Identificadores de produtos
GTIN e tipos de identificadores
GTIN (Global Trade Item Number) é o número mundial de um artigo comercial, utilizado para identificar de maneira única qualquer produto ou item sobre o qual exista uma necessidade de obter informações específicas e deva ser atribuído um preço. O GTIN salvará todos os identificadores de produtos (PI) neste campo, concatenando os valores. É um padrão que engloba os códigos EAN, UPC, JAN, GTIN14, ISBN, ISBN10 e ISBN13.
Atualmente, os atributo com as tag new_required e conditional_required indicam sua obrigação dependendo de cada caso.
Enviar as informações dos identificadores de produtos
Podem ser realizadas da mesma forma em que são postados os atributos independente da categoria.
Exemplo do item sem variações:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"listing_type_id":"gold_special",
"pictures":[ { "id":"553111-MLA20482692355_112015" } ],
"title":"Item de testeo -- no ofertar --kc:off",
"available_quantity":4,
"buying_mode":"buy_it_now",
"currency_id":"ARS",
"condition":"not_specified",
"category_id":"MLA377600",
"site_id":"MLA",
"price":100,
"attributes": [
{ "id": "CARRIER", "value_id": "298335", "value_name":"Desbloqueado" },
{ "id": "GTIN", "value_name": "977015057271221" }
]
}' 'https://api.mercadolibre.com/items'
Exemplo do item com variações:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"listing_type_id":"gold_special",
"pictures":[ { "id":"553111-MLA20482692355_112015" } ],
"title":"Item de testeo -- no ofertar --kc:off",
"available_quantity":4,
"buying_mode":"buy_it_now",
"currency_id":"ARS",
"condition":"not_specified",
"category_id":"MLA377600",
"site_id":"MLA",
"price":100,
"variations": [
{ "picture_ids": [ "553111-MLA20482692355_112015" ], "available_quantity": 2, "price": 100, "attribute_combinations": [ { "id": "COLOR", "value_id": "52049" } ], "attributes": [ { "id": "GTIN", "value_name": "4006381333931" } ] },
{ "picture_ids": [ "553111-MLA20482692355_112015" ], "available_quantity": 2, "price": 100, "attribute_combinations": [ { "id": "COLOR", "value_id": "52055" } ], "attributes": [ { "id": "GTIN", "value_name": "7015057271221" } ] }
]
}
' 'https://api.mercadolibre.com/items'
Acrescentar as informações num item já existente
Exemplo de modificações do item:
Deverão se enviar todos os atributos existentes do ítem incluindo o código de indentificadores de produto.
Sem variações
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"attributes": [
{
"id": "GTIN",
"value_name": "7015057271221"
},
{
"id": "BRAND"
}
]
}' 'https://api.mercadolibre.com/items/MLA642016284'
Com variações
Da mesma maneira em que adiciona ou modifica qualquer atributo numa variação, para adicionar ou modificar, tem que especificar a listagem de variações que deseja manter no item (indicando o ID da variação) e adicionando a listagem de atributos que deseja manter em cada variação.
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
"variations": [{
"id": 847326284,
"attributes": [{
"id": "GTIN",
"value_name": "7015057271221"
}]
}, {
"id": 847326282,
"attributes": [{
"id": "GRILL",
"value_name": "No"
}]
}]
}' 'https://api.mercadolibre.com/items/MLA642016284'
Lembre-se o item já tiver o atributo GTIN no nível do item, você não poderá especificá-lo novamente no nível da variante. Nesse caso, você deve primeiro excluí-lo no nível do item e depois especificá-lo no nível da variação.
Consultar as informações sobre os identificadores de seus produtos
Para obter esses dados, você deverá fazer um GET na API:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID?include_attributes=all
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB1212897155?include_attributes=all
Resposta:
{
"id": "MLB1212897155",
"site_id": "MLB",
"title": "Reparador Instantâneo Inflador Pneus Citroen C3 Oferta",
"subtitle": null,
"seller_id": 413586300,
"category_id": "MLB3936",
"official_store_id": null,
"price": 28.5,
"base_price": 28.5,
"original_price": null,
"currency_id": "BRL",
"initial_quantity": 25500,
"available_quantity": 5000,
"sold_quantity": 0,
"sale_terms": [
{
"id": "WARRANTY_TIME",
"name": "Tempo de garantia",
"value_id": null,
"value_name": "90 dias",
"value_struct": {
"number": 90,
"unit": "dias"
},
"values": [
{
"id": null,
"name": "90 dias",
"struct": {
"number": 90,
"unit": "dias"
}
}
]
},
{
"id": "WARRANTY_TYPE",
"name": "Tipo de garantia",
"value_id": "2230280",
"value_name": "Garantia do vendedor",
"value_struct": null,
"values": [
{
"id": "2230280",
"name": "Garantia do vendedor",
"struct": null
}
]
}
],
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"start_time": "2019-04-15T14:49:44.000Z",
"stop_time": "2020-01-21T17:58:09.000Z",
"condition": "new",
"permalink": "https://produto.mercadolivre.com.br/MLB-1212897155-reparador-instantneo-inflador-pneus-citroen-c3-oferta-_JM",
"thumbnail": "http://mlb-s2-p.mlstatic.com/692928-MLB30967650522_062019-I.jpg",
"secure_thumbnail": "https://mlb-s2-p.mlstatic.com/692928-MLB30967650522_062019-I.jpg",
"pictures": [
{
"id": "692928-MLB30967650522_062019",
"url": "http://mlb-s2-p.mlstatic.com/692928-MLB30967650522_062019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/692928-MLB30967650522_062019-O.jpg",
"size": "500x500",
"max_size": "1000x1000",
"quality": ""
},
{
"id": "981087-MLB29954390293_042019",
"url": "http://mlb-s2-p.mlstatic.com/981087-MLB29954390293_042019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/981087-MLB29954390293_042019-O.jpg",
"size": "335x500",
"max_size": "579x863",
"quality": ""
},
{
"id": "735393-MLB29954407546_042019",
"url": "http://mlb-s2-p.mlstatic.com/735393-MLB29954407546_042019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/735393-MLB29954407546_042019-O.jpg",
"size": "306x500",
"max_size": "530x865",
"quality": ""
},
{
"id": "800235-MLB29954373431_042019",
"url": "http://mlb-s2-p.mlstatic.com/800235-MLB29954373431_042019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/800235-MLB29954373431_042019-O.jpg",
"size": "308x500",
"max_size": "533x864",
"quality": ""
},
{
"id": "840149-MLB29954377892_042019",
"url": "http://mlb-s2-p.mlstatic.com/840149-MLB29954377892_042019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/840149-MLB29954377892_042019-O.jpg",
"size": "466x500",
"max_size": "817x876",
"quality": ""
},
{
"id": "631017-MLB29954401158_042019",
"url": "http://mlb-s2-p.mlstatic.com/631017-MLB29954401158_042019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/631017-MLB29954401158_042019-O.jpg",
"size": "476x500",
"max_size": "829x870",
"quality": ""
},
{
"id": "758623-MLB29954378499_042019",
"url": "http://mlb-s2-p.mlstatic.com/758623-MLB29954378499_042019-O.jpg",
"secure_url": "https://mlb-s2-p.mlstatic.com/758623-MLB29954378499_042019-O.jpg",
"size": "495x500",
"max_size": "866x874",
"quality": ""
}
],
"video_id": null,
"descriptions": [
{
"id": "MLB1212897155-2055995672"
}
],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [
],
"shipping": {
"mode": "me2",
"methods": [
],
"tags": [
],
"dimensions": null,
"local_pick_up": false,
"free_shipping": false,
"logistic_type": "drop_off",
"store_pick_up": false
},
"international_delivery_mode": "none",
"seller_address": {
"city": {
"id": "BR-SP-78",
"name": "Presidente Prudente"
},
"state": {
"id": "BR-SP",
"name": "São Paulo"
},
"country": {
"id": "BR",
"name": "Brasil"
},
"search_location": {
"neighborhood": {
"id": "TVhYSmFyZGltIFBhdWxpc3RhVFZoWVVISmxjM",
"name": "Jardim Paulista"
},
"city": {
"id": "TVhYUHJlc2lkZW50ZSBQcnVkZW50ZVRVeENVR",
"name": "Presidente Prudente"
},
"state": {
"id": "TUxCUFNBT085N2E4",
"name": "São Paulo"
}
},
"latitude": -22.110016,
"longitude": -51.40688,
"id": 1028136300
},
"seller_contact": null,
"location": {
},
"geolocation": {
"latitude": -22.110016,
"longitude": -51.40688
},
"coverage_areas": [
],
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "31163",
"value_name": "Multilaser",
"value_struct": null,
"values": [
{
"id": "31163",
"name": "Multilaser",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros"
},
{
"id": "GTIN",
"name": "Código universal de produto",
"value_id": "-1",
"value_name": null,
"value_struct": null,
"values": [
{
"id": "-1",
"name": null,
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros"
},
{
"id": "ITEM_CONDITION",
"name": "Condição do item",
"value_id": "2230284",
"value_name": "Novo",
"value_struct": null,
"values": [
{
"id": "2230284",
"name": "Novo",
"struct": null
}
],
"attribute_group_id": "OTHERS",
"attribute_group_name": "Outros"
}
],
"warnings": [
],
"listing_source": "",
"variations": [
],
"status": "closed",
"sub_status": [
"deleted"
],
"tags": [
"good_quality_picture",
"immediate_payment",
"cart_eligible"
],
"warranty": "Garantia do vendedor: 90 dias",
"catalog_product_id": null,
"domain_id": "MLB-VEHICLE_ACCESSORIES",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [
],
"automatic_relist": false,
"date_created": "2019-04-15T14:49:44.000Z",
"last_updated": "2020-01-24T10:28:51.000Z",
"health": 0.85,
"catalog_listing": false
}
Considerações
- Não são SKU internos.
- Você pode enviar mais de um código de identificação para o mesmo produto. Nesse caso, você deve enviar no atributo GTIN todos os códigos de produto separados por vírgula.
- Lembre-se de verificar ao /attributes se os atributos estiverem marcados com as seguintes tags:
- obrigatório, o atributo é obrigatório.
- new_required, o atributo é obrigatório se a condição do item for nova.
- conditional_required, neste caso verifique quais são os atributos obrigatórios realizando um POST para o novo recurso /attributes/conditional com todas as informações do item e você reconhecerá os atributos necessários para aquela publicação. - A quantidade de caracteres varia de acordo com o tipo de código: existem de 8, 10, 12, 13 ou 14 caracteres. Inclusive um mesmo código pode ser escrito novamente, sendo completado com zeros no começo, e ser igualmente válido.
- São validados os GTIN enviados e, caso não sejam válidos, o POST não será permitido.
- Recomenda-se incluir a marca e, pelo menos, um dos outros identificadores. Essas são condições necessárias para poder participar em programas de publicações de produtos de terceiros, como o Google Shopping.
Referência do código da mensagem
Error_code | Tipo de erro | Mensagem de erro | Descrição | Solução possível |
---|---|---|---|---|
7710 | ERROR | Product Identifier [GTIN] has invalid values: [00000000] | O Product Identifier que foi inserido não é válido | Introduzir um Product Identifier válido |
7711 | ERROR | Product Identifier [GTIN] has invalid format values: [abc12345] | O identificador de produto inserido tem um formato incorreto | Introduzir um Product Identifier válido |
7712 | ERROR | Product Identifier [GTIN] with values 1234567890 corresponds to CATEGORY [CELLPHONES] | O identificador de produto inserido não corresponde à categoria/produto | Introduzir um identificador de produto válido para o Catálogo |
7713 | ERROR | Product Identifier [GTIN] with values 1234567890 corresponds to BRAND [Samsung] | O identificador de produto inserido não corresponde à marca selecionada | Introduzir um Product Identifier válido para o Catálogo |
7714 | ERROR | Product Identifier [GTIN] with values 1234567890 corresponds to product [iPhone 11 Pro Max 64 GB Gris espacial 4 GB RAM] | O identificador de produto inserido não corresponde ao produto selecionado | Introduzir um identificador de produto válido para o Catálogo |
7810 | ERROR | The attributes [GTIN] are required for category [CELLPHONES] and brand Samsung. Check the attribute is present in the attributes list or in all variation's attributes_combination or attributes | O identificador do produto é obrigatório | Insira um identificador de produto |
Descrição de identificadores de recurso
BRAND: Marca.
MPN: Número de Parte do Fabricante.
GTIN: Número Mundial do Artigo Comercial [Global Trade Item Number] para o Artigo.
Part Number
Denomina-se Part Number os códigos que servem para localizar univocamente uma peça automotiva, definindo as compatibilidades da peça, entre outras coisas. Com base num determinado número de parte, podemos saber para que tipo de automóvel corresponde a peça.
Próximo: Qualidade das publicações.
