Nordlet per sviluppatori di applicazioni

Integra fatturazione, contabilità e dichiarazioni fiscali nell'Unione Europea nel tuo software tramite una singola API JSON, SDK tipizzati, webhook, un server MCP e aziende di sandbox.

Molte applicazioni generano eventi finanziari: il pagamento di un ordine, il rinnovo di un abbonamento, l'emissione di un rimborso. Ognuno di questi eventi deve trovare riscontro nella contabilità aziendale.

Nordlet è un software di contabilità progettato nativamente tramite API (API-first). Tutte le funzionalità dell'applicazione web sono accessibili anche attraverso una singola API JSON. La tua applicazione invia gli eventi e Nordlet gestisce la contabilità e prepara le dichiarazioni fiscali.

Cosa fa Nordlet

Espone ogni azione come POST /v1/{module}/{resource}/{action} con un corpo JSON, ad esempio /v1/sales/invoices/create.
Autentica ogni richiesta tramite una chiave API associata a una singola specifica azienda. Ciascuna chiave dispone di permessi specifici (scopes), come sales:read o sales:write, che ne limitano il raggio d'azione.
Accetta gli importi come stringhe decimali e mai come numeri in virgola mobile, evitando così la perdita di centesimi dovuta agli arrotondamenti.
Accetta un'intestazione Idempotency-Key per ogni operazione di modifica. Un nuovo tentativo con la stessa chiave restituisce la prima risposta senza rieseguire l'operazione. L'idempotenza garantisce che una richiesta ripetuta produca lo stesso effetto di una richiesta singola.
Restituisce tutti gli errori in un formato unificato condiviso.
Consente fino a 300 richieste al minuto per chiave API.
Registra qualsiasi modifica all'interno di un registro di audit (audit log).

La guida alle convenzioni delle API descrive ciascuna di queste regole in dettaglio.

Registri contabili sempre corretti

L'emissione di una fattura assegna un numero progressivo senza interruzioni, verifica che il periodo contabile sia aperto e registra la scrittura contabile all'interno della stessa transazione di database.
Ogni registrazione deve essere sempre bilanciata. È il database stesso a verificare questa condizione al momento del salvataggio della transazione.
I documenti emessi e registrati non possono essere eliminati. Una riconciliazione bancaria errata viene stornata mediante una scrittura di storno, anziché modificando il documento originario. Questo è il principio fondamentale di un mastrino immutabile.

SDK, MCP e webhook

Vengono generati SDK tipizzati basati sulla stessa descrizione OpenAPI per TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift e Rust. Fino alla pubblicazione ufficiale di un SDK, è possibile installarlo direttamente dal relativo repository sorgente. Si veda la guida agli SDK.
È disponibile una collezione Postman contenente tutti gli endpoint.
Il server MCP consente a un assistente IA come Claude Code di effettuare ricerche nell'API e di inviare chiamate utilizzando la tua chiave API. Ciascuna chiamata costituisce una normale richiesta API soggetta agli stessi permessi e limiti.
I webhook notificano alla tua applicazione il verificarsi di eventi specifici, quali sale_invoice.issued o sale_invoice.paid. Ciascun invio è firmato digitalmente tramite una firma HMAC, consentendoti di verificare che provenga effettivamente da Nordlet. Gli invii non riusciti vengono ripetuti per circa 24 ore.

Test tramite aziende di sandbox

Crea un'azienda impostando isSandbox: true, oppure seleziona l'opzione di sandbox durante la configurazione di un'azienda nell'applicazione.
Un'azienda di sandbox funziona esattamente come un'azienda reale: stessi moduli e stesse API.
Viene chiaramente contrassegnata come dato di prova e non è possibile convertire un'azienda reale in una di sandbox né viceversa.
Le dichiarazioni e le fatture elettroniche di un'azienda di sandbox vengono inviate ai servizi di test delle amministrazioni competenti.
L'utilizzo all'interno di un'azienda di sandbox viene misurato e fatturato esattamente come per un'azienda reale.

La guida introduttiva illustra passo dopo passo la creazione della prima chiave API, dell'emissione della prima fattura e dell'intero ciclo operativo.

FAQ

Un'applicazione può gestire più aziende?

Sì. Ciascuna chiave API appartiene a una singola azienda, pertanto è necessario generare una chiave distinta per ciascuna di esse. Ogni invio tramite webhook include il parametro companyId dell'azienda di pertinenza, permettendo a un unico endpoint di ricezione di servire più aziende.

Devo sviluppare autonomamente la generazione delle dichiarazioni fiscali?

No. Nordlet genera le dichiarazioni direttamente dai dati contabili. A seconda del paese, provvede all'invio diretto della dichiarazione, genera un file pronto per il caricamento oppure mostra i dati da inserire manualmente. La tabella di supporto per le dichiarazioni elenca i dettagli per ciascuna giurisdizione.