Saltar a contenido

0017. Catálogo cat_metodos_pago: requisitos del cobro por defecto false

Estado: Aceptado Fecha: 2026-10-07 Autor: David Garcia Módulo(s) afectado(s): app/domains/catalogos/, alembic/versions/20261007_002_crear_cat_metodos_pago.py Complementa a: ADR 0015

Contexto

cat_metodos_pago define las formas de pago de un cobro en campo (efectivo, transferencia, cheque...). Además de codigo y nombre trae dos booleanos obligatorios, sin default en el borrador del modelo de datos: requiere_banco_referencia (el cobro debe indicar banco y referencia) y requiere_imagen_comprobante (el cobro debe adjuntar foto del comprobante). El CRUD sigue el estándar del ADR 0015; falta decidir cómo se llenan.

Decisión

  • Ambos booleanos valen false por defecto, en la API y en la base (server_default false), con el mismo criterio que requiere_geolocalizacion en el ADR 0016.
  • Ambos son editables. PUT reemplaza todos los campos editables: si uno no viene, toma false.
Tabla Ruta (/api/v1/catalogos/...) Migración
cat_metodos_pago metodos-pago 20261007_002

Alternativas descartadas

  • Obligatorios en la entrada, como en el borrador — obliga a enviarlos siempre, aunque lo habitual (efectivo) es que no se requiera nada.
  • Default true — exigiría banco y comprobante a métodos que no los tienen, como el efectivo.

Consecuencias

  • Un método de pago creado sin indicar los requisitos no exige nada al cobro.
  • El frontend debe enviar en el PUT el valor vigente de ambos campos; si los omite, quedan en false.
  • Las reglas que usan estos campos (exigir banco o comprobante al registrar un cobro) se aplican cuando exista trx_cobros_campo, no en este catálogo.

Media página como máximo. Si el ADR crece más que eso, probablemente estás documentando el diseño completo del módulo, no una decisión puntual — separa.