Criar uma assinatura para produtos do marketplace comercial

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

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

Pré-requisitos

• Credenciais de autenticação do Partner Center. Esse cenário dá 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 a ID 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:

• Product: um constructo de agrupamento para bens ou serviços adquiríveis. Um produto em si não é um item comprável.
• SKU: uma SKU (Unidade de Manutenção de Estoque) adquirível em um produto. AS SKUs representam as diferentes formas do produto.
• Disponibilidade: uma configuração na qual um 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 a SKU que você deseja comprar. Se você já conhece 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 para um produto
   • Obter um SKU usando a ID do SKU

   Nota

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

2. Se as SKUs forem marcadas com o pré-requisito InventoryCheck, verifique o inventário para uma SKU.

   Nota

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

3. Recupere a disponibilidade da 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

1. Criar um carrinho para manter a coleção de itens de catálogo que você pretende comprar. Quando você cria um carrinho , os itens do carrinho são agrupados automaticamente com base no que pode ser comprado em conjunto 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 a 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 do cliente.

Obter link de ativação

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

Gerenciamento do ciclo de vida

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

• Cancelar uma assinatura do marketplace comercial
• Habilitar ou desabilitar o autorenew para uma assinatura do marketplace comercial

Gerenciamento de quantidade

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

• Alterar a quantidade de uma assinatura

Fatura e reconciliação

Você pode gerenciar faturas do cliente (incluindo encargos de assinaturas para produtos do marketplace comercial) usando os seguintes métodos:

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

Ambiente de área restrita

Para obter diretrizes sobre a área restrita do Marketplace, consulte Testar e depurar com sua área restrita de integração do Partner Center.