Saltar a contenido

0018. CRUD de los catálogos por empresa — segundo slice: bancos

Estado: Aceptado Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/

Contexto

El ADR 0017 abrió los catálogos por empresa con cat_feriados. Este ADR lo replica para cat_bancos, que como monedas y países tiene codigo único — pero por empresa: la tabla declara unique(empresa_id, codigo) (uq_cat_bancos_empresa_codigo). El empresa_id se acepta en el body por ahora; cuando exista la capa de autenticación vendrá del token, como ya se documentó en el ADR 0017.

Decisión

Se implementa el CRUD de cat_bancos bajo /api/v1/catalogos/bancos, con la arquitectura de capas router -> service -> repository del ADR 0001 transversal:

  • POST /api/v1/catalogos/bancos crea con 201; PUT /api/v1/catalogos/bancos/{banco_id} actualiza parcialmente con 200; DELETE /api/v1/catalogos/bancos/{banco_id} elimina lógicamente con 204.
  • El repository hace add/commit/refresh y las lecturas filtran deleted_at.
  • Validaciones:
  • empresa_id debe existir en mae_empresas → 404 "Empresa no encontrada" (reutiliza EmpresaNoEncontradoError).
  • El codigo no puede repetirse dentro de la misma empresa → 409 (nueva excepción BancoCodigoDuplicadoError), igual que la constraint uq_cat_bancos_empresa_codigo de la tabla.

Alternativas descartadas

  • Esperar a la capa de autenticación — mismo criterio que el ADR 0017: no hay nada que esperar, el empresa_id se recibe en el body hasta que el token lo provea.
  • Validar el código de forma global — el unique es por empresa, no global: dos empresas pueden usar el mismo código de banco.

Consecuencias

  • Completa los catálogos por empresa junto con el ADR 0017.
  • Cuando llegue la autenticación, el empresa_id del token reemplazará al del body (pendiente documentado).
  • OpenAPI del servicio suma 3 endpoints (pasa a 40).