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
falsepor defecto, en la API y en la base (server_default false), con el mismo criterio querequiere_geolocalizacionen el ADR 0016. - Ambos son editables.
PUTreemplaza todos los campos editables: si uno no viene, tomafalse.
| 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
PUTel valor vigente de ambos campos; si los omite, quedan enfalse. - 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.