L'organisation cliente

Une fois un token org-scoped obtenu (voir Authentification et scopes), cet endpoint retourne uniquement l'identité générale de l'organisation cliente représentée par le token. Le taxIdentifier doit être utilisé comme MessageSenderIdentifier dans les factures TEIF soumises en son nom.

GET /api/core-proxy/organization

Nécessite le scope invoice:read et un token limité à une organisation ayant autorisé votre application.

curl "https://<base_url>/api/core-proxy/organization" \
  -H "Authorization: Bearer ORG_SCOPED_TOKEN"

Réponse 200 OK :

{
  "orgId": "5b1e2b7a-4c31-4e2a-9d9a-7b0f9e6a1234",
  "orgName": "Société ABC SARL",
  "taxIdentifier": "1234567ABCD000"
}

La réponse est volontairement limitée à ces trois champs. Le plan, l'abonnement, les crédits, les statistiques, les clés API et les indicateurs internes de l'organisation restent privés.

GET /api/partner/authorized-orgs, appelé avec un token app-only, permet d'abord de découvrir les organisations ayant autorisé votre application. Demandez ensuite un token org-scoped avec le org_id choisi avant d'appeler cet endpoint ou de soumettre une facture.

Script complet

Le guide dédié du workflow Bash récupère automatiquement ce matricule. S'il existe plusieurs organisations autorisées, indiquez --org-id, --org-tax-id ou utilisez --interactive; le script refuse toute sélection implicite.

Étape suivante

Passez à Soumettre et consulter des factures pour construire une facture avec le bon taxIdentifier.