Recursos do carrinho

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	string	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 expirará, em formato de data e hora. Aplica-se após o carrinho ser criado com sucesso.
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.
Situação	string	O estado do carrinho. Os valores possíveis são "Ativo" (pode ser atualizado/enviado) e "Encomendado" (já foi enviado).

ItemDoCarrinho

Representa um item contido em um carrinho.

Propriedade	Tipo	Descrição
ID	string	Um identificador exclusivo para um item na linha do carrinho. Aplica-se após a criação bem-sucedida do carrinho.
Id do Item do Catálogo	string	O identificador do item de catálogo.
Nome Amigável	string	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	string	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	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 registados na compra.
Contexto de Provisionamento	Dicionário<string, 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.
itens adicionais	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.
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	string	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.

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 com desconto após o rateio ser realizado.
Preço	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 total final	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 uma linha de item do carrinho.

Propriedade	Tipo	Necessário	Descrição
termo de duraçã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 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	Informações adicionais para 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 do sandbox foi excedido.
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	O atestado não foi aceito.
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	string	O ID do grupo de pedidos associados ao erro.
código	Int	O código de erro.
Descrição	string	A descrição do erro.