Validação da tabela de medidas

Importante:
Este recurso está disponível para Brasil, Argentina e México.

Nosso objetivo é melhorar a experiência no site. Por isso, disponibilizamos a tabelas de medidas onde os vendedores da vertical de Moda podem dar mais detalhes das medidades 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. Revise a documentação para verificar como carregar uma tabela de medidas.

Conteúdos

→Definir domínio de moda a publicar →Consultar atributos para a tabela na ficha técnica de domínio →Consultar ficha técnica da tabela de medidas →Busca de domínios com tabelas de medidas criadas


Domínios disponíveis para uso do Tabela de medidas


Definir domínio de moda a publicar

Para seguir com o fluxo de publicar com uma tabela de medidas associada, é necessário revisar o predictor de categorias usando o recurso /domain_discovery.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/domain_discovery/search?q=$Q

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/domain_discovery/search?limit=1&q=Zapatillas

Resposta:

[
  {
    "domain_id": "MLA-SNEAKERS",
    "domain_name": "Zapatillas",
    "category_id": "MLA109027",
    "category_name": "Zapatillas",
    "attributes": [
    ]
  }
]


Consultar atributos para a tabela na ficha técnica de domínio

Já com a categoria da publicação identificada, deverá ser realizada uma consulta ao recurso de /domains/$domain_id/technical_specs, consultar a ficha técnica do domínio, reconhecer os atributos com "value_type": "grid_id" y "grid_row_id" que permitem identificar se o domínio requer uma tabela de medidas.
Adicionalmente, terá que reconhecer aqueles atributos que contem com a tag "grid_template_required", os quais serão requeridos para a busca da ficha técnica da tabela de medidas.

Nota:
A partir de agora as tabelas de medidas passam a ter uma ficha técnica, que é definida segundo o domínio do item. E com base nesta ficha técnica se define que informações são necessárias ter em conta no momento da criação da tabela de medidas.

Identificados os atributos, deve-se continuar completando os atributos para a criação tabela de medidas.


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specs

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/MLA-SNEAKERS/technical_specs

Respuesta:

