Publicaciones requeridas en catálogo

Ahora algunos productos deben publicarse en catálogo o tener una publicación de catálogo asociada para continuar vendiendo en Mercado Libre. Previo a saber si un producto forma parte de catálogo, te recomendamos consultar el recurso /products/search e identificar si tienes que publicarlo en catálogo.
En caso de que no puedas publicar ni asociar la publicación por no encontrar el producto en catálogo, podrás informar tu publicación o variación para informar que no se encuentra el producto en nuestro catálogo mediante el recurso /catalog_listing_eligibility/moderation_buybox/evaluate.

Contenidos

→Reconocer productos antes de publicar →Identificar publicaciones existentes para asociar (optin) →Fecha límite para publicar en catálogo →Informar publicación o variación requerida sin catalog_product_id →Consultar moderaciones →Agregar tag de preaviso en ítems de prueba


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:

Nota:
El vendedor podrá reconocer las publicaciones requeridas en catálogo por familia de producto, es decir, si decide vender un “Apple iPhone 3G 8 GB Negro 128 MB RAM” deberá asociarlo a una publicación de catálogo porque la familia de ese producto (iPhone 3) está activa en catálogo. En caso de que el producto o variación se encuentre dentro de una familia de productos requeridos en catálogo pero sus características específicas no se encuentren en catálogo, deberás marcarlo para evitar su moderación.

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_forewarning

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456987/items/search?tags=catalog_forewarning

Respuesta acotada:

{
    "seller_id": "123456987",
    "query": null,
    "paging": {
        "limit": 50,
        "offset": 0,
        "total": 1
    },
    "results": [
        "MLA123456789"
    ],
    "filters": [],
    "available_filters": [
            ]
}
Nota:
La respuesta del search mostrará en results todos los ítems del vendedor marcados con el tag catalog_forewarning.

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/date

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/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 fecha expirada:

{
   "status":"date_expired",
   "moderation_date":"2020-06-10T13:00:00Z"
}
Nota:
Recuerda filtrar y notificar las fechas limites de publicación en catálogo a tus vendedores para evitar que pausemos sus publicaciones y mejoren la experiencia de venta.

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).
  • Informar publicación o variación requerida sin catalog_product_id: 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 marcar estas publicaciones o variaciones.

Informar publicación o variación requerida sin catalog_product_id

Importante:
Esta funcionalidad estará disponible el 16 de noviembre de 2021.

Antes de informar una publicación o variación, asegúrate de que tu producto sea requerido en catálogo y de haber buscado, mediante el recurso /product_search, el producto activo para asociarlo. Si tu producto es requerido para catálogo y no encuentras un producto activo al cual asociar tu publicación, deberás marcar el ítem o variación de la siguiente manera.

Nota:
Las publicaciones marcadas con /catalog_listing_eligibility/moderation_buybox/evaluate serán revisadas internamente 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 con 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 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

Consultar moderaciones

A continuación, puedes reconocer si una publicación fue moderada (pausada) por no asociarla a tiempo a una publicación de catálogo, validando su reason (causa) y remedy (accionable). Recuerda: cualquier cambio o modificación que altere la calidad de la publicación, podrá generar su moderación.

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:

{
   "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 marcar el item / variación para mencionar que no se encontró un producto para asociarla.


Agregar tag de preaviso en ítems de prueba

Para 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. 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.

o regístrate para recibir las últimas novedades sobre nuestra API