Validación de guía de talles
Contenidos
→Definir dominio de moda a publicar →Consultar atributos para la guía en la ficha técnica del dominio →Consulta ficha técnica de la guía de talles →Búsqueda de dominios con guías de talles creadas →Dominios disponibles para el uso de la guía de talles
Definir dominio de moda a publicar
Para avanzar en el flujo de publicación con una guía de talles asociada, es necesario revisar el predictor de categorías mediante el recurso de /domain_discovery.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/$SITE_ID/domain_discovery/search?q=$QEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/domain_discovery/search?limit=1&q=ZapatillasRespuesta:
[
{
"domain_id": "MLA-SNEAKERS",
"domain_name": "Zapatillas",
"category_id": "MLA109027",
"category_name": "Zapatillas",
"attributes": []
}
]
Consultar atributos para la guía en la ficha técnica del dominio
Ya con la categoría y dominio identificado para la publicación, deberás realizar una consulta al recurso de /domains/$domain_id/technical_specs y consultar la ficha técnica del dominio reconocer los atributos con "value_type": "grid_id" y "grid_row_id" que permitirán identificar si el dominio requiere una guía de talles.
Adicionalmente tendrás que reconocer aquellos atributos que cuenten con el tag de "grid_template_required" los cuales serán requeridos para la búsqueda de la ficha técnica de la guía de talles.
Identificados los atributos, debes continuar completando los atributos para la creación de la guía de talles.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specsEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/domains/MLA-SNEAKERS/technical_specsRespuesta:
{
"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": {}
}
Consulta ficha técnica de la guía de talles
La ficha técnica de la guía de talles va a determinar la estructura de los atributos que tiene una guía de talles dentro de la publicación, deberás realizar un POST al recurso de /domains/$domain_id/technical_specs?section=grids y enviar todos los atributos reconocidos anteriormente con el tag de "grid_template_required".
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...}
https://api.mercadolibre.com/domains/$DOMAIN_ID/technical_specs/?section=gridsEjemplo:
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=gridsRespuesta:
{
"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"
}]
}
]
}]
}]
}
}
Búsqueda de dominios con guías de talles creadas
Con el recurso de /catalog/charts/$site_id/domains/search se puede reconocer los dominios que actualmente cuentan con Guías de talle que el vendedor puede usar ya sea por marca (BRAND), estándar (STANDARD) o personalizadas (SPECIFIC) configuradas por sites, enviando el filtro “type=BRAND” , “type=STANDARD” o “type=SPECIFIC” y el site correspondiente en el body del POST.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {...} https://api.mercadolibre.com/catalog/charts/domains/searchEjemplo de dominios configurados con guías por 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/searchEjemplo de dominios configurados con guías estándar:
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
Ejemplo de dominios configurados con guías 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
Respuesta:
{
"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"
}
]
}
Dominios disponibles para el uso de la guía de talles
A continuación detallamos cuales dominios están encendidos para el uso de la guía de talles.
| Dominio | Disponibilidad |
|---|---|
| SNEAKERS | Argentina, México y Brasil. |
| BOOTS_AND_BOOTIES | Argentina, México y Brasil. |
| LOAFERS_AND_OXFORDS | Argentina, México y Brasil. |
| FOOTBALL_SHOES | Argentina, México y Brasil. |
| SANDALS_AND_CLOGS | Argentina, México y Brasil. Roll out 12 de abril. |
Conoce más sobre Gestionar guía de talles
.Ingrese o regístrate para recibir las últimas novedades sobre nuestra API
