Compatibilidades entre itens e produtos de Autopeças

Importante:

Este recurso está disponível apenas para Argentina, México e Brasil.

As compatibilidade permitem associar itens publicados a produtos compatíveis no marketplace, por exemplo, se você tiver um "Pneu Michelin Primacy 4 205/55 R16 91V" publicado, poderá definir atributos como Marca, Modelo, Ano e Motor para os quais esta peça é compatível. Dessa maneira, você melhora a qualidade das publicações e reduz o número de publicações por item.
Para isso, você deve acessar o dump e verificar se o domínio dos itens e o domínio dos produtos são compatíveis. Em seguida, você pode associar as compatibilidades de 3 (três) maneiras diferentes e, finalmente, listá-las.
Se a compatibilidade não for adequada, você poderá eliminar os definidos pelos usuários (vendedores).

Conteúdos

→Verificar compatibilidade entre domínios
→Contar produtos de um domínio
→Associar compatibilidades
↳Por produto
↳Por domínio de produto
↳Por produto e domínio de produto
→Listar compatibilidades
↳Obter todas as compatibilidades de um item
↳Obter uma compatibilidade específica de um item por seu ID
→Eliminar compatibilidades

Verificar compatibilidade entre domínios

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

Ao consultar o dump a seguir, você obtém a compatibilidade para cada domínio por site.

Chamada:

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

Resposta:

[
   {
      "domain_id":"$domain_id",
      "compatibilities":[
         {
            "compatible_domain_id":"$domain_id"
         },
         {
            "compatible_domain_id":"$domain_id"
         }
      ]
   },
   {
      "domain_id":"$domain_id",
      "compatibilities":[
         {
            "compatible_domain_id":"$domain_id"
         },
         {
            "compatible_domain_id":"$domain_id"
         }
      ]
   }
]

Exemplo chamada:

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

Exemplo de resposta:

[
   {
       "domain_id": "MLA-AUTOMOTIVE_SHOCK_ABSORBERS",
       "compatibilities": [
           {
               "compatible_domain_id": "MLA-CARS_AND_VANS"
           }
       ]
   }
]

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.

Nota:

O limite de tráfego APP_ID é de 100 rpm.

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 y 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.

Nota:

O limite de tráfego APP_ID é de 100 RPM (request por minuto).

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":"$productId1"
      },
      {
         "id":"$productId2"
      }
   ]
}

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLM794706391/compatibilities
{
   "products":[
      {
         "id":"MLM15847274"
      }
   ]
}

Resposta:

{
  "products": [{
    "id": "d8b9af3b-1b36-096d-a0bf-4b0fb19085f8",
    "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
    "catalog_product_id": "MLM15847274",
    "catalog_product_name": "Ford Crown Victoria 2001 Police Interceptor",
    "source": "SELLER",
    "restrictions": []
  }],
  "items": []
}

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.

Chamada:

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

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": "VEHICLE_YEAR",
        "value_id": "6730991"
      },
      {
        "id": "MODEL",
        "value_id": "1252874"
      },
      {
        "id": "TRIM",
        "value_id": "2228234"
      }
    ]
  }]
}

Resposta:

{
  "products": [{
      "id": "4cb9af35-8e9b-ebfd-9e7f-2245ac363d10",
      "domain_id": "MLA-CARS_AND_VANS",
      "catalog_product_id": "MLA15863808",
      "catalog_product_name": "Volkswagen Gol Sedan 2010 Comfortline",
      "source": "SELLER",
      "restrictions": []
    },
    {
      "id": "c2b9af35-8e78-f34f-ef71-30bb11af0742",
      "domain_id": "MLA-CARS_AND_VANS",
      "catalog_product_id": "MLA15856472",
      "catalog_product_name": "Chrysler Cirrus 2010 Touring",
      "source": "SELLER",
      "restrictions": []
    }

  ],
  "items": []
}

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"

               }
           ]
       }
   ]
}

Resposta:

{
   "products": [
{
           "id": "4cb9af35-8e9b-ebfd-9e7f-2245ac363d10",
           "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
           "catalog_product_id": "MLM15863808",
           "catalog_product_name": "Volkswagen Gol Sedan 2010 Comfortline",
           "source": "SELLER",
           "restrictions": []
       },
       {
           "id": "c2b9af35-8e78-f34f-ef71-30bb11af0742",
           "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
           "catalog_product_id": "MLM15856472",
           "catalog_product_name": "Chrysler Cirrus 2010 Touring",
           "source": "SELLER",
           "restrictions": []
       }

],
   "items": []
}

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": "$productId1"
  }, {
    "id": "$productId2"
  }],
  "products_families": [{
    "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/items/MLM794706391/compatibilities
{
  "products": [{
    "id": "MLM15847274"
  }],
  "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:

{
  "products": [{
      "id": "48af8178-50ce-971a-fc41-8c9a954cea62",
      "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
      "catalog_product_id": "MLA123254432",
      "catalog_product_name": "Producto 1",
      "source": "SELLER",
      "restrictions": [

      ]
    },
    {
      "id": "8abae1a7-9ced-411e-93d6-df6173c7f5fe",
      "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
      "catalog_product_id": "MLA123254551",
      "catalog_product_name": "Producto 2",
      "source": "SELLER",
      "restrictions": [

      ]
    }
  ]
}

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.

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

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.

Nota:

Se uma compatibilidade carregada pelo fornecedor já estiver disponível no catálogo do Mercado Livre, ela não será exibida no campo products da resposta.

Obter todas as compatibilidades de um item

Chamada:

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

Ejemplo de chamada:

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

Ejemplo de resposta:

{
  "products": [{
      "id": "48af8178-50ce-971a-fc41-8c9a954cea62",
      "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
      "catalog_product_id": "MLA123254432",
      "catalog_product_name": "Producto 1",
      "source": "SELLER",
      "restrictions": []
    },
    {
      "id": "8abae1a7-9ced-411e-93d6-df6173c7f5fe",
      "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
      "catalog_product_id": "MLA123254551",
      "catalog_product_name": "Producto 2",
      "source": "SELLER",
      "restrictions": [

      ]
    }
  ],
  "catalog_compatibilities_count": 15
}

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

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": "8abae1a7-9ced-411e-93d6-df6173c7f5fe",
  "domain_id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
  "catalog_product_id": "MLM123254551",
  "catalog_product_name": "Producto 2",
  "source": "SELLER",
  "restrictions": []
}

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

Eliminar compatibilidades

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

Eliminar una compatibilidad 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

La respuesta será un 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

Resposta:

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

Eliminar compatibilidades para um domínio de um ítem

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 permisos sobre el ítem.
404: el ítem o la compatibilidad no existen.