Fatoora Connect — Overview
Fatoora Connect is the cloud partner offer. You manage a portfolio of companies, each with its own server seal and TTN credentials, and you invoice against your subscription quota.
This category is for integrators on partner-connect-starter, partner-connect-business, or partner-connect-max. Invoicing, signing, and TTN submission use the same API as Partner API.
Actors
- You (the Connect partner) — your fatoora.tn organization. It creates child companies or links an existing account.
- The client company — a separate organization, with its tax ID, seal, and TTN credentials.
- The owner of an existing fatoora.tn account — they accept or reject the link from their own account.
- TTN — only Fatoora talks to the tax authority. Every invoice you issue is deducted from the Connect subscription balance.
Two ways to add a company
| Situation | Action |
|---|---|
| The tax ID does not exist yet | Create the company |
| The tax ID already belongs to a fatoora.tn account | Request a link |
| The tax ID belongs to another Connect, a Cabinet, or a partner account | Neither create nor link (NOT_LINKABLE) |
Your own invoices
The Connect organization can create, sign, and send invoices for its own tax ID from the interface: editor, seal, API keys, and job history. That space is separate from client-company management. The partner clientId is for client companies; organization API keys are for your own tax ID.
Authentication
Company management (list, create, seal, TTN, link) uses the Connect manager session: POST /api/auth/login, then Authorization: Bearer. Only the owner and managers can call these routes.
Invoicing on behalf of a client company uses OAuth2 Client Credentials, as in Partner API. Get an org-scoped token with the partner clientId and the company org_id, then follow Invoices and Signing and tracking.
Plans
| Plan | Companies | TTN invoices / month |
|---|---|---|
partner-connect-starter | 10 | 500 |
partner-connect-business | 50 | 5,000 |
partner-connect-max | Unlimited | Unlimited |