Pular para o conteúdo
platform
PT EN

Casos de uso

Venda assistida e balcão: o caminho típico pela API

Cenário

O vendedor e o balcão atendem dentro do próprio portal: identificam o cliente e compram em nome dele, com os endereços, o limite de crédito, os preços de contrato e as regras de preço desse cliente. O cliente não precisa entrar no portal para ser atendido.

A cotação deixa de ser um documento à parte. O carrinho que o vendedor monta já usa as condições do cliente, e vira pedido quando o cliente aceita, sem redigitação. O vendedor salva o carrinho e envia o link; o cliente edita, fecha sozinho ou devolve para o vendedor finalizar.

Numa negociação real, desconto e prazo são trocados um pelo outro. Por isso os dois têm limite no mesmo lugar: a alçada de desconto de cada vendedor e as condições de pagamento permitidas para cada grupo de clientes.

A integração mantém, a partir do seu sistema, quem são os vendedores, quais clientes cada um atende e os carrinhos que chegam prontos.

As dores que levam a esta integração

Aprovar desconto é um caos; cada um aprova de um jeito

Como aparece

"Aprovar desconto é um caos. Cada um aprova de um jeito."

Por que acontece

Faltam alçadas no sistema, com bloqueio preventivo. A aprovação é humana, informal e não auditável.

A margem bruta está OK, mas a líquida não

Como aparece

"Minha margem bruta está OK, mas a líquida não."

Por que acontece

Três fontes combinadas: empilhamento de descontos, ausência de auditoria e de alçada, e pós-venda (devolução, troca e frete reverso), tudo fora do relatório de margem bruta.

A oportunidade só aparece se o vendedor for atrás dela

Como aparece

"Meu faturamento depende de cada vendedor lembrar de ligar para os clientes certos."

Por que acontece

A geração de oportunidade é um ato individual e não instrumentado: depende de memória, disciplina e disposição de cada vendedor, e não existe sistema que percorra a carteira inteira procurando o que oferecer a quem.

O que normalmente se integra

EntidadeSentidoFrequência típicaEndpoints e eventos
Vendedores O vendedor é cadastrado a partir de uma conta que já existe, com as permissões que ele passa a ter no atendimento. Removido o vendedor, a conta continua existindo. Seu sistema para a CWS Platform Quando a equipe muda
Carteira de clientes de cada vendedor A carteira em lote vincula, desvincula ou substitui a lista de clientes numa única chamada. Seu sistema para a CWS Platform Quando a carteira muda
Clientes Nos dois sentidos Carga inicial e a cada alteração de cadastro
Contratos e regras de preço Regra e contrato têm a opção de impedir que o vendedor aplique desconto adicional sobre o preço resultante. Seu sistema para a CWS Platform Por vigência do contrato e quando a política muda
Limite de crédito Seu sistema para a CWS Platform A cada evento financeiro que altera o limite
Carrinhos montados pelo seu sistema O carrinho pode levar o e-mail do vendedor responsável. Excluído o carrinho, o link deixa de funcionar. Seu sistema para a CWS Platform A cada oferta preparada para um cliente
Orçamentos Nos dois sentidos A cada solicitação do cliente
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
Alçadas de desconto e aprovação Cada vendedor tem três limites: a alçada, acima da qual o pedido vai para aprovação; o bloqueio de item, que impede inserir o desconto na linha; e o bloqueio de pedido. Ao enviar para aprovação, o vendedor informa o motivo. Não está na coleção pública. Configuração no painel Quando a política de desconto 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

    Cadastrar os vendedores

    O seu sistema cadastra cada vendedor a partir de uma conta que já existe e define as permissões dele no atendimento, como limitar o vendedor à própria carteira.

  3. 3

    Montar as carteiras

    O seu sistema vincula os clientes de cada vendedor, um a um ou em lote. A partir do vínculo, o cliente passa a ser atendido por esse vendedor.

  4. 4

    Garantir as condições do cliente

    O atendimento usa o que o cliente já tem na plataforma. O seu sistema mantém o cadastro, os contratos de preço e o limite de crédito, e é com eles que o vendedor negocia.

  5. 5

    Entregar carrinhos prontos

    O seu sistema monta o carrinho de um cliente, indica o vendedor responsável e recebe o link de acesso, para enviar ao cliente. O cliente abre o link e finaliza a compra com os itens já montados.

  6. 6

    Receber o pedido negociado

    O desconto acima da alçada do vendedor manda o pedido para aprovação antes de ele seguir. Depois que o pedido é gerado, a plataforma avisa o seu endpoint por webhook, e o seu sistema busca o pedido completo.

  7. 7

    Devolver o andamento

    O seu sistema atualiza o status do pedido e envia a nota fiscal já emitida. Enquanto o pedido está em alçada pendente, a atualização de status responde 422.

Variações

Um vendedor por cliente

Por padrão um cliente pode acumular vendedores. O vínculo pode ser feito como único, substituindo o vendedor anterior, e a loja pode exigir que cada cliente fique ligado a um só vendedor.

Frete negociado pelo vendedor

Depende de ativação

O cadastro do vendedor define se ele pode alterar o frete ou inserir um frete. Com a alçada de frete ativa, a alteração tem limite próprio e teto de bloqueio, e exige motivo.

Aprovação em níveis

Depende de ativação

Cada perfil tem uma faixa de desconto que aprova, e o pedido sobe nível a nível, com comentário e histórico. É configuração, sem rota na coleção pública.

Alçada validada por um motor externo

Depende de ativação

A loja pode escolher quais lojas têm a alçada de desconto validada por um mecanismo externo, do seu lado. Não está na coleção pública.

Orçamento respondido pelo seu sistema

Quando o cliente pede orçamento, o seu sistema 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.

Venda de balcão feita fora da plataforma

Depende de ativação

Quando o balcão ainda fecha a venda em outro sistema, o seu sistema pode informar essa venda para o programa de cashback, e o crédito fica para uso no portal.

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.