Recursos do pedido
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. |
Links de pedido
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. |
OrderLineItemLinks
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: |
| 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. |