API · INTEGRACIONS
Connecta Finoview amb el teu programari.
En les dues direccions.
Una API REST sobre JSON per llegir les dades financeres de les teves empreses i importar empreses cap a Finoview. Autenticació per clau d'API, aïllada per compte.
Dues maneres d'integrar-te
Entenem que cada programari és diferent: per això donem facilitats per connectar-se i per integrar-se.
Connectar · llegir
Porta les teves dades de Finoview al teu BI, ERP o programari. Empreses, balanç, compte de resultats, cash flow i ràtios — amb etiquetes llegibles.
- GET d'empreses i estats financers
- Tots els anys, totes les teves empreses
- A punt per a Power BI i Excel
Integrar · escriure
Que el teu programari comptable o ERP exporti empreses cap a Finoview, amb el teu propi pla de comptes PGC.
- POST d'empreses i exercicis
- Mapeja des de comptes PGC: nosaltres calculem
- Idempotent: reimportar no duplica
Com funciona
1 · Genera la teva clau d'API
Des del teu perfil a Finoview, en un clic. Només lectura, o amb permís d'escriptura per importar.
2 · Crida l'API
Una capçalera Authorization i llestos. Entra JSON, surt JSON. Versionada a /api/v1.
3 · Sincronitza
Tornar a enviar les mateixes dades actualitza, no duplica. Pensat per mantenir-ho tot al dia.
Una API, dos verbs
Llegir les xifres de l'últim exercici
curl "https://api.finoview.com/api/v1/companies/<ID>/financials?year=latest" \
-H "Authorization: Bearer fv_live_…"Importar una empresa i un exercici
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 } }] }'Seguretat per defecte
Claus amb hash
Mai no guardem el token; comparació en temps constant (model a l'estil d'Stripe).
Aïllament per compte
Una clau només accedeix a les teves dades. Mai a les d'un altre compte.
Permisos mínims
L'escriptura requereix una clau específica. Les de lectura no poden escriure.
Ets un programari que vol exportar a Finoview?
Patró bring-your-own-key: la clau d'API l'emet el compte de Finoview que rep les dades. La teva app només la demana i fa POST — no t'has de registrar ni demanar-nos res.
Afegeix un camp "Enganxa la teva clau d'API de Finoview" a la teva app. El client la genera al seu perfil amb permís d'escriptura.
saldo = deure − haver (signe natural). Finoview aplica el signe, suma els pares i calcula les ràtios.
Tornar a enviar actualitza, no duplica (dedup per CIF + origen). Cada empresa porta el teu source.
A punt per connectar?
Crea el teu compte, genera una clau d'API i comença a llegir o importar dades en minuts.