# 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. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ----------------------------------------------------------------- | | **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`](/docs/referencia/conexiones/estado-consultar). ## Qué hace [#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 [#entrada] | Campo | Tipo | Requerido | Descripción | | | | | | | | | | | | | | | | | | ----------- | --------------------------------- | ----------------- | ----------- | ---------------- | ---------------------- | --------------------- | ------------------ | ------- | ------- | ---------- | -------------- | ------- | --- | ----------------- | --- | ------------------------ | ----------------------------------- | -- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `beginDate` | string \`^(?:(?:\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))$\` | sí | 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` | string \`^(?:(?:\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))$\` | sí | 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. |
JSON Schema de entrada ```json { "$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 [#ejemplo] ```bash title="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"}}' ``` ```json title="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):** ```json { "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 [#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í | 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` | 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 ```json { "$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 [#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](/docs/referencia/errores).