{
   "input": {
       "groups": [
           {
               "id": "MAIN",
               "label": "Características principales",
               "relevance": 1,
               "section": "SPECIFICATIONS",
               "ui_config": {},
               "components": [
                   {
                       "component": "COMBO",
                       "label": "Marca",
                       "ui_config": {
                           "hint": "Escribe la marca real del producto o 'Genérica' si no tiene marca.",
                           "allow_custom_value": true,
                           "allow_filtering": true
                       },
                       "attributes": [
                           {
                               "id": "BRAND",
                               "name": "Marca",
                               "value_type": "string",
                               "value_max_length": 255,
                               "tags": [
                                   "grid_filter",
                                   "catalog_required",
                                   "required"
                               ],
                               "values": [],
                               "hierarchy": "PARENT_PK",
                               "relevance": 1
                           }
                       ],
                       "unified_units": []
                   },
                   {},
                   {},
                   {},
                   {
                       "component": "COMBO",
                       "label": "Género",
                       "ui_config": {
                           "allow_custom_value": false,
                           "allow_filtering": true
                       },
                       "attributes": [
                           {
                               "id": "GENDER",
                               "name": "Género",
                               "value_type": "list",
                               "tags": [
                                   "grid_template_required",
                                   "grid_filter",
                                   "catalog_required",
                                   "required"
                               ],
                               "values": [
                                   {
                                       "id": "339665",
                                       "name": "Mujer"
                                   },
                                   {
                                       "id": "339666",
                                       "name": "Hombre"
                                   },
                                   {
                                       "id": "339668",
                                       "name": "Niñas"
                                   },
                                   {
                                       "id": "339667",
                                       "name": "Niños"
                                   },
                                   {
                                       "id": "110461",
                                       "name": "Sin género"
                                   }
                               ],
                               "hierarchy": "PARENT_PK",
                               "relevance": 1
                           }
                       ],
                       "unified_units": []
                   },
                   {},
                   {},
                   {},
                   {},
                   {
                       "component": "GRID_ROW_INPUT",
                       "label": "ID de la fila de la guía de talles",
                       "ui_config": {
                           "allow_custom_value": false,
                           "allow_filtering": false
                       },
                       "attributes": [
                           {
                               "id": "SIZE_GRID_ROW_ID",
                               "name": "ID de la fila de la guía de talles",
                               "value_type": "grid_row_id",
                               "value_max_length": 255,
                               "tags": [
                                   "vip_hidden",
                                   "hidden",
                                   "variation_attribute"
                               ],
                               "hierarchy": "CHILD_PK",
                               "relevance": 1
                           }
                       ],
                       "unified_units": []
                   },
                   {}
               ]
           },
           {
               "id": "DMT",
               "label": "Otras características",
               "relevance": 1,
               "section": "SPECIFICATIONS",
               "ui_config": {},
               "components": [
                   {},
                   {},
                   {},
                   {},
                   {},
                   {
                       "component": "GRID_INPUT",
                       "label": "ID de la guía de talles",
                       "ui_config": {
                           "allow_custom_value": false,
                           "allow_filtering": false
                       },
                       "attributes": [
                           {
                               "id": "SIZE_GRID_ID",
                               "name": "ID de la guía de talles",
                               "value_type": "grid_id",
                               "value_max_length": 255,
                               "tags": [
                                   "vip_hidden"
                               ],
                               "hierarchy": "FAMILY",
                               "relevance": 1
                           }
                       ],
                       "unified_units": []
                   },
                   {},
                   {
                       "component": "COMBO",
                       "label": "Deportes recomendados",
                       "ui_config": {
                           "allow_custom_value": true,
                           "allow_filtering": true
                       },
                       "attributes": [
                           {
                               "id": "RECOMMENDED_SPORTS",
                               "name": "Deportes recomendados",
                               "value_type": "string",
                               "value_max_length": 255,
                               "tags": [
                                   "multivalued",
                                   "grid_filter"
                               ],
                               "values": [],
                               "hierarchy": "FAMILY",
                               "relevance": 1
                           }
                       ],
                       "unified_units": []
                   },
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {},
                   {}
               ]
           }
       ]
   },
   "output": {}
}

Consultar ficha técnica da tabela de medidas

