Pular para o conteúdo
platform
PT EN

Casos de uso

Compras B2B e suprimentos: o caminho típico pela API

Cenário

É a reposição repetitiva sob contrato: o comprador executa uma política de compras que já existe, com preço acordado, vários endereços de entrega e pagamento a prazo. O valor do canal está em reduzir o custo de cada transação.

O volume já existe no relacionamento entre o fornecedor e quem compra dele. A integração digitaliza o pedido de reposição que hoje é feito por telefone e planilha, sem depender de conquistar clientes novos.

Quem compra costuma ser uma equipe, não uma pessoa. O canal precisa atender a negociação, e não só exibir uma vitrine: contrato, crédito, orçamento e prazo fazem parte do mesmo pedido.

As dores que levam a esta integração

O cliente desiste no checkout porque não tem boleto a prazo

Como aparece

"O cliente coloca tudo no carrinho e desiste no checkout porque não tem boleto a prazo."

Por que acontece

Pagamento B2B é um serviço financeiro: prazo faturado, limite de crédito usado como pagamento, troca e divisão do valor entre vendedores. Um checkout pensado para cartão de crédito não comporta isso.

O preço negociado de cada cliente não cabe no portal

Como aparece

"Cada cliente tem o preço dele, ninguém consegue colocar isso no site."

Por que acontece

A transação B2B move cinco variáveis ao mesmo tempo (preço, entrega, pagamento, quantidade e composição), e plataformas de e-commerce tratam isso como campos estáticos de formulário.

O portal mostra estoque e preço que divergem do ERP

Como aparece

"O portal mostra estoque que já não existe."

Por que acontece

O ERP trabalha em janelas de processamento, e a verdade do sistema de registro não chega ao canal de venda no ritmo em que o cliente compra.

O que normalmente se integra

EntidadeSentidoFrequência típicaEndpoints e eventos
Clientes compradores e endereços de entrega Nos dois sentidos Carga inicial e a cada alteração de cadastro
Contratos de preço O contrato fixa o preço do item, independentemente do preço de estoque, e pode cobrir todos os clientes ou um recorte por documento, grupo ou tipo de cliente. Seu sistema para a CWS Platform Por vigência do contrato
Limite de crédito O limite é uma conta corrente do cliente, com saldo e extrato. O tipo de pagamento a prazo se vincula a um limite de crédito. Seu sistema para a CWS Platform A cada evento financeiro que altera o limite
Estoque e preço Seu sistema para a CWS Platform Contínua, em lotes pequenos
Carrinhos de reposição A criação devolve o link do carrinho. A edição soma quantidades aos itens ou troca a lista inteira, sem gerar outro link. Seu sistema para a CWS Platform A cada ciclo de reposição
Orçamentos Nos dois sentidos A cada solicitação do comprador
Prazo dos itens sob consulta É o envio dos prazos que libera o pedido para o pagamento. Seu sistema para a CWS Platform A cada pedido com item sob consulta
Pedidos CWS Platform para o seu sistema Por evento (webhook) ou por consulta periódica
Status, nota fiscal e acompanhamento dos itens O acompanhamento informa, item a item, o que já saiu, o que está em preparo e o que ficou pendente. É o que o comprador vê durante o atendimento. Seu sistema para a CWS Platform A cada mudança de etapa do pedido
Compradores e carteiras de compra Cada comprador tem login próprio e só compra para os clientes da sua carteira. A nota sai no CNPJ do cliente, e o pedido registra quem comprou. Depende de ativação e é configurado no painel, sem rota na coleção pública. Configuração no painel Quando a equipe de compras muda

Fluxo típico

  1. 1

    Autenticar

    O integrador obtém o token de acesso com o usuário de integração da loja e o envia como Bearer nas demais chamadas. O token vale 12 horas; ao expirar, a resposta é 401 e basta autenticar de novo.

  2. 2

    Carregar os clientes e os endereços

    O sistema do fornecedor cria os clientes compradores e os endereços de entrega de cada um. O documento do cliente é a chave nas chamadas seguintes.

  3. 3

    Publicar o preço acordado

    O contrato sobe com os clientes e os produtos que ele cobre. Para quem está vinculado, vale o preço do contrato; fora das condições dele vale o preço padrão da loja.

  4. 4

    Informar o limite de crédito

    O sistema do fornecedor informa o limite de cada cliente. O pedido com saldo suficiente é aprovado automaticamente.

  5. 5

    Manter estoque e preço

    O estoque e o preço padrão sobem em lotes de 1 a 50 itens, e a resposta traz o resultado de cada item.

  6. 6

    Montar o carrinho de reposição

    Quando a reposição é previsível, o sistema do fornecedor monta o carrinho do cliente e recebe o link. O comprador abre o link e finaliza a compra com os itens já montados, em vez de refazer a busca.

  7. 7

    Receber o pedido e acompanhar item a item

    A plataforma avisa o pedido por webhook. O sistema do fornecedor busca o detalhe, devolve o status e a nota fiscal, e informa a situação de cada item enquanto o pedido é atendido.

Variações

Central de compras com vários compradores

Depende de ativação

Cada pessoa da central de compras tem login próprio e compra para os clientes da sua carteira, sem compartilhar a senha da empresa. A nota sai no CNPJ do cliente, e o pedido registra quem comprou. É configuração, sem rota na coleção pública.

Orçamento antes do pedido

O comprador pede orçamento, o sistema do fornecedor lista as solicitações pendentes e responde com preço e prazo. Quando o orçamento vira pedido, a integração rastreia de qual cotação ele veio.

Item com prazo sob consulta

Um item pode ser vendido sem estoque físico, com prazo de preparo sob consulta. O sistema do fornecedor lista os itens do pedido que esperam prazo e informa o prazo de cada um; é esse envio que libera o pedido para o pagamento.

Entrega em mais de um endereço

Depende de ativação

Com a entrega fracionada, a entrega de um depósito é dividida em várias, cada uma com produtos, endereço, data e frete próprios. Cada fração vira um pedido com status próprio, e chega assim no webhook de pedidos.

Vários fornecedores no mesmo portal

Quando o portal de compras reúne vários fornecedores, o pedido do comprador se divide em um pedido por fornecedor. Cada fornecedor integra o que é dele, e a loja de origem consulta o conjunto.

Pedido acima do limite de crédito

Quando o cliente não tem saldo, a loja decide por configuração se ele pode fechar o pedido e deixá-lo pendente de aprovação. O pedido que excede o limite nasce com um status inicial próprio, gerado pela plataforma.

Quadro de possibilidades

Este é um caminho comum, não o único.

A CWS Platform chega ao mesmo objetivo por configuração, por API ou pela combinação das duas, e a melhor forma depende da sua operação, do seu ERP e das suas regras. Converse com um arquiteto da CWS Platform para desenhar a integração do seu caso.

Conversar com um arquiteto

Módulos da plataforma envolvidos

Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.