Identificadores de productos

Los identificadores son códigos que sirven para localizar unívocamente a un producto. Conoce más cómo identificar el código universal de producto.

Contenidos

→GTIN y tipos de identificadores
→Enviar la información de los identificadores de productos
→Agregar la información a un ítem existente?
    ↳Ejemplo de modificaciones de ítem
→Consultar la información sobre los identificadores de tus productos
→Consideraciones
→Descripción de identificadores de recursos
→Part Number


GTIN y tipos de identificadores

El 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. Incluye todos los identificadores de producto (PIs) en este campo, como los códigos EAN, UPC, JAN,GTIN14, ISBN, ISBN10 e ISBN13.
Actualmente, el atributo cuenta con los tags new_required y conditional_required que indican su obligatoriedad dependiendo en cada caso.


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

Agregar la información a un ítem existente

Ejemplo de modificaciones de item:

Se deberán enviar todos los IDs de los atributos existentes del ítem, sumando el atributo GTIN con el código de producto correspondiente.
Sin variaciones

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

Con variaciones

De la misma forma que se agrega o modifica cualquier atributo en una variación, para agregarlos o modificarlos se debe indicar la lista de variaciones que se desea permanezcan en el ítem (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": "GTIN",
      "value_name": "7015057271221"
    }]
  }, {
    "id": 847326282,
    "attributes": [{
      "id": "GRILL",
      "value_name": "No"
    }]
  }]
}' 'https://api.mercadolibre.com/items/MLA642016284'

Ten en cuenta que si el ítem ya posee el atributo GTIN a nivel ítem, no podrás volver a especificarlo a nivel variante. En ese caso, primero debes borrarlo a nivel ítem para luego, especificarlo a nivel variación.


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/$ITEM_ID?include_attributes=all

Ejemplo:

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

Respuesta:

{
  "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
}
Nota:
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.
  • Puedes enviar más de un código identificador para un mismo producto. En ese caso, debes enviar en el atributo GTIN todos los códigos de producto separados por coma.
  • Recuerda verificar en /attributes si los atributos están marcados con los siguientes tags:
    - required, el atributo es obligatorio.
    - new_required, el atributo es obligatorio si la condición del ítem es nueva
    - conditional_required, verifica si el atributo es obligatorio realizando un POST al nuevo recurso recurso /attributes/conditional con toda la información del ítem y reconocerás qué atributos son requeridos para esa publicación.
  • 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 completándose con ‘0’s al comienzo e igual ser válido.
  • Se validan los GTIN enviados y en caso de no ser válidos, no se permitirá realizar el POST.
  • 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.

Referencia de código de mensajes

Importante:
A partir del 9 de octubre de 2020, si realizas un POST a ítems sin los atributos requeridos completos, podrás obtener el error 7712. Conoce más sobre Atributos obligatorios.
Error_code Tipo de error Mensaje de error Descripción Posible solución
7710 ERROR Product Identifier [GTIN] has invalid values: [00000000] El Product Identifier ingresado no es válido Ingresar un Product Identifier válido
7711 ERROR Product Identifier [GTIN] has invalid format values: [abc12345] El Product Identifier ingresado tiene formato incorrecto Ingresar un Product Identifier válido
7712 ERROR Product Identifier [GTIN] with values 1234567890 corresponds to CATEGORY [CELLPHONES] El Product Identifier ingresado no corresponde con la categoría/producto Ingresar un Product Identifier válido para el Catálogo
7713 ERROR Product Identifier [GTIN] with values 1234567890 corresponds to BRAND [Samsung] El Product Identifier ingresado no corresponde a la marca seleccionada Ingresar un Product Identifier válido para el Catálogo
7714 ERROR Product Identifier [GTIN] with values 1234567890 corresponds to product [iPhone 11 Pro Max 64 GB Gris espacial 4 GB RAM] El Product Identifier ingresado no corresponde al producto seleccionado Ingresar un Product Identifier válido para el 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 El Product Identifier es requerido Ingresar un Product Identifier

Descripción de identificadores de recursos

BRAND: Marca.
MPN: Número de Parte del Fabricante.
GTIN: Número Mundial del Artículo Comercial [Global Trade Item Number] para el Artículo.

Part Number

Son los códigos que utilizamos 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.


Siguiente: Variaciones.

o regístrate para recibir las últimas novedades sobre nuestra API