Compatibilidades entre itens e produtos de Autopeças

Verificar compatibilidade entre domínios

Antes de criar compatibilidade entre itens e produtos, verifique se os domínios e categorias do item e do produto são compatíveis.

Ao consultar o dump a seguir, a lista de domínios e categorias em que você pode ou precisa informar compatibilidades por site.

Chamada:

curl -X GET http://api.mercadolibre.com/catalog/dumps/domains/$SITE_ID/compatibilities

Exemplo de chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/dumps/domains/MLM/compatibilities

Exemplo de resposta:

[
    {
        "domain_id": "MLM-AUTOMOTIVE_SHOCK_ABSORBERS",
        "main": false,
        "compatibilities": [
            {
                "compatible_domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
                "type": "EXTENSION",
                "required": false,
                "restrictions": [],
                "categories": [
                    {
                        "id": "MLM45878",
                        "required": true,
                        "note_status": "ENABLED",
                        "restrictions_status": "DISABLED",
                        "universal_status": "DISABLED"
                    }
                ]
            }
        ]
    },
    …
}]

Os novos campos indicam:

• categories: categorias que suportam a compatibilidade de carregamento.
• required: categorias em que é obrigatório carregar compatibilidades.
• type: tipo de compatibilidade. Apenas o tipo EXTENSION suporta compatibilidades de carregamento.
• note_status e restrictions_status: indicam se a categoria permite reportar notas e restrições de posição.
• universal_status: indica se a categoria permite a comunicação de compatibilidades universais. ENABLED: permite a comunicação de compatibilidades universais ou DISABLED: não permite a comunicação de compatibilidades universais.

Obtenha mais informações de domínios, produtos e atributos de autopeças.

Contar produtos de um domínio

Para verificar o número de produtos existentes por domínio (família de produtos) que atendem a certos atributos e valores, você pode executar o seguinte POST. Isso permitirá que você valide, antes de associar as compatibilidades, a quantidade de produtos e evite erros nas atribuições de compatibilidade.
Isso é importante, pois apenas um máximo de 200 produtos podem ser atribuídos por chamada.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/count_family_products
{
  "domain_id": "$domainId",
  "attributes": [{
    "id": "$attributeId1",
    "value_id": "$valueId1"
  }, {
    "id": "$attributeId2",
    "value_name": "$valueName2"
  }]
}

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_compatibilities/products_search/count_family_products
{
  "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
  "attributes": [{
      "id": "BRAND",
      "value_name": "Volkswagen"
    },
    {
      "id": "CAR_AND_VAN_MODEL",
      "value_name": "VENTO"
    }
  ]
}

Resposta:

{
   "count":141
}

Associar compatibilidades

Para associar compatibilidades de um item a um produto e / ou domínio, você pode consultar até um máximo de 200 produtos por chamada (incluindo os definidos nos domínios) e fazê-lo de três maneiras diferentes:

• Por produto: para adicionar novas compatibilidades a um item, você deve enviar as compatibilidades que deseja adicionar. Não é necessário enviar os existentes para manter os atuais.
• Por domínios de produto: você pode especificar um conjunto de atributos que definem um domínio de produto. Para cada domínio, você deve especificar seu domínio e, para cada atributo, um valor que consiste em id e/ou name.
• Por produto e domínio: você pode associar compatibilidades a um item publicado de outro produto e a um dominio de produtos, ou seja permite associar conjuntamente os 2 primeiros.

Valores possíveis para uma restrição de posição

Ao associar uma compatibilidade poderá também indicar a restrição de posição da mesma, que com a chamada seguinte poderá conhecer os valores possíveis para a informar.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/catalog_compatibilities/restrictions/values?main_domain_id=MLB-CARS_AND_VANS&secondary_domain_id=MLB-VEHICLE_SHOCK_ABSORBERS

Respuesta:

