Reporte mensual de verificaciones (CSV / XLSX / PDF / preview)

GET https://api.veriko.mx/v1/finance/monthly

Audiencia: public
Autenticación: API key
Permiso: finance:generate_self

Listado SAT-friendly de las verificaciones del mes en 15 columnas: Fecha, Folio plataforma, Tipo, Clave de rastreo, Fecha operación, Monto, Banco emisor, CLABE emisora, Banco receptor, CLABE receptora, Beneficiario, Veredicto Banxico, CEP disponible, Folio CEP, Tiempo (ms).

format=csv (predeterminado, text/csv; charset=utf-8): CSV plano con BOM UTF-8 y header de marca [HEADER].
format=xlsx (application/vnd.openxmlformats-officedocument.spreadsheetml.sheet): libro con encabezado congelado, autofiltro y formato de celda.
format=pdf (application/pdf): ledger estilo extracto, máximo 1000 filas. Para volúmenes mayores usa csv o xlsx.
format=preview (application/json): primeras 20 filas como JSON FinancePreviewResponse para previsualizar en UI.

Administradores con finance:generate_all pueden consultar otro usuario vía ?user_id=<uuid>.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`format`	query	`string`	opcional	Formato de salida. Predeterminado: `csv`
`month` *	query	`string`	obligatorio	Mes a reportar en formato `YYYY-MM`.
`user_id`	query	`string (uuid)`	opcional	Solo para administradores con `finance:generate_all`. UUID del usuario a consultar.

Petición

cURLPython•JavaScript•PHP•

curl -X GET 'https://api.veriko.mx/v1/finance/monthly' \
  -H 'Authorization: Bearer mxcep_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200** `FinancePreviewResponse` — Stream CSV/XLSX/PDF, o envelope JSON en modo preview.
Campo	Tipo	Descripción
`type`	`string`	Tipo del recurso JSON:API (siempre `finance_preview`).
`attributes`	`object`	Campos del preview del reporte.
`report`	`string`	Tipo de reporte: `monthly` — estado de cuenta mensual; `counterparties` — top contrapartes; `by-bank` — desglose por banco; `accounting` — libro diario contable.
`month`	`string`	Mes del reporte en formato YYYY-MM.
`headers`	`array`	Nombres de las columnas del CSV, en el mismo orden que las filas en `rows`.
`rows`	`array` (elementos: ?–20)	Primeras 20 filas de datos del reporte (máximo).

**Códigos de respuesta** `GET /v1/finance/monthly`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Stream CSV/XLSX/PDF, o envelope JSON en modo preview.	`FinancePreviewResponse`
400	`4xx`	Parámetro `month` inválido o ausente	`ErrorResponse`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
500	`5xx`	`pdf_render_failed` — el renderer PDF truena (OOM/fuente). Probar CSV o XLSX.	`ErrorResponse`

**Cabeceras de respuesta** `200`
Cabecera	Tipo	Descripción
`Cache-Control`	`string`	Disables intermediary caching de la descarga (no aplica al modo preview).
`Content-Disposition`	`string`	Nombre de archivo sugerido (no aplica al modo preview).

**Errores de `GET /v1/finance/monthly`**
Código	Clave	Detalle
400	`invalid_month`	'month' is required and must be YYYY-MM. Envelope meta.request_id `d5e6f7a8b9c1`
401	`unauthorized`	Invalid or missing authentication credentials. Envelope meta.request_id `c4d5e6f7a8b9`
403	`forbidden`	You do not have permission to access this resource. Envelope meta.request_id `d5e6f7a8b9c0`