API · INTEGRACIONES

Conecta Finoview con tu software.
En las dos direcciones.

Una API REST sobre JSON para leer los datos financieros de tus empresas e importar empresas hacia Finoview. Autenticación por API key, aislada por cuenta.

Dos formas de integrarte

Entendemos que cada software es distinto: por eso damos facilidades para conectarse y para integrarse.

Conectar · leer

Lleva tus datos de Finoview a tu BI, ERP o software. Empresas, balance, cuenta de resultados, cash flow y ratios — con etiquetas legibles.

  • GET de empresas y estados financieros
  • Todos los años, todas tus empresas
  • Listo para Power BI y Excel

Integrar · escribir

Que tu software contable o ERP exporte empresas hacia Finoview, con tu propio plan de cuentas PGC.

  • POST de empresas y ejercicios
  • Mapea desde cuentas PGC: nosotros calculamos
  • Idempotente: reimportar no duplica

Cómo funciona

1 · Genera tu API key

Desde tu perfil en Finoview, en un clic. Solo lectura, o con permiso de escritura para importar.

2 · Llama a la API

Una cabecera Authorization y listo. JSON entra, JSON sale. Versionada en /api/v1.

3 · Sincroniza

Reenviar los mismos datos actualiza, no duplica. Pensado para mantener todo al día.

Una API, dos verbos

Leer las cifras del último ejercicio

curl "https://api.finoview.com/api/v1/companies/<ID>/financials?year=latest" \
  -H "Authorization: Bearer fv_live_…"

Importar una empresa y un ejercicio

curl -X POST https://api.finoview.com/api/v1/companies \
  -H "Authorization: Bearer fv_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": "ACME SL", "cif": "B12345678", "source": "MI_SOFTWARE",
        "years": [{ "year": 2025, "accounts": { "700": 1500000 } }] }'

Seguridad por defecto

Keys hasheadas

Nunca guardamos el token; comparación en tiempo constante (modelo estilo Stripe).

Aislamiento por cuenta

Una key solo accede a tus datos. Jamás a los de otra cuenta.

Permisos mínimos

La escritura requiere una key específica. Las de lectura no pueden escribir.

¿Eres un software que quiere exportar a Finoview?

Patrón bring-your-own-key: la API key la emite la cuenta de Finoview que recibe los datos. Tu app solo la pide y hace POST — no tienes que registrarte ni pedirnos nada.

El usuario trae su key

Añade un campo "Pega tu API key de Finoview" en tu app. El cliente la genera en su perfil con permiso de escritura.

Una Sumas y Saldos por año

saldo = debe − haber (signo natural). Finoview aplica el signo, suma los padres y calcula los ratios.

Idempotente y atribuido

Reenviar actualiza, no duplica (dedup por CIF + origen). Cada empresa lleva tu source.

¿List@ para conectar?

Crea tu cuenta, genera una API key y empieza a leer o importar datos en minutos.