États et modes des enregistrements

⚠️Warning

Vous consultez la documentation pour la version API 2025-08-12. La dernière version est 2026-06-01. Les principaux changements incluent la 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 contrôles de validation internes. Les détails sont disponibles dans les messages de log.
• 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 si la validation réussit.
• POST → Rejected : Si l’enregistrement échoue à la validation interne lors de la création, il passe automatiquement à l’état Rejected, fournissant des messages de log 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 log 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é, quel que soit le résultat (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.