États et modes du Contribuable, de l'Emplacement et du Système

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

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 Taxpayer, Location et System. 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 d’événements internes ou d’appels API externes.

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

É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 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 opère 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’identifiants invalides ou d’erreurs. 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

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.
• Acquired → Decommissioned : Nécessite un appel API (PATCH) pour mettre fin au cycle de vie de la ressource sans jamais l’activer. Cela est utile, par exemple, lorsqu’une ressource a été créée par erreur et n’a jamais besoin de devenir opérationnelle. Comme la ressource n’a jamais été activée, le mode correspondant reste Inactive pendant toute la durée.

⚠️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.