Recursos do carrinho
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.
Carrinho
Descreve um carrinho.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ID | string | Um identificador de carrinho que é fornecido após a criação bem-sucedida do carrinho. |
| criaçãoTimeStamp | DateTime | A data em que o carrinho foi criado, no formato data-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 data-hora. Aplicado após a criação bem-sucedida do carrinho. |
| expiraçãoTimeStamp | DateTime | A data em que o carrinho expirará, no formato data-hora. Aplicado após a criação bem-sucedida do carrinho. |
| lastModifiedUser | string | 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 . |
| estado | string | O status do carrinho. Os valores possíveis são "Ativo" (pode ser atualizado/enviado) e "Encomendado" (já foi enviado). |
CartLineItem
Representa um item contido em um carrinho.
| Propriedade | Tipo | Descrição |
|---|---|---|
| ID | string | Um identificador exclusivo para um item de linha do carrinho. Aplicado após a criação bem-sucedida do carrinho. |
| catalogItemId | string | O identificador de item de catálogo. |
| friendlyNome | string | Opcional. O nome amigável para o item definido pelo parceiro para ajudar a desambiguar. |
| quantidade | número inteiro | O número de licenças ou instâncias. |
| currencyCode | string | O código da moeda. |
| faturamentoCiclo | Objeto | O tipo de ciclo de faturamento definido para o período atual. |
| termoDuração | string | 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 PartnerID no registro na compra. |
| provisionamentoContexto | Cadeia de dicionário<, string> | Contexto adicional 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 | string | Um grupo para indicar quais itens podem ser enviados juntos na mesma ordem. |
| addonItems | Lista de objetos CartLineItem | Uma coleção de itens de linha de carrinho para addons. Esses itens serão comprados para a assinatura base que resulta da compra do item da linha do carrinho raiz. |
| error | Objeto | Aplicado após a criação do carrinho se ocorrer um erro. |
| renovarPara | Matriz de objetos | Uma matriz de recursos RenewsTo . |
| 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. |
| promotionId | string | O ID da promoção que está prestes a ser aplicado ao item de linha do carrinho. |
| customTermEndDate | DateTime | A data final do primeiro período de cobrança da nova assinatura. |
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 |
|---|---|---|---|
| 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 cobrança aplicável após todos os descontos terem sido aplicados e o rateio ter sido realizado. |
| extendedPreço | duplo | Não | Preço do item de linha com quantidade, descontos e rateio aplicado, na moeda de faturamento aplicável. |
RenovarPara
Representa um item contido em um item de linha de carrinho.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| 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 (um mês) e P1Y (um ano). |
Códigos de sucesso e erro de resposta
Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. 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 | Descrição |
|---|---|---|
| errorCode | CartErrorCode | O tipo de erro de carrinho. |
| errorDescription | string | A descrição do erro, incluindo quaisquer notas sobre valores suportados, valores padrão ou limites. |
| informações adicionais | Informação Adicional | Informações adicionais para o erro. |
Informação Adicional
Informações adicionais sobre o erro.
| Propriedade | Tipo | Descrição |
|---|---|---|
| disponívelQuantidade | número inteiro | O número de licenças restantes que podem ser compradas para o SKU de determinado produto. |
| compradoQuantidade | número inteiro | O número de licenças que estão sendo compradas. |
CartErrorCode
Tipos de erros de carrinho.
| Nome | CódigoDoErro | Descrição |
|---|---|---|
| CurrencyIsNotSupported | 10000 | A moeda não é suportada para determinado mercado |
| CatalogItemIdIsNotValid | 10001 | A ID do item de catálogo não é válida |
| QuotaNotAvailable | 10002 | Quota disponível insuficiente |
| InventárioNãoDisponível | 10003 | O inventário não está disponível para a oferta selecionada |
| ParticipantsIsNotSupportedForPartner | 10004 | A definição de participantes não é suportada pelo Parceiro |
| UnableToProcessCartLineItem | 10006 | Não é possível processar o item de linha do carrinho. |
| SubscriptionIsNotValid | 10007 | A subscrição não é válida. |
| SubscriptionIsNotEnabledForRI | 10008 | A subscrição não está ativada para compras de reservas. |
| SandboxLimitExceeded | 10000 | O limite da área restrita foi excedido. |
| InvalidInput | 10010 | A entrada genérica não é válida. |
| SubscriçãoNotRegistered | 10011 | A subscrição não é válida. |
| AtestadoNãoAceito | 10012 | O atestado não foi aceito. |
| MaxAllowedSeatsPerSubscriptionExceeded | 10015 | O número de lugares solicitado excede o limite. |
| Desconhecido | 0 | Default value |
CarrinhoCheckoutResultado
Representa o resultado de um checkout de carrinho.
| Propriedade | Tipo | Descrição |
|---|---|---|
| encomendas | Lista de objetos Order. | A recolha de encomendas. |
| orderErrors | Lista de objetos OrderError . | A coleção de erros de ordem. |
OrderError
Representa um erro que ocorre durante um checkout de carrinho quando um pedido é criado.
| Propriedade | Tipo | Descrição |
|---|---|---|
| orderGroupId | string | O ID do grupo de pedidos do pedido com o erro. |
| code | número inteiro | O código de erro. |
| descrição | string | A descrição do erro. |