Description de la manière dont les API et les événements REST intègrent les systèmes à SAP Subscription Billing
Explication de la différence entre l'intégration de SAP S/4HANA, édition cloud public et édition cloud privé
Analyse du contenu d'intégration standard de SAP Subscription Billing avec les systèmes SAP
Intégration de SAP Subscription Billing à d'autres systèmes SAP et non SAP
Utilisation des API REST dans SAP Subscription Billing
Exploration des API d'abonnement
Gestion des API d'utilisation dans SAP Subscription Billing
Gestion des API de facturation dans SAP Subscription Billing

Gestion des API d'utilisation dans SAP Subscription Billing

Objective

After completing this lesson, you will be able to gérez les API d'utilisation pour créer des rapports, mettre à jour et récupérer des données d'utilisation dans SAP Subscription Billing.

API d'utilisation pour signaler, mettre à jour et récupérer les données d'utilisation dans SAP Subscription Billing

Les ID de ressources techniques jouent un rôle crucial dans l'identification de l'abonnement correct lors du traitement des données d'utilisation, en s'assurant que les données sont correctement mises en correspondance avec l'abonnement correspondant lors du processus de facturation.

Lors de la création d'un abonnement, l'élément de tarif dans notre exemple pour le produit BR469 est conçu pour générer automatiquement des ID de ressource techniques afin d'identifier de manière unique les ressources. Vous avez également la possibilité de gérer manuellement vos propres ressources techniques.

Dans le scénario suivant, le système est configuré pour gérer automatiquement la génération d'ID de ressource technique. En ce qui concerne le chargement des données d'utilisation dans SAP Subscription Billing, chaque option d'abonnement peut être associée à un ou plusieurs ID de ressources techniques. Pour commencer à générer des données d'utilisation avec une API, commencez par acquérir l'ID de ressource technique pour le poste d'abonnement qui requiert un enregistrement d'utilisation. Vous pouvez ouvrir l'application SAP Fiori Gestion des abonnements dans le système SAP Subscription Billing, ouvrir le poste d'abonnement et le contrôler sous Ressources techniques. Vous pouvez également envoyer une demande d'abonnement GET pour récupérer toutes les informations de l'abonnement.

Voyons comment créer une nouvelle demande pour un ID de ressource technique. Regardez la vidéo suivante pour commencer.

Maintenant que vous avez eu l'occasion d'explorer la création d'un ID de ressource technique avec un CLIENT REST, faisons-le nous-mêmes dans l'exercice suivant.

Accéder à l'ID de ressource technique pour l'envoi de données d'utilisation via l'API

Scénario de gestion

Vous êtes un développeur qui implémente la facturation des abonnements pour votre société.

Votre société propose un service avec une détermination du prix basée sur l'utilisation. Ils doivent implémenter un système pour suivre et facturer avec précision les clients en fonction de leur utilisation. Votre tâche consiste à récupérer l'ID de ressource technique pour l'abonnement d'un client spécifique, qui sera utilisé pour envoyer les données d'utilisation via l'API.

Étapes

  1. Répétez l'exercice Obtenir l'ID client et créez un abonnement à l'aide de l'API d'abonnement POST, car l'abonnement a été résilié.

    1. Répétez l'exercice.

  2. Créez une nouvelle demande dans Bruno.

    Utilisez les données suivantes :

    ZoneValeur
    Nom<of your choice>, par exemple : Obtenir un abonnement
    régul. par défautObtention
    URL

    https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records

    Autor.Jeton du porteur

    ID de ressource technique : ______________________________________

    1. Créez une demande dans Bruno en cliquant sur + dans l'onglet.

    2. Donnez-lui un nom de votre choix, par exemple : Obtenir un abonnement.

    3. Pour l'URL, remplacez la méthode par POST et saisissez l'URL : https://eu10.revenue.cloud.sap/api/subscription/v1/subscriptions.

    4. Sélectionnez Créer.

    5. Remplacez l'ID dans l'URL par l'ID de facture de l'exercice Envoyer une demande de récupération des informations de données d'utilisation.

    6. Ouvrez l'onglet Auth et sélectionnez BearerToken.

    7. Saisissez le Jeton du porteur de l'exercice Générer un jeton du porteur pour obtenir l'autorisation pour les API.

    8. Sélectionnez Envoyer.

    9. Vérifiez que vous recevez une réponse « 200 » et affichez une liste de tous les abonnements dans le système. Une fois que vous avez trouvé votre abonnement, vous pouvez rechercher l'ID de ressource technique (sous le nœud "technicalResources"). Notez l'ID de la ressource technique.

    10. Une fois que vous avez trouvé votre abonnement, vous pouvez rechercher l'ID de ressource technique (sous le nœud technicalResources). Notez l'ID de la ressource technique.

