Recursos

Infracciones y denuncias

Lo mismo que la página Infracciones del panel: qué infracciones de Mercado Libre tiene su cuenta, cuáles atender primero y qué hacer con cada una, y las denuncias de marca que todavía puede responder. Es lectura: no cambia nada en su cuenta.

Gravedad y acción recomendada

Cada infracción trae una gravedad (severity):

  • severe: propiedad intelectual (falsificación, denuncia de marca, réplicas) o producto prohibido. Son las que suspenden cuentas y las que cuenta el nivel de riesgo.
  • quality: calidad de la publicación (fotos, catálogo, categoría, compatibilidades…). Bajan la exposición, no suspenden.
  • informative: no exigen nada. También pasan a informativas las graves de una publicación ya cerrada, las que Mercado Libre ya resolvió por su cuenta y las de más de un año (estas con historic: true).

Y una acción recomendada (action), con next_step en español para mostrarlo tal cual:

  • repair_in_automeli: se repara desde la página Infracciones del panel (fotos, catálogo o categoría).
  • claim_to_ml: se reclama a Mercado Libre con el texto de claim_message.
  • close_and_block: cerrar la publicación y bloquear la marca o el producto en la lista negra. No se reclama.
  • fix_in_ml: se corrige en la publicación, dentro de Mercado Libre.
  • auto_paused: Automeli la pausa sola; no hay nada que hacer.
  • sanctioned_by_ml: Mercado Libre ya la sancionó; no se puede editar, pero cuenta para el riesgo.
  • none: nada que hacer.

Resumen: riesgo, qué atender y denuncias

GET/v2/infractions/summary
scopeaccount:read
RequestGET /infractions/summary
curl "https://api.automeli.com/api/v2/infractions/summary" \
     -H "X-API-Key: automeli_live_..."
200Response

risk.level: high, medium, low o none (orientativo; la regla va en risk.rule), contando las graves abiertas. to_do: un grupo por tipo, primero las graves (severity severe) y después las de calidad (quality), con by_action, main_action y next_step; las graves traen además reasons y hasta 5 sample_listing_ids. main_action: repair_in_automeli (se repara desde el panel), claim_to_ml (se reclama a Mercado Libre con claim_message, ver GET /infractions), close_and_block (cerrar y bloquear en la lista negra), fix_in_ml (se corrige en Mercado Libre), auto_paused (Automeli la pausa sola), sanctioned_by_ml o none. open_complaints: hasta 10 denuncias abiertas, la que vence primero arriba; hours_left = horas enteras hasta due_at (negativo = vencida), responded = ya presentó documentación y Mercado Libre la revisa; total_capped: true = hay 200 o más. paused_by_veto = publicaciones que Automeli pausó por la lista negra de productos. category_republished = las que Automeli republicó para corregir la categoría y cómo quedaron. last_check_at = última revisión pedida desde el panel. partial: true = faltan las partes de unavailable (counts, open_complaints, quality_groups, paused_by_veto, category_republished o last_check_at): counts llega como { available: false }, sin cifras, y las demás en null (quality_groups: sin los grupos de calidad en to_do); unavailable_detail dice por qué si aplica (más de 10.000 de calidad no se agrupan: use GET /infractions con severity=quality). Nunca lea un partial como cuenta limpia.

