Recursos do carrinho

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.

Carrinho

Descreve um carrinho.

Propriedade	Type	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.
expirationTimeStamp	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.
status	string	O status do carrinho. Os valores possíveis são "Ativo" (pode ser atualizado/enviado) e "Pedido" (já foi enviado).

CartLineItem

Representa um item contido em um carrinho.

Propriedade	Type	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.
friendlyName	string	Opcional. O nome amigável para o item definido pelo parceiro para ajudar a desambiguar.
quantity	INT	O número de licenças ou instâncias.
currencyCode	string	O código da moeda.
billingCycle	Objeto	O tipo de ciclo de faturamento definido para o período atual.
prazoDuração	string	Uma representação ISO 8601 da duração do termo. Os valores atuais suportados 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 PartnerID no registro na compra.
provisionamentoContexto	Cadeia de caracteres do dicionário<, cadeia de caracteres>	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 de 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 RenewTo.
AtestadoAceito	bool	Indica concordância com as condições de oferta ou sku. Necessá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 de término 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	Type	Obrigatório	Descrição
listPrice	double	Não	Preço listado no catálogo sem nenhum modificador de preço aplicado.
descontoPreço com desconto	double	Não	Preço após a aplicação de todo o modificador de preços aplicável.
Preço rateado	double	Não	Preço descontado após a realização do rateio.
price	duplo	Não	Preço na moeda de faturamento aplicável após todos os descontos terem sido aplicados e o rateio ter sido realizado.
preço estendido	double	Não	Preço do item de linha com quantidade, descontos e rateio aplicados, na moeda de faturamento aplicável.

RenovarPara

Representa um item contido em um item de linha do carrinho.

Propriedade	Type	Obrigatório	Descrição
prazoDuração	string	Não	Uma representação ISO 8601 da duração do prazo de renovação. Os valores atuais suportados são P1M (um mês) e P1Y (um ano).

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro do Partner Center.

Erro de Carrinho

Representa um erro que ocorre após a criação de um carrinho.

Propriedade	Type	Descrição
errorCode	CartErrorCode	O tipo de erro de carrinho.
errorDescription	string	A descrição do erro, incluindo quaisquer observações sobre valores suportados, valores padrão ou limites.
additionalInformation	Informações Adicionais	Informações adicionais para o erro.

AdditionalInformation

Informações adicionais sobre o erro.

Propriedade	Type	Descrição
disponívelQuantidade	INT	O número de licenças restantes que podem ser adquiridas para o SKU do produto especificado.
compradoQuantidade	INT	O número de licenças que estão sendo compradas.

CartErrorCode

Tipos de erros de carrinho.

Nome	ErrorCode	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
CotaNão Disponível	10002	Cota insuficiente disponível
InventárioNão Disponível	10003	O inventário não está disponível para a oferta selecionada
ParticipantsIsNotSupportedForPartner	10004	A configuração de participantes não é suportada para o Parceiro
UnableToProcessCartLineItem	10006	Não é possível processar o item de linha do carrinho.
SubscriptionIsNotValid	10007	A assinatura não é válida.
SubscriptionIsNotEnabledForRI	10008	A assinatura não está habilitada para compras de reserva.
SandboxLimitExceeded	10009	O limite da área restrita foi excedido.
Entrada inválida	10010	A entrada genérica não é válida.
SubscriptionNotRegistered	10011	A assinatura não é válida.
AtestadoNãoAceito	10012	O atestado não foi aceito.
MaxAllowedSeatsPerSubscriptionExceeded	10015	O número de assentos solicitados excede o limite.
Desconhecido	0	Valor padrão

CartCheckoutResult

Representa o resultado de um checkout de carrinho.

Propriedade	Type	Descrição
pedidos	Lista de objetos Order.	A cobrança de pedidos.
orderErrors	Lista de objetos OrderError .	A coleção de erros de ordem.

OrderError

Representa um erro que ocorre durante o checkout de um carrinho quando um pedido é criado.

Propriedade	Type	Descrição
orderGroupId	string	O ID do grupo de pedidos do pedido com o erro.
code	INT	O código de erro.
descrição	string	A descrição do erro.