Business Days API
para Latinoamérica
Días hábiles reales para 11 países — considerando feriados oficiales, decretos de puente y reglas locales de traslado. Un endpoint HTTP reemplaza meses de mantenimiento de calendarios.
Plan Free con uso comercial incluido · sin tarjeta
Por qué el calendario en LATAM no se puede hardcodear
En Europa o EE.UU., los calendarios son estables. En LATAM, los gobiernos modifican el calendario oficial varias veces al año — con días de aviso o sin ellos. Un array estático de feriados en tu codebase es deuda técnica activa.
El Ejecutivo decreta puentes con menos de 2 semanas de anticipación. En 2024 hubo 2. Ninguno estaba en las listas publicadas en enero.
18 de los 20 feriados nacionales se mueven al lunes siguiente. La regla tiene excepciones y depende del día en que cae cada año.
Algunos feriados son irrenunciables por ley — los empleados no pueden ser obligados a trabajar. Los bancos tienen reglas adicionales para ciertos días.
Los endpoints de lógica operativa
Los endpoints operativos están disponibles desde el plan Starter ($9/mes). El plan Free incluye is-business-day, holidays/:year y next-holiday.
/v1/:country/business-days/add?date=YYYY-MM-DD&days=N Suma N días hábiles a una fecha. Salta feriados y fines de semana.
"result_date": "2026-09-23" Fechas de entrega, plazos de despacho /v1/:country/business-days/subtract?date=YYYY-MM-DD&days=N Resta N días hábiles. Útil para fechas límite hacia atrás.
"result_date": "2026-09-15" Fecha de corte para procesos de nómina /v1/:country/business-days/between?from=YYYY-MM-DD&to=YYYY-MM-DD Cuenta los días hábiles entre dos fechas, excluyendo feriados.
"business_days": 20 SLAs, plazos legales, liquidaciones /v1/:country/last-business-day?date=YYYY-MM-DD Retorna el último día hábil del mes de la fecha indicada.
"last_business_day": "2026-01-30" Cierres contables, cortes de facturación /v1/:country/is-business-day?date=YYYY-MM-DD Verifica si una fecha es día hábil. Incluye nombre del feriado si corresponde.
"is_business_day": false, "holiday_name": "..." Validación antes de cobros o envíos · Plan Free Por sector de uso
El mismo motor sirve para distintos casos. El problema de fondo es siempre el mismo: días hábiles incorrectos.
Un cargo en feriado genera reversa, reclamo y chargeback.
is-business-day Free "Llega en 3 días" sin contar feriados es una promesa que no se cumple.
business-days/add Starter Días hábiles distintos por país en el mismo mes. Un error afecta la confianza del empleado.
business-days/between Starter El feriado de Colombia no es el de Chile. Coordinar tránsitos es imposible sin datos por país.
business-days/add + is-business-day Starter 11 países, un solo contrato
Reemplaza :country por el código ISO del país.
El argumento contra construirlo internamente
Construir un sistema de días hábiles para un país tarda 2-3 días. Para 11 países, con sus reglas de traslado y feriados regionales, estás mirando semanas de trabajo y una suite de tests que nunca va a ser suficiente.
Pero el problema real no es el build — es el mantenimiento. Los gobiernos de LATAM decretan cambios de calendario con menos de 2 semanas de anticipación. Cuando eso pasa, alguien tiene que detectarlo, actualizar la lista, deployar, y rezar para que no haya nada en producción que ya calculó mal.
feriados.io absorbe ese costo. Cuando se decreta un nuevo feriado, está disponible en la API en menos de 24 horas. El plan Business recibe un webhook.
Lista para usar en producción
API key gratis en 30 segundos. Plan Free incluye is-business-day con uso comercial. Plan Starter desde $9/mes para lógica operativa completa.