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:

  1. Salario ordinario cerca de 2×SMMLV (para validar auxilio).
  2. Salario ordinario con pagos no salariales altos (para validar regla del 40%).
  3. Salario ordinario en 3.9×SMMLV vs 4.0×SMMLV (entrada/salida de FSP).
  4. Salario ordinario en 9.9×SMMLV vs 10.1×SMMLV con “exoneración activada” (debe aplicar/no aplicar).
  5. Clase ARL I vs V (comparar orden de magnitud).
  6. Horas extra/recargos antes y después de 15-jul-2026 (divisor 220 vs 210).
  7. 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:

  1. Página de documentación a corregir (URL o slug).
  2. Texto actual y propuesta (o explicación).
  3. Fuente oficial (enlace).
  4. Si es un cálculo: un caso de prueba con:
    • vigencia,
    • fecha,
    • entradas,
    • resultado esperado,
    • justificación y fuente.