Fatoora Connect — Aperçu
Fatoora Connect est l'offre partenaire cloud. Vous gérez un portefeuille de sociétés, chacune avec son propre sceau serveur et ses identifiants TTN, et vous facturez sur le quota de votre abonnement.
Cette catégorie s'adresse aux intégrateurs d'un plan partner-connect-starter, partner-connect-business ou partner-connect-max. La facturation, la signature et l'envoi TTN utilisent la même API que Partner API.
Les acteurs
- Vous (le partenaire Connect) — votre organisation fatoora.tn. Elle crée des sociétés filles ou rattache un compte déjà existant.
- La société cliente — une organisation à part, avec son matricule fiscal, son sceau et ses identifiants TTN.
- Le propriétaire d'un compte fatoora.tn — s'il existe déjà, c'est lui qui accepte ou refuse le rattachement, depuis son propre compte.
- TTN — seul Fatoora communique avec l'administration. Chaque facture émise est décomptée du solde de l'abonnement Connect.
Deux façons d'ajouter une société
| Situation | Action |
|---|---|
| Le matricule n'existe pas encore | Créer la société |
| Le matricule appartient déjà à un compte fatoora.tn | Demander le rattachement |
| Le matricule appartient à un autre Connect, à un Cabinet, ou à un compte partenaire | Ni création ni rattachement (NOT_LINKABLE) |
Votre propre facturation
L'organisation Connect elle-même peut créer, signer et envoyer les factures de son matricule depuis l'interface : éditeur, sceau, clés API et historique des jobs. Cet espace est distinct de la gestion des sociétés clientes. L'identifiant partenaire (clientId) sert aux sociétés clientes ; les clés API de l'organisation servent à votre propre matricule.
Authentification
La gestion des sociétés (liste, création, sceau, TTN, rattachement) utilise la session du gérant Connect : POST /api/auth/login, puis Authorization: Bearer. Seuls le propriétaire et les gestionnaires peuvent appeler ces routes.
La facturation au nom d'une société cliente utilise OAuth2 Client Credentials, comme Partner API. Obtenez un token org-scoped avec le clientId partenaire et l'org_id de la société, puis suivez Factures et Signature et suivi.
Plans
| Plan | Sociétés | Factures TTN / mois |
|---|---|---|
partner-connect-starter | 10 | 500 |
partner-connect-business | 50 | 5 000 |
partner-connect-max | Illimité | Illimité |
Pendant l'essai, le plafond documentaire du partenaire s'applique comme pour les autres plans partenaires.