INICIO¶
Documentación y Especificación Técnica: CRM de Fuerza de Ventas y Ecosistema SIGFA Pro¶
Fecha: 2026-09-10
Autores: Kevin Delgado, David Garcia & Duval Alcivar
Arquitectura: Microservicios Desacoplados + Multi-Tenancy RLS (BIGINT)
Bases de Datos: core, crm
Gestión de ENUMs: Gestionados en la capa de código / backend (FastAPI / Pydantic / SQLAlchemy 2.0); en PostgreSQL se persisten como VARCHAR(...).
1. Contexto y Principios de Diseño¶
El sistema legacy (SIGFA / SIGFAPRO) mantenía tablas monolíticas desnormalizadas (por ejemplo, i133t_cartera_clientes con 68 columnas y i127t_promotor con 61 columnas) donde se mezclaban datos de identidad personal, encuestas socioeconómicas, datos transaccionales, credenciales de acceso y blobs binarios (bytea).
Para la nueva arquitectura de microservicios, el ecosistema se normaliza en Tercera Forma Normal (3NF) práctica y se estructura respetando los siguientes principios rectores de diseño:
- Aislamiento por Microservicios y Bounded Contexts:
- La plataforma se divide en dos bases de datos físicas independientes:
core(servicios transversales de identidad y empresa) ycrm(gestión comercial de clientes, fuerza de ventas, pedidos y recaudación). -
Desacoplamiento Cross-Database: No existen Foreign Keys físicas entre bases de datos distintas. La integración entre servicios se realiza mediante correlación lógica por
UUID(p. ej.,cliente_id,promotor_id,usuario_id,persona_id). -
Aislamiento Multi-Tenant por Empresa (PostgreSQL RLS):
- Toda tabla con tenencia incorpora la columna obligatoria
empresa_id BIGINT NOT NULL. -
El aislamiento se garantiza a nivel de motor de base de datos mediante PostgreSQL Row-Level Security (RLS) utilizando la variable de sesión
app.current_empresa_id:ALTER TABLE <schema>.<tabla> ENABLE ROW LEVEL SECURITY; CREATE POLICY rls_<tabla>_empresa ON <schema>.<tabla> FOR ALL USING (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT) WITH CHECK (empresa_id = current_setting('app.current_empresa_id', true)::BIGINT); -
Integridad Referencial Compuesta Intra-Servicio:
- Todas las claves foráneas internas dentro del mismo esquema/base de datos que involucran tablas con tenencia son compuestas:
CONSTRAINT fk_<tabla>_<relacion> FOREIGN KEY (empresa_id, <fk_id>) REFERENCES <schema>.<tabla_padre> (empresa_id, id) ON DELETE RESTRICT -- o ON DELETE CASCADE según el caso -
Cada tabla dispone de la restricción
CONSTRAINT uq_<tabla>_empresa_id UNIQUE (empresa_id, id)como destino de integridad. -
Identificadores y Códigos de Negocio:
- La clave primaria estándar es
id UUID NOT NULL DEFAULT gen_random_uuid()(a excepción deidentidad.mae_empresasque actúa como raíz numérica conid BIGINT GENERATED ALWAYS AS IDENTITY). -
Los códigos de negocio (
codigo VARCHAR(30) NOT NULL) son únicos por empresa medianteCONSTRAINT uq_<tabla>_empresa_codigo UNIQUE (empresa_id, codigo). -
Auditoría Estándar Unificada:
- Todas las entidades implementan el bloque de auditoría estándar de 6 columnas:
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.
2. Especificación Detallada de Tablas + DBML + Script SQL¶
Orden de especificación arquitectónica: MAE > TRX > TRX ... DETALLE > CAT > REL > LOG > CFG.
2.0. Accesos Rápidos por Servicio¶
Cada servicio incluye tres capas de documentación: las especificaciones de tablas (DBML + SQL), las migraciones Alembic y los modelos SQLAlchemy.
| Servicio | Especificaciones | Migraciones (Alembic) | Modelos (SQLAlchemy) |
|---|---|---|---|
core.svc-identidad |
Tablas | README | Modelos |
core.svc-notificaciones |
Tablas | README | Modelos |
crm.svc-clientes |
Tablas | README | Modelos |
crm.svc-fuerza_ventas |
Tablas | README | Modelos |
2.1. Base de Datos Core (core)¶
Servicio centralizado encargado de la gobernanza de tenants, identidades personales, usuarios del sistema, sucursales y catálogos geográficos y fiscales globales.
2.1.1. Tablas Maestras (mae)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.mae_empresas |
identidad |
i034t_empresa |
Entidad troncal y raíz de empresas/tenants de toda la plataforma SIGFA Pro. | Ver Especificación |
identidad.mae_personas |
identidad |
i127t (identidad) |
Registro centralizado de personas naturales (nombres, apellidos, documento de identidad, contacto y fotografía). | Ver Especificación |
identidad.mae_sucursales |
identidad |
i145t_sucursal |
Sedes y sucursales físicas operativas de la empresa con ubicación geográfica y datos de contacto. | Ver Especificación |
identidad.mae_usuarios |
identidad |
i127t (credenciales) |
Cuenta de acceso de usuario al sistema (autenticación, username, password hash y estado de sesión). | Ver Especificación |
identidad.mae_entidades |
identidad |
— | Raíz polimórfica del patrón party: persona natural o jurídica (ADR 0022). | Ver Especificación |
identidad.mae_personas_juridicas |
identidad |
— | Personas jurídicas externas (nombre, identificación fiscal, ubicación) con cuenta de usuario (ADR 0022). | Ver Especificación |
2.1.2. Tablas Transaccionales (trx)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.trx_refresh_tokens |
identidad |
— | Rotación de refresh tokens (hash SHA-256) con expiración y revocación lógica. | Ver Especificación |
2.1.3. Tablas Transaccionales Detalle (trx ... detalle)¶
No aplica para este esquema / servicio.
2.1.4. Tablas Catálogos (cat)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.cat_paises |
identidad |
i123t_pais |
Catálogo global de países (ISO 3166-1 alfa-3). | Ver Especificación |
identidad.cat_ciudades |
identidad |
i126t_ciudad |
Catálogo global de ciudades asociadas a países. | Ver Especificación |
identidad.cat_tipos_identificacion |
identidad |
i035t_doc_ident |
Catálogo fusionado de tipos de identificación (RUC, Cédula, Pasaporte) con codigo único y reglas de validación de longitud/regex; absorbió cat_tipos_documentos (ADR 0012 core-svc-identidad). |
Ver Especificación |
identidad.cat_generos |
identidad |
— | Géneros para el perfil de personas. | Ver Especificación |
identidad.cat_monedas |
identidad |
i124t_moneda |
Catálogo global de monedas soportadas (código ISO 4217 y símbolo). | Ver Especificación |
identidad.cat_aplicaciones |
identidad |
— | Aplicaciones del núcleo activables por empresa. | Ver Especificación |
identidad.cat_tipos_usuario |
identidad |
— | Tipos de cuenta de usuario (usuario, root, externo). |
Ver Especificación |
identidad.cat_provincias |
identidad |
i125t_provincia |
Catálogo de provincias o divisiones territoriales por país. | Ver Especificación |
identidad.cat_feriados |
identidad |
core_sigfa.cat_feriados |
Catálogo de feriados por empresa y país para calendarios laborales. | Ver Especificación |
identidad.cat_bancos |
identidad |
co_banco |
Catálogo de instituciones bancarias y financieras por empresa. | Ver Especificación |
identidad.cat_tipos_documentosfue eliminada por el ADR 0012 de core-svc-identidad (migración20260929_001): se fusionó dentro decat_tipos_identificacion. Su documentación se conserva como nota histórica en 0010-cat_tipos_documentos.md.
2.1.5. Tablas Relación (rel)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.rel_usuario_empresa |
identidad |
— | Membresía de usuarios a empresas del núcleo. | Ver Especificación |
identidad.rel_usuario_sucursal |
identidad |
— | Sucursales asignadas a cada usuario. | Ver Especificación |
identidad.rel_empresa_aplicacion |
identidad |
— | Aplicaciones habilitadas por empresa. | Ver Especificación |
identidad.rel_usuario_accion |
identidad |
— | Permisos por usuario o tipo de usuario sobre una acción (un solo sujeto por fila). | Ver Especificación |
2.1.6. Tablas de Auditoría y Trazabilidad (log)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.log_sesiones |
identidad |
— | Bitácora de eventos de sesión (login, logout, fallos). | Ver Especificación |
erp.audit_log |
erp |
— | Bitácora de auditoría particionada por mes, en la base del producto. | Ver Especificación |
2.1.7. Tablas de Configuración (cfg)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
identidad.cfg_modulos |
identidad |
— | Módulos configurados por empresa y aplicación. | Ver Especificación |
identidad.cfg_menu |
identidad |
— | Menú jerárquico por empresa y módulo (niveles 1..3). | Ver Especificación |
identidad.cfg_menu_acciones |
identidad |
— | Acciones autorizables por menú. | Ver Especificación |
2.1.8. Tablas del Servicio de Notificaciones (notificaciones)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
notificaciones.cat_canales |
notificaciones |
— | Catálogo global de canales de notificación (correo, WhatsApp, push). | Ver Especificación |
notificaciones.cat_tipos_marcacion |
notificaciones |
— | Catálogo global de tipos de marcación biométrica (entrada/salida). | Ver Especificación |
notificaciones.mae_plantillas_mensaje |
notificaciones |
— | Plantillas reutilizables de mensajes por empresa y canal. | Ver Especificación |
notificaciones.mae_grupos_destinatarios |
notificaciones |
— | Grupos de destinatarios para envíos masivos por empresa. | Ver Especificación |
notificaciones.mae_dispositivos_biometricos |
notificaciones |
— | Dispositivos biométricos registrados para captura de marcaciones. | Ver Especificación |
notificaciones.rel_grupo_destinatario_usuario |
notificaciones |
— | Vinculación N:M entre grupos de destinatarios y usuarios. | Ver Especificación |
notificaciones.trx_mensajes |
notificaciones |
— | Cola transaccional de mensajes a enviar con estados y reintentos. | Ver Especificación |
notificaciones.trx_marcaciones |
notificaciones |
— | Marcaciones biométricas de dispositivos (particionada por fecha). | Ver Especificación |
2.2. Base de Datos CRM (crm)¶
Módulo comercial y operativo encargado de la administración integral de clientes, cartera crediticia, gestión de promotores de venta, órdenes de pedido, planificación de despachos, visitas en ruta, encuestas comerciales, avisos de cobranza y recaudaciones de campo.
2.2.1. Tablas Maestras (mae)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.mae_clientes |
clientes |
i133t_cartera_clientes (68 col) |
Entidad central del cliente comercial. Contiene la información de identidad comercial, categorización y estado de relación con la empresa. Los aspectos financieros y fiscales se delegan a satélites 1:1 o servicios especializados. | Ver Especificación |
clientes.mae_contactos_cliente |
clientes |
i134t_contacto_cliente |
Directorio maestro de personas de contacto comercial para clientes. | Ver Especificación |
clientes.mae_prospectos |
clientes |
c063t_agenda_actividades |
Gestión de oportunidades comerciales y leads capturados en campo por los promotores antes de su conversión y alta formal como clientes. | Ver Especificación |
clientes.mae_documentos_cliente |
clientes |
i287t_documentos_cliente |
Expediente digital de documentos mercantiles y legales (RUC, Cédula Representante, Contrato de Crédito, Pagaré, Permisos) almacenados en Object Storage (S3 / MinIO). | Ver Especificación |
clientes.mae_locales_cliente |
clientes |
i339t_locales_cliente |
Sucursales, almacenes y puntos de entrega físicos geolocalizados del cliente para visitas de promotores, geocercas móviles y despacho logístico de mercadería. | Ver Especificación |
fuerza_ventas.mae_promotores |
fuerza_ventas |
i127t_promotor (61 col) |
Perfil comercial del promotor de ventas. Aísla la identidad de usuario y credenciales (delegadas a core.identidad) y se enfoca en parámetros comerciales, metas, comisiones y cupos de crédito comercial. | Ver Especificación |
fuerza_ventas.mae_metas_promotores |
fuerza_ventas |
i176t_meta_promotor |
Objetivos mensuales o periódicos de ventas, cobertura de clientes compradores, visitas efectivas y recaudación asignados a los promotores comerciales. | Ver Especificación |
fuerza_ventas.mae_agencias |
fuerza_ventas |
i283t_agencia_promotor |
Células organizacionales y agencias comerciales intermedias para estructurar grupos de venta regionales y líneas de supervisión comercial. | Ver Especificación |
fuerza_ventas.mae_presupuestos_cliente |
fuerza_ventas |
i714t_presupuesto_cliente |
Presupuesto comercial y proyección mensual de ventas acordada por cada cliente específico bajo la atención de un promotor determinado. | Ver Especificación |
fuerza_ventas.mae_equipos_consignacion |
fuerza_ventas |
c221t / c222t |
Control y trazabilidad de activos de la empresa entregados a clientes en calidad de comodato o consignación (neveras, dispensadores, exhibidores POP, racks, balanzas). | Ver Especificación |
2.2.2. Tablas Transaccionales (trx)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.trx_encuestas_cliente |
clientes |
c061t / c062t |
Cabecera de encuestas, censos comerciales y evaluaciones de satisfacción aplicadas en campo por promotores durante visitas a clientes o prospectos. | Ver Especificación |
fuerza_ventas.trx_pedidos |
fuerza_ventas |
c067t_pedido |
Cabecera de órdenes de pedido generadas desde la aplicación móvil de promotores hacia el dominio de pedidos. | Ver Especificación |
fuerza_ventas.trx_visitas_requerimientos |
fuerza_ventas |
c065t_requerimientos_visita |
Requerimientos comerciales, técnicos, materiales POP y reclamos solicitados durante una visita. Normaliza requerimientos 1:N con ciclo de vida, fechas de compromiso y asignación de responsables. | Ver Especificación |
fuerza_ventas.trx_visitas_documentos |
fuerza_ventas |
c064t_documentos_agenda |
Evidencias fotográficas, firmas digitales y actas de visita capturadas en la app móvil y almacenadas en Object Storage (S3 / MinIO). | Ver Especificación |
fuerza_ventas.trx_avisos_cobro |
fuerza_ventas |
c213t_amortizacion_cliente / vi_aviso_cobro |
Programación y seguimiento de órdenes de cobranza asignadas a los promotores en campo para la gestión y recaudación de facturas de clientes. | Ver Especificación |
fuerza_ventas.trx_visitas |
fuerza_ventas |
c063t_agenda_actividades |
Cabecera principal de actividades y visitas en ruta de la fuerza de ventas. Incorpora validación de exclusividad de destino (cliente formal vs prospecto lead) y registro georreferenciado de check-in / check-out móvil. | Ver Especificación |
fuerza_ventas.trx_cobros_campo |
fuerza_ventas |
c213t_amortizacion_cliente |
Registro de cobros y recaudaciones comerciales efectuadas directamente en campo por promotores o cobradores móviles. Conecta los ingresos recibidos en ruta con tesorería. | Ver Especificación |
fuerza_ventas.trx_pedidos_planificaciones |
fuerza_ventas |
c072t_planificacion_pedido |
Cronograma de entregas parciales y despachos escalonados vinculados a una orden de pedido o a líneas específicas de producto. | Ver Especificación |
2.2.3. Tablas Transaccionales Detalle (trx ... detalle)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.trx_encuestas_cliente_detalle |
clientes |
c061t / c062t |
Detalle tipado de respuestas abiertas, numéricas, booleanas y opciones de selección múltiple/única registradas en las encuestas comerciales. | Ver Especificación |
fuerza_ventas.trx_pedidos_detalle |
fuerza_ventas |
c066t_detalle_pedido |
Desglose ítem por ítem de los productos solicitados en el pedido, con alta precisión decimal en precio unitario (NUMERIC(14,4)), cantidades fraccionables (NUMERIC(12,4)) y desglose tributario de descuentos e impuestos. |
Ver Especificación |
fuerza_ventas.trx_avisos_cobro_detalle |
fuerza_ventas |
c213t (arrays paralelos normalizados) |
Desglose de facturas y documentos de deuda vinculados a una orden de cobro en campo. | Ver Especificación |
fuerza_ventas.trx_cobros_campo_imputaciones |
fuerza_ventas |
c213t (descompone arrays co_aviso / nu_abono_aviso) |
Desglose de amortizaciones e imputaciones aplicadas por cada cobro en campo hacia facturas pendientes de cobro u órdenes de cobranza vinculadas. | Ver Especificación |
2.2.4. Tablas Catálogos (cat)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.cat_canales_comerciales |
clientes |
i282t_canales |
Define los canales de distribución comercial de la empresa (p. ej., Tradicional, Moderno, Horeca, Institucional, Exportación). Permite segmentar estrategias de precios y promociones. | Ver Especificación |
clientes.cat_tipos_canal_comercial |
clientes |
i747t_tipo_canal |
Sub-clasificación técnica de los canales comerciales (Mayorista, Minorista, Supermercados, Cadenas) por tenant. | Ver Especificación |
clientes.cat_clases_cliente |
clientes |
i248t_clase_cliente |
Categorización comercial de clientes según volumen, facturación o importancia estratégica (A, B, C, Clave, Corporativo, Distribuidor). | Ver Especificación |
clientes.cat_grupos_economicos |
clientes |
i143t_grupo_economico |
Permite agrupar diferentes clientes y razones sociales bajo un mismo holding empresarial para consolidar análisis de riesgo y cupo global de crédito. | Ver Especificación |
clientes.cat_modelos_comerciales |
clientes |
i746t_modelo_comercial |
Define las modalidades de negocio aplicables a la relación comercial con el cliente (Venta Directa, Consignación, Distribución Exclusiva, Preventa, Autoventa). | Ver Especificación |
clientes.cat_tipos_credito |
clientes |
i132t_tipo_credito |
Condiciones y líneas de financiamiento comercial otorgadas a clientes (Crédito Ordinario, Carta de Crédito, Pagaré, Crédito Documentario). | Ver Especificación |
clientes.cat_terminos_pago |
clientes |
i132t_termino_pago |
Plazos y acuerdos comerciales para la cancelación de pedidos y facturas (Contado Inmediato, 7 días, 15 días, 30 días, 60 días, Anticipado). | Ver Especificación |
clientes.cat_tipos_actividad |
clientes |
i137t_actividad |
Catálogo de tipos de gestión en campo realizadas durante visitas de promotores (Venta, Cobranza, Entrega de Muestras, Auditoría POP, Capacitación, Reclamo). | Ver Especificación |
clientes.cat_tipos_envio |
clientes |
i149t_tipo_envio |
Métodos y modalidades logísticas para entrega de pedidos (Flota Propia, Transporte Tercerizado, Retiro en Planta, Courier Expreso). | Ver Especificación |
clientes.cat_incoterms |
clientes |
i746t_incoterm |
Términos estándar internacionales para operaciones de exportación y despacho comercial (EXW, FOB, CIF, CFR, DDP, DAP). | Ver Especificación |
clientes.cat_tipos_carga |
clientes |
i743t_tipo_carga |
Especificaciones térmicas y de manipulación de la mercancía durante despacho (Carga Seca, Refrigerada, Congelada, Frágil, Peligrosa). | Ver Especificación |
clientes.cat_metodos_pago |
clientes |
i135t_metodo_pago |
Instrumentos monetarios válidos para transacciones y recaudación en campo (Efectivo, Cheque al Día, Cheque Posfechado, Transferencia Bancaria, Tarjeta de Débito/Crédito, Depósito). | Ver Especificación |
clientes.cat_unidades_comerciales |
clientes |
i136t_unidad_comercial |
Divisiones o líneas estratégicas de negocio de la empresa (p. ej., Consumo Masivo, Farmacéutica, Industrial, Institucional) para asignación de promotores. | Ver Especificación |
clientes.cat_encuesta_preguntas |
clientes |
c061t / c062t |
Catálogo formal de preguntas y reactivos utilizados en encuestas de prospección, satisfacción y auditoría de punto de venta (reemplaza arrays desnormalizados y JSON libres). | Ver Especificación |
clientes.cat_encuesta_opciones |
clientes |
c062t_respuesta_pregunta_cerrada |
Opciones predefinidas para preguntas de selección cerrada o múltiple en encuestas comerciales de campo. | Ver Especificación |
clientes.cat_estados_cliente |
clientes |
i014t_estatus |
Catálogo estandarizado de estados comerciales y operativos del cliente (PROSPECTO, ACTIVO, INACTIVO, SUSPENDIDO_CREDITO, BLOQUEADO_LEGAL, DADO_DE_BAJA). | Ver Especificación |
clientes.cat_estados_prospecto |
clientes |
c063t_agenda_actividades |
Fases del embudo de ventas y calificación de leads (NUEVO, EN_CALIFICACION, VISITA_AGENDADA, PROPUESTA_PRESENTADA, CONVERTIDO_A_CLIENTE, DESCARTADO). | Ver Especificación |
clientes.cat_estados_visita |
clientes |
c063t_agenda_actividades |
Máquina de estados de la gestión de visitas en campo (PROGRAMADA, EN_RUTA, INICIADA_CHECKIN, COMPLETADA_CHECKOUT, CANCELADA_NO_CONTACTO, REPROGRAMADA). | Ver Especificación |
clientes.cat_tipos_clientes |
clientes |
i035t_tipo_cliente |
Catálogo maestro de personería jurídica y tributaria del cliente (Persona Natural, Persona Jurédica / Empresa, etc.). | Ver Especificación |
fuerza_ventas.cat_estados_cobro |
fuerza_ventas |
co_estatus |
Catálogo maestro de estados de cobro en ruta para órdenes y avisos de cobranza. | Ver Especificación |
fuerza_ventas.cat_estados_visita |
fuerza_ventas |
co_estatus |
Catálogo de estados de ciclo de vida de visitas para el equipo de promotores. | Ver Especificación |
fuerza_ventas.cat_modalidades_pago_comision |
fuerza_ventas |
i127t.tx_modalidad_pago_comision |
Modalidad de liquidación y pago de comisiones de promotores (CONTADO / CRÉDITO). | Ver Especificación |
fuerza_ventas.cat_tipos_actividad |
fuerza_ventas |
i137t_actividad |
Tipologías de actividad comercial y gestión presencial en campo para promotores. | Ver Especificación |
fuerza_ventas.cat_tipos_requerimiento_visita |
fuerza_ventas |
c065t_req_cliente |
Tipos de requerimiento levantados en visitas (cotizaciones, muestras, material POP, calidad, reclamo). | Ver Especificación |
fuerza_ventas.cat_tipos_promotor |
fuerza_ventas |
i127t_promotor |
Catálogo de tipos de promotor y roles comerciales de venta en campo. | Ver Especificación |
fuerza_ventas.cat_tipos_equipo |
fuerza_ventas |
c221t |
Catálogo de tipologías de equipos y activos entregados en consignación. | Ver Especificación |
fuerza_ventas.cat_estados_equipo |
fuerza_ventas |
c222t |
Catálogo de estados físicos y de mantenimiento de equipos en consignación. | Ver Especificación |
fuerza_ventas.cat_prioridades_requerimiento |
fuerza_ventas |
c065t |
Niveles de prioridad de atención para requerimientos levantados en ruta. | Ver Especificación |
fuerza_ventas.cat_estados_requerimiento_visita |
fuerza_ventas |
c065t |
Catálogo de estados de ciclo de vida de requerimientos y reclamos. | Ver Especificación |
fuerza_ventas.cat_tipos_evidencia_visita |
fuerza_ventas |
c064t |
Tipos de documentos y evidencias adjuntadas a las visitas en ruta. | Ver Especificación |
fuerza_ventas.cat_metodos_pago |
fuerza_ventas |
co_forma |
Catálogo de métodos y formas de pago aceptados en cobranza de campo. | Ver Especificación |
2.2.5. Tablas Relación (rel)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.rel_clientes_promotores |
clientes |
i137t_cliente_promotor |
Asignación de clientes a la cartera comercial de los promotores, definiendo el vendedor titular, el día de visita habitual y la secuencia en la ruta diaria. | Ver Especificación |
clientes.rel_unidades_comerciales_sucursales |
clientes |
i144t_unidad_comercial_sucursal |
Habilitación y despliegue operativo de las líneas y unidades comerciales de negocio en cada sucursal física de la empresa. | Ver Especificación |
clientes.rel_canal_tipo_empresa |
clientes |
i747t / i748t |
Matriz de configuración y habilitación de canales y tipos de canal comercial autorizados para operar en cada tenant empresarial. | Ver Especificación |
clientes.rel_clientes_contactos |
clientes |
i134t_contacto_cliente |
Vinculación N:M entre clientes comerciales y contactos con atribuciones operativas (compras, recepción, autorizaciones). | Ver Especificación |
fuerza_ventas.rel_promotores_supervisores |
fuerza_ventas |
i127t_promotor (co_promotor_padre) |
Asignación jerárquica histórica y activa entre promotores de campo y sus supervisores comerciales dentro de la estructura de ventas. | Ver Especificación |
fuerza_ventas.rel_promotores_sucursales |
fuerza_ventas |
i146t_promotor_sucursal |
Mapeo de cobertura comercial y asignación de promotores sobre las diferentes sucursales operativas de la empresa. | Ver Especificación |
fuerza_ventas.rel_promotores_paises |
fuerza_ventas |
i142t_promotor_pais |
Cobertura territorial internacional y países autorizados para la operación y venta de promotores de exportación. | Ver Especificación |
fuerza_ventas.rel_agencias_sucursales |
fuerza_ventas |
i283t_agencia_promotor |
Mapeo de relación y cobertura entre agencias comerciales intermedias y las sucursales físicas operativas de la empresa. | Ver Especificación |
fuerza_ventas.rel_promotores_agencias |
fuerza_ventas |
i284t_agencia_vendedor |
Pertenencia y asignación de los promotores a las diferentes agencias o células comerciales de ventas. | Ver Especificación |
fuerza_ventas.rel_vendedor_unidad_comercial |
fuerza_ventas |
i748t_acceso_uni_comer |
Habilitación y permisos de acceso de vendedores a unidades comerciales por sucursal. | Ver Especificación |
2.2.6. Tablas de Auditoría y Trazabilidad (log)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.log_cambios_cliente |
clientes |
c297t_historia_cliente |
Bitácora de auditoría histórica e inmutable para el rastreo de modificaciones en campos sensibles de la ficha del cliente (límites de crédito, estados, términos de pago). | Ver Especificación |
fuerza_ventas.log_ubicaciones_promotores |
fuerza_ventas |
c550t (14,2 M filas) |
Telemetría GPS en ruta de promotores móviles (particionada mensualmente por rango de fecha para alto rendimiento). | Ver Especificación |
2.2.7. Tablas de Configuración (cfg)¶
| Tabla | Esquema | Origen Legacy | Propósito / Descripción | Enlace |
|---|---|---|---|---|
clientes.cfg_registro_cliente_sucursal |
clientes |
i406t_parametros_cliente |
Valores y comportamientos por defecto del formulario de alta y registro de clientes según la sucursal operadora. | Ver Especificación |
clientes.cfg_reglas_credito_tipo_empresa |
clientes |
i417t_regla_credito |
Reglas y políticas comerciales automáticas para asignación de líneas de crédito según el tipo de empresa y sucursal. | Ver Especificación |
fuerza_ventas.cfg_comisiones_promotor |
fuerza_ventas |
i127t_promotor (comisiones con histórico) |
Configuración de comisión del promotor comercial con vigencia temporal desde fecha de aplicación. | Ver Especificación |
fuerza_ventas.cfg_secuencia_pedido |
fuerza_ventas |
Secuencias anuales |
Control y generación atómica de correlativos numéricos de pedidos por año fiscal y tenant. | Ver Especificación |