Saltar a contenido

clientes.cat_tipos_clientes

Propósito

Clasifica la naturaleza jurídica del cliente. Los valores previstos son PERSONA_NATURAL y PERSONA_JURIDICA; se configuran por empresa. No describe su canal, rol comercial, clase A/B/C ni modalidad de venta. Por tanto, DISTRIBUIDOR, MAYORISTA y DETALLISTA no pertenecen a este catálogo.

El CRM usará una sola definición de esta naturaleza jurídica. Antes de migrar datos se debe comprobar si core.identidad ya aporta este dato y acordar cuál sistema lo gobierna, para evitar discrepancias entre bases.

Estructura propuesta

Columna Tipo Regla
id uuid Clave primaria
empresa_id bigint Empresa propietaria
codigo varchar(30) Código estable, único por empresa
nombre varchar(100) Nombre visible
descripcion text Explicación opcional
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.cat_tipos_clientes (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    empresa_id BIGINT NOT NULL,
    codigo VARCHAR(30) NOT NULL,
    nombre VARCHAR(100) NOT NULL,
    descripcion TEXT,
    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_tipos_clientes_empresa_id UNIQUE (empresa_id, id),
    CONSTRAINT uq_tipos_clientes_empresa_codigo UNIQUE (empresa_id, codigo)
);

ALTER TABLE clientes.cat_tipos_clientes ENABLE ROW LEVEL SECURITY;
CREATE POLICY rls_tipos_clientes_empresa
    ON clientes.cat_tipos_clientes
    USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT)
    WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT);

Contrato para clientes.mae_clientes

Cuando se modele la nueva mae_clientes, guardará tipo_cliente_id UUID NOT NULL con esta referencia:

CONSTRAINT fk_mae_clientes_tipo_cliente
    FOREIGN KEY (empresa_id, tipo_cliente_id)
    REFERENCES clientes.cat_tipos_clientes (empresa_id, id)

UNIQUE (empresa_id, id) permite crear la FK compuesta en PostgreSQL y garantiza que el tipo pertenezca a la misma empresa. La clasificación jurídica es independiente del tipo_canal_id comercial definido para el cliente.