clientes.mae_clientes¶
Propósito¶
Guarda la identidad comercial y fiscal básica del cliente por empresa. Los datos de contacto, domicilio, crédito, despacho y asignación de promotores se modelarán en sus tablas correspondientes. La ficha conserva las clasificaciones ya acordadas: naturaleza jurídica, subcanal comercial y clase A/B/C. El modelo comercial se deja como referencia opcional al catálogo provisional. Cada cliente puede pertenecer a un solo grupo económico o a ninguno. El término de pago por defecto es opcional: el pedido lo toma como valor inicial.
tipo_cliente_id significa únicamente PERSONA_NATURAL o PERSONA_JURIDICA. tipo_canal_id identifica el subcanal; el canal padre se obtiene de cat_tipos_canal_comercial.canal_id, sin repetirlo aquí. Para un canal sin subdivisión debe existir un tipo GENERAL. clase_cliente_id puede quedar vacío hasta clasificar al cliente.
Estructura propuesta¶
| Columna | Tipo | Regla |
|---|---|---|
id |
uuid |
Clave primaria |
empresa_id |
bigint |
Empresa propietaria |
codigo |
varchar(30) |
Código interno único por empresa |
razon_social |
varchar(200) |
Nombre legal obligatorio |
nombre_comercial |
varchar(200) |
Nombre comercial opcional |
tipo_identificacion_id |
uuid |
Identificador lógico del tipo de identificación en core |
numero_documento |
varchar(30) |
Documento del cliente, obligatorio |
tipo_cliente_id |
uuid |
Naturaleza jurídica, obligatoria |
tipo_canal_id |
uuid |
Subcanal comercial, obligatorio |
clase_cliente_id |
uuid |
Clase A/B/C, opcional |
modelo_comercial_id |
uuid |
Modelo comercial, opcional y sin valores definidos aún |
grupo_economico_id |
uuid |
Grupo económico actual, opcional; uno por cliente |
unidad_comercial_id |
uuid |
Unidad comercial actual, opcional; B2B/B2C/B2G/B2E según negocio |
termino_pago_id |
uuid |
Término de pago por defecto, opcional; el pedido lo toma como valor inicial |
contacto_principal_id |
uuid |
Contacto principal opcional, vinculado a este mismo cliente |
fecha_registro |
date |
Fecha de alta según el negocio |
is_activo |
boolean |
Estado administrativo; por defecto true |
created_at / updated_at |
timestamptz |
Fechas de auditoría obligatorias |
deleted_at |
timestamptz |
Borrado lógico, opcional |
created_by / updated_by |
uuid |
Usuarios de auditoría, opcionales |
CREATE TABLE clientes.mae_clientes (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
empresa_id BIGINT NOT NULL,
codigo VARCHAR(30) NOT NULL,
razon_social VARCHAR(200) NOT NULL,
nombre_comercial VARCHAR(200),
tipo_identificacion_id UUID NOT NULL,
numero_documento VARCHAR(30) NOT NULL,
tipo_cliente_id UUID NOT NULL,
tipo_canal_id UUID NOT NULL,
clase_cliente_id UUID,
modelo_comercial_id UUID,
grupo_economico_id UUID,
unidad_comercial_id UUID,
termino_pago_id UUID,
contacto_principal_id UUID,
fecha_registro DATE NOT NULL,
is_activo BOOLEAN NOT NULL DEFAULT true,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
deleted_at TIMESTAMPTZ,
created_by UUID,
updated_by UUID,
CONSTRAINT uq_mae_clientes_empresa_id UNIQUE (empresa_id, id),
CONSTRAINT uq_mae_clientes_empresa_codigo UNIQUE (empresa_id, codigo),
CONSTRAINT uq_mae_clientes_empresa_documento
UNIQUE (empresa_id, tipo_identificacion_id, numero_documento),
CONSTRAINT fk_mae_clientes_tipo_cliente
FOREIGN KEY (empresa_id, tipo_cliente_id)
REFERENCES clientes.cat_tipos_clientes (empresa_id, id),
CONSTRAINT fk_mae_clientes_tipo_canal
FOREIGN KEY (empresa_id, tipo_canal_id)
REFERENCES clientes.cat_tipos_canal_comercial (empresa_id, id),
CONSTRAINT fk_mae_clientes_clase
FOREIGN KEY (empresa_id, clase_cliente_id)
REFERENCES clientes.cat_clases_cliente (empresa_id, id),
CONSTRAINT fk_mae_clientes_modelo
FOREIGN KEY (empresa_id, modelo_comercial_id)
REFERENCES clientes.cat_modelos_comerciales (empresa_id, id),
CONSTRAINT fk_mae_clientes_grupo_economico
FOREIGN KEY (empresa_id, grupo_economico_id)
REFERENCES clientes.mae_grupos_economicos (empresa_id, id),
CONSTRAINT fk_mae_clientes_unidad_comercial
FOREIGN KEY (empresa_id, unidad_comercial_id)
REFERENCES clientes.cat_unidades_comerciales (empresa_id, id),
CONSTRAINT fk_mae_clientes_termino_pago
FOREIGN KEY (empresa_id, termino_pago_id)
REFERENCES clientes.cat_terminos_pago (empresa_id, id)
);
CREATE INDEX ix_mae_clientes_empresa_tipo_canal
ON clientes.mae_clientes (empresa_id, tipo_canal_id);
CREATE INDEX ix_mae_clientes_empresa_clase
ON clientes.mae_clientes (empresa_id, clase_cliente_id);
CREATE INDEX ix_mae_clientes_empresa_grupo_economico
ON clientes.mae_clientes (empresa_id, grupo_economico_id);
CREATE INDEX ix_mae_clientes_empresa_unidad_comercial
ON clientes.mae_clientes (empresa_id, unidad_comercial_id);
CREATE INDEX ix_mae_clientes_empresa_termino_pago
ON clientes.mae_clientes (empresa_id, termino_pago_id);
ALTER TABLE clientes.mae_clientes ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_mae_clientes_empresa
ON clientes.mae_clientes
USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);
Relaciones y decisiones pendientes¶
tipo_identificacion_id UUIDcorresponde alid UUIDdocumentado encore.identidad.cat_tipos_identificacionde la basecore. Es una correlación lógica, sin FK física entre bases; la existencia y vigencia del tipo deberán validarse mediante la integración con core.- La unicidad de
(empresa_id, tipo_identificacion_id, numero_documento)se aplica también a clientes borrados lógicamente. Revisar duplicados y posibles documentos compartidos en el legacy antes de cargar datos. Confirmar la compatibilidad entre tipo de identificación y naturaleza jurídica. modelo_comercial_idpuede quedarNULL; no se cargan valores hasta definir el significado del catálogo con la empresa. Si un cliente puede tener varios modelos o vigencias, sustituir la FK singular por una relación apropiada.grupo_economico_idrepresenta la pertenencia actual a cero o un grupo de la misma empresa. Esta FK no guarda historial de cambios; si el negocio lo requiere después, se añadirá una tabla de historial sin permitir dos grupos vigentes a la vez.unidad_comercial_idconserva el término del negocio para B2B/B2C/B2G/B2E. Es opcional y representa una unidad actual por cliente; no equivale al canal comercial ni a una sucursal interna. Se debe confirmar el significado de cada código antes de migrar valores. No se crearel_unidades_comerciales_sucursales.termino_pago_ides el término de pago por defecto del cliente (legacyi133t_cartera_clientes.co_tipo_credito, lleno en el 100 % de los clientes). Es opcional.trx_pedidos.termino_pago_idlo toma como valor inicial y puede cambiarlo en cada pedido: el término del pedido no se deriva del cliente después de creado. La FK compuesta exige un término de la misma empresa.- Los contactos se comparten entre clientes mediante
rel_clientes_contactos.contacto_principal_idse valida contra el vínculo del mismo cliente mediante una FK compuesta, declarada después de crear la relación enrel_clientes_contactos.md. No se crea un campo ni un rol específico de representante legal.ciudad_id, dirección detallada y coordenadas pertenecen a cada fila demae_locales_cliente. - No se incluyen
zona_id,cliente_padre_id,magnitud_id,canal_venta_idniis_vigente. Origen y estado de validación continúan pendientes de diseño.fecha_registroes una fecha de negocio distinta decreated_at.