Identificadores de produtos

Os identificadores são códigos que servem para localizar um produto univocamente.

Conteúdo:

O que é GTIN?

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.
É um padrão que abarca os códigos: EAN, UPC, JAN, ISBN13.

Quem pode nos enviar essas informações?

Mediante recursos via API, todos os vendedores da Argentina, Brasil, Chile, Colômbia, México e Uruguai podem enviar os identificadores de produtos como atributos em suas publicações.

Importante: Serão destacadas as publicações dos vendedores que enviem essas informações corretamente.

Por sua vez, os vendedores do Brasil e do México que possuam um alto nível de reputação e enviem os identificadores de produto terão possibilidades de serem escolhidos para mostrarem seus artigos no catálogo do Google Shopping.

Como posso distingui-los do resto dos atributos?

São aqueles que têm como “type”: “product_identifier” e você poderá encontrá-los na seção de atributos do item ou de cada variação.

Benefícios

  • Benefício no futuro: Categorizar o item automaticamente.
  • Benefício no futuro: Completar os atributos dos itens e mostrá-los numa ficha técnica na VIP.
  • Boost em Search, suas publicações mais acima se você carregar o código identificador de seu produto.

Como devem ser enviadas as informações dos identificadores de produtos?

Podem ser realizadas da mesma forma em que são postados os atributos independente da categoria.
Observação: 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": "EAN", "value_name": "9780471117094" }
    ]
}' '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": "EAN", "value_name": "4006381333931" } ] },
        { "picture_ids": [ "553111-MLA20482692355_112015" ], "available_quantity": 2, "price": 100, "attribute_combinations": [ { "id": "COLOR", "value_id": "52055" } ], "attributes": [ { "id": "EAN", "value_name": "9780471117094" } ] }
    ]
}
' 'https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN'

Como 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": "EAN",
          "value_name": "9780471117094"
        },
{
          "id": "BRAND",
          "value_name": "Philips"
        }
      ]
}''' 'https://api.mercadolibre.com/items/MLA642016284'

Com variações
Caso o item tenha variações, de enviar o PUT anterior, sendo os product identifiers variation_attributes, o atributo será replicado para todas as variações. Caso deseje especificar um product identifier diferente para cada variação, veja o seguinte exemplo:

curl -X PUT -d '{"attributes": [{ "id": "EAN", "value_name": "9780471117094" }]}' https://api.mercadolibre.com/items/{Item_Id}/variations/{Variations_Id}?access_token=$ACCESS_TOKEN

Da mesma maneira em que são modificados qualquer atributo numa variação, para modificá-los deve ser especificada a relação de variações que deseja manter no item (indicando seu id de variação), e acrescentando a relação de atributos que deseja manter em cada uma das variações.

curl -X PUT -d '{
  "variations": [{
    "id": 847326284,
    "attributes": [{
      "id": "EAN",
      "value_name": "9780471117094"
    }]
  }, {
    "id": 847326282,
    "attributes": [{
      "id": "GRILL",
      "value_name": "No"
    }]
  }]
}' 'https://api.mercadolibre.com/items/MLA642016284'

Convidamos você para assistir o seguinte vídeo tutorial que explicará detalhadamente como realizar as ações comentadas.

Como 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/MLB558871250?include_attributes=all

Observação: 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.
  • 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, não serão considerados pela API.
  • Você pode enviar mais de um código identificador para um mesmo produto. Por exemplo, EAN e UPC.
  • 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.
  • Se você deseja renunciar ao benefício, envie um e-mail aos seguintes endereços:
    Vendedores brasileiros: gps-optout@mercadolivre.com.br
    Vendedores hispanos: gps-optout@mercadolibre.com
    Assunto: cancelar assinatura {SellerId}
    Mensagem: (opcional). Motivo pelo qual renuncia ao benefício.
    Lembre-se que, caso renuncie ao benefício, nenhum de seus produtos será mostrado no Google Shopping.

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.
ISBN: International Standard Book Number. É um identificador único para livros, previsto para uso comercial.

Existem dois tipos:

ISBN-10
É um código de 10 caracteres, em que os primeiros 9 sempre são dígitos, porém o último pode ser um dígito ou uma letra ‘X’. Esta versão do código NÃO é compatível com o padrão GTIN, porém pode ser fornecido para os itens que assim sejam requeridos.
ISBN-13
É um código numérico de 13 caracteres, contemplado no padrão GTIN.

EAN: European Article Number (agora, modificado para International Article Number). É um sistema de código de barras adotado em mais de 100 países.

UPC: Universal Product Code. Sistema de código de barras usado normalmente nos Estados Unidos e Canadá.
upc

JAN: Japanese Article Number. É o sistema de códigos de identificação de produtos utilizado no Japão. É compatível com o comprimento e as validações dos códigos EAN-13.

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.

Benefícios

  • A relação das pessoas que o carreguem será indexada pelo widget de autopeças.
  • Será alcançado um método de pesquisa mais acertado.

ejemplo-partnumber
Próximo:
Variações.

Please rate this