Recursos Cross
Confira os principais recursos das nossas APIs
Documentação do
Você pode usar esta documentação para as seguintes unidades de negócio:
Gerenciar tabela de medidas
Criar tabela de medidas personalizada
Considere a resposta recebida na ficha técnica da tabela de medidas. Com essa informação, você poderá estruturar o corpo do POST. Se você enviar algum atributo que não esteja na ficha técnica, ele retornará um erro.
E também indicará:
- Tipos de dados (text, number unit, list, etc).
- Atributos que possuem a tag main_attribute_candidate devem ser enviados pelo menos um como main_atributte.Os atributos com a tag required são obrigatórios.
- Os atributos que possuem a tag grid_filter devem ser carregados no nível geral da tabela de medidas e não no nível de rows.
- No nível de rows, você terá de enviar os atributos somente com a tag required somente e pelo menos um com a tag main_attribute_candidate.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/chartsExemplo de criação de uma tabela personalizada para um domínio de footwear, gênero Masculino com as medidas de 40 a 42 e adicionalmente se define como um tamanho principal o 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 criação da tabela de medidas para domínios 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"
}
}
]
}
]
}
]
}Exemplo para criar uma tabela de medidas personalizada usando intervalos 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/chartsAlgumas considerações sobre os atributos das tabelas de medidas:
- manufacturer_size: é opcional e representa a medida da marca ou do fabricante.
- size: calcula-se apenas conforme a regra que tenha a tabela de medidas e representará o tamanho principal que será visualizado na publicação (na coluna principal).
- foot_length y foot_length_to: atributos utilizados para criar intervalos de medidas dentro da especificação de uma fila da tabela e medidas.
A primeira coluna de uma tabela de medidas, determinará o que vai no picker (detalhe descritivo do tamanho). Esta coluna pode ser determinada pelo vendedor para alterar o que queremos mostrar como uma descrição do tamanho.
No caso das tabelas de medidas estândar e de marca, a coluna de detalhes (picker) será predefinida carregadas por site.
Por exemplo, o vendedor indicou que seu tamanho principal devem ser do tipo US_SIZE, portanto a coluna SIZE é calculada de acordo com o que o vendedor indicou.
Exemplo do front de uma publicação com uma tabela de medidas associada.
Cada quadro azul (picker) no caso da imagem "9 US" faz referência as medidas designadas pelo vendedor como principais.
Criar tabela em domínios TOPS and BOTTOMS
Para domínios de TOPS e BOTTOMS, como, por exemplo: calças, camisas, vestidos, entre outros. Incluímos atributos do tipo de dados value_type: "list" uma Lista, que contém um conjunto de valores predeterminados pelo Mercado Livre para especificar certos atributos de uma tabela de medida personalizada. adicionalmente, você encontrará a tag multivalued que permitirá criar a guia com um ou mais valores específicos dentro da lista para cada linha, exemplo: você verá que o tamanho Small inclui os valores da lista de tamanhos de 26 a 30 (26, 27, 28, 29, 30), enquanto o tamanho Large corresponde a um único valor de tamanho 40.
Nos domínios TOPS and BOTTOMS você só pode usar guias de tipo SPECIFIC, ou guias personalizadas especificadas por cada vendedor.
Ao consultar a ficha técnica da tabela de medida verá no resultado um tipo de dado list que determina uma Lista, este atributo indicará os possíveis valores que pode tomar, tanto seu value_id como seu value_name.
Exemplo de criação de uma tabela de medidas personalizada, com medidas corporais, por uma Lista:
curl -L -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{
"names": {
"MLB": "Tabela TOPS and BOTTOMS de teste"
},
"domain_id": "PANTS_TEST",
"site_id": "MLB",
"attributes": [
{
"id": "GENDER",
"values": [
{
"name": "Feminino"
}
]
}
],
"main_attribute": {
"attributes": [
{
"site_id": "MLB",
"id": "SIZE"
}
]
},
"rows": [
{
"attributes": [
{
"id": "SIZE",
"values": [
{
"name": "Small"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"values": [
{
"name": "34"
},
{
"name": "36"
},
{
"name": "38"
},
{
"name": "40"
}
]
},
{
"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": "3259454"
},
{
"id": "3189154"
},
{
"id": "3189158"
}
]
},
{
"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": "52"
}
]
},
{
"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"
}
]
}
]
}
]
}'Resposta da criação de uma tabela de medidas com medidas corporais por uma Lista:
{
"id": "526618",
"names": {
"MLB": "Tabela TOPS and BOTTOMS de teste"
},
"domain_id": "PANTS_TEST",
"site_id": "MLB",
"type": "SPECIFIC",
"seller_id": 819780659,
"main_attribute_id": "SIZE",
"attributes": [
{
"id": "GENDER",
"name": "Gênero",
"values": [
{
"name": "Feminino"
}
]
}
],
"rows": [
{
"id": "526618:1",
"attributes": [
{
"id": "SIZE",
"name": "Tamanho",
"values": [
{
"name": "Small"
}
]
},
{
"id": "SIZE",
"name": "Tamanho da marca",
"values": [
{
"name": "Small"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"name": "Tamanho do filtro",
"values": [
{
"id": "3189130",
"name": "34"
},
{
"id": "3259450",
"name": "36"
},
{
"id": "3259451",
"name": "38"
},
{
"id": "3189142",
"name": "40"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"name": "Contorno da cintura de",
"values": [
{
"name": "82 cm",
"struct": {
"number": 82.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"name": "Contorno do quadril de",
"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": "526618:2",
"attributes": [
{
"id": "SIZE",
"name": "Tamanho",
"values": [
{
"name": "Medium"
}
]
},
{
"id": "SIZE",
"name": "Tamanho da marca",
"values": [
{
"name": "Medium"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"name": "Tamanho do filtro",
"values": [
{
"id": "3259454",
"name": "44"
},
{
"id": "3189154",
"name": "46"
},
{
"id": "3189158",
"name": "48"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"name": "Contorno da cintura de",
"values": [
{
"name": "86 cm",
"struct": {
"number": 86.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"name": "Contorno do quadril de",
"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": "526618:3",
"attributes": [
{
"id": "SIZE",
"name": "Tamanho",
"values": [
{
"name": "Large"
}
]
},
{
"id": "SIZE",
"name": "Tamanho da marca",
"values": [
{
"name": "Large"
}
]
},
{
"id": "PANTS_TEST_FILTRABLE_SIZES",
"name": "Tamanho do filtro",
"values": [
{
"id": "4146158",
"name": "52"
}
]
},
{
"id": "WAIST_CIRCUMFERENCE_FROM",
"name": "Contorno da cintura de",
"values": [
{
"name": "88 cm",
"struct": {
"number": 88.0,
"unit": "cm"
}
}
]
},
{
"id": "HIP_CIRCUMFERENCE_FROM",
"name": "Contorno do quadril de",
"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"
}
}
]
}
]
}
]
}
Considere que
- Os valores recibidos dentro do atributo list, serão validdos pela Lista que Mercado Livre dispõe na ficha técnica, caso envie um valor que não esteja dentro desta lista, retornará um error do 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 o campo de tipo list, envie value_id ou o value_name, caso envie ambos parâmetros o value_id tem maior relevância que value_name .
Criar tabelas com medidas de roupas
Apenas para os domínios de TOPS and BOTTOMS, após consultar a ficha técnica da tabela de medidas e reconhecer que atributos tem a tag de CLOTHING_MEASURE você poderá criar a tabela de medidas apenas especificando medidas de roupas.
Considere que:
- Você deve especificar o campo "measure_type" e seus possíveis valores: BODY_MEASURE, CLOTHING_MEASURE ou MIXED_MEASURE. Este campo faz referência ao tipo de medida que o vendedor especificará na tabela de medidas. Uma vez criada a tabela de medidas, este campo não poderá ser modificado.
- Uma mesma tabela de medidas poderá ter medida de roupas e corporais ao mesmo tempo utilizando o campo "measure_type" MIXED_MEASURE.
- Caso não envie o campo "measure_type" por funcionamento a tabela de medidas será de medidas corporais ou BODY_MEASURE e todas as validações serão a partir deste tipo de medida.
Exemplo de criação de uma tabela de medidas personalizada, com medidas de roupas:
curl -L -X POST 'https://api.mercadolibre.com/catalog/charts' -H 'Authorization: Bearer $ACCESS_TOKEN' -H 'Content-Type: application/json' -d '{ "names": { "MLB": "Tabela de teste de calças com as medidas da peça" }, "domain_id": "PANTS_TEST", "site_id": "MLB", "measure_type": "CLOTHING_MEASURE", "attributes": [ { "id": "GENDER", "values": [ { "name": "Feminino" } ] } ], "main_attribute": { "attributes": [ { "site_id": "MLB", "id": "SIZE" } ] }, "rows": [ { "attributes": [ { "id": "SIZE", "values": [ { "name": "46" } ] }, { "id": "PANTS_TEST_FILTRABLE_SIZES", "values": [ { "name": "S" } ] }, { "id": "GARMENT_LENGTH_FROM", "name": "Comprimento da roupa de", "values": [ { "name": "12 cm" } ] }, { "id": "GARMENT_WAIST_WIDTH_FROM", "name": "Largura da cintura da roupa de", "values": [ { "name": "30 cm" } ] }, { "id": "GARMENT_HIP_WIDTH_FROM", "name": "Largura do quadril da roupa de", "values": [ { "name": "40 cm" } ] }, { "id": "GARMENT_THIGH_WIDTH_FROM", "name": "Largura da coxa da roupa de", "values": [ { "name": "22 cm" } ] }, { "id": "GARMENT_INSEAM_LENGTH_FROM", "name": "Comprimento da costura interna da roupa de", "values": [ { "name": "11 cm" } ] }, { "id": "GARMENT_FRONT_RISE_FROM", "name": "Foto frontal da roupa de", "values": [ { "name": "13 cm" } ] } ] } ] }'
Consultar tabela de medidas
Você pode consultar uma tabela de medidas específica enviando o ID da tabela de medidas por meio do recurso/catalog/charts/$chart_id.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog/charts/232382Resposta
{ "id": "232382", "names": { "MLC": "Tabla de tallas Sandalias Niña" }, "domain_id": "SANDALS_AND_CLOGS", "site_id": "MLC", "type": "SPECIFIC", "seller_id": 12345667, "main_attribute_id": "MANUFACTURER_SIZE", "attributes": [ { "id": "GENDER", "name": "Género", "values": [ { "id": "339668", "name": "Niñas" } ] } ], "rows": [ { "id": "569686:1", "attributes": [ { "id": "SIZE", "name": "Talla", "values": [ { "name": "17" } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "10.9 cm", "struct": { "number": 10.9, "unit": "cm" } } ] }, { "id": "MANUFACTURER_SIZE", "name": "Talle de marca", "values": [ { "name": "17" } ] } ] }, { "id": "569686:2", "attributes": [ { "id": "SIZE", "name": "Talla", "values": [ { "name": "18" } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "11.5 cm", "struct": { "number": 11.5, "unit": "cm" } } ] }, { "id": "MANUFACTURER_SIZE", "name": "Talle de marca", "values": [ { "name": "18" } ] } ] }, { "id": "569686:3", "attributes": [ { "id": "SIZE", "name": "Talla", "values": [ { "name": "19" } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "12.2 cm", "struct": { "number": 12.2, "unit": "cm" } } ] }, { "id": "MANUFACTURER_SIZE", "name": "Talle de marca", "values": [ { "name": "19" } ] } ] }, { "id": "569686:4", "attributes": [ { "id": "SIZE", "name": "Talla", "values": [ { "name": "20" } ] }, { "id": "FOOT_LENGTH", "name": "Largo del pie", "values": [ { "name": "12.9 cm", "struct": { "number": 12.9, "unit": "cm" } } ] }, { "id": "MANUFACTURER_SIZE", "name": "Talle de marca", "values": [ { "name": "20" } ] } ] } }
Adicionar filas na tabela de medidas
Também será possível criar ou adicionar uma fila na tabela de medidas já criadasem necessidade de modificar toda a tabela. Basta realizar um POST no recurso /catalog/charts/$chart_id/rows e incluir a fila correspondente.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_ID/rowsExemplo para adicionar uma fila em uma tabelas de medida do 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/rowsExemplo para adicionar uma fila em uma tabela de medida do 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/rowsModificar fila na tabela de medida
Além de criar ou adicionar uma fila na tabela de medida, poderá modificar as já existentes. Realizando um PUT no recurso /catalog/charts/$chart_id/rows/$row_id e editando a fila correspondente, só se aplica aos casos em que você deseja adicionar informações extras, como no exemplo em que FOOT_LENGTH é adicionado.
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_ID/rows/$ROW_IDExemplo:
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/569686/rows/1
Modificar tabela de medida
Em uma tabela de medidas criada anteriormente, só é possível modificar o campo nome. Se tiver cometido um erro ao criar a tabela de medidas, por exemplo, nos tamanhos principais ou na atribuição de gênero, a tabela de medidas deverá ser recriada.
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d {...} https://api.mercadolibre.com/catalog/charts/$CHART_IDEjemplo:
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
Associar uma tabela de medidas a um itemPara atribuir uma tabela de medidas a publicações nos domínios exigidos, você terá que realizar um POST aos itens, enviando os novos atributos do tipo GRID_ID e GRID_ROW_ID, o que permitirá que você se refira ao (SIZE_GRID_ID) a tabela de medidas a qual desejamos associar o item ou variação e (SIZE_GRID_ROW_ID) em referência à linha na tabela de medida.
Exemplo de associação de uma tabela de medidas, para uma publicação sem variações, onde o atributo SIZE_GRID_ROW_ID vai para o nível dos atributos da publicação:
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/itemsExemplo de associação de uma tabela de medidas, para uma publicação com variações, onde o atributo SIZE_GRID_ROW_ID vai para o nível de atributo de cada uma das variações da publicação:
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" } ] } ] }'Eliminar Tabela de Medidas sem uso
Considere excluir apenas guias de tamanho que não estejam vinculadas a nenhum item.
Chamada:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/catalog/charts/$CHART_ID'Exemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/catalog/charts/124125'Resposta:
{ "message": "Before removing the size chart, we'll check that it isn't linked to any listing.
If it's still there after 24 hours, it means it's linked to one or more listings and you'll have to unlink it to remove it" }A Tabela de Medidas não é excluída imediatamente, mas é realizada uma verificação para garantir que não esteja relacionado a nenhum item ativo, conforme indicado na mensagem de sucesso da API.
Para saber se a Tabela de Medidas foi excluída com sucesso, é necessário consultar o seu status 24 horas após a solicitação da exclusão.
Ao verificar se a Tabela de Medidas está vinculada a um item ativo, o “chart_status” será atualizado para INACTIVE.
Caso seja detectado que ainda está em uso, ele não será excluído e o “chart_status” será mantido no status ACTIVE.
Esses status só serão visíveis ao visualizar uma Tabela de Medidas que está sendo removida ou cuja remoção foi solicitada.
Para garantir a correta eliminação, é necessário desvincular a guia de tamanhos de todos os itens, atualizando a Guia de Tamanhos e suas variações.
Próximo Validação da tabela de medidas.