Recursos Cross

Explora los recursos principales de nuestras APIs
circulos azuis em degrade

Documentación

Puedes usar esta documentación para las siguientes unidades de negocio:

Última actualización 31/10/2023

Moderaciones con pausado

A diferencia de las moderaciones con status under_review, desde Mercado Libre también pausamos publicaciones por diferentes motivos, como:

  • Cambio inusual de precio: Cuando el vendedor modifica por error el precio.
  • Ítems sin ventas o abandonados: Cuando el vendedor tiene ítems sin ventas.
  • Carga de imágenes por URL: Cuando el vendedor publica imágenes mediante URL y estas aún no son procesadas.

Para todos estos casos, el vendedor podrá revisar y activar el ítem.


Flujo recomendado


Consultar moderaciones con ítems pausados

Realiza una búsqueda de publicaciones con status: paused y el tag moderation_penalty. Para activarla, debes realizar un PUT a /items con status: active, ya que este tipo de moderación preventiva solo pausa la publicación.


Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/0123456789/items/search?tags=moderation_penalty&status=paused

Respuesta:

{
   "seller_id": "0123456789",
   "paging": {...},
   "results": [
       "MLA1147839589",
       "MLA1148439168",
       "MLA1149506534",
       "MLA1157034561",
       "MLA1164314507",
       "MLA1173423437"
   ],
   "orders": [...],
   "available_orders": [...]
}

Cuando identifiques estos ítems, debes consultar sus moderaciones. Por ejemplo:


Moderación por cambio inusual de precio

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?related_item_id=$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/223456789?related_item_id=MLA135232000

Respuesta:

{
  "infractions": [
      {
          "id": "1378710000",
          "date_created": "2023-09-11T10:37:45.107-0400",
          "user_id": "223456789",
          "related_item_id": "MLA135232000",
          "element_id": "MLA135232000",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "DESC",
          "reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos.",
          "remedy": "Inactiva para revisar
La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos."
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 1,
      "total": 1
  },
  "sorting_type": "date_created_desc"
}

En este caso te recomendamos dar el accionable al vendedor de corregir precio y activar el ítem.


Moderación de ítem sin ventas

Los ítems sin ventas y/o sin visitas también podrán ser pausados por Mercado Libre para evitar afectar la reputación del vendedor. Ejecutando la misma llamada anterior, obtenemos información sobre este tipo de moderación. Conoce cómo gestionar las publicaciones que no tuvieron ventas en un largo periodo de tiempo.


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/453616000?related_item_id=MLA1363212345

Respuesta:

{
  "infractions": [
      {
          "id": "1399670000",
          "date_created": "2023-09-20T09:32:57.409-0400",
          "user_id": "453616000",
          "related_item_id": "MLA1363212345",
          "element_id": "MLA1363212345",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "PP",
          "reason": "La pausamos porque no tuvo ventas durante un largo periodo de tiempo. Lo hicimos para ayudarte en la gestión y evitarte cancelaciones.",
          "remedy": "Inactiva para revisar
Si todavía querés vender tu publicación, revisala para verificar que esté actualizada y reactivala para que vuelva a estar a la venta, o podés eliminarla si ya no vendés."
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 20,
      "total": 1
  },
  "sorting_type": "date_created_desc"
}

En este caso te recomendamos dar el accionable al vendedor de revisar la publicación para verificar que esté actualizada y reactivarla para que vuelva a estar a la venta o eliminarla si ya no vende.



Carga de imágenes por URL

En la creación de un nuevo ítem, si las imágenes son de tipo source (URL), el ítem quedará pausado, sub_status:picture_downloading_pending para indicarle al vendedor que aún no se descargaron. Cuando las imágenes se descarguen correctamente, el ítem tendrá status active automáticamente.
Recuerda que cada imagen será válida siempre que su dimensión sea como mínimo de 250px en ambos lados (width y height) y al menos un lado de más de 500px.


Respuesta:

{
    "infractions": [
        
        {
            "id": "1467440394",
            "date_created": "2023-10-10T19:01:02.73-0400",
            "user_id": "453616456",
            "related_item_id": "MLA1373668879",
            "element_id": "MLA1373668879",
            "element_type": "ITM",
            "site_id": "MLA",
            "filter_subgroup": "FOTOS",
            "reason": "La pausamos temporalmente porque estamos verificando que tu foto se haya cargado correctamente.",
            "remedy": "
La pausamos temporalmente porque estamos verificando que tu foto se haya cargado correctamente.
"
        }

Si la imagen no puede descargarse luego un período de tiempo definido, el ítem quedará moderado con status: under_review, sub_status: picture_downloading_pending.



Respuesta:

        {
            "id": "1467963806",
            "date_created": "2023-10-10T20:13:18.009-0400",
            "user_id": "453616456",
            "related_item_id": "MLA1373668879",
            "element_id": "MLA1373668879",
            "element_type": "ITM",
            "site_id": "MLA",
            "filter_subgroup": "FOTOS",
            "reason": "La foto no se cargó correctamente. Corregila para reactivar tu publicación.",
            "remedy": "
La foto no se cargó correctamente. Corrígela para reactivar tu publicación.
"
        },

En este caso te recomendamos dar el accionable al vendedor cargar nuevamente su imagen de portada, ya que no pudo ser procesada (link inválido de imagen).



Siguiente: Moderaciones de Imágenes.