{
  "data": {
    "risk": {
      "level": "high",
      "severe_open": 7,
      "severe_last_7d": 0,
      "last_severe_at": "2026-11-04T16:03:45.000Z",
      "rule": "high: 5+ graves abiertas o 2+ en los últimos 7 días; medium: 1+ en 7 días o 2+ abiertas; low: 1 abierta. Es orientativo."
    },
    "counts": {
      "available": true,
      "severe": 7, "quality": 1238, "informative": 77, "resolved": 880, "total": 2202,
      "resolved_last_30d": 75
    },
    "to_do": [
      {
        "type": "PI_FAKES",
        "type_label": "Propiedad intelectual / Falsificación",
        "severity": "severe",
        "total": 1,
        "by_action": { "claim_to_ml": 1 },
        "main_action": "claim_to_ml",
        "main_action_label": "Reclamar a Mercado Libre",
        "next_step": "Envía el texto de claim_message a la IA de Mercado Libre desde la publicación; suele ganarse.",
        "reasons": [
          { "reason_id": 454, "reason": "Los datos del producto no coincidían entre sí.", "count": 1, "action": "claim_to_ml", "last_at": "2026-07-30T17:21:03.000Z" }
        ],
        "sample_listing_ids": ["MCO1234567890"]
      },
      {
        "type": "CATALOG",
        "type_label": "Catálogo",
        "severity": "quality",
        "total": 667,
        "by_action": { "repair_in_automeli": 446, "fix_in_ml": 221 },
        "main_action": "repair_in_automeli",
        "main_action_label": "Reparar aquí",
        "next_step": "Repárala desde la página de Infracciones de Automeli (fotos, catálogo o categoría): Automeli hace el cambio en Mercado Libre."
      }
    ],
    "sanctioned_by_ml": {
      "total": 6,
      "by_type": [
        { "type": "RECALL", "type_label": "Producto retirado del mercado", "total": 3 },
        { "type": "COMER", "type_label": "Producto prohibido para la venta", "total": 3 }
      ]
    },
    "open_complaints": {
      "total": 1,
      "total_capped": false,
      "items": [
        {
          "case_id": 81234567,
          "listing_id": "MCO9876543210",
          "sku": "B0EXAMPLE1",
          "title": "Gafas De Sol Polarizadas",
          "brand": "Acme",
          "complainant": "Acme Brands LLC",
          "reason": "Uso no autorizado de la marca",
          "status": "WAITING_DOCUMENTATION",
          "responded": false,
          "created_at": "2026-11-18T14:02:11Z",
          "due_at": "2026-11-22T14:02:11Z",
          "hours_left": 41
        }
      ]
    },
    "paused_by_veto": 6,
    "category_republished": { "total": 236, "ok": 108, "sanctioned_again": 37 },
    "last_check_at": null,
    "last_detection_at": "2026-11-15T06:05:28.000Z"
  },
  "partial": false,
  "unavailable": [],
  "context": { "seller_id": 108386, "environment": "live" }
}
Denuncias con plazo. open_complaints trae las denuncias de marca abiertas, la que vence primero arriba, con hours_left (horas hasta due_at; negativo = vencida). Una denuncia sin responder a tiempo se vuelve infracción. responded: true = ya presentó documentación y Mercado Libre la revisa. Para un aviso diario, consulte este endpoint una vez al día y avise de las que tengan responded: false.

risk.level (high, medium, low o none) es orientativo y la regla viene en risk.rule. to_do agrupa por tipo lo que falta atender: primero las graves, con sus motivos y algunas publicaciones de muestra, y después las de calidad. Para ver cada publicación, use el listado con el mismo type.

Respuesta parcial. En una cuenta con cientos de miles de infracciones, una parte del resumen puede no terminar a tiempo. El resto llega igual, con partial: true y la lista de lo que falta en unavailable (esa parte viene en null; counts llega como { available: false }). No es una cuenta limpia. Con más de 10.000 infracciones de calidad pendientes, las de calidad no se agrupan (unavailable_detail lo explica): consulte el listado con severity=quality. Si ni siquiera las graves terminan, responde 503 E_INFRACTION_TIMEOUT.
Errores posibles de este endpoint (4)
E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403
E_INFRACTION_TIMEOUT

Sólo v2 (GET /infractions y /infractions/summary): la consulta superó su tope de tiempo (cuentas con cientos de miles de infracciones). Trae Retry-After: 30; reintente una vez o, en el listado, acótelo (type, listing_id, sku o fechas)

503
E_INFRACTION_COOLDOWN

Sólo v2 (GET /infractions y /infractions/summary): esa misma consulta agotó el tiempo hace menos de 30 s y no se vuelve a correr. Espere lo que diga Retry-After o acótela

429
E_INTERNAL

Error inesperado. Reintente con backoff

503

Listar infracciones

