Domicilios
Videos tutoriales
Los videos se reproducen si la carpeta media/ está disponible en el servidor.
¿Para qué sirve este módulo?
El módulo Domicilios administra las entregas a domicilio de los pedidos ya despachados: asignación de mensajeros, agrupación en rutas, seguimiento de estados, recaudo contra entrega, evidencias (foto/firma), liquidación de caja y reportes operativos.
- Listado de despachos con forma de entrega Domicilio, filtrados por estado.
- Rutas para agrupar varios pedidos en una sola salida del domiciliario.
- Recaudos de venta y envío cuando el cliente paga al recibir.
- Liquidaciones para cuadrar lo recaudado al cerrar la ruta.
- Dashboard y reportes con indicadores y exportación PDF/Excel.
Relación con otros módulos
| Acción / dato | Módulo o pantalla |
|---|---|
| Crear pedido y definir domicilio | Pedidos — forma de entrega y dirección del cliente |
| Generar despacho del pedido | Despachos (desde pedido) — el despacho entra al módulo cuando es domicilio |
| Empacar mercancía | Packing — antes de asignar a ruta |
| Registrar pagos del pedido | Ventas / Caja — abonos y saldo pendiente visibles en el despacho |
| Alta de mensajeros | Empleados con cargo domiciliario |
| Tarifas de envío | Configuración del módulo — tarifas por zona o valor |
| Transportadora externa | Configuración — no usa rutas internas del domiciliario |
Flujo habitual: Pedido → Packing → Despacho (domicilio, estado pendiente) → Crear ruta → Salida → Entregas/recaudos → Retorno → Liquidación.
Permisos
- El acceso al módulo depende del perfil asignado en el menú lateral.
- El icono Configuración solo aparece con el permiso de administrador (domiciliarios, transportadoras, tarifas).
- Liquidar, aprobar o marcar pagada una liquidación suele estar restringido a supervisores o caja; confirme con su administrador.
Inicio rápido (flujo diario)
- Revise el listado Asignado : despachos domicilio pendientes de ruta.
- Entre a Rutas → Crear ruta, elija domiciliario, fecha y marque los despachos disponibles.
- En el detalle de la ruta, pulse Registrar salida cuando el mensajero sale (estado ruta → en_ruta).
- Durante la jornada, actualice cada parada: entregado, novedad o devolución; registre recaudos si aplica.
- Al regresar, pulse Registrar retorno (estado ruta → completada).
- Genere la liquidación, revísela, apruebe y marque como pagada cuando caja confirme el dinero.
Conceptos clave
- Despacho
- Registro de envío ligado a un pedido. En domicilios solo se listan los de forma Domicilio.
- Ruta
- Agrupación de uno o más despachos para un domiciliario en una fecha. Tiene hora de salida, retorno y totales de recaudo.
- Parada / orden
- Cada despacho dentro de la ruta tiene un orden de visita configurable en el detalle.
- Recaudo venta
- Dinero del pedido que el domiciliario cobra al cliente (contra entrega).
- Recaudo envío
- Valor del envío cobrado en la puerta, si aplica.
- Liquidación
- Documento que resume lo esperado vs lo recaudado en una ruta completada; pasa por revisión y pago.
- Intentos de entrega
- Contador en el despacho; útil cuando hay novedades repetidas.
Estados del despacho
| Código | Nombre | Significado |
|---|---|---|
| 1 | Pendiente / Asignado | Listo para incluir en una ruta (menú: Asignado) |
| 2 | Esperando recogida | Ya está en una ruta programada; falta registrar salida |
| 3 | En ruta | Mensajero en camino (tras salida de ruta) |
| 4 | Novedad | No se pudo entregar (cliente ausente, dirección, etc.) |
| 5 | Devolución | Mercancía regresa a la empresa |
| 6 | Anulado | Despacho cancelado |
| 7 | Entregado | Entrega exitosa |
Puede cambiar el estado desde el listado (modal) o desde el detalle de ruta/despacho. Una ruta liquidada ya no permite cambios.
Estados de la ruta y liquidación
Ruta
| Estado | Descripción | Acciones típicas |
|---|---|---|
| Programada | Ruta creada | Registrar salida |
| En ruta | Domiciliario en calle | Actualizar paradas, registrar retorno |
| Completada | Retorno registrado | Generar liquidación |
| Liquidada | Cierre contable hecho | Solo consulta |
Liquidación
| Estado | Descripción | Siguiente paso |
|---|---|---|
| Pendiente | Generada automáticamente | Revisar y aprobar |
| Revisada | Aprobada por supervisor | Marcar como pagada en caja |
| Pagada | Dinero recibido en caja | Archivo / consulta |
Listado y filtros
La pantalla principal muestra despachos según el icono de estado elegido en el menú. Por defecto abre Asignado (estado 1).
Filtros disponibles
- Domiciliario — mensajero asignado (o todos).
- Buscar cliente/pedido — texto libre sobre nombre o ID de pedido.
- Fecha desde / hasta — acota por fechas del pedido o despacho según la búsqueda activa.
Filtros guardados
Use el componente en la esquina del card para guardar, cargar o eliminar combinaciones de filtros frecuentes (por ejemplo, un domiciliario concreto en la semana).
Acciones en la tabla
- Ver detalle del despacho .
- Cambiar estado (modal) si no está entregado.
- Enviar mensaje al cliente (WhatsApp) con datos de guía cuando aplique.
Crear ruta
Ruta de acceso: Rutas → botón crear, o .
- Seleccione el domiciliario (empleados activos con cargo domiciliario).
- Indique la fecha de ruta (normalmente el día de la salida).
- Marque uno o más despachos disponibles (estado 1, domicilio, sin ruta previa).
- Opcional: observaciones generales de la ruta.
- Confirme Crear ruta.
Efecto automático: la ruta queda programada; cada despacho pasa a estado Esperando recogida, se asigna el mensajero y se notifica al domiciliario.
Detalle de ruta
En concentra la operación del día:
- Datos del domiciliario, fecha, estado, horas de salida/retorno.
- Tabla de despachos con orden, cliente, dirección, valores y recaudos.
- Botones de acción según el estado de la ruta.
- Enlace al historial de la ruta (auditoría de cambios).
- Impresión de la hoja de ruta cuando esté disponible.
Salida y retorno
Registrar salida
Disponible en ruta programada. Confirme cuando el domiciliario sale con los paquetes. Registra hora de salida y cambia la ruta a en_ruta; los despachos pueden pasar a En ruta.
Registrar retorno
Disponible en ruta en_ruta. Use al finalizar la jornada. Registra hora de retorno y deja la ruta en completada, habilitando la liquidación.
Estados por parada (en la ruta)
Cada despacho dentro de la ruta tiene un estado de entrega independiente del listado general:
- asignado — en la ruta, pendiente de visita.
- en_camino — mensajero dirigiéndose a esa dirección.
- entregado — entrega confirmada (sincroniza despacho a Entregado).
- novedad — no entregado; registre observaciones.
- devuelto — mercancía regresa (despacho en Devolución).
Al marcar entregado con recaudo pendiente, complete los montos en el modal de recaudo antes de cerrar la liquidación.
Detalle del despacho
muestra la ficha completa:
- Pedido: total, abonos, saldo pendiente, estado de pago.
- Cliente: contacto y dirección con anotaciones.
- Despacho: estado, forma de entrega, valor envío, intentos, observaciones.
- Mensajero o transportadora asignada.
- Secciones de recaudo, recibos, fotos/firmas e historial de cambios.
Recaudos y recibos
Recaudo de venta y envío
En pedidos contra entrega, el despacho indica si cobra pago y/o cobra envío. Al recibir dinero:
- Registre el monto recaudado (venta y/o envío).
- Marque el recaudo como realizado cuando corresponda.
- Desde el detalle puede crear recibos adicionales si hubo pagos parciales o múltiples formas de pago.
En el detalle de ruta puede editar recaudos con el modal Editar recaudo antes de liquidar.
La liquidación compara monto esperado vs monto recaudado por cada despacho de la ruta.
Fotos y firmas
Desde el detalle del despacho puede adjuntar evidencia de entrega:
- Foto — paquete en puerta, fachada o comprobante visual.
- Firma — captura en pantalla del receptor (tableta o móvil).
Recomendado en entregas de alto valor o cuando la empresa exige prueba documental. Las evidencias quedan ligadas al despacho y visibles en auditorías.
Liquidaciones
Generar
Desde una ruta completada, use Generar liquidación. El sistema totaliza recaudo venta, recaudo envío y detalle por despacho.
Revisar y aprobar
En filtre por fecha, domiciliario o estado. Abra el detalle, verifique diferencias y pulse Aprobar (estado → revisada).
Pagar
Cuando caja recibe el efectivo o confirma consignaciones, marque la liquidación como pagada. La ruta pasa a liquidada y ya no admite ediciones.
Configuración
Pantalla (permiso de administrador):
- Domiciliarios — listado de mensajeros del módulo (empleados cargo 2).
- Transportadoras — empresas externas de envío (guía, teléfono, web).
- Tarifas envío — valores de domicilio según reglas del negocio.
Los domiciliarios deben existir previamente en Empleados con el cargo correcto y estado activo.
Estadísticas (dashboard)
resume el día actual:
- Total de despachos en rutas del día (por fecha de ruta).
- Conteo por estado: entregados, en ruta, pendientes, novedades.
- Tasa de éxito (% entregados).
- Rutas del día por estado (programada, en_ruta, etc.).
- Totales de recaudo venta/envío cuando aplica.
Reportes y exportación
permite analizar un rango de fechas (por defecto últimos 30 días):
- Estadísticas de despachos, rutas, domiciliarios y liquidaciones.
- Serie diaria de los últimos 7 días.
- Exportar a PDF o Excel vía .
Los reportes usan preferentemente la fecha de ruta para alinear operación logística con cierre de caja.
Preguntas frecuentes
Ejemplos prácticos
Ruta matutina estándar
Filtrar Asignado → Crear ruta con 8 pedidos → Salida 8:00 → Entregas y recaudos → Retorno 13:00 → Liquidación y aprobación en caja.
Novedad por cliente ausente
En ruta, marque parada como novedad, agregue observación. El despacho pasa a Novedad. Reprogramar en nueva ruta al día siguiente.
Contra entrega parcial
Cliente paga envío en efectivo y saldo después: registre recaudo envío, cree recibo parcial de venta, deje saldo pendiente visible en el pedido.
Buenas prácticas
- Arme rutas por zona para reducir tiempos y combustible.
- Registre salida al momento real de partida; evita estados adelantados.
- Complete recaudos el mismo día; no liquide con montos pendientes sin explicación.
- Use fotos o firmas en entregas con saldo alto o reclamos frecuentes.
- Revise el dashboard al mediodía para redistribuir novedades.
- Guarde filtros del listado si supervisa siempre los mismos domiciliarios.
- No modifique rutas ya liquidadas; abra un ajuste en caja o pedidos si hubo error.