Publicaciones requeridas
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.