Tabelas de Medidas

Nosso objetivo é oferecer a melhor experiência dentro do site. Por isso, disponibilizamos a Tabela de Medidas onde os vendedores de Fashion possam dar mais detalhes dos seus produtos aos compradores.
Assim, o vendedor poderá diminuir o número de perguntas, devoluções por problemas com os tamanhos, e aumentar as vendas. Para isso, agora ele pode informar as medidas de cada tamanho.
Ele poderá ter uma ou mais Tabelas que podem ser associadas a um ou mais anuncios, abaixo temos mais detalhes de como fazer isso.
Nota: só poderá escolher os atributos de medida (ex.: comprimento total ou contorno de cintura) aplicáveis a sua Tabela.

Conteúdos

→Obter os atributos de medidas
→Criar uma Tabela de medidas
→Alterar uma Tabela
→Associar itens a uma Tabela
→Consultar uma Tabela específica
→Consultar as Tabelas criadas pelo vendedor
→Consultar os itens associados a uma Tabela
→Remover uma Tabela


Obter os atributos de medidas

Para conhecer os atributos disponíveis para criar a tabela, você deverá consultar quais estão disponíveis no país onde quiser anunciar. Chamada:

curl -X GET https://api.mercadolibre.com/size_charts/measurements?site_id=$SITE_ID 

Exemplo:

curl -X GET https://api.mercadolibre.com/size_charts/measurements?site_id=MLA

Resposta:

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


Criar uma Tabela de medidas

Caso você deseje criar uma tabela, deverá realizar um POST no recurso /size_charts encaminhando os seguintes parâmetros:
Name: String com o nome da tabela:
Sizes: Lista de medidas que a tabela vai conter
Sizes -> Name: String com o tamanho
Sizes -> Measurements: Lista de atributos de medida
Sizes -> Measurements -> Id: String com o atributo de medida
Sizes -> Measurements -> Value: Value: String com um valor, exemplo “5”, ou também um intervalo “5 - 10” Exemplo:

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

Resposta:

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


Possíveis erros:

- O usuário não pertence ao site no qual quer criar a tabela.

{
    "error": "VALIDATION_SITE",
    "message": "The feature is not available for the site",
    "status": 403
}

- A medida que está encaminhando não é correta

{
    "error": "MEASUREMENT_NOT_FOUND",
    "message": "Measurement CHEST_CIRCUMFERENCE2 not found",
    "status": 400
}

- A medida que está encaminhando está duplicada

{
    "error": "DUPLICATE_MEASUREMENT_VALIDATION",
    "message": "Duplicate measurement attributes",
    "status": 400,
    "errors": [
        {
            "code": "DUPLICATE_MEASUREMENT_VALIDATION",
            "message": "Duplicate measurement attributes CHEST_CIRCUMFERENCE"
        }
    ]
}

- O número de atributos de medida que estão sendo encaminhados não estão dentro dos parâmetros máximos e mínimos

{
    "error": "MEASUREMENT_NOT_ALLOWED",
    "message": "Measurement attributes count not allowed. Max (5) Min (1)",
    "status": 400
}

- As medidas que estão sendo encaminhadas estão duplicados Response status: 400
Response body:

{
    "error": "DUPLICATE_SIZE_VALIDATION",
    "message": "Size duplicated",
    "status": 400
}


Alterar uma Tabela

Para alterar uma tabela, você terá que realizar um PUT no recurso /size_charts com o ID da respectiva tabela. Lembre-se de encaminhar todas as informações, tanto aquelas que você quiser alterar quanto as que não. Chamada:

curl -X PUT https://api.mercadolibre.com/size_charts/{size_chart_id}?access_token={token} 

Exemplo:

curl -X 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
			}]
	}]}


Associar itens a uma Tabela

Já criada a tabela, ela pode ser associada a qualquer anúncio do usuário que a criou. Lembre-se de que uma mesma tabela pode ser utilizada em vários itens. Chamada:

curl -X PUT  https://api.mercadolibre.com/size_charts/{size_chart_id}/items?access_token={token} 

Exemplo:

PUT  https://api.mercadolibre.com/size_charts/123456/items?access_token={token} 
{
    "items": [
        "MLA646854744",
	 "MLA240984332",
	 "MLA676711123"
    ]
}
Nota:
- Para que a associação seja bem-sucedida, o item deve ter o atributo SIZE completo.
- Se você quiser associar um novo item à tabela, ou remover algum que não seja mais aplicável, lembre que deverá encaminhar a lista completa de anúncios associados a essa tabela para não perder a relação.


Consultar uma Tabela específica

Para visualizar as informações de uma tabela em particular, você deverá fazer a seguinte consulta: Chamada:

GET https://api.mercadolibre.com/size_charts/123456

Exemplo:

GET https://api.mercadolibre.com/size_charts/123456

Nota: Esta consulta não requer access_token. Resposta:

{
    "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 as Tabelas criadas pelo vendedor

Para visualizar as informações das tabelas habilitadas pelo vendedor, você deverá fazer a seguinte consulta: Chamada:

GET https://api.mercadolibre.com/size_charts?access_token={token}

Nota: Esta consulta requer access_token. Resposta:

[
    {
        "id": 10,
        "name": "{nombre1}"
    },
    {
        "id": 11,
        "name": "{nombre2}"
    },
    {
        "id": 12,
        "name": "{nombre3}"
    },
    {
        "id": 13,
        "name": "{nombre4}"
    },
    {
        "id": 14,
        "name": "{nombre5}"
    }
]


Consultar os itens associados a uma Tabela

Para visualizar todos os itens associados a uma mesma tabela do vendedor, você deverá fazer a seguinte consulta: Chamada:

curl -X GET https://api.mercadolibre.com/size_charts/{size_chart_id}/items?access_token={token}

Exemplo:

curl -X GET https://api.mercadolibre.com/size_charts/123456/items?access_token={token}

Resposta:

{
    "items": [
        "MLA646854744"
    ],
    "paging": {
        "total": 1,
        "offset": 0,
        "limit": 50
    }
}


Remover uma Tabela

Caso você queira remover uma tabela criada previamente, deverá realizar um DELETE com o ID que quer apagar: Chamada:

curl -X DELETE https://api.mercadolibre.com/size_charts/{size_chart_id}?access_token=$ACCESS_TOKEN

Exemplo:

curl -X DELETE https://api.mercadolibre.com/size_charts/123456?access_token=$ACCESS_TOKEN
ou registre-se para receber as últimas notícias sobre nossa API