Nordlet pour les développeurs d'applications

Ajoutez la facturation, la tenue de comptabilité et les déclarations fiscales dans l'UE à votre logiciel grâce à une API JSON unique, des SDK typés, des webhooks, un serveur MCP et des sociétés bac à sable.

De nombreuses applications génèrent des flux financiers: une commande est réglée, un abonnement est renouvelé, un remboursement est émis. Chacun de ces événements doit être comptabilisé dans les livres d'une entreprise.

Nordlet est un logiciel de comptabilité conçu selon l'approche API-first. Toutes les fonctionnalités de l'application web sont également accessibles via une API JSON unique. Votre application transmet les événements, tandis que Nordlet tient la comptabilité et prépare les déclarations fiscales.

Ce que fait Nordlet

Expose chaque action sous la forme POST /v1/{module}/{resource}/{action} avec un corps JSON, par exemple /v1/sales/invoices/create.
Authentifie chaque requête à l'aide d'une clé d'API rattachée à une seule entreprise. Chaque clé dispose de périmètres d'accès (scopes), tels que sales:read ou sales:write, qui limitent ses actions autorisées.
Traite les montants sous forme de chaînes de caractères décimales, jamais en nombres à virgule flottante, afin qu'aucun centime ne soit perdu lors des arrondis.
Accepte un en-tête Idempotency-Key sur chaque modification. Une nouvelle tentative avec la même clé renvoie le premier résultat au lieu d'exécuter l'opération une seconde fois. L'idempotence (idempotency) garantit qu'une requête répétée produit le même effet qu'une seule requête.
Renvoie toutes les erreurs selon un format unique partagé.
Autorise 300 requêtes par minute et par clé d'API.
Enregistre chaque modification dans un journal d'audit (audit log).

Le guide des conventions d'API détaille chacune de ces règles.

Une comptabilité toujours exacte

L'émission d'une facture attribue un numéro séquentiel sans rupture, vérifie que la période comptable (accounting period) est ouverte et comptabilise l'écriture dans le journal (journal entry) lors de la même transaction de base de données.
Chaque écriture doit être équilibrée. La base de données elle-même effectue cette vérification lors de l'enregistrement de la transaction.
Les documents émis et enregistrés ne peuvent pas être supprimés. Une affectation bancaire erronée est corrigée par une écriture de contrepassation, et non en modifiant l'ancienne. C'est ce qui caractérise un grand livre immuable (immutable ledger).

SDK, MCP et webhooks

Des SDK typés sont générés à partir de la même spécification OpenAPI pour TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift et Rust. En attendant qu'un SDK soit publié, vous pouvez l'installer depuis son dépôt source. Consultez le guide des SDK.
Une collection Postman contenant l'ensemble des points de terminaison est disponible.
Le serveur MCP permet à un assistant IA tel que Claude Code d'interroger l'API et de l'appeler avec votre clé d'API. Chaque appel constitue une requête API classique soumise aux mêmes périmètres et limites.
Les webhooks informent votre application lorsqu'un événement se produit, par exemple sale_invoice.issued ou sale_invoice.paid. Chaque envoi est sécurisé par une signature HMAC afin de vous permettre de vérifier qu'il provient bien de Nordlet. Les envois infructueux sont réitérés pendant environ 24 heures.

Tests avec des sociétés bac à sable

Créez une entreprise avec isSandbox: true, ou cochez la case bac à sable lors de la configuration d'une entreprise dans l'application.
Une société bac à sable fonctionne exactement comme une vraie entreprise, avec les mêmes modules et la même API.
Elle est clairement identifiée comme des données de test, et il est impossible de convertir une vraie entreprise en bac à sable ou inversement.
Les déclarations et les factures électroniques (e-invoice) d'une société bac à sable sont acheminées vers les services de test des administrations.
L'utilisation d'une société bac à sable fait l'objet d'un suivi et d'une tarification identiques à ceux d'une vraie entreprise.

Le guide de prise en main vous guide pas à pas pour créer votre première clé d'API, émettre votre première facture et suivre l'ensemble du cycle.

FAQ

Une seule application peut-elle gérer plusieurs entreprises?

Oui. Chaque clé d'API étant rattachée à une seule entreprise, vous créez une clé par entreprise. Chaque notification de webhook inclut l'identifiant companyId de l'entreprise concernée, ce qui permet à un récepteur unique de servir plusieurs entreprises.

Dois-je développer moi-même les déclarations fiscales?

Non. Nordlet génère les déclarations à partir de la comptabilité. Selon le pays, Nordlet transmet directement la déclaration, produit un fichier prêt à être téléchargé ou affiche les montants à saisir. Le tableau de support des déclarations répertorie tous les cas de figure.