Una fila por publicación, tipo y motivo, de la más reciente a la más vieja, paginadas por cursor. Por defecto, solo las pendientes.

GET/v2/infractions
scopeaccount:read
RequestGET /infractions
curl "https://api.automeli.com/api/v2/infractions?severity=severe&limit=20" \
     -H "X-API-Key: automeli_live_..."
200Response

Una fila por publicación, tipo y motivo. listing_status = estado en Mercado Libre. severity, action y sus *_label como en GET /infractions/summary; next_step dice qué hacer. claim_message = texto para reclamar a Mercado Libre (solo con action claim_to_ml). detection_count = cuántas veces Mercado Libre la detectó. resolution: pending, o cómo se resolvió (resolved_at). historic: true = grave de más de un año, que ya no cuenta para el riesgo. brand_complaint = la marca y el origen si fue una denuncia de marca. republished_as = la publicación nueva si Automeli la republicó para corregir la categoría (ok: si quedó activa o pausada). Sin filas con algún filtro además de status (en la primera página): hint y types_present (los tipos que la cuenta sí tiene con ese status; null si no se pudieron leer). Con solo status y sin filas no hay hint: no hay infracciones con ese status.

{
  "data": [
    {
      "listing_id": "MCO1234567890",
      "sku": "B0EXAMPLE2",
      "title": "Parrilla Enfriadora Acero Inoxidable",
      "listing_status": "under_review",
      "type": "DOMAIN",
      "type_label": "Categoría incorrecta",
      "reason_id": 305,
      "reason": "Estaba en una categoría incorrecta.",
      "severity": "quality",
      "severity_label": "Calidad de la publicación",
      "action": "repair_in_automeli",
      "action_label": "Reparar aquí",
      "next_step": "Repárala desde la página de Infracciones de Automeli (fotos, catálogo o categoría): Automeli hace el cambio en Mercado Libre.",
      "claim_message": null,
      "detected_at": "2026-11-13T14:47:17Z",
      "detection_count": 1,
      "resolution": "pending",
      "resolved_at": null,
      "historic": false,
      "brand_complaint": null,
      "republished_as": null
    }
  ],
  "next_cursor": "eyJsYXN0X2lkIjp7ImQiOiIyMDI2LTExLTEzIDE0OjQ3OjE3LjAwMDAwMCJ9fQ==",
  "has_more": true,
  "filters_applied": { "status": "pending" },
  "context": { "seller_id": 108386, "environment": "live" }
}

Los filtros se combinan entre sí, también con status (por defecto, pending): las informativas y la acción none solo salen con status=informative, resolved o all. severity, action y type aceptan varios valores separados por coma. Para reclamar, filtre por action=claim_to_ml: cada fila trae el texto listo en claim_message.

Cero filas con filtros (además de status) no significa que la cuenta esté limpia: la respuesta trae hint y types_present, los tipos que la cuenta sí tiene, para corregir el filtro (por ejemplo, HOMOL y no HOMOLOGACION).

Si una consulta tarda demasiado responde 503 E_INFRACTION_TIMEOUT con Retry-After: 30; repetir la misma consulta antes de ese plazo responde 429 E_INFRACTION_COOLDOWN. Acótela con type, listing_id, sku o fechas.

Errores posibles de este endpoint (5)
E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403
E_INFRACTION_INVALID_PARAM

Sólo v2 (GET /infractions): status, severity, action, type, listing_id, sku, fechas o limit inválido; el detalle dice cuál y qué valores acepta

422
E_INFRACTION_TIMEOUT

Sólo v2 (GET /infractions y /infractions/summary): la consulta superó su tope de tiempo (cuentas con cientos de miles de infracciones). Trae Retry-After: 30; reintente una vez o, en el listado, acótelo (type, listing_id, sku o fechas)

503
E_INFRACTION_COOLDOWN

Sólo v2 (GET /infractions y /infractions/summary): esa misma consulta agotó el tiempo hace menos de 30 s y no se vuelve a correr. Espere lo que diga Retry-After o acótela

429
E_INTERNAL

Error inesperado. Reintente con backoff

503