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:
- 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 do setor).
Para comprar um item do catálogo, conclua as seguintes etapas:
Identifique e recupere o Produto e a SKU que você deseja comprar.
Verifique se há um SKU no inventário. Esta etapa só é necessária para SKUs marcadas com um valor InventoryCheck na propriedade purchasePrerequisites .
Recupere a disponibilidade para a SKU. Você precisará do CatalogItemId da disponibilidade ao fazer o pedido. Para obter esse valor, use uma das seguintes APIs:
Envio de pedidos
Para enviar a ordem do item de catálogo, faça o seguinte:
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 agrupados automaticamente com base no que pode ser comprado juntos no mesmo Pedido.
Confira o carrinho. O check-out de um carrinho resulta na criação de um Pedido.
Obter detalhes do pedido
Você pode recuperar os detalhes de um pedido individual usando o ID do pedido ou obter uma lista de pedidos para um cliente. Há um atraso de até 15 minutos entre o momento em que um pedido é enviado e quando ele aparecerá em uma lista de pedidos de um cliente.
Consulte Obter um pedido por ID para obter os detalhes de um pedido individual usando os IDs do pedido.
Consulte Obter todos os pedidos de um cliente para obter uma lista de pedidos de um cliente usando a ID do cliente.
Consulte Obter uma lista de pedidos por cliente e tipo de ciclo de faturamento para obter uma lista de pedidos de um cliente por tipo de ciclo de faturamento, permitindo que você liste pedidos de itens de catálogo (cobranças únicas) e pedidos faturados anuais ou mensais separadamente.
Gerenciamento do ciclo de vida
Como parte do gerenciamento do ciclo de vida dos itens de catálogo no Partner Center, você pode recuperar informações sobre os Direitos do item de catálogo e obter detalhes da reserva usando a 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 por itens de catálogo.
Saldo e pagamento
Para obter o saldo da conta corrente no tipo de moeda padrão que é um saldo de cobranças recorrentes e únicas (item de catálogo), consulte Obter o saldo da conta atual.
Saldo e pagamento em várias moedas
Para obter o saldo da sua conta corrente 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.
Facturas
Para obter uma coleção de faturas que mostram cobranças recorrentes e únicas, consulte Obter uma coleção de faturas.
Nota Fiscal Única
Para recuperar uma fatura específica usando a ID da fatura, consulte Obter uma fatura por ID.
Reconciliação
Para obter uma coleção de detalhes de item de linha de fatura (Itens de linha de reconciliação) para uma ID de fatura específica, consulte Obter itens de linha de fatura.
Baixar uma fatura como PDF
Para recuperar um extrato de fatura em formato PDF usando uma ID de fatura, consulte Obter um extrato de fatura.