Comprar itens do catálogo

O cenário a seguir demonstra o processo genérico para comprar itens do catálogo usando a API do Partner Center.

Descoberta

Selecione produtos e Unidades de Manutenção de Estoque (SKUs) e verifique sua disponibilidade usando os seguintes modelos de API do Partner Center:

• Product - Uma estrutura de agrupamento para bens ou serviços adquiríveis. Um produto por si só não é um item comprável.
• SKU - Um SKU disponível para compra associada a um produto. Estes representam as diferentes formas do produto.
• Disponibilidade - Uma configuração na qual uma SKU está disponível para compra (como país/região, moeda e segmento de setor).

Para comprar um item do catálogo, conclua as seguintes etapas:

1. Identifique e recupere o Produto e a SKU que deseja comprar.

   • Obtenha uma lista de produtos
   • Obter um produto usando a ID do produto
   • Obter uma lista de SKUs para um produto
   • Obter um SKU usando o ID do SKU

2. Verifique se há uma SKU no inventário. Esta etapa só é necessária para SKUs que estão marcados com um valor InventoryCheck na propriedade purchasePrerequisites.

   • Verificar Inventário

3. Recupere a disponibilidade para o SKU . Você precisará do CatalogItemId da disponibilidade ao fazer o pedido. Para obter esse valor, use uma das seguintes APIs:

   • Obtenha uma lista de disponibilidades para um SKU
   • Obter uma disponibilidade usando o ID de disponibilidade

Submissão de encomendas

Para enviar a ordem de itens do catálogo, faça o seguinte:

1. Crie um Carrinho para armazenar a coleção de itens de catálogo que você pretende comprar. Quando você cria um carrinho, os itens de linha do carrinho são automaticamente agrupados com base no que pode ser comprado junto no mesmo Encomendar.

   • Criar um carrinho de compras
   • Atualizar um carrinho de compras

2. Confira o carrinho. A finalização da compra de um carrinho resulta na criação de um Pedido.

   • Finalizar a compra do carrinho

Obter detalhes da encomenda

Você pode recuperar os detalhes de um pedido individual usando o ID do pedido ou obter uma lista de pedidos para um cliente. Existe um atraso de até 15 minutos entre o momento em que uma encomenda é submetida e quando irá aparecer numa lista de encomendas de um cliente.

• Consulte Obter uma encomenda por ID para obter os detalhes de uma encomenda individual utilizando os IDs de encomenda.

• Consulte Obter todos os pedidos de um cliente para obter uma lista de pedidos utilizando o ID do cliente.

• Consulte Obter uma lista de pedidos por cliente e tipo de ciclo de faturamento obter uma lista de pedidos para um cliente por tipo de ciclo de faturamento permitindo listar pedidos de itens de catálogo (cobranças únicas) e pedidos faturados anuais ou mensais separadamente.

Gestão do ciclo de vida

Como parte do gerenciamento do ciclo de vida dos itens do catálogo no Partner Center, você pode recuperar informações sobre o item do catálogo Direitose obter detalhes da reserva usando o ID do pedido de reserva. Para obter exemplos de como fazer isso, consulte Obter direitos. ​

Fatura e conciliação

Os cenários seguintes mostram como visualizar programaticamente as faturas do cliente e obter os saldos e resumos da conta que incluem cobranças pontuais para itens de catálogo.

Saldo e pagamento

Para obter o saldo atual da conta na sua moeda predefinida, que inclui tanto encargos recorrentes como únicos (item de catálogo), consulte Obter o saldo atual da sua conta.

Saldo e pagamento em várias moedas

Para obter o saldo da sua conta corrente, além de uma coleção de resumos de faturas que contém um resumo de fatura com cobranças periódicas e pontuais para cada um dos tipos de moeda do seu cliente, consulte Obter resumos de faturas.

Faturas

Para obter uma coleção de faturas que mostram cobranças recorrentes e únicas, consulte Obter uma coleção de faturas. ​

Fatura Única

Para recuperar uma fatura específica usando o ID da fatura, consulte Obter uma fatura por ID. ​

Reconciliação

Para obter uma coleção de detalhes dos itens de linha da fatura (itens de linha relacionados à reconciliação) para uma ID da fatura específica, consulte Obter itens de linha de fatura. ​

Transferir uma fatura em formato PDF

Para recuperar um extrato de fatura em formato PDF usando um ID de fatura, consulte Obter um extrato de fatura.