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

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.