Contexte
Dans de nombreux cas, vos clients auront souscrit à une offre avec la possibilité d’activer des options, utiliser un certain de nombre de ressources, etc. Par exemple, votre client dispose d’un abonnement qui contient 3 licences pour l’utilisation d’un logiciel. Mais, il peut à tout moment ajouter une licence supplémentaire.
Dans ce cas, vous devez notifier ProAbono, pour que les éventuelles modifications de tarifs soient appliquées.
Prérequis
Pour que cela fonctionne, vous devez avoir :
- Au moins un client avec un abonnement actif.
- L’abonnement du client doit contenir au moins une caractéristique modifiable.
Procédure
1/ lister les caractéristiques de l’abonnement
Requête
POST https://api-{IdBusiness}.proabono.com/v1/Usage?ReferenceCustomer={ReferenceCustomer} { "ReferenceCustomer": "{ReferenceCustomer}", "DateStamp": "{Date du Jour YYYY-MM-DD}TZ" }
ProAbono va lister toutes les caractéristiques liées à l’abonnement du client et décrire 2 quantités :
- quantité incluse de cette caractéristique dans l’abonnement
- quantité actuelle de cette caractéristique
2/ Modifier la quantité ou l’activation d’une caractéristique
Exemple : requête pour une caractéristique avec quantité : Limitation ou Consommation
POST https://api-{IdBusiness}.proabono.com/v1/Usage
{
"ReferenceFeature": "{ReferenceFeature}",
"ReferenceCustomer": "{ReferenceCustomer}",
"Increment": 5,
"DateStamp": "{Date du Jour YYYY-MM-DD}TZ"
}
OU
Exemple requête pour une caractéristique avec activation : OnOff
POST https://api-{IdBusiness}.proabono.com/v1/Usage { "ReferenceFeature": "{ReferenceFeature}", "ReferenceCustomer": "{ReferenceCustomer}" "IsEnabled" : true, "DateStamp": "{Date du Jour YYYY-MM-DD}TZ" }