Criar uma subscrição para produtos comerciais do marketplace

  • Artigo

Você pode criar uma assinatura para produtos comerciais do marketplace usando APIs do Partner Center. Você deve obter uma lista de ofertas para um mercado, criar e enviar um pedido para uma assinatura de mercado comercial e, em seguida, recuperar um link de ativação.

Você também pode executar o gerenciamento do ciclo de vida e gerenciar faturas para essas assinaturas .

Pré-requisitos

  • Credenciais de autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
  • O identificador do cliente. Se você não tiver um identificador de cliente, siga as etapas em Obter uma lista de clientes. Como alternativa, entre no Partner Center, escolha o cliente na lista de clientes, selecione Conta e salve sua ID da Microsoft.

Obter uma lista de ofertas para um mercado

Você pode verificar as ofertas disponíveis para um mercado usando os seguintes modelos de API do Partner Center:

  • Produto: Uma construção de agrupamento para bens ou serviços que podem ser comprados. Um produto em si não é um item comprável.
  • SKU: Uma unidade de manutenção de estoque (SKU) comprável sob um produto. Estes representam as diferentes formas do produto.
  • Disponibilidade: uma configuração na qual uma SKU está disponível para compra (como país/região, moeda ou segmento de setor).

Antes de comprar uma reserva do Azure, conclua as seguintes etapas:

  1. Identifique e recupere o produto e o SKU que deseja comprar. Se você já souber a ID do produto e a ID da SKU, selecione-as.

    Nota

    Você pode identificar produtos de marketplace comercial por sua propriedade ProductType de "Azure" e sua propriedade SubType de "SaaS".

  2. Se as SKUs estiverem marcadas com um pré-requisito InventoryCheck , verifique se há uma SKU no inventário.

    Nota

    No momento, não há produtos de mercado comercial que suportem a verificação de estoque ou sejam marcados com um pré-requisito InventoryCheck .

  3. Recupere a disponibilidade para o SKU. Você precisará do CatalogItemId da disponibilidade ao fazer o pedido, que pode ser recuperado por meio das seguintes APIs:

Criar e enviar uma encomenda

Para enviar seu pedido de reserva do Azure, siga estas etapas:

  1. Crie um carrinho para armazenar a coleção de itens do catálogo que você pretende comprar. Quando você cria um carrinho, os itens da linha do carrinho são automaticamente agrupados com base no que pode ser comprado juntos na mesma ordem. (Você também pode atualizar um carrinho.)
  2. Confira o carrinho, que resulta na criação de um pedido.

Obter detalhes da encomenda

Você pode recuperar os detalhes de um pedido individual usando o ID do pedido. Você também pode recuperar uma lista de todos os pedidos de um cliente específico.

Nota

Depois que um pedido é enviado, há um atraso de até 15 minutos antes que o pedido apareça na lista de pedidos desse cliente.

O parceiro ou cliente tem de ativar subscrições para produtos do Azure Marketplace. Você pode obter um link de ativação por item de linha de ordem. Você também pode obter uma assinatura por ID e, em seguida, enumerar sua propriedade Links para criar um link de ativação.

Gestão do ciclo de vida

Você pode gerenciar o ciclo de vida de suas assinaturas de produtos comerciais do marketplace usando os seguintes métodos:

Gestão quantitativa

A quantidade de uma assinatura de mercado comercial deve estar dentro dos limites definidos por sua SKU associada (consulte os atributos minimumQuantity e maximumQuant). Para atualizar a quantidade de uma assinatura de mercado comercial, use o seguinte método:

Fatura e conciliação

Você pode gerenciar faturas de clientes (incluindo cobranças por assinaturas de produtos comerciais do marketplace) usando os seguintes métodos:

Teste usando a conta de área restrita de integração

Na produção, depois de criar uma assinatura para produtos SaaS do mercado comercial, você precisa recuperar um link de ativação personalizado do Partner Center e visitar o site do editor para concluir o processo de configuração. A cobrança da assinatura começará somente após a conclusão da configuração.

No ambiente de sandbox CSP, não há integração com ISVs. Se você tentar recuperar um link de ativação do Partner Center, um link fictício será retornado. Não é possível usar este link fictício para concluir o processo de configuração no site do editor. Para usar a conta sandbox de integração para testar a cobrança de assinaturas de produtos SaaS do marketplace comercial, use o seguinte método para ativar a assinatura. A cobrança da assinatura começará após a ativação bem-sucedida: