Logiciel de comptabilité doté d'une API

Chaque fonctionnalité de Nordlet est accessible via une API JSON unique, accompagnée de kits de développement (SDK), de webhooks, de réessais idempotents et d'un serveur MCP pour assistants IA.

Une API (interface de programmation d'applications) permet à deux programmes de communiquer entre eux. Une API comptable permet à votre propre logiciel de créer des factures, d'enregistrer des règlements et de consulter des états financiers sans qu'un opérateur n'ait à naviguer dans des écrans.

Nordlet est un logiciel de comptabilité dont l'API constitue le principal point d'accès. Tout ce que l'application Web réalise est accessible via cette même API JSON. Cette page s'adresse aux développeurs ainsi qu'aux décideurs qui choisissent les connexions de leur produit.

Ce que fait Nordlet

Une structure de requête unique. Chaque appel prend la forme POST /v1/{module}/{resource}/{action} avec un corps JSON, par exemple sales/invoices/create ou bank/transactions/match.
Des clés d'API dotées de périmètres. Chaque clé est rattachée à une entreprise et dispose de périmètres (scopes) tels que sales:read ou bank:write. Une clé dépourvue du périmètre requis se voit retourner une réponse 403.
Les montants exprimés en texte. Les montants sont des chaînes décimales comportant jusqu'à 4 décimales, jamais des nombres à virgule flottante, afin qu'aucun centime ne soit perdu lors des arrondis.
Un format d'erreur unique. Chaque erreur possède la même structure comprenant un code, un message et un identifiant de requête.
Des requêtes de listes standardisées. Tout appel de type list utilise les mêmes paramètres de pagination, de tri et de filtrage, et peut renvoyer des totaux.
De véritables règles comptables. Les écritures comptables doivent être équilibrées, la numérotation des pièces justificatives doit être continue, et une période comptable clôturée rejette toute nouvelle imputation avec une réponse 409. Chaque modification est consignée dans un journal d'audit.

Sécuriser les réessais grâce à l'idempotence

Un incident réseau peut survenir après le traitement de votre requête mais avant la réception de la réponse. Un nouvel essai risquerait alors de dupliquer la facture. L'idempotence (idempotency) garantit qu'une requête répétée produit le même effet que la première.

Transmettez un en-tête Idempotency-Key avec toute requête modifiant des données.
Un réessai muni de la même clé et du même corps de requête renvoie la réponse stockée, accompagnée de l'en-tête x-idempotent-replay: true.
L'utilisation d'une même clé avec un corps de requête différent est refusée.
Les clés sont conservées pendant 24 heures.

Webhooks

Un webhook est un message envoyé par Nordlet à votre serveur lorsqu'un événement se produit, tel que sale_invoice.paid.

Les événements sont enregistrés dans la même transaction de base de données que la modification, de sorte qu'aucun événement n'est émis en cas de annulation (rollback).
Chaque notification est signée via HMAC-SHA256 au moyen de votre secret d'abonnement, ce qui vous permet de vérifier qu'elle provient bien de Nordlet.
En cas d'échec de transmission, de nouveaux essais sont effectués pendant environ 24 heures. Vous pouvez également relancer l'envoi manuellement.
La gestion des abonnements s'effectue depuis la section Account → Webhooks ou via l'API.

Outils pour les développeurs

Documentation de l'API. Une documentation interactive de l'API générée à partir de la description OpenAPI, ainsi qu'une collection Postman.
Kits de développement (SDK). Des clients typés pour TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift et Rust, générés à partir de la même spécification. Consultez le guide des SDK.
Serveur MCP. Des assistants IA tels que Claude peuvent interroger et appeler l'API à l'aide de votre clé d'API. Consultez le guide du serveur MCP.
Entreprises de test (Sandbox). Une entreprise de test fonctionne comme une entité réelle, est identifiée comme telle, et transmet ses déclarations ainsi que ses factures électroniques exclusivement vers les environnements de test des administrations.
Limite de débit (Rate limit). 300 requêtes par minute et par clé d'API, avec des en-têtes indiquant le quota restant.

FAQ

Que puis-je réaliser via l'API ?

L'intégralité des fonctionnalités du produit : facturation, achats, grand livre, rapprochement bancaire, stocks, immobilisations, paie, états financiers et télédéclarations. Le guide de prise en main détaille un cycle complet, de la facture aux données de TVA.

Puis-je intégrer la comptabilité au sein de ma propre solution ?

Oui. Chaque entreprise configurée dans Nordlet dispose de sa propre comptabilité, que votre logiciel pilote via sa clé d'API. L'API ne propose aucune fonction permettant de modifier ou de supprimer une écriture comptable validée. Toute correction fait l'objet d'une nouvelle écriture, garantissant ainsi l'immuabilité du grand livre immuable.