Recursos do pedido

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Um parceiro faz um pedido quando um cliente deseja comprar uma assinatura de uma lista de ofertas.

Observação

O recurso Order tem um limite de taxa de 500 solicitações por minuto por identificador de locatário.

Pedido

Descreve o pedido de um parceiro.

Propriedade Type Descrição
id string Um identificador de pedido que é fornecido após a criação bem-sucedida do pedido.
alternateId string Um identificador amigável para o pedido.
referenceCustomerId string O identificador do cliente.
billingCycle string Indica a frequência com que o parceiro é cobrado por esse pedido. Os valores suportados são os nomes de membros encontrados em BillingCycleType. O padrão é Mensal ou Único na criação do pedido. Este campo é aplicado após a criação bem-sucedida do pedido.
transactionType string Somente leitura. O tipo de transação da ordem. Os valores com suporte são UserPurchase, SystemPurchase ou SystemBilling
lineItems matriz de recursos OrderLineItem Uma lista detalhada das ofertas que o cliente está comprando, incluindo a quantidade.
currencyCode string Somente leitura. A moeda usada ao fazer o pedido. Aplicado após a criação bem-sucedida do pedido.
moedaSímbolo string Somente leitura. O símbolo de moeda associado ao código de moeda.
creationDate datetime Somente leitura. A data em que o pedido foi criado, no formato de data e hora. Aplicado após a criação bem-sucedida do pedido.
status string Somente leitura. O status do pedido. Os valores com suporte são os nomes de membros encontrados em OrderStatus.
links Links de pedido Os links de recursos correspondentes ao Pedido.
attributes Atributos de recursos Os atributos de metadados correspondentes ao Pedido.

OrderLineItem

Um pedido contém uma lista detalhada de ofertas e cada item é representado como um OrderLineItem.

Propriedade Type Descrição
lineItemNumber int Cada item de linha na coleção recebe um número de linha exclusivo, contando de 0 para count-1.
offerId string O ID da oferta.
subscriptionId string A ID da assinatura.
parentSubscriptionId string Opcional. O ID da assinatura pai em uma oferta complementar. Aplica-se somente ao PATCH.
friendlyName string Opcional. O nome amigável da assinatura definido pelo parceiro para ajudar a desambiguar.
quantity int O número de licenças ou instâncias.
customTermEndDate Datetime A data de término do primeiro período de cobrança da nova assinatura.
termDuration string Uma representação ISO 8601 da duração do prazo. Os valores atuais suportados são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).
transactionType string Somente leitura. O tipo de transação do item de linha. Os valores com suporte são new, renew, addQuantity, removeQuantity, cancel, convert ou customerCredit.
partnerIdOnRecord string Quando um provedor indireto fizer um pedido em nome de um revendedor indireto, preencha esse campo apenas com o PartnerID do revendedor indireto (nunca a ID do provedor indireto). Isso garante a contabilidade adequada para incentivos.
provisioningContext Contexto de provisionamento Informações necessárias para o provisionamento de alguns itens no catálogo. A propriedade provisioningVariables em um SKU indica quais propriedades são necessárias para itens específicos no catálogo.
links OrderLineItemLinks Somente leitura. Os links de recurso correspondentes ao item de linha da ordem.
renovarPara Renovar Detalhes da duração do período de renovação.
AtestadoAceito bool Indica o acordo para oferecer ou sku condições. Necessário apenas para ofertas ou SKUs em que SkuAttestationProperties ou OfferAttestationProperties enforceAttestation é True.
Preços Preços Detalhes do preço de tabela.
purchaseCommitment Compromisso de compra O valor fixo comprometido em serviços de computação.

Renovar

Representa os detalhes da duração do prazo de renovação.

Propriedade Type Obrigatória Descrição
termDuration string Não Uma representação ISO 8601 da duração do prazo de renovação. Os valores atuais com suporte são P1M (1 mês) e P1Y (1 ano).

Preços

Representa os detalhes do preço. Os valores dos preços são fornecidos antes dos impostos.

