Compartir vía

API de suministro de SaaS en el marketplace comercial de Microsoft

  • Artículo

Las API de suministro de SaaS permiten a los publicadores, también conocidos como proveedores de software independientes (ISV), publicar y vender sus aplicaciones SaaS en Microsoft AppSource, Azure Marketplace y Azure Portal. Estas API permiten que las aplicaciones ISV participen en todos los canales habilitados para el comercio: directo, dirigido por asociados (revendedor) y dirigidos por campo. La integración con estas API es un requisito para crear y publicar una oferta de SaaS transaccionable en el Centro de partners.

Para obtener información sobre las API de suministro de SaaS, le recomendamos que lea 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 los ISV y Microsoft:

  • flujo de página de aterrizaje: Microsoft notifica al publicador que la oferta de SaaS del publicador fue adquirida por un cliente en Marketplace.
  • Flujo de activación: el publicador notifica a Microsoft que se ha configurado una cuenta SaaS recién comprada en la parte del publicador.
  • Flujo de actualización: cambio del plan comprado o el número de puestos comprados, 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 notifica al publicador los cambios de suscripción de SaaS y la cancelación desencadenada por el cliente desde el lado de Microsoft.

Para la cancelación de la suscripción de SaaS comprada, la integración es opcional, ya que el cliente puede hacerlo desde Microsoft.

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

  • Microsoft factura correctamente a los clientes finales que compraron la oferta de SaaS del publicador.
  • Los clientes finales obtienen la experiencia de usuario correcta comprando, configurando, usando y administrando suscripciones de SaaS adquiridas en Marketplace.

Estas API permiten que las ofertas del publicador participen en todos los canales habilitados para el comercio:

  • Directo
  • Dirigido por asociados (revendedor, Proveedor de soluciones en la nube [CSP])
  • Liderado por el campo

En el escenario de revendedor (CSP), un CSP compra 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 tareas siguientes:

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

El publicador no está obligado a implementar ninguno de los flujos de llamadas de la API de forma diferente para este escenario.

Para más información, veaProveedor de soluciones en la nube (CSP).

Importante

Las APIs de cumplimiento de SaaS versión 1 se han obsoleto; en su lugar, use la versión 2. La versión 1 se mantiene actualmente solo para atender a los publicadores existentes y la documentación de V1 ya no está disponible. Si cree que necesita acceder a él, puede enviar un correo electrónico saas-api-v1@microsoft.com.

Nota

Las API de suministro de SaaS solo están diseñadas para llamarse 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.

Contenido relacionado

Tutoriales en vídeo