{
      "attributes_values": [   
          {
               "attribute_id": "POSITION",
               "values":
                [
                    {
                        "value_id": "23536",
                        "value_name": "Superior",
                    },
                    {
                        "value_id": "23537",
                        "value_name": "Inferior"
                    }
               ]
         }
    ]
}

Associar por produto

Para associar uma compatibilidade com um ou mais produtos individuais, você pode usar o buscador de produtos.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
   "products": [{
       "id": "$PRODUCTIID",
       "note": "texto",
       "restrictions": [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      },
                      {
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}, 
                                  {"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      }
                    ]
                }]
   }]
}

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
   "products": [{
       "id": "MLB155254",
       "note": "Modelos posteriores a Mayo de 2018",
       "restrictions": [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "12456","value_name": "Delantero"}]
                      },
                      {
                        "values":[{"value_id": "65432","value_name": "Trasero"}, 
                                  {"value_id": "87675","value_name": "Inferior"}]
                      }
                    ]
                }]
   }]
}

Resposta:

{
 "created_compatibilities_count": 72
}

Também é possível associar uma nota e restrições de posição a mais de uma compatibilidade, para isso é necessário substituir o nodo products por products_group, exemplo:

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
   "products_group": [{
       "ids": ["MLB155254", "MLB155255"],
       "note": "texto",
       "restrictions": [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      },
                      {
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}, 
                                  {"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      }
                    ]
                }]
   }]
}

Associar por domínio de produto

Para associar compatibilidades definidas por um grupo de atributos que determinam um domínio, conheça os domínios e atributos das autopeças.

Nota:

- Você pode informar até 10 domínios de produto diferentes por chamada.
- O campo note e array de restrictions já estão disponíveis no json para envios de compatibilidade.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
   "products_families": [{
       "domain_id": "$DOMAIN_ID",
       "attributes": [{
               "id": "$ATTRIBUTE_ID",
               "value_id": "$VALUE_ID"
           },
           {
               "id": "$ATTRIBUTE_ID",
               "value_id": "$VALUE_ID"
           },
       ],
     "note": "Texto",
     "restrictions":
                [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      },
                      {
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}, 
                                  {"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      }
                    ]
                }]
}

Exemplo (exceto MLM):

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA794706391/compatibilities
{
   "products_families": [{
       "domain_id": "MLA-CARS_AND_VANS",
       "attributes": [{
               "id": "BRAND",
               "value_id": "60249"
           },
           {
               "id": "YEAR",
               "value_name": "2010"
           },
       ],
     "note": "Solamente para vehículos de fabricación Europea",
     "restrictions":
                [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "12456","value_name": "Delantero"}]
                      },
                      {
                        "values":[{"value_id": "65432","value_name": "Trasero"}, 
                                  {"value_id": "87675","value_name": "Inferior"}]
                      }
                    ]

                }]
}

Resposta:

{
 "created_compatibilities_count": 23
}

Exemplo MLM:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities
{
   "products_families": [{
           "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
           "attributes": [{
                   "id": "DRIVE_TYPE",
                   "value_id": "8182649"
                  
               },
               {
                   "id": "CAR_AND_VAN_BODY_TYPE",
                   "value_id": "8183109"
                  
               },
               {
                   "id": "YEAR",
                   "value_name": "2010"
                  
               }
           ],
     "note": "Solamente para vehículos de fabricación Europea",
     "restrictions":
                [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "12456","value_name": "Delantero"}]
                      },
                      {
                        "values":[{"value_id": "65432","value_name": "Trasero"}, 
                                  {"value_id": "87675","value_name": "Inferior"}]
                      }
                    ]
       }
   ]
}

Resposta:

{
 "created_compatibilities_count": 23
}

