Nordlet pentru dezvoltatori de aplicații

Adăugați facturare, contabilitate și declarații fiscale din UE în software-ul dvs. printr-un singur API JSON, SDK-uri tipizate, webhook-uri, un server MCP și companii sandbox.

Multe aplicații generează evenimente financiare: o comandă este achitată, un abonament se reînnoiește, se emite o rambursare. Fiecare dintre aceste evenimente trebuie să ajungă în contabilitatea unei companii.

Nordlet este un software de contabilitate conceput de la zero pentru API-uri (API-first). Tot ceea ce face aplicația web este disponibil și prin intermediul unui singur API JSON. Aplicația dvs. trimite evenimentele, iar Nordlet ține evidența contabilă și pregătește declarațiile fiscale.

Ce face Nordlet

Expune fiecare acțiune sub forma POST /v1/{module}/{resource}/{action} cu un corp JSON, de exemplu /v1/sales/invoices/create.
Autentifică fiecare cerere cu o cheie API care aparține unei singure companii. Fiecare cheie include permisiuni (scopes), cum ar fi sales:read sau sales:write, care îi limitează acțiunile.
Prelucrează sumele ca șiruri de caractere zecimale (decimal strings), niciodată ca numere cu virgulă mobilă (floating-point), astfel încât să nu se piardă cenți din cauza rotunjirilor.
Acceptă un antet Idempotency-Key pentru fiecare modificare. O reîncercare cu aceeași cheie returnează primul răspuns în loc să execute din nou operațiunea. Idemponența (idempotency) înseamnă că o cerere repetată are același efect ca o singură cerere.
Returnază fiecare eroare într-un format comun.
Permite 300 de cereri pe minut pentru fiecare cheie API.
Înregistrează fiecare modificare într-un jurnal de audit (audit log).

Ghidul privind convențiile API tratează în detaliu fiecare dintre aceste reguli.

Înregistrări contabile care rămân corecte

Emiterea unei facturi atribuie un număr secvențial fără întreruperi, verifică dacă perioada contabilă (accounting period) este deschisă și înregistrează nota contabilă (journal entry) în aceeași tranzacție de BAZĂ de date.
Fiecare înregistrare trebuie să fie în echilibru. Baza de date însăși verifică acest lucru atunci când tranzacția este salvată.
Documentele emise și înregistrate nu pot fi șterse. O asociere greșită cu extrasul de bancă este corectată printr-o înregistrare de stornare, nu prin editarea celei vechi. Aceasta este semnificația unui registru imutabil (immutable ledger).

SDK-uri, MCP și webhook-uri

SDK-urile tipizate sunt generate din aceeași descriere OpenAPI pentru TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift și Rust. Până la publicarea unui SDK, îl puteți instala din depozitul său sursă. Consultați ghidul pentru SDK-uri.
Este disponibilă o colecție Postman care conține fiecare punct final (endpoint).
Serverul MCP permite unui asistent AI precum Claude Code să caute în API și să îl apeleze folosind cheia dvs. API. Fiecare apel este o cerere API obișnuită, cu aceleași permisiuni și limite.
Webhook-urile notifică aplicația dvs. atunci când se întâmplă ceva, de exemplu sale_invoice.issued sau sale_invoice.paid. Fiecare livrare este semnată cu o semnătură HMAC pentru a putea verifica dacă provine de la Nordlet. Livrările eșuate sunt reîncercate timp de aproximativ 24 de ore.

Testarea cu companii sandbox

Creați o companie cu isSandbox: true sau bifați căsuța sandbox atunci când configurați o companie în aplicație.
O companie sandbox funcționează ca una reală: aceleași module, același API.
Este marcată în mod clar ca date de test, iar o companie reală nu poate fi transformată în sandbox și nici invers.
Declarațiile și facturile electronice (e-invoices) ale unei companii sandbox sunt trimise către serviciile de test ale autorităților fiscale.
Utilizarea într-o companie sandbox este contorizată și facturată la fel ca utilizarea într-o companie reală.

Ghidul de inițiere descrie pas cu pas obținerea primei chei API, emiterea primei facturi și ciclul complet.

FAQ

Poate o singură aplicație să deservească mai multe companii?

Da. Fiecare cheie API aparține unei singure companii, așa că puteți crea câte o cheie pentru fiecare companie. Fiecare livrare prin webhook conține identificatorul companyId al companiei căreia îi aparține, astfel încât un singur receptor poate deservi mai multe companii.

Trebuie să construiesc singur declarațiile fiscale?

Nu. Nordlet generează declarațiile pe baza evidenței contabile. Pentru fiecare declarație, sistemul o trimite direct, generează un fișier pe care îl încărcați sau afișează valorile pe care trebuie să le introduceți, în funcție de țară. Tabelul de asistență pentru declarații prezintă toate cazurile posibile.