Financieros Service

FinancierosService concentra la configuración financiera estable del tenant. Opera sobre categorías bancarias, bancos, categorías de movimiento, libro banco y lectura base de conciliación.

Responsabilidad

Área	Métodos	Repositorio
Categorías bancarias	getCategorias, createCategoria, updateCategoria, deleteCategoria	FinancierosRepository
Bancos	getBancos, getBanco, createBanco, updateBanco, deleteBanco	FinancierosRepository
Categorías de movimiento	getCategoriasMovimiento, createCategoriaMovimiento, updateCategoriaMovimiento	FinancierosRepository
Libro banco	getLibroBanco	FinancierosRepository
Conciliación base	getConciliacion	FinancierosRepository

Validaciones

Operación	Regla
Crear categoría bancaria	Requiere codigo, nombre y tipo.
Tipo de categoría bancaria	Solo acepta BANCO, PRESTAMO, LINEA_CREDITO, INVERSION, OTRO.
Cuenta contable de categoría	Si se informa, debe existir en administracion.plan_contable y pertenecer a los padres permitidos por tipo.
Crear banco	Requiere nombre, categoria_id, numero_cuenta y tipo_cuenta.
Tipo de cuenta bancaria	Solo acepta CTA_CTE, AHORRO, VISTA, CAJA, OTRO.
Categoría de movimiento	Requiere codigo, nombre y aplica_a; aplica_a debe ser ABONO, CARGO o AMBOS.

Cuentas Permitidas por Tipo

Tipo	Padres contables permitidos
BANCO	1101200
INVERSION	1102000
LINEA_CREDITO	2101000, 210100
PRESTAMO	2101100, 2201000

Validación por padre

La validación acepta que la cuenta informada sea directamente uno de los códigos permitidos o que tenga codigo_padre dentro del grupo permitido.

Endpoints

Método	Ruta	Service call
GET	/api/financieros/categorias	getCategorias(ctx, soloActivas)
POST	/api/financieros/categorias	createCategoria(ctx, body)
PUT	/api/financieros/categorias/:id	updateCategoria(ctx, id, body)
DELETE	/api/financieros/categorias/:id	deleteCategoria(ctx, id)
GET	/api/financieros/bancos	getBancos(ctx, soloActivos, fechaHasta)
POST	/api/financieros/bancos	createBanco(ctx, body)
PUT	/api/financieros/bancos/:id	updateBanco(ctx, id, body)
DELETE	/api/financieros/bancos/:id	deleteBanco(ctx, id)
GET	/api/financieros/categorias-movimiento	getCategoriasMovimiento(ctx)
GET	/api/financieros/libro-banco?bancoId&anio&mes	getLibroBanco(ctx, bancoId, anio, mes)

Patrón

El servicio aplica BaseService como Template Method para transacciones y resultados, pero mantiene consultas de lectura directas contra el pool del tenant. Las mutaciones de creación y actualización usan withTransaction; las lecturas no abren transacción.