Última actualización 06/09/2022

Publicaciones requeridas en catálogo

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

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 antes de publicar

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 acotada 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 acotada:

{
    "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 limite 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
Nota:
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.

Consultar 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 en catálogo.