Visão geral
O Registro de pedidos (Orders Registry) é um histórico de compras centrado no contato. Para cada contato (e, opcionalmente, para cada negócio) você registra os pedidos com título, valor, moeda, status e data, montando uma visão clara de tudo o que aquela pessoa já comprou.
É importante entender o que ele é e o que não é: o registro de pedidos é um log, não um gateway de pagamento. Ele não cobra, não estorna e não concilia dinheiro — quem cuida da cobrança é o módulo de Pagamentos. Marcar um pedido como "reembolsado" ou "cancelado" aqui é apenas uma anotação no histórico, não uma operação financeira.
Os pedidos podem chegar de várias origens: lançados manualmente, recebidos via webhook, criados pela API, originados do módulo de Pagamentos ou de integrações de comércio.
Pré-requisitos
- O Registro de pedidos é opcional e vem desativado por padrão. Peça a um administrador para habilitá-lo para a conta.
- Permissão de gestão de CRM para criar e editar pedidos.
- Contatos cadastrados — todo pedido pertence a um contato.
Passo a passo
- Confirme com um administrador que o Registro de pedidos está habilitado.
- Abra um contato (ou um negócio) e localize a seção de Pedidos.
- Crie um pedido informando título, valor, moeda e status.
- Opcionalmente, informe a data do pedido e a data de pagamento, e vincule o pedido a um negócio.
- Atualize o status conforme o pedido evolui (pago, parcialmente pago, em atraso, reembolsado, etc.).
Configurações & opções
- Status do pedido: pendente, pago, parcialmente pago, em atraso, reembolsado, cancelado e falho.
- Origem (source): manual, webhook, API, Pagamentos ou comércio — identifica de onde veio o registro.
- Vínculos: todo pedido pertence a um contato e pode ser ligado a um negócio do CRM.
- Moeda e valor: cada pedido tem seu valor e moeda próprios (padrão BRL).
- Identificador externo: pedidos vindos de integrações trazem um ID externo que evita duplicação.
- Carteira por responsável: quando a privacidade por responsável está ativa, cada vendedor vê apenas os pedidos dos contatos/negócios que pode acessar.
Casos de uso
- Manter o histórico de compras de cada cliente direto no perfil do contato.
- Acompanhar, no negócio, os pedidos já realizados naquela oportunidade.
- Consolidar pedidos de várias origens (manual, Pagamentos, comércio) em um único log.
- Alimentar automações e relatórios com base no que cada contato comprou.
Dicas, limites e boas práticas
- Use o registro de pedidos para histórico; para cobrar de fato, use o módulo de Pagamentos.
- Padronize títulos e status para facilitar a leitura e os filtros.
- Ao integrar via webhook/API, envie um ID externo estável para não duplicar pedidos.
- Vincule o pedido ao negócio correspondente quando fizer sentido, para conectar venda e oportunidade.
Solução de problemas
- Não vejo a seção de Pedidos: o módulo pode estar desativado para a conta — fale com um administrador.
- Pedido duplicado: confirme se a integração está enviando o mesmo ID externo em vez de criar um novo.
- O pedido não cobrou o cliente: isso é esperado — o registro é um log; a cobrança é feita em Pagamentos.
- Não consigo criar um pedido: verifique sua permissão de gestão de CRM e se o contato existe.