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

1. Confirme com um administrador que o **Registro de pedidos** está habilitado.
2. Abra um **contato** (ou um **negócio**) e localize a seção de **Pedidos**.
3. Crie um pedido informando **título**, **valor**, **moeda** e **status**.
4. Opcionalmente, informe a **data do pedido** e a **data de pagamento**, e vincule o pedido a um **negócio**.
5. 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.

## 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)
- [Objetos personalizados (Custom Objects)](/hc/ajuda/articles/contacts-crm-custom-objects-pt-br)