Un pedido asocia a un contacto con los productos que pidió o compró: el precio de cada uno, los descuentos, el IVA, el envío, lo que ha pagado y si ya se le entregó. Está apagado por defecto: un administrador lo enciende en Configuración → Pedidos y compras; mientras tanto no aparece en el menú.
Cómo se crean#
| Origen | Cómo | Fuente que queda registrada |
|---|---|---|
| A mano | Menú Pedidos → Nuevo pedido (o desde la pestaña Pedidos del panel de información de un chat, correo o llamada) | Manual |
| Desde una cotización | En una cotización aceptada o firmada, botón Crear pedido: copia productos, cantidades, descuentos e IVA. Una cotización solo se convierte una vez | Cotización (con su número) |
| Desde una oportunidad | Con el producto y el valor de la oportunidad | Oportunidad |
| Desde la API | POST /v1/pedidos (ver Referencia de las APIs) | API, web, WooCommerce u otra, con el nombre de la llave y su referencia externa |
Cada pedido guarda de dónde vino (fuente, detalle y, si viene de otro sistema, su referencia externa; una misma referencia no se puede registrar dos veces) y quién lo creó.
El pedido#
- Valor de cada línea: el valor de un producto del catálogo viene bloqueado (usa el precio del catálogo); solo se puede escribir otro si el producto tiene encendido Valor editable (ver Productos). Las líneas libres siempre admiten el valor que escribas.
- Productos: cada línea guarda una foto del producto y de su precio en el momento del pedido (si cambias el catálogo después, los pedidos viejos no cambian). Si el producto tiene varios precios, eliges cuál; también puedes agregar sus adicionales y líneas libres (servicios sueltos).
- Descuento por producto: en porcentaje (%) o en valor fijo ($) en cada línea.
- Descuento general: en % o $, con motivo; se reparte entre las líneas en proporción a su valor (centavo a centavo, sin diferencias de redondeo).
- IVA: por línea (por defecto el de la configuración). El descuento se aplica antes del IVA.
- Envío: monto, su propio % de IVA, dirección, método y número de guía.
- Totales: subtotal, descuentos, envío, impuestos, total, pagado, reembolsado y saldo.
- Todo se guarda solo mientras editas.
Tres estados independientes#
| Estado | Valores |
|---|---|
| Del pedido | Borrador → Pendiente de pago → En proceso → Completado · Cancelado · Reembolsado |
| Del pago (se calcula con los pagos) | Sin pagar · Pago parcial · Pagado · Reembolso parcial · Reembolsado |
| De la entrega (se calcula con lo entregado por línea) | Sin entregar · Entrega parcial · Entregado · Devuelto |
Reglas:
- Solo cambian los productos, descuentos y envío de un pedido en borrador, o pendiente sin pagos (si la configuración lo permite). Un pedido con pagos nunca cambia sus productos: para corregirlo se registra un reembolso.
- Los pagos no pueden superar el saldo. Los reembolsos (solo administradores y supervisores) no pueden superar lo pagado.
- Al pagarse por completo pasa solo a En proceso; al estar pagado y entregado puede pasar solo a Completado (ambas reglas se activan o no en la configuración).
- Para cancelar un pedido con pagos primero hay que reembolsarlos. Un pedido reembolsado por completo queda Reembolsado.
- Cada cambio queda en el Historial del pedido (quién y cuándo, o si fue la API o una pasarela).
Número de factura#
Cuando el pedido se factura en Siigo o Alegra (acción de etapa «Generar factura»), el número de la factura aparece como campo Número de factura en el editor del pedido y en el detalle de la oportunidad, con «Ver PDF» si se guardó el PDF. Al pulsar el número de factura se abre la factura en una pestaña nueva con su dirección pública del proveedor (en Siigo, public_url; se ve sin iniciar sesión, así que trátala como un dato sensible). En la API de pedidos viene como factura_numero, factura_proveedor, factura_url y factura_pdf.
Pagos#
- Registrar pago: monto, método (Transferencia bancaria, Bre-B, Efectivo o Pasarela de pago; Wompi y ePayco entran como pasarela), referencia y nota.
- Cobrar por enlace (si los cobros con Wompi o ePayco están encendidos, en pesos colombianos): crea el enlace por el saldo o un anticipo y lo envía por una conversación. Cuando el cliente paga, el abono se registra solo en el pedido.
Comprobante de pago#
Cada pedido puede tener un comprobante de pago (imagen), guardado como la dirección (URL) de la imagen. En la pantalla del pedido, sección Pagos, pega la dirección y se muestra la imagen (se guarda al terminar de escribir); si lo dejas vacío, se quita. También se llena solo: cuando una etapa de oportunidad tiene la acción «Cambiar un dato → Comprobante de pago», el sistema que mueve la oportunidad por la API envía comprobante_url y la acción lo guarda en el pedido de esa oportunidad (ver Acciones automáticas de etapa). El cambio queda en el Historial del pedido. La API de pedidos también lo lee y lo escribe (comprobante_url).
Subirlo a mano: si el cliente no lo cargó en el formulario de verificación de pago, en la sección Pagos pulsa Subir imagen y elige el archivo (JPG, PNG, WebP o GIF de hasta 5 MB). Reemplaza al anterior, se muestra de inmediato y queda en el historial del pedido. También se puede subir en un pedido ya pagado; no en uno cancelado o reembolsado.
Entrega#
Marca todo entregado, o la cantidad entregada de cada línea; también devuelto. Registra la guía y el método de envío.
Quién ve qué#
Cada usuario ve los pedidos que creó o de los que es responsable; administradores y supervisores ven todos y son los únicos que registran reembolsos y eliminan pedidos (solo borradores o cancelados sin pagos).
Compras del contacto (aparte)#
Las compras de la ficha del contacto (cursos u otros productos que ya adquirió, por ejemplo desde WooCommerce) son independientes de los pedidos. En Configuración → Pedidos y compras → Compras del contacto eliges si se muestra la sección, su título (por ejemplo «Compras» o «Cursos») y, opcionalmente, que los productos de un pedido pagado se registren como compras del contacto.
Configuración#
En Configuración → Pedidos y compras: encender el módulo, numeración (prefijo, siguiente consecutivo, cifras y sufijo; puedes usar {AAAA}, {AA} y {MM}, y ves una vista previa del próximo número), moneda, IVA y envío por defecto, estado inicial, términos y las reglas automáticas.
API#
Leer, crear y actualizar pedidos desde otros sistemas: GET/POST /v1/pedidos, GET/PATCH /v1/pedidos/{id}, con los permisos pedidos:leer y pedidos:escribir. Con PATCH también se cambia el estado, se registran pagos, reembolsos y entregas; si algo falla no se guarda nada. Detalle y ejemplos en la Referencia de las APIs.
Datos del comprobante y lectura con IA#
Cada pedido guarda, junto a la imagen del comprobante, estos datos: código de referencia del pago, banco de origen, banco de destino, fecha y hora.
- Lectura automática: cuando llega la imagen (por el formulario de verificación de pago, por la API o subida a mano) se envía a la IA configurada en Configuración → Inteligencia Artificial, con un prompt que busca esos datos. En unos segundos aparecen en el detalle del pedido y de la oportunidad. Lo que la IA no ve con claridad queda en blanco; si el comprobante no trae código de referencia, se usa el número de documento del contacto.
- Edición por el asesor: en el detalle de la oportunidad, debajo de la imagen, y en el detalle del pedido, los campos son editables y se guardan solos al salir de cada uno. La IA nunca pisa lo que ya está escrito: solo completa los campos vacíos.
- Imagen nueva: al cambiar el comprobante se borran los datos anteriores y la IA lee la imagen nueva.
- Extraer dato de nuevo: botón bajo los datos (en la oportunidad) para repetir la lectura, por ejemplo si la IA estaba apagada o falló. Si la IA está apagada o sin configurar, el pedido queda con el aviso y no se lee.
- Los datos salen también en la API de pedidos (
comprobante_referencia,comprobante_banco_origen,comprobante_banco_destino,comprobante_fecha,comprobante_hora) y se pueden enviar para registrarlos o corregirlos. El consumo se suma al de la IA (tipo «comprobante»).
Valor y cuenta de origen: además del código de referencia, los bancos, la fecha y la hora, la IA lee el valor pagado y la cuenta de origen tal como aparece en el comprobante (a veces solo los últimos dígitos, por ejemplo *2563). Ambos son editables.
Advertencia de valor: el valor del comprobante se compara con el valor a pagar del pedido (su total y, si el pedido ya tenía pagos, también su saldo pendiente; tolerancia de 1 peso). Junto al campo Valor del comprobante aparece «Coincide con el valor a pagar» en verde o, si es distinto, «Diferente al valor a pagar del pedido (…)» en naranja con el monto esperado; se recalcula al corregir el valor. En la API de pedidos salen comprobante_valor, comprobante_cuenta_origen y comprobante_valor_coincide (true, false o null si no hay valor).
Un solo pedido abierto por contacto (reescritura)#
Un contacto solo puede tener un pedido abierto sin procesar a la vez. Si ya tiene uno y hace un pedido nuevo (por la API, por ejemplo desde la tienda web) sin haber procesado el primero, no se crea otro pedido: el pedido existente se reescribe con los datos del nuevo y su oportunidad también se reescribe.
- Cuándo aplica: el pedido anterior está en Borrador o Pendiente de pago, sin pagos y sin comprobante. Si ya tiene un pago o un comprobante (está en verificación), no se toca y el pedido nuevo se crea normalmente.
- Qué se reescribe en el pedido: líneas, descuentos, envío, notas, complemento del correo, origen y referencia externa. Conserva su número y su historial, donde queda anotado «se reescribió con los datos del pedido nuevo».
- Qué se reescribe en la oportunidad: título, valor y demás datos; no se crea una segunda oportunidad (si la web alcanzó a crear una nueva antes del pedido, se elimina y se conserva la anterior con sus datos). La oportunidad vuelve a «entrar» a la etapa inicial: si estaba en otra etapa se mueve ahí, y si ya estaba en ella se repiten sus acciones «al entrar» (por ejemplo, el correo con los datos del pedido nuevo).
- La API: al reescribir, la respuesta es 200 (no 201) e incluye
"reescrito": truey el número del pedido que se reescribió; al crear la oportunidad de ese pedido, también responde 200 con"reescrita": true. Si se repite la misma referencia externa, sigue respondiendo «pedido duplicado». Para forzar un pedido adicional se puede enviarpermitir_varios_abiertos: true. - Esto aplica a los pedidos que llegan por la API; los que se crean a mano desde la pantalla de Pedidos no se reescriben.
Monitor de ventas (carritos abandonados)#
En Configuración → Pedidos → Monitor de ventas se define cuántas horas debe llevar un pedido pendiente de pago, sin pagos y sin comprobante para contarse como carrito abandonado (por defecto 24). Lo usa el Monitor de pedidos y ventas de Colas.