États et Modes des Enregistrements

⚠️Warning

Vous consultez la documentation de la version API 2024-10-31. La version la plus récente est 2026-06-01. Les principaux changements incluent une terminologie mise à jour (Asset → Organization, Entity → Taxpayer/Location).

Cette section décrit le cycle de vie d’un Record — les valeurs possibles de state et mode et les transitions entre elles, toutes déclenchées automatiquement par le système.

États

• Accepted : Le Record a été reçu et a passé la validation initiale, mais aucun résultat final n’a encore été persisté. Il s’agit d’un état temporaire.
• Rejected : L’enregistrement a été reçu mais n’a pas passé nos vérifications de validation internes. Les détails sont disponibles dans les messages de journal.
• Completed : Le Record a été soumis avec succès à l’Administration fiscale et accepté par celle-ci. Il s’agit d’un état final.
• Failed : Une erreur s’est produite lors du traitement. Le Record n’a pas passé les contrôles de validation de l’Administration fiscale, ou une erreur a empêché notre système de confirmer le résultat de la transmission. Les détails sont disponibles dans les messages de journal. Il s’agit d’un état final.

Modes

• Processing : Le Record est en cours de traitement. L’état correspondant est Accepted.
• Finished : Le Record a été traité, avec un résultat réussi ou non. L’état correspondant est Rejected, Completed ou Failed.

Transitions d’État

• POST → Accepted : L’enregistrement est créé via un appel API et entre temporairement dans l’état Accepted s’il est validé avec succès.
• POST → Rejected : Si l’enregistrement échoue à la validation interne lors de la création, il passe automatiquement à l’état Rejected, fournissant des messages de journal supplémentaires sur l’erreur.
• Accepted → Completed : Cette transition se produit automatiquement une fois que l’enregistrement a été traité avec succès.
• Accepted → Failed : Si une erreur se produit pendant le traitement, l’enregistrement passe automatiquement à l’état Failed, fournissant des messages de journal supplémentaires pour le débogage.

⚠️Important

L’état final d’un enregistrement TRANSACTION est retourné directement dans la réponse synchrone POST — aucun polling ni webhook n’est requis.

Transitions de Mode

• Processing → Finished : Une fois que l’enregistrement a été traité, que le résultat soit réussi ou non, il passe automatiquement au mode Finished.

📘Remarque

Processing est le mode par défaut de chaque INTENTION à sa création. Une fois que l’INTENTION est référencée dans une TRANSACTION, elle prend l’état et le mode de cette TRANSACTION.

Pour les enregistrements TRANSACTION, Processing est normalement temporaire et devrait se résoudre en mode Finished en quelques secondes. Si une TRANSACTION reste en mode Processing pendant plus de quelques minutes, considérez-le comme une transition bloquée et contactez-nous avec l’ID du Record afin que nous puissions investiguer.