Compartilhar via


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.