Descripción de cómo API REST y eventos integran sistemas con SAP Subscription Billing

Explicación de la diferencia entre la integración de SAP S/4HANA, edición en la nube pública y privada

Análisis del contenido de integración estándar de SAP Subscription Billing con sistemas SAP

Integración de SAP Subscription Billing con otros sistemas SAP y no SAP

Uso de API REST en SAP Subscription Billing

Exploración de API de suscripción

Gestión de API de uso en SAP Subscription Billing

Gestión de API de facturas en SAP Subscription Billing

Gestión de API de uso en SAP Subscription Billing

Objective

After completing this lesson, you will be able to gestione API de uso para informar, actualizar y recuperar datos de uso en SAP Subscription Billing.

API de uso para informar, actualizar y recuperar datos de uso en SAP Subscription Billing

Los ID de recursos técnicos desempeñan un papel crucial en la identificación de la suscripción correcta al procesar datos de uso, lo que garantiza que los datos coincidan con precisión con la suscripción correspondiente durante el proceso de facturación.

Al crear una suscripción, el elemento de tarifa en nuestro ejemplo para el producto BR469 está diseñado para generar automáticamente IDs de recursos técnicos para identificar recursos de forma unívoca. Como alternativa, tiene la opción de actualizar manualmente sus propios recursos técnicos.

En el siguiente escenario, el sistema está configurado para gestionar la generación automática de ID de recursos técnicos. Cuando se trata de cargar datos de uso en SAP Subscription Billing, cada elemento de suscripción se puede asociar con uno o varios ID de recursos técnicos. Para empezar a generar datos de uso con una API, primero adquiera el ID de recurso técnico para la posición de suscripción que necesita un registro de uso. Puede abrir la aplicación SAP Fiori Gestionar suscripciones en el sistema SAP Subscription Billing, abrir la posición de suscripción y verificar en Recursos técnicos. También puede enviar una solicitud de suscripción GET para recuperar toda la información de la suscripción.

Veamos cómo crear una nueva solicitud para un ID de recurso técnico. Vea el siguiente vídeo para empezar.

Ahora que ha tenido la oportunidad de explorar la creación de un ID de recurso técnico con un REST CLIENT, hagámoslo nosotros mismos en el siguiente ejercicio.

Obtener el ID de recurso técnico para enviar datos de uso mediante API

Escenario empresarial

Es un desarrollador que implementa Facturación de suscripciones para su empresa.

Su empresa ofrece un servicio con determinación de precios basada en el uso. Deben implementar un sistema para realizar un seguimiento preciso y facturar a los clientes en función de su uso. Su tarea es recuperar el ID de recurso técnico para la suscripción de un cliente específico, que se utilizará para enviar datos de uso mediante una API.

Pasos

Repita el ejercicio Obtener ID de cliente y Crear una suscripción mediante la API POST Subscription, ya que la suscripción se ha cancelado.
1. Vuelva a realizar el ejercicio.
Cree una nueva solicitud en Bruno.
Utilice los datos siguientes:
Campo Valor
Nombre <of your choice>, por ejemplo: Obtener suscripción
por defecto Obtener
URL
https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
Autoriz. Token de portador
ID de recurso técnico: ______________________________________
1. Cree una nueva solicitud en Bruno seleccionando + en la pestaña.
2. Asígnele un nombre de su elección, por ejemplo: Obtener suscripción.
3. Para la URL, modifique el método a POST e introduzca la URL: https://eu10.revenue.cloud.sap/api/subscription/v1/subscriptions.
4. Seleccione Crear.
5. Sustituya el ID en la URL por el ID de factura del ejercicio Enviar una solicitud de obtención para recuperar información de datos de uso.
6. Abra la pestaña Autenticación y seleccione BearerToken.
7. Introduzca el token de portador del ejercicio Generar un token de portador para obtener autorización para las API.
8. Seleccione Enviar.
9. Verifique que reciba una respuesta "200" y vea una lista con todas las suscripciones en el sistema. Una vez que encuentre su suscripción, puede buscar el ID del recurso técnico (en el nodo "TechnicalResources"). Anote el ID de recurso técnico.
10. Una vez que encuentre su suscripción, puede buscar el ID del recurso técnico (en el nodo TechnicalResources). Anote el ID de recurso técnico.

