Publicaciones requeridas
Una publicación de marketplace es requerida para catálogo si es elegible con el tag catalog_listing_eligible y adicionalmente el producto de catálogo al cual la vas a asociar cuenta con el campo listing_strategy: catalog_required, en este caso Mercado Libre podrá moderar la publicación solicitando que publique en catálogo mediante el optin.
Algunos dominios únicamente se permite publicar productos a través de catálogo, quiere decir que, si la publicación de marketplace ya tiene su correspondiente producto de catálogo asociado, la publicación original de marketplace será inactivada por Mercado Libre.
Podrás utilizar el recurso /items/validate para reconocer previo a realizar un POST que cumplas con todas las validaciones, para poder publicar correctamente.
Te recomendamos consultar el recurso /products/search e identificar si tienes que publicarlo en catálogo antes de hacer un optin. En caso de que no puedas asociar la publicación a catálogo, tendrás que marcar tu publicación o variación para informar que no se encuentra el producto en nuestro catálogo mediante el recurso de /catalog_listing_eligibility/moderation_buybox/evaluate.
Reconocer productos previamente
Previo a crear nuevos productos en catálogo, debes reconocer si el producto existe y está activo. Para esto, realiza un GET al recurso /products/search con el filtro status:active 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).
- Informar publicación o variación requerida sin catalog_product_id (no encontrada en catálogo para asociar) evitando su moderación.
Llamada para reconocer productos requeridos en catálogo donde puedes usar el q o product_identifier o parent_product_id para hacer la búsqueda exacta:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/search?status=active&site_id=$SITE_ID&listing_strategy=catalog_required&q={q}
Ejemplo de llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/search?status=active&site_id=MLA&skip_cache=true&listing_strategy=catalog_required&q=Huawei Y6p 64 GB black
Ejemplo de respuesta acortada para un producto requerido en catálogo:
{
"keywords": "Huawei Y6p 64 GB black",
"paging": {
"total": 1,
"limit": 10,
"offset": 0
},
"results": [
{
"id": "MLA15996644",
"status": "active",
"domain_id": "MLA-CELLPHONES",
"settings": {
"listing_strategy": "catalog_required"
},
"name": "Huawei Y6p 64 GB midnight black 3 GB RAM",
"main_features": [],
"attributes": [ ...
],
"pictures": [
...
],
"parent_id": "MLA15996641",
"children_ids": []
}
]
}
Para nuevos dominios donde las publicaciones a catálogo sean requeridas, desde Mercado Libre implementamos una forma de que puedas reconocer el listado de todas las publicaciones de marketplace que deben publicarse en catálogo antes de ser moderadas y evitar fricciones con el vendedor.
Para identificarlas debes hacer uso del recurso GET items/search filtrando por el tag catalog_forewarning una vez identificadas, te recomendamos asociar cada publicación a un producto de catálogo (hacer optin) y evitar penalizaciones.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?tags=catalog_forewarning
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456/items/search?tags=catalog_forewarning
Respuesta acortada:
{
"seller_id": "123456",
"query": null,
"paging": {
"limit": 50,
"offset": 0,
"total": 15
},
"results": [
"MLA887478882",
"MLA830583442",
"MLA830570458",
"MLA835548382",
"MLA835731852",
"MLA837273858",
"MLA833333835",
"MLA833333341",
"MLA700204505",
"MLA703848375",
"MLA703848388",
"MLA708343730",
"MLA703234381",
"MLA712487522",
"MLA712883748"
],
"orders": [
...
],
"available_orders": [...]
}
Estas publicaciones de marketplace tendrán asociadas una fecha límite para ser asociadas a un producto de catálogo, luego de esta fecha, si el seller no hizo el optin (crear la publicación de catálogo), se ejecuta un proceso que va a remover el tag de catalog_forewarning y modera la publicación de marketplace bajo el filtro de OP_OBEY, puedes consultar esta fecha límite 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/date
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA830570458/catalog_forewarning/date
Respuesta 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 una fecha que ya expiró:
{
"status":"date_expired",
"moderation_date":"2020-06-10T13:00:00Z"
}
Marcar publicaciones de marketplace
Existen varias razones por las que a una publicación de marketplace no se le puede hacer OPTIN:
- Desde el search de productos no encuentras un producto de catálogo que cumpla con las condiciones de tu publicación de marketplace.
- Encontraste un producto de catálogo que se asemeja, pero comparando la ficha técnica en los principales atributos de tu publicación de marketplace encuentras que existen diferencias.
- No hay un producto de catálogo activo al cual puedas asociar la publicación de marketplace.
En cualquier caso, tendrás que marcar tu publicación o variación para informar a Mercado Libre que no puedes hacer OPTIN y esto se realiza mediante el llamado al recurso de /catalog_listing_eligibility/moderation_buybox/evaluate.
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{...}
https://api.mercadolibre.com/catalog_listing_eligibility/moderation_buybox/evaluate
Ejemplo para marcar una publicación de marketplace que tiene una variación:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
"item_id": "MLA3434544"
"variations": [{
"id": 3434343
}]
}
https://api.mercadolibre.com/catalog_listing_eligibility/moderation_buybox/evaluate
Respuesta:
{
"item_id": "MLA3434544"
"variations": [{
"id": 3434343
}]
"activation_date": "2021-09-03T13:00:00.000Z"
}
Ejemplo para marcar una publicación de marketplace sin variación:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
{
"item_id": "MLA3434544"
}
https://api.mercadolibre.com/catalog_listing_eligibility/moderation_buybox/evaluate
Dominios de venta exclusiva en catálogo
Algunos dominios son de venta exclusiva para catálogo, es decir, únicamente se puede publicar y vender a través de páginas de producto de catálogo y no de publicaciones del marketplace, por este motivo, al momento de hacer optin de una publicación de marketplace completa (todas las variaciones de la publicación tienen su correspondiente asociación a un producto de catálogo)), la publicación de marketplace se modera con status: under_review y solo podrás venderlo y gestionando a través de catálogo.
Para una publicación de marketplace creada en algún dominio de venta exclusiva para catálogo, vas a poder reconocer que se moderó por medio del tag: catalog_only_restricted.
"status": "under_review",
"sub_status": [
"forbidden"
],
"tags": [
"catalog_only_restricted",
"poor_quality_picture",
"test_item",
"immediate_payment",
"cart_eligible"
],
Para considerar:
- Las publicaciones de marketplace que tienen múltiples variaciones solo se inactivan después del optin completo de todas las variaciones en catálogo. De lo contrario, permanecerá activo.
- El flujo de dominios de venta exclusiva estará disponible únicamente nuevas publicaciones y al hacer optin, las publicaciones de marketplace que ya se encuentren dentro de estos dominios por ahora no serán afectados.
Moderaciones
A continuación, puedes reconocer si una publicación fue moderada (pausada) por no asociarla a tiempo a un producto de catálogo, validando su reason (causa) y remedy (accionable). Recuerda que, cualquier cambio o modificación que altere la calidad de la publicación, podrá generar su moderación.
Llamada:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/1234567
Respuesta para una publicación de marketplace moderada que no pertenece a un dominio de venta exclusiva en catálogo:
{
"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 (hacer optin) o marcar la publicación/variación para mencionar que no se encontró un producto para asociarla.
Respuesta para una publicación de marketplace moderada que pertenece a un dominio de venta exclusiva, este producto no se podrá reactivar nuevamente:
{
"infractions": [
{
"id": "943314941",
"date_created": "2022-05-23T16:52:14.387-0400",
"user_id": "1005109061",
"related_item_id": "MLA1138520248",
"element_id": "MLA1138520248",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "AP",
"reason": "La anulamos porque este producto solo puedes venderlo con tu publicación de catálogo.",
"remedy": "La anulamos porque este producto solo puedes venderlo con tu publicación de catálogo."
}
],
"paging": {
"offset": 0,
"limit": 20,
"total": 2
},
"sorting_type": "date_created_desc"
}
Tag de preaviso para pruebas
Para probar la funcionalidad de preaviso en dominios de catálogo requeridos, es necesario que:
- La publicación de marketplace sea elegible en catálogo, dentro de un producto activo.
- La publicación no puede ser de un producto de catálogo que ya pertenece a un dominio requerido. Caso contrario, al publicarse, el ítem será moderado.
Si cumples estos requisitos, carga los datos en el formulario para agregar el tag catalog_forewarning.
Siguiente: Competencia.