Identificadores de produtos

Os identificadores são códigos que servem para localizar um produto univocamente. Conheça mais como identificar o código universal de produto.

Conteúdo

→GTIN e tipos de identificadores
→Enviar as informações dos identificadores de produtos
→Acrescentar as informações num item já existente
    ↳Exemplo de modificações do item
→Consultar as informações sobre os identificadores de seus produtos?
→Considerações
→Descrição de identificadores de recurso
→Part Number


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.

Nota:
Caso o item tenha variações, você poderá especificar um identificador de produto para cada uma delas, em sua seção de atributos identificadores de produtos.

Exemplo do item sem variações:

curl -X POST -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?access_token=$ACCESS_TOKEN'

Exemplo do item com variações:

curl -X POST -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?access_token=$ACCESS_TOKEN'

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 -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 -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 https://api.mercadolibre.com/items/$ITEM_ID?include_attributes=all

Exemplo:

curl -X GET 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": [
    "brand_verified",
    "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
}
Nota:
Lembre-se que caso torne a publicar seu artigo, o identificador de produto que você enviou para a publicação original será mantido automaticamente.

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.

ou registre-se para receber as últimas notícias sobre nossa API