Generar reporte de Mercado Pago

Solicita una generación puntual del reporte «Todas las transacciones» de esta conexión, por 1 a 60 días completos GMT-03.


Tool ID	`mercadopago.reportes.generar`
Nombre MCP	`mercadopago__reportes__generar`
Conector	`mercadopago`
Plano	`action`
Scope (permiso)	`mercadopago:write`
Auth	`connection_credentials`
Versión	`1`
Sensible	sí
Deprecado	no
Comportamiento	readOnly=false, destructive=true, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute_write de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Requiere consentimiento previo de una persona propietaria o administradora desde Ajustes o el alta y permiso mercadopago:write del actor y de la conexión y habilitación de reportes por Soporte; esta tool no otorga consentimiento. Una generación a pedido por cuenta y día de Chile, aparte de la diaria. Mercado Pago envía un correo al titular por cada reporte. Exige Idempotency-Key UUID v4 estable. Conserva la misma clave al repetir la solicitud; ante resultado_desconocido no cambies de clave ni solicites otra generación. Connect reconcilia con lecturas; sólo puede reenviar una vez tras 60 minutos sin candidatos ni pendientes comprobados. aceptado sólo confirma una generación pendiente; la descarga y validación del CSV corresponden al sync. No devuelve movimientos ni acredita cobertura.

Entrada

Campo	Tipo	Requerido	Descripción
`beginDate`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]
`endDate`	string `^(?:(?:\d\d[2468][048]	\d\d[13579][26]	\d\d0[48]

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "beginDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:Z))$",
      "description": "Inicio inclusivo del reporte, instante UTC ISO 8601 con segundos y Z, sin fracciones. Debe ser 03:00:00Z: inicio de un día completo GMT-03."
    },
    "endDate": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:Z))$",
      "description": "Fin inclusivo del reporte, instante UTC ISO 8601 con segundos y Z, sin fracciones. Debe ser 02:59:59Z del día posterior al último día pedido. Hasta 60 días completos desde beginDate."
    }
  },
  "required": [
    "beginDate",
    "endDate"
  ],
  "additionalProperties": false
}

Ejemplo

curl

curl -X POST https://connect.emisso.ai/api/v1/tools/mercadopago.reportes.generar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Idempotency-Key: 9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743" \
  -H "Content-Type: application/json" \
  -d '{"input":{"beginDate":"2026-10-25T03:00:00Z","endDate":"2026-10-26T02:59:59Z"}}'

MCP · meta-tool execute_write

{
  "tool": "mercadopago.reportes.generar",
  "params": {
    "beginDate": "2026-10-25T03:00:00Z",
    "endDate": "2026-10-26T02:59:59Z"
  },
  "connectionId": "conn_9tKfR2mQx4Vb",
  "idempotencyKey": "9d1f4c2a-7b30-4e58-9c11-2f6a8de5b743"
}

Clave de idempotencia obligatoria. Sin ella la llamada responde idempotency_key_missing. Genera un UUID v4 nuevo por operación y envíalo en Idempotency-Key (REST) o en idempotencyKey (MCP). Repite la misma clave solo al reintentar esa operación.

Salida esperada (200):

{
  "data": {
    "estado": "aceptado",
    "operacionId": "req_5tYw2nRk88Ma",
    "reporteId": "99336983670",
    "puedeReintentar": false
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "mercadopago.reportes.generar",
    "plane": "action",
    "latency_ms": 7410,
    "audit_status": "recorded"
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`estado`	`"aceptado"` · `"no_creado"` · `"resultado_desconocido"`	sí	aceptado: Mercado Pago aceptó una generación pendiente; no confirma CSV leído ni cobertura. no_creado: respondió sin crear el reporte. resultado_desconocido: el envío pudo ocurrir y no se puede confirmar su resultado.
`operacionId`	string	sí	request_id del servidor de la primera solicitud con esta clave de idempotencia; se conserva al repetir la misma clave.
`reporteId`	string	null	sí
`puedeReintentar`	booleano	sí	Siempre false: no generes otra clave ni repitas el efecto. Una repetición de transporte conserva la misma clave y recupera el resultado sin otro envío.
`motivo`	`"permiso_rechazado"`	no	permiso_rechazado: se observó HTTP 401 o 403 al acceder a reportes; el efecto de la generación puede seguir incierto y no invalida la credencial global. Revisa el permiso de reportes y vuelve a autorizar desde Ajustes si corresponde. Conserva la operación y su clave; no generes otra clave ante un resultado incierto.

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "estado": {
      "type": "string",
      "enum": [
        "aceptado",
        "no_creado",
        "resultado_desconocido"
      ],
      "description": "aceptado: Mercado Pago aceptó una generación pendiente; no confirma CSV leído ni cobertura. no_creado: respondió sin crear el reporte. resultado_desconocido: el envío pudo ocurrir y no se puede confirmar su resultado."
    },
    "operacionId": {
      "type": "string",
      "description": "request_id del servidor de la primera solicitud con esta clave de idempotencia; se conserva al repetir la misma clave."
    },
    "reporteId": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Identificador textual confirmado por Mercado Pago para la generación; null si no se conoce. No significa que el CSV esté listo o leído."
    },
    "puedeReintentar": {
      "type": "boolean",
      "const": false,
      "description": "Siempre false: no generes otra clave ni repitas el efecto. Una repetición de transporte conserva la misma clave y recupera el resultado sin otro envío."
    },
    "motivo": {
      "description": "permiso_rechazado: se observó HTTP 401 o 403 al acceder a reportes; el efecto de la generación puede seguir incierto y no invalida la credencial global. Revisa el permiso de reportes y vuelve a autorizar desde Ajustes si corresponde. Conserva la operación y su clave; no generes otra clave ante un resultado incierto.",
      "type": "string",
      "enum": [
        "permiso_rechazado"
      ]
    }
  },
  "required": [
    "estado",
    "operacionId",
    "reporteId",
    "puedeReintentar"
  ],
  "additionalProperties": false
}

Errores de esta tool

Código	HTTP	Reintentable	Qué hacer
`connection_disabled`	403	no	Reactívala en /connections o usa otra conexión del mismo sistema.
`connection_not_found`	404	no	Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
`connection_credential_required`	428	no	Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior.
`connection_busy`	409	sí	Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
`upstream_error`	502	sí	Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
`timeout`	504	sí	Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.