Recolecciones

Las recolecciones registran el efectivo retirado de cada máquina por los técnicos en campo. Es uno de los procesos más sensibles del negocio: requiere transparencia total, trazabilidad y validación por parte del cliente cuando aplica.

Flujo completo de una recolección

1. Técnico llega a la máquina y escanea su QR o valida proximidad GPS
2. Cuenta el efectivo recogido del compartimento
3. Registra en la app móvil: denominaciones, total, observaciones, fotos
4. Sube la recolección al sistema (queda en estado "Pendiente de aprobación")
5. Supervisor/contabilidad revisa desde el panel admin
6. Aprueba o rechaza con motivo
7. Si corresponde: se genera factura o nota de crédito según el modelo comercial

Acceso desde el panel

1. Menú lateral → Operaciones → Recolecciones

Vista principal con KPIs (Recolectado del período, Eficiencia de cuadre, Faltantes acumulados, Sobrantes acumulados), Top máquinas con diferencias, Ranking de operadores y resumen rápido (Pendientes de validar, Recolectado hoy, Total histórico). Tabla con número COL-YYYY-XXXX, máquina, cliente, operador, estado (Pendiente / Validado), monto recolectado, diferencia, alertas y fecha. Botón "Agendar Recolecta" arriba a la derecha.

Estados de una recolección

• Pendiente — registrada por técnico, esperando aprobación
• Aprobada — validada y notificada al cliente
• Rechazada — anulada con motivo (discrepancia, fraude, error)
• Facturada — generó factura asociada

Revisar y aprobar una recolección

1. Abre la recolección pendiente
2. Verifica:
   • Monto total declarado por el técnico
   • Desglose por denominación
   • Fotos del efectivo y de la máquina
   • Ubicación GPS desde donde se hizo
   • Hora y fecha
3. Si todo está bien, pulsa "Aprobar"
4. Si hay discrepancia, pulsa "Rechazar" y especifica el motivo

Vista detalle (pestaña Detalle): header con número COL-YYYY-XXXX, tipo de máquina (Vending), datos de máquina/cliente/fecha, banner de aprobación, bloque de Contadores (ventas totales, ventas en efectivo, ventas cashless, créditos en caja, stacker, target card) con valores actual/anterior/diferencia, bloque de Pagos digitales y Cash con totales y panel lateral con datos del técnico, GPS validado y firmas del operador y del cliente.

Numeración consecutiva

Cada recolección recibe un número consecutivo único (ej: COL-2026-0001) que sirve para:

• Referencias en facturación
• Auditorías
• Reportes

Historial de la máquina

Dentro del detalle de cualquier recolección, la pestaña Historial de la máquina muestra las últimas recolectas hechas sobre el mismo equipo. Es la mejor herramienta para detectar tendencias, validar contra el promedio y aprobar con criterio:

• Gráfico de tendencia con los últimos 4 montos recolectados
• Promedio histórico de la máquina y tendencia porcentual respecto al período anterior
• Tabla con cada recolecta anterior: número, fecha, operador, monto recolectado, diferencia y estado de validación
• La recolecta abierta queda marcada como ACTUAL en la tabla para que sea fácil ubicarla en el contexto

Pestaña Historial de la máquina con gráfico de tendencia, promedio (en este caso $341,80), tendencia (+519,1%) y tabla con las últimas 4 recolectas del equipo. La recolecta actual aparece resaltada con la etiqueta "ACTUAL".