Calendario de feriados
Los plazos de la propiedad industrial chilena se cuentan en días hábiles, así que el corpus mantiene el calendario de feriados legales para sus propios cálculos (ventanas de oposición, plazos de apelación). Esta guía cubre el endpoint que lo expone, para que puedas calcular esos mismos plazos por tu cuenta — y auditar los nuestros.
El esquema completo y siempre actualizado por campo vive en la referencia OpenAPI interactiva en
/docs(Scalar). Esta guía explica el contrato y enlaza a esa referencia — no reformula el esquema. Cuando un campo no está documentado aquí,/docses autoritativo.
A lo largo de la guía la URL base se escribe como $TARNO_BASE_URL y la clave como $TARNO_API_KEY,
y cada llamada lleva el encabezado X-API-Key.
GET /holidays · scope insights:read · equivalente MCP: list_holidays
curl -sS "$TARNO_BASE_URL/holidays?year=2026" -H "X-API-Key: $TARNO_API_KEY"
{
"results": [
{ "date": "2026-01-01", "name": "Año Nuevo", "type": "regular", "origin": "seed:reglas-permanentes" },
{ "date": "2026-04-03", "name": "Viernes Santo", "type": "regular", "origin": "seed:reglas-permanentes" }
],
"limit": …, "next": null, "hasMore": false, "total": …,
"meta": { "dataAsOf": "2026-10-05T05:41:47.891Z", "coverageThrough": "2030-12-31", "coverage": { "from": "2013-01-01", "to": "2030-12-31" } }
}
| Parámetro | Qué hace |
|---|---|
year |
Atajo para un año completo. |
from / to |
Rango explícito (ISO YYYY-MM-DD), inclusive. Si los indicas, mandan sobre year. |
type |
regular o excepcional (ver abajo). |
⛔ Desde el 2026-09-23 los nombres antiguos desde / hasta / anio / tipo ya no existen: pedir
con ellos es un 400 validation_error cuyo detail nombra el parámetro nuevo (por ejemplo
`desde` was renamed: use `from`). Lo mismo vale para cualquier parámetro que la ruta no conozca
(envelope incluido): nunca se descarta en silencio.
Regulares frente a excepcionales
Cada fila declara si un algoritmo puede reproducirla:
regular— se deriva de las reglas permanentes: fechas fijas, computus de Pascua, los corrimientos a lunes/viernes de las leyes 19.668 y 20.299, y los feriados adicionales de Fiestas Patrias y Año Nuevo de las leyes 20.215 y 20.983 (si el 18 y 19 caen martes-miércoles hay feriado el lunes 17; miércoles-jueves, el viernes 20; sábado-domingo, el viernes 17; y si el 1 de enero cae domingo, el lunes 2).excepcional— creado por una ley ad-hoc para un solo día de un solo año, o por un decreto de elección. Ninguna regla lo produce: sólo se puede leer de una lista.
origin completa el cuadro diciendo de dónde salió esa fila concreta (Ley 20.215,
Ley 21.462, decreto:dia-de-eleccion, seed:reglas-permanentes). Un origin que empieza por
loader: señala una fila que puso el refresco automático, no una migración revisada.
Esta distinción no es teórica. El feriado del viernes 2024-09-20 faltaba en el calendario, y su ausencia rompía el techo legal de 15 días hábiles del plazo de apelación en 65 casos medidos. Un feriado ausente no se nota hasta que desplaza un plazo.
# ¿qué feriados no puede reproducir ningún cálculo automático?
curl -sS "$TARNO_BASE_URL/holidays?type=excepcional" -H "X-API-Key: $TARNO_API_KEY"
La cobertura es finita — y es un dato, no una deducción
El calendario cubre un rango de años declarado explícitamente. Fuera de él no hay dato, y eso no significa que no haya feriados: significa que no lo sabemos. La diferencia no es académica — son cosas opuestas:
- no hay feriados en ese tramo → tu cuenta de días hábiles es correcta;
- ese tramo no está cargado → tu cuenta degrada a sólo-fines-de-semana y te da un plazo más largo del real, sin que nada falle. Ése es el error peligroso: le dirías a un abogado que tiene más tiempo del que tiene.
curl -sS "$TARNO_BASE_URL/holidays" -H "X-API-Key: $TARNO_API_KEY"
{ "results": [ … ], "meta": { "coverage": { "from": "2013-01-01", "to": "2030-12-31" }, … } }
GET /holidays · scope insights:read · equivalente MCP: list_holidays
Es barato y cacheable (Cache-Control: public, max-age=3600), así que si congelas el calendario en
tu repo puedes escribir este rango junto a los datos y que tu artefacto diga de qué años
responde.
No es el min/max de las filas, y esa es toda la gracia. El min/max describe lo que hay, no
lo que el calendario afirma: si un año entrara a medias —sólo Navidad, por ejemplo— el min/max diría
«cubro hasta ese 25 de diciembre» y congelarías un año al 5 % creyéndolo completo. El rango sólo
avanza cuando un año está entero, y por eso termina el 31 de diciembre del último año
declarado y no el día del último feriado.
Pedir fuera del rango es un error, nunca una lista vacía
curl -sS "$TARNO_BASE_URL/holidays?from=2031-01-01&to=2031-12-31" -H "X-API-Key: $TARNO_API_KEY"
{
"type": "https://api.tarno.cl/problems/out_of_coverage",
"title": "Business rule not satisfied",
"status": 422,
"detail": "El calendario cubre 2013-01-01 → 2030-12-31; el rango pedido lo excede.",
"code": "out_of_coverage",
"requestId": "…",
"coverage": { "from": "2013-01-01", "through": "2030-12-31" }
}
HTTP 422. Nunca un 200 con lista vacía o parcial. El rango viaja dentro del error, así que
no necesitas una segunda llamada para saber contra qué chocaste. En MCP el mismo caso devuelve un
resultado de error con el mismo code y el mismo coverage.
Dos detalles del contorno:
- Un extremo abierto no es un error.
?from=2030-12-01acota con lo que haya; sólo se comprueban los límites que indicas explícitamente. - Dentro del rango, vacío significa vacío.
?from=2026-02-01&to=2026-02-28devuelve[]con un 200 porque febrero de 2026 no tiene feriados, y eso es un dato fiable.
La cobertura declarada viaja siempre en meta.coverage —{ "from", "to" }—, sin pedirla
con ninguna bandera: una sola llamada trae los feriados y el rango del que responden.
meta.coverageThrough es el último día con calendario declarado (el to de meta.coverage): los
plazos que acaban hasta esa fecha se cuentan con feriados declarados; uno que acabe después no se
puede contar con este calendario. Es la racha contigua de años declarados: un año sin declarar en medio
la corta.
Cada cuánto se actualiza
Un trabajo semanal refresca la ventana de hoy a dos años vista: da de alta los feriados
nuevos (una ley ad-hoc suele publicarse con pocas semanas de aviso) y retira los que dejan de
serlo — el caso típico es una elección que se mueve de la fecha planificada a la celebrada. Fuera de
esa ventana el calendario sólo cambia por una migración revisada. meta.dataAsOf es el instante
de la última carga correcta de ese trabajo (no la sync de marcas ni la hora de tu petición); null
si nunca terminó ninguna.
Un matiz que conviene conocer si calculas plazos a mucha distancia: los feriados regulares se derivan de las reglas permanentes y por eso cubren la ventana entera, pero los excepcionales sólo se detectan hasta donde llegan las fuentes públicas que los publican — hoy algo más de un año. Para cualquier plazo en curso sobra: el más largo del sistema son 30 días hábiles.
Contar días hábiles con este calendario
Si lo que necesitas es la fecha del N.º día hábil tras un ancla, no hace falta que la calcules tú:
GET /business-days (MCP: compute_business_days) cuenta con este mismo
calendario —el mismo cómputo que la ventana de oposición— y devuelve la fecha, los fines de semana y
feriados que saltó, la cobertura que usó y la norma del cómputo; y la marca como estimación cuando
el tramo sale de la cobertura declarada.