Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para a Nuvem Microsoft para o Governo dos EUA
Um parceiro faz um pedido quando um cliente deseja comprar uma assinatura de uma lista de ofertas.
Cart
Descreve um carrinho de compras.
| Propriedade | Tipo | Description |
|---|---|---|
| id | cadeia | Um identificador de carrinho fornecido após a criação bem-sucedida do carrinho. |
| creationTimeStamp | DateTime | A data em que o carrinho foi criado, no formato de data e hora. Aplicado após a criação bem-sucedida do carrinho. |
| lastModifiedTimeStamp | DateTime | A data em que o carrinho foi atualizado pela última vez, no formato de data e hora. Aplicado após a criação bem-sucedida do carrinho. |
| expirationTimeStamp | DateTime | A data em que o carrinho expira, no formato de data e hora. Aplicado após a criação bem-sucedida do carrinho. |
| lastModifiedUser | cadeia | O usuário que atualizou o carrinho pela última vez. Aplicado após a criação bem-sucedida do carrinho. |
| lineItems | Matriz de objetos | Uma matriz de recursos CartLineItem . |
| status | cadeia | A situação do carrinho. Os valores possíveis são "Ativo" (pode ser atualizado/enviado) e "Ordenado" (já foi enviado). |
CartLineItem
Representa um item contido em um carrinho.
| Propriedade | Tipo | Description |
|---|---|---|
| id | cadeia | Um identificador exclusivo para um item de linha do carrinho. Aplicado após a criação bem-sucedida do carrinho. |
| catalogItemId | cadeia | O identificador de item do catálogo. |
| friendlyName | cadeia | Optional. O nome amigável do item definido pelo parceiro para ajudar a desambiguar. |
| quantidade | int | O número de licenças ou instâncias. |
| código de moeda | cadeia | O código de moeda. |
| billingCycle | Object | O tipo de ciclo de faturamento definido para o período atual. |
| duração do prazo | cadeia | Uma representação ISO 8601 da duração do prazo. Os valores atuais com suporte são P1M (um mês), P1Y (um ano) e P3Y (três anos). |
| participants | Lista de pares de Cadeia de Caracteres de Objeto | Uma coleção de strings para o PartnerID no registro da compra. |
| provisioningContext | Cadeia de caracteres de dicionário<, cadeia de caracteres> | Contexto extra usado ao disponibilizar o item comprado. Para determinar quais valores são necessários para um item específico, consulte a propriedade provisioningVariables da SKU. |
| orderGroup | cadeia | Um grupo para indicar quais itens podem ser enviados juntos na mesma ordem. |
| Itens de adição | Lista de objetos CartLineItem | Uma coleção de itens do carrinho para addons. Esses itens são comprados para a assinatura base que resulta da compra do item de linha do carrinho raiz. |
| erro | Object | Aplicado após o carrinho ter sido criado se ocorreu um erro. |
| renewsTo | Matriz de objetos | Uma matriz de recursos RenewsTo . |
| AttestationAccepted | bool | Indica o contrato para oferecer ou condições de sku. Necessário apenas para ofertas ou skus em que SkuAttestationProperties ou OfferAttestationProperties enforceAttestation é True. |
| promotionId | cadeia | A ID da promoção que está prestes a ser aplicada ao item de linha do carrinho. |
| customTermEndDate | DateTime | A data de término do primeiro período de cobrança da nova assinatura. |
Participantes
Representa os revendedores do distribuidor que gerenciam a assinatura do cliente.
| Propriedade | Tipo | Description |
|---|---|---|
| transaction_reseller | cadeia | A ID do parceiro do revendedor que gerencia o cliente. |
| additional_transaction_reseller | cadeia | IDs adicionais de outros parceiros envolvidos na transação ou na gestão do cliente. Essa propriedade só é aplicável a distribuidores que operam nos mercados da UE/EFTA. |
Pricing
Representa os detalhes do preço. Os valores de preço são fornecidos antes da tributação.
| Propriedade | Tipo | Obrigatório | Description |
|---|---|---|---|
| listPrice | duplo | Não | Preço listado no catálogo sem modificadores de preços aplicados. |
| discountedPrice | duplo | Não | Preço depois de aplicar todo o modificador de preços aplicável. |
| preço proporcional | duplo | Não | Preço com desconto após a prorrogação. |
| price | duplo | Não | Preço na moeda de cobrança aplicável depois que todos os descontos são aplicados e a proração é executada. |
| preço estendido | duplo | Não | Preço do item com quantidade, descontos e prorrateio aplicados, na moeda de cobrança aplicável. |
RenewsTo
Representa um item contido em um item de linha do carrinho de compras.
| Propriedade | Tipo | Obrigatório | Description |
|---|---|---|---|
| duração do prazo | cadeia | Não | Uma representação ISO 8601 da duração do termo de renovação. Os valores atuais com suporte são P1M (um mês) e P1Y (um ano). |
ScheduledNextTermInstructions
Esta tabela descreve as propriedades scheduledNextTermInstructions para a renovação da oferta de avaliação baseada em licença (NCE) de novas experiências comerciais. Se nenhum valor for especificado, as avaliações serão renovadas em assinaturas pagas e renovarão para um prazo anual, cobrança mensal e 25 licenças.
| Propriedade | Tipo | Obrigatório | Description |
|---|---|---|---|
| produto | matriz | Não | Uma matriz que especifica a oferta em que uma assinatura de avaliação é renovada e o termo e a frequência de cobrança que a assinatura paga tem. |
| quantidade | int | Não | A quantidade de licença que a assinatura paga correspondente tem depois que a oferta de avaliação é renovada. |
Product
Esta tabela descreve as propriedades do productTerm para a renovação da oferta de avaliação baseada em licença NCE. Se nenhum valor for especificado nesse array, os períodos de teste serão renovados em assinaturas pagas com prazo anual e cobrança mensal.
| Propriedade | Tipo | Obrigatório | Description |
|---|---|---|---|
| ID do produto | cadeia | Não | Um GUID formatado para representar o produto da assinatura paga na qual a avaliação se renova. |
| skuId | cadeia | Não | Um GUID formatado para representar o SKU da assinatura paga na qual a avaliação é renovada. |
| availabilityId | cadeia | Não | Um GUID formatado para representar a disponibilidade da assinatura paga na qual a avaliação é renovada. |
| billingCycle | cadeia | Não | A frequência de cobrança que a assinatura paga correspondente tem depois que a oferta de avaliação é renovada. |
| duração do prazo | cadeia | Não | A duração do termo que a assinatura paga correspondente tem depois que a oferta de avaliação é renovada. |
Códigos de erro e êxito de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e mais informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros extras. Para obter a lista completa,consulte Códigos de erro do Partner Center.
CartError
Representa um erro que ocorre após a criação de um carrinho.
| Propriedade | Tipo | Description |
|---|---|---|
| código de erro | CartErrorCode | O tipo de erro do carrinho. |
| errorDescription | cadeia | A descrição do erro, incluindo anotações sobre valores com suporte, valores padrão ou limites. |
| Informações Adicionais | Informações adicionais | Mais informações sobre o erro. |
Informações Adicionais
Informações adicionais sobre o erro.
| Propriedade | Tipo | Description |
|---|---|---|
| quantidadeDisponível | int | O número de licenças restantes que podem ser adquiridas para a SKU de produto fornecida. |
| quantidadeComprada | int | O número de licenças que estão sendo compradas. |
CódigoDeErroDoCarrinho
Tipos de erros de carrinho de compras.
| Nome | ErrorCode | Description |
|---|---|---|
| MoedaNãoÉSuportada | 10000 | A moeda não tem suporte para determinado mercado |
| IdentificadorDoItemDeCatálogoNãoÉVálido | 10001 | A ID do item de catálogo não é válida |
| CotaNãoDisponível | 10002 | Cota insuficiente disponível |
| InventárioNãoDisponível | 10003 | O inventário não está disponível para a oferta selecionada |
| ParticipantesNãoSãoSuportadosParaParceiro | 10004 | Não há suporte para a configuração de participantes para o Partner |
| Não é possível processar o item da linha do carrinho | 10006 | Não é possível processar o item do carrinho. |
| AssinaturaNãoÉVálida | 10007 | A assinatura não é válida. |
| AssinaturaNãoEstáHabilitadaParaRI | 10008 | A assinatura não está habilitada para compras de reserva. |
| SandboxLimitExceeded (Limite de sandbox excedido) | 10009 | O limite do sandbox é excedido. |
| EntradaInválida | 10010 | A entrada genérica não é válida. |
| AssinaturaNãoRegistrada | 10011 | A assinatura não é válida. |
| AtestaçãoNãoAceita | 10012 | O atestado não foi aceito. |
| Número máximo de assentos permitidos por assinatura excedido | 10015 | O número solicitado de assentos excede o limite. |
| Unknown | 0 | Valor padrão |
ResultadoFinalizaçãoCarrinho
Representa o resultado de uma finalização de compra do carrinho.
| Propriedade | Tipo | Description |
|---|---|---|
| pedidos | Lista de objetos Order . | A coleta de pedidos. |
| errosDePedido | Lista de objetos OrderError . | A coleção de erros de pedidos. |
OrderError
Representa um erro que ocorre durante a finalização do carrinho de compras quando um pedido é criado.
| Propriedade | Tipo | Description |
|---|---|---|
| IdentificadorDoGrupoDePedido | cadeia | O ID do grupo de pedidos do pedido com o erro. |
| codificar | int | O código de erro. |
| descrição | cadeia | A descrição do erro. |