API de cumplimiento de SaaS en el marketplace comercial de Microsoft

  • Artículo

Las API de suministro de SaaS permiten que fabricantes de software independientes (ISV) publiquen y vendan sus aplicaciones SaaS con Microsoft AppSource, Azure Marketplace y Azure Portal. Estas API permiten a las aplicaciones de ISV participar en todos los canales de comercio: directo, dirigidos por asociados (revendedor) y sobre el terreno. La integración con estas API es un requisito para crear y publicar una oferta de SaaS que permite transacciones en el Centro de partners.

Para obtener información sobre las API de suministro de SaaS, se recomienda leer también los siguientes artículos:

Flujos de API

Los ISV deben implementar los siguientes flujos de API agregando a su código de servicio SaaS para mantener el mismo estado de suscripción para ISV y Microsoft:

  • Flujo de la página de aterrizaje: Microsoft notifica al anunciante que un cliente de Marketplace ha adquirido la oferta de SaaS del publicador.
  • Flujo de activación: El publicador notifica a Microsoft que se ha configurado una cuenta de SaaS recién adquirida en el lado del publicador.
  • Flujo de actualización: cambio del plan adquirido o el número de puestos adquiridos, o ambos.
  • Suspender y restablecer el flujo: suspender la oferta de SaaS comprada en caso de que el método de pago del cliente ya no sea válido. La oferta suspendida se puede restablecer cuando se resuelve el problema con el método de pago.
  • Flujos de webhook: Microsoft enviará una notificación al editor sobre los cambios de suscripción de SaaS y la cancelación desencadenada por el cliente del lado de Microsoft.

Para la cancelación de la suscripción de SaaS adquirida, la integración es opcional porque la puede realizar el cliente del lado de Microsoft.

La integración correcta con las API de cumplimiento de SaaS es fundamental para asegurarse de que:

  • Microsoft factura correctamente a los clientes finales que compraron la oferta de SaaS del editor.
  • Los clientes finales reciben la experiencia de usuario correcta para comprar, configurar, usar y administrar las suscripciones de SaaS adquiridas en el Marketplace.

Estas API permiten a las ofertas del publicador participar en todos los canales habilitados para comercio:

  • Directo
  • Dirigido por asociados (revendedor, CSP)
  • Dirigido por campo

En el escenario de revendedor (CSP), un proveedor de servicios de cifrado adquiere la oferta de SaaS en nombre del cliente final. Se espera que un cliente use la oferta de SaaS, pero el CSP es la entidad que realiza las siguientes tareas:

  • Factura al cliente.
  • Cambia los planes de suscripción y la cantidad de puestos comprados.
  • Cancela las suscripciones.

El publicador no es necesario para implementar ninguno de los flujos de llamada API de forma diferente para este escenario.

Para más información acerca de CSP, consulte https://partner.microsoft.com/licensing.

Advertencia

La versión actual de esta API es la versión 2, que se debe usar para todas las nuevas ofertas de SaaS. La versión 1 de la API está en desuso y se mantiene para proporcionar soporte a las ofertas existentes.

Nota:

Las API de cumplimiento de SaaS solo están pensadas para ser llamadas desde un servicio back-end del publicador. No se admite la integración con las API directamente desde la página web del publicador. Solo se debe usar el flujo de autenticación de servicio a servicio.

Pasos siguientes

Tutoriales en vídeo