Guía de Usuario — Módulo COD Recolectado

¿Qué es el módulo COD?

COD significa Cash on Delivery — Pago Contra Entrega. Es el dinero que el repartidor cobra físicamente al destinatario en el momento de entregar el paquete.

El módulo COD Recolectado te muestra:

• ✅ Cuánto dinero se ha recolectado en un período de tiempo
• ✅ Por cada moneda (USD, MXN, COP, etc.)
• ✅ Por remitente (cliente que envía)
• ✅ Por repartidor que cobró

Importante: Si una orden aparece en este reporte, significa que ya fue entregada y el dinero ya fue cobrado. No existe el estado “pendiente de cobrar” aquí — para ver lo pendiente, el repartidor lo ve en su app móvil.

¿Cómo activo el módulo?

El módulo está en versión Beta. Por defecto viene apagado y debe activarlo el dueño de la organización:

1. Entra al menú Organización y abre Sistema
2. Busca la sección “Módulo COD (Beta)”
3. Activa el switch
4. Guarda los cambios

Una vez activado, aparecerá en el menú lateral la opción “COD Recolectado” y los repartidores verán un nuevo apartado en su app móvil.

⚠️ Solo los roles Super-admin y Admin pueden activar o desactivar este módulo.

Acceder al panel COD

En el menú lateral haz clic en “COD Recolectado” (icono 💵). Se abrirá el panel principal.

Verás un banner amarillo arriba que indica que el módulo está en Beta. Puedes cerrarlo y no volverá a aparecer en tu navegador.

¿Qué veo en el panel?

Tarjetas de totales (KPIs)

Una tarjeta por cada moneda en la que se haya recolectado dinero. Cada tarjeta muestra:

• 💰 Total recolectado en esa moneda
• 📦 Cantidad de órdenes que sumaron ese total

Por ejemplo, si tu negocio cobra en MXN y USD verás dos tarjetas, una por cada moneda. Nunca se suman monedas distintas entre sí.

Tabla de órdenes

Lista de cada orden entregada con COD en el período seleccionado. Columnas:

Cuando lo cobrado difiere de lo esperado, la fila lleva su etiqueta: Cobro incompleto (se cobró menos), Cobro en exceso (se cobró más) o No registrado — este último aparece en órdenes de mostrador entregadas sin que nadie capturara el cobro, y el reporte nunca presenta el importe esperado como si se hubiera cobrado. Los datos de la oficina y la persona quedan fijados al momento del cobro: renombrar la oficina o dar de baja a la persona después no los cambia.

Botón “Exportar”

Descarga toda la tabla actual en un archivo compatible con Excel y Google Sheets. Respeta los filtros que tengas aplicados.

Filtros

Haz clic en el botón “Filtros” (icono 🔽) para abrir las opciones:

Rango de fechas

• Desde y Hasta — el período que quieres consultar
• Por defecto muestra el mes actual
• Máximo permitido: 1 año por consulta

Si seleccionas un rango muy largo el sistema te avisará.

Cliente / Remitente (solo Admin)

Si eres Admin, Manager, Contador o Super-admin puedes filtrar por un remitente específico. Útil para revisar el COD recolectado por un cliente en particular.

Si eres Cliente solo ves tus propias órdenes — este filtro no aparece para ti.

Repartidor

Filtra por el repartidor que cobró el dinero en entregas a domicilio. Útil para revisar cuánto cobró cada repartidor. El dinero recibido en mostradores no se atribuye a ningún repartidor.

Agencia cobradora y Recibió el dinero

Si tu organización opera oficinas, puedes filtrar por la oficina que recibió el dinero y por la persona que lo recibió en el mostrador. Estos filtros no aparecen en organizaciones sin oficinas.

Aplicar / Reiniciar

• Aplicar: ejecuta el filtro
• Reiniciar: vuelve al rango por defecto (mes actual, sin filtros)

¿Qué ve cada rol?

¿Por qué no aparece “Estado de pago” en la tabla?

Es una decisión deliberada para evitar confusión:

