Esta es una traducción que desde EGA Futura ofrecemos como cortesía a toda la Ohana y comunidad de programadores , consultores , administradores y arquitectos de Salesforce para toda Iberoamérica .

El enlace a la publicación original, lo encontrarás al final de este artículo.

Siga y complete un trailmix de Learn MOAR Summer '22 para administradores o desarrolladores antes del 31 de julio de 2022 a las 11:59 p. Se aplican restricciones. Aprenda cómo participar y revise las reglas oficiales visitando la página de Trailhead Quests .

Introducción a la gestión de suscripciones

Con la gestión de suscripciones disponible en el verano de 2022, Salesforce permite a las empresas gestionar y monetizar sus suscripciones comerciales en cualquier canal de autoservicio. Esta nueva función le permite automatizar el proceso de facturación, facturación y cobro de pagos de productos de suscripción y ventas únicas. También aprovecha las capacidades de IA de Einstein para evaluar el riesgo de pagos atrasados y maximizar los ingresos.

La administración de suscripciones está impulsada por algunos objetos estándar nuevos en el diseño principal de la API central y headless de Salesforce. La lógica de los diversos procesos involucrados en la suscripción está en las API. Esto lo desvincula de la capa de la aplicación y brinda flexibilidad a los desarrolladores para usar estas API con el front-end de su elección, incluidos sitios web, Slack y aplicaciones móviles.

La API admite casos de uso comunes para administrar ventas de suscripciones recurrentes, que incluyen:

  • Cálculo de precios y ajustes de precios.
  • Implementar una experiencia de "comprar ahora" (pago) en todos los canales de autoservicio
  • Cancelación y renovación de una suscripción
  • Manejo de facturación y pagos

Comience con la API de administración de suscripciones

Para comenzar, necesitará una organización de Salesforce configurada con lo siguiente:

  • Datos del producto
  • Información sobre precios y facturación
  • Una pasarela de pago
  • Un proveedor de impuestos
  • Opcionalmente, una aplicación conectada para la implementación de OAuth 2.0. Necesitará esto solo si está utilizando API REST de administración de suscripciones para integrarse con sistemas fuera del núcleo de Salesforce.

Puede encontrar más información sobre el modelo de datos para la gestión de suscripciones y cómo configurar la organización para habilitar esta funcionalidad en la documentación de Salesforce (disponible próximamente).

Cómo trabajar con la API de administración de suscripciones

La API de administración de suscripciones es una colección de API síncronas y asíncronas. Se puede acceder a estas API de forma segura mediante tokens obtenidos a través del flujo de autorización de OAuth 2.0 mediante aplicaciones conectadas .

Puede encadenar una o más de estas API fácilmente para lograr una funcionalidad integral, como crear una solución de compra ahora (experiencia de pago) que permita a los clientes seleccionar y comprar productos mediante un método de pago preconfigurado.

El siguiente diagrama muestra un ejemplo de cómo encadenar los extremos REST de las API de administración de suscripciones para crear una solución de "comprar ahora". Consulte la guía de referencia para obtener más información sobre cada uno de los pasos involucrados.


Para las API asíncronas, se publica un evento de plataforma cada vez que se completa el proceso. Un suscriptor puede suscribirse y escucharlo de varias maneras ( ver documentos ).

Invocación de la API de administración de suscripciones

Puede invocar las API de administración de suscripciones utilizando una o una combinación de herramientas.

Flujos de Salesforce

Se proporcionan diferentes acciones invocables de flujo para invocar varias API de administración de suscripciones. Consulte los documentos para ver una plantilla de flujo de ejemplo para una solución de "comprar ahora".

El siguiente diagrama muestra cómo usar el elemento de pausa de flujo para esperar los eventos de finalización de acciones asincrónicas (eventos de plataforma). En este ejemplo, cuando se completa la creación de la factura, se publica un evento de factura procesada.

Apex y LWC

Puede llamar a acciones invocables a través de Apex y suscribirse a los eventos de finalización (eventos de plataforma) de acciones asincrónicas a través de disparadores.

También puede crear sus propios componentes de LWC como interfaz para trabajar con las API de gestión de suscripciones.

Consejo profesional: aproveche el componente base de la API Lightning EMP para suscribirse a los eventos de finalización (eventos de plataforma) de una acción asincrónica.

