Gestión de Pedidos y Aprobación de Pagos

La sección de Pedidos (/admin/orders) es la pantalla operativa principal para el cajero o encargado de operaciones del negocio. Aquí llegan todos los pedidos estructurados que los clientes realizan a través de WhatsApp o el catálogo web.

1. El Flujo de Estados de un Pedido

Cada orden en FlowWap recorre un flujo de estados claro para asegurar una correcta coordinación entre el cliente, el cajero, el equipo de despacho y los repartidores:

[Borrador] ──> [Pendiente de Pago] ──> [En Preparación] ──> [Listo] ──> [En Camino] ──> [Entregado]

1. Borrador (draft): El cliente está armando su carrito en la web.
2. Pendiente de Pago (pending_payment): El pedido está confirmado en espera del comprobante de transferencia o Pago Móvil.
3. En Preparación (preparing): El pago ha sido aprobado. El equipo de operaciones/almacén recibe la orden e inicia la preparación y empaque.
4. Listo (ready): El paquete está embalado y listo. Espera ser retirado en tienda o asignado al repartidor.
5. En Camino (out_for_delivery): Solo para pedidos con envío a domicilio: el repartidor recogió el pedido y va en ruta hacia el cliente.
6. Entregado (delivered) o Cancelado (cancelled): Fin del ciclo del pedido.

2. Pantalla de Pedidos Operativa

El panel muestra los pedidos del día en una lista responsiva y reactiva en tiempo real. Cuenta con herramientas de búsqueda y control:

• Barra de Búsqueda Instantánea: Permite filtrar pedidos al escribir el nombre del cliente, ID del pedido, productos o notas especiales.
• Pestañas de Filtro por Estado: Botones rápidos para alternar entre Todos, Pendientes, Preparando, Listo / En Camino, Entregados y Cancelados.
• Exportación a CSV: Botón 📥 Exportar CSV que descarga de inmediato una hoja de cálculo con todos los pedidos, detalles financieros (subtotal, descuentos, cupones, envíos, totales), desglose de artículos y datos de entrega con compatibilidad UTF-8 (Excel, Google Sheets).
• Vista en Acordeón: Cada fila se puede expandir para consultar:
  • Detalle del Cliente: Nombre, número de WhatsApp y dirección detallada de entrega.
  • Detalle de Compra: Lista de productos, cantidades, descuentos aplicados y cupón utilizado.
  • Resumen Financiero: Subtotal de productos, descuento de promociones, costo de delivery y total neto.
  • Comprobante de Pago: Imagen del comprobante con enlaces seguros temporales.

3. Validación y Aprobación de Pagos

Aprobación Manual (Cajero)

Cuando el cliente envía la captura de su Pago Móvil o transferencia por WhatsApp, la imagen aparece en el acordeón del pedido en el panel web. El cajero debe contrastar la referencia y el monto en su portal bancario y presionar:

• Aprobar Pago: Esto transiciona el estado del pedido automáticamente a preparing (en preparación/empaque) y envía una alerta al equipo operativo en Telegram.
• Rechazar Pago: Si la transferencia es inválida, el cajero rechaza el comprobante.

Seguimiento de Envíos (Delivery)

Para pedidos con envío a domicilio, el acordeón del pedido incluye botones adicionales que te permiten seguir el ciclo de reparto desde el panel:

• 🚗 En Camino: Aparece cuando el pedido está Listo. Márcalo cuando el repartidor recoja el pedido y salga hacia el cliente.
• ✅ Entregado: Aparece cuando el pedido está En Camino. Márclalo al confirmar la entrega final.

Estos botones también están disponibles para tu equipo de reparto directamente en Telegram (ver la guía del Bot de Telegram). Ambos canales se sincronizan al instante: si el repartidor marca “En Camino” desde Telegram, el panel se actualiza automáticamente.

4. Notificaciones y Limitaciones del MVP

• Notificaciones al Cliente por WhatsApp: En el MVP actual, la notificación de cambio de estado al cliente por WhatsApp se gatilla a través del bot de Telegram del staff (cuando el equipo marca /listo en el chat de operaciones). Las acciones directas de aprobación desde el panel web actualizan la base de datos pero la notificación al cliente está disponible primordialmente vía Telegram.
• Validación de Pagos: La verificación de comprobantes en este MVP es 100% manual por parte del cajero o administrador. La lectura automatizada por OCR se encuentra planificada para versiones futuras.