Reportes

Endpoints de sólo lectura para obtener los reportes financieros de tu empresa: balance general, estado de resultados (P&L) y flujo de efectivo.

Estos cálculos son los mismos que ves en la app — Finova los calcula al vuelo, no se almacenan. Los reportes operan sobre incomes, expenses, deposits y cuentas en la zona horaria que indiques.

Todos los endpoints requieren el scope read-reports.

Parámetros comunes

Param	Tipo	Detalle
start_on	YYYY-MM-DD	Inicio del rango. Opcional para balance-sheet, requerido para los otros.
end_on	YYYY-MM-DD	Fin del rango. Opcional para balance-sheet (default: hoy), requerido para los otros.
timezone	string	IANA, ej. America/Mexico_City. Default America/Mexico_City.

Errores:

• 400 missing_parameters — falta start_on o end_on en income-statement / cash-flow.
• 422 report_failed — el servicio devolvió un error de validación (rango invertido, etc.).

---

Balance general

GET/api/v1/reports/balance-sheetread-reports

Snapshot de activos, pasivos y capital a una fecha de corte. Si omites end_on, se usa hoy.

cURL

curl 'https://developers.fi-nova.com/api/v1/reports/balance-sheet?end_on=2026-05-31' \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO'

JavaScript

const url = new URL('https://developers.fi-nova.com/api/v1/reports/balance-sheet');
url.searchParams.set('end_on', '2026-05-31');
const res  = await fetch(url, { headers: { Authorization: 'Bearer finova_sk_TU_SECRETO' } });
const { data } = await res.json();

El data incluye las secciones agregadas (assets, liabilities, equity) con los montos por moneda.

---

Estado de resultados (P&L)

GET/api/v1/reports/income-statementread-reports

Ingresos, costos, gastos y utilidad neta para el rango [start_on, end_on]. Requeridos.

cURL

curl 'https://developers.fi-nova.com/api/v1/reports/income-statement?start_on=2026-01-01&end_on=2026-03-31' \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO'

---

Flujo de efectivo

GET/api/v1/reports/cash-flowread-reports

Entradas y salidas de efectivo en el rango. Categoriza por operación, inversión y financiamiento cuando aplica.

cURL

curl 'https://developers.fi-nova.com/api/v1/reports/cash-flow?start_on=2026-01-01&end_on=2026-03-31&timezone=America/Mexico_City' \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO'

---

¿Y los exports a Excel?

Los exports a XLSX (los que descarga la app web vía /reports/balance-sheet/export) no están expuestos en la API pública por ahora. La intención es que tu integración consuma los datos JSON y los formatee en tu propio sistema. Si necesitas el XLSX directo, contáctanos.