{
"consumedUnits": "150",
"description": "Transaction usage subscription 101",
"externalId": "15-04-transaction-usage",
"metric": {
"id": 1
},
"subscription": {
"id": 3
}
}
La facturation comprend tout ce qui concerne le montant à prélever. Le prélèvement est le processus qui consiste à encaisser effectivement l’argent auprès de l’abonné. Ces deux processus sont découplés dans notre système. Cela signifie que le prélèvement ne doit pas nécessairement être exécuté directement après la facturation. Cette étape peut être différée (voir Stratégies de prélèvement). De plus, le montant qui doit être prélevé ne dépend pas uniquement du montant calculé lors du processus de facturation. Il peut être différent.
Une fois l’abonnement actif, nous tenons un journal d’abonnement pour chaque abonné. Pendant la période, vous pouvez ajouter des entrées au journal de l’abonné en fournissant des rapports d’utilisation ou en ajoutant des écritures de journal supplémentaires pour les services que vous souhaitez facturer à votre abonné. Une fois la période écoulée, le token de l’abonné sera prélevé et une facture de période sera créée et envoyée à votre abonné.
Il existe différents types de prélèvements qui seront automatiquement comptabilisés dans le journal de l’abonné par le système. Vous avez toutefois aussi la possibilité de créer des écritures de journal manuellement. Si vous utilisez des frais à l’usage, vous devez créer des rapports d’utilisation métrique, qui indiquent que les unités consommées peuvent être prélevées.
Les rapports d’utilisation métrique sont utilisés pour prélever auprès de vos abonnés les unités consommées si vous utilisez des frais à l’usage sur votre produit.
Les rapports d’utilisation métrique sont utilisés pour facturer l’utilisation mesurée de vos produits avec un prix à l’usage. Vous pouvez créer le rapport d’utilisation métrique dans le backend via Space > Abonnement > Rapports d’utilisation métrique.
Les rapports d’utilisation métrique sont généralement créés via l’API web service. Vous pouvez également utiliser l’opération create sur le
Subscription Metric Usage Service
pour créer un rapport d’utilisation.
Request
{
"consumedUnits": "150",
"description": "Transaction usage subscription 101",
"externalId": "15-04-transaction-usage",
"metric": {
"id": 1
},
"subscription": {
"id": 3
}
}
Tous les rapports d’utilisation métrique seront automatiquement prélevés auprès de votre abonné à la fin de la période. Nous additionnons tous les rapports d’utilisation métrique d’un abonné et appliquons automatiquement les frais à l’usage définis dans le produit.
Si vous souhaitez ajouter des débits ou des crédits à votre abonné, vous pouvez le faire via des écritures de journal.
Les écritures de journal peuvent être ajoutées manuellement. Ouvrez l’abonnement et passez dans l’onglet des écritures de journal pour ajouter des positions.
Vous pouvez également ajouter des écritures de journal via l’API en utilisant l’opération create sur le
Subscription Ledger Entry Service.
|
Note
|
Les montants négatifs correspondent à des crédits. |
Request
{
"amountIncludingTax": "55",
"externalId": "subscriber-101-consulting-service",
"quantity": "1",
"subscriptionVersion": {
"id": 3
},
"taxes": [{
"rate": "8",
"title": "VAT Switzerland"
}],
"title": "Consulting Services"
}
Une fois les écritures de journal créées, elles se trouvent dans l’état open. Les écritures de journal ouvertes sont prélevées
automatiquement dès que la période suivante arrive à échéance. Vous pouvez également prélever les écritures de journal manuellement
en créant un prélèvement pour l’abonnement.
Les prélèvements peuvent être créés via le backend en naviguant vers l’onglet Prélèvements dans l’abonnement. Un prélèvement
se compose d’une date d’exécution planifiée et d’une référence. Une fois la date d’exécution planifiée atteinte, toutes les
écritures de journal ouvertes seront prélevées. Vous pouvez également créer des prélèvements via l’API web service en utilisant l’opération create sur le
Subscription Charge Service.
Request
{
"externalId": "1-charge-subscription-101",
"plannedExecutionDate": "2017-04-25T07:50:15.596Z",
"processingType": "SYNCHRONOUS",
"reference": "1-charge-subscription-101",
"subscription": {
"id": 3
}
}
Les prélèvements sont normalement exécutés automatiquement une fois la période terminée. Vous avez toutefois la possibilité de configurer des stratégies de prélèvement spéciales déterminant quand le prélèvement de votre abonné doit avoir lieu. Cela se fait sous Space > Abonnements > Configuration > Stratégies. Vous pouvez y sélectionner une stratégie de prélèvement.
Vous pouvez également configurer plusieurs stratégies de prélèvement et leur appliquer des conditions déterminant comment elles sont sélectionnées. Les conditions de stratégie peuvent être définies sous Space > Abonnements > Conditions de stratégie.
Par exemple, si le montant total à prélever est inférieur à 5 EUR, le prélèvement peut ne pas avoir de sens parce que les frais sont trop élevés. On peut donc définir une stratégie de prélèvement qui ignore le prélèvement pour cette période spécifique. Le montant sera reporté sur la période suivante.
Un autre cas d’utilisation pourrait être que le prélèvement doive toujours avoir lieu au début du mois parce que vous vous attendez à ce que l’abonné dispose alors de suffisamment d’argent sur son compte bancaire. Vous pouvez donc configurer une stratégie de prélèvement qui retarde le prélèvement jusqu’au prochain début de mois.