Directorio General de Terceros

Descripción General

El Directorio de Terceros es el repositorio maestro unificado de todas las personas naturales y jurídicas con las que la empresa sostiene relaciones contractuales, comerciales o laborales en SigFacERP (/third-parties).

Diseñado bajo el patrón de arquitectura Master-Detail, permite explorar con fluidez el padrón completo de contactos, aplicar filtros avanzados por rol o ubicación geográfica, y consultar de manera inmediata la ficha técnica, cartera y cuentas de un tercero sin abandonar la vista principal.

---

Capacidades Principales del Módulo

Padrón Multirrol Unificado

Una entidad puede actuar simultáneamente como Cliente, Proveedor, Empleado o Cobrador sin duplicar registros en la base de datos.

Master-Detail en Tiempo Real

Panel lateral contextual que despliega instantáneamente datos básicos, contacto, ubicación física y condiciones de crédito al hacer clic en cualquier fila.

Filtros Geográficos y Tributarios

Segmentación por tipo de persona (Natural/Jurídica), responsabilidades DIAN, estado operativo y asignación territorial (Zonas y Barrios).

Importación y Creación Rápida

Asistente de importación masiva por archivo CSV y formulario lateral amplio para creación inmediata de nuevos registros.

---

Estructura de la Interfaz

La vista se divide en tres secciones estratégicas:

1. Encabezado y Barra de Herramientas

• Contador Global de Terceros: Indicador numérico en tiempo real del total de contactos registrados en el inquilino.
• Acceso a Gestión Geográfica (Gestión): Menú contextual con accesos directos a la administración de Zonas y Barrios.
• Importar CSV: Despliega el asistente de carga masiva para migración o sincronización de bases de datos externas.
• + Nuevo Tercero: Abre el formulario lateral deslizante para registrar un nuevo tercero en el sistema.

2. Barra de Búsqueda y Filtros Avanzados

• Buscador Universal: Filtra en tiempo real por nombre, razón social, número de documento o correo electrónico.
• Panel Desplegable de Filtros (Filtros):
  • Tipo de Tercero: Todos, Cliente, Proveedor, Empleado, Cobrador.
  • Tipo de Persona: Todas, Natural, Jurídica.
  • Zona y Barrio: Selectores en cascada para filtrar la cartera por ruta logística.
  • Estado: Todos, Activo o Inactivo.
  • Botón Limpiar: Restablece todos los criterios de búsqueda a su valor predeterminado.

3. Panel Maestro (Tabla de Resultados)

Presenta los registros con diseño responsivo de alta densidad:

• DOCUMENTO: Tipo y número de identificación fiscal con formato normalizado.
• TERCERO: Razón social o nombres legales junto con el correo institucional.
• CLASIFICACIÓN: Etiquetas tipo chip coloreadas que indican los roles asignados (Cliente, Proveedor, Empleado).
• ESTADO: Badge visual con punto indicador (Activo en verde / Inactivo en rojo).
• ACCIONES: Botones para edición rápida, activación/desactivación y eliminación lógica.

4. Panel de Detalle Contextual (Lateral Derecho)

Al seleccionar cualquier tercero de la tabla, se abre automáticamente el panel lateral con dos pestañas de consulta:

• Pestaña General:
  • Identificación: Documento formateado, tipo de persona, roles activos y estado.
  • Datos Básicos: Razón social y nombre comercial.
  • Contacto: Correo electrónico y teléfonos de atención.
  • Ubicación: Dirección domiciliaria y país.
  • Crédito y Tributos: Límite de crédito asignado, plazo comercial en días, régimen tributario y responsabilidades fiscales DIAN.
• Pestaña Cuentas:
  • Consulta de cuentas contables auxiliares asociadas, saldos vigentes y cartera pendiente.

---

Detalle Visual por Vistas

1. Master-Detail (Detalle Seleccionado)

2. Listado Completo

3. Filtros Avanzados

4. Formulario de Creación

---

Flujo Operativo

1. Acceso al Módulo: Haz clic en el elemento Terceros del menú lateral o ingresa directamente a /third-parties.

2. Búsqueda y Filtrado:

   • Escribe en la barra de búsqueda el nombre, NIT o correo del tercero.
   • Si requieres búsquedas específicas, pulsa Filtros y segmenta por tipo de tercero, persona, zona o estado.

3. Consulta de Detalles: Haz clic sobre cualquier fila de la tabla. El panel derecho se desplegará de forma inmediata mostrando la ficha técnica consolidada.

4. Gestión y Acciones:

   • Para modificar datos, pulsa el botón Editar (ícono lápiz) en la fila o en el panel de detalle.
   • Para suspender operaciones comerciales con el tercero, pulsa el botón Inactivar.
   • Para crear un nuevo registro, pulsa + Nuevo Tercero en la barra superior.

---

Reglas de Negocio y Validaciones Fiscales

• Unicidad Obligatoria: La combinación de tipo de documento y número de identificación es estrictamente única por empresa (Tenant). El sistema no permite registros duplicados.
• Cálculo Automático del Dígito de Verificación (DV): Para documentos tipo NIT, el DV se calcula en tiempo real aplicando el algoritmo Módulo 11 exigido por la DIAN.
• Borrado Lógico Protegido (Soft Delete): No es posible eliminar físicamente un tercero si posee documentos contables asociados (facturas, recibos de caja o comprobantes de egreso). El sistema aplicará un borrado lógico preservando el histórico tributario.

Tabla de Estados y Acciones Permitidas

Estado	Significado Operativo	Acciones Permitidas
Activo	Tercero habilitado plenamente para transacciones.	Emisión de facturas, cotizaciones, recibos de caja, compras y egresos.
Inactivo	Tercero suspendido temporalmente por morosidad o retiro.	Consulta histórica; bloqueado para expedición de nuevos documentos.
Con Bloqueo de Cartera	Tercero con límite de cupo superado o mora en cobros.	Requiere autorización gerencial para emitir nuevas ventas a crédito.

Seguridad y Control de Accesos

Las acciones de modificación, inactivación y eliminación requieren los permisos correspondientes (third_parties.update, third_parties.delete). Si un usuario solo posee permisos de consulta (third_parties.view), los botones de acción se ocultarán automáticamente.