Gestionar guía de talles
Búsqueda de guías de talles
Con el recurso /catalog/charts/search podrás realizar un POST, para filtrar con algunos atributos de tu publicación y reconocer las guías de talle que podrían sugerirse para la publicación. De esta manera podrás filtrar las guías de talles y mostrar las sugerencias para que el vendedor pueda elegir por una guía de talle sugerida, clonar u optar por crear una guía de talle personalizada.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/searchEjemplo:
curl -X POST 'https://api.mercadolibre.com/catalog/charts/search' -H 'x-caller-id: 123456' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' --data-raw '{
"domain_id": "SNEAKERS",
"site_id": "MLA",
"seller_id": 123456,
"attributes": [
{
"id": "GENDER",
"values": [
{
"name": "Mujer"
}
]
},
{
"id": "BRAND",
"values": [
{
"name": "adidas"
}
]
}
]
}'Al momento de realizar búsquedas sobre la guía de talles debes tener en cuenta el atributo con el tag grid_template_required en la ficha técnica este define qué atributos son requeridos para enviar en el POST de la búsqueda para sugerir guías de talles. En todos los casos dominio, site, seller son obligatorios.
Si en el body del POST se envía:
- Sin type se retornan todos los resultados de guías personalizadas, estándar y por marca. De acuerdo a los filtros enviados en el POST.
- Con type= SPECIFIC se retornan todos los resultados de guías personalizadas, de acuerdo a los filtros enviados en el POST de acuerdo al género que se envíe.
- Con type= STANDARD se retornan todos los resultados de guías estándar de acuerdo a los filtros enviados en el POST.
- Con type= BRAND se retornan todos los resultados de guías por marca de acuerdo a los filtros enviados en el POST.
Respuesta:
Como respuesta se obtendrán todos los chart_id que arroje como resultado la búsqueda de guías de acuerdo a los filtros enviados.
{
"charts": [
{
"id": "426237",
"names": {
"MLA": "Guia de talles de calzado de mujer de adidas TEST APPAREL"
},
"domain_id": "SNEAKERS",
"type": "BRAND",
"main_attribute_id": "EU_SIZE",
"secondary_attribute_id": "F_US_SIZE",
"attributes": [],
"rows": []
},
{
"id": "426238",
"names": {
"MLA": "Guía de talles Standard de calzado de mujer TEST"
},
"domain_id": "SNEAKERS",
"type": "STANDARD",
"main_attribute_id": "AR_SIZE",
"secondary_attribute_id": "F_US_SIZE",
"attributes": [],
"rows": []
},
{},
{},
{},
{}
]
}
En caso de que realices una búsqueda con un dominio que no esté configurado con la nueva guía de talles, recibirás un error.
{
"error": "domain_not_active",
"message": "Domain MLA-HATS_AND_CAPS is not active to be used in charts.",
"status": 400
}
De igual manera puedes hacer uso de la búsqueda de guía de talles usando en el filtro el atributo de main_attribute_id en la llamada de ejemplo estamos utilizando UZ_SIZE.
curl -X POST 'https://api.mercadolibre.com/catalog/charts/search' -H 'x-caller-id: 123456' -H 'Content-Type: application/json' -H 'Authorization: Bearer $ACCESS_TOKEN' --data-raw '{
"domain_id": "SNEAKERS",
"site_id": "MLA",
"seller_id": 123456,
"attributes": [
{
"id": "GENDER",
"values": [
{
"name": "Mujer"
}
]
},
{
"id": "BRAND",
"values": [
{
"name": "adidas"
}
]
}
]
}'
Crear guía de talles personalizada
En caso de que quieras crear una guía de talles personalizada deberás usar el recurso de /catalog/charts enviando un POST con la información necesaria para la creación de una guía de talles.
Ten en cuenta la ficha técnica que recibirás como respuesta cuando cargues el atributo requerido para el template, ya que esta ficha técnica contará con los atributos que debes enviar en el POST de creación de la guía de talles, si envías algún atributo que no se encuentre en la ficha retornará error.
Adicionalmente, esta ficha técnica también indica:
- Los tipos de datos (text, number unit, list, etc).
- Los atributos que cuenten con el tag de main_attribute_candidate (Candidatos a ser talle principal) deberás enviar al menos uno como main_atributte.
- Los atributos con el tag de required son obligatorios a excepción de los que también contienen el tag de grid_filter.
- Los atributos que cuenten con el tag grid_filter deben ser cargados a nivel general de guía de talles y no a nivel de rows.
- A nivel de rows, tendrás que enviar aquellos atributos que cuenten con el tag de required únicamente y al menos uno que cuente con el tag de main_attribute_candidate.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/chartsEjemplo de creación de una guía personalizada para un dominio de footwear, para hombres con las medidas desde 40 a la 42 y adicionalmente se define como talle principal el US_SIZE:
curl -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' --data-raw '{
"names": {
"MLA": "Guía de talles de calzado de hombre"
},
"domain_id": "SNEAKERS",
"site_id": "MLA",
"main_attribute": {
"attributes": [
{
"site_id": "MLA",
"id": "M_US_SIZE"
}
]
},
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339666",
"name": "Hombre"
}
]
}
],
"rows": [
{
"attributes": [
{
"id": "AR_SIZE",
"values": [
{
"name": "40 AR"
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "8,5 US"
}
]
},
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "10 cm"
}
]
}
]
},
{
"attributes": [
{
"id": "AR_SIZE",
"values": [
{
"name": "41 AR"
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "9 US"
}
]
},
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "15 cm"
}
]
}
]
},
{
"attributes": [
{
"id": "AR_SIZE",
"values": [
{
"name": "42 AR"
}
]
},
{
"id": "M_US_SIZE",
"values": [
{
"name": "9,5 US"
}
]
},
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "20 cm"
}
]
}
]
}
]
}'Respuesta: creación de la guia de talles para dominios de footwear.
{
"id": "463005",
"names": {
"MLA": "Guía de talles de calzado de hombre"
},
"domain_id": "SNEAKERS",
"site_id": "MLA",
"type": "SPECIFIC",
"seller_id": 1108966308,
"main_attribute_id": "M_US_SIZE",
"secondary_attribute_id": "AR_SIZE",
"attributes": [
{
"id": "GENDER",
"name": "Género",
"values": [
{
"id": "339666",
"name": "Hombre"
}
]
}
],
"rows": [
{
"id": "463005:1",
"attributes": [
{
"id": "SIZE",
"name": "Talle",
"values": [
{
"name": "8,5 US",
"struct": {
"number": 8.5,
"unit": "US"
}
}
]
},
{
"id": "FOOT_LENGTH",
"name": "Largo del pie",
"values": [
{
"name": "10 cm",
"struct": {
"number": 10.0,
"unit": "cm"
}
}
]
},
{
"id": "AR_SIZE",
"name": "AR",
"values": [
{
"name": "40 AR",
"struct": {
"number": 40.0,
"unit": "AR"
}
}
]
},
{
"id": "M_US_SIZE",
"name": "US-M",
"values": [
{
"name": "8,5 US",
"struct": {
"number": 8.5,
"unit": "US"
}
}
]
}
]
},
{
"id": "463005:2",
"attributes": [
{
"id": "SIZE",
"name": "Talle",
"values": [
{
"name": "9 US",
"struct": {
"number": 9.0,
"unit": "US"
}
}
]
},
{
"id": "FOOT_LENGTH",
"name": "Largo del pie",
"values": [
{
"name": "15 cm",
"struct": {
"number": 15.0,
"unit": "cm"
}
}
]
},
{
"id": "AR_SIZE",
"name": "AR",
"values": [
{
"name": "41 AR",
"struct": {
"number": 41.0,
"unit": "AR"
}
}
]
},
{
"id": "M_US_SIZE",
"name": "US-M",
"values": [
{
"name": "9 US",
"struct": {
"number": 9.0,
"unit": "US"
}
}
]
}
]
},
{
"id": "463005:3",
"attributes": [
{
"id": "SIZE",
"name": "Talle",
"values": [
{
"name": "9,5 US",
"struct": {
"number": 9.5,
"unit": "US"
}
}
]
},
{
"id": "FOOT_LENGTH",
"name": "Largo del pie",
"values": [
{
"name": "20 cm",
"struct": {
"number": 20.0,
"unit": "cm"
}
}
]
},
{
"id": "AR_SIZE",
"name": "AR",
"values": [
{
"name": "42 AR",
"struct": {
"number": 42.0,
"unit": "AR"
}
}
]
},
{
"id": "M_US_SIZE",
"name": "US-M",
"values": [
{
"name": "9,5 US",
"struct": {
"number": 9.5,
"unit": "US"
}
}
]
}
]
}
]
}Ejemplo para crear una guía personalizada usando rangos de medidas:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
"names": {
"MLA": "Guia de test para rangos niños"
},
"domain_id": "SNEAKERS_TEST",
"site_id": "MLA",
"attributes": [
{
"id": "GENDER",
"values": [
{
"id": "339667",
"name": "Niños"
}
]
}
],
"main_attribute": {
"attributes": [
{
"site_id": "MLA",
"id": "MANUFACTURER_SIZE"
}
]
},
"rows": [
{
"attributes": [
{
"id": "MANUFACTURER_SIZE",
"values": [
{
"name": "3 US"
}
]
},
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "10 cm"
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "13 cm"
}
]
}
]
},
{
"attributes": [
{
"id": "MANUFACTURER_SIZE",
"values": [
{
"name": "4 US"
}
]
},
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "15 cm"
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "20 cm"
}
]
}
]
}
]
}' https://api.mercadolibre.com/catalog/chartsAlgunas consideraciones sobre los atributos de las guías de talles:
- manufacturer_size: el cual es optativo y representa el talle de la marca o del fabricante.
- size: que representará el talle principal que se visualiza en la publicación.
- foot_length y foot_length_to: atributos utilizados para crear rangos de medidas dentro de la especificación de una fila de la guía de talles.
La primera columna de la guía de talles, determina lo que va en el picker (detalle descriptivo del talle). Esta columna puede ser determinada por el vendedor para cambiar lo que queremos mostrar como descripción del talle.
En el caso de guías de talle standard y marca, la columna del detalle (picker) va a estar predefinida y son configuradas por site. Siempre la primera columna de la guía de talles, será identificada bajo el id del atributo SIZE.
Para el caso del ejemplo, el vendedor indicó que su talle principal es US_SIZE, por lo tanto la columna SIZE es calculada de acuerdo a lo que indicó el vendedor.
Ejemplo de cómo se visualiza en el front la publicación con guía de talle asignada.
En cada cuadro azul (picker) hace referencia a los talles designados como principales por el vendedor.
Crear guías en dominios TOPS and BOTTOMS
Para dominios de TOPS and BOTTOMS, por ejemplo: pantalones, camisas, vestidos, entre otros. Hemos incluído atributos del tipo de dato value_type: "list" una Lista, que contiene un conjunto de valores predeterminados por Mercado Libre para especificar ciertos atributos de una guía de talles personalizada, adicionalmente encontrarás el tag de multivalued que permitirá crear la guía con uno o más valores específicos dentro de la lista para cada fila, para ejemplificar: podrás ver que la talla Small incluye los valores de la lista de tallas desde la 26 hasta la 30 (26, 27, 28, 29, 30), mientras que la talla Large corresponde un único valor de talla 40.
En los dominios de TOPS and BOTTOMS únicamente se puede hacer uso de guías de tipo SPECIFIC, o guías personalizadas especificadas por cada vendedor.
Al consultar la ficha técnica de la guía de talles se verá en el resultado un tipo de dato list que determina una Lista, dicho atributo indicará los posibles valores que puede tomar, tanto su value_id como su value_name.
Ejemplo de creación de una guía de talles personalizada desde una Lista:
curl -L -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
"names": {
"MLA": "Guia de tallas lista-multivalued pants test"
},
"domain_id": "PANTS_TEST",
"site_id": "MLA",
"attributes": [
{
"id": "GENDER",
"values": [
{
"name": "Hombre"
}
]
}
],
"main_attribute": {
"attributes": [
{
"site_id": "MLA",
"id": "SIZE"
}
]
},
"rows": [
{
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Small"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"values": [
{
"name": "26"
},
{
"name": "27"
},
{
"name": "28"
},
{
"name": "29"
},
{
"name": "30"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "82 cm"
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"values": [
{
"name": "90 cm"
}
]
},
{
"id": "LENGTH_FROM_WAIST_TO_ANKLE_FROM",
"values": [
{
"name": "104 cm"
}
]
},
{
"id": "LENGTH_FROM_INSEAM_TO_ANKLE_FROM",
"values": [
{
"name": "107 cm"
}
]
},
{
"id": "THIGH_CIRCUMFERENCE_FROM",
"values": [
{
"name": "45 cm"
}
]
}
]
},
{
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Medium"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"values": [
{
"id": "3259507"
},
{
"id": "3189126"
},
{
"id": "3189128"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "86 cm"
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"values": [
{
"name": "93 cm"
}
]
},
{
"id": "LENGTH_FROM_WAIST_TO_ANKLE_FROM",
"values": [
{
"name": "108 cm"
}
]
},
{
"id": "LENGTH_FROM_INSEAM_TO_ANKLE_FROM",
"values": [
{
"name": "110 cm"
}
]
},
{
"id": "THIGH_CIRCUMFERENCE_FROM",
"values": [
{
"name": "47 cm"
}
]
}
]
},
{
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Large"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"values": [
{
"name": "40"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"values": [
{
"name": "88 cm"
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"values": [
{
"name": "111 cm"
}
]
},
{
"id": "LENGTH_FROM_WAIST_TO_ANKLE_FROM",
"values": [
{
"name": "113 cm"
}
]
},
{
"id": "LENGTH_FROM_INSEAM_TO_ANKLE_FROM",
"values": [
{
"name": "107 cm"
}
]
},
{
"id": "THIGH_CIRCUMFERENCE_FROM",
"values": [
{
"name": "49 cm"
}
]
}
]
}
]
}'Respuesta de la creación de una guía de talles desde una Lista:
{
"id": "515255",
"names": {
"MLA": "Guia de tallas lista-multivalued pants test"
},
"domain_id": "PANTS_TEST",
"site_id": "MLA",
"type": "SPECIFIC",
"seller_id": 1108966308,
"main_attribute_id": "SIZE",
"attributes": [
{
"id": "GENDER",
"name": "Género",
"values": [
{
"name": "Hombre"
}
]
}
],
"rows": [
{
"id": "515255:1",
"attributes": [
{
"id": "SIZE",
"name": "Talle",
"values": [
{
"name": "Small"
}
]
},
{
"id": "SIZE",
"name": "Talla de la etiqueta",
"values": [
{
"name": "Small"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"name": "Talle estándar",
"values": [
{
"id": "4147746",
"name": "26"
},
{
"id": "3259523",
"name": "27"
},
{
"id": "3259504",
"name": "28"
},
{
"id": "3259505",
"name": "29"
},
{
"id": "3259506",
"name": "30"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"name": "Circunferencia de cintura desde",
"values": [
{
"name": "82 cm",
"struct": {
"number": 82.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"name": "Circunferencia de cadera desde",
"values": [
{
"name": "90 cm",
"struct": {
"number": 90.0,
"unit": "cm"
}
}
]
},
{
"id": "LENGTH_FROM_WAIST_TO_ANKLE_FROM",
"name": "Largo de la cintura al tobillo desde",
"values": [
{
"name": "104 cm",
"struct": {
"number": 104.0,
"unit": "cm"
}
}
]
},
{
"id": "LENGTH_FROM_INSEAM_TO_ANKLE_FROM",
"name": "Largo de la entrepierna al tobillo desde",
"values": [
{
"name": "107 cm",
"struct": {
"number": 107.0,
"unit": "cm"
}
}
]
},
{
"id": "THIGH_CIRCUMFERENCE_FROM",
"name": "Contorno del muslo desde",
"values": [
{
"name": "45 cm",
"struct": {
"number": 45.0,
"unit": "cm"
}
}
]
}
]
},
{
"id": "515255:2",
"attributes": [
{
"id": "SIZE",
"name": "Talle",
"values": [
{
"name": "Medium"
}
]
},
{
"id": "SIZE",
"name": "Talla de la etiqueta",
"values": [
{
"name": "Medium"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"name": "Talle estándar",
"values": [
{
"id": "3259507",
"name": "31"
},
{
"id": "3189126",
"name": "32"
},
{
"id": "3189128",
"name": "33"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"name": "Circunferencia de cintura desde",
"values": [
{
"name": "86 cm",
"struct": {
"number": 86.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"name": "Circunferencia de cadera desde",
"values": [
{
"name": "93 cm",
"struct": {
"number": 93.0,
"unit": "cm"
}
}
]
},
{
"id": "LENGTH_FROM_WAIST_TO_ANKLE_FROM",
"name": "Largo de la cintura al tobillo desde",
"values": [
{
"name": "108 cm",
"struct": {
"number": 108.0,
"unit": "cm"
}
}
]
},
{
"id": "LENGTH_FROM_INSEAM_TO_ANKLE_FROM",
"name": "Largo de la entrepierna al tobillo desde",
"values": [
{
"name": "110 cm",
"struct": {
"number": 110.0,
"unit": "cm"
}
}
]
},
{
"id": "THIGH_CIRCUMFERENCE_FROM",
"name": "Contorno del muslo desde",
"values": [
{
"name": "47 cm",
"struct": {
"number": 47.0,
"unit": "cm"
}
}
]
}
]
},
{
"id": "515255:3",
"attributes": [
{
"id": "SIZE",
"name": "Talle",
"values": [
{
"name": "Large"
}
]
},
{
"id": "SIZE",
"name": "Talla de la etiqueta",
"values": [
{
"name": "Large"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"name": "Talle estándar",
"values": [
{
"id": "3189142",
"name": "40"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"name": "Circunferencia de cintura desde",
"values": [
{
"name": "88 cm",
"struct": {
"number": 88.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"name": "Circunferencia de cadera desde",
"values": [
{
"name": "111 cm",
"struct": {
"number": 111.0,
"unit": "cm"
}
}
]
},
{
"id": "LENGTH_FROM_WAIST_TO_ANKLE_FROM",
"name": "Largo de la cintura al tobillo desde",
"values": [
{
"name": "113 cm",
"struct": {
"number": 113.0,
"unit": "cm"
}
}
]
},
{
"id": "LENGTH_FROM_INSEAM_TO_ANKLE_FROM",
"name": "Largo de la entrepierna al tobillo desde",
"values": [
{
"name": "107 cm",
"struct": {
"number": 107.0,
"unit": "cm"
}
}
]
},
{
"id": "THIGH_CIRCUMFERENCE_FROM",
"name": "Contorno del muslo desde",
"values": [
{
"name": "49 cm",
"struct": {
"number": 49.0,
"unit": "cm"
}
}
]
}
]
}
]
}A considerar:
- Los valores recibidos dentro del atributo tipo list, se validarán contra la Lista que Mercado Libre dispone en la ficha técnica, en caso de enviar un valor que no esté dentro de dicha lista, retornará un error de tipo value_is_not_in_the_list.
{
"error": "chart_validation_error",
"message": "Chart validation errors found",
"status": 400,
"errors": [
{
"code": "value_is_not_in_the_list",
"message": "Value 88 in attribute FILTRABLE_SIZE is incorrect",
"cell": {
"attribute_id": "FILTRABLE_SIZE",
"row": {
"id": null,
"main_attribute": {
"id": "SIZE",
"value": "46"
}
}
}
}
]
}
- Para especificar el campo de tipo list, se puede enviar el value_id o el value_name, en caso de enviar ambos parámetros el value_id tiene mayor relevancia que el value_name.
Agregar filas en guía de talles
También podrás crear o agregar una fila en una guía de talle creada. Sin necesidad de tener que modificar la guía, podrás realizar un POST al recurso de /catalog/charts/$chart_id/rows y sumar la fila correspondiente.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_ID/rowsEjemplo para agregar una fila en una guía de talle del tipo BRAND o STANDARD:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"sites": ["MLA", "CBT"], // Aplica si type = BRAND | STANDARD
"attributes": [{
"id": "UK_SIZE",
"values": [{
"name": "44"
}]
},{
"id": "AR_SIZE",
"values": [{
"name": "44"
}]
}
}'
https://api.mercadolibre.com/catalog/charts/4/rowsEjemplo para agregar una fila en una guía de talle del tipo SPECIFIC:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"attributes": [{
"id": "AR_SIZE",
"values": [{
"name": "43 AR"
}]
},{
"id": "FOOT_LENGTH",
"values": [{
"name": "22 cm"
}]
}]
}'
https://api.mercadolibre.com/catalog/charts/4/rowsModificar fila en guía de talles
Además agregar una fila en la guía de talles, podrás modificar las ya existentes. Realizando un PUT al recurso de /catalog/charts/$chart_id/rows/$row_id y editando la fila correspondiente.
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_ID/rows/$ROW_IDEjemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"attributes": [
{
"id": "FOOT_LENGTH",
"values": [
{
"id": "FOOT_LENGTH",
"values": [
{
"name": "10 cm"
}
]
},
{
"id": "FOOT_LENGTH_TO",
"values": [
{
"name": "13 cm"
}
]
}
]
}
]
}'
https://api.mercadolibre.com/catalog/charts/155405/rows/155405:1Modificar guía de talle
Para modificar una guía, define sólo los campos que deben ser modificados. En el caso de attributes y rows, los objetos enviados en la lista si existen previamente en la guía son modificados y si no existen son creados.
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_IDEjemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d
'{
"names": {
"MLA": "Guía de talles de calzado de hombre"
}
}'
https://api.mercadolibre.com/catalog/charts/5
Asociar guía de talle al ítem
Para asignar una guía de talle a las publicaciones que se encuentren dentro de los dominios requeridos con guías, tendrás que realizar un POST a ítems, enviando los nuevos atributos de tipo GRID_ID y GRID_ROW_ID, los cuales permitirán hacer referencia con el (SIZE_GRID_ID) a la guía de talles a la cual queremos asociar el ítem o variación y (SIZE_GRID_ROW_ID) en referencia a la fila dentro de la guia de talles.
Ejemplo de asociar una guía de talles, para una publicación sin variaciones, donde el atributo SIZE_GRID_ROW_ID va a nivel de atributos de la publicación:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"title": "ITEM DE TEST MODA - NO OFERTAR",
"pictures": [
{
"secure_url": "https://http2.mlstatic.com/D_783501-MLB20327737026_062015-O.jpg",
"url": "http://http2.mlstatic.com/D_783501-MLB20327737026_062015-O.jpg",
"quality": "",
"id": "783501-MLB20327737026_062015"
}
],
"price": 30000,
"currency_id": "ARS",
"available_quantity": 5,
"catalog_listing": false,
"attributes": [
{
"id": "ITEM_CONDITION",
"value_id": "2230284"
},
{
"id": "BRAND",
"value_id": "14671",
"value_name" : "Nike"
},
{
"id": "LINE",
"value_id": "289533",
"value_name": "Air Max"
},
{
"id": "MODEL",
"value_id": "27030",
"value_name": "AP"
},
{
"id": "GENDER",
"value_id": "339665",
"value_name": "Mujer"
},
{
"id": "AGE_GROUP",
"value_id": "6725189",
"value_name": "Adultos"
},
{
"id": "SIZE_GRID_ID",
"value_id": "11273930",
"value_name":"26008"
},
{
"id": "STYLE",
"value_id": "6694772",
"value_name": "Deportivo"
},
{
"id": "RECOMMENDED_SPORTS",
"value_id": "6694768",
"value_name": "Running"
},
{
"id": "EXTERIOR_MATERIALS",
"value_id": "5017538",
"value_name": "Cuero sintético"
},
{
"id": "OUTSOLE_MATERIALS",
"value_id": "930364",
"value_name": "Goma"
},
{
"id": "FOOTWEAR_TECHNOLOGIES",
"value_id": "8668190",
"value_name": "Air"
},
{
"id": "FOOTWEAR_TYPE",
"value_id": "517583",
"value_name": "Zapatilla"
},
{
"id": "COLOR",
"value_id": null,
"value_name": "Blanco/Blanco/Platino metalizado/Platino puro"
},
{
"id": "SIZE_GRID_ROW_ID",
"value_id": "11286240",
"value_name": "26008:1"
}
],
"catalog_product_id": "MLA18565233",
"category_id": "MLA455855",
"listing_type_id": "gold_pro"
}'
https://api.mercadolibre.com/itemsEjemplo de asociar una guía de talles, para una publicación con variaciones, donde el atributo SIZE_GRID_ROW_ID va a nivel de atributos de cada una de las variaciones de la publicación:
curl -L -X POST 'https://api.mercadolibre.com/items' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
"title": "Tênis Unissex Eros Olympikus Test No Ofertar",
"category_id": "MLB23332",
"price": 349.9,
"currency_id": "BRL",
"available_quantity": 6,
"buying_mode": "buy_it_now",
"condition": "new",
"listing_type_id": "gold_special",
"pictures": [
{
"source": "http://http2.mlstatic.com/D_686163-MLB51823676081_102022-O.jpg"
},
{
"source": "http://http2.mlstatic.com/D_945109-MLB51823569653_102022-O.jpg"
}
],
"attributes": [
{
"id": "BRAND",
"value_name": "Olympikus"
},
{
"id": "GENDER",
"value_name": "Homem"
},
{
"id": "MODEL",
"value_name": "EROS"
},
{
"id": "SIZE_GRID_ID",
"value_name": "210058"
}
],
"variations": [
{
"available_quantity": 5,
"price": 349.9,
"attribute_combinations": [
{
"id": "COLOR",
"value_name": "BRANCO-SAFFRON"
},
{
"id": "SIZE",
"value_name": "36 BR"
}
],
"picture_ids": [
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670601935.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670605879.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670608926.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670611911.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670614401.jpg"
],
"attributes": [
{
"id": "EAN",
"value_name": "9003065700244"
},
{
"id": "SELLER_SKU",
"value_name": "9003065700244"
},
{
"id": "SIZE_GRID_ROW_ID",
"value_name": "210058:4"
}
]
},
{
"available_quantity": 2,
"price": 349.9,
"attribute_combinations": [
{
"id": "COLOR",
"value_name": "BRANCO-SAFFRON"
},
{
"id": "SIZE",
"value_name": "37 BR",
"value_id": "11375309"
}
],
"picture_ids": [
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670601935.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670605879.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670608926.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670611911.jpg",
"https://storage.googleapis.com/vetorapp0.appspot.com/BATA-5227/3065770-3011_1665670614401.jpg"
],
"attributes": [
{
"id": "EAN",
"value_name": "9003065700060"
},
{
"id": "SELLER_SKU",
"value_name": "9003065700060"
},
{
"id": "SIZE_GRID_ROW_ID",
"value_name": "210058:5"
}
]
}
]
}'
Consultar una guía específica
Una vez creada la guía de talle, podrás consultar por una guía enviando el id de la misma mediante el recurso de /catalog/charts/$chart_id
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/$CHART_IDEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/3Respuesta:
{
"id": "2323823902",
"names": {
"MLA": "Guía de talles de Adidas Mujer",
"CBT": "Size chart for Adidas Women"
},
"domain_id": "SNEAKERS",
"template_id": "2",
"type": "SPECIFIC", // BRAND | SPECIFIC | STANDARD
"seller_id": 123456, // Solo si type = SPECIFIC
"site_id": "MLA", // Solo si type = SPECIFIC
"attributes": [{
"id": "BRAND",
"name": "Marca",
"values": [{
"id": "2786671",
"name": "Adidas"
}]
},{
"id": "GENDER",
"name": "Género",
"values": [{
"id": "339666",
"name": "Mujer"
}]
}],
"rows": [{
"id": "28292",
"sites": ["MLA", "CBT"], // Aplica a todos si sites es vacío, solo se muestra si no se especifica el site_id en la consulta
"attributes": [{
"id": "SIZE", //Talle calculado si se envía el site en el caso de las multisite
"name": "Talle ",
"values": [{
"id": "3259454",
"name": "44"
}]
},{
"id": "UK_SIZE",
"name": "Talle UK",
"values": [{
"id": "3259454",
"name": "44"
}]
},{
"id": "AR_SIZE",
"name": "Talle AR",
"values": [{
"id": "3259454",
"name": "44"
}]
},{
"id": "SLEEVE_LENGTH",
"name": "Largo de mangas",
"values": [{
"id": "3259552",
"name": "73 cm",
"struct": {
"number": 73,
"unit": "cm"
}
}]
}]
}]
}Siguiente: Validación de guía de talles.
Zona de los archivos adjuntos Vista previa del vídeo Developers | Guía de talles de YouTube