Product identifiers

Identifiers are codes used to unequivocally locate a product. Learn more about how to identify the product universal code.

Contents

→GTIN and identifiers types
→Send product identifier information
→Add information to an existing item
    ↳Example of item variation
→Query information about product identifiers
→Considerations
→Resource identifier description
→Part Number


GTIN and identifiers types

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. The GTIN will save all the PIs in this field, concatenating values. This is a standard that includes EAN, UPC, JAN, GTIN14, ISBN, ISBN10 and ISBN13 codes.
Currently, the attribute has new_required and conditional_required tag that indicates that it is mandatory depends the case.


Send product identifier information

You can send this information just like you post attributes, regardless of the category.

Note:
In case the item has variations, you can specify each variation in the product identifier attribute section.

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": "GTIN", "value_name": "977015057271221" }
    ]
}' '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": "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'

Add information to an existing item

Example of item variation:

All IDs of the existing attributes of the item must be sent, adding the GTIN attribute with the corresponding product code.
No variations

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

With variations

In the same way that any attribute in a variation is added or modified, to add or modify them you must indicate the list of variations that you want to remain in the item (indicating its variation ID), and adding the list of attributes that you want remain in each of the variations.

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'

Remember, if the item have the GTIN attribute to item level, cannot specify again to variant level. In this case, you have to quit to item level and then, specify to variation level.


Query information about product identifiers

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

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

Example:

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

Response:

