Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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.
Carrinho
Descreve um carrinho.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ID | cadeia (de caracteres) | Um identificador de carrinho que é fornecido após a criação bem-sucedida do carrinho. |
| marcaTemporalDeCriação | Data/Hora | A data em que o carrinho foi criado, no formato data-hora. Aplicado após a criação bem-sucedida do carrinho. |
| CarimboDeHoraDaÚltimaModificação | Data/Hora | A data em que o carrinho foi atualizado pela última vez, no formato data-hora. Aplicado após a criação bem-sucedida do carrinho. |
| carimboDeHoraDeExpiração | Data/Hora | A data em que o carrinho expira, no formato de data e hora. Aplica-se após o carrinho ser criado com sucesso. |
| lastModifiedUser | cadeia (de caracteres) | O usuário que atualizou o carrinho pela última vez. Aplica-se após o carrinho ser criado com sucesso. |
| lineItems | Matriz de objetos | Uma matriz de recursos CartLineItem. |
| estado | cadeia (de caracteres) | O estado do carrinho. Os valores possíveis são "Ativo" (pode ser atualizado/submetido) e "Ordenado" (já foi submetido). |
ItemDoCarrinho
Representa um item contido em um carrinho.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ID | cadeia (de caracteres) | Um identificador exclusivo para um item na linha do carrinho. Aplica-se após o carrinho ser criado com sucesso. |
| Id do Item do Catálogo | cadeia (de caracteres) | O identificador do item de catálogo. |
| Nome Amigável | cadeia (de caracteres) | Opcional. O nome amigável do item definido pelo parceiro para ajudar na desambiguação. |
| Quantidade | Int | O número de licenças ou instâncias. |
| código de moeda | cadeia (de caracteres) | O código da moeda. |
| Ciclo de faturamento | Objeto | O tipo de ciclo de faturamento definido para o período atual. |
| duração do termo | cadeia (de caracteres) | Uma representação ISO 8601 da duração do termo. Os valores suportados atuais são P1M (um mês), P1Y (um ano) e P3Y (três anos). |
| Participantes | Lista de pares de Object String | Uma coleção de cadeias para o PartnerID registado na compra. |
| Contexto de Provisionamento | Dicionário<string, string> | Contexto extra usado ao provisionar o item comprado. Para determinar quais valores são necessários para um item específico, consulte a propriedade provisioningVariables da SKU. |
| orderGroup | cadeia (de caracteres) | Um grupo para indicar quais itens podem ser enviados juntos na mesma ordem. |
| itens adicionais | Lista de objetos CartLineItem | Uma coleção de itens de linha de carrinho para addons. Estes itens são adquiridos em direção à subscrição base resultante da compra da linha de carrinho raiz. |
| erro | Objeto | Aplicado após a criação do carrinho se ocorrer um erro. |
| renova para | Matriz de objetos | Uma matriz de recursos RenewsTo. |
| AtestadoAceito | Bool | Indica acordo para oferecer ou condições de código SKU. Obrigatório apenas para ofertas ou skus em que SkuAttestationProperties ou OfferAttestationProperties enforceAttestation é True. |
| promotionId | cadeia (de caracteres) | O ID da promoção que está prestes a ser aplicado ao item de linha do carrinho. |
| customTermEndDate | Data/Hora | A data final do primeiro período de cobrança da nova assinatura. |
Participants
Representa os revendedores do distribuidor que gerem a subscrição do cliente.
| Propriedade | Tipo | Descrição |
|---|---|---|
| transação_revendedor | cadeia (de caracteres) | O ID do parceiro do revendedor que gere o cliente. |
| revendedor_de_transação_adicional | cadeia (de caracteres) | IDs adicionais de outros parceiros envolvidos na transação ou na gestão do cliente. Esta propriedade é aplicável apenas a distribuidores que operem nos mercados UE/EFTA. |
Preços
Representa os detalhes do preço. Os valores dos preços são fornecidos antes da tributação.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| preço de lista | duplo | Não | Preço listado no catálogo sem quaisquer modificadores de preços aplicados. |
| preço com desconto | duplo | Não | Preço depois de aplicar todos os modificadores de preços aplicáveis. |
| preço proporcional | duplo | Não | Preço descontado após a realização da prorratação. |
| Preço | duplo | Não | Preço na moeda de faturação aplicável após todos os descontos terem sido aplicados e a prorratização efetuada. |
| preço total final | duplo | Não | Preço do item com quantidade, descontos e prorrata aplicados, na moeda de faturação aplicável. |
RenovarPara
Representa um item contido em uma linha de item do carrinho.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| duração do termo | cadeia (de caracteres) | Não | Uma representação ISO 8601 da duração do período de renovação. Os valores atuais suportados são P1M (um mês) e P1Y (um ano). |
ScheduledNextTermInstructions
Esta tabela descreve as propriedades de instruções do próximo termo agendado para a renovação de ofertas de teste baseadas em licença para novas experiências de comércio (NCE). Se não forem especificados valores, os testes são renovados para subscrições pagas e passam a um período anual, faturação mensal e 25 licenças.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| produto | matriz | Não | Um array que especifica a oferta em que uma subscrição de teste se renova e o período e a frequência de faturação que a subscrição paga possui. |
| Quantidade | Int | Não | A quantidade de licenças que a assinatura paga correspondente tem quando a oferta de teste for renovada. |
Produto
Esta tabela descreve as propriedades do productTerm para a renovação da oferta experimental baseada em licença NCE. Se não forem especificados valores neste arranjo, os testes renovam-se em subscrições pagas com faturação anual e mensal.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| productId | cadeia (de caracteres) | Não | Um GUID formatado para representar o produto da subscrição paga na qual o período experimental é convertido. |
| skuId | cadeia (de caracteres) | Não | Um GUID formatado para representar o SKU da subscrição paga para o qual o período experimental é renovado. |
| availabilityId | cadeia (de caracteres) | Não | Um GUID formatado para representar a disponibilidade da subscrição paga para a qual o período experimental se renova. |
| Ciclo de faturamento | cadeia (de caracteres) | Não | A frequência de faturação que a assinatura paga correspondente tem quando a oferta experimental é renovada. |
| duração do termo | cadeia (de caracteres) | Não | A duração da subscrição paga correspondente após a renovação da oferta de teste. |
Códigos de sucesso e erro de resposta
Cada resposta vem com um código de status HTTP que indica sucesso 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 consultar a lista completa, veja os códigos de erro do Partner Center .
CartError
Representa um erro que ocorre após a criação de um carrinho.
| Propriedade | Tipo | Descrição |
|---|---|---|
| código de erro | CartErrorCode | O tipo de erro de carrinho. |
| descriçãoDoErro | cadeia (de caracteres) | A descrição do erro, incluindo quaisquer notas sobre valores suportados, valores padrão ou limites. |
| informações adicionais | Informações Adicionais | Mais informações sobre o erro. |
Informação Adicional
Informações adicionais sobre o erro.
| Propriedade | Tipo | Descrição |
|---|---|---|
| quantidade disponível | Int | O número de licenças restantes que podem ser compradas para o SKU de determinado produto. |
| quantidadeComprada | Int | O número de licenças que estão sendo compradas. |
CartErrorCode
Tipos de erros de carrinho.
| Nome | Código de erro | Descrição |
|---|---|---|
| MoedaNãoÉSuportada | 10.000 | A moeda não é suportada para o mercado especificado |
| O ID do item de catálogo não é válido | 10001 | A ID do item de catálogo não é válida |
| QuotaNãoDisponível | 10002 | Quota disponível insuficiente |
| InventárioNãoDisponível | 10003 | O inventário não está disponível para a oferta selecionada |
| ParticipantesNãoSuportadosParaParceiro | 10004 | A definição de participantes não é suportada para Partner |
| Incapaz de Processar Item do Carrinho | 10006 | Não é possível processar o item de linha do carrinho. |
| AssinaturaNãoÉVálida | 10007 | A subscrição não é válida. |
| A subscrição não está ativada para RI | 10008 | A subscrição não está ativada para compras de reservas. |
| LimiteDaSandboxExcedido | 10009 | O limite de sandbox foi ultrapassado. |
| EntradaInválida | 10010 | A entrada genérica não é válida. |
| SubscriçãoNãoRegistada | 10011 | A subscrição não é válida. |
| Atestado Não Aceito | 10012 | A atestação não foi aceite. |
| Número Máximo de Lugares Permitidos por Subscrição Excedido | 10015 | O número de lugares solicitado excede o limite. |
| Desconhecido | 0 | Valor padrão |
Resultado da Finalização de Compra
Representa o resultado da finalização de compra do carrinho de compras.
| Propriedade | Tipo | Descrição |
|---|---|---|
| encomendas | Lista de objetos do Pedido . | A recolha de encomendas. |
| Erros de Pedido | Lista de objetos OrderError. | A coleção de erros de pedidos. |
Erro de Pedido
Representa um erro que ocorre durante um checkout de carrinho quando um pedido é criado.
| Propriedade | Tipo | Descrição |
|---|---|---|
| idGrupoDePedido | cadeia (de caracteres) | O ID do grupo de pedidos associados ao erro. |
| código | Int | O código de erro. |
| Descrição | cadeia (de caracteres) | A descrição do erro. |