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
2026
mx-calendario-fiscal: días hábiles y vencimientos fiscales de México
ts · node
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,addBusinessDaysywhyNotBusinessDay, conpurpose: 'procedure' | 'filing'para distinguir trámites de declaraciones y pagos.whyNotBusinessDaydevuelve el motivo con sufundamentoy susource. - 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) yfiscalCalendar(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)eisLaborHoliday(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; unDatese 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.