0013. CRUD de los catálogos — quinto slice: términos de pago¶
Estado: Propuesto Fecha: 2026-09-30 Autor: Kevin Delgado Lopez Módulo(s) afectado(s): app/domains/catalogos/, tests/unit/catalogos/
Contexto¶
Sigue el molde del ADR 0008. cat_terminos_pago define cuándo se paga una
operación y agrega dias_plazo (smallint, CHECK dias_plazo >= 0; contado
= 0). docs-sql pide que cambiar el plazo de un término no modifique las
obligaciones ya pactadas: si cambian las condiciones, se crea o versiona otro
término.
Decisión¶
- Endpoints bajo
/api/v1/catalogos/terminos-pago, con los mismos códigos y reglas que canales comerciales (ADR 0008). dias_plazoes obligatorio al crear y se valida entre 0 y 32 767 (tope desmallint): fuera de ese rango responde 422 y no llega a la base.dias_plazono se edita porPUT, igual que el código: elTerminoPagoActualizarRequestno lo declara, así que enviarlo da 422. Para otro plazo se crea un término nuevo y, si hace falta, se borra el anterior.- El listado se ordena por
dias_plazoy después porcodigo(contado primero).
Alternativas descartadas¶
- Permitir editar
dias_plazo— cuando existan operaciones que lo usen, cambiarlo alteraría en silencio lo que el término significa para ellas. - Dejar que la base rechace el plazo inválido — el CHECK o el desborde de
smallintdarían un 500 en lugar de un 422 claro.
Consecuencias¶
- La API expone 25 operaciones de catálogos (5 catálogos × 5).
- Corregir un plazo mal cargado exige crear otro término; el código del anterior queda ocupado porque el UNIQUE cuenta los borrados.
- Las operaciones que usen el término deberán guardar su propia fecha de vencimiento (docs-sql); eso se resuelve en su tabla, no aquí.
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.