Pular para o conteúdo
platform
PT EN

Casos de uso

Portal B2B próprio: o caminho típico pela API

Cenário

A empresa abre um portal em que o cliente B2B se identifica e compra sozinho, com as condições que já foram negociadas com ele. O portal só substitui o telefone se mostrar ao comprador o preço, o crédito e o estoque que valem para ele, e não uma tabela geral.

Em B2B o preço não é um valor guardado: é o resultado de regras que consideram quem compra, de onde o produto sai, a quantidade e a condição de pagamento. Por isso a integração leva ao portal os vínculos e as regras (grupos de clientes, contratos, regras de preço, limite de crédito), e a plataforma calcula o preço no momento da compra.

O vendedor continua no canal. Ele atende dentro do mesmo portal, com as condições do cliente, e um pedido pode começar com um e terminar com o outro.

As dores que levam a esta integração

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 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.

Simplificamos o preço porque o sistema não aguenta

Como aparece

"A gente nivelou a tabela porque manter preço diferente por filial e por cliente virou impossível de administrar."

Por que acontece

O sistema de origem não sustenta preço por depósito cruzado com o preço de cada cliente, de cada categoria e de cada condição, e a empresa achata a política para conseguir administrar.

Meus vendedores dizem que o portal vai matar a comissão deles

Como aparece

"Meus vendedores dizem que o portal vai matar a comissão deles."

Por que acontece

Se o vendedor só é remunerado pelo pedido manual, o portal representa comissão perdida, e a resistência é racional. É falha de modelo operacional, não de plataforma.

O que normalmente se integra

EntidadeSentidoFrequência típicaEndpoints e eventos
Clientes, endereços e grupos O grupo do cliente é um dos critérios que as regras de preço e as condições de pagamento usam para decidir o que vale para ele. Nos dois sentidos Carga inicial e a cada alteração de cadastro
Contratos de preço O contrato fixa o preço do item para os clientes vinculados e se sobrepõe às regras de preço. Entre contratos válidos para o mesmo cliente, vale o de menor número de prioridade. Seu sistema para a CWS Platform Por vigência do contrato
Regras de preço Entre as regras não cumulativas vale só a de maior prioridade; as cumulativas se aplicam sobre o resultado. Seu sistema para a CWS Platform Quando a política comercial muda
Limite de crédito O limite é uma conta corrente do cliente na plataforma, com saldo e extrato, e pode ser usado como meio de pagamento. Seu sistema para a CWS Platform A cada evento financeiro que altera o limite
Estoque e preço por depósito Cada par de produto e depósito tem preço e quantidade próprios, e o frete é calculado a partir do endereço do depósito de origem. Seu sistema para a CWS Platform Contínua, em lotes pequenos
Vendedores e carteiras Seu sistema para a CWS Platform Quando a carteira muda
Prioridade de produtos na busca Cada produto pode ter um nível de prioridade nas buscas da loja, de 1 a 5. Removida a prioridade, o produto volta ao comportamento padrão da busca. Seu sistema para a CWS Platform Quando o sortimento prioritário muda
Pedidos CWS Platform para o seu sistema Por evento (webhook) ou por consulta periódica
Status, nota fiscal e rastreio A plataforma não emite a nota fiscal: recebe os dados e o XML da nota já emitida. O fluxo de status é de mão única. Seu sistema para a CWS Platform A cada mudança de etapa do pedido
Produtos, frete e formas de pagamento O cadastro de produto, as tabelas de frete e as condições de pagamento são mantidos no painel. A base de conhecimento também descreve criação de produto e consulta de estoque por API: não está na coleção pública. Configuração no painel Na implantação e quando a operação 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 clientes e grupos

    O seu sistema cria os clientes na plataforma, com os endereços, e os vincula aos grupos que a política comercial usa. O documento do cliente é a chave nas chamadas seguintes.

  3. 3

    Publicar contratos e regras de preço

    O seu sistema envia os contratos, com os clientes e os produtos de cada um, e as regras de preço. Para quem está vinculado a um contrato vale o preço do contrato; fora das condições dele vale o preço padrão da loja, com as regras de preço aplicáveis.

  4. 4

    Enviar estoque e preço

    O seu sistema envia estoque e preço por depósito, em lotes de 1 a 50 itens. A resposta traz o resultado de cada item, então o integrador lê o corpo e reprocessa só o que foi recusado.

  5. 5

    Informar o limite de crédito

    O seu sistema informa o limite de cada cliente. A partir daí o pedido com saldo suficiente é aprovado automaticamente, e o cliente fecha a compra a prazo sem esperar uma liberação à parte.

  6. 6

    Ligar os vendedores às carteiras

    O seu sistema cadastra os vendedores e monta a carteira de cada um. No atendimento, o vendedor compra em nome do cliente com os endereços, o limite de crédito, os preços de contrato e as regras de preço desse cliente.

  7. 7

    Receber o pedido e devolver o andamento

    Depois que o pedido é gerado, a plataforma avisa o seu endpoint por webhook. O seu sistema busca o pedido completo, registra e devolve cada etapa: pronto para envio, enviado com o rastreio, e a nota fiscal já emitida.

Variações

Carrinho pronto enviado por link

O seu sistema monta um carrinho com produtos escolhidos para um cliente e recebe o link de acesso. O cliente abre o link e finaliza a compra com os itens já montados.

Várias filiais

Quando uma matriz integra por várias filiais, o estoque e os contratos de cada filial têm rotas próprias, com a filial na rota. O limite de crédito pode valer por loja ou para a matriz inteira; nesse caso o cliente usa o limite em qualquer filial.

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.

Orçamento para item sem preço ou sem estoque

Um produto pode ficar no portal com o orçamento habilitado mesmo sem preço ou estoque. O cliente pede o orçamento, e o seu sistema lista os pedidos pendentes e responde com preço e prazo.

Produtos em destaque na busca

O seu sistema define o nível de prioridade de um produto nas buscas da loja e o ajusta quando o sortimento prioritário muda.

Impostos calculados no ERP

Depende de ativação

Quando a regra fiscal mora no ERP, a plataforma chama o endpoint de tributos do ERP antes de fechar o pedido e usa os valores devolvidos, por item. É uma chamada síncrona, e o seu tempo de resposta entra no tempo do carrinho.

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.