Associar por produto e domínio de produtos

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
   "products": [{
       id": "$PRODUCTIID",
       "note": "texto",
       "restrictions": [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      },
                      {
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}, 
                                  {"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      }
                    ]
   }],
   "products_families": [{
       "domain_id": "$DOMAIN_ID",
       "attributes": [{
               "id": "ATTRIBUTE_ID",
               "value_id": "$VALUE_ID"
           },
           {
               "id": "ATTRIBUTE_ID",
               "value_id": "$VALUE_ID"
           },
       ],
     "note": "Texto",
     "restrictions":
                [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      },
                      {
                        "values":[{"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}, 
                                  {"value_id": "$VALUE_ID","value_name": "$VALUE_NAME"}]
                      }
                    ]
                }]
}

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities
{
   "products": [{
       "id": "MLB155254",
       "note": "Modelos posteriores a Mayo de 2018",
       "restrictions": []
   }],
   "products_families": [{
       "domain_id": "MLB-CARS_AND_VANS",
       "attributes": [{
               "id": "BRAND",
               "value_id": "60249"
           },
           {
               "id": "YEAR",
               "value_name": "2010"
           },
       ],
     "note": "Solamente para vehículos de fabricación Europea",
     "restrictions":
                [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "12456","value_name": "Delantero"}]
                      },
                      {
                        "values":[{"value_id": "65432","value_name": "Trasero"}, 
                                  {"value_id": "87675","value_name": "Inferior"}]
                      }
                    ]
                }]
}

No campo note não permitimos até 500 caracteres e o texto é moderado.

Resposta:

{
 "created_compatibilities_count": 23
}

Possíveis erros

400: validações de consistência:

• Os campos obrigatórios estão incompletos.
• O formato dos IDs está incorreto.
• Mais de 200 produtos foram encontrados e / ou especificados para as famílias de produtos.
• Mais de 10 domínios de produto foram especificados.
• Os produtos e / ou domínios não pertencem ao mesmo site que o item.
• Todos os produtos devem ser children.
• O domínio do item é compatível com os domínios dos produtos especificados e/ou com os domínios especificados nas famílias de produtos especificadas.
• Não pode haver mais de 4 posições configuradas em uma restrição de posição.
• Cada restrição de posição pode ter no máximo 4 ids.
• Os ids devem pertencer ao conjunto fechado de ids definidos.
• A combinação de valores deve ser única, ou seja, não pode haver duas listas de ids iguais em uma restrição de posição.
• A categoria do item deve ter notas e restrições de posição habilitadas.
• A nota não pode exceder 500 caracteres.

403: token inválido ou falta de permissões no item.
404: o item, produtos ou domínios especificados não existem.

Associar compatibilidade universal

Para indicar que um item é compatível com qualquer produto, dentro da solicitação, existe um campo universal que deve ser informado em true. Isso indica que esse item é universal (portanto, nenhuma compatibilidade deve ser associada a ele, pois ele é compatível com todos os produtos do mesmo domínio).

Ao indicar uma compatibilidade universal, não é possível especificar produtos e famílias. Se ambos os campos forem enviados, será devolvido um erro.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
   "products": [],
   "products_families": [],
   "products_group": [],
   "universal": true
}

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM12456789/compatibilities
{
   "products": [],
   "products_families": [],
   "products_group": [],
   "universal": true,
}

Resposta:

{
 "created_compatibilities_count": 1
}

Possíveis erros ao atribuir compatibilidades universais

400: validação de consistência:

No caso de os produtos e as famílias serem enviados ao mesmo tempo que é comunicada uma compatibilidade universal, esta será obtida:

• Message: "Invalid arguments for specific request. Please check details to satisfy validations".
• Details: "at least one of products, products_groups, products_families or universal must be specified, if universal no products can be specified".

Se tiver alguma compatibilidade no item registrado anteriormente e tentar torná-lo universal, receberá a seguinte mensagem:

• Message: Item has compatibilities and these must be removed before setting it as universal.

Quando se tenta gerar um item universal e a categoria não está ativada para esta experiência, obtém-se:

• Message: There is no configured compatibility for the category $CATEGORY_ID

Se o item anteriormente é universal e você tentar carregar alguma compatibilidade, obterá:

• Message: Item has universal setting and must be removed before creating compatibilities.

403: token inválido ou falta de permissões para o item.

