Product identifiers

Identifiers are codes used to unequivocally locate a product.

Contents:

What is GTIN?

GTIN (Global Trade Item Number) is the global trade item number used to unequivocally identify any product or item about which there is a need to both retrieve specific information and put a price to.
It is a standard that includes codes: EAN, UPC, JAN, ISBN13.

Who can send us this information?

Using API-based resources, every seller from Argentina, Brazil, Chile, Colombia, Mexico, and Uruguay can send product identifiers as attributes in their listings.

Important: We will highlight the listings from sellers who send this information correctly.

In turn, high-level reputation sellers from Brazil and Mexico who send product identifiers will have a chance to be selected and display their items in the Google Shopping catalog.

How can I differentiate them from other attributes?

They read “type”: “product_identifier” and you can find them in the attribute section or variation.
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.

Benefits

  • Future benefit: To automatically categorize items.
  • Future benefit: To complete item attributes and display them in a VIP data sheet.
  • To boost your listings to the top Search results when you load your product identifier code.

How should I send product identifier information?

You can send this information just like you post attributes, with the possibility of sending any category.

Note: If the item has variations, you can specify a attribute product identifier.

Example of item without variations

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'

Example of item with variations

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'

How can I add information to an existing item?

Example modification of item:

All existing attributes of the item must be sent including the product identifier code.

Without variation

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

With variation
For items with variations, if you send the previous PUT, the attribute will be replicated for all variations as product identifiers have variation_attributes. To specify a different product identifier for each variation, see the example below:

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

Just as you modify any attribute in a variation, to modify them you should specify the list of variations that should remain in the item (specifying their variation ID), and add the list of attributes that should remain in each variation.

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'

Watch the following video tutorial explaining in detail how to perform the above tasks.

How can I query information about my product identifiers?

To get this information, you should make a GET to the API:
Call:

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

Note: Remember that if you relist an item, the Product Identifier that you sent for the original listing will automatically remain.

Considerations

  • They are not internal SKUs.
  • The number of characters varies by code type: they can have 8, 10, 12, 13 or 14 characters. You can even rewrite the same code with left zero padding and it will still be valid.
  • The sent GTINs are validated and, if not valid, the API will disregard them.
  • You can send more than one identifier code for the same product. For example, EAN and UPC.
  • It is advisable to include the Brand and, at least, one additional identifier. These are the conditions required to participate in third-party product listings, such as Google Shopping.
  • If you want to waive this benefit, just send an e-mail to the e-mail addresses below:
    Brazilian sellers: gps-optout@mercadolivre.com.br
    Spanish-speaking sellers: gps-optout@mercadolibre.com
    Subject: cancel subscription {SellerId}
    Message: (optional). Reason why you waive the benefit.
    Remember that, if you waive the benefit, none of your products will be displayed on Google Shopping.

Resource Identifier Description

BRAND: Brand
MPN: Manufacturer Part Number.
GTIN: Global Trade Item Number.
ISBN: International Standard Book Number. Unique identifier for books, intended for commercial use.

There are two types:

ISBN-10
Ten-character code, where the first 9 are always digits, but the last one can be either a digit or a letter ‘X’. This version of the code is NOT compliant with the GTIN standard; however, it can be provided if items so require.
ISBN-13
Numeric 13-character code, included in the GTIN standard.

EAN: European Article Number (now renamed International Article Number). Bar code system used by over 100 countries.

UPC: Universal Product Code. Bar code system generally used in the US and Canada.
upc

JAN: Japanese Article Number. Product identification code system used in Japan. It is compliant with EAN-13 code length and validations.

Part Number

The codes used to unequivocally locate an automotive spare part by defining the spare part compatibilities, among others, are referred to as Part Numbers.
Based on a specific part number we can learn the car for which it is used.

Benefits

  • The lists of the people who load them will be indexed by the car part widget.
  • This will result in a more accurate search method.

ejemplo-partnumber

Next:
Variations.

Please rate this