Organisation API — Aperçu
Organisation API s'adresse aux organisations abonnées à un plan DigiGO, SEAL Max ou Fatoora Trust qui veulent créer, valider, signer et suivre leurs propres factures TEIF de façon programmatique — depuis leur ERP, leur logiciel comptable ou un script interne.
Si vous êtes un intégrateur technique qui soumet des factures au nom d'autres organisations clientes, consultez plutôt la catégorie Partner API — un modèle d'autorisation différent (OTP, découverte d'organisations) qui ne s'applique pas ici.
La différence structurelle clé
Une clé API Organisation est définitivement liée à votre propre organisation dès sa création. Contrairement à Partner API, il n'y a :
- aucune étape de découverte d'organisation — pas de
GET /api/partner/authorized-orgsni de résolution de matricule, - aucun
org_idà transmettre — chaque requête agit automatiquement sur votre propre organisation, - aucune autorisation par OTP à obtenir — la clé, c'est déjà l'autorisation.
Cycle de vie
| Étape | Action | Où |
|---|---|---|
| 1 — Créer une clé | Générez un client_id/client_secret scopé à votre organisation | /app/api-keys |
| 2 — S'authentifier | Échangez vos identifiants contre un token Bearer (1h), sans org_id | Authentification |
| 3 — Soumettre | Envoyez une facture TEIF (JSON ou XML) — validée de façon synchrone | Factures |
| 4 — Signer et envoyer | Déclenchez la signature (SEAL ou DigiGO selon votre plan) et l'envoi à TTN | Signature et suivi |
| 5 — Suivre | Interrogez le job, listez vos factures, ou recevez des webhooks en temps réel | Signature et suivi |
Qui peut créer des clés API ?
Les rôles owner et admin de votre organisation, depuis Tableau de bord Fatoora → /app/api-keys. Chaque plan plafonne le nombre de clés simultanées (0 sur les paliers starter, davantage sur business/max, illimité sur certains). Cette même page propose un onglet « Utilisation de l'API » avec une version interactive et toujours à jour de ce guide, pré-remplie avec votre vrai client_id.
Étape suivante
Passez à Authentification et scopes pour obtenir votre premier token.