Saltar a contenido

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 requestId del 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.