États et Modes d'Entity et System

⚠️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 fournit un aperçu du state et du mode qui définissent le cycle de vie et le comportement opérationnel des ressources Entities et Systems. Le diagramme ci-dessous illustre les transitions entre ces états et modes, détaillant comment la ressource évolue de la création à la mise hors service et comment ses modes opérationnels s’adaptent en fonction des événements internes ou des appels API externes.

Comprendre ces transitions est essentiel pour gérer efficacement les ressources, assurer des opérations fluides et résoudre des problèmes tels que des identifiants non valides ou des pauses temporaires.

États

• Acquired : État initial de la ressource lors de sa création. Aucune opération ne peut être effectuée dans cet état.
• Commissioned : La ressource est prête et entièrement opérationnelle (à condition que le mode soit opératif).
• Decommissioned : La ressource n’est plus opérationnelle et ne peut effectuer aucune tâche.

Modes

• Inactive : Mode initial de la ressource lors de sa création. Les opérations ne peuvent pas être effectuées dans ce mode.
• Operative : La ressource est entièrement fonctionnelle et fonctionne comme prévu.
• Suspended : La ressource est temporairement suspendue via un appel API (PATCH) — par ex. pour mettre à jour les identifiants Fisconline ou d’autres informations de ressource. Une fois la mise à jour terminée, la ressource peut être remise en mode Operative.
• Degraded (pas encore disponible en LIVE dans cette version) : La ressource est opérationnelle mais temporairement indisponible — par ex. en raison d’erreurs d’identifiants Fisconline. En TEST, ce mode peut être déclenché manuellement en envoyant le record TRANSACTION avec le header X-Taxpayer-Credentials-Expired: true pour préparer votre intégration avant la mise en production. Pour en savoir plus, consultez l’article dédié : Qu’est-ce que le mode DEGRADED et comment intervenir ?

📘Note

Chaque transition est déclenchée soit par un appel API externe, soit se produit automatiquement en fonction de la logique système interne :

• PATCH indique qu’un appel API externe est requis pour initier la transition.
• INTERNAL indique que la transition est déclenchée automatiquement au sein du système.

Les flèches bidirectionnelles indiquent que la transition peut se produire dans les deux sens — par exemple, un appel PATCH peut déplacer le mode de la ressource de OPERATIVE → SUSPENDED ou de SUSPENDED → OPERATIVE.

Transitions d’État

• Acquired → Commissioned : Nécessite un appel API (PATCH) pour activer la ressource. En cas de succès, le mode correspondant passe automatiquement de Inactive à Operative.
• Commissioned → Decommissioned : Nécessite un appel API (PATCH) pour marquer la ressource comme n’étant plus en usage. En cas de succès, le mode correspondant passe de Operative à Inactive, marquant la fin du cycle de vie de la ressource.

⚠️Avertissement de facturation

La mise en service d’un Système dans l’environnement LIVE marque le début de la facturation et déclenche la transmission de factures officielles aux autorités fiscales. Aucune facturation ni transmission réelle n’a lieu dans l’environnement TEST.

Transitions de Mode

• Inactive → Operative : Transition automatique lorsque l’état est mis à jour avec succès à Commissioned via un appel API (PATCH).
• Operative → Suspended : Déclenchée via un appel API (PATCH) — par ex. pour suspendre temporairement les opérations lors de la mise à jour des identifiants Fisconline ou d’autres informations de ressource.
• Operative → Degraded (pas encore disponible en LIVE dans cette version) : Transition automatique — par ex. en raison d’erreurs persistantes d’identifiants Fisconline. En TEST, cette transition peut être déclenchée manuellement en envoyant le record TRANSACTION avec le header X-Taxpayer-Credentials-Expired: true pour préparer votre intégration avant la mise en production. Pour en savoir plus, consultez l’article dédié : Qu’est-ce que le mode DEGRADED et comment intervenir ?
• Degraded → Suspended (pas encore disponible en LIVE dans cette version) : Doit être déclenchée manuellement via un appel API (PATCH) pour corriger les erreurs persistantes d’identifiants Fisconline avant de restaurer le Taxpayer en mode Operative. Pour en savoir plus, consultez l’article dédié : Qu’est-ce que le mode DEGRADED et comment intervenir ?
• Suspended → Operative : Déclenchée via un appel API (PATCH) une fois les mises à jour nécessaires effectuées — par ex. les identifiants Fisconline ou d’autres informations de ressource.