Open Source · Librería En desarrollo

mx-calendario-fiscal: días hábiles y vencimientos fiscales de México

Librería de TypeScript sin dependencias: días hábiles y vencimientos fiscales de México (día 17, declaración anual) con el fundamento legal y la fuente de cada fecha. CFF art. 12, RMF y LFT art. 74.

Rol
Diseño y desarrollo
Año
2026
Publicado

mx-calendario-fiscal es una librería en TypeScript con la lógica de días hábiles y vencimientos fiscales de México, sin dependencias en ejecución. Cada regla y cada fecha lleva su fundamento legal y un enlace a la fuente primaria. Licencia MIT.

Estado: el código y las pruebas están en GitHub; todavía no está publicado en npm.

Por qué existe

Un vencimiento fiscal no es «el día 17»: es el 17 recorrido al siguiente día hábil, y «día hábil» lo definen tres documentos que no coinciden:

  • CFF art. 12: días que nunca cuentan (fines de semana, lunes recorridos, 5 de mayo…).
  • RMF regla 2.1.6: días y periodos generales de vacaciones que el SAT declara inhábiles. No detienen el plazo para presentar declaraciones y pagar (CFF 12, párr. 2).
  • LFT art. 74: descansos obligatorios laborales. No es la misma lista: el 5 de mayo es inhábil fiscal pero no laboral, y el relevo presidencial es 1 de diciembre en el CFF y 1 de octubre en la LFT.

La librería mantiene esos conjuntos separados y te dice por qué un día es inhábil. Los paquetes de npm que encontré cubren solo la lista laboral; ninguno cubre CFF 12 + RMF + vencimientos recurrentes.

Uso

import { isBusinessDay, nextBusinessDay, addBusinessDays, monthlyDueDate, annualDueDate } from 'mx-calendario-fiscal';

isBusinessDay('2025-11-17');   // false: tercer lunes de noviembre (CFF art. 12)
nextBusinessDay('2025-11-17'); // '2025-11-18'

// IVA de octubre de 2025: el 17 es inhábil y se recorre al 18.
const iva = monthlyDueDate({ obligation: 'iva', period: '2025-10' });
iva.nominal;      // '2025-11-17'
iva.due;          // '2025-11-18'
iva.fundamento;   // ['LIVA art. 5o.-D, último párr.', 'CFF art. 12, párr. 5']

// Declaración anual de personas físicas, ejercicio 2025.
annualDueDate({ year: 2025, taxpayer: 'pf' }).due; // '2026-04-30'

// Plazo de trámite en días hábiles: las vacaciones del SAT (18–31 jul 2025) no cuentan.
addBusinessDays('2025-07-17', 1);                         // '2025-08-01'
// Para declarar y pagar sí son hábiles.
addBusinessDays('2025-07-17', 1, { purpose: 'filing' });  // '2025-07-18'

Qué trae

  • Días hábiles: isBusinessDay, nextBusinessDay, previousBusinessDay, addBusinessDays y whyNotBusinessDay, con purpose: 'procedure' | 'filing' para distinguir trámites de declaraciones y pagos. whyNotBusinessDay devuelve el motivo con su fundamento y su source.
  • Vencimientos: monthlyDueDate (día 17: pagos provisionales de ISR para personas morales y físicas, retenciones de ISR, IVA y DIOT), annualDueDate (personas morales 31 de marzo, personas físicas 30 de abril) y fiscalCalendar(year) con todos los vencimientos del año ordenados. Cada resultado trae la fecha nominal, la fecha ya recorrida, los motivos del recorrido y el fundamento.
  • Viernes bancario: con payAtBank: true, si el último día del plazo es viernes y se paga en banco, se prorroga al siguiente día hábil (CFF art. 12, párr. 5).
  • Descansos laborales: laborHolidays(year) e isLaborHoliday(date) con la LFT art. 74, separados de los fiscales.
  • Fechas publicadas y proyectadas: los datos de la RMF están incluidos hasta 2026. Para años posteriores aplica las reglas legales fijas y marca el resultado con projected: true, porque la RMF de ese año aún puede añadir días o vacaciones. Nunca inventa vacaciones que el SAT no ha publicado.
  • Sin zonas horarias: las fechas son cadenas YYYY-MM-DD; un Date se lee por sus componentes de calendario locales y no hay aritmética de zona horaria.
  • Build: ESM y CommonJS, tipos incluidos, Node ≥ 18.

Lo que no hace

  • No es asesoría fiscal ni legal. Es una herramienta de apoyo: las fechas dependen de leyes y resoluciones que el SAT puede cambiar en cualquier momento. Verifica contra las fuentes primarias o con un profesional antes de confiar en una fecha.
  • No decide si estás obligado a presentar ni bajo qué régimen (RESICO, bimestral, etc.).
  • No modela días adicionales por sexto dígito del RFC: no pude confirmar esa regla en una fuente primaria, así que está excluida.
  • No incluye calendarios estatales, del IMSS o bancarios, ni prórrogas por contingencia que el SAT publique sobre la marcha.

Stack técnico

  • TypeScript, compilado a ESM y CommonJS con tipos
  • Node.js ≥ 18, sin dependencias en ejecución
  • node:test para la suite
  • GitHub Actions para typecheck, pruebas y publicación a npm con Trusted Publishing y procedencia al empujar una etiqueta vX.Y.Z

Repositorio

Ver en GitHub → · Para validar los identificadores de un contribuyente está mx-identifiers.

Objetivo

Que quien necesite calcular un vencimiento o un plazo en días hábiles no tenga que reconciliar a mano el CFF, la RMF y la LFT, y que cada fecha que devuelva se pueda rastrear hasta su fundamento.

07 / Contacto

¿Algo parecido? Escríbeme.

Con dos líneas (qué necesitas y qué tienes hoy) te digo si este tipo de proyecto aplica y cuál sería el primer paso.