Configuración General y Parámetros del Sistema

Descripción General

El módulo de Configuración General centraliza los parámetros operacionales, fiscales y de hardware del inquilino (Tenant). Dirigido a Administradores del Sistema y Contadores. Permite gestionar las tarifas tributarias de IVA e impuestos al consumo, los consecutivos y prefijos de comprobantes autorizados por la DIAN, los métodos de pago aceptados y la vinculación de terminales físicas e impresoras térmicas de tickets (ESC/POS).

Flujo Operativo

1. Acceso a la vista: Navega a /general-settings en el panel principal o accede directamente al área de terminales en /general-settings/pos-terminals.

2. Diligenciamiento y Configuración de Terminales ESC/POS:

   • En la sección Impresora ESC/POS de este equipo , revisa el estado del periférico local.
   • El sistema valida el protocolo de conexión: si no se ejecuta bajo conexión cifrada, advierte el mensaje se requiere HTTPS y mantiene temporalmente deshabilitado el botón Emparejar e imprimir prueba.
   • Bajo entorno seguro (HTTPS o localhost), selecciona la velocidad en baudios (19200 baudios estándar) y haz clic en Emparejar e imprimir prueba.
   • Selecciona el puerto serie (USB / Serie COM) en el cuadro de diálogo del navegador para registrar el identificador de la impresora.

3. Ejecución y Confirmación: Configura las demás pestañas:

   • Impuestos: Define las tarifas de IVA (0%, 5%, 19%) e impuestos de retención.
   • Consecutivos y Prefijos: Ingresa el número de resolución DIAN, fecha de vigencia, prefijo (ej: FAC, POS) y rango autorizado (desde 1 hasta 10,000).
   • Métodos de Pago: Activa métodos de pago aceptados y asocia la cuenta contable receptora.
   • Haz clic en Guardar Configuración General. El sistema valida los datos y responde: "Configuración general actualizada exitosamente".

Reglas de Negocio y Validaciones

• Requisito de HTTPS para WebSerial: La integración directa con impresoras térmicas ESC/POS requiere que la aplicación se sirva mediante protocolo HTTPS (o dominio local seguro), condición estricta validada en la suite tenant-pos-printer.spec.ts.
• Alertas de Agotamiento de Consecutivo: El sistema emite alertas preventivas cuando el consecutivo activo alcanza el 90% del rango autorizado por la DIAN para gestionar la nueva resolución antes del vencimiento.

Tabla de Estados y Acciones Permitidas

Módulo de Configuración	Propósito Técnico	Acciones Disponibles
Resoluciones y Prefijos	Control de consecutivos fiscales autorizados por la DIAN.	Crear prefijo, asignar fecha de vencimiento, vigilar rango.
Impuestos y Retenciones	Tarifas porcentuales de IVA, ICA y Retención en la fuente.	Crear nuevas tarifas tributarias, asociar cuentas PUC.
Terminales e Impresoras	Emparejamiento WebSerial ESC/POS por estación de trabajo.	Emparejar puerto serie, imprimir ticket de prueba, calibrar.
Métodos de Pago	Catálogo de formas de pago y pasarelas electrónicas.	Vincular a cuentas contables de banco o caja.

Restricciones Operativas

No es posible retroceder el número de consecutivo actual de una resolución si ya se han emitido facturas con numeraciones superiores; esto violaría el principio de consecutividad fiscal exigido por la DIAN.