Encomendar recursos

  • Artigo

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

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

Nota

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

Ordenar

Descreve a ordem 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.
faturamentoCiclo string Indica a frequência com que o parceiro é cobrado por este pedido. Os valores suportados são os nomes de membros encontrados em BillingCycleType. O padrão é Monthly ou OneTime na criação do pedido. Este campo é aplicado após a criação bem-sucedida da ordem.
Tipo de transação string Só de Leitura. O tipo de transação da ordem. Os valores suportados 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 Só de Leitura. A moeda usada ao fazer o pedido. Aplicado após a criação bem-sucedida da ordem.
currencySymbol string Só de Leitura. O símbolo de moeda associado ao código da moeda.
criaçãoData de criação datetime Só de Leitura. A data em que a ordem foi criada, no formato data-hora. Aplicado após a criação bem-sucedida da ordem.
estado string Só de Leitura. O status do pedido. Os valores suportados são os nomes de membros encontrados em OrderStatus.
ligações OrderLinks Os links de recursos correspondentes à Ordem.
atributos ResourceAttributes Os atributos de metadados correspondentes à Ordem.

OrderLineItem

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

Propriedade Type Description
lineItemNumber número inteiro Cada item de linha na coleção recebe um número de linha exclusivo, contando de 0 a contagem-1.
offerId string O ID da oferta.
subscriptionId cadeia O ID da assinatura.
parentSubscriptionId string Opcional. A ID da assinatura pai em uma oferta de complemento. Aplica-se apenas ao PATCH.
friendlyNome string Opcional. O nome amigável para a assinatura definido pelo parceiro para ajudar a desambiguar.
quantidade número inteiro O número de licenças ou instâncias.
customTermEndDate DateTime A data final do primeiro período de cobrança da nova assinatura.
termoDuração string Uma representação ISO 8601 da duração do termo. Os valores suportados atuais são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).
Tipo de transação string Só de Leitura. O tipo de transação do item de linha. Os valores suportados são new, renew, addQuantity, removeQuantity, cancel, convert ou customerCredit.
parceiroIdOnRecord string Quando um fornecedor indireto fizer uma encomenda em nome de um revendedor indireto, preencha este campo apenas com o ID do parceiro do revendedor indireto ( nunca o ID do fornecedor indireto). Isto garante uma contabilização adequada dos incentivos.
provisionamentoContexto ProvisionamentoContexto Informações necessárias para o provisionamento de alguns itens no catálogo. A propriedade provisioningVariables em uma SKU indica quais propriedades são necessárias para itens específicos no catálogo.
ligações OrderLineItemLinks Só de Leitura. Os links de recursos correspondentes ao item de linha da ordem.
renovarPara RenovarPara Detalhes da duração do prazo de renovação.
AtestadoAceito booleano Indica acordo para oferecer ou condições de sku. Obrigatório apenas para ofertas ou skus em que SkuAttestationProperties ou OfferAttestationProperties enforceAttestation é True.
Preços Preços Detalhes do preço de tabela.
compraCompromisso CompraCompromisso O montante fixo comprometido em serviços de computação.

RenovarPara

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

Propriedade Type Obrigatório Description
termoDuração string Não Uma representação ISO 8601 da duração do período de renovação. Os valores atuais suportados 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 da tributação.

Propriedade Type Obrigatório Description
listaPreço duplo Não Preço listado no catálogo sem quaisquer modificadores de preços aplicados.
descontadoPreço duplo Não Preço depois de aplicar todos os modificadores de preços aplicáveis.
rateadoPreço duplo Não Preço com desconto após a realização do rateio.
preço duplo Não Preço na moeda de faturamento aplicável após todos os descontos serem aplicados e o rateio ser realizado.
extendedPreço duplo Não Preço do item de linha com quantidade, descontos e rateio aplicado, na moeda de faturamento aplicável.

Representa os links de recursos correspondentes à ordem.

Propriedade Type Description
provisionamentoStatus Ligação Quando preenchido, o link para recuperar o status de provisionamento para o pedido.
Eu mesmo Ligação O link para recuperar o recurso de pedido.

Representa a assinatura completa associada ao pedido.

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

Estado da Encomenda

Um [Enum/dotnet/api/system.enum] com valores que indicam o estado da ordem.

valor Position Description
desconhecido 0 Inicializador de enum.
concluída 5 A encomenda está concluída.
pendente 2 A encomenda está a ser processada.
cancelado 3 A encomenda é cancelada.
suspenso 4 A ordem está suspensa. Para saber mais, consulte: Estados do ciclo de vida da assinatura - NCE suspenso.
Revisão pendente 5 O despacho está pendente de revisão secundária. Os parceiros podem ser obrigados a carregar documentação. Consulte Apresentação de treinamento de revisão de negócio secundário para saber o que esperar se você for selecionado para uma revisão de negócio secundário.
Carregamento PO pendente 6 O parceiro deve carregar a Ordem de Compra do Cliente e inserir os detalhes conforme descrito na Microsoft para análise.
PO Upload Concluído 7 A ordem de compra (PO) foi enviada pelo parceiro e a Microsoft está analisando. Nenhuma outra ação exigida pelo parceiro.
Revisão PO rejeitada 8 Esta ordem não passou na revisão secundária e não será processada.
sucesso parcial 9 Uma ou mais assinaturas na ordem têm um problema. Os parceiros devem recomprar subscrições não satisfeitas.
error 10 A ordem resultou em um erro. Os parceiros devem recomprar.

OrderLineItemProvisioningStatus

Representa o status de provisionamento de um OrderLineItem.

Propriedade Type Description
lineItemNumber número inteiro O número de linha exclusivo do item de linha do pedido. Os valores variam de 0 a count-1.
estado string O status de provisionamento do item de linha do pedido. Os valores incluem:Cumprido: O cumprimento da encomenda é concluído com sucesso e o utilizador poderá utilizar as reservas
Não cumpridas: Não cumpridas devido a cancelamento
Pré-cumprimentoPendente:
 O seu pedido ainda está a ser processado, o cumprimento ainda não está concluído
quantidadeProvisionamentoInformações Lista<QuantidadeProvisionamentoStatus> Uma lista de informações de status de provisionamento de quantidade para o item de linha do pedido.

QuantityProvisioningStatus

Representa o status de provisionamento por quantidade.

Propriedade Type Description
quantidade número inteiro O número de itens.
estado string O status do número de itens.

ProvisionamentoContexto

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

Propriedade Type Description
âmbito string O tipo de escopo para uma compra que indica onde os benefícios se aplicam: Único, Compartilhado.
entitlementId string A ID da assinatura do Azure que seria usada para uma compra. Necessário para escopo único.

CompraCompromisso

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

Propriedade Type Description
montante número inteiro O compromisso de montante fixo.
moeda string A moeda do compromisso.
cereais string O período do compromisso.