États et modes de Taxpayer, Location et System

⚠️Warning

Vous consultez la documentation pour la version API 2026-05-04. La dernière version est 2026-06-01.

Cette section fournit une vue d’ensemble de l’state et du mode qui définissent le cycle de vie et le comportement opérationnel des ressources Taxpayer, Location et System. Le diagramme ci-dessous illustre les transitions entre états et modes, en 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 invalides.

📘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.

États

• Acquired : État initial de la ressource lors de sa création. Les opérations ne peuvent pas être effectuées dans cet état.
• Commissioned : La ressource est prête et pleinement opérationnelle (à condition que le mode soit opératif).
• Decommissioned : La ressource n’est plus opérationnelle et ne peut plus effectuer de tâches.

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 pleinement 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 ?

Transitions d’état

Toutes les transitions de state sont irréversibles.

• 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 System dans l’environnement LIVE marque le début de la facturation et déclenche la transmission des 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.