API développeurs
Vos logiciels lisent la comptabilité de Wazna
Une clé d’API, des appels en lecture, et vos données comptables arrivent dans votre ERP, votre tableau de bord ou votre outil de gestion. Sans ressaisie.
Écrire à info@wazna.tn
BASE=https://votre-adresse-wazna/api/public/v1
curl -X GET "$BASE/dossiers/{dossierId}/balance?date=2026-09-30" \
-H "Authorization: Bearer wzk_live_7Hq2…"
HTTP/1.1 200 OK
{
"date": "2026-09-30",
"exerciceId": "00000000-0000-4000-8000-000000000001",
"elements": [
{ "compte": "401", "libelleCompte": "Fournisseurs",
"debitMillimes": 12500000, "creditMillimes": 18750000,
"soldeMillimes": -6250000 },
{ "compte": "532", "libelleCompte": "Banques",
"debitMillimes": 48300000, "creditMillimes": 31120500,
"soldeMillimes": 17179500 }
],
"curseurSuivant": null
}Pourquoi l’API
Ce que vous gagnez
Plus de ressaisie
Vos outils lisent directement les écritures, la balance et les tiers. Fini l’export puis l’import à la main.
Des chiffres à jour
Vous lisez les écritures validées au moment de l’appel, pas un fichier envoyé la semaine dernière.
Le cabinet garde la main
L’administrateur du cabinet crée la clé, choisit les dossiers ouverts, et peut la révoquer à tout moment.
Comment ça marche
Trois étapes
- 1
L’administrateur crée la clé dans Wazna
Il choisit les dossiers et, s’il le souhaite, les adresses IP autorisées.
- 2
Vous appelez l’API en lecture
Des requêtes GET, avec la clé dans l’en-tête Authorization: Bearer.
- 3
Vos données arrivent dans votre outil
Des réponses JSON, montants en millimes, prêtes pour votre ERP ou votre tableau de bord.
Ressources
Ce que vous pouvez lire
Chemin de base :
https://votre-adresse-wazna/api/public/v1| Ressource | Chemin |
|---|---|
| Dossiers | GET /dossiers |
| Fiche du dossier | GET /dossiers/{dossierId} |
| Plan comptable | GET /dossiers/{dossierId}/plan-comptable |
| Écritures validées | GET /dossiers/{dossierId}/ecritures |
| Grand livre | GET /dossiers/{dossierId}/grand-livre |
| Balance à une date | GET /dossiers/{dossierId}/balance?date=… |
| Tiers | GET /dossiers/{dossierId}/tiers |
| Factures lues | GET /dossiers/{dossierId}/factures |
| Échéances fiscales | GET /dossiers/{dossierId}/echeances |
Exemple
La balance à une date, en un appel
BASE=https://votre-adresse-wazna/api/public/v1
curl -X GET "$BASE/dossiers/{dossierId}/balance?date=2026-09-30" \
-H "Authorization: Bearer wzk_live_7Hq2…"
HTTP/1.1 200 OK
{
"date": "2026-09-30",
"exerciceId": "00000000-0000-4000-8000-000000000001",
"elements": [
{ "compte": "401", "libelleCompte": "Fournisseurs",
"debitMillimes": 12500000, "creditMillimes": 18750000,
"soldeMillimes": -6250000 },
{ "compte": "532", "libelleCompte": "Banques",
"debitMillimes": 48300000, "creditMillimes": 31120500,
"soldeMillimes": 17179500 }
],
"curseurSuivant": null
}La clé passe dans l’en-tête, jamais dans l’adresse. Les montants sont des entiers en millimes de dinar : 1 190,000 TND s’écrit 1190000.
Sécurité
Une clé sous contrôle
Lecture seule
Seule la méthode GET existe. L’API ne crée, ne modifie et ne supprime rien.
Limitée
Une clé peut être réservée à certains dossiers et à certaines adresses IP.
Expirante et révocable
Elle expire au plus tard au bout d’un an et se révoque à tout moment.
Tracée
Chaque appel est journalisé.
Cloisonnée
Chaque cabinet ne voit que ses propres données.
Questions fréquentes
Questions fréquentes
Qui crée la clé d’API ?
L’administrateur du cabinet, dans Wazna. Il choisit ce que la clé peut lire et peut la révoquer à tout moment.
Peut-on écrire dans Wazna par l’API ?
Non. L’accès est en lecture seule : uniquement des requêtes GET.
Une clé voit-elle tous les dossiers ?
Seulement ceux que l’administrateur a ouverts. Une clé peut aussi être limitée à certaines adresses IP.
Combien de temps une clé est-elle valable ?
Au plus un an. Elle peut être révoquée avant, à tout moment.
Sous quel format arrivent les données ?
En JSON. Les montants sont des entiers en millimes de dinar et les dates au format AAAA-MM-JJ.