Registro de pedidos (Orders Registry) no CRM

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Conversa Labs

Última atualização em 7 de set de 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. Alterar o status de um pedido manual não chama o gateway; ainda assim, um status financeiro alimenta comissões, estoque, metas e automações internas e, por isso, exige autorização e auditoria.

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.

Como editar e mudar o status

Um pedido manual ainda não financeiro pode ter título, valor, moeda, data e status corrigidos por quem gerencia o CRM.
Para entrar em parcialmente pago, pago ou reembolsado, é necessária permissão de gestão de vendas e uma justificativa. O antes, o depois, o responsável e o motivo ficam registrados.
Depois que o pedido produz efeitos financeiros, valor, moeda, itens e negócio não podem ser reescritos no lugar. Use a correção de vínculos ou a anulação governada para preservar comissões, estoque e metas.
Um pedido vindo de Pagamentos ou de outra integração é um retrato sincronizado. Abra os detalhes e use Gerenciar em Cobranças para localizar a cobrança de origem; pagamentos confirmed ou paid são projetados como pedido pago. Corrija os fatos no sistema de origem e sincronize, em vez de editar o log.
Antes de anular um pedido financeiro ou integrado, a tela mostra a prévia das compensações e dos bloqueios. Comissões fechadas, reservas confirmadas, recompensas já concedidas ou distribuição entregue bloqueiam a operação para evitar divergência.

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, vendedor e ordenação para chegar ao recorte desejado. Esses filtros ficam no endereço da página, então podem ser recarregados ou compartilhados. O filtro de vendedor aparece para quem pode gerenciar a equipe e usa a atribuição canônica da venda.
Clique no título de qualquer pedido para abrir o detalhe. O endereço passa a identificar aquele pedido e pode ser recarregado ou compartilhado; contato, organização, negócio e cobranças vinculadas aparecem como atalhos, conforme sua permissão.
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 vincule o pedido a um negócio. Ao marcar como pago, a data de pagamento é registrada pelo fluxo controlado.
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, parcialmente reembolsado, em atraso, reembolsado, cancelado e falho. Em reembolso parcial, a receita reconhecida mantém somente o saldo não devolvido.
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.
Pedido integrado × manual: em pedidos criados por Pagamentos ou por uma integração, valor e status acompanham a origem e não são sobrescritos no registro. Abra a cobrança vinculada para cancelar, reembolsar ou conciliar. Em pedidos manuais, a edição continua disponível no detalhe.

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.
Ao enviar partially_refunded, envie também amount_refunded, maior que zero e menor que o valor total.
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. Para cancelar, reembolsar ou corrigir a liquidação, abra os detalhes e selecione Gerenciar em Cobranças.
Não consigo mudar o status de um pedido pago/integrado: gerencie a operação na cobrança ou no gateway de origem pelo atalho do detalhe. O webhook sincroniza o resultado sem transformar o registro em uma segunda fonte da verdade.

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.