API REST

Al realizar la integración con sistemas fuera del núcleo de Salesforce, simplemente puede invocar las API REST de Gestión de suscripciones utilizando las herramientas y el idioma de su elección. Suscríbase fácilmente a los eventos de finalización de las API asíncronas a través del cliente cometD disponible en varios lenguajes populares de código abierto.

El siguiente ejemplo muestra un cuerpo de solicitud HTTP que crea un pedido para una suscripción perenne.

Tenemos un par de supuestos: 1) la suscripción cuesta $10/mes y comienza el 1 de enero de 2021, con un impuesto sobre las ventas estimado del 7,25 %, y 2) la siguiente información está configurada para los registros a los que se hace referencia en la solicitud.

  • La cuenta tiene una dirección de facturación y una dirección de envío.
  • La entrada del libro de precios está configurada para un producto perenne.
  • El tratamiento de facturación y el tratamiento fiscal predeterminados están configurados para el producto.
  • El plazo de pago por defecto está configurado
 POST /services/data/v55.0/composite
 { "allOrNone": true, "compositeRequest": [ { "method": "POST", "url": "/services/data/vXX.0/sobjects/Order", "referenceId": "refOrder", "body": { "AccountId": "001RM00000XXXXX", "EffectiveDate": "2022-01-01", "Pricebook2Id": "01sRM00000XXXXX", "BillToContactId": "003xx00000XXXXX", "Status": "Draft" } }, { "method": "POST", "url": "/services/data/vXX.0/sobjects/AppUsageAssignment", "referenceId": "refAppTag", "body": { "AppUsageType": "SubscriptionManagement", "RecordId": "@{refOrder.id}" } }, { "method": "POST", "url": "/services/data/vXX.0/sobjects/OrderAction", "referenceId": "refOrderAction", "body": { "OrderId": "@{refOrder.id}", "Type": "New Sale" } }, { "method": "POST", "url": "/services/data/vXX.0/sobjects/OrderItem", "referenceId": "refOrderItem", "body": { "OrderId": "@{refOrder.id}", "OrderActionId": "@{refOrderAction.id}", "PricebookEntryId": "01uRM00000XXXXX", "ServiceDate": "2022-01-01", "Quantity": 1.0, "UnitPrice": 10.0, "NetUnitPrice": 10.0, "TotalLineAmount": 10.0, "PeriodBoundary": "Anniversary", "BillingFrequency2": "Monthly" } }, { "method": "POST", "url": "/services/data/vXX.0/sobjects/OrderItemTaxLineItem", "referenceId": "refTaxLineItem", "body": { "OrderItemId": "@{refOrderItem.id}", "Name": "Sales Tax", "Amount": 0.73, "Type": "Estimated", "TaxEffectiveDate": "2022-01-01" } } ]

Puede obtener más información sobre las diversas API de administración de suscripciones a través de la documentación . Tenga en cuenta que los documentos proporcionan código de muestra en varios lenguajes, incluidos Java, Javascript y Python, que le muestran cómo invocar las API.

Referencias útiles

Aprende MOAR esta semana

Los gerentes de producto y el equipo de relaciones con los desarrolladores están de regreso para compartir las características y funcionalidades más recientes en Summer '22. Para ayudarlo a desarrollarse más rápido, el nuevo contenido de Developer Relations cubrirá sus nuevas funciones favoritas. Además, asegúrese de consultar Release Readiness Live el viernes 20 de mayo de 2022 a las 9:00 a. m. PST . Por último, esté atento al blog de desarrolladores de Salesforce todos los días de esta semana para obtener más publicaciones sobre Summer '22.

Para obtener aún más información, consulte la mezcla de senderos Summer '22 .

Sobre el Autor

Mohith Shrivastava trabaja como promotor principal de desarrollo en Salesforce. Actualmente se está enfocando en API e integraciones y herramientas para desarrolladores. Puedes seguirlo a través de Twitter @msrivastav13 .

Esta es una traducción realizada por EGA Futura, y este es el link a la publicación original: https://developer.salesforce.com/blogs/2022/05/learn-moar-in-summer-22-with-the-new-subscription-management-api.html

Entradas recomendadas