Administración del ciclo de vida de la suscripción de SaaS
El marketplace comercial administra todo el ciclo de vida de una suscripción de SaaS después de su compra por parte del usuario final. Usa la página de aterrizaje, las API de suministro, las API de operaciones y el webhook como mecanismo para impulsar la activación, el uso, las actualizaciones y la cancelación reales de la suscripción de SaaS. La factura del usuario final se basa en el estado de la suscripción de SaaS que Mantiene Microsoft.
Estados de una suscripción de SaaS
En el diagrama siguiente se muestran los estados de una suscripción de SaaS y las acciones aplicables.
Comprado, pero aún no activado (PendingFulfillmentStart)
Después de que un usuario final o proveedor de soluciones en la nube (CSP) compre una oferta de SaaS en el marketplace comercial, se notificará al publicador de la compra. Después, el publicador puede crear y configurar una nueva cuenta de SaaS en el lado del publicador para el usuario final.
Para que se produzca la creación de la cuenta:
- El cliente selecciona el botón Configurar cuenta ahora que está disponible para una oferta de SaaS después de su compra correcta en Microsoft AppSource o Azure Portal. Como alternativa, el cliente puede usar la botón Configurar ahora en el correo electrónico que recibirá poco después de la compra.
- Después, Microsoft notifica al asociado la compra abriendo la dirección URL de la página de aterrizaje con el parámetro token (el token de identificación de compra del marketplace comercial) en la nueva pestaña del explorador.
Un ejemplo de dicha llamada es https://contoso.com/signup?token=<blob>, pero la dirección URL de la página de aterrizaje de esta oferta de SaaS en el Centro de partners se configura como https://contoso.com/signup. Este token proporciona al publicador un identificador que identifica de forma única la compra de SaaS y el cliente.
Propina
No incluya el carácter de signo de libra (#) en la dirección URL de la página de aterrizaje. De lo contrario, los clientes no pueden acceder a la página de aterrizaje. El publicador tiene 30 días para resolver el recurso cuando el estado es PendingFulfillmentStart. De lo contrario, se anula el recurso. Dado que el ciclo de facturación no se inició y no se factura la compra correspondiente, el estado cambia a Cancelación de suscripción. El cliente no se factura por la compra.
Importante
La dirección URL de la página de aterrizaje debe estar en funcionamiento todo el día, todos los días y estar lista para recibir nuevas llamadas de Microsoft siempre. Si la página de aterrizaje deja de estar disponible, los clientes no pueden registrarse en el servicio SaaS y empezar a usarlo.
A continuación, el publicador debe volver a pasar el token de a Microsoft llamando a SaaS Resolve APIy escribiendo el token como el valor del parámetro x-ms-marketplace-token header. Como resultado de la llamada a resolve API, el token se intercambia para obtener detalles de la compra de SaaS, como el identificador único de la compra, el identificador de oferta comprado y el identificador del plan comprado.
En la página de aterrizaje, el cliente debe iniciar sesión en la cuenta de SaaS nueva o existente a través del inicio de sesión único (SSO) de Microsoft Entra.
Nota
El publicador no recibe una notificación de la compra de SaaS hasta que el cliente inicia el proceso de configuración desde el lado de Microsoft.
El publicador debe implementar el inicio de sesión único para proporcionar la experiencia del usuario requerida por Microsoft para este flujo. Asegúrese de usar la aplicación Microsoft Entra multiinquilino y permitir cuentas profesionales y educativas o cuentas microsoft personales al configurar el inicio de sesión único. Este requisito solo se aplica a la página de aterrizaje, para los usuarios que se redirigen al servicio SaaS cuando ya han iniciado sesión con las credenciales de Microsoft. El inicio de sesión único no es necesario para todos los inicios de sesión en el servicio SaaS.
Nota
Si el inicio de sesión único requiere que un administrador deba conceder permiso a una aplicación, la descripción de la oferta en el Centro de partners debe revelar que se requiere acceso de nivel de administrador. Esta divulgación es cumplir con directivas de certificación de Marketplace comercial.
Después de iniciar sesión, el cliente debe completar la configuración de SaaS en el lado del publicador. A continuación, el publicador debe llamar a la API de Activar suscripción para enviar una señal a Azure Marketplace de que se complete el aprovisionamiento de la cuenta de SaaS. Esta acción inicia el ciclo de facturación del cliente. Si la llamada a la API Activate Subscription no se realiza correctamente, el cliente no se factura por la compra.
Tanto el comprador como el propietario de la cuenta de facturación reciben un correo electrónico que los solicita para configurar la cuenta.
Nota
El publicador tiene 30 días para resolver el recurso cuando el estado es PendingFulfillmentStart. De lo contrario, el recurso se anula porque el ciclo de facturación no se inició y no se factura la compra correspondiente. El estado cambia a cancelación de suscripción. El cliente no se factura por la compra.
Activo (suscrito )
activo (suscrito) es el estado estable de una suscripción de SaaS aprovisionada. Después de los procesos del lado de Microsoft, la llamada Activar la API de suscripción, la suscripción de SaaS se marca como suscrito. El cliente ahora puede usar el servicio SaaS en el lado del publicador y se factura.
Cuando una suscripción de SaaS ya está activa, el cliente puede seleccionar administrar la experiencia de SaaS desde Azure Portal o el Centro de administración de Microsoft 365. Esta acción también hace que Microsoft llame a la dirección URL de la página de aterrizaje
Se envía un correo electrónico de notificación de activación al comprador y al propietario de la cuenta de facturación.
Actualización (suscrito )
Esta acción significa que Microsoft y el publicador procesan una actualización de una suscripción de SaaS activa existente. Actualizaciones iniciadas por:
- El cliente del marketplace comercial.
- CSP del marketplace comercial.
- El cliente del sitio SaaS del publicador (pero no para las compras realizadas por CSP).
Hay dos tipos de actualizaciones disponibles para una suscripción de SaaS:
- Actualice el plan cuando el cliente elija otro plan para la suscripción.
- Actualice la cantidad cuando el cliente cambie el número de licencias compradas para la suscripción.
Solo se puede actualizar una suscripción activa. Mientras se actualiza la suscripción, su estado permanece activo en el lado de Microsoft.
Actualización iniciada desde marketplace comercial
En este flujo, el cliente cambia el plan de suscripción o la cantidad de licencias desde Azure Portal o el Centro de administración de Microsoft 365.
- Después de escribir una actualización, Microsoft llamará a la dirección URL del webhook del publicador, configurada en el campo webhook de conexión de
en la página de configuración técnica de en el Centro de partners, con un valor adecuado para acción y otros parámetros pertinentes. - El lado del publicador debe realizar los cambios necesarios en el servicio SaaS y notificar a Microsoft cuando termine llamando al estado de actualización de API de operación.
- Si la revisión se envía con error estado, el proceso de actualización no finaliza en el lado de Microsoft. La suscripción de SaaS mantiene el plan y la cantidad de licencias existentes.
Nota
El publicador debe invocar PATCH para actualizar el estado de la API de operación con un de respuesta de error y éxito dentro de un período de tiempo de 10 segundos después de recibir la notificación de webhook. Si el estado patch de la operación no se recibe en los 10 segundos, el plan de cambio se aplicar revisiones automáticamente como Correcto.
La secuencia de llamadas API para un escenario de actualización que se inicia desde el marketplace comercial se muestra en el diagrama siguiente.
Actualización iniciada desde el publicador
En este flujo, el cliente cambia el plan de suscripción o la cantidad de licencias adquiridas desde el propio servicio SaaS.
- Antes de que se realice el cambio solicitado en el lado del publicador, el código del publicador debe llamar al api de plan de cambio de
o a la API Change Quantity o ambos. - Microsoft aplica el cambio a la suscripción y, a continuación, notifica al publicador a través de webhook de conexión para aplicar el mismo cambio.
- Solo debe el publicador realizar el cambio necesario en la suscripción de SaaS y notificar a Microsoft cuándo se realiza el cambio llamando a Estado de actualización de la API de operación.
La secuencia de llamadas API para un escenario de actualización que se inicia desde el lado del publicador se muestra en el diagrama siguiente.
Un correo electrónico de notificación que indica un cambio de plan se envía al comprador y al propietario de la cuenta de facturación.
Un correo electrónico de notificación que indica un cambio en la cantidad se envía al comprador y al propietario de la cuenta de facturación.
Suspendido (suspendido)
Este estado indica que no se recibió el pago de un cliente para el servicio SaaS. Microsoft notifica al publicador este cambio en el estado de la suscripción de SaaS. La notificación se realiza a través de una llamada al webhook con la acción parámetro establecido en Suspendido.
El publicador podría o no realizar cambios en el servicio SaaS en el lado del publicador. Se recomienda que el publicador ponga esta información a disposición del cliente suspendido y limite o bloquee el acceso del cliente al servicio SaaS. Hay una probabilidad de que el pago no se reciba nunca.
Nota
Microsoft proporciona al cliente un período de gracia de 30 días antes de cancelar automáticamente la suscripción. Una vez finalizado el período de gracia de 30 días, el webhook recibe una acción Unsubscribe.
Cuando una suscripción está en estado suspendido:
- El asociado o ISV debe mantener la cuenta de SaaS en un estado recuperable, de modo que se pueda restaurar toda la funcionalidad sin pérdida de datos ni configuraciones.
- El partner o isV deben esperar una solicitud para restablecer la suscripción, si el pago se recibe durante el período de gracia o una solicitud para cancelar el aprovisionamiento de la suscripción al final del período de gracia. El mecanismo de webhook envía ambas solicitudes.
El estado de la suscripción se cambia a suspendidos en el lado de Microsoft antes de que el publicador realice cualquier acción. Solo se pueden suspender las suscripciones activas.
Se envía un correo electrónico de notificación que indica el cambio de estado a suspendidos tanto al comprador como al propietario de la cuenta de facturación.
Después de un período de suspensión de 30 días, se envía un correo electrónico sobre la cancelación posterior a la suspensión al comprador y al propietario de la cuenta de facturación.
Restablecido (suspendido)
Esta acción indica que el instrumento de pago del cliente es válido de nuevo. Se realizó un pago para la suscripción de SaaS y se restablece la suscripción. En este caso:
- Microsoft llama al webhook con una acción de parámetro establecido en el valor de Restablecido.
- El publicador se asegura de que la suscripción vuelva a estar totalmente operativa en el lado del publicador.
- El proceso de restablecimiento se realiza correctamente y el cliente se factura de nuevo por la suscripción de SaaS.
Solo se puede restablecer una suscripción suspendida. La suscripción de SaaS suspendida permanece en un estado de suspendido mientras se restablece. Una vez finalizada esta operación, el estado de la suscripción se convierte en Active.
Se envía un correo electrónico al comprador y al propietario de facturación después de la transición del estado suspendido al estado restablecido.
Renovado (suscrito)
Microsoft renueva automáticamente la suscripción de SaaS al final del período de suscripción de un mes o año. El valor predeterminado de la configuración de autorenewal es true para todas las suscripciones de SaaS. Las suscripciones de SaaS activas siguen renovarse con una cadencia regular. Microsoft proporciona notificaciones de webhook de solo información para eventos de renovación. Un cliente puede desactivar la renovación automática de una suscripción de SaaS a través del Portal de administración de Microsoft 365. En este caso, la suscripción de SaaS se cancela automáticamente al final del período de facturación actual. Los clientes también pueden cancelar la suscripción de SaaS en cualquier momento.
Solo se renuevan automáticamente las suscripciones activas. Las suscripciones permanecen activas durante el proceso de renovación y si la renovación automática se realiza correctamente. Después de la renovación, las fechas de inicio y finalización del período de suscripción se actualizan a las fechas del nuevo período.
Si se produce un error en una autorenewal debido a un problema con el pago, la suscripción se convierte en Suspendido y se notifica al publicador.
Los correos electrónicos de aviso para la renovación se envían tanto al comprador como al propietario de la cuenta de facturación, 30 días antes de la fecha de renovación anual o multiear.
Cancelado (cancelada)
Las suscripciones alcanzan este estado después de que se realice una acción explícita de cliente o CSP para cancelar la suscripción. Cancelan una suscripción desde el sitio del publicador, Azure Portal o el Centro de administración de Microsoft 365. Una suscripción también se cancela implícitamente, como resultado del pago por impago de vencimientos y después de estar en el Estado suspendido durante 30 días.
Después de que el publicador reciba una llamada de webhook de cancelación, debe conservar los datos del cliente para la recuperación a petición durante al menos siete días. Solo se pueden eliminar los datos del cliente.
Una suscripción de SaaS se puede cancelar en cualquier momento de su ciclo de vida. Después de cancelar una suscripción, no se puede reactivar.
El correo electrónico de cancelación se envía al comprador y al propietario de la cuenta de facturación.
Contenido relacionado
tutoriales de vídeo de