Publicaciones requeridas en catálogo
Mira nuestro webinar:
Contenidos
→Reconocer productos antes de publicar →Identificar publicaciones existentes para asociar (optin) →Fecha límite para publicar en catálogo →Crear publicaciones de mayor calidad →Validar calidad de publicaciones ↳Product Identifiers (PIs) ↳Imágenes ↳Título y descripción →Consultar moderaciones →Agregar tag de preaviso en ítems de prueba
Antes de comenzar, puedes ver el flujo recomendado para publicar:
Reconocer productos antes de publicar
Previo a crear nuevas publicaciones, debes reconocer si el producto existe y está activo en catálogo. Para esto, realiza un GET al recurso /products/search con el filtro status y revisa mediante el listing_strategy: catalog_required si el producto debe estar publicado en catálogo. En este caso, podrás:
- Publicar de manera directa en catálogo
- Realizar una publicación tradicional y asociarla a una publicación de catálogo (optin)
- Crear una publicación de marketplace de mayor calidad
De esta manera, evitarás que tu publicación sea moderada (pausada) por Mercado Libre.
Ejemplo de producto requerido a catálogo:
{
"keywords": " Apple iphone 3g",
"domain_id": "MLA-CELLPHONES",
"paging": {
"total": 3,
"limit": 10,
"offset": 0
},
"results": [
{
"id": "MLA6005934",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Apple iPhone iPhone 3G 8 GB Negro 128 MB RAM",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "9344",
"value_name": "Apple"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "58993",
"value_name": "iPhone"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "14605",
"value_name": "iPhone 3G"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52049",
"value_name": "Negro"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59566",
"value_name": "8 GB"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "579543",
"value_name": "128 MB"
},
{
"id": "MAIN_COLOR",
"name": "Color principal",
"value_id": "2450295",
"value_name": "Negro"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7404961",
"value_name": "iOS"
}
],
"pictures": [
{
"id": "675782-MLA31138875214_062019",
"url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
},
{
"id": "915001-MLA31138546867_062019",
"url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
},
{
"id": "881441-MLA31138332972_062019",
"url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
},
{
"id": "804666-MLA31139286536_062019",
"url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
}
]
},
{
"id": "MLA6007403",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Apple iPhone iPhone 3G 16 GB Negro 128 MB RAM",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "9344",
"value_name": "Apple"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "58993",
"value_name": "iPhone"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "14605",
"value_name": "iPhone 3G"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52049",
"value_name": "Negro"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59561",
"value_name": "16 GB"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "579543",
"value_name": "128 MB"
},
{
"id": "MAIN_COLOR",
"name": "Color principal",
"value_id": "2450295",
"value_name": "Negro"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7404961",
"value_name": "iOS"
}
],
"pictures": [
{
"id": "675782-MLA31138875214_062019",
"url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
},
{
"id": "915001-MLA31138546867_062019",
"url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
},
{
"id": "881441-MLA31138332972_062019",
"url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
},
{
"id": "804666-MLA31139286536_062019",
"url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
}
]
},
{
"id": "MLA6007404",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Apple iPhone iPhone 3G 16 GB Blanco 128 MB RAM",
"attributes": [
{
"id": "BRAND",
"name": "Marca",
"value_id": "9344",
"value_name": "Apple"
},
{
"id": "LINE",
"name": "Línea",
"value_id": "58993",
"value_name": "iPhone"
},
{
"id": "MODEL",
"name": "Modelo",
"value_id": "14605",
"value_name": "iPhone 3G"
},
{
"id": "IS_DUAL_SIM",
"name": "Es Dual SIM",
"value_id": "242084",
"value_name": "No"
},
{
"id": "COLOR",
"name": "Color",
"value_id": "52055",
"value_name": "Blanco"
},
{
"id": "INTERNAL_MEMORY",
"name": "Memoria interna",
"value_id": "59561",
"value_name": "16 GB"
},
{
"id": "RAM",
"name": "Memoria RAM",
"value_id": "579543",
"value_name": "128 MB"
},
{
"id": "MAIN_COLOR",
"name": "Color principal",
"value_id": "2450308",
"value_name": "Blanco"
},
{
"id": "OPERATING_SYSTEM_NAME",
"name": "Nombre del sistema operativo",
"value_id": "7404961",
"value_name": "iOS"
}
],
"pictures": [
{
"id": "675782-MLA31138875214_062019",
"url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
},
{
"id": "915001-MLA31138546867_062019",
"url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
},
{
"id": "881441-MLA31138332972_062019",
"url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
},
{
"id": "804666-MLA31139286536_062019",
"url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
}
]
}
]
}Identificar publicaciones existentes para asociar
Para reconocer las publicaciones de marketplace actuales que deben publicarse en catálogo, consulta al recurso search con el parámetro catalog_forewarning y filtra este tipo de publicaciones. Una vez identificadas, te recomendamos asociar cada publicación a una de catálogo (optin) y evitar penalizaciones.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?tags=catalog_forewarningEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456987/items/search?tags=catalog_forewarningRespuesta acotada:
{
"seller_id": "123456987",
"query": null,
"paging": {
"limit": 50,
"offset": 0,
"total": 1
},
"results": [
"MLA123456789"
],
"filters": [],
"available_filters": [
]
}Fecha límite para publicar en catálogo
Reconociendo estas publicaciones, consulta la fecha límite que tendrás como plazo para publicar el producto en catálogo realizando una consulta al recurso /catalog_forewarning/date.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/catalog_forewarning/dateEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/catalog_forewarning/dateRespuesta de publicación con fecha asignada:
{
"status":"date_defined",
"moderation_date":"2020-08-20T13:00:00Z"
}Respuesta de publicación que no tiene el tag de catalog_forewarning:
{
"status":"date_not_defined",
"moderation_date": null
}Respuesta de publicación con fecha expirada:
{
"status":"date_expired",
"moderation_date":"2020-06-10T13:00:00Z"
}Para evitar que las publicaciones existentes sean moderadas (pausadas) por no haber sido publicadas a tiempo en catálogo, puedes:
- Asociar la publicación a un producto existente: para esto, primero debes confirmar que el producto del catálogo coincida con el de tu publicación y luego asociar la publicación (optin).
- Crear la publicación de mayor calidad: esta solución está disponible sólo si tu producto no existe en catálogo y por ende, no puedes asociarlo (optin) por ejemplo debido al color del producto que vendes. A continuación, te explicamos cómo crear publicaciones de mayor calidad.
Crear publicaciones de mayor calidad
Este tipo de publicaciones estará disponible en caso de que la familia de producto que se encuentre requerida a catálogo, no cuente con el producto específico que se está queriendo publicar. Para esto, deberás completar adecuadamente los siguientes requisitos del producto:
- GTIN obligatorio
- Atributos requeridos
- Título y descripción con información del producto (próximamente)
- Imágenes de óptima calidad (próximamente)
Para reconocer este tipo de publicaciones consulta al recurso /items y verifica el tag catalog_product_candidate de cada ítem.
Recuerda que aunque la publicación cuente con el tag mencionado podría ser pausada si no cumple con los requisitos de calidad descritos. Con el status: under_review puedes identificar los ítems pausados de este tipo de publicaciones que no cumplen los requisitos.
Ejemplo de ítem con mayor calidad:
{
"id": "MLA123456789",
"site_id": "MLA",
"title": "Item De Testeo, Por Favor No Ofertar --kc:off",
"subtitle": null,
"seller_id": 123456987,
"category_id": "MLA3530",
"official_store_id": null,
"price": 50,
"base_price": 50,
"original_price": null,
"currency_id": "ARS",
"initial_quantity": 1,
"available_quantity": 1,
"sold_quantity": 0,
"sale_terms": [ ],
"buying_mode": "buy_it_now",
"listing_type_id": "free",
"start_time": "2020-02-17T16:30:39.000Z",
"stop_time": "2020-04-17T04:00:00.000Z",
"condition": "new",
"permalink": "https://articulo.mercadolibre.com.ar/MLA-839616438-item-de-testeo-por-favor-no-ofertar-kcoff-_JM",
"thumbnail": "http://mla-s1-p.mlstatic.com/951410-MLA40807113659_022020-I.jpg",
"secure_thumbnail": "https://mla-s1-p.mlstatic.com/951410-MLA40807113659_022020-I.jpg",
"pictures": [ ],
"video_id": null,
"descriptions": [ ],
"accepts_mercadopago": true,
"non_mercado_pago_payment_methods": [ ],
"shipping": { },
"international_delivery_mode": "none",
"seller_address": { },
"seller_contact": null,
"location": { },
"geolocation": { },
"coverage_areas": [ ],
"attributes": [ ],
"warnings": [ ],
"listing_source": "",
"variations": [ ],
"status": "active",
"sub_status": [ ],
"tags": [
"catalog_product_candidate",
"good_quality_picture",
"test_item",
"immediate_payment"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-02-17T16:30:40.000Z",
"last_updated": "2020-02-17T16:34:12.000Z",
"health": 0.4,
"catalog_listing": false
}Validar calidad de publicaciones
Este recurso de validación te permitirá verificar si un ítem cumple con los parámetros requeridos de calidad. Recuerda que una publicación puede ser moderada en caso de que algún requisito de calidad de este tipo de publicación no sea correcto o no esté completo.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validateEjemplo de validación que cumple con parámetros de calidad requerida:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"title": "ok",
"description":"ok",
"category_id": "MLA538565",
"pictures":[
"967960-MLA41175135696_032020"
],
"domain_id":"MLA-CELLPHONES",
"attributes":[
{
"id": "BRAND",
"name": "Marca",
"value_id": "995",
"value_name": "Apple"
},
{
"id": "GTIN",
"value_name": "0190198457012"
}
]
}Ejemplo de validación que no cumple los parámetros de calidad requerida:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"title": "Test title",
"description":"Test title",
"category_id": "MLA438566",
"pictures":[
"967960-MLA41175135696_032020"
],
"domain_id":"MLA-CELLPHONES",
"attributes":[
{
"id": "BRAND",
"name": "Marca",
"value_id": "995",
"value_name": "Apple"
},
{
"id": "GTIN",
"value_name": "0190198457011"
}
]
}Respuesta en caso de que la información consultada es incorrecta:
{
"message": "Validation error",
"error": "validation_error",
"status": 400,
"cause": [
{
"cause_id": 6004,
"code": "item.product_identifier.invalid",
"message": "El código no corresponde a tu producto.",
"references": [
"0190198457011",
"PI_INCORRECT"
],
"type": "error"
},
{
"cause_id": 6001,
"code": "item.title.invalid",
"message": "Title has invalid topics",
"references": [
"LOCATION"
],
"type": "error"
},
{
"cause_id": 6002,
"code": "item.description.invalid",
"message": "Description has invalid topics",
"references": [
"LINK_TO_STORE",
"LOCATION",
"STOCK"
],
"type": "error"
},
{
"cause_id": 6003,
"code": "item.picture.invalid",
"message": "Picture quality is not good",
"references": [
"967960-MLA41175135696_032020",
"logo_text_watermark",
"blur"
],
"type": "error"
}
]
}Campos de la respuesta
status: puede tener valores 400 cuando algunos de los parámetros que valides no cumplan la calidad requerida y valor 204 cuando los parámetros cumplen con la calidad requerida.
cause: tendrá las múltiples causas que generan el error de validación dependiendo las que hayan sido enviadas en el POST. Pueden ser por GTIN, título, descripción y/o imágenes.
- cause_id: refiere a las validaciones enviadas y no son de calidad.
- code: es el código descriptivo por el cual se produce el error.
- message: es el motivo del error por el cual falla la validación.
- references: son las validaciones que fallaron. Para el caso de imágenes y PIs hacemos referencia al id que no pasa la validación.
Validar Product Identifiers (PIs)
Para validar correctamente PIs, te recomendamos enviar el site_id, domain_id y los atributos BRAND (opcional), MODEL (opcional) y GTIN con sus respectivos value_name.
Ejemplo de validación de Product Identifiers:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"domain_id":"MLA-CELLPHONES",
"attributes":[
{
"id":"BRAND",
"name":"Marca",
"value_id":"995",
"value_name":"Apple"
},
{
"id":"MODEL",
"value_name":"iPhone X"
},
{
"id":"GTIN",
"value_name":"0190198457011"
}
]
}Respuesta con errores de PI:
{
"message":"Validation error",
"error":"validation_error",
"status":400,
"cause":[
{
"cause_id":6004,
"code":"item.product_identifier.invalid",
"message":"El código no corresponde a tu producto.",
"references":[
"0190198457011",
"PI_INCORRECT"
],
"type":"error"
}
]
}Posibles mensajes de error
- El código no corresponde a tu producto.
- El código no pertenece a la categoría.
- El código no pertenece a la marca.
Validar imágenes
Para validar imágenes de publicaciones de mayor calidad debes realizar un POST enviando site_id y id de la imagen a analizar. Para eso, debes cargar las imágenes en nuestros servidores y el “category_id” en la cual vas a publicar. Conoce la categoría a publicar utilizando el predictor de categorías.
Ejemplo de validación de imágenes:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id": "MLA",
"category_id": "MLA438566",
"pictures": [
"967960-MLA41175135696_032020",
"967961-MLA41175135696_032020"
]
}Respuesta con errores de imágenes:
{
"message":"Validation error",
"error":"validation_error",
"status":400,
"cause":[
{
"cause_id":6003,
"code":"item.picture.invalid",
"message":"Picture quality is not good",
"references":[
"967960-MLA41175135696_032020",
"logo_text_watermark",
"blur"
],
"type":"error"
}
]
}Posibles errores de imágenes
minimum_size: evalúa si alguna de las imágenes de la publicación supera el mínimo de 500 x 500 px.
logo_text_watermark: evalúa si la primera imagen de la publicación contiene logos, texto, banners promocionales o marcas de agua.
white_background: evalúa si la primera imagen de la publicación tiene fondo blanco puro, es decir, fondo blanco creado con un editor de imágenes, en lugar de una foto de producto frente a una pared u otro elemento.
multiproduct: evalúa si la primera imagen contiene más de un producto. Por ejemplo, no permitimos que la primera imagen de la publicación contenga varios pares de zapatillas.
blur: evalúa que las imágenes de la publicación no sean borrosas.
unprofessional_photo: se ejecuta cuando el resto de las validaciones da negativo. Evalúa tres condiciones a la vez: multiproducto, fondo blanco y logos. No significa que la imagen cumpla las tres, sino que puede no estar cumpliendo con alguna de las tres.
Validar título y descripción
Con esta validación puedes reconocer si el título y la descripción del producto no es de calidad.
tienen en cuenta tópicos o información que buscamos que no se encuentre en el título o descripción de un producto, cada tópico cuenta con una descripción de alcance indicando lo que abarca.
Para realizar el POST de validación de título y descripción debes enviar site_id, title y description.
Ejemplo de validación de título y descripción:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"title": "Apple Iphone X Rose",
"description":"Fotos amplias y perfectas de día y de noche. Un color rosado perfecto."
}Respuesta con errores de título y descripción:
{
"message":"Validation error",
"error":"validation_error",
"status":400,
"cause":[
{
"cause_id":6001,
"code":"item.title.invalid",
"message":"Title has invalid topics",
"references":[
"LOCATION"
],
"type":"error"
},
{
"cause_id":6002,
"code":"item.description.invalid",
"message":"Description has invalid topics",
"references":[
"LINK_TO_STORE",
"LOCATION",
"STOCK"
],
"type":"error"
}
]
}Posibles errores de título y descripción
En la respuesta podrás reconocer los diferentes tópicos por los cuales la publicación no cumple los requisitos de calidad en su título o descripción. En primer instancia, validaremos:
| Tópicos | Detalles |
|---|---|
| SHIPPING | Contiene información del envío, por ejemplo proceso de envío del producto, cómo se envía el producto, costo de envío, detalle del transporte o demora del envío |
| METHOD_OF_PAYMENT | Contiene información del pago, como formas de pago aceptadas o financiación |
| BILLING | Contiene información de la facturación, por ejemplo si emite factura A o B y formas de envío de estas (por email, correo) |
| WARRANTY | Contiene información de la garantía del producto, duración o términos de esta |
| LOCATION | Contiene información de la tienda física, ubicación, puntos de retiro, procedencia del producto |
Próximamente, sumaremos los siguientes tópicos a las validaciones:
| Tópicos | Detalles |
|---|---|
| PICKUP | Contiene información del proceso de entrega del producto, como en sucursal, kioscos, correo o domicilio del vendedor |
| TECHNICAL_SUPPORT | Contiene información del servicio técnico ofrecido por la sucursal |
| ABOUT_US | Contiene información del vendedor |
| FAQ | Contiene información sobre preguntas frecuentes en las descripciones del producto |
| STOCK | Contiene información del stock |
| LEGAL | Contiene información legal como Términos y Condiciones |
| OFFICE_HOURS | Contiene información de la atención |
| LINK_TO_STORE | Contiene links a publicaciones de Mercado Libre o links externos |
Consultar moderaciones
A continuación, consulta al recurso /moderations/infractions y reconoce si una publicación fue moderada (pausada) por no asociarla a tiempo a una publicación de catálogo. Puedes reconocerla con el reason (causa) y remedy (accionable):
Reason: La pausamos porque no ofreces el producto también en catálogo.
Remedy: Publica tu producto en catálogo para seguir vendiéndolo. Cuando lo hagas, tu publicación original se reactivará automáticamente.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_IDEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/1234567Respuesta:
{
"infractions": [
{
"id": "594794188",
"date_created": "2020-10-28T01:43:32.414-0400",
"user_id": "1234567",
"related_item_id": "MLA1692147078",
"element_id": "MLA1692147078",
"element_type": "ITM",
"site_id": "MLA",
"reason": "La pausamos porque no ofreces el producto también en catálogo.",
"remedy": "Publica tu producto en catálogo para seguir vendiéndolo. Cuando lo hagas, tu publicación original se reactivará automáticamente."
}
],
"paging": {
"offset": 0,
"limit": 2,
"total": 20671
},
"sorting_type": "date_created_desc"
}Para reactivar tu publicación deberás asociar la publicación a catálogo (optin) o crear publicaciones de mayor calidad. Conoce más cómo notificar la fecha límite para publicar en catálogo y evitar este tipo de moderación.
Moderaciones en publicaciones de mayor calidad
Con el anterior recursos también puedes identificar los motivos de moderación de una publicación de mayor calidad cuando la respuesta tenga:
Reason: La pausamos porque el código universal está incompleto o es incorrecto. Remedy: Revisá el código universal del producto para volver a activarla.
Para reactivar estas publicaciones, valida los parámetros de calidad.
Agregar tag de preaviso en ítems de prueba
Para que puedas probar la funcionalidad de preaviso, es necesario que: El ítem de marketplace sea elegible para una publicación de Catálogo existente. El ítem no puede ser de un catálogo/producto ya requerido, que, en caso contrario, al publicarse el ítem ya cae en moderación. Una vez que se cumplan estos requisitos, carga los datos en el formulario para agregar el tag catalog_forewarning.
Siguiente: Competencia en catálogo.
