Guías de Talles

Nuestro objetivo es ofrecer la mejor experiencia dentro del site. Por eso, disponemos de Guía de Talles donde los vendedores de Moda puedan dar más detalles de sus productos a los clientes. Esta funcionalidad permite disminuir el número de preguntas, devoluciones por problemas con los tamaños e aumentar las ventas. Para esto, ahora él puede detallar las medidas de cada tamaño. Además, se podrá tener una o más tablas asociadas a diferentes publicaciones. ¡Revisa nuestra documentación para conocer cómo cargarlas!

Nota:

Solo podrás escoger los atributos de talles, por ejemplo, el largo total o el contorno de la cintura, aplicables a su guía.

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"
    ]
}

Nota:

-Para que la asociación sea exitosa, el ítem debe contar con el atributo SIZE completo.
-Si deseas asociar un nuevo ítem a la guía o quitar alguno que ya no aplique, deberás enviar la lista completa de publicaciones asociadas a esa guía para no perder la relación.
- Puedes asociar hasta 500 artículos a la misma guía. A partir de esa cantidad, recomendamos crear otra guía.

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

Nota:

Esta consulta no requiere access_token.

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

Nota:

Esta llamada 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 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