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.

Deteção

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

• Produto - Uma construção de agrupamento para bens ou serviços compráveis. Um produto por si só não é um item comprável.
• SKU - Um SKU comprável sob 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.

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

2. Verifique se há uma SKU no inventário. Esta etapa só é necessária para SKUs 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 sua ordem de itens de 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 da linha do carrinho são automaticamente agrupados com base no que pode ser comprado juntos no mesmo pedido.

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

2. Confira o carrinho. O check-out 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 da encomenda.

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

• Consulte Obter uma lista de pedidos por cliente e tipo de ciclo de faturamento para 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 os Direitos dos itens do catálogo e 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 a seguir mostram como exibir programaticamente as faturas do cliente e obter os saldos e resumos da conta que incluem cobranças únicas para itens de catálogo.

Saldo e pagamento

Para obter o saldo da conta corrente no seu tipo de moeda padrão que é um saldo de cobranças recorrentes e únicas (item de catálogo), consulte Obter o saldo da sua conta atual.

Saldo e pagamento em várias moedas

Para obter o saldo da sua conta atual e uma coleção de resumos de faturas contendo um resumo de fatura com cobranças recorrentes e únicas para cada um dos tipos de moeda do 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 do item de linha da fatura (Itens de linha de reconciliação) para uma ID de fatura específica, consulte Obter itens de linha da 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.