Nota

Alcance de esta sección: Esta sección introduce el despacho y seguimiento del módulo de Logística. La captura de pedidos y georuteo inicial se abordan en la sección de Nueva Venta y Entrega a Domicilio.

Depot OS — Logística y Despacho

¿Qué es el módulo de Logística y Despacho?

El módulo de Logística es la herramienta de control para toda la operación de entregas a domicilio del negocio. Permite asignar pedidos a tu flotilla de repartidores, dar seguimiento en tiempo real al estado de cada envío, gestionar zonas geográficas de cobertura y mantener un control estricto del dinero en efectivo que recolectan los repartidores tras cada entrega.

Este módulo se adapta de manera inteligente: si tu sucursal no ofrece servicio a domicilio o desactivas la logística interna, la barra lateral se limpia automáticamente ocultando esta sección para evitar sobrecarga visual en tus operadores.

Panel de despacho a domicilio

Desde el panel central de Logística, el encargado de despacho o gerente de la sucursal tiene visibilidad completa del flujo de entregas:

Listado de pedidos a domicilio: Visualización ordenada de las comanda destinadas a entrega a domicilio, mostrando su número de pedido, nombre del cliente, dirección completa de destino, tiempo transcurrido y monto total.
Seguimiento de estados: Indicadores de colores que muestran si el pedido está en cola (Pendiente), elaborándose (Preparando), empacado y listo en mostrador (Listo), en trayecto con el repartidor (En camino) o finalizado con éxito (Entregado).
Asignación de repartidores: Un selector integrado que permite asignar o reasignar el pedido a cualquiera de los repartidores disponibles en turno.

Flujo de asignación y despacho

El proceso está diseñado para ser ágil en momentos de alta demanda:

Asignación del repartidor: Al completarse la preparación del pedido en cocina, el despachador selecciona al repartidor de la lista del personal activo.
Visibilidad en ruta: Una vez asignado, el pedido se despliega automáticamente en la pantalla del repartidor.
Entrega en camino: Al salir del establecimiento, el repartidor marca el pedido "En camino", notificando al sistema y permitiendo al gerente monitorear los tiempos de traslado.
Entrega completada: Al llegar con el cliente y entregar los productos, el repartidor marca el estatus como "Entregado", finalizando el ciclo operativo.

Control de efectivo y arqueo de repartidores

Uno de los mayores puntos de fuga de dinero en negocios con entregas físicas es el manejo de efectivo por parte de la flotilla. Depot OS resuelve esto a través de las Sesiones de Efectivo para Repartidores:

Apertura de sesión: Antes de iniciar su jornada de entregas, el cajero o gerente abre una sesión de efectivo para el repartidor desde el módulo de Gestion de Cajas.
Acumulación de saldo: Cada vez que el repartidor entrega un pedido marcado con método de pago "contra entrega" o "pago en efectivo al recibir", el valor de esa comanda se suma automáticamente al saldo esperado de su sesión.
Arqueo de regreso: Al regresar a la sucursal al final del turno, el repartidor entrega el dinero en efectivo recaudado. El administrador cierra la sesión del repartidor ingresando la cantidad física entregada.
Cálculo automático de diferencias: El sistema compara al instante el efectivo esperado contra el entregado, reportando cualquier sobrante o faltante de manera inmutable en los reportes de caja para evitar mermas.

Zonas de cobertura y validación de direcciones

Para garantizar que solo se acepten pedidos que tu equipo puede entregar, Depot OS incluye herramientas de delimitación geográfica:

Rango de cobertura: Permite establecer un punto central (sucursal) y un radio de cobertura en kilómetros.
Direcciones seguras: Al levantar un pedido a domicilio desde la pantalla de Operacion de Ventas, el buscador de direcciones utiliza mapas inteligentes para sugerir ubicaciones válidas, confirmando en tiempo real si el domicilio del cliente se encuentra dentro del radio de entrega permitido antes de procesar el pedido.

Enlaces relacionados

Operación de Ventas: Cómo registrar direcciones y despachar comanda de reparto.
Gestión de Cajas: Cómo abrir, cerrar y auditar las sesiones de efectivo de los repartidores.
Control de Turnos y Personal: Configuración de roles de repartidor y permisos de acceso.

Configuración y Parámetros del Sistema

Las opciones y límites geográficos de despacho se configuran a nivel empresa y se guardan en companies.pos_settings (o mediante overrides en branches.pos_settings).

Sesión de Efectivo para Repartidores (DB)

Para salvaguardar el dinero recaudado en la calle, el sistema implementa la tabla driver_cash_sessions (Sesiones de Efectivo de Repartidor) vinculada al módulo de cajas:

Al asignarse una orden con pago contra entrega (paymentMethod = 'cash' y allowPayOnDelivery = true), el sistema asocia el pedido con el identificador del repartidor (orders.delivery_employee_id).
El saldo acumulado se carga a su saldo esperado en la base de datos de manera atómica.
Al finalizar el turno de reparto, la sesión del conductor se liquida contra la caja registradora mediante un movimiento de tipo expense / subtipo driver_handover para ingresar el efectivo a la caja activa del mostrador.

Referencia del Esquema de Configuración (Logística)

Parámetro / Key	Tipo	Valor por Defecto	Descripción y Efecto Operativo
`deliveryRequiresAssignment`	`boolean`	`true`	Asignación requerida: Si es `true`, los repartidores solo visualizan en su aplicación móvil las entregas que les fueron asignadas de manera explícita por el despachador. Si es `false`, cualquier repartidor libre puede tomar pedidos en cola.
`deliveryAreaRadiusKm`	`select`	`"5"`	Radio de cobertura: Radio máximo en kilómetros (`3`, `5`, `10`, `15` km) desde las coordenadas geográficas de la sucursal para admitir entregas a domicilio. El POS valida la dirección del cliente contra este rango.

Módulo: Logística