Última actualización 17/03/2023

Gestionar guía de talles

Importante:
Este recurso está disponible en Argentina, México y Brasil.
A partir del 6 de marzo se comenzará a encender gradualmente en Uruguay, Colombia, Perú, Ecuador y Chile.

La guía de talle permite que los compradores tengan una mejor experiencia al momento de elegir su producto, evitando así cambios de talle y/o reclamos; por eso tenga en cuenta desarrollar esta funcionalidad para atender a vendedores de moda.
Con el nuevo formato de guía de talles, contaremos con 3 tipos de guías las cuales se podrán identificar por Marca (BRAND), estándar de Mercado Libre (STANDARD) o personalizada/específica del seller (SPECIFIC).

Para los sites de Uruguay, Colombia, Perú, Ecuador y Chile únicamente contaremos con la experiencia de guías de talles personalizada/específica del seller (SPECIFIC).




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.

Nota:
Para clonar una guia de talles, deberás reconocer en el buscador de guías la que mejor se asemeje a tus necesidades y usar el recurso de consultar una guía de talles con el chart_id que se intenta clonar. Podrás copiar la plantilla y avanzar por el flujo de crear guía de talle personalizada.

Además ten en cuenta que si realizas una búsqueda con un dominio que no se encuentre dentro de los configurados con la nueva guía de talles, recibirás error.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json"  -d {...} https://api.mercadolibre.com/catalog/charts/search

Ejemplo:


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.


Nota:
En el caso de ser una guía específica (SPECIFIC) para un vendedor es necesario aclarar el id del mismo y no es necesario definir los sites dado que la guía estará acotada al site del vendedor. En caso de que la guía sea de marca (BRAND) o estándar de Meli (STANDARD), se deben especificar los sites incluidos a nivel de fila y las traducciones de los nombres de la guía que correspondan.

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/charts

Ejemplo 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/charts


Algunas 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

Importante:
Las guías de talles de los dominios TOPS and BOTTOMS, se podrán trabajar con atributos tipo list permitiendo valores múltiples (multivalued), por ejemplo: para un atributo id:SIZE con name S - L vamos a permitir cargar múltiples valores en el atributo d: FILTRABLE_SIZE con name: S,M, L. A partir de abril 2023 la experiencia de multivalued será encendida.

No se podrá crear o modificar publicaciones del marketplace dentro de las categorías de TOPS and BOTTOMS sin guía de talles, por lo que dispusimos el dominio de PANTS_TEST en los distintos sites para que se pudieran hacer pruebas e ir acoplando las integraciones.

Para estas nuevas categorías de TOPS and BOTTOMS no se podrá usar las guías de talles por Marca (BRAND) o estándar de Mercado Libre (STANDARD), únicamente se podrá crear publicaciones a partir de guías de talles de tipo personalizada (SPECIFIC).

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/rows

Ejemplo 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/rows

Ejemplo 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/rows

Modificar 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.

Importante:
Ten en cuenta que al modificar no podrás editar el talle principal (main_attribute) de cada fila (row) y tampoco podrás eliminar filas.

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_ID

Ejemplo:

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:1

Modificar 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.


Importante:
Ten en cuenta que al modificar no podrás editar el talle principal (main_attribute) de la guía, como el valor del talle principal de la fila (row) y los atributos generales. Además no podrás eliminar filas.

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_ID

Ejemplo:

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.

Nota:
Ten en cuenta al momento de asociar guías de talles, considerar en primer lugar las guías definidas por marca, luego las estándar de Mercado Libre y por último las guías personalizadas.

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/items

Ejemplo 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

Nota:
Si envías el parámetro site_id, obtendrás solo las filas correspondientes a ese site, en caso de que no envíes el parámetro no se filtrarán y devolverá todas las filas.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/$CHART_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/3

Respuesta:

{
 "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