Última actualización 10/01/2023

Publicaciones requeridas

Nota:
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.
Importante:
Este recurso está disponible en Argentina, México, Brasil, Colombia, Chile y Uruguay.

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:

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.

Nota:
Las publicaciones marcadas con /catalog_listing_eligibility/moderation_buybox/evaluate serán revisadas por Mercado Libre para validar que lo informado sea correcto. Caso contrario, serán moderadas por OPT_OBEY.

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
Notas:
- Desde Mercado Libre estamos encendiendo progresivamente los dominios de venta exclusiva en catálogo, iniciando con ELECTRIC_SHOWER_HEADS el 20/06/22 y CELLPHONES el 27/06/22.

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

Nota:
Esta funcionalidad no está disponible para Perú ni para Ecuador, ya que las publicaciones no se están moderando.


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.