Bancos

Endpoints para gestionar cuentas bancarias, movimientos y reconciliaciones.

Cuentas bancarias

Listar cuentas

GET /bank-accounts

Crear cuenta

POST /bank-accounts

{
  "name": "Ficohsa Empresarial",
  "bankName": "Ficohsa",
  "accountNumber": "200012345678",
  "currency": "HNL",
  "openingBalance": 50000.00,
  "openingBalanceDate": "2026-01-01",
  "chartOfAccountId": 15,
  "isActive": true
}

Actualizar cuenta

PUT /bank-accounts/:id

Eliminación de cuentas

Solo desde la aplicación web; las integraciones con API key no admiten DELETE en este recurso.

---

Transacciones bancarias

Transferencia entre cuentas

POST /bank-transactions/transfer

{
  "fromAccountId": 1,
  "toAccountId": 2,
  "amount": 5000.00,
  "transactionDate": "2026-04-16",
  "reference": "Transferencia interna"
}

Movimientos automáticos

Los movimientos bancarios se crean automáticamente al registrar pagos en documentos cuando el método de pago tiene una cuenta bancaria vinculada. No es necesario crear movimientos manuales para pagos.

Tipos de movimiento

Tipo	Descripción
payment_doc	Pago de documento (automático)
transfer_in	Transferencia entrante / depósito efectivo
transfer_out	Transferencia saliente / retiro efectivo
deposit	Depósito manual
withdrawal	Retiro manual

---

Reconciliaciones bancarias

Listar reconciliaciones

GET /bank-accounts/:accountId/reconciliations

Crear reconciliación (borrador)

POST /bank-accounts/:accountId/reconciliations

Actualizar borrador

PATCH /bank-accounts/:accountId/reconciliations/:id

Completar reconciliación

POST /bank-accounts/:accountId/reconciliations/:id/complete

---

Interacción con pagos

Cuando se registra un pago en un documento:

1. Si el método de pago tiene bankAccountId, se crea un BankTransaction automáticamente.
2. Pagos con método marcado como isCashMethod generan tipo transfer_in (cobro) o transfer_out (pago compra).
3. Al cancelar un pago, se crea una transacción de reversión con el monto y dirección invertidos.
4. Al eliminar un documento con pagos confirmados, las transacciones bancarias se revierten.

Dirección del movimiento por tipo de documento

Tipo doc	Dirección banco
01, 07, 113, 112, 107 (ventas)	Crédito (dinero entra)
103, 104, 106, 11 (compras)	Débito (dinero sale)
105 (NC compra)	Crédito (reembolso entra)
06 (NC venta)	Débito (reembolso sale)
100, 101 (anticipos cliente)	Crédito (dinero entra)
102 (anticipo proveedor)	Débito (dinero sale)