Criar uma assinatura para produtos do Marketplace comercialCreate a subscription for commercial marketplace products

Aplica-se a:Applies to:

  • Partner CenterPartner Center

Você pode criar uma assinatura para produtos do Marketplace comercial usando as APIs do Partner Center.You can create a subscription for commercial marketplace products using Partner Center APIs. Você deve obter uma lista de ofertas para um mercado, criar e enviar um pedido para uma assinatura do Marketplace comercial e, em seguida, recuperar um link de ativação.You must get a list of offers for a market, create and submit an order for a commercial marketplace subscription, then retrieve an activation link.

Você também pode executar o gerenciamento do ciclo de vida e gerenciar faturas para essas assinaturas.You can also perform lifecycle management and manage invoices for these subscriptions.

Pré-requisitosPrerequisites

  • Credenciais de autenticação do Partner Center .Partner Center authentication credentials. Esse cenário dá suporte à autenticação com aplicativos autônomos e aplicativos + credenciais de usuário.This scenario supports authentication with both standalone App and App+User credentials.
  • O identificador do cliente.The customer identifier. Se você não tiver o identificador de um cliente, siga as etapas em obter uma lista de clientes.If you don't have a customer's identifier, follow the steps in Get a list of customers. Como alternativa, entre no Partner Center, escolha o cliente na lista de clientes, selecione contae, em seguida, salve sua ID da Microsoft.Alternatively, sign in to Partner Center, choose the customer from the list of customers, select Account, then save their Microsoft ID.

Obter uma lista de ofertas de um mercadoGet a list of offers for a market

Você pode verificar as ofertas disponíveis para um mercado usando os seguintes modelos de API do Partner Center:You can check the available offers for a market using the following Partner Center API models:

  • Produto: uma construção de agrupamento para bens ou serviços compráveiss.Product: A grouping construct for purchasable goods or services. Um produto em si não é um item compráveis.A product itself isn't a purchasable item.
  • SKU: uma SKU (unidade de manutenção de estoque) compráveis em um produto.SKU: A purchasable Stock Keeping Unit (SKU) under a product. Elas representam as diferentes formas do produto.These represent the different shapes of the product.
  • Disponibilidade: uma configuração na qual um SKU está disponível para compra (como país, moeda ou segmento do setor).Availability: A configuration in which a SKU is available for purchase (such as country, currency, or industry segment).

Antes de comprar uma reserva do Azure, conclua as seguintes etapas:Before you purchase an Azure reservation, complete the following steps:

  1. Identifique e recupere o produto e a SKU que você deseja comprar.Identify and retrieve the product and SKU that you want to purchase. Se você já souber a ID do produto e a ID do SKU, selecione-as.If you already know the Product ID and SKU ID, select them.

    Observação

    Você pode identificar os produtos do Marketplace comercial por sua propriedade ProductType do "Azure" e sua propriedade subtipo de "Saas".You can identify commercial marketplace products by their ProductType property of "Azure" and their SubType property of "SaaS".

  2. Se as SKUs forem marcadas com um pré-requisito InventoryCheck , Verifique o inventário de uma SKU.If the SKUs are tagged with an InventoryCheck prerequisite, check the inventory for a SKU.

    Observação

    Neste momento, não há produtos do Marketplace comercial que dão suporte à verificação de inventário ou marcados com um pré-requisito InventoryCheck .At this time, there are no commercial marketplace products that support inventory check or are tagged with an InventoryCheck prerequisite.

  3. Recupere a disponibilidade para a SKU.Retrieve the availability for the SKU. Você precisará do CatalogItemId da disponibilidade ao fazer o pedido, que pode ser recuperado por meio das seguintes APIs:You will need the CatalogItemId of the availability when placing the order, which you can retrieve through the following APIs:

Criar e enviar um pedidoCreate and submit an order

