Configuración del flujo de caja: antes de empezar
Configura cómo se mueve el dinero de la empresa y obtén los reportes de cada turno de caja.
Flujo completo, de la configuración al reporte:
- Cuentas y billeteras (sección Cuentas bancarias,
bank-accounts): registra dónde cae o de dónde sale el dinero que no es efectivo: cuentas bancarias (bank), billeteras digitales como Yape o Plin (wallet), pasarelas de pago como Niubiz o Izipay (gateway, reciben cobros pero no pagan) y tarjetas de la empresa (card, pagan pero no reciben cobros). - Métodos de pago (esta sección): define cada forma de cobro/pago y su regla de destino (
destination_rule):any(se elige al registrar),type:<tipo>(solo cuentas de ese tipo) oaccount:<id>(siempre esa cuenta). El efectivo (goes_to_cash_drawer: true) va al cajón. Marca para qué sirve cada uno: cobrar (use_for_income), pagar (use_for_expense) o ambos. - Opciones de caja (esta sección,
cash-settings): caja general por defecto, valores iniciales del Libro de caja, si los vendedores pueden sacar reportes y qué reportes se ofrecen. - Abrir caja (sección Caja, Aperturar caja): cada usuario cobra en efectivo sobre su caja abierta.
- Cobrar y pagar: al registrar un pago envía
payment_method_type_idypayment_destination_id. Los valores válidos para el usuario los da Catálogos → Destinos de pago (catalogs/payment-destinations):cash(su caja abierta) o el id de una cuenta. El servidor aplica la regla del método: si es de cuenta fija y envías otra cuenta, o si el tipo de cuenta no corresponde, rechaza el pago con un mensaje que puede mostrarse al usuario. - Cerrar caja con arqueo (sección Caja, Cerrar caja): envía el efectivo contado (
counted_amount); el sistema calcula el teórico y la diferencia. - Reportes (esta sección,
cash-reports): consulta el catálogo de reportes y genera el que necesites de una caja (PDF o Excel), o el consolidado del día de todas las cajas.
Permisos: los métodos de pago y las opciones de caja son solo para administradores (403 a un vendedor). Los reportes de caja: administrador siempre; vendedor solo con available_cash_report_seller activo y solo de sus propias cajas.
Formato: las respuestas JSON son {success, data, message?} y los errores usan el código HTTP real: 403 sin permiso, 404 no existe, 409 una regla de negocio impide la operación (el message explica qué hacer), 422 {success: false, message: {campo: [errores]}} validación de campos. Los reportes responden el archivo (PDF o Excel).
Códigos de método de pago: el id es texto de 2 caracteres (01, 13); respeta el cero a la izquierda. Los códigos 01 a 10 son del sistema (01 Efectivo, 04 Transferencia...): se pueden editar y desactivar, no eliminar.