Propriedade Type Obrigatória Descrição
listPreço double Não Preço listado no catálogo sem nenhum modificador de preço aplicado.
preço com desconto double Não Preço após aplicar todos os modificadores de preços aplicáveis.
preço rateado double Não Preço com desconto após a execução do rateio.
price duplo Não Preço na moeda de cobrança aplicável depois que todos os descontos forem aplicados e o rateio for executado.
preço estendido double Não Preço do item de linha com quantidade, descontos e rateio aplicados, na moeda de faturamento aplicável.

Representa os links de recursos correspondentes ao pedido.

Propriedade Type Descrição
provisioningStatus Link Quando preenchido, o link para recuperar o status de provisionamento da ordem.
self Link O link para recuperar o recurso de pedido.

Representa a assinatura completa associada ao pedido.

Propriedade Type Descrição
provisioningStatus Link Quando preenchido, o link para recuperar o status de provisionamento do item de linha.
sku Link O link para recuperar informações de SKU para o item de catálogo comprado.
subscription Link Quando preenchido, o link para as informações completas da assinatura.
ativaçãoLinks Link Quando preenchido, o recurso GET para links para ativar a assinatura.

OrderStatus

Um [Enum/dotnet/api/system.enum) com valores que indicam o estado do pedido.

Valor Posição Descrição
unknown 0 Inicializador de enumeração.
concluído 1 O pedido está concluído.
pending 2 O pedido está sendo processado.
cancelled 3 O pedido é cancelado.
suspenso 4 A ordem está suspensa. Para saber mais, confira: <bpt xmlns="urn:oasis:names:tc:xliff:document:1.2" id="1">&lt;a href="../subscription-lifecycle" data-linktype="relative-path"&gt;</bpt>Estados do ciclo de vida da assinatura – NCE suspensa<ept xmlns="urn:oasis:names:tc:xliff:document:1.2" id="1">&lt;/a&gt;</ept>.
revisão pendente 5 A ordem está pendente de revisão secundária. Os parceiros podem ser solicitados a fazer upload da documentação. Consulte Apresentação de treinamento de revisão de negócios secundários para saber o que esperar se você for selecionado para uma revisão de negócios secundária.
upload de pedido de compra pendente 6 O parceiro deve carregar sua Ordem de Compra do Cliente e inserir detalhes conforme descrito para revisão pela Microsoft.
upload de po concluído 7 A ordem de compra (PO) foi enviada pelo parceiro e a Microsoft está revisando. Nenhuma ação adicional é exigida pelo parceiro.
Revisão de PO rejeitada 8 Este pedido não passou na revisão secundária e não será processado.
Sucesso parcial 9 Uma ou mais assinaturas no pedido têm um problema. Os parceiros devem recomprar assinaturas não atendidas.
error 10 A ordem resultou em um erro. Os parceiros devem recomprar.

OrderLineItemProvisioningStatus

Representa o status de provisionamento de um OrderLineItem.

Propriedade Type Descrição
lineItemNumber int O número de linha exclusivo do item de linha da ordem. Os valores variam de 0 a count-1.
status string O status de provisionamento do item de linha da ordem. Os valores incluem:
Processado: o processamento do pedido foi concluído com sucesso e o usuário poderá usar as reservas
Não processado: não processado devido ao cancelamento
PrefulfillmentPending: sua solicitação ainda está sendo processada, o processamento ainda não foi concluído
quantityProvisioningInformation Listar<QuantityProvisioningStatus> Uma lista de informações de status de provisionamento de quantidade para o item de linha da ordem.

QuantityProvisioningStatus

Representa o status de provisionamento por quantidade.

Propriedade Type Descrição
quantity int O número de itens.
status string O status do número de itens.

Contexto de provisionamento

Informações necessárias para o provisionamento de alguns itens no catálogo. A propriedade provisioningVariables em um SKU indica quais propriedades são necessárias para itens específicos no catálogo.

Propriedade Type Descrição
scope string O tipo de escopo de uma compra que indica onde os benefícios se aplicam: Individual, Compartilhado.
entitlementId string A ID da assinatura do Azure que seria usada para uma compra. Necessário para escopo único.

Compromisso de compra

O valor fixo comprometido em serviços de computação.

Propriedade Type Descrição
valor int O compromisso de valor fixo.
moeda string A moeda do compromisso.
grão string O período do compromisso.