Partilhar via


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.