Saltar al contenido
Facturador

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:

  1. 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).
  2. 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) o account:<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.
  3. 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.
  4. Abrir caja (sección Caja, Aperturar caja): cada usuario cobra en efectivo sobre su caja abierta.
  5. Cobrar y pagar: al registrar un pago envía payment_method_type_id y payment_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.
  6. 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.
  7. 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.