Skip to main content

Votre organisation

Avant de soumettre votre première facture, il vous faut votre matricule fiscal — TEIF exige qu'il corresponde exactement à MessageSenderIdentifier dans le document soumis, sous peine d'un rejet 422 SENDER_MATRICULE_MISMATCH. Cet endpoint vous donne cette information, ainsi qu'un aperçu de votre plan, vos crédits de signature restants, et vos statistiques de facturation — le tout en un seul appel.

GET /api/v2/organization​

Nécessite le scope invoice:read (déjà inclus dans toute clé API existante — aucune régénération nécessaire).

curl -X GET "https://<base_url>/api/v2/organization" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Réponse 200 OK :

{
  "orgId": "5b1e2b7a-4c31-4e2a-9d9a-7b0f9e6a1234",
  "orgName": "Société ABC SARL",
  "taxIdentifier": "1234567ABCD000",
  "status": "active",
  "isTestAccount": false,
  "isSandboxAccount": false,
  "partnerStatus": null,
  "createdAt": "2026-01-10T09:12:00.000Z",
  "plan": {
    "slug": "digigo-business",
    "name": "DigiGO Business",
    "status": "active",
    "monthlyLimit": 500,
    "isUnlimited": false,
    "currentPeriodStart": "2026-07-01T00:00:00.000Z",
    "currentPeriodEnd": "2026-07-31T23:59:59.000Z",
    "trialEndsAt": null
  },
  "signatureCredits": {
    "remainingTotal": 32,
    "nearestExpiryAt": "2027-01-15T00:00:00.000Z"
  },
  "stats": {
    "totalCount": 128,
    "sentCount": 120,
    "errorCount": 3,
    "totalRevenue": 45210.50,
    "byMonth": [{ "month": "2026-07", "created": 12, "sent": 11, "errors": 0 }]
  },
  "apiKeyStats": {
    "organizationId": "5b1e2b7a-4c31-4e2a-9d9a-7b0f9e6a1234",
    "totalInvoices": 128,
    "stats": [{ "appId": "ak_live_xxx", "invoicesCreated": 128, "invoicesSigned": 120, "invoicesSubmittedToTtn": 118 }]
  }
}

taxIdentifier est votre matricule fiscal — utilisez-le tel quel comme MessageSenderIdentifier dans vos factures TEIF. Le guide dédié du workflow Bash le récupère automatiquement et vérifie également les fichiers JSON/XML fournis avant leur soumission.

stats et apiKeyStats reflètent exactement ce que renvoient GET /invoices/stats et GET /invoices/api-key-stats (voir Factures), simplement regroupés ici avec votre identité et votre plan. Si fatooraCore est temporairement indisponible, ces deux champs valent null — le reste de la réponse (identité, plan, crédits) reste fiable, car il provient uniquement de la base de données Fatoora.

Crédits de signature

signatureCredits.remainingTotal cumule vos crédits de pack de signature actifs et non expirés. Chaque sign-and-send en consomme un, en complément (ou à défaut) de votre quota d'abonnement mensuel — voir Signature et suivi TTN.

Étape suivante​

Passez à Soumettre et consulter des factures pour construire votre première facture TEIF avec le bon taxIdentifier.