Un plazo mal calculado en salud
no es un bug. Es un incumplimiento.
Las EPS tienen plazos legales para autorizar procedimientos. Los laboratorios prometen resultados en días hábiles. Los reportes epidemiológicos necesitan denominadores correctos para comparar meses. En todos los casos, "día hábil" depende del país — y cambia con cada decreto.
Plazos legales exactos
Autorización de procedimientos, respuesta a reclamos, entrega de resultados — cada plazo regulatorio calculado con los feriados reales del país.
Reportes normalizados
Comparar atenciones de marzo vs abril requiere saber que uno tuvo 23 días hábiles y el otro 19. Sin normalizar, los KPIs mienten.
Agendamiento correcto
"Su próxima consulta es en 3 días hábiles" — calculado automáticamente considerando feriados nacionales y regionales.
El problema — reportes que no se pueden comparar
Un hospital en Perú reporta 1.200 atenciones en marzo y 980 en abril. ¿Bajó la productividad? No necesariamente — abril tuvo Semana Santa y 3 días hábiles menos. Sin normalizar por días hábiles, la comparación es incorrecta y las decisiones que se toman sobre ella también.
Sin normalizar
Marzo: 1.200 · Abril: 980
→ "Abril bajó un 18%"
Normalizado por días hábiles
Marzo: 52.2/día · Abril: 51.6/día
→ "Rendimiento estable"
Implementación — Python + pandas
import requests, pandas as pd
API = "https://api.feriados.io/v1"
HDR = {"Authorization": "Bearer frd_tu_key"}
def dias_habiles(pais, año, mes):
r = requests.get(
f"{API}/{pais}/business-days/between",
params={"from": f"{año}-{mes:02d}-01",
"to": f"{año}-{mes:02d}-{pd.Period(f'{año}-{mes}', 'M').days_in_month}"},
headers=HDR
)
return r.json()["data"]["business_days"]
# Normalizar atenciones por mes
df = pd.DataFrame([
{"mes": "Marzo", "atenciones": 1200, "dias_hab": dias_habiles("PE", 2026, 3)},
{"mes": "Abril", "atenciones": 980, "dias_hab": dias_habiles("PE", 2026, 4)},
])
df["por_dia"] = (df.atenciones / df.dias_hab).round(1)
print(df)
# mes atenciones dias_hab por_dia
# Marzo 1200 23 52.2
# Abril 980 19 51.6 ← rendimiento establePlazos regulatorios — calcular vencimientos
# La EPS debe responder en 5 días hábiles
# Solicitud recibida: 2 de abril 2026 (jueves antes de Semana Santa)
GET api.feriados.io/v1/PE/business-days/add
?date=2026-04-02&days=5
"success": true,
"data": "start_date": "2026-04-02",
"result_date": "2026-04-13", // lunes, saltó Semana Santa
"business_days_added": 5
# Sin la API: un calendario estático diría 9 de abril.
# Con Semana Santa, el plazo real es el 13.
# 4 días de diferencia = incumplimiento regulatorio.Resultados de laboratorio
"Su resultado estará listo en 3 días hábiles" — calculado con los feriados reales del país, no con una estimación fija.
/business-days/add SLA de aseguradoras / EPS
Plazos legales para autorizar procedimientos y responder reclamos. Un día de diferencia puede ser una multa.
/business-days/add Reportes epidemiológicos
Normalizar indicadores por días hábiles del mes para comparar periodos con distinta cantidad de feriados.
/business-days/between Nómina diferenciada
Personal médico trabaja feriados, administrativo no. Cada grupo requiere un cálculo distinto de días trabajados.
/business-days/between Agendamiento de consultas
"Su próxima cita es el siguiente día hábil disponible" — preciso aunque caiga en feriados regionales.
/business-days/add Fecha de cierre contable
El último día hábil del mes como fecha de corte para facturación y reportes mensuales.
/last-business-day El riesgo de mantener esto internamente
Perú tiene feriados que dependen de Pascua. Colombia aplica la Ley Emiliani que traslada feriados al lunes. Chile tiene feriados irrenunciables que no se pueden mover. Cuando un gobierno decreta un feriado con 10 días de aviso, alguien en tu equipo tiene que detectarlo, actualizar el sistema y verificar que ningún plazo regulatorio pendiente se recalculó mal. Con feriados.io, los datos se actualizan en menos de 24 horas de cada decreto — automáticamente.
Calendario por institución — días no laborables propios
Cada hospital cierra días distintos
Día del médico, aniversario institucional, cierres administrativos de fin de año, días de inventario de farmacia, auditorías internas — cada establecimiento tiene su propio calendario. Si calculas plazos o normalizas reportes solo con los feriados del país, el resultado sigue estando incompleto.
Con calendarios personalizados defines los días no laborables de tu institución una sola vez. Después, cada cálculo de días hábiles los considera automáticamente con el parámetro ?calendar=tu-clinica.
# 1. Crear el calendario de tu institución
POST api.feriados.io/v1/calendars
{ "name": "Clínica San Martín", "slug": "clinica-sm" }
# 2. Agregar días no laborables propios
POST api.feriados.io/v1/calendars/clinica-sm/dates
{ "date": "2026-10-05", "name": "Día de la Medicina Peruana" }
{ "date": "2026-12-23", "name": "Cierre administrativo" }
# 3. Calcular plazos incluyendo los días de la clínica
GET api.feriados.io/v1/PE/business-days/add
?date=2026-10-01&days=5&calendar=clinica-sm
# Sin calendar: resultado = 8 de octubre
# Con calendar: resultado = 9 de octubre (saltó el Día de la Medicina)Plan Starter — desde $9/mes
Plazos correctos, sin mantenimiento
11 países de LATAM. Datos actualizados con cada decreto. Sin calendarios que mantener.
Sin tarjeta para plan Free · Cancela cuando quieras