A ficha técnica da tabela de medidas vai determinar a estrutura dos atributos com uma tabela de medidas na publicação, deverá realizar um POST ao recurso de /domains/$domain_id/technical_specs?section=grids e enviar todos os atributos reconhecidos anteriormente com a tag de "grid_template_required".


Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specs/?section=grids

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
    "attributes": [
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "14671",
            "value_name": "Nike",
            "value_struct": null,
            "values": [
                {
                    "id": "14671",
                    "name": "Nike",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "GENDER",
            "name": "Género",
            "value_id": "339665",
            "value_name": "Mujer",
            "value_struct": null,
            "values": [
                {
                    "id": "339665",
                    "name": "Mujer",
                    "struct": null
                }
            ],
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ]
}'
https://api.mercadolibre.com/domains/MLA-SNEAKERS/technical_specs/?section=grids

Resposta:

Nota:
Considere esta resposta que é a Ficha Técnica para a criação de uma tabela de medidas no produto.


{
  "input": {
    "groups": [{
      "id": "SIZE_CHART",
      "label": "Guía de talles",
      "relevance": 1,
      "section": "GRIDS",
      "ui_config": {},
      "components": [{
        "component": "GRID",
        "label": "Guia de Talles",
        "ui_config": {
          "max_allowed": 75,
          "allow_custom_value": true,
          "allow_filtering": false
        },
        "components": [{
            "component": "TEXT_OUTPUT",
            "label": "Género",
            "ui_config": {},
            "attributes": [{
              "id": "GENDER",
              "name": "Género",
              "value_type": "string",
              "tags": [
                "grid_template_required",
                "grid_filter",
                "fixed",
                "catalog_required",
                "required"
              ],
              "values": [{
                "id": "339665",
                "name": "Mujer"
              }],
              "hierarchy": "PARENT_PK",
              "relevance": 1
            }],
            "unified_units": []
          },
          {
            "component": "TEXT_OUTPUT",
            "label": "Marca",
            "ui_config": {},
            "attributes": [{
              "id": "BRAND",
              "name": "Marca",
              "value_type": "string",
              "value_max_length": 255,
              "tags": [
                "grid_filter",
                "catalog_required",
                "required"
              ],
              "hierarchy": "PARENT_PK",
              "relevance": 1
            }],
            "unified_units": []
          },
          {
            "component": "TEXT_INPUT",
            "label": "Edad",
            "ui_config": {},
            "attributes": [{
              "id": "AGE_GROUP",
              "name": "Edad",
              "value_type": "string",
              "value_max_length": 255,
              "tags": [
                "hidden",
                "read_only",
                "grid_filter"
              ],
              "hierarchy": "PARENT_PK",
              "relevance": 1
            }],
            "unified_units": []
          },
          {
            "component": "TEXT_INPUT",
            "label": "Estilo",
            "ui_config": {},
            "attributes": [{
              "id": "STYLE",
              "name": "Estilo",
              "value_type": "string",
              "value_max_length": 255,
              "tags": [
                "grid_filter",
                "required"
              ],
              "hierarchy": "FAMILY",
              "relevance": 1
            }],
            "unified_units": []
          },
          {
            "component": "TEXT_INPUT",
            "label": "Deportes recomendados",
            "ui_config": {},
            "attributes": [{
              "id": "RECOMMENDED_SPORTS",
              "name": "Deportes recomendados",
              "value_type": "string",
              "value_max_length": 255,
              "tags": [
                "multivalued",
                "grid_filter"
              ],
              "hierarchy": "FAMILY",
              "relevance": 1
            }],
            "unified_units": []
          },
          {
            "component": "NUMBER_UNIT_INPUT",
            "label": "Largo del pie",
            "ui_config": {
              "allow_custom_value": false,
              "allow_filtering": false
            },
            "attributes": [{
              "id": "FOOT_LENGTH",
              "name": "Largo del pie",
              "value_type": "number_unit",
              "value_max_length": 255,
              "tags": [
                "required"
              ],
              "default_unit_id": "cm",
              "units": [{
                  "id": "\"",
                  "name": "\""
                },
                {
                  "id": "cm",
                  "name": "cm"
                }
              ],
              "hierarchy": "CHILD_PK",
              "relevance": 1
            }],
            "default_unified_unit_id": "cm",
            "unified_units": [{
                "id": "\"",
                "name": "\""
              },
              {
                "id": "cm",
                "name": "cm"
              }
            ]
          },
          {
            "component": "TEXT_INPUT",
            "label": "Talle de marca",
            "ui_config": {
              "allow_custom_value": false,
              "allow_filtering": false
            },
            "attributes": [{
              "id": "MANUFACTURER_SIZE",
              "name": "Talle de marca",
              "value_type": "string",
              "value_max_length": 255,
              "tags": [
                "unique",
                "main_attribute_candidate"
              ],
              "hierarchy": "ITEM",
              "relevance": 1
            }],
            "unified_units": []
          },
          {
            "component": "NUMBER_UNIT_INPUT",
            "label": "AR",
            "ui_config": {
              "allow_custom_value": false,
              "allow_filtering": false
            },
            "attributes": [{
              "id": "AR_SIZE",
              "name": "AR",
              "value_type": "number_unit",
              "value_max_length": 255,
              "tags": [
                "main_attribute_candidate"
              ],
              "default_unit_id": "AR",
              "units": [{
                "id": "AR",
                "name": "AR"
              }],
              "hierarchy": "CHILD_PK",
              "relevance": 1
            }],
            "default_unified_unit_id": "AR",
            "unified_units": [{
              "id": "AR",
              "name": "AR"
            }]
          },
          {
            "component": "NUMBER_UNIT_INPUT",
            "label": "US-F",
            "ui_config": {
              "allow_custom_value": false,
              "allow_filtering": false
            },
            "attributes": [{
              "id": "F_US_SIZE",
              "name": "US-F",
              "value_type": "number_unit",
              "value_max_length": 255,
              "tags": [
                "main_attribute_candidate"
              ],
              "default_unit_id": "US",
              "units": [{
                "id": "US",
                "name": "US"
              }],
              "hierarchy": "CHILD_PK",
              "relevance": 1
            }],
            "default_unified_unit_id": "US",
            "unified_units": [{
              "id": "US",
              "name": "US"
            }]
          },
          {
            "component": "NUMBER_UNIT_INPUT",
            "label": "EU",
            "ui_config": {
              "allow_custom_value": false,
              "allow_filtering": false
            },
            "attributes": [{
              "id": "EU_SIZE",
              "name": "EU",
              "value_type": "number_unit",
              "value_max_length": 255,
              "tags": [
                "main_attribute_candidate"
              ],
              "default_unit_id": "EU",
              "units": [{
                "id": "EU",
                "name": "EU"
              }],
              "hierarchy": "CHILD_PK",
              "relevance": 1
            }],
            "default_unified_unit_id": "EU",
            "unified_units": [{
              "id": "EU",
              "name": "EU"
            }]
          },
          {
            "component": "NUMBER_UNIT_INPUT",
            "label": "UK",
            "ui_config": {
              "allow_custom_value": false,
              "allow_filtering": false
            },
            "attributes": [{
              "id": "UK_SIZE",
              "name": "UK",
              "value_type": "number_unit",
              "value_max_length": 255,
              "tags": [
                "main_attribute_candidate"
              ],
              "default_unit_id": "UK",
              "units": [{
                "id": "UK",
                "name": "UK"
              }],
              "hierarchy": "CHILD_PK",
              "relevance": 1
            }],
            "default_unified_unit_id": "UK",
            "unified_units": [{
              "id": "UK",
              "name": "UK"
            }]
          }
        ]
      }]
    }]
  }
}


Busca de domínios com tabelas de medidas criadas

Com o recurso de /catalog/charts/$site_id/domains/search será possível reconhecer os domínios que atualmente contam com tabelas de medidas para que o vendedor possa usar e seja por Marca (que são as tabelas de medidas oferecidas pelas marcas (BRAND), estândar (STANDARD) ou personalizadas (SPECIFIC) configuradas por site, enviando o filtro type=BRAND , type=STANDARD ou type=SPECIFIC e site correspondente no corpo do POST.

Nota:
As tabelas de medidas padrão Mercado Livre e as fornecedias pelas marcas já contam com toda a informação requerida já completa (Ficha técnica e valores).

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/domains/search

Exemplo de domínios configurados com tabelas de medidas fornecedias pelas marca:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
      "site_id": "MLA",      
      "type": "BRAND"
}' https://api.mercadolibre.com/catalog/charts/domains/search

Exemplo de domínios configurados com tabelas de medida padrão Mercado Livre:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
        "site_id": "MLA",      
        "type": "STANDARD"
}' https://api.mercadolibre.com/catalog/charts/domains/search

Exemplo de domínios configurados com tabelas de medidas personalizadas:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
      "site_id": "MLA",     
       "type": "SPECIFIC"

}' https://api.mercadolibre.com/catalog/charts/domains/search

Resposta:

{
   "domains": [
       {
           "domain_id": "SNEAKERS"
       },
       {
           "domain_id": "BOOTS_AND_BOOTIES"
       },
       {
           "domain_id": "SANDALS_AND_CLOGS"
       },
       {
           "domain_id": "LOAFERS_AND_OXFORDS"
       },
       {
           "domain_id": "FOOTBALL_SHOES"
       },
       {
           "domain_id": "SNEAKERS_TEST"
       }
   ]
}


Domínios disponíveis para uso do Tabela de medidas

Abaixo detalhamos quais domínios são ativados para uso do tabela de medidas.

Domínio Disponibilidade
SNEAKERS Argentina, México e Brasil.
BOOTS_AND_BOOTIES Argentina, México e Brasil.
LOAFERS_AND_OXFORDS Argentina, México e Brasil.
FOOTBALL_SHOES Argentina, México e Brasil.
SANDALS_AND_CLOGS Argentina, México e Brasil. Roll out 12 de abril.
ou registre-se para receber as últimas notícias sobre nossa API