Identificadores de productos

Los identificadores son códigos que sirven para localizar unívocamente a un producto.

Contenido:

¿Qué es GTIN?

GTIN (Global Trade Item Number) es el número mundial de un artículo comercial, utilizado para identificar de manera única a cualquier producto o ítem sobre el que existe una necesidad de obtener información específica y se le debe asignar un precio.
Es un estándar que engloba a los códigos: EAN, UPC, JAN, ISBN13.

¿Quién puede enviarnos esta información?

Mediante recursos vía API, todos los vendedores de Argentina, Brasil, Chile, Colombia, México y Uruguay pueden enviar los identificadores de productos como atributos en sus publicaciones.

Importante: Destacaremos las publicaciones de aquellos vendedores que envíen esta información correctamente.

A su vez, aquellos vendedores dentro de Brasil y México que cuenten con nivel de reputación alto y envíen los identificadores de producto tendrán posibilidades de ser elegidos para mostrar sus artículos en el catálogo de Google Shopping.

¿Cómo los distingo del resto de los atributos?

Son aquellos que tienen como “type”: “product_identifier” y los podrás encontrar en la sección de atributos del ítem o de cada variación.

Beneficios

  • Beneficio en un futuro: Categorizar automáticamente el ítem.
  • Beneficio en un futuro: Completar los atributos de los ítems y mostrarlos en una ficha técnica en la VIP.
  • Boost en Search, tus publicaciones más arriba si cargas el código identificador de tu producto.

¿Cómo se debe enviar la información de los identificadores de productos?

Se puede realizar de la misma manera en que se postean atributos independientemente de la categoría.
Nota: En caso que el ítem tenga variaciones, podrás especificar, en cada una de ellas, en su sección de atributos identificadores de productos.

Ejemplo de ítem sin variaciones

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'

Ejemplo de ítem con variaciones

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'

¿Cómo agregar la información a un ítem existente?

Ejemplo de modificaciones de item

Se deberán enviar todos los atributos existentes del ítem incluyendo el código de identificadores de productos.
Sin variaciones

curl -X PUT -d '''{
  "attributes": [
        {
          "id": "EAN",
          "value_name": "9780471117094"
        },
{
          "id": "BRAND",
          "value_name": "Philips"
        }
      ]
}''' 'https://api.mercadolibre.com/items/MLA642016284'

Con variaciones
En el caso que el ítem tenga variaciones, de enviar el PUT anterior, al ser los product identifiers variation_attributes, el atributo se replicará para todas las variaciones. De querer especificar un product identifier distinto para cada variación, ver el siguiente ejemplo:

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

De la misma forma que se modifica cualquier atributo en una variación, para modificarlos se debe indicar la lista de variaciones que se desea permanezcan en el item (indicando su id de variación), y agregando la lista de atributos que se desea permanezcan en cada una de las variaciones.

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'

Te invitamos a ver el siguiente video tutorial que te explicará en detalle cómo realizar las acciones comentadas.

¿Cómo consultar la información sobre los identificadores de tus productos?

Para obtener estos datos deberás hacer un GET a la API:
Llamada:

curl -X GET https://api.mercadolibre.com/items/MLB558871250?include_attributes=all

Nota: Recuerda que si vuelves a publicar tu artículo, el Identificador de Producto que enviaste para la publicación original se mantendrá automáticamente.

Consideraciones

  • No son SKU internos.
  • La cantidad de caracteres varía por tipo de código: existen de 8, 10, 12, 13 o 14 caracteres. Incluso un mismo código puede volver a escribirse completandose con ‘0’s al comienzo e igual ser válido.
  • Se validan los GTIN enviados y en caso de no ser válidos no serán tenidos en cuenta por la API.
  • Puedes enviar más de un código identificador para un mismo producto. Por ejemplo EAN y UPC.
  • Se recomienda incluir la Marca y, por lo menos, uno de los demás identificadores. Estas son condiciones necesarias para poder participar en programas de publicaciones de productos de terceros, como Google Shopping.
  • Si deseas renunciar al beneficio, envía un correo electrónico a las siguientes direcciones de correo electrónico:
    Vendedores brasileños: gps-optout@mercadolivre.com.br
    Vendedores hispanos: gps-optout@mercadolibre.com
    Asunto: cancelar suscripción {SellerId}
    Mensaje: (opcional). Motivo por el cual se renuncia al beneficio.
    Recuerda que si renuncias al beneficio, ninguno de tus productos se mostrará en Google Shopping.

Descripción de Identificadores de Recurso

BRAND: Marca
MPN: Número de Parte del Fabricante.
GTIN: Números Mundial del Artículo Comercial [Global Trade Item Number] para el Artículo.
ISBN: International Standard Book Number. Es un identificador único para libros, previsto para uso comercial.

Existen dos tipos:

ISBN-10
Es un código de 10 caracteres, donde los primeros 9 siempre son dígitos, pero el último puede bien ser un dígito o una letra ‘X’. Esta versión del código NO es compatible con el estándar GTIN, pero puede ser suministrado para los ítems que así lo requieran.
ISBN-13
Es un código numérico de 13 caracteres, contemplado en el estándar GTIN.

EAN: European Article Number (ahora renombrado a International Article Number). Es un sistema de código de barras adoptado por más de 100 países.

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

JAN: Japanese Article Number. Es el sistema de códigos de identificación de productos usado en Japón. Es compatible con la longitud y validaciones de los códigos EAN-13.

Part Number

Se denomina Part Number a los códigos que sirven para localizar unívocamente a un repuesto automotor definiendo las compatibilidades del repuesto, entre otras cosas.
En base a un determinado número de parte podemos saber a qué tipo de auto aplica el repuesto.

Beneficios

Los listados de las personas que lo carguen van a ser indexados por el widget de autopartes.
Se logrará un método de búsqueda más acertado.
ejemplo-partnumber

Siguiente:
Variaciones.

Por favor califica del 1 al 5