Guías de Talle

Estamos siempre buscando lograr una mejor experiencia dentro del sitio, por eso te aconsejamos que tus publicaciones de Moda contengan sus respectivas Guías de Talle, para poder ser más específico con las medidas de los talles de tus publicaciones.
De esta forma podrás reducir la cantidad de preguntas, las devoluciones por problemas con los talles, y aumentar tus ventas.
Para eso, ahora podés cargar las medidas de cada talle. Ten en cuenta que los valores también podrán ser rangos o equivalencias entre distintos sistemas de talle.
En primer lugar deberás crear las Guías de Talle de tu usuario, y luego asociar una de ellas a cada una de las publicaciones que corresponda. Podrás tener múltiples Guías y cada una la podrás asociar a tantas publicaciones como gustes.
Sólo podrás elegir los atributos de medida (ej: largo total o contorno de cintura) que aplican para tu Guía, de un conjunto de atributos preestablecidos.

Contenidos:

Obtener los atributos de medidas

Para conocer los atributos disponibles para crear la guía, deberás consultar cuales aplican para el país donde desees publicar. Llamada
GET https://api.mercadolibre.com/size_charts/measurements?site_id={site_id} 
Ejemplo
GET  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
POST  https://api.mercadolibre.com/size_charts?access_token={access_token} 
{
"name" : "test",
"sizes" : [
{
"name": "L",
"measurements" : [
{
"id": "CHEST_CIRCUMFERENCE",
"value" : "25 - 30"
},
{
"id": "TOTAL_LENGTH",
  "value" : "55 - 60"
}
]
},{
"name": "M",
"measurements" : [
{
"id": "CHEST_CIRCUMFERENCE",
"value" : "20 - 25"
},
{
 	"id": "TOTAL_LENGTH",
"value" : "45 - 50"
}]
}]
}
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
PUT  https://api.mercadolibre.com/size_charts/{size_chart_id}?access_token={token} 
Ejemplo
PUT  https://api.mercadolibre.com/size_charts/123456?access_token={token} 
{
	"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 items 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 aplicar a varios ítems. Llamada
PUT  https://api.mercadolibre.com/size_charts/{size_chart_id}/items?access_token={token} 
Ejemplo
PUT  https://api.mercadolibre.com/size_charts/123456/items?access_token={token} 
{
    "items": [
        "MLA646854744",
	 "MLA240984332",
	 "MLA676711123"
    ]
}
Aclaración: Si deseas asociar un nuevo ítem a la guía, o quitar alguno que ya no aplique, recuerda que deberás enviar la lista completa de publicaciones asociadas a esa guía para no perder la relación.

Consultar una Guía específica

Para conocer la información de una guía en particular, deberás hacer la siguiente consulta: Llamada
GET https://api.mercadolibre.com/size_charts/123456
Ejemplo
GET https://api.mercadolibre.com/size_charts/123456
Nota: Esta consulta no requiere access_token. Respuesta
{
    "id": 123456,
    "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 conocer la información de las guías dadas de alta por el vendedor, deberás hacer la siguiente consulta: Llamada
GET https://api.mercadolibre.com/size_charts?access_token={token}
Nota: Esta consulta sí requiere access_token. 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 conocer todos los ítems que están asociados a una misma guía del vendedor, deberás hacer la siguiente consulta: Llamada
GET https://api.mercadolibre.com/size_charts/{size_chart_id}/items?access_token={token}
Ejemplo
GET https://api.mercadolibre.com/size_charts/123456/items?access_token={token}
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
DELETE https://api.mercadolibre.com/size_charts/{size_chart_id}?access_token={token}
Ejemplo
DELETE https://api.mercadolibre.com/size_charts/123456?access_token={token}

Forma parte de nuestra comunidad