Rattachement
Quand le matricule existe déjà sur fatoora.tn, vous n'ouvrez pas un second compte. Vous envoyez une demande. Le propriétaire l'accepte, la refuse ou l'arrête plus tard, dans l'onglet Rattachement de son organisation, avec un code reçu par e-mail.
Le partenaire n'appelle pas l'envoi du code, la connexion du propriétaire, ni la confirmation. Ces étapes n'existent que dans le compte du propriétaire.
Envoyer une demande
POST /api/partner/link-requests
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
{ "sourceOrganizationId": "UUID_DU_COMPTE_EXISTANT" }
La demande est créée au statut pending.
Lister et filtrer
GET /api/partner/link-requests
GET /api/partner/link-requests?status=pending
status | Sens |
|---|---|
pending | En cours. Inclut aussi otp_sent. |
expired | Sans réponse depuis plus de 7 jours. Ce n'est pas une valeur stockée : elle est calculée. |
cancelled | Annulée par le partenaire. |
rejected | Refusée par le propriétaire. |
approved | Acceptée. La société apparaît dans la liste. |
revoked | Rattachement arrêté par le propriétaire. |
Sans status, toutes les demandes sont renvoyées.
Annuler une demande en cours
POST /api/partner/link-requests/{id}/cancel
Uniquement tant que la demande est ouverte et non expirée. Une demande expirée, refusée ou déjà acceptée ne s'annule pas (REQUEST_EXPIRED).
Côté propriétaire
Dans Organisation → Rattachement, le propriétaire :
- accepte — un code est envoyé à son e-mail, il le confirme sur le même onglet ;
- refuse ;
- une fois rattaché, arrête le rattachement — là aussi avec un code e-mail.
Après acceptation, la société est gérée comme les autres : sceau, TTN, puis facturation via Partner API.