{
  "id": "MLA633578907",
  "site_id": "MLA",
  "title": "Coche Mega Baby Bebe Convertible Tres En Uno Con Huevito + Asiento Moisés Cuna Plegable Liviano",
  "subtitle": null,
  "seller_id": 158482976,
  "category_id": "MLA1386",
  "official_store_id": 89,
  "price": 13599,
  "base_price": 13599,
  "original_price": 22000,
  "currency_id": "ARS",
  "initial_quantity": 433,
  "available_quantity": 2,
  "sold_quantity": 150,
  "sale_terms": [
  ],
  "buying_mode": "buy_it_now",
  "listing_type_id": "gold_special",
  "start_time": "2016-09-02T17:39:11.000Z",
  "stop_time": "2038-11-18T14:00:44.000Z",
  "condition": "new",
  "permalink": "https://articulo.mercadolibre.com.ar/MLA-633578907-coche-mega-baby-bebe-convertible-tres-en-uno-con-huevito-asiento-moises-cuna-plegable-liviano-_JM",
  "thumbnail": "http://mla-s2-p.mlstatic.com/983306-MLA32083317355_092019-I.jpg",
  "secure_thumbnail": "https://mla-s2-p.mlstatic.com/983306-MLA32083317355_092019-I.jpg",
  "pictures": [
    {
      "id": "735548-MLA32083300337_092019",
      "url": "http://mla-s2-p.mlstatic.com/735548-MLA32083300337_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/735548-MLA32083300337_092019-O.jpg",
      "size": "500x480",
      "max_size": "1250x1200",
      "quality": ""
    },
    {
      "id": "741789-MLA32019273642_082019",
      "url": "http://mla-s2-p.mlstatic.com/741789-MLA32019273642_082019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/741789-MLA32019273642_082019-O.jpg",
      "size": "491x500",
      "max_size": "1280x1302",
      "quality": ""
    },
    {
      "id": "747789-MLA32043220670_092019",
      "url": "http://mla-s2-p.mlstatic.com/747789-MLA32043220670_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/747789-MLA32043220670_092019-O.jpg",
      "size": "349x500",
      "max_size": "898x1284",
      "quality": ""
    },
    {
      "id": "624468-MLA32043228118_092019",
      "url": "http://mla-s2-p.mlstatic.com/624468-MLA32043228118_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/624468-MLA32043228118_092019-O.jpg",
      "size": "453x500",
      "max_size": "1102x1215",
      "quality": ""
    },
    {
      "id": "900307-MLA32043240018_092019",
      "url": "http://mla-s2-p.mlstatic.com/900307-MLA32043240018_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/900307-MLA32043240018_092019-O.jpg",
      "size": "341x500",
      "max_size": "844x1237",
      "quality": ""
    },
    {
      "id": "783902-MLA32043240019_092019",
      "url": "http://mla-s2-p.mlstatic.com/783902-MLA32043240019_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/783902-MLA32043240019_092019-O.jpg",
      "size": "491x500",
      "max_size": "1280x1302",
      "quality": ""
    },
    {
      "id": "658934-MLA32083311321_092019",
      "url": "http://mla-s2-p.mlstatic.com/658934-MLA32083311321_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/658934-MLA32083311321_092019-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "857876-MLA32083298383_092019",
      "url": "http://mla-s2-p.mlstatic.com/857876-MLA32083298383_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/857876-MLA32083298383_092019-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "754490-MLA32083300393_092019",
      "url": "http://mla-s2-p.mlstatic.com/754490-MLA32083300393_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/754490-MLA32083300393_092019-O.jpg",
      "size": "485x500",
      "max_size": "1196x1232",
      "quality": ""
    },
    {
      "id": "923540-MLA32083298413_092019",
      "url": "http://mla-s2-p.mlstatic.com/923540-MLA32083298413_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/923540-MLA32083298413_092019-O.jpg",
      "size": "500x294",
      "max_size": "1302x766",
      "quality": ""
    },
    {
      "id": "983306-MLA32083317355_092019",
      "url": "http://mla-s2-p.mlstatic.com/983306-MLA32083317355_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/983306-MLA32083317355_092019-O.jpg",
      "size": "500x465",
      "max_size": "1302x1213",
      "quality": ""
    },
    {
      "id": "786695-MLA32314105615_092019",
      "url": "http://mla-s2-p.mlstatic.com/786695-MLA32314105615_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/786695-MLA32314105615_092019-O.jpg",
      "size": "500x274",
      "max_size": "546x300",
      "quality": ""
    },
    {
      "id": "716553-MLA32019273687_082019",
      "url": "http://mla-s2-p.mlstatic.com/716553-MLA32019273687_082019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/716553-MLA32019273687_082019-O.jpg",
      "size": "491x500",
      "max_size": "1260x1282",
      "quality": ""
    },
    {
      "id": "871381-MLA32043231631_092019",
      "url": "http://mla-s2-p.mlstatic.com/871381-MLA32043231631_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/871381-MLA32043231631_092019-O.jpg",
      "size": "336x500",
      "max_size": "844x1255",
      "quality": ""
    },
    {
      "id": "669449-MLA32043220719_092019",
      "url": "http://mla-s2-p.mlstatic.com/669449-MLA32043220719_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/669449-MLA32043220719_092019-O.jpg",
      "size": "453x500",
      "max_size": "1102x1215",
      "quality": ""
    },
    {
      "id": "826780-MLA32043193495_092019",
      "url": "http://mla-s2-p.mlstatic.com/826780-MLA32043193495_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/826780-MLA32043193495_092019-O.jpg",
      "size": "491x500",
      "max_size": "1260x1282",
      "quality": ""
    },
    {
      "id": "677524-MLA32083353656_092019",
      "url": "http://mla-s2-p.mlstatic.com/677524-MLA32083353656_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/677524-MLA32083353656_092019-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "942096-MLA32083321358_092019",
      "url": "http://mla-s2-p.mlstatic.com/942096-MLA32083321358_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/942096-MLA32083321358_092019-O.jpg",
      "size": "485x500",
      "max_size": "1196x1232",
      "quality": ""
    },
    {
      "id": "917084-MLA32083298482_092019",
      "url": "http://mla-s2-p.mlstatic.com/917084-MLA32083298482_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/917084-MLA32083298482_092019-O.jpg",
      "size": "500x500",
      "max_size": "1200x1200",
      "quality": ""
    },
    {
      "id": "952714-MLA32083364095_092019",
      "url": "http://mla-s2-p.mlstatic.com/952714-MLA32083364095_092019-O.jpg",
      "secure_url": "https://mla-s2-p.mlstatic.com/952714-MLA32083364095_092019-O.jpg",
      "size": "453x500",
      "max_size": "1102x1215",
      "quality": ""
    }
  ],
  "video_id": null,
  "descriptions": [
    {
      "id": "MLA633578907-1168469391"
    }
  ],
  "accepts_mercadopago": true,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
    "mode": "me2",
    "free_methods": [
      {
        "id": 73328,
        "rule": {
          "default": true,
          "free_mode": "country",
          "free_shipping_flag": true,
          "value": null
        }
      }
    ],
    "tags": [
      "self_service_in",
      "fbm_in_process",
      "mandatory_free_shipping"
    ],
    "dimensions": null,
    "local_pick_up": false,
    "free_shipping": true,
    "logistic_type": "cross_docking",
    "store_pick_up": false
  },
  "international_delivery_mode": "none",
  "seller_address": {
    "city": {
      "name": "Villa Adelina"
    },
    "state": {
      "id": "AR-B",
      "name": "Buenos Aires"
    },
    "country": {
      "id": "AR",
      "name": "Argentina"
    },
    "search_location": {
      "neighborhood": {
        "id": "TUxBQlZJTDI2MDZa",
        "name": "Villa Adelina"
      },
      "city": {
        "id": "TUxBQ1NBTjg4ZmJk",
        "name": "San Isidro"
      },
      "state": {
        "id": "TUxBUEdSQWU4ZDkz",
        "name": "Bs.As. G.B.A. Norte"
      }
    },
    "latitude": -34.511597,
    "longitude": -58.543797,
    "id": 141524093
  },
  "seller_contact": null,
  "location": {
  },
  "geolocation": {
    "latitude": -34.511597,
    "longitude": -58.543797
  },
  "coverage_areas": [
  ],
  "attributes": [
    {
      "id": "CONSTRUCTION_MATERIAL",
      "name": "Material de la estructura",
      "value_id": null,
      "value_name": "Aluminio",
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "Aluminio",
          "struct": null
        }
      ],
      "attribute_group_id": "",
      "attribute_group_name": ""
    },
    {
      "id": "3_IN_1",
      "name": "Es 3 en 1",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "values": [
        {
          "id": "242085",
          "name": "Sí",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "ACCESSORIES_INCLUDED",
      "name": "Accesorios incluidos",
      "value_id": null,
      "value_name": "Canasto,Cubrepie,Mosquitero",
      "value_struct": null,
      "values": [
        {
          "id": "3675752",
          "name": "Canasto",
          "struct": null
        },
        {
          "id": "110959",
          "name": "Cubrepie",
          "struct": null
        },
        {
          "id": null,
          "name": "Mosquitero",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "BRAND",
      "name": "Marca",
      "value_id": "2417128",
      "value_name": "Mega Baby",
      "value_struct": null,
      "values": [
        {
          "id": "2417128",
          "name": "Mega Baby",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "CUSHION_MATERIAL",
      "name": "Material de la funda",
      "value_id": null,
      "value_name": "Espuma",
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "Espuma",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "IS_RECLINING",
      "name": "Es reclinable",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "values": [
        {
          "id": "242085",
          "name": "Sí",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "ITEM_CONDITION",
      "name": "Condición del ítem",
      "value_id": "2230284",
      "value_name": "Nuevo",
      "value_struct": null,
      "values": [
        {
          "id": "2230284",
          "name": "Nuevo",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "MODEL",
      "name": "Modelo",
      "value_id": "2514412",
      "value_name": "Lanin",
      "value_struct": null,
      "values": [
        {
          "id": "2514412",
          "name": "Lanin",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "RECLINING_POSITIONS_NUMBER",
      "name": "Cantidad de posiciones de reclinado",
      "value_id": null,
      "value_name": "4",
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "4",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "SECURITY_SYSTEM_TYPE",
      "name": "Tipo de sistema de seguridad",
      "value_id": null,
      "value_name": "arnes 5 puntos",
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "arnes 5 puntos",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "STROLLER_CAPACITY",
      "name": "Capacidad del cochecito",
      "value_id": null,
      "value_name": "25 kilos",
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "25 kilos",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "STROLLER_TYPE",
      "name": "Tipo de cochecito",
      "value_id": "400208",
      "value_name": "De paseo",
      "value_struct": null,
      "values": [
        {
          "id": "400208",
          "name": "De paseo",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "TRAVEL_SYSTEM",
      "name": "Incluye travel system",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "values": [
        {
          "id": "242085",
          "name": "Sí",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "WEIGHT_LIMIT",
      "name": "Peso máximo soportado",
      "value_id": null,
      "value_name": "18 kg",
      "value_struct": {
        "number": 18,
        "unit": "kg"
      },
      "values": [
        {
          "id": null,
          "name": "18 kg",
          "struct": {
            "number": 18,
            "unit": "kg"
          }
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "WHEELS_AMOUNT",
      "name": "Cantidad de ruedas",
      "value_id": "925314",
      "value_name": "4",
      "value_struct": null,
      "values": [
        {
          "id": "925314",
          "name": "4",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "WHEELS_TYPE",
      "name": "Tipo de ruedas",
      "value_id": null,
      "value_name": "Simple",
      "value_struct": null,
      "values": [
        {
          "id": null,
          "name": "Simple",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "WITH_BRAKES",
      "name": "Con frenos",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "values": [
        {
          "id": "242085",
          "name": "Sí",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    },
    {
      "id": "WITH_RETRACTABLE_CANOPY",
      "name": "Con capota retráctil",
      "value_id": "242085",
      "value_name": "Sí",
      "value_struct": null,
      "values": [
        {
          "id": "242085",
          "name": "Sí",
          "struct": null
        }
      ],
      "attribute_group_id": "OTHERS",
      "attribute_group_name": "Otros"
    }
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
    {
      "id": 42554311661,
      "price": 13599,
      "attribute_combinations": [
        {
          "id": "COLOR",
          "name": "Color",
          "value_id": "52035",
          "value_name": "Violeta",
          "value_struct": null,
          "values": [
            {
              "id": "52035",
              "name": "Violeta",
              "struct": null
            }
          ]
        },
        {
          "id": "CHASSIS_COLOR",
          "name": "Color del chasis",
          "value_id": "3089652",
          "value_name": "Plateado",
          "value_struct": null,
          "values": [
            {
              "id": "3089652",
              "name": "Plateado",
              "struct": null
            }
          ]
        }
      ],
      "available_quantity": 1,
      "sold_quantity": 50,
      "sale_terms": [
      ],
      "picture_ids": [
        "983306-MLA32083317355_092019",
        "786695-MLA32314105615_092019",
        "716553-MLA32019273687_082019",
        "871381-MLA32043231631_092019",
        "669449-MLA32043220719_092019",
        "826780-MLA32043193495_092019",
        "677524-MLA32083353656_092019",
        "942096-MLA32083321358_092019",
        "917084-MLA32083298482_092019",
        "952714-MLA32083364095_092019"
      ],
      "catalog_product_id": "MLA14061788",
      "attributes": [
        {
          "id": "PACKAGE_HEIGHT",
          "name": "Altura del paquete",
          "value_id": null,
          "value_name": "68 cm",
          "value_struct": {
            "number": 68,
            "unit": "cm"
          },
          "values": [
            {
              "id": null,
              "name": "68 cm",
              "struct": {
                "number": 68,
                "unit": "cm"
              }
            }
          ]
        },
        {
          "id": "PACKAGE_WIDTH",
          "name": "Ancho del paquete",
          "value_id": null,
          "value_name": "68 cm",
          "value_struct": {
            "number": 68,
            "unit": "cm"
          },
          "values": [
            {
              "id": null,
              "name": "68 cm",
              "struct": {
                "number": 68,
                "unit": "cm"
              }
            }
          ]
        },
        {
          "id": "MAIN_COLOR",
          "name": "Color principal",
          "value_id": "2450311",
          "value_name": "Violeta",
          "value_struct": null,
          "values": [
            {
              "id": "2450311",
              "name": "Violeta",
              "struct": null
            }
          ]
        },
        {
          "id": "GTIN",
          "name": "Código universal de producto",
          "value_id": null,
          "value_name": "7793400588119",
          "value_struct": null,
          "values": [
            {
              "id": null,
              "name": "7793400588119",
              "struct": null
            }
          ]
        },
        {
          "id": "EAN",
          "name": "EAN",
          "value_id": null,
          "value_name": "7793400588119",
          "value_struct": null,
          "values": [
            {
              "id": null,
              "name": "7793400588119",
              "struct": null
            }
          ]
        },
        {
          "id": "PACKAGE_LENGTH",
          "name": "Largo del paquete",
          "value_id": null,
          "value_name": "68 cm",
          "value_struct": {
            "number": 68,
            "unit": "cm"
          },
          "values": [
            {
              "id": null,
              "name": "68 cm",
              "struct": {
                "number": 68,
                "unit": "cm"
              }
            }
          ]
        },
        {
          "id": "PACKAGE_WEIGHT",
          "name": "Peso del paquete",
          "value_id": null,
          "value_name": "17000 g",
          "value_struct": {
            "number": 17000,
            "unit": "g"
          },
          "values": [
            {
              "id": null,
              "name": "17000 g",
              "struct": {
                "number": 17000,
                "unit": "g"
              }
            }
          ]
        },
        {
          "id": "SELLER_SKU",
          "name": "SKU",
          "value_id": null,
          "value_name": "7793400588119",
          "value_struct": null,
          "values": [
            {
              "id": null,
              "name": "7793400588119",
              "struct": null
            }
          ]
        }
      ]
    },
    {
      "id": 42554311647,
      "price": 13599,
      "attribute_combinations": [
        {
          "id": "COLOR",
          "name": "Color",
          "value_id": "283164",
          "value_name": "Dorado",
          "value_struct": null,
          "values": [
            {
              "id": "283164",
              "name": "Dorado",
              "struct": null
            }
          ]
        },
        {
          "id": "CHASSIS_COLOR",
          "name": "Color del chasis",
          "value_id": "3089652",
          "value_name": "Plateado",
          "value_struct": null,
          "values": [
            {
              "id": "3089652",
              "name": "Plateado",
              "struct": null
            }
          ]
        }
      ],
      "available_quantity": 1,
      "sold_quantity": 100,
      "sale_terms": [
      ],
      "picture_ids": [
        "735548-MLA32083300337_092019",
        "741789-MLA32019273642_082019",
        "747789-MLA32043220670_092019",
        "624468-MLA32043228118_092019",
        "900307-MLA32043240018_092019",
        "783902-MLA32043240019_092019",
        "658934-MLA32083311321_092019",
        "857876-MLA32083298383_092019",
        "754490-MLA32083300393_092019",
        "923540-MLA32083298413_092019"
      ],
      "catalog_product_id": "MLA14061786",
      "attributes": [
        {
          "id": "PACKAGE_HEIGHT",
          "name": "Altura del paquete",
          "value_id": null,
          "value_name": "68 cm",
          "value_struct": {
            "number": 68,
            "unit": "cm"
          },
          "values": [
            {
              "id": null,
              "name": "68 cm",
              "struct": {
                "number": 68,
                "unit": "cm"
              }
            }
          ]
        },
        {
          "id": "PACKAGE_WIDTH",
          "name": "Ancho del paquete",
          "value_id": null,
          "value_name": "68 cm",
          "value_struct": {
            "number": 68,
            "unit": "cm"
          },
          "values": [
            {
              "id": null,
              "name": "68 cm",
              "struct": {
                "number": 68,
                "unit": "cm"
              }
            }
          ]
        },
        {
          "id": "MAIN_COLOR",
          "name": "Color principal",
          "value_id": "2450289",
          "value_name": "Dorado",
          "value_struct": null,
          "values": [
            {
              "id": "2450289",
              "name": "Dorado",
              "struct": null
            }
          ]
        },
        {
          "id": "GTIN",
          "name": "Código universal de producto",
          "value_id": null,
          "value_name": "7793400588102",
          "value_struct": null,
          "values": [
            {
              "id": null,
              "name": "7793400588102",
              "struct": null
            }
          ]
        },
        {
          "id": "EAN",
          "name": "EAN",
          "value_id": null,
          "value_name": "7793400588102",
          "value_struct": null,
          "values": [
            {
              "id": null,
              "name": "7793400588102",
              "struct": null
            }
          ]
        },
        {
          "id": "PACKAGE_LENGTH",
          "name": "Largo del paquete",
          "value_id": null,
          "value_name": "68 cm",
          "value_struct": {
            "number": 68,
            "unit": "cm"
          },
          "values": [
            {
              "id": null,
              "name": "68 cm",
              "struct": {
                "number": 68,
                "unit": "cm"
              }
            }
          ]
        },
        {
          "id": "PACKAGE_WEIGHT",
          "name": "Peso del paquete",
          "value_id": null,
          "value_name": "17000 g",
          "value_struct": {
            "number": 17000,
            "unit": "g"
          },
          "values": [
            {
              "id": null,
              "name": "17000 g",
              "struct": {
                "number": 17000,
                "unit": "g"
              }
            }
          ]
        },
        {
          "id": "SELLER_SKU",
          "name": "SKU",
          "value_id": null,
          "value_name": "7793400588102",
          "value_struct": null,
          "values": [
            {
              "id": null,
              "name": "7793400588102",
              "struct": null
            }
          ]
        }
      ]
    }
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
    "good_quality_thumbnail",
    "loyalty_discount_eligible",
    "today_promotion",
    "brand_verified",
    "deal_of_the_day",
    "good_quality_picture",
    "immediate_payment",
    "cart_eligible"
  ],
  "warranty": "6 meses de garantía",
  "catalog_product_id": "MLA14061786",
  "domain_id": "MLA-BABY_STROLLERS",
  "parent_item_id": null,
  "differential_pricing": null,
  "deal_ids": [
    "MLA3294"
  ],
  "automatic_relist": false,
  "date_created": "2016-09-02T17:39:11.000Z",
  "last_updated": "2020-02-11T14:19:28.588Z",
  "health": 0.9,
  "catalog_listing": false
}
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.
  • Now, you should take this into account when loading Product Identifiers. The GTIN will save all the PIs in this field, concatenating values. Just like the ISBN, with the identifiers that it includes.
  • Check if the attribute has the tag new_required and the condition of the item is new, since the attribute is mandatory to publish.
  • 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.
  • GTINs sent are validated and, if not valid, the POST will not be allowed.
  • 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.

Message code reference

Error_code Error type Error message Description Possible solution
7710 ERROR Product Identifier [GTIN] has invalid values: [00000000] The Product Identifier inserted isn´t valid. Introduce a valid Product Identifier.
7711 ERROR Product Identifier [GTIN] has invalid format values: [abc12345] The Product Identifier inserted isn´t valid. Introduce a valid Product Identifier.
7712 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. The Product Identifier is mandatory. Introduce a Product Identifier.
7713 ERROR Product Identifier [GTIN] with values [1234567890] corresponds to CATEGORY [CELLPHONES] The Product Identifier introduced isn´t match with the category/product. Introduce a valid Product Identifier to catalogue.

Resource identifier description

BRAND: Brand.
MPN: Manufacturer Part Number.
GTIN: Global Trade Item Number.

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.


Next topic: Variations.

or register to recieve the latest news about our API