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

1. Confirme com um administrador que o **Registro de pedidos** está habilitado.
2. 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.
3. 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.
4. 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.
5. Crie um pedido manual informando **contato existente**, **título**, **valor**, **moeda** e **status**.
6. Quando houver produtos, consulte os itens com nome, quantidade, preço unitário e desconto; eles preservam
   a fotografia financeira da venda.
7. 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.
8. 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.
9. 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

- [CRM: pipelines, kanban e negócios (deals)](/hc/ajuda/articles/contacts-crm-crm-pipelines-kanban-negocios-pt-br)
- [Negócios: notas, anexos, checklists, itens de linha e valor automático](/hc/ajuda/articles/contacts-crm-crm-notas-anexos-checklists-line-items-valor-pt-br)
- [Visão geral de Contatos e do CRM](/hc/ajuda/articles/contacts-crm-overview-pt-br)

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