Repartos y Logística

El módulo de Repartos y Logística gestiona el ciclo completo de entrega a domicilio: creación del viaje con wizard, registro de cobranza por parada, generación automática de deuda en la cuenta corriente de cada cliente e historial analítico de performance.

Ruta: Menú lateral → Repartos

Ciclo de vida de un reparto

NUEVO ──→ EN TRÁNSITO ──→ COMPLETADO
                │
                └──→ ANULADO

Estado	Quién actúa	Qué puede hacer
`en_transito`	Encargado	Ver entregas, Cargar cierre, Hoja de ruta, Anular
`completado`	Encargado	Ver detalle, Comprobante, Anular
`anulado`	Encargado	Solo ver detalle (no imprimible)

Pantalla principal — Listado operativo

Al ingresar al módulo se muestra el listado de repartos con dos pestañas:

Hoy: solo los repartos del día actual — activos y cerrados.
Todo: el historial completo de todos los repartos.

KPIs en tiempo real (calculados sobre la vista activa):

KPI	Qué representa
En la calle	Repartos actualmente en tránsito
Esperado	Suma de todos los montos de las facturas
Cobrado	Suma de los cobros confirmados
Deuda generada	Total acreditado en cuentas corrientes

Cada reparto aparece como una card con estado visual y acciones directas:

● En la calle (azul, dot pulsante): Ver detalle · Cargar cierre · Hoja de ruta
● Cobro completo / Con faltante / Con deuda (verde/ámbar/rojo): Ver detalle · Comprobante

Historial analítico

Ruta: Repartos → Historial

El historial muestra solo repartos cerrados y anulados con datos de performance que el listado operativo no tiene:

KPIs del período: total repartos, total cobrado, deuda generada y efectividad promedio.
Por cada reparto: ✓ entregas cobradas · ⚠ con deuda · ✗ no entregadas.
Barra de efectividad: verde ≥ 90% · ámbar ≥ 70% · rojo < 70%.
Filtros: búsqueda por repartidor + rango de fechas + paginación.

Crear un nuevo reparto

Ruta: Repartos → Nuevo reparto

El wizard organiza la creación en dos pasos para que no falte información.

Paso 1 — Datos del viaje

Campo	Descripción
Repartidor (requerido)	Nombre de quien realiza el viaje. Aparece en todos los documentos.
Fecha del reparto	Precargada con hoy. Ajustala si el cierre es de un día anterior.
Tipo de unidad	Flota propia: vehículo del negocio. Fletero / tercero: transporte externo contratado.
Notas para el repartidor	Instrucciones del viaje. Aparecen en la hoja de ruta impresa.

Presioná Siguiente: elegir facturas → para avanzar al Paso 2.

Paso 2 — Selección de facturas

El selector muestra las facturas disponibles para entregar:

Buscá y filtrá por nombre de cliente, dirección o nro. de boleta + rango de fechas.
Cada factura muestra badge de tipo de cliente, deuda previa si tiene saldo en cuenta corriente y badge Ya en Reparto #X si ya está asignada a otro viaje.
Las facturas ya asignadas aparecen atenuadas — no podés agregarlas.
El footer muestra en tiempo real: X facturas · $YY.YYY.

Al confirmar la selección, elegís cómo guardar:

Botón	Cuándo usarlo
Enviar en tránsito	El repartidor sale ahora. Cargás los cobros cuando vuelva desde Cargar cierre.
Completar y cerrar	Ya tenés todos los datos. Los cobros se pre-calculan: CC = pendiente/$0, efectivo = cobrado/total.

Detalle del reparto

Al hacer clic en una card o en Ver detalle accedés a la pantalla completa del reparto.

El header muestra:

Badge de estado en línea propia: ● En la calle / ✓ Completado.
Título con número, repartidor, fecha, tipo de unidad y cantidad de entregas.
Botones de acción según el estado:
- En tránsito: Imprimir remito (si hay 1 entrega) · Hoja de ruta · Cargar cierre · Anular cierre
- Completado: Imprimir remito (si hay 1 entrega) · Comprobante · Anular cierre

Las tarjetas de KPIs muestran Esperado, Cobrado, Faltante y Deuda generada. Si el reparto está en tránsito, los últimos tres aparecen en gris con “Pendiente de cierre”.

Acordeón de entregas

Cada entrega tiene su propio acordeón expandible:

Cerrado: muestra nombre del cliente, razón social, dirección, teléfono, items count y total a cobrar.
Abierto: el total desaparece y aparece el número de factura en el header. Dentro:
- Productos en dos líneas: nombre + precio c/u · subtotal.
- Total boleta prominente al pie con border-t-2.
- Botones Ver venta #X e Imprimir remito con fondo coloreado.

Anular un cierre

El botón “Anular cierre” está disponible siempre y revierte el reparto completo.

Completar un reparto en tránsito

Ruta: Detalle del reparto → Cargar cierre

