Aller au contenu principal

Démarrer en Sandbox

Cette page est le point de départ recommandé pour une première intégration avec eas'Invoice PA.

L'objectif n'est pas de remplacer les guides API ou le Swagger, mais de vous conduire jusqu'à un premier parcours complet :

obtenir les accès → onboarder une entreprise → vérifier son adressage → déposer une facture → suivre son traitement.

Choisissez votre point de départ​

Étape 1 — Vérifier vos accès​

Vous êtes partenaire​

Vous devez disposer des credentials permettant d'appeler les Partner APIs.

Le parcours standard est alors :

  1. obtenir un token OAuth2 partenaire ;
  2. créer le tenant ;
  3. lancer son provisioning ;
  4. récupérer l'accès à la Tenant Public API ;
  5. générer ou faire tourner le secret associé.

➡️ Guide Partner APIs
➡️ Swagger Partner APIs — SANDBOX
➡️ Collection Postman bcs-partner-api

Vous êtes client ou intégrateur​

Votre tenant et vos credentials Tenant Public API doivent déjà avoir été mis à disposition.

Vous commencez directement par l'obtention d'un token OAuth2 puis par les opérations sur la Tenant Public API.

➡️ Démarrer avec la Tenant Public API
➡️ Swagger Tenant Public API — SANDBOX

Étape 2 — Obtenir un token OAuth2​

Les intégrations serveur-à-serveur utilisent le grant OAuth2 client_credentials.

Le principe est le même pour les APIs protégées :

client_id + client_secret
        ↓
Auth Server
        ↓
access_token
        ↓
Authorization: Bearer <access_token>

Conservez le client_secret dans un coffre de secrets et ne journalisez jamais le token complet.

➡️ Authentification et headers

Étape 3 — Créer et onboarder l'unité légale​

Dans la Tenant Public API, l'entreprise à onboarder est représentée par une unité légale.

Le parcours type est :

POST /v1/onboarding/legal-units
        ↓
legalUnitId
        ↓
POST /v1/onboarding/legal-units/{legalUnitId}/start
        ↓
GET /v1/onboarding/legal-units/{legalUnitId}/state
        ↓
état exploitable / parcours terminé

Le legalUnitId retourné par la plateforme doit être conservé. Un SIREN ou un SIRET ne le remplace pas dans les routes d'onboarding.

➡️ Créer une unité légale
➡️ Piloter l'onboarding
➡️ État et historique
➡️ Collection Postman bcs-tenant-public-api — folder Onboarding and Legal Units

Étape 4 — Vérifier le destinataire dans l'annuaire​

Avant l'émission d'une facture, utilisez le Directory Service lorsque vous devez déterminer ou vérifier l'adressage du destinataire.

Le parcours habituel consiste à vérifier :

  1. l'entreprise ou l'établissement à partir du SIREN / SIRET ;
  2. le code de routage lorsqu'il existe ;
  3. la ligne d'annuaire ;
  4. le statut de la ligne avant dépôt.

➡️ Guide Directory Service
➡️ Collection Postman bcs-tenant-public-api — folder Directory service (AFNOR)

Étape 5 — Déposer votre première facture​

Le dépôt s'effectue via le Flow Service :

POST /v1/flows

La facture peut être fournie dans une syntaxe supportée par le contrat de l'environnement, notamment Factur-X, UBL ou CII.

Une réponse 202 Accepted signifie que le dépôt a été accepté pour traitement. Elle ne signifie pas que tous les contrôles techniques et métier ultérieurs sont terminés.

➡️ Déposer, rechercher et récupérer un flux
➡️ Typologie des flux
➡️ Collection Postman bcs-tenant-public-api — folder Flow service (AFNOR)

Étape 6 — Suivre le résultat​

Après le dépôt, conservez au minimum les identifiants de corrélation retournés ou utilisés par votre intégration, en particulier le flowId.

Le suivi doit distinguer :

  • le résultat technique du flux : réception, contrôles, acquittement ;
  • le statut métier de la facture : événements de cycle de vie échangés séparément.

Un acquittement technique positif ne signifie donc pas que la facture a atteint son statut métier final.

➡️ Acquittements et erreurs
➡️ Factures et cycle de vie
➡️ Publier un statut CDAR
➡️ Exemples fonctionnels des neuf statuts CDAR
➡️ Comprendre le cycle de vie et les statuts

Critères de réussite de votre premier parcours​

Votre premier test SANDBOX peut être considéré comme complet lorsque vous êtes capable de :

  • obtenir et renouveler un token OAuth2 ;
  • appeler l'API avec le bon contexte d'organisation ;
  • créer et suivre une unité légale ;
  • terminer ou suivre son onboarding ;
  • vérifier un destinataire via Directory Service ;
  • déposer une facture ;
  • retrouver le flux déposé ;
  • récupérer ses métadonnées ou documents disponibles ;
  • distinguer acquittement technique et statut métier ;
  • tracer les identifiants nécessaires au support.
En cas de problème

Commencez par le Guide de dépannage API avant d'escalader un incident.

Ressources directes​