El estado de pago de una orden se refiere a si el cliente remitente le pagó al negocio por el servicio de transporte, NO a si el dinero del COD ya fue entregado al remitente.

Como confundía a los operadores (“Pendiente” parecía decir que el COD no se había cobrado, cuando en realidad ya estaba entregado), se decidió ocultar esa columna en este reporte.

La regla simple: si una orden aparece en este reporte, el COD ya fue cobrado físicamente.

Cuando salga el módulo de Liquidaciones de COD (próximamente), allí se verá si ya le pagaste al remitente el dinero recolectado.

Vista del repartidor (app móvil)

Los repartidores ven su propio resumen COD desde la app móvil, en una pestaña dedicada. Allí ven:

• 💵 Pendiente por cobrar — dinero de órdenes asignadas que aún no entregan
• 📅 Hoy — recolectado en el día actual
• 📆 Esta semana y Este mes
• 🗓️ Histórico — todo el tiempo
• 🔍 Rango personalizado — pueden elegir fechas específicas

Todo agrupado por moneda, igual que en el panel web.

Exportar a Excel

1. Aplica los filtros que quieras (fechas, cliente, repartidor)
2. Haz clic en “Exportar” (icono ⬇️)
3. Se descarga un archivo con el rango de fechas en el nombre
4. Ábrelo con Excel, Google Sheets o cualquier hoja de cálculo

El archivo conserva acentos y caracteres especiales correctamente al abrirse en Excel.

Límite por descarga: hasta 50,000 filas. Si tu rango excede eso, se exportan las 50,000 más recientes. Para volúmenes mayores divide en períodos más cortos.

Para evitar saturar el sistema hay un límite de 10 descargas por minuto por usuario.

Preguntas frecuentes

¿Por qué no veo “COD Recolectado” en el menú?

Posibles razones:

1. El módulo no está activado en tu organización. Pídele al Admin que vaya a Organización → Sistema y active el switch.
2. No tienes permiso para ver el reporte. Pídele al Admin que revise tu rol.

¿Por qué no aparece una orden que sé que se entregó hoy?

La orden debe cumplir dos condiciones:

1. Estar en estado “Entregado” (el estado terminal del flujo)
2. Tener monto COD mayor a cero

Si la orden no tenía COD asignado al crearla, no aparecerá aquí. Tampoco aparecen órdenes en estados intermedios (en tránsito, asignada, etc.).

Mis órdenes nunca llegan con monto COD, ¿qué falta?

Que el nivel de servicio con el que se crean admita el cobro. Es un ajuste aparte de este módulo: en Tarifas → Niveles de Servicio, al editar el servicio, hay un interruptor “Permitir contra entrega (COD)” que viene apagado por defecto. Mientras esté apagado, al crear la orden ni siquiera aparece el campo del monto, así que nunca habrá nada que reportar aquí.

Activar este módulo no habilita el cobro por sí solo: este panel es el reporte del dinero ya cobrado, y el permiso de cobrar vive en cada servicio.

Los totales que veo no coinciden con los del repartidor en la app

No deberían discrepar — ambas vistas usan exactamente la misma fórmula y la misma fuente de datos. Si ves diferencia, verifica:

• Que estén usando el mismo rango de fechas y misma zona horaria
• Que estén filtrando por el mismo repartidor

Si aún así no coinciden, repórtalo al equipo de soporte.

¿Puedo ver el detalle de una orden?

En la versión actual del panel no hay enlace directo al detalle. Puedes copiar el ID y buscarlo en el listado de Órdenes desde el menú principal.

¿Qué significa la moneda “N/A”?

Son órdenes muy antiguas que se crearon sin asignar moneda explícita. El sistema las agrupa aparte para no mezclarlas con las modernas. Idealmente deberían ser pocas y solo en el histórico.

Soporte

¿Encontraste un monto que no coincide o un comportamiento extraño? Como el módulo está en Beta, reporta el caso al equipo de soporte con:

• El rango de fechas que estás consultando
• El filtro aplicado (cliente / repartidor)
• El monto que esperabas vs el que ves
• Captura de pantalla si es posible

Esto nos ayuda a estabilizar el módulo antes de salir de Beta.