Cuando el repartidor vuelve, cargás los resultados reales de cada entrega.

Para cada entrega completás:

Campo	Descripción
¿Cuánto cobró? (requerido)	Monto exacto recibido. El Faltante se calcula en tiempo real.
Estado de entrega	Uno de 6 estados — ver tabla de estados más abajo.
Forma de cobro	Efectivo · Transferencia · Mixto · Fiado.
Motivo / observación	Aparece cuando el estado no es Cobrado o hay faltante.

Cuando una entrega va a generar deuda, aparece un aviso inmediato:

⚠ Se generará deuda de $5.000 para Almacén La Esquina

El resumen al pie se actualiza en tiempo real con Esperado · Cobrado · Faltante · Deuda generada.

Presioná Guardar cierre de reparto para registrar todo. Las deudas se acreditan automáticamente en las cuentas corrientes de cada cliente.

Estados de entrega

Estado	Cuándo usarlo	¿Genera deuda?
Cobrado	Se cobró el 100% del monto de la factura.	No
Parcial	Se cobró una parte. El cliente pagará el resto después.	✅ Sí
Pendiente	No se cobró nada. Queda registrado en cuenta corriente.	✅ Sí
No entregado	La mercadería volvió. No había nadie en el domicilio.	No
Rechazado	El cliente se negó a recibir la entrega.	No
Otro	Situación excepcional con observación.	No

Deuda automática en cuenta corriente

Al guardar el cierre, Ventar actualiza las cuentas corrientes sin pasos adicionales.

Cuando se cumplen las tres condiciones:

Calcula el monto faltante (total factura − monto cobrado).
Registra ese monto como deuda en la cuenta corriente del cliente.
El movimiento queda trazado con referencia al cierre de reparto.

Para consultar la deuda generada:

Detalle del reparto → KPI “Deuda generada” con el total del viaje.
Historial analítico → tarjeta del reparto → badge ”⚠ X con deuda”.
Operaciones → Clientes → ficha del cliente → historial de cuenta corriente.

Impresión de documentos

Ventar genera tres documentos A4 profesionales:

Documento	Disponible	Acceso
Hoja de Ruta	Siempre	Botón “Hoja de ruta” en el detalle
Comprobante	Solo completado	Botón “Comprobante” en el detalle
Remito individual	Por entrega	Botón “Imprimir remito” en el acordeón

Hoja de Ruta: listado de todas las paradas con cliente, dirección, monto a cobrar, tabla de productos por parada, campos para anotar cobros y firma de recepción. Imprimila antes de que el repartidor salga.
Comprobante: resumen contable del cierre — todas las entregas con sus estados, cobros, faltantes y deuda generada por cliente. Para el archivo interno del negocio.
Remito individual: detalle de productos de una venta específica para el cliente. La firma en el remito es el respaldo de que la mercadería fue recibida.

Buenas prácticas

Registrá el cierre el mismo día del reparto para mantener correlación con la caja.
Usá “Enviar en tránsito” si el repartidor sale y vuelve más tarde — el reparto queda registrado sin esperar los resultados.
Completá siempre el campo Motivo cuando el estado no sea Cobrado para tener trazabilidad del seguimiento posterior.
Asegurate de que las ventas de reparto tengan cliente asignado al facturar, para que la deuda automática funcione.
Consultá el Historial analítico periódicamente para detectar patrones de cobros incompletos por repartidor o zona.

Preguntas frecuentes

¿Puedo editar un reparto después de guardarlo?

Los repartos no se editan directamente. Si está En tránsito, completalo con los outcomes reales desde Cargar cierre. Si ya está Completado, solo podés anular el cierre completo y crear uno nuevo. Para ajustes en una deuda individual, trabajá desde Operaciones → Clientes → Cuenta Corriente.

¿Qué pasa si agrego una factura por error en el Paso 2?

En el Paso 2 del wizard, antes de confirmar podés desmarcar el checkbox de cualquier factura. Una vez guardado el reparto no es posible quitar facturas individuales — anulá el cierre y creá uno nuevo.

¿Puedo agregar facturas de días anteriores?

Sí. En el Paso 2, ajustá el filtro Desde para mostrar ventas de días anteriores.

¿Puedo tener varios repartidores el mismo día?

Sí. Cada repartidor requiere su propio reparto. En la pestaña Hoy del listado el resumen suma todos los cierres del día.

¿La deuda del reparto afecta el crédito disponible del cliente?

Sí. La deuda generada se suma al saldo de la cuenta corriente. Si el negocio maneja límites de crédito, impacta en la disponibilidad para nuevas ventas en Cuenta Corriente.

¿Qué pasa con la deuda cuando anulo un reparto?

Al anular, Ventar revierte automáticamente todas las deudas que se habían acreditado en las cuentas corrientes de los clientes. El reparto no se elimina — queda en el historial con badge Anulado para mantener la trazabilidad.