Registro de pedidos (Orders Registry) no CRM

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em Aug 18, 2026

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.
No menu lateral, abra Pedidos. A página reúne os pedidos que você pode consultar, inclusive os vinculados a contatos e negócios existentes.
Use a busca, período, origem, gateway, status e ordenação para chegar ao recorte desejado. Esses filtros ficam no endereço da página, então podem ser recarregados ou compartilhados.
Crie um pedido manual informando contato existente, título, valor, moeda e status.
Quando houver produtos, consulte os itens com nome, quantidade, preço unitário e desconto; eles preservam a fotografia financeira da venda.
Opcionalmente, informe a data do pedido e a data de pagamento, e vincule o pedido a um negócio.
Exporte o mesmo recorte em CSV ou selecione pedidos manuais para a ação em massa disponível. Pedidos de integrações são protegidos contra edição e exclusão na tela: a caixa de seleção fica desabilitada neles, e Selecionar todos os pedidos manuais destes filtros também alcança apenas os manuais.
Se um pedido integrado estiver com cliente ou vínculos incorretos, use Corrigir cliente e vínculos da venda. Escolha o contato, revise cobrança e recuperação relacionadas e aplique a prévia. Essa ação não edita o retrato financeiro do pedido e também funciona quando o registro integrado é imutável.

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.
Itens do pedido: o nome e os valores de cada item são um retrato da venda. Alterações posteriores no Catálogo não reescrevem o que foi vendido; quando disponível, o item também mantém o vínculo ao produto ou à variação da mesma conta.
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.
Lista global e CSV: a tela Pedidos é paginada no servidor; a exportação respeita os filtros e a seleção atual, sem incluir dados fora do seu escopo.
Editar × corrigir vínculos: somente pedidos manuais têm edição e exclusão comuns. A correção separada de contato, organização, negócio e conversa preserva valor, status, itens, datas e identidade externa.

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.
Comparar, no relatório do Catálogo, o orçamento dos negócios com o valor efetivamente liquidado dos itens.

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.
Para cada item integrado, envie também um identificador estável do item; assim, uma nova entrega do mesmo pedido não duplica as linhas.
Vincule o pedido ao negócio correspondente quando fizer sentido, para conectar venda e oportunidade.
Edite ou exclua somente registros manuais. Em um importado, use Corrigir cliente e vínculos apenas para associações; corrija valor, status, itens, datas ou ID externo na fonte e sincronize novamente.

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.
O nome ou preço do catálogo mudou: o item registrado continua exibindo o retrato da venda original; isso é intencional para preservar o histórico financeiro.
Não consigo criar um pedido: verifique sua permissão de gestão de CRM e se o contato existe.
Não consigo editar um pedido importado: isso é intencional. Registros recebidos de Pagamentos, comércio, API ou webhook preservam os fatos financeiros contra reentregas. Se o problema for somente o cliente ou outro vínculo, use Corrigir cliente e vínculos da venda na linha do pedido.

Veja também

Remover pedidos de teste ou órfãos

Na lista de Pedidos, administradores podem remover registros que vieram de cobranças ou integrações. Informe o tipo e o motivo da correção. O pedido sai imediatamente da visão Operacionais, mas a origem, o responsável, o motivo e eventuais compensações permanecem no histórico de auditoria.

Pedidos manuais nunca pagos e sem cobrança vinculada podem ser excluídos de forma definitiva. Pedidos pagos ou vinculados a uma integração são anulados, não apagados: comissões abertas, estoque e pontuação de engajamento são compensados de forma atômica. Uma comissão já fechada bloqueia a operação para evitar divergência financeira.

Use o filtro Situação do registro → Anulados para revisar o que foi removido. A restauração só é permitida quando a anulação não gerou compensações contábeis, de estoque ou engajamento e quando a identidade externa ainda está livre.

Para excluir a própria cobrança, primeiro arquive-a. Somente uma cobrança não liquidada pode ser eliminada permanentemente; a exclusão exige um motivo e anula/desvincula o pedido relacionado antes de apagar a cobrança local. Nenhuma dessas ações cancela ou estorna valores no gateway.