Software di contabilità con un'API

Ogni parte di Nordlet è disponibile tramite un'unica API JSON, con SDK, webhook, tentativi idempotenti e un server MCP per assistenti IA.

Un'API (interfaccia di programmazione delle applicazioni) è lo strumento che consente a un programma di comunicare con un altro. Un'API di contabilità permette al vostro software di creare fatture, registrare pagamenti e leggere report senza che un utente debba cliccare tra varie schermate.

Nordlet è un software di contabilità in cui l'API costituisce il principale canale di accesso. Tutto ciò che l'applicazione web compie è disponibile tramite la stessa API JSON. Questa pagina è rivolta agli sviluppatori e a chi decide a quale prodotto connettere il proprio sistema.

Cosa fa Nordlet

Una struttura di richiesta univoca. Ogni chiamata è del tipo POST /v1/{module}/{resource}/{action} con un corpo JSON, ad esempio sales/invoices/create o bank/transactions/match.
Chiavi API con permessi (scopes). Ciascuna chiave appartiene a una singola azienda e dispone di permessi specifici come sales:read o bank:write. Una chiave priva del permesso necessario riceve una risposta 403.
Importi come testo. Gli importi sono stringhe decimali con un massimo di 4 cifre decimali, mai numeri in virgola mobile, evitando così la perdita di centesimi dovuta agli arrotondamenti.
Un formato di errore unico. Ogni errore presenta lo stesso formato con un codice, un messaggio e un ID di richiesta.
Interrogazioni di elenco condivise. Ogni chiamata di tipo list accetta i medesimi campi di paginazione, ordinamento e filtro, e può restituire i totali.
Requisiti contabili rigorosi. Le registrazioni contabili devono essere bilanciate, i numeri dei documenti non devono presentare salti e un'periodo contabile bloccato rifiuta le nuove registrazioni restituendo una risposta 409. Ogni modifica viene tracciata in un registro di audit (audit log).

Tentativi sicuri con l'idempotenza

Una rete può subire interruzioni dopo che la richiesta è stata elaborata ma prima che voi riceviate la risposta. In tal caso, un nuovo tentativo (retry) potrebbe generare la stessa fattura due volte. L'idempotenza garantisce che una richiesta ripetuta produca lo stesso effetto della prima.

Inviate un'intestazione Idempotency-Key in qualsiasi chiamata che modifichi i dati.
Un nuovo tentativo con la stessa chiave e lo stesso corpo della richiesta restituisce la risposta memorizzata, accompagnata dall'intestazione x-idempotent-replay: true.
La stessa chiave associata a un corpo differente viene rifiutata.
Le chiavi vengono conservate per 24 ore.

Webhook

Un webhook è un messaggio che Nordlet invia al vostro server quando si verifica un evento, ad esempio sale_invoice.paid.

Gli eventi vengono scritti nella stessa transazione di database della modifica, pertanto una modifica soggetta a rollback non genera alcun evento.
Ogni invio è firmato tramite HMAC-SHA256 utilizzando il segreto di sottoscrizione, permettendovi di verificare che provenga effettivamente da Nordlet.
Per un invio non riuscito vengono effettuati nuovi tentativi per circa 24 ore. Potete inoltre reinviarlo manualmente.
Le sottoscrizioni sono gestibili alla voce Account → Webhooks oppure tramite l'API.

Strumenti per gli sviluppatori

Documentazione API (API reference). Una documentazione API interattiva generata dalla specifica OpenAPI, oltre a una collection di Postman.
SDK. Client tipizzati per TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift e Rust, generati a partire dalla stessa specifica. Consultate la guida agli SDK.
Server MCP. Gli assistenti IA come Claude possono effettuare ricerche e chiamare l'API utilizzando la vostra chiave API. Consultate la guida al server MCP.
Aziende di sandbox. Un'azienda di prova funziona come una reale, è contrassegnata come dato di test e invia dichiarazioni e fatture elettroniche esclusivamente agli endpoint di test delle amministrazioni.
Limiti di frequenza (rate limit). 300 richieste al minuto per ciascuna chiave API, con intestazioni che indicano la quota residua.

FAQ

Cosa posso fare tramite l'API?

Qualsiasi operazione disponibile nel prodotto: fatturazione, acquisti, libro mastro (general ledger), riconciliazione bancaria, magazzino, beni, stipendi, report e dichiarazioni per l'amministrazione finanziaria. La guida introduttiva illustra un intero ciclo, dalla fattura ai dati IVA.

Posso integrare la contabilità all'interno del mio prodotto?

Sì. Ogni azienda in Nordlet gestisce la propria contabilità e il vostro software vi accede tramite la relativa chiave API. L'API non include chiamate per modificare o eliminare una registrazione contabile già contabilizzata. Eventuali correzioni richiedono una nuova registrazione, preservando così l'immutabilità del libro mastro.