Metodología

Última actualización:

Principios editoriales

  1. Fórmula primero, copia después. Antes de publicar la página de una calculadora, escribimos la función matemática en TypeScript y la cubrimos con pruebas unitarias.
  2. Fuente verificable. Cada constante legal cita la norma o el sitio oficial donde se publicó.
  3. Cálculo en el navegador. No enviamos datos del usuario a un servidor para procesar.
  4. Disclaimer visible. Toda calculadora con consecuencia legal o tributaria muestra un aviso claro de que el cálculo es referencial.

Fuentes legales por país

Ecuador

  • Código del Trabajo — base para décimo tercero, décimo cuarto, vacaciones, fondos de reserva.
  • Ley de Seguridad Social y resoluciones del IESS — tasas de aporte personal y patronal.
  • Ley de Régimen Tributario Interno y Reglamento — IVA, ISD, retenciones, factura electrónica.
  • Acuerdo Ministerial del SBU — Salario Básico Unificado vigente por año.

Tarifas de pasarelas de pago

  • PayPal: tarifas de comerciante por región publicadas en paypal.com (revisamos al menos anualmente).
  • Stripe: stripe.com/pricing por país.
  • MercadoPago: documentación de tarifas oficial por país.

Pruebas automáticas

Cada calculadora tiene un archivo calc.test.ts con casos:

  • Caso típico (un usuario normal).
  • Caso extremo (cero, números muy grandes, decimales).
  • Caso documentado oficialmente (cuando existe un ejemplo publicado por la autoridad).
  • Redondeo (verificamos que el redondeo coincida con el método legal).

El pipeline de despliegue corre los tests antes de publicar. Si una constante cambia y un test rompe, la calculadora no se publica hasta corregir el caso esperado.

Ciclo de actualización

  • Enero: revisión de constantes anuales (SBU, base imponible, fracciones, tarifas pasarelas).
  • Trimestral: revisión de tipos de cambio, comisiones internacionales.
  • Cada vez que llega un reporte de error: revisión puntual.

Versionado de constantes

Las constantes se guardan con su año de vigencia en el código: 

// src/lib/calculators/ec-iess/calc.ts
export const TASAS_IESS_2026 = {
  empleadoGeneral: 0.0945,
  empleadorGeneral: 0.1115,
  fondosReserva: 0.0833,
};

Esto permite que, si en el futuro un usuario necesita calcular un periodo histórico, podamos ofrecerle la tasa que estaba vigente en ese año.

Errores y corrección

Cuando confirmamos un error en una fórmula, lo corregimos en menos de 48 horas hábiles, agregamos un test que cubre el caso roto, y publicamos una nota en el pie de la calculadora con la fecha y descripción del cambio cuando el impacto es relevante.