Saltar a contenido

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_plazo es obligatorio al crear y se valida entre 0 y 32 767 (tope de smallint): fuera de ese rango responde 422 y no llega a la base.
  • dias_plazo no se edita por PUT, igual que el código: el TerminoPagoActualizarRequest no 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_plazo y después por codigo (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 smallint darí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.