💰 Finanzas

---

1. 🧩 Descripción General

El módulo de Finanzas permite gestionar el flujo de efectivo de la empresa, monitorear cuentas por pagar y cobrar, y proporcionar visibilidad de los movimientos financieros. Se conecta directamente con Compras, Ventas, Facturación y Bancos para registrar automáticamente ingresos y egresos relacionados con documentos del ERP.

---

2. 🧱 Modelos del Módulo

a. AccountReceivable

• id: integer (PK)
• client_id: FK → Client
• invoice_id: FK → Invoice (si aplica)
• sales_order_id: FK → SalesOrder
• amount: decimal
• paid_amount: decimal
• due_date: date
• status: enum (pendiente, pagado, vencido)

b. AccountPayable

• id: integer (PK)
• provider_id: FK → Provider
• purchase_order_id: FK → PurchaseOrder
• amount: decimal
• paid_amount: decimal
• due_date: date
• status: enum (pendiente, pagado, vencido)

c. Payment

• id: integer (PK)
• type: enum (ingreso, egreso)
• method: enum (transferencia, efectivo, tarjeta, etc.)
• reference: string
• amount: decimal
• date: date
• description: text
• related_id: FK → AccountReceivable o AccountPayable

---

3. 🔁 Funciones del Controlador

• indexAccountsReceivable(): Ver cuentas por cobrar.
• indexAccountsPayable(): Ver cuentas por pagar.
• storePayment(): Registrar pago recibido o realizado.
• reconcile(): Conciliar pagos contra documentos.
• summary(): Reporte de flujo de caja.

---

4. 🌐 Endpoints detallados y justificados

Método	Ruta	Descripción	Justificación
GET	/api/finanzas/accounts-receivable	Listar cuentas por cobrar	Seguimiento de ingresos
GET	/api/finanzas/accounts-payable	Listar cuentas por pagar	Seguimiento de egresos
POST	/api/finanzas/payments	Registrar pago	Entrada/salida de efectivo
POST	/api/finanzas/reconcile	Conciliación	Asociación de pagos con facturas
GET	/api/finanzas/summary	Reporte financiero	Análisis de flujo de caja

---

5. 🖥️ Diseño UX sugerido (flujo de usuario)

Página: "Cuentas por Cobrar / Pagar"

• Tabla con cliente/proveedor, monto, vencimiento
• Filtros: estado, rango de fechas
• Acciones: Ver, Conciliar, Registrar pago

Página: "Registrar Pago"

• Formulario con:
  • Tipo (ingreso/egreso)
  • Monto, método, referencia
  • Relación con cuenta (por pagar/cobrar)

Página: "Resumen Financiero"

• Total cobros vs pagos por mes
• Flujo de efectivo

---

6. 📄 Vistas sugeridas (tipo wireframe)

Vista	Campos sugeridos	Acciones
Cuentas	Nombre, documento, total, pagado, vencimiento	Ver, Conciliar
Pago	Tipo, monto, método, referencia, descripción	Guardar
Resumen	Ingresos, egresos, saldo neto mensual	Ver histórico

---

7. 🔗 Conexión Frontend ↔ API JSON:API

Acción en Frontend	Método/API	Resultado esperado
Ver cuentas por pagar	GET /api/finanzas/accounts-payable	Tabla
Ver cuentas por cobrar	GET /api/finanzas/accounts-receivable	Tabla
Registrar pago	POST /api/finanzas/payments	Crear entrada/salida
Conciliar	POST /api/finanzas/reconcile	Relacionar pagos
Ver resumen	GET /api/finanzas/summary	Reporte mensual

---

📊 Este módulo proporciona trazabilidad financiera al ERP, permitiendo a la empresa mantener el control sobre sus ingresos, egresos y obligaciones pendientes, integrando todos los movimientos generados desde compras y ventas.