Software de contabilitate cu un API

Fiecare parte a platformei Nordlet este disponibilă printr-un singur API JSON, cu pachete SDK, webhook-uri, reîncercări idempotente și un server MCP pentru asistenții AI.

Un API (interfață de programare a aplicațiilor) reprezintă o modalitate prin care un program poate comunica cu altul. Un API de contabilitate permite propriului tău software să creeze facturi, să înregistreze plăți și să citească rapoarte, fără ca o persoană să fie nevoită să parcurgă ecrane prin clicuri.

Nordlet este un software de contabilitate în care API-ul reprezintă calea principală de acces. Tot ceea ce face aplicația web este disponibil prin același API JSON. Această pagină se adresează atât dezvoltatorilor, cât și persoanelor care iau decizii cu privire la integrările produsului lor.

Ce face Nordlet

O singură formă de cerere. Fiecare apel este de tipul POST /v1/{module}/{resource}/{action} cu un corp JSON, de exemplu sales/invoices/create sau bank/transactions/match.
Chei API cu domenii de aplicare (scopes). Fiecare cheie aparține unei singure companii și include domenii de aplicare precum sales:read sau bank:write. O cheie care nu deține domeniul necesar va primi un răspuns 403.
Sume reprezentate ca text. Valorile monetare sunt șiruri zecimale cu până la 4 zecimale, niciodată numere în virgulă mobilă (floating-point), astfel încât să nu se piardă cenți din cauza rotunjirilor.
Un singur format de eroare. Orice eroare utilizează aceeași structură, care conține un cod, un mesaj și un ID de cerere.
Interogări de liste partajate. Orice apel de tip list acceptă aceleași câmpuri pentru paginare, sortare și filtrare, putând returna și totaluri.
Reguli contabile reale. Înregistrările contabile trebuie să fie în echilibru, numerele de document nu trebuie să prezinte întreruperi, iar o perioadă contabilă închisă respinge noile înregistrări cu un cod de răspuns 409. Orice modificare este consemnată într-un jurnal de audit (audit log).

Reîncercări sigure cu idempotență

O rețea poate întâmpina o eroare după ce cererea ta a fost procesată, dar înainte de a primi răspunsul. Încercarea repetată ar putea duce la crearea dublă a aceleiași facturi. Idempotența înseamnă că o cerere repetată are exact același efect ca prima.

Trimite un antet Idempotency-Key la orice apel care modifică date.
O reîncercare efectuată cu aceeași cheie și același corp al cererii va returna răspunsul salvat anterior, însoțit de antetul x-idempotent-replay: true.
Aceeași cheie utilizată cu un corp diferit va fi respinsă.
Cheile sunt stocate timp de 24 de ore.

Webhook-uri

Un webhook este un mesaj pe care Nordlet îl trimite serverului tău atunci când se produce un anumit eveniment, cum ar fi sale_invoice.paid.

Evenimentele sunt scrise în aceeași tranzacție de Baza de date ca și modificarea, astfel încât o modificare anulată (rolled back) nu va genera trimiterea niciunui eveniment.
Fiecare livrare este semnată prin HMAC-SHA256 folosind secretul tău de abonament, permițându-ți să verifici autenticitatea provenienței din Nordlet.
O livrare eșuată este reîncercată timp de aproximativ 24 de ore. De asemenea, poți declanșa o retrimitere manuală.
Abonamentele pot fi gestionate din secțiunea Account → Webhooks sau direct prin intermediul API-ului.

Instrumente pentru dezvoltatori

Documentație de referință API. O secțiune interactivă de referință API generată pe baza descrierii OpenAPI, însoțită de o colecție Postman.
Pachete SDK. Clienți cu tipuri definite pentru TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift și Rust, generați pe baza aceleiași descrieri. Consultă ghidul pentru SDK-uri.
Server MCP. Asistenții de tip AI, precum Claude, pot căuta și apela API-ul folosind cheia ta API. Consultă ghidul pentru serverul MCP.
Companii sandbox. O companie de test funcționează la fel ca una reală, este marcată drept date de test și transmite declarații și facturi electronice exclusiv către punctele finale de test ale autorităților fiscale.
Limită de apeluri (rate limit). 300 de cereri pe minut pentru fiecare cheie API, însoțite de anteturi care indică disponibilitatea rămasă.

Întrebări frecvente

Ce pot face prin intermediul API-ului?

Absolut tot ce se poate face în produs: facturare, achiziții, cartea mare, reconciliere bancară, stocuri, active, salarizare, rapoarte și declarații către autorități. Ghidul de noțiuni introductive prezintă un ciclu complet, de la factură până la valorile TVA-ului.

Pot integra funcționalități contabile în propriul meu produs?

Da. Fiecare companie din Nordlet are propriile registre contabile, iar software-ul tău le poate accesa prin intermediul cheii sale API. API-ul nu include nicio metodă de editare sau ștergere a unei înregistrări contabile validate. Orice corecție se efectuează printr-o nouă înregistrare, menținând astfel un registru imutabil.