Compatibilidades entre itens e produtos de Autopeças
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.
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.
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.
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.
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.