Contexte
Un abonnement a deux états :
-
Un état métier (Status) qui peut être vu comme un état simplifié ou un état externe
-
Un état technique (StateSubscription) qui reflète l’état métier et apporte de précisions sur le cycle de vie de cet abonnement.
État métier
C’est l’état qui vous intéressera dans la plupart des cas. Il indique l’état de l’abonnement tel qu’un logiciel externe a besoin de le voir.
|
État métier |
API |
Description |
|
Brouillon |
Draft |
L’abonnement n’a pas encore démarré |
|
Actif |
Active |
L’abonnement est actif, ce qui signifie que le client peut accéder à votre service. |
|
Suspendu |
Suspended |
L’abonnement a été suspendu |
|
Interrompu |
Ended |
L’abonnement n’est plus actif |
|
Supprimé |
Deleted |
Abonnement en cours de suppression |
État technique
Cet état ne vous servira que si vous souhaitez exactement comprendre le fonctionnement de ProAbono. Il indique où se trouve l’abonnement dans sa machine à états, les actions et les conséquences possibles.
Appuyez-vous plutôt sur l’état métier pour vous éviter de rentrer dans la complexité
Si vous souhaitez aller plus loin, cet article vous décrira le cycle de vie de l’abonnement.
| État métier | État technique (StateSubscription) |
Description |
|---|---|---|
| Brouillon | DraftCustomer | Brouillon créé par un client qui n’a pas achevé le parcours de souscription. |
| DraftAgent | Brouillon créé par un membre de votre équipe | |
| DraftDelayedStart | Abonnement dont le démarrage est programmé | |
| DraftDelayedUpgrade | Abonnement qui remplacera un abonnement actif lors de sa prochaine échéance (changement d’offre) | |
| Actif | ActiveRunning | L’abonnement est actif. |
| ActiveDelayedUpgrade | Cet abonnement sera remplacé par un autre à la prochaine échéance (changement d’offre). | |
| ActiveDelayedTermination | L’abonnement sera résilié à la prochaine échéance | |
| ActiveDelayedSuspension | L’abonnement sera suspendu à la prochaine échéance | |
| Suspendu | SuspendedAgent | Suspendu par un membre de votre organisation |
| SuspendedNoPaymentInfo | Suspendu automatiquement car le client ne possède pas de moyen de paiement valide | |
| SuspendedPaymentDue | Suspendu automatiquement parce que le client a trop d’impayés | |
| Interrompu | EndedComplete | Fin d’un abonnement à durée limité |
| EndedTerminated | Abonnement résilié | |
| EndedUpgraded | Abonnement résilié suite à un changement d’offre | |
| Supprimé | Deleted | Abonnement en cours de suppression |
Exemple d’un abonnement au format JSON
{
"Id": 42",
...
"ReferenceCustomer": "123456",
"Status": "Active", // Etat métier
"StateSubscription": "ActiveDelayedTermination", // Etat technique
...
}