Nivel de servicio
Esta página es el acuerdo de nivel de servicio (SLA) de la API REST (https://api.tarno.cl) y del
servidor MCP (https://mcp.tarno.cl) de Tarno: qué nos comprometemos a cumplir, cómo se mide cada
cifra y qué queda fuera. Las cifras son conservadoras a propósito: cada una está por debajo de lo
que el servicio ha medido en la práctica (se indica al lado), para que el compromiso se pueda cumplir
también en un mes malo.
Las consecuencias de un incumplimiento (créditos u otras) las fija el contrato de tu organización; esta página fija los objetivos y cómo se miden.
Arquitectura: una máquina, copias fuera y recuperación ensayada
Tarno corre en una sola máquina. No hay una segunda máquina en caliente ni conmutación automática: una falla de la máquina se cubre recuperando el servicio desde copia, no pasando el tráfico a otra. Por eso los compromisos de esta página son de disponibilidad mensual y de tiempo de recuperación, no de redundancia.
- Copias cifradas fuera de la máquina, en un almacenamiento externo independiente: el corpus y la vigilancia, una vez al día; las claves de API y las organizaciones de los clientes, cada hora. Se guardan 14 días.
- Archivo de los PDF del Estado Diario: los boletines tal como los publicó INAPI se copian cada día al mismo almacenamiento externo, se comprueba la integridad de la copia completa (cada fichero, por tamaño y huella) y se conservan sin caducidad. No van cifrados: son documentos públicos.
- Recuperación ensayada: la restauración completa del servicio en una máquina nueva, a partir de las copias reales, está escrita paso a paso y cronometrada (último ensayo: 2026-10-04).
Compromisos
| Compromiso | Valor comprometido | Medido (referencia) |
|---|---|---|
| Disponibilidad mensual de la API REST y del MCP | 99,5 % | 99,93 % en 30 días (al 2026-09-30) |
| Respuestas de error del servidor (5xx) | < 0,5 % de las peticiones del mes | 0,034 % en 30 días |
| Pérdida máxima de datos (RPO) | 24 h (claves y organizaciones: 1 h) | copia diaria del corpus y la vigilancia; cada hora, claves y organizaciones |
| Tiempo de recuperación (RTO) | 4 h | restauración completa ensayada: 11 min de trabajo técnico hasta servir con las claves de los clientes, ≈ 28 min hasta el servicio completo |
| Mantenimiento | dentro de la ventana declarada, avisado con 48 h | — |
Disponibilidad
Porcentaje de los minutos del mes natural (UTC) en que la API REST y el MCP responden a las peticiones.
Un minuto cuenta como no disponible cuando el servicio no responde o responde 503 a todas las
peticiones. No cuentan como no disponibles los minutos de las exclusiones, incluido el
mantenimiento avisado. 99,5 % equivale a unas 3 h 40 min de indisponibilidad como máximo en un
mes de 31 días.
Errores del servidor
Proporción de peticiones del mes que terminan en un código 5xx. No cuentan los 4xx (petición
inválida, clave sin permiso, 429 por superar la cuota o el límite de ráfaga): son respuestas
correctas a una petición que no se puede atender.
Pérdida máxima de datos (RPO)
Si hubiera que recuperar el servicio desde copia, lo más que se puede perder es lo escrito desde la última copia:
| datos | RPO |
|---|---|
| Corpus (marcas, anotaciones, partes, catálogos) | 24 h; además, la siguiente sincronización con INAPI vuelve a traer lo publicado |
| Vigilancia de parecidos (listas, elementos y parecidas detectadas) | 24 h |
| Claves de API y organizaciones de los clientes | 1 h |
Tras una recuperación, GET /system/freshness dice de qué fecha es el corpus servido.
Tiempo de recuperación (RTO)
Tiempo desde que se confirma una caída de la máquina hasta que la API REST y el MCP vuelven a responder con las claves de los clientes y la búsqueda completa (incluida la búsqueda por similitud). El plazo corre dentro del horario de soporte; una caída fuera de él empieza a contar al inicio del siguiente. La parte técnica de la restauración está medida (unos 28 min hasta el servicio completo); el resto del plazo es margen para preparar la máquina nueva, sus nombres y certificados.
Mantenimiento
- Ventana declarada: domingos de 02:00 a 06:00 (America/Santiago), como máximo 4 h al mes.
- Aviso previo: al menos 48 h antes, al contacto técnico de tu organización.
- Un mantenimiento fuera de la ventana o sin aviso cuenta como indisponibilidad.
- La sincronización diaria no es mantenimiento: la carga de los datos de INAPI se hace con el servicio en marcha, sin corte. Durante la cadena diaria la API y el MCP siguen respondiendo.
Exclusiones
No cuentan contra los compromisos:
- el mantenimiento avisado dentro de la ventana declarada;
- la fuerza mayor y las caídas de proveedores de red o de nombres ajenos a Tarno;
- la indisponibilidad de INAPI o de sus fuentes: afecta a la frescura del corpus, no a la disponibilidad de la API, que sigue sirviendo los datos ya cargados;
- el uso fuera de cuota o del límite de ráfaga (
429), y las peticiones inválidas o sin permiso (4xx); - los ataques o el abuso que obliguen a limitar el acceso para proteger el servicio.
Objetivos de rendimiento
Objetivos de latencia (p95, medidos sobre el mes), por debajo de los cuales operamos el servicio. A diferencia de los compromisos de arriba, son objetivos: si se superan, se investiga y se corrige.
| Operación | Objetivo p95 | Medido (prueba de carga, 6 clientes simultáneos) |
|---|---|---|
| Ficha, anotaciones y catálogos | < 1,5 s | ficha 1,2 s · anotaciones 0,4 s |
| Búsqueda | < 3 s | 1,1 s |
Búsqueda por similitud (similarTo) |
< 5 s | 1,4 s con caché caliente; 4,5–4,7 s en frío para consultas cortas |
| Informes | < 6 s | informe de disponibilidad 3,2 s |
Cadencia de frescura
Tarno mantiene su corpus neutral actualizado ejecutando sus pipelines de ingesta de INAPI en un cron gestionado. La cadencia sigue cómo INAPI mismo publica:
| Fuente | Cadencia de publicación de INAPI | Sync de Tarno |
|---|---|---|
| Datos abiertos de INAPI | Diaria | Cron gestionado, de lunes a sábado (los domingos no hay sync) |
| Estado-Diario | Lunes a viernes (Santiago) | Cron gestionado, en días de publicación |
| Fichas de expediente de INAPI | Continua | Cron gestionado, una vez al día dentro de la cadena diaria (12:00 Chile) |
Los domingos no hay sincronización (decisión de 2026-10-10): la cadena corre de lunes a sábado
a las 12:00 de Chile, así que el domingo dataAsOf sigue en el sábado. stale de GET /system/freshness no cuenta los
domingos (con el umbral por defecto; con thresholdHours explícito, exacto). El lunes la cadena recoge todo lo acumulado. INAPI no publica
Estado Diario en domingo.
Qué es dataAsOf (y qué no). dataAsOf es el instante en que terminó la última corrida de sincronización con
éxito de cualquier fuente de marcas (sync_run.status = 'ok', sin las fuentes documentales). Dice «el corpus se
tocó por última vez a esta hora», no «todas las fuentes están al día a esta hora»: si una fuente falla durante días y
otra sigue corriendo, dataAsOf sigue siendo de hoy. Y una corrida con éxito que no cambia nada también lo avanza: dice
que el pipeline pasó, no que INAPI publicó algo. Para saber qué fuente está atrasada, o cuánto hace que una fuente
cambió el corpus, la verdad es GET /system/freshness (lastRunAt frente a lastMovementAt y stale por fuente).
Cada fuente caducada se vigila además en el monitor con el calendario de Chile (días hábiles y feriados de la tabla
feriado).
Objetivo de frescura: lo que INAPI publica un día hábil, disponible antes de las 15:00
(America/Santiago) de ese día, salvo que INAPI no lo haya publicado a tiempo. Todas las cadencias se
declaran en horario America/Santiago. La frescura por fuente en cada momento la reporta
GET /system/freshness (scope insights:read) — consulta la página de estado. Trata a
GET /system/freshness, no a este documento, como la verdad en vivo sobre qué tan fresco está el
corpus en este momento.
Soporte
El soporte lo atiende el operador en horario laboral (lunes a viernes, America/Santiago, salvo feriados de Chile):
- No hay soporte 24/7. Una caída fuera de horario se atiende al inicio del siguiente horario laboral, y el RTO cuenta desde ahí.
- Para incidencias, contacta a tu operador con el
requestIddel sobre de error (correlaciona tu reporte con el log del servidor). - Los avisos de cambios incompatibles y de obsolescencia se publican en el changelog con la ventana de migración indicada en la política de versionado.
Resumen
| Aspecto | Compromiso |
|---|---|
| Disponibilidad | 99,5 % mensual; errores 5xx < 0,5 % de las peticiones. |
| Datos | RPO 24 h (claves y organizaciones 1 h); copias cifradas fuera de la máquina, 14 días. |
| Recuperación | RTO 4 h dentro del horario de soporte; restauración ensayada. |
| Mantenimiento | Domingos 02:00–06:00 (Santiago), máx. 4 h/mes, aviso de 48 h. La sincronización diaria no corta el servicio. |
| Arquitectura | Una máquina, sin redundancia en caliente; se recupera desde copia. |
| Frescura | Datos abiertos de lunes a sábado (sin sync los domingos); Estado-Diario Lun–Vie (Santiago); en vivo en GET /system/freshness. |
| Soporte | Operador, horario laboral de Chile. Sin soporte 24/7. |