Guías de Talles
Contenidos
→Obtener los atributos de medidas →Crear una Guía de Talle ↳Posibles errores →Modificar una Guía →Asociar items a una Guía →Consultar una Guía específica →Consultar las Guías creadas por el vendedor →Consultar los ítems asociados a una Guía →Eliminar una Guía
Obtener los atributos de medidas
Para conocer los atributos disponibles para crear la guía, deberás consultar cuales están disponibles en el país donde desees publicar.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/measurements?site_id=$SITE_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/measurements?site_id=MLA
Respuesta:
[
{
"id": "BELT_LENGTH",
"name": "Largo del cinturón",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "CHEST_CIRCUMFERENCE",
"name": "Contorno del pecho",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "FOOTWEAR_LENGTH",
"name": "Largo del calzado",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "FOOTWEAR_WIDTH",
"name": "Ancho del calzado",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "HEAD_CIRCUMFERENCE",
"name": "Circunferencia de la cabeza",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "HIP_CIRCUMFERENCE",
"name": "Contorno de la cadera",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "INSEAM_LENGTH",
"name": "Largo de la entrepierna",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "PALM_WIDTH",
"name": "Ancho de la palma",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "SLEEVE_LENGTH",
"name": "Largo de manga",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "TOTAL_LENGTH",
"name": "Largo total",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "WAIST_CIRCUMFERENCE",
"name": "Contorno de la cintura",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
}
]
Crear una Guía de Talle
En caso que desees crear una guía, deberás realizar un POST al recurso /size_charts enviando los siguientes parámetros:
- Name: String con el nombre de la guía
- Sizes: Lista de medidas que va a contener la guía
- Sizes -> Name: String con el talle
- Sizes -> Measurements: Lista de atributos de medida
- Sizes -> Measurements -> Id: String con el atributo de medida
- Sizes -> Measurements -> Value: String con un valor, ejemplo “5”, o también un rango “5 - 10”
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts
{
"name":"test",
"sizes":[
{
"name":"L",
"measurements":[
{
"id":"CHEST_CIRCUMFERENCE",
"value":25
},
{
"id":"TOTAL_LENGTH",
"value":55
}
]
},
{
"name":"M",
"measurements":[
{
"id":"CHEST_CIRCUMFERENCE",
"value":25
},
{
"id":"TOTAL_LENGTH",
"value":33
}
]
}
]
}
Respuesta:
status: 201
{
"id": 10,
"name": "test",
"columns": [
{
"id": "CHEST_CIRCUMFERENCE",
"name": "Contorno del pecho",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "TOTAL_LENGTH",
"name": "Largo total”,
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
}
],
"sizes": [
{
"name": "L",
"measurements": [
{
"id": "CHEST_CIRCUMFERENCE",
"value": "25"
},
{
"id": "TOTAL_LENGTH",
"value": "55"
}
]
},
{
"name": "M",
"measurements": [
{
"id": "CHEST_CIRCUMFERENCE",
"value": "25"
},
{
"id": "TOTAL_LENGTH",
"value": "33"
}
]
}
]
}
Posibles errores
El usuario no pertenece al sitio donde quiere crear la guía.
{
"error": "VALIDATION_SITE",
"message": "The feature is not available for the site",
"status": 403
}
La medida que se está enviando no es correcta.
{
"error": "MEASUREMENT_NOT_FOUND",
"message": "Measurement CHEST_CIRCUMFERENCE2 not found",
"status": 400
}
La medida que se está mandando está duplicada.
{
"error": "DUPLICATE_MEASUREMENT_VALIDATION",
"message": "Duplicate measurement attributes",
"status": 400,
"errors": [
{
"code": "DUPLICATE_MEASUREMENT_VALIDATION",
"message": "Duplicate measurement attributes CHEST_CIRCUMFERENCE"
}
]
}
La cantidad de atributos de medida que se están mandando no están dentro de los parámetros máximos y mínimos.
{
"error": "MEASUREMENT_NOT_ALLOWED",
"message": "Measurement attributes count not allowed. Max (5) Min (1)",
"status": 400
}
Los talles que se están enviando están duplicados
Response status: 400
Response body:
{
"error": "DUPLICATE_SIZE_VALIDATION",
"message": "Size duplicated",
"status": 400
}
Modificar una Guía
Para modificar una guía deberás realizar un PUT al recurso /size_charts con el ID de la guía correspondiente. Ten en cuenta enviar toda la información, tanto la que deseas modificar como la que no.
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/$SIZE_CHART_ID
Ejemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/123456
{
"name" : "test1",
"sizes" : [{
"name": "L",
"measurements" : [{
"id": "CHEST_CIRCUMFERENCE",
"value" : 25
},
{
"id": "TOTAL_LENGTH",
"value" : 56
}]
},
{
"name": "M",
"measurements" : [{
"id": "CHEST_CIRCUMFERENCE",
"value" : 25
},
{
"id": "TOTAL_LENGTH",
"value" : 33
}]
}]}
Asociar ítems a una Guía
Una vez que la guía ya está creada puede ser asociada a cualquier publicación que pertenezca al usuario que la creó. Ten en cuenta que una misma guía puede ser utilizada en varios ítems.
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/$SIZE_CHART_ID/items
Ejemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/123456/items
{
"items": [
"MLA646854744",
"MLA240984332",
"MLA676711123"
]
}
Consultar una Guía específica
Para conocer la información de una guía en particular, deberás hacer la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/123456
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/123456
Respuesta:
{
"id": 10,
"name": "test",
"columns": [
{
"id": "CHEST_CIRCUMFERENCE",
"name": "Contorno del pecho",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
},
{
"id": "TOTAL_LENGTH",
"name": "Largo total",
"type": {
"id": "NUMBER_UNIT",
"default_unit": "cm"
}
}
],
"sizes": [
{
"measurements": [
{
"id": "CHEST_CIRCUMFERENCE",
"value": "25"
},
{
"id": "TOTAL_LENGTH",
"value": "55"
}
],
"name": "L"
},
{
"measurements": [
{
"id": "CHEST_CIRCUMFERENCE",
"value": "25"
},
{
"id": "TOTAL_LENGTH",
"value": "33"
}
],
"name": "M"
}]}
Consultar las Guías creadas por el vendedor
Para ver la información de las guías dadas de alta por el vendedor, deberás hacer la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts
Respuesta:
[
{
"id": 10,
"name": "{nombre1}"
},
{
"id": 11,
"name": "{nombre2}"
},
{
"id": 12,
"name": "{nombre3}"
},
{
"id": 13,
"name": "{nombre4}"
},
{
"id": 14,
"name": "{nombre5}"
}
]
Consultar los ítems asociados a una guía
Para ver todos los ítems que están asociados a una misma guía del vendedor, deberás hacer la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/$SIZE_CHART_ID/items
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/123456/items
Respuesta:
{
"items": [
"MLA646854744"
],
"paging": {
"total": 1,
"offset": 0,
"limit": 50
}
}
Eliminar una Guía
En caso de que se desee eliminar una guía creada previamente, se deberá realizar un DELETE con el ID que se desea borrar.
Llamada:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/
Ejemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/size_charts/123456