Asynchronisme et statuts

Certaines opérations myBCS sont asynchrones.

Le piège le plus fréquent consiste à considérer le succès de la requête initiale comme le résultat final.

Que signifie 202 Accepted ?

Un 202 signifie :

la demande a été acceptée pour traitement.

Il ne signifie pas :

le traitement métier complet a réussi.

Après un 202, utilisez le mécanisme de suivi prévu par l'API.

Flow Service

Après un dépôt :

POST /v1/flows
     ↓
202 Accepted
     ↓
flowId
     ↓
traitement asynchrone
     ↓
recherche / récupération du flux
     ↓
acknowledgement technique
     ↓
événements métier éventuels

Conservez le flowId retourné.

Statut technique ≠ statut métier

Le statut d'acquittement reflète le traitement technique du flux.

Le cycle de vie de la facture est porté par des événements métier distincts.

Ainsi :

acknowledgement.status = Ok

ne signifie pas nécessairement :

facture approuvée

ou :

facture payée

➡️ Comprendre le cycle de vie et les statuts

Polling Flow Service

Lorsque votre intégration repose sur du polling :

• utilisez les mécanismes de recherche différentielle prévus par le contrat ;
• exploitez updatedAfter lorsqu'il est disponible et applicable ;
• stockez votre dernier point de reprise ;
• évitez de recharger en permanence tout l'historique ;
• gérez la pagination et les limites de résultats.

Onboarding

L'onboarding doit également être suivi par son état.

Conservez :

• legalUnitId ;
• onboardingRequestId lorsqu'il est retourné ;
• l'état courant ;
• les informations nécessaires pour reprendre ou redémarrer le parcours.

➡️ État et historique de l'onboarding

Si un statut semble manquer

Avant de conclure à une perte :

1. recherchez le flux par les critères disponibles ;
2. vérifiez la fenêtre temporelle de recherche ;
3. vérifiez le tenant et Organization-Id ;
4. vérifiez la pagination ;
5. vérifiez si le flux est technique, facture ou cycle de vie ;
6. récupérez les métadonnées du flowId concerné ;
7. collectez les identifiants de corrélation avant escalade.