Última actualización 15/03/2023
Identificadores de productos
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.
Ejemplo de ítem sin variaciones:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -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'Ejemplo de ítem con variaciones:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -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'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 -H 'Authorization: Bearer $ACCESS_TOKEN' -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 -H 'Authorization: Bearer $ACCESS_TOKEN' -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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID?include_attributes=allEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB558871250?include_attributes=allRespuesta:
{
"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",
"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
}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
| 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.