Campo	Valor
Nombre	<of your choice>, por ejemplo: Obtener suscripción
por defecto	Obtener
URL	https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
Autoriz.	Token de portador

Envío de datos de uso al sistema SAP Subscription Billing

Una vez obtenido un ID de recurso técnico, su siguiente paso es enviar datos de uso al sistema SAP Subscription Billing con su API. Al proporcionar el ID de recurso técnico, el sistema asocia los datos de uso con la suscripción adecuada.

Dentro de SAP Subscription Billing, el recurso técnico hace referencia a los recursos o servicios específicos que consume el cliente. Podrían ser cosas como almacenamiento de datos, llamadas API, ancho de banda de red o cualquier otro recurso o servicio medible que se esté utilizando dentro del modelo de suscripción. El recurso técnico es clave para realizar un seguimiento y facturar con precisión a los clientes en función de su uso. En nuestro escenario, el tipo de recurso técnico se llama USAGE_FEE y el ID será un ID de recurso técnico generado automáticamente. En escenarios reales, el tipo podría ser, por ejemplo, llamadas API y el ID podría ser la dirección IP del dispositivo.

En el siguiente vídeo, aprenderá a crear una nueva solicitud POST en Bruno para enviar datos de uso al sistema SAP Subscription Billing, que aplicará en el ejercicio.

Resumen

Realice los dos ejercicios siguientes.

Ahora que ha tenido la oportunidad de cargar y consumir datos de uso y crear recursos técnicos y sus ID correspondientes, en la siguiente unidad gestionará las API de facturación para crear, recuperar, actualizar y borrar información en SAP Subscription Billing.

Enviar datos de uso a su suscripción mediante API

Escenario empresarial

Su siguiente tarea es enviar datos de uso al sistema Facturación de suscripciones mediante una API. Por ejemplo, esto podría ser para una serie de llamadas API si sus clientes pagan por llamada API.

Pasos

Cree una nueva solicitud en Bruno.
Utilice los datos siguientes:
Campo Valor
Nombre Crear datos de uso
Método URL Contabilizar
URL utilizada https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
Autoriz. BearerToken
1. Seleccione + en la pestaña.
2. Introduzca el nombre de la tabla.
3. Para la URL, modifique el método a POST e introduzca la URL: https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records.
4. Seleccione Crear.
Añada el token de portador.
1. Abra la pestaña Autenticación y seleccione BearerToken.
2. Introduzca el token de portador del ejercicio Obtener el ID de recurso técnico para enviar datos de uso mediante API.
Introduzca el JSON, por ejemplo:
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. Abra la pestaña Cuerpo y seleccione JSON.
2. Introduzca el código indicado.
3. Seleccione el botón Enviar.
  Debería recibir un 201 con el ID de los registros de uso.

Campo	Valor
Nombre	Crear datos de uso
Método URL	Contabilizar
URL utilizada	https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
Autoriz.	BearerToken

Resultado

Ahora que ha cargado datos de uso en el sistema SAP Subscription Billing, debe verificar si los datos se reflejan en el sistema. Enviará una solicitud GET para verificar la visualización de estos datos de uso.

Enviar una solicitud GET para recuperar información de datos de uso

Escenario empresarial

En este ejercicio, su tarea es implementar un sistema que recupere información de datos de uso para la suscripción de un cliente específico mediante la API de facturación de suscripciones. Esta información se utilizará para analizar el comportamiento de uso del cliente.

Pasos

Cree una nueva solicitud en Bruno.
Utilice los datos siguientes:
Campo Valor
Nombre Obtener datos de uso
Método URL Obtener
URL utilizada https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
Autoriz. BearerToken
1. Seleccione + en la pestaña.
2. Introduzca el nombre de la tabla.
3. Para la URL, modifique el método a Obtener e introduzca la URL: https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records.
4. Seleccione Crear.
Añada el token de portador.
1. Abra la pestaña Autenticación y seleccione BearerToken.
2. Introduzca el token de portador del ejercicio Generar un token de portador para obtener autorización para las API.
3. Seleccione Enviar.

Campo	Valor
Nombre	Obtener datos de uso
Método URL	Obtener
URL utilizada	https://eu10.revenue.cloud.sap/api/usage-record/v1/usage-records
Autoriz.	BearerToken

Continue to quiz