Documentación
Guía de revisión para profesionales (contable/tributaria)
Checklist para revisar la documentación y el motor de cálculo: casos de prueba, puntos sensibles, y cómo proponer correcciones con fuentes.
Este documento está pensado para profesionales contables/tributarios/laborales que revisarán la calculadora y su documentación.
1) Objetivo de la revisión
Queremos validar:
- que las reglas estén bien interpretadas,
- que los cálculos estén bien implementados para el alcance definido,
- y que la documentación sea clara, pedagógica y verificable con fuentes.
2) Alcance (qué revisar vs qué no)
Revisar (sí)
- Nómina dependientes: salario ordinario e integral.
- IBC (incluye regla del 40%).
- Seguridad social (salud/pensión/FSP).
- ARL por clase.
- Parafiscales y exoneración (modelo operativo).
- Prestaciones sociales (provisión mensual y modo por días).
- Liquidación de contrato (DÍAS360, cortes anuales/semestrales, novedades e incapacidades informativas).
- Novedades/ausencias y su impacto en días computables.
- Incapacidades comunes y laborales (reglas base EPS/ARL y visualización informativa).
- Horas extra/recargos (valor hora por divisor, recargo dominical progresivo).
- Retención en la fuente (modelo simplificado mensual).
No revisar como “requisito” (todavía)
- Incapacidades prolongadas (>180 días), rehabilitación y controversias de origen avanzadas.
- Embargos y libranzas.
- Independientes.
- Casos sectoriales.
3) Checklist de puntos sensibles (donde suelen aparecer diferencias)
3.1 IBC y regla del 40%
- ¿Qué pagos se consideran “no salariales” en el modelo?
- ¿La fórmula del 40% y “exceso” está correctamente explicada?
- ¿Topes mínimo/máximo del IBC están bien aplicados?
Fuente:
3.2 Auxilio de transporte
- Umbral (hasta 2×SMMLV) y fuentes por vigencia.
- Tratamiento en bases de prestaciones (educativo vs exacto por caso).
3.3 Seguridad social
- Porcentajes salud/pensión (empleador vs trabajador).
- FSP: rangos y porcentajes.
Fuentes:
3.4 Exoneración (114-1)
- Condiciones del empleador: ¿qué deberíamos aclarar más?
- Umbral del trabajador (<10×SMMLV) como regla operativa.
- Qué se exonera (ICBF/SENA y salud empleador) y qué no (CCF).
Fuente:
3.5 Prestaciones
- Coherencia de porcentajes vs fórmulas por días.
- Intereses de cesantías: si debe prorratearse por días en modo avanzado.
- Vacaciones y salario variable: cómo explicarlo y qué tanto implementamos.
3.6 Horas extra y recargos
- Divisor mensual por fecha (Ley 2101).
- Recargo dominical progresivo (Art. 179 CST).
- Interpretación de “solo recargo” vs “pago completo” en diferentes escenarios.
3.7 Retención en la fuente (simplificada)
- Prorrateo mensual de límites anuales (1200 UVT intereses vivienda, 790 UVT renta exenta, 1340 UVT límite 40%).
- Tabla del Art. 383 y rangos.
- Deducciones y dependientes: topes y definición (Art. 387).
Fuentes:
4) Casos de prueba sugeridos (para comparar resultados)
Proponemos revisar con al menos estos escenarios:
- Salario ordinario cerca de 2×SMMLV (para validar auxilio).
- Salario ordinario con pagos no salariales altos (para validar regla del 40%).
- Salario ordinario en 3.9×SMMLV vs 4.0×SMMLV (entrada/salida de FSP).
- Salario ordinario en 9.9×SMMLV vs 10.1×SMMLV con “exoneración activada” (debe aplicar/no aplicar).
- Clase ARL I vs V (comparar orden de magnitud).
- Horas extra/recargos antes y después de 15-jul-2026 (divisor 220 vs 210).
- Retención: base cerca de 95 UVT (debe pasar de 0 a >0).
5) Cómo proponer correcciones (formato recomendado)
Para que podamos aplicar correcciones rápido, envía:
- Página de documentación a corregir (URL o slug).
- Texto actual y propuesta (o explicación).
- Fuente oficial (enlace).
- Si es un cálculo: un caso de prueba con:
- vigencia,
- fecha,
- entradas,
- resultado esperado,
- justificación y fuente.