Dezvoltatori — API ContaFlow
API REST public pentru integrări. Document OpenAPI: descarcă openapi.json (importabil în Postman / Swagger / Insomnia).
Autentificare
Fiecare cerere trimite o cheie API per firmă în antet:
Authorization: Bearer cf_live_<prefix>_<secret>
Cheile se generează din Setări firmă → Chei API, cu nivel citire sau citire+scriere. URL de bază: /api/v1. Datele sunt izolate pe firma cheii.
Scrierile acceptă antetul Idempotency-Key (reluarea aceleiași chei nu dublează). Erorile au forma { "eroare": { "cod", "mesaj" } } (coduri HTTP 400/401/403/404/409/422).
Parteneri Clienți și furnizori
| Metodă | Cale | Descriere | Parametri |
|---|---|---|---|
| GET | /api/v1/parteneri | Listează partenerii | referintaExterna (query) |
| POST | /api/v1/parteneri | Creează un partener | — |
| GET | /api/v1/parteneri/{id} | Detalii partener | id* (path) |
Facturi Facturi emise/primite, postare, e-Factura XML
| Metodă | Cale | Descriere | Parametri |
|---|---|---|---|
| GET | /api/v1/facturi | Listează facturile | tip (query), referintaExterna (query) |
| POST | /api/v1/facturi | Creează o factură | — |
| GET | /api/v1/facturi/{id} | Detalii factură | id* (path) |
| POST | /api/v1/facturi/{id}/postare | Postează factura în contabilitate | id* (path) |
| GET | /api/v1/facturi/{id}/xml | XML e-Factura (UBL, doar facturi emise) | id* (path) |
Trezorerie Încasări și plăți
| Metodă | Cale | Descriere | Parametri |
|---|---|---|---|
| GET | /api/v1/trezorerie | Listează operațiunile | referintaExterna (query) |
| POST | /api/v1/trezorerie | Înregistrează o încasare/plată | — |
Note Note contabile
| Metodă | Cale | Descriere | Parametri |
|---|---|---|---|
| GET | /api/v1/note | Listează notele | referintaExterna (query) |
| POST | /api/v1/note | Creează o ciornă de notă | — |
| GET | /api/v1/note/{id} | Detalii notă | id* (path) |
| POST | /api/v1/note/{id}/postare | Postează nota | id* (path) |
Rapoarte Balanță, situații, registre, TVA (citire)
| Metodă | Cale | Descriere | Parametri |
|---|---|---|---|
| GET | /api/v1/balanta | Balanța de verificare | exercitiuId* (query), luna (query) |
| GET | /api/v1/registre/cartea-mare | Cartea Mare (fișa unui cont) | exercitiuId* (query), contId* (query) |
| GET | /api/v1/registre/inventar | Registrul Inventar | exercitiuId* (query) |
| GET | /api/v1/registre/jurnal | Registrul Jurnal | exercitiuId* (query) |
| GET | /api/v1/situatii | Situații financiare (bilanț + CPP + F40) | exercitiuId* (query), nrSalariati (query) |
| GET | /api/v1/tva/d300 | Decont D300 (defalcat pe cote) | an* (query), luna* (query) |
| GET | /api/v1/tva/d394 | Declarație D394 (pe partener) | an* (query), luna* (query) |
| GET | /api/v1/tva/decont | Decont TVA (sumar) | an* (query), luna* (query) |
Integrări Conectori (eMAG etc.)
| Metodă | Cale | Descriere | Parametri |
|---|---|---|---|
| POST | /api/v1/integrari/emag | Importă comenzi eMAG ca facturi | — |