0016. CRUD de los catálogos — octavo slice: tipos de clientes¶
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 y cierra los 8 catálogos comerciales.
cat_tipos_clientes clasifica la naturaleza jurídica del cliente
(PERSONA_NATURAL, PERSONA_JURIDICA) y tiene la misma forma que canales.
docs-sql advierte que svc-identidad ya distingue persona natural y jurídica
(hoy como tipo_contribuyente de mae_personas_comerciales, ADR 0067 de
identidad), y que antes de migrar datos hay que acordar qué sistema gobierna el dato.
Decisión¶
- Endpoints bajo
/api/v1/catalogos/tipos-clientes, con los mismos códigos y reglas que canales comerciales (ADR 0008). - Sin reglas propias ni datos precargados.
- La superposición con svc-identidad queda pendiente: el catálogo se expone
porque
mae_clientes.tipo_cliente_idya lo referencia.
Alternativas descartadas¶
- Esperar el acuerdo con svc-identidad —
mae_clientesexige el tipo desde su alta; sin el CRUD no habría cómo cargarlo. - Admitir clasificaciones comerciales (
DISTRIBUIDOR,MAYORISTA) — docs-sql las excluye: pertenecen a canales y clases de cliente.
Consecuencias¶
- La API expone 40 operaciones de catálogos (8 catálogos × 5).
- Si svc-identidad pasa a gobernar el dato, este catálogo se reemplaza por una referencia a identidad en un ADR nuevo.
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.