Criar uma assinatura para produtos comerciais do marketplace

Você pode criar uma assinatura para produtos do Marketplace comercial usando as 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. Esse 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 o identificador de um 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 compráveis. 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 do setor).

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

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

   • Obter uma lista de produtos
   • Obter um produto usando a ID do produto
   • Obter uma lista de SKUs de um produto
   • Obter uma SKU usando a ID da SKU

   Observação

   Você pode identificar produtos comerciais do marketplace pela propriedade ProductType de "Azure" e pela propriedade SubType de "SaaS".

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

   Observação

   No momento, não há produtos comerciais do marketplace que ofereçam suporte à verificação de estoque ou sejam marcados com um pré-requisito do InventoryCheck .

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

   • Obter uma lista de disponibilidades de um SKU
   • Obter uma disponibilidade usando a ID de disponibilidade

Criar e enviar um pedido

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

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

Obter detalhes do pedido

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.

Observação

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

Obter link de ativação

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

Gerenciamento do ciclo de vida

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

• Cancelar uma assinatura do marketplace comercial
• Habilitar ou desabilitar a renovação automática para uma assinatura comercial do marketplace

Gerenciamento de quantidade

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

• Alterar a quantidade de uma assinatura

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:

• Obter os itens de linha de consumo do marketplace comercial cobrados na fatura
• Obter os links de estimativa de fatura
• Obter os itens de linha de consumo do marketplace comercial não cobrados na fatura
• Obter itens de linha de reconciliação não faturados de fatura

Testar 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 instalação.

No ambiente de área restrita do 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 esse link fictício para concluir o processo de configuração no site do editor. Para usar a conta de área restrita de integração para testar a cobrança de assinaturas de produtos SaaS do marketplace comercial, use o método a seguir para ativar a assinatura. A cobrança da assinatura começará após a ativação bem-sucedida:

• Ativar uma assinatura de área restrita para produtos do marketplace comercial