404: o item não existe.

Alterar ou eliminar notas e restrição de posição

Para alterar ou apagar uma nota e restrição de posição, execute um PUT no recurso de informar compatibilidades alterando as informações que você precisa no campo update. Para deletar uma ou ambas informações, deve enviar o campo note e/ou array de restrictions vazio. No exemplo abaixo ambos campos são eliminados.

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
  "update": {
    "products": [{
            "id": "MLB155254",
            "note": "",
            "restrictions":[]
            }
        ]
    }
}

Listar compatibilidades

Com esse recurso, é possível listar todas as compatibilidades para um item específico. O atributo products contém as compatibilidades do vendedor e catalog_compatibilities_count tem a quantidade de compatibilidades do catálogo do Mercado Livre, ou seja, essas últimas compatibilidades não serão listadas devido a limitações nas licenças de propriedade intelectual.

Obter todas as compatibilidades de um item

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities?extended=true

Exemplo de chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities?extended=true

Exemplo de resposta:

{
   "products": [
        {
            "id": "bcbd413f-cd65-0e0f-88c9-5eb4aebb5372",
            "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
            "catalog_product_id": "MLM15847548",
            "catalog_product_name": "Volkswagen Jetta 2010 GLI Manual 5",
            "source": "SELLER",
            "note": "Solo modelos de caja automática"
        },
        {
            "id": "58bd413f-cd65-a719-9570-2ca8f2b528af",
            "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
            "catalog_product_id": "MLM15847546",
            "catalog_product_name": "Volkswagen Jetta 2010 GLI Automática 6",
            "source": "SELLER",
            "note": "Modelos posteriores a Junio 2010",
            "restrictions":
                [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "12456","value_name": "Delantero"}]
                      },
                      {
                        "values":[{"value_id": "65432","value_name": "Trasero"}, 
                                  {"value_id": "87675","value_name": "Inferior"}]
                    }]
             }]
        }

   ],
    "catalog_compatibilities_count": 15
}

Um erro 404 significa que o item não existe.

Obter as compatibilidades de um item universal

Caso o item seja configurado como universal, a resposta um campo adicional chamado universal é adicionado, contendo uma lista de domínios principais com os quais o item é compatível.

Exemplo de resposta:

{
          "universal": {
              “domain_ids”:  [“MLM_CARS_AND_VANS_FOR_COMPATIBILITIES”]
            }
}

Obter uma compatibilidade específica de um item por seu ID

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities/$compatibility_id

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities/$compatibility_id

Resposta:

{
  "id": "bcbd413f-cd65-0e0f-88c9-5eb4aebb5372",
  "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
  "catalog_product_id": "MLM15847548",
  "catalog_product_name": "Volkswagen Jetta 2010 GLI Manual 5",
  "note": "Solo para versiones con frenos a disco en las ruedas traseras",
  "note_status": "PENDING",
  "restrictions": [{
                    "attribute_id": "POSITION",
                    "attribute_values":
                    [{
                        "values":[{"value_id": "12456","value_name": "Delantero"}]
                      }]
               }]
}

As notas só aparecem no front do item no status APPROVED ou CHECKED.

Um erro 404 significa que o item ou a compatibilidade não existe.

Obtenha uma nota de compatibilidade

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities/$COMPATIBILITY_ID/note

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM12456789/compatibilities/bcbd413f-cd65-0e0f-88c9-5eb4aebb5372/note

Resposta:

{
    "note": "Solo para versiones con frenos a disco en las ruedas traseras"
}

Eliminar compatibilidades

Se você associou uma compatibilidade incorreta ao item, é possível removê-lo desde que o vendedor o tenha feito.

Eliminar uma compatibilidade específica para o item indicado

Chamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities/$COMPATIBILITY_ID

Exemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities/4cb9af35-8e9b-ebfd-9e7f-2245ac363d10

A resposta será um http 200.

Eliminar compatibilidades para um item

Chamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities

Exemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities

As notas só aparecem no front do item no status

Resposta:

{
  "deleted_compatibilities": [
    "d0ba2aeb-7409-0037-7b23-0b91266fd00e",
    "72ba233d-16d8-218b-4062-7a97dab166c8"
  ]
}

Eliminar compatibilidades para um domínio de um item

Chamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/compatibilities
{
"products_families": [{
  "domain_id": "$domain_id",
  "attributes": [{
    "id": "$attribute_id1",
    "values":[{ 
      "id": "$value_id1",
      "name": "$value_name1"
    }]
  },{
    "id": "$attribute_id2",
    "values":[{ 
      "id": "$value_id1",
      "name": "$value_name1"
    }]
  }]
}]
}

Exemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities
  {
  "products_families": [{
          "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
          "attributes": [{
                  "id": "DRIVE_TYPE",
                  "value_id": "8182649"           
              },
              {
                  "id": "CAR_AND_VAN_BODY_TYPE",
                  "value_id": "8183109"
              },
              {
                  "id": "YEAR",
                  "value_name": "2010"              
              }]
      }]
}

Resposta:

{
   "deleted_compatibilities": [
       "d0ba2aeb-7409-0037-7b23-0b91266fd00e",
       "72ba233d-16d8-218b-4062-7a97dab166c8"
   ]
}

Possíveis erros

400: formato incorreto / mais de 200 produtos para o domínio especificado / mais de 10 domínios especificados.
403: token inválido, o falta de permissões sobre o ítem.
404: o ítem ou a compatibilidade não existem.

Como informar exceções

Em casos de Peças de carros e caminhonetes, em que a categoria exige a informação de compatibilidades, mas não encontra nenhum veículo, modelo ou versão disponível no catálogo. Estes itens fazem parte do fluxo de exceções e para informá-los, disponibilizamos o seguinte recurso:

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$item_id/compatibilities/exception
{
  "comment": “texto livre com um máximo de 255 caracteres” 
}

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB12345678/compatibilities/exception
{
  "comment": “texto livre com um máximo de 255 caracteres” [Requerido]
}

Resposta:

200 OK

Possíveis erros

400: o item está finalizado ou inativo.
400: o item tem compatibilidades existentes.
400: a categoria do item não tem compatibilidades.
400: o item tem uma exceção de compatibilidade existente.
400: comentário necessário.

Verifique se um item tem uma exceção

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$item_id/compatibilities/exception

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB12345678/compatibilities/exception

Resposta:

{
   "has_exception": true/false
}

Conhecer compatibilidades que geram reclamações

Para que você possa corrigir as compatibilidades indicadas incorretamente, você poderá identificar o automóvel escolhido pelo comprador quando for gerado um pedido de incompatibilidade, usando o seguinte endpoint:

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/compats-snapshots/orders/$ORDER_ID

Exemplos:

Ordem com reclamação onde o comprador selecionou diferentes filtros durante a compra do produto e foi confirmado que o produto selecionado "Sim, era compatível" com o item (compatibility_status.compatibility = CONFIRMED)

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/compats-snapshots/orders/2000006372967416

Response:

{
    "item_id": "MLM2187940074",
    "product_id": "MLM15879678",
    "seller_id": "61597650",
    "user_selection": {
        "label_values": [
            {
                "label": "Marca",
                "value_name": "Jeep",
                "values": [
                    {
                        "attribute_id": "BRAND",
                        "value_id": "60395"
                    }
                ]
            },
            {
                "label": "Modelo",
                "value_name": "Grand Cherokee",
                "values": [
                    {
                        "attribute_id": "CAR_AND_VAN_MODEL",
                        "value_id": "8236932"
                    }
                ]
            },
            {
                "label": "Año",
                "value_name": "1998",
                "values": [
                    {
                        "attribute_id": "YEAR",
                        "value_id": "60500"
                    }
                ]
            },
            {
                "label": "Versión",
                "value_name": "Limited - SUV 4 Puertas",
                "values": [
                    {
                        "attribute_id": "CAR_AND_VAN_SUBMODEL",
                        "value_id": "8238101"
                    },
                    {
                        "attribute_id": "CAR_AND_VAN_BODY_TYPE",
                        "value_id": "8183114"
                    },
                    {
                        "attribute_id": "BODY_DOORS_NUMBER",
                        "value_id": "8239302"
                    }
                ]
            },
            {
                "label": "Mecánica",
                "value_name": "5.2L V8 Gasolina Aspirado Caja Automática 4 Marchas - Tracción RWD",
                "values": [
                    {
                        "attribute_id": "CAR_AND_VAN_ENGINE",
                        "value_id": "8753511"
                    },
                    {
                        "attribute_id": "ASPIRATION",
                        "value_id": "8183201"
                    },
                    {
                        "attribute_id": "TRANSMISSION_CONTROL_TYPE",
                        "value_id": "8183158"
                    },
                    {
                        "attribute_id": "TRANSMISSION_SPEEDS_NUMBER",
                        "value_id": "8239312"
                    },
                    {
                        "attribute_id": "DRIVE_TYPE",
                        "value_id": "8182651"
                    }
                ]
            }
        ]
    },
    "compatibility_status": {
        "compatibility": "CONFIRMED", 
    "compatibility_id": "bec40b54-c7de-1ad2-a7e2-00a5e34376a4"
    },
    "compatibility_deleted": true,
    "date_created": "2023-08-31T20:08:41Z",
    "date_updated": "2023-08-31T22:37:39Z"
}

Ordem com reclamação quando o comprador não seleccionou um veículo durante a compra do produto.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/compats-snapshots/orders/2000006372967424

Response:

{
    "item_id": "MLM2038068352",
    "seller_id": "186880296",
    "compatibility_status": {
      "compatibility": "NO_USER_SELECTION",
      "note": "We don't have the compatibility information for this order. The user made the order without completing the widget. ",
      "restrictions": []
    },
    "date_created": "2023-08-23T12:30:57Z"
  }

Ordem com reclamação em que, antes da compra, foi confirmado ao comprador que o produto selecionado “Não era compatível” com o item (compatibility_status.compatibility = INCOMPATIBLE).

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/compats-snapshots/orders/2000006372967684

Response:

{
    "item_id": "MLM693204319",
    "seller_id": "56493851",
    "compatibility_status": {
        "compatibility": "INCOMPATIBLE"
    },
    "compatibility_deleted": true,
    "date_created": "2023-08-25T14:45:48Z"
}

Os campos indicam:

• compatibility_id: identificador de compatibilidade selecionado durante a compra.
• product_id: ID do veículo selecionado antes da compra.
• user_selection: detalhes dos filtros selecionados pelo comprador no momento da compra.

• compatibility_status.compatibility:
  • CONFIRMED: indica que foi confirmado ao comprador que o veículo selecionado era compatível com o item comprado.
  • INCOMPATIBLE: indica que foi confirmado ao comprador que o veículo selecionado não era compatível com o item comprado.
• compatibility_deleted::
  • “true” indica que a compatibilidade para o veículo selecionado pelo comprador já foi eliminada pelo item no momento da consulta.



Possíveis erros:

Error_code	Mensagem de erro	Descrição
400	Compatibility snapshot for order with id $ORDER_ID not found.	Ordem não é válida.
401	Invalid access token.	Access token inválido.
403	The compatibility snapshot can only be retrieved for orders with claims.	A ordem não tem qualquer reivindicação associada.
403	Caller must be the seller of the item.	Está sendo feita uma tentativa de consultar a ordem de um vendedor que não corresponde ao token de acesso fornecido.

Importante:
Para manter as compatibilidades atualizadas, você pode saber quais são os veículos que foram adicionados ao catálogo entrando no recurso /catalog_compatibilities/products_search/new?categoryId=$CATEGORY_ID.

Próximo: Referências de domínios, produtos e atributos para Autopeças.