Para enviar seu pedido de reserva do Azure, siga estas etapas:To submit your Azure reservation order, follow these steps:

  1. Crie um carrinho para manter a coleção de itens de catálogo que você pretende comprar.Create a cart to hold the collection of catalog items that you intend to buy. Quando você cria um carrinho, os itens de linha do carrinho são automaticamente agrupados com base no que pode ser adquirido juntos na mesma ordem.When you create a cart, the cart line items are automatically grouped based on what can be purchased together in the same order. (Você também pode atualizar um carrinho.)(You can also update a cart.)
  2. Confira o carrinho, que resulta na criação de um pedido.Check out the cart, which results in the creation of an order.

Obter detalhes do pedidoGet order details

Você pode recuperar os detalhes de uma ordem individual usando a ID do pedido.You can retrieve the details of an individual order using the order ID. Você também pode recuperar uma lista de todos os pedidos de um cliente específico.You can also retrieve a list of all orders for a specific customer.

Observação

Depois que um pedido é enviado, há um atraso de até 15 minutos antes que a ordem seja exibida na lista de pedidos do cliente.After an order is submitted, there is a delay of up to 15 minutes before the order appears in that customer's order list.

O parceiro ou cliente deve ativar assinaturas para produtos do Azure Marketplace.The partner or customer must activate subscriptions to Azure Marketplace products. Você pode obter um link de ativação por item de linha de pedido.You can get an activation link by order line item. Você também pode obter uma assinatura por IDe, em seguida, enumerar sua propriedade links para criar um link de ativação.You can also get a subscription by ID, then enumerate its Links property to create an activation link.

Gerenciamento do ciclo de vidaLifecycle management

Você pode gerenciar o ciclo de vida de suas assinaturas para produtos do Marketplace comercial usando os seguintes métodos:You can manage the lifecycle of your subscriptions to commercial marketplace products using the following methods:

Gerenciamento de quantidadeQuantity management

A quantidade de uma assinatura do Marketplace comercial deve estar dentro dos limites definidos por seu SKU associado (consulte os atributos minimumQuantity e maximumQuantity ).The quantity of a commercial marketplace subscription must be within the limits defined by its associated SKU (see the minimumQuantity and maximumQuantity attributes). Para atualizar a quantidade de uma assinatura do Marketplace comercial, use o seguinte método:To update the quantity of a commercial marketplace subscription, use the following method:

Fatura e reconciliaçãoInvoice and reconciliation

Você pode gerenciar faturas de clientes (incluindo encargos de assinaturas para produtos do Marketplace comercial) usando os seguintes métodos:You can manage customer invoices (including charges for subscriptions to commercial marketplace products) using the following methods:

Testar usando a conta da área restrita da integraçãoTest using integration sandbox account

Em produção, depois de criar uma assinatura para produtos SaaS do Marketplace comercial, você precisará recuperar um link de ativação personalizado do Partner Center e visitar o site do editor para concluir o processo de instalação.In production, after you have created a subscription to commercial marketplace SaaS products, you need to retrieve a personalized activation link from Partner Center and visit the publisher's site to complete the setup process. A cobrança da assinatura será iniciada somente após a conclusão da instalação.Subscription billing will begin only after setup is complete.

No ambiente de área restrita do CSP, não há integração com ISVs.In the CSP sandbox environment, there is no integration with ISVs. Se você tentar recuperar um link de ativação do Partner Center, um link fictício será retornado.If you try to retrieve an activation link from Partner Center, a dummy link will be returned. Você não pode usar esse link fictício para concluir o processo de instalação no site do Publicador.You cannot use this dummy link to complete the setup process at the publisher's site. Para usar a conta da área restrita da integração para testar a cobrança de assinaturas para produtos SaaS do Marketplace comercial, use o método a seguir para ativar a assinatura em vez disso.To use the integration sandbox account to test billing for subscriptions to commercial marketplace SaaS products, use the following method to activate the subscription instead. A cobrança da assinatura será iniciada após a ativação bem-sucedida:Subscription billing will begin after successful activation: