Saltar a contenido

clientes.trx_perfil_financiero_cliente

Propósito

Conserva el perfil financiero y operativo anual declarado por un cliente. Es un registro histórico por año, separado de mae_clientes, porque sus valores pueden cambiar entre períodos. No depende del módulo de encuestas configurables. Origen legacy: campos financieros de i133t_cartera_clientes.

Esta versión supone un único perfil consolidado por cliente y año calendario. Una corrección actualiza ese registro y deja rastro en la auditoría; no se crean versiones mientras no exista un requisito legal o de auditoría que las exija.

Estructura propuesta

Columna Tipo Regla
id uuid Clave primaria
empresa_id bigint Empresa propietaria
cliente_id uuid Cliente al que corresponde el perfil
anio smallint Año calendario de los datos
fecha_declaracion date Fecha de captura o declaración, opcional
ingreso numeric(16,2) Ingreso anual declarado, opcional
egreso numeric(16,2) Egreso anual declarado, opcional
utilidad_bruta numeric(16,2) Utilidad bruta declarada; puede ser negativa
utilidad_operativa numeric(16,2) Utilidad operativa declarada; puede ser negativa
anios_operaciones smallint Años de operación declarados, no negativo
anios_comerciales smallint Años de actividad comercial declarados, no negativo
cantidad_empleados integer Cantidad declarada, no negativa
cantidad_sucursales integer Cantidad declarada del negocio del cliente, no negativa
cantidad_vendedores integer Cantidad declarada del negocio del cliente, no negativa
cantidad_clientes integer Cantidad declarada del negocio del cliente, no negativa
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.trx_perfil_financiero_cliente (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    empresa_id BIGINT NOT NULL,
    cliente_id UUID NOT NULL,
    anio SMALLINT NOT NULL,
    fecha_declaracion DATE,
    ingreso NUMERIC(16,2),
    egreso NUMERIC(16,2),
    utilidad_bruta NUMERIC(16,2),
    utilidad_operativa NUMERIC(16,2),
    anios_operaciones SMALLINT,
    anios_comerciales SMALLINT,
    cantidad_empleados INTEGER,
    cantidad_sucursales INTEGER,
    cantidad_vendedores INTEGER,
    cantidad_clientes INTEGER,
    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_trx_perfil_financiero_empresa_id UNIQUE (empresa_id, id),
    CONSTRAINT uq_trx_perfil_financiero_cliente_anio
        UNIQUE (empresa_id, cliente_id, anio),
    CONSTRAINT fk_trx_perfil_financiero_cliente
        FOREIGN KEY (empresa_id, cliente_id)
        REFERENCES clientes.mae_clientes (empresa_id, id),
    CONSTRAINT ck_trx_perfil_financiero_anio
        CHECK (anio BETWEEN 1900 AND 2100),
    CONSTRAINT ck_trx_perfil_financiero_ingreso
        CHECK (ingreso IS NULL OR ingreso >= 0),
    CONSTRAINT ck_trx_perfil_financiero_egreso
        CHECK (egreso IS NULL OR egreso >= 0),
    CONSTRAINT ck_trx_perfil_financiero_anios_operaciones
        CHECK (anios_operaciones IS NULL OR anios_operaciones >= 0),
    CONSTRAINT ck_trx_perfil_financiero_anios_comerciales
        CHECK (anios_comerciales IS NULL OR anios_comerciales >= 0),
    CONSTRAINT ck_trx_perfil_financiero_cantidad_empleados
        CHECK (cantidad_empleados IS NULL OR cantidad_empleados >= 0),
    CONSTRAINT ck_trx_perfil_financiero_cantidad_sucursales
        CHECK (cantidad_sucursales IS NULL OR cantidad_sucursales >= 0),
    CONSTRAINT ck_trx_perfil_financiero_cantidad_vendedores
        CHECK (cantidad_vendedores IS NULL OR cantidad_vendedores >= 0),
    CONSTRAINT ck_trx_perfil_financiero_cantidad_clientes
        CHECK (cantidad_clientes IS NULL OR cantidad_clientes >= 0)
);

CREATE INDEX ix_trx_perfil_financiero_empresa_cliente_anio
    ON clientes.trx_perfil_financiero_cliente (empresa_id, cliente_id, anio);

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

Reglas de interpretación

  • Los importes se almacenan según la convención monetaria acordada por cada empresa. Esta tabla no guarda moneda_codigo; no se deben comparar importes entre empresas sin una conversión externa definida.
  • cantidad_sucursales, cantidad_vendedores y cantidad_clientes son cifras declaradas del negocio del cliente. No son conteos automáticos de mae_locales_cliente, rel_clientes_promotores ni de otras tablas CRM.
  • Las utilidades pueden ser negativas cuando representan pérdidas. No se calculan automáticamente a partir de ingreso y egreso, porque sus definiciones contables no están establecidas.
  • No se incluyen facturacion_externa, tiene_instalaciones_propias, tiene_distribucion_propia ni cliente_vigente. El primer campo no tiene una definición verificable y los dos siguientes son banderas de negocio aún no modeladas; el último duplicaría el estado del cliente.
  • La FK comprueba existencia y misma empresa, pero no que el cliente siga activo. La operación de alta debe impedir perfiles nuevos para clientes inactivos o borrados lógicamente; los perfiles históricos se conservan si el cliente cambia de estado.
  • Las correcciones actualizan la fila del año y sus campos de auditoría. Si el negocio necesita conservar declaraciones sucesivas, habrá que añadir un modelo de revisiones en una etapa posterior.