Envoi des données d'utilisation au système SAP Subscription Billing

Une fois que vous avez obtenu un ID de ressource technique, l'étape suivante consiste à envoyer les données d'utilisation au système SAP Subscription Billing avec votre API. En indiquant l'ID de ressource technique, le système associe les données d'utilisation à l'abonnement approprié.

Dans SAP Subscription Billing, la ressource technique fait référence aux ressources ou services spécifiques consommés par le client. Il peut s'agir de stockage de données, d'appels API, de bande passante réseau ou de toute autre ressource ou service mesurable utilisé dans le modèle d'abonnement. La ressource technique est essentielle pour suivre et facturer avec précision les clients en fonction de leur utilisation. Dans notre scénario, le type de ressource technique est appelé USAGE_FEE et l'ID sera un ID de ressource technique généré automatiquement. Dans les scénarios réels, le type peut être, par exemple, Appels API et l'ID peut être l'adresse IP de l'appareil.

Dans la vidéo suivante, vous allez apprendre à créer une nouvelle demande POST dans Bruno pour envoyer des données d'utilisation au système SAP Subscription Billing, que vous appliquerez ensuite dans l'exercice.

synthèse

Effectuez les deux exercices suivants.

Maintenant que vous avez eu l'occasion de charger et d'utiliser les données d'utilisation et de créer des ressources techniques et leurs ID correspondants, dans le chapitre suivant, vous gérerez les API de facturation pour créer, récupérer, mettre à jour et supprimer des informations dans SAP Subscription Billing.

Envoyer les données d'utilisation à votre abonnement via l'API

Scénario de gestion

Votre tâche suivante consiste à envoyer les données d'utilisation au système de facturation des abonnements via l'API. Par exemple, il peut s'agir d'un certain nombre d'appels d'API si vos clients paient par appel d'API.

Étapes

  1. Créez une nouvelle demande dans Bruno.

    Utilisez les données suivantes :

    ZoneValeur
    NomCréer données d'utilisation
    Méthode URLComptabiliser
    URL utiliséehttps://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
    Autor.BearerToken

    1. Cliquez sur le signe + dans l'onglet.

    2. Saisissez le nom du tableau.

    3. Pour l'URL, remplacez la méthode par POST et saisissez l'URL : https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records.

    4. Sélectionnez Créer.

  2. Ajoutez le jeton du porteur.

    1. Ouvrez l'onglet Auth et sélectionnez BearerToken.

    2. Saisissez le jeton du porteur de l'exercice Obtenir l'ID de ressource technique pour l'envoi de données d'utilisation via l'API.

  3. Saisissez le JSON, par exemple :

    Code Snippet
    12345678
      "startedAt": "2024-07-05T05:00:00Z",
  "endedAt": "2024-07-06T05:00:00Z",
  "category": "MEASURED",
  "metricId": "USAGE_FEE",
  "quantity": 5,
  "userTechnicalId": "your technical resource ID"
}

    1. Ouvrez l'onglet Corps et sélectionnez JSON.

    2. Saisissez le code indiqué.

    3. Cliquez sur le bouton Envoyer.

      Vous devez recevoir un 201 avec l'ID des enregistrements d'utilisation.

Résultat

Maintenant que vous avez chargé les données d'utilisation dans le système SAP Subscription Billing, vous devez vérifier si les données sont reflétées dans le système. Vous allez envoyer une demande GET pour vérifier l'affichage de ces données d'utilisation.

Envoyer une demande GET pour récupérer les informations de données d'utilisation

Scénario de gestion

Dans cet exercice, votre tâche consiste à implémenter un système qui récupère les informations de données d'utilisation pour l'abonnement d'un client spécifique à l'aide de l'API de facturation des abonnements. Ces informations seront utilisées pour analyser le comportement d'utilisation du client.

Étapes

  1. Créez une nouvelle demande dans Bruno.

    Utilisez les données suivantes :

    ZoneValeur
    NomAccéder aux données d'utilisation
    Méthode URLObtention
    URL utiliséehttps://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
    Autor.BearerToken

    1. Cliquez sur le signe + dans l'onglet.

    2. Saisissez le nom du tableau.

    3. Pour l'URL, remplacez la méthode par Get et saisissez l'URL : https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records.

    4. Sélectionnez Créer.

  2. Ajoutez le jeton du porteur.

    1. Ouvrez l'onglet Auth et sélectionnez BearerToken.

    2. Saisissez le Jeton du porteur de l'exercice Générer un jeton du porteur pour obtenir l'autorisation pour les API.

    3. Sélectionnez Envoyer.

Learning

SAP FacebookSAP YoutubeSAP LinkedIn