## Visión general

El **Registro de pedidos (Orders Registry)** es un **historial de compras** centrado en el contacto. Para
cada contacto (y, opcionalmente, para cada negocio) registras los pedidos con **título, valor, moneda,
estado y fecha**, armando una vista clara de todo lo que esa persona ya compró.

Es importante entender lo que **es** y lo que **no es**: el registro de pedidos es un **log**, no una
pasarela de pago. **No cobra, no reembolsa ni concilia dinero** — del cobro se encarga el módulo de
**Pagos**. Marcar un pedido como "reembolsado" o "cancelado" aquí es solo una anotación en el historial, no
una operación financiera.

Los pedidos pueden llegar de varias orígenes: cargados **manualmente**, recibidos vía **webhook**, creados
por la **API**, originados del módulo de **Pagos** o de integraciones de **comercio**.

## Requisitos previos

- El **Registro de pedidos** es opcional y viene **desactivado por defecto**. Pide a un administrador que lo
  habilite para la cuenta.
- Permiso de **gestión de CRM** para crear y editar pedidos.
- Contactos cargados — todo pedido pertenece a un contacto.

## Paso a paso

1. Confirma con un administrador que el **Registro de pedidos** esté habilitado.
2. Abre un **contacto** (o un **negocio**) y ubica la sección de **Pedidos**.
3. Crea un pedido indicando **título**, **valor**, **moneda** y **estado**.
4. Opcionalmente, indica la **fecha del pedido** y la **fecha de pago**, y vincula el pedido a un **negocio**.
5. Actualiza el **estado** a medida que el pedido evoluciona (pagado, parcialmente pagado, en mora,
   reembolsado, etc.).

## Configuración y opciones

- **Estado del pedido**: pendiente, pagado, parcialmente pagado, en mora, reembolsado, cancelado y fallido.
- **Origen (source)**: manual, webhook, API, Pagos o comercio — identifica de dónde vino el registro.
- **Vínculos**: todo pedido pertenece a un **contacto** y puede vincularse a un **negocio** del CRM.
- **Moneda y valor**: cada pedido tiene su propio valor y moneda (por defecto BRL).
- **Identificador externo**: los pedidos de integraciones traen un **ID externo** que evita duplicados.
- **Cartera por responsable**: cuando la privacidad por responsable está activa, cada vendedor ve solo los
  pedidos de los contactos/negocios a los que puede acceder.

## Casos de uso

- Mantener el **historial de compras** de cada cliente directo en el perfil del contacto.
- Seguir, en el negocio, los pedidos ya realizados en esa oportunidad.
- Consolidar pedidos de varios orígenes (manual, Pagos, comercio) en un único log.
- Alimentar automatizaciones e informes según lo que cada contacto compró.

## Consejos, límites y buenas prácticas

- Usa el registro de pedidos para **historial**; para **cobrar de verdad**, usa el módulo de Pagos.
- Estandariza **títulos** y **estados** para facilitar la lectura y los filtros.
- Al integrar vía webhook/API, envía un **ID externo** estable para no duplicar pedidos.
- Vincula el pedido al **negocio** correspondiente cuando tenga sentido, para conectar venta y oportunidad.

## Solución de problemas

- **No veo la sección de Pedidos**: el módulo puede estar desactivado para la cuenta — habla con un
  administrador.
- **Pedido duplicado**: verifica que la integración esté enviando el mismo **ID externo** en lugar de crear
  uno nuevo.
- **El pedido no cobró al cliente**: es lo esperado — el registro es un log; el cobro se hace en Pagos.
- **No puedo crear un pedido**: revisa tu permiso de gestión de CRM y que el contacto exista.

## Ver también

- [CRM: pipelines, kanban y negocios (deals)](/hc/ajuda/articles/contacts-crm-crm-pipelines-kanban-negocios-es)
- [Negocios: notas, adjuntos, checklists, ítems de línea y valor automático](/hc/ajuda/articles/contacts-crm-crm-notas-anexos-checklists-line-items-valor-es)
- [Visión general de Contactos y del CRM](/hc/ajuda/articles/contacts-crm-overview-es)
- [Objetos personalizados (Custom Objects)](/hc/ajuda/articles/contacts-crm-custom-objects-es)