Recursos Cross
Explora los recursos principales de nuestras APIs![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentación
Puedes usar esta documentación para las siguientes unidades de negocio:
Moderaciones con pausado
Flujo recomendado
![](https://http2.mlstatic.com/storage/developers-site-cms-admin/210250041477-espan-ol--1-.png)
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.