⚙️ Configuración del sistema

Catálogo central de obligaciones tributarias (DIAN, municipales, sectoriales). Las que asignes a un cliente aparecen en su ficha.

Sectores de los clientes (Admon, Gastro, Pizzería, etc.). Color visual para identificarlos.

Clasificación comercial: Fijo (cobro mensual), Renta (anual), Eventual (puntual)…

Categorías disponibles al subir documentos del cliente (RUT, Cámara, Cédula, Factura, etc.). Puedes crear tus propias categorías.

Estados disponibles al actualizar un vencimiento (Presentado y pagado, Sin pago, No presentado, etc.). Marca final los estados que cierran el ciclo (no requieren más acción), y negativo los que indican falta (vencido, no presentado).

Edita bancos, clasificaciones (Fijo/Variable/Hormiga/…), grupos (CASA/TRANSPORTE/…) y categorías de gasto.

Calendarios tributarios cargados (DIAN nacional, municipales). Cantidad de fechas por cada uno.

Tarifas usadas por el cálculo automático del ICA (Régimen Simple — formulario 2593, y Régimen Ordinario — formulario 420). Una misma combinación municipio + CIIU + año puede tener dos filas: una para cada régimen. Fuente sugerida para Simple: micrositio DIAN.

Personas que ejecutan tareas. Cada uno con teléfono WhatsApp (con código país) para los botones de asignación rápida.

Clientes externos con login propio en portal.orozcoyco.pages.dev. Cada uno puede gestionar una o más empresas con permisos granulares por módulo (estado de cuenta, contratos, pagos a proveedores, solicitudes).

Grupos visuales para clasificar tareas (Tributaria, Nómina, Gestión interna, etc.). Editables.

Mensajes reutilizables para WhatsApp/email. Usa placeholders {{cliente}}, {{periodo}}, {{mes}}, {{anio}}, {{dia}}, {{obligacion}} que se reemplazan automáticamente al enviar.

Registro automático de quién cambió qué en las tablas sensibles (clientes, accesos, pagos, permisos, tareas, solicitudes). Solo visible para admin.

Monitor manual del consumo de egress de Supabase Free (5 GB/mes). El sistema te avisa cada 7 días para revisar; vos copiás el GB del dashboard y se evalúa contra los umbrales.

Valores normativos colombianos usados para calcular el costo total de nómina y prestaciones sociales en los informes contables. Estos parámetros NO son editables — están definidos por ley y se actualizan via migration SQL cada año.

Prestaciones sociales (factor 21,83%)

Calculadas mes a mes en el trigger SQL _pila_recalcular_prestaciones (m146/m198/m199). Base = IBC + Aux. transporte excepto vacaciones (Art. 192 CST: solo sobre salario ordinario).

Aportes patronales a Seguridad Social

Calculados sobre el IBC (Ingreso Base de Cotización). El aux. transporte NO computa para aportes (Art. 17 Ley 100/1993).

Exoneración Art. 114-1 Estatuto Tributario

Costo total de nómina mensual (fórmula)

Valores históricos por año

Para actualizar valores al inicio de cada año, modificar la función SQL _pila_aux_transporte (ver sql/migration_198_*.sql).

Plantillas que generan tareas automáticamente al presionar "Generar tareas del mes". Ej: PILA mensual, Desprendibles quincenal [15,30], etc.

Personalizá las cuentas contables PUC usadas al generar la interfase Siigo para cada cliente. Si el cliente no tiene configuración propia, se usan los valores por defecto del PUC estándar. Hacé clic en el número de cuenta y presioná Enter (o hacé clic afuera) para guardar.

Catálogo global usado por el módulo Planillas PILA al generar la interfase Siigo. Cuando llegue una administradora nueva en una planilla y no esté acá, quedará excluida del export con NIT vacío. Mantenelo actualizado.

Esta clave se te pedirá al ejecutar acciones marcadas como sensibles para confirmar la operación. Se almacena hasheada con bcrypt — el sistema nunca conoce la clave en texto plano. Si olvidás la clave, podés sobreescribirla desde acá ingresando una nueva.

Guardá el email y password de la cuenta Siigonube del despacho. Se inyectan automáticamente en los runner Python que descargues — así el runner funciona con doble-clic sin necesitar un archivo .env.