Saltar a contenido

Base documental (Directrices y leyes)

Esta guía cubre la base documental de Tarno: lo que INAPI, BCN y el SII publican sobre el registro de marcas en Chile, guardado literal y versionado y leído por el mismo contrato que las marcas (REST ≡ MCP). Lleva su propio permiso, legal:read (ver Permiso).

El esquema completo y siempre actualizado por campo vive en la referencia OpenAPI interactiva en https://api.tarno.cl/docs (Scalar). Esta guía explica cómo se piden estas lecturas — no reformula el esquema.

A lo largo de la guía la URL base es https://api.tarno.cl y cada llamada lleva el encabezado X-API-Key.

Qué es la base documental

Tres fuentes (el SII con dos corridas), cada una con su corrida propia:

fuente qué guarda corrida
INAPI las Directrices de marcas (capítulo a capítulo, con su página), las circulares, el Sistema de Madrid y la tabla de tasas inapi_documents (semanal)
BCN LeyChile el texto de las leyes del catálogo de normas —la Ley 19.039, su Reglamento…— en todas sus versiones, artículo → letra → inciso, con las notas de modificación bcn_statutes (semanal)
SII los indicadores UTM, UTA, IPC, UF y dólar observado sii_indicators (diaria)
SII (nómina) la razón social, el subtipo, el inicio de actividades y el domicilio vigente (comuna y región) de las personas jurídicas con RUT chileno; se lee en el bloque sii de la parte (Partes) sii_legal_entities (diaria, al final de la cadena de sincronización)

⛔ Lo guardado es lo que escribió la fuente: sin resúmenes, sin paráfrasis y sin «relevancia». Nada se borra: una versión nueva cierra la anterior y la conserva, así que siempre se puede leer qué decía un texto en una fecha pasada.

Hoy se leen las Directrices, las circulares y Madrid —la lista, el Sumario de cada documento y cualquier apartado literal— (abajo), el texto de un artículo a una fecha (abajo), la búsqueda por texto y por parecido en los dos (abajo), la tabla de tasas con los pesos calculados al leer (abajo), los indicadores del SII (abajo) y el registro de cambios de versión (abajo). Y, en el detalle de una anotación, la cita explicada: el texto de cada norma citada tal como regía ese día y los capítulos de las Directrices que la tratan (abajo).

Permiso: legal:read

Toda lectura de la base documental exige legal:read, y ese permiso se concede explícitamente:

  • una clave sin restricción (con scopes vacío) no lo tiene;
  • la clave de prueba tampoco;
  • brands:read y reports:read no lo incluyen.

Sin él, la llamada responde 403 forbidden y el mensaje nombra legal:read. Pídelo a tu operador.

⚠ Para quien concede claves: una lista de scopes no vacía es una lista cerrada. Pasar una clave de [] a ["legal:read"] le quita todas las demás lecturas: hay que escribir la lista completa (por ejemplo ["brands:read", "insights:read", "watch:read", "legal:read"]). Ver autenticación.

La fecha del dato, por fuente

Cada respuesta dice la fecha de su fuente en dataAsOf (y en la cabecera Iris-Data-As-Of cuando la respuesta es un objeto): la última corrida correcta de inapi_documents, bcn_statutes o sii_indicators, según lo que se lea. ⛔ Nunca es la fecha del corpus de marcas: una corrida de marcas de esta mañana no dice nada de cuándo se leyó la Ley 19.039, y al revés. dataAsOf: null significa «no hay ninguna corrida correcta de esa fuente» — no lo sabemos, que es distinto de «hoy».

Directrices, circulares y Madrid

Todo lo que INAPI publica en la base documental: los 50 capítulos de las Directrices de marcas, las circulares, la página y el manual del Sistema de Madrid y las publicaciones de tasas. Tres lecturas, todas con permiso legal:read:

operación REST MCP
la lista de documentos, cada uno con su versión vigente GET /guidance/documents list_guidance_documents
un documento con su Sumario (el árbol de apartados, sin cuerpos) y el historial de sus versiones GET /guidance/documents/{code} get_guidance_document
un apartado literal, con su página, su versión y las normas que cita GET /guidance/documents/{code}/section get_guidance_section

Cómo se cita un apartado

  • La cita estable es (code, version, path): el código del documento (guideline-35 = capítulo 35 de las Directrices), el número de versión (version.seq) y el path del apartado en el propio Sumario de INAPI (III.D, III.D.▪1.§7, III.D.sidebar1, intro). Por ejemplo: «Directrices, cap. 35, versión 2, III.D.▪1.§7 (p. 18)». ⛔ Nunca un id de fila: se reconstruyen cuando se mejora la extracción de una misma versión, y no los publicamos.
  • La cita de un abogado es code + paragraph: «cap. 35 § 7» se pide con paragraph=7. Si ese número se repite dentro de la versión (INAPI numera a veces dos veces), la respuesta es 409 ambiguous_selector con los path candidatos, y se vuelve a pedir por path.
  • Sin version se lee la versión vigente; con version se lee una anterior (INAPI no conserva las versiones viejas en su web; nosotros sí). El historial está en get_guidance_document → versions.

Qué significan partial, image_only y ocr

Cada versión declara en extractionStatus cómo se pudo leer:

valor qué significa
extracted el texto y el Sumario se leyeron limpios
partial el texto es literal, pero el árbol está incompleto: una entrada del Sumario que imprime INAPI no aparece en el cuerpo, o un título rotulado del cuerpo no está en el Sumario (y su texto queda dentro del apartado de arriba). Es una inconsistencia de la fuente, que se declara. Un título que sólo está redactado distinto en el Sumario y en el cuerpo ya no cuenta como partial: el apartado está, con el título del cuerpo
image_only INAPI publicó el documento como imágenes: no hay texto. get_guidance_document responde 200 con outline: [], y pedir un apartado es 422 out_of_coverage con extractionStatus: "image_only"
ocr INAPI publicó el documento como imágenes y su texto se leyó a máquina (reconocimiento de texto, OCR). Tiene un apartado por página (ocr.p1, …) y se encuentra al buscar, pero no es literal: alguna palabra puede estar mal leída y, en un diagrama (el cap. 21, el flujo de tramitación), el orden de las etiquetas es el de la página, no el del procedimiento, y las flechas no son texto. Se cita el PDF, nunca este texto. Los aciertos de search_guidance lo llevan en version.extractionStatus
pending · failed aún no leído / no se pudo leer

⛔ Un capítulo partial o image_only no se rellena con texto que no es de la fuente; el texto de uno ocr es de la fuente, pero leído a máquina, y así se declara.

Parámetros

operación parámetro qué es
lista kind opcional, uno o varios de guideline, circular, manual, web_page, fee_schedule (kind=guideline,circular)
lista q opcional, palabras del título sin acentos ni mayúsculas (2–100 caracteres)
documento, apartado code el código del documento (minúsculas, dígitos y guiones: guideline-35, madrid-page)
documento, apartado version opcional, el número de versión (seq); por defecto, la vigente
apartado path o paragraph uno y sólo uno: el path del Sumario (hasta 200 caracteres, codificado en la URL) o el número de párrafo (1–9999)

La lista va ordenada por tipo, número de capítulo (guideline-2 antes que guideline-10) y código, con total exacto; un documento que INAPI dejó de enlazar sigue en ella con missingSince.

Ejemplo: el § 7 del capítulo 35, en la versión vigente.

curl -sS "https://api.tarno.cl/guidance/documents/guideline-35/section?paragraph=7" \
  -H "X-API-Key: $TARNO_API_KEY"
# o por su path, codificado: ?path=III.D.%E2%96%AA1.%C2%A77
{ "name": "get_guidance_section",
  "arguments": { "code": "guideline-35", "paragraph": 7 } }

La respuesta trae document, version (seq, extractionStatus…), path, kind, heading, paragraphNumber, pageFrom/pageTo, el body literal, children (los hijos directos, para bajar por el Sumario) y citations: cada norma citada con legalNormId (que se lee con get_legal_norm_article), citedNorm (el número de la ley, también si está fuera del catálogo) y lawNamed: false cuando el texto cita un «art. 19» sin decir de qué ley. dataAsOf es la última lectura correcta de INAPI (inapi_documents).

Errores

estado code cuándo
400 validation_error un parámetro desconocido; path y paragraph a la vez, o ninguno; kind=statute (es de BCN); q de un carácter; un code con mayúsculas o /
403 forbidden la clave no tiene legal:read
404 not_found el documento, la versión o el apartado no existen
409 ambiguous_selector el número de párrafo se repite en la versión; candidates trae los path
422 out_of_coverage la versión no tiene texto (image_only); lleva coverage: null y su extractionStatus

El texto de un artículo a una fecha

GET /legal-norms/{id}/articles/{article} ≡ get_legal_norm_article — permiso legal:read.

El artículo literal, tal como BCN lo publica, en la versión que regía para esa norma en asOf, con sus letras, incisos y notas de modificación.

parámetro qué es
id el id de la norma en GET /legal-norms ≡ list_legal_norms (texto opaco)
article la clave del artículo: 20, 17 bis a, 1, único — la misma que traen las citas de las anotaciones. Mayúsculas, un «Artículo»/«Art.» delante y º se ignoran. En REST, con espacios codificados (17%20bis%20a)
letter opcional, una letra (a–z, ñ): sólo esa letra
subsection opcional, un inciso (1–99): de la letra si hay letter, del artículo si no
asOf opcional, YYYY-MM-DD: la fecha cuyo texto quieres. Por defecto, hoy en Chile
transitional opcional, true para el artículo transitorio con esa clave (una ley puede tener un art. 1 permanente y un art. 1 transitorio). Por defecto false. Sólo true o false: otro valor ⇒ 400 validation_error

Ejemplo: el art. 20 letra h de la Ley 19.039 tal como regía el 2021-03-15 (1 es un id ilustrativo; tómalo de GET /legal-norms).

curl -sS "https://api.tarno.cl/legal-norms/1/articles/20?letter=h&asOf=2021-03-15" \
  -H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_legal_norm_article",
  "arguments": { "id": "1", "article": "20", "letter": "h", "asOf": "2021-03-15" } }

Qué texto rige una fecha

Una norma del catálogo puede tener varios textos de BCN a lo largo del tiempo. La Ley 19.039 tiene tres:

desde hasta texto
— 2006-06-19 la Ley 19.039 original
2006-06-20 2022-08-05 el DFL 3 (texto refundido)
2022-08-06 — el DFL 4 (texto refundido vigente)

Y cada texto tiene sus propias vigencias en BCN. La respuesta lo dice todo en text: documentCode (qué texto), validFrom/validTo (su vigencia según BCN), appliesFrom/appliesTo (la ventana en que es el texto de esta norma) y lastSeenAt (la última vez que BCN nos sirvió ese contenido). Una fecha de 2015 lee el DFL 3 aunque BCN dé al DFL 3 una vigencia abierta: manda la ventana de la norma.

Artículos no partidos y transitorios

  • split/splitStatus: split = las letras se encontraron y se verificaron; unsplit = no se pudieron cortar con seguridad (por ejemplo, una lista de letras que reinicia a mitad de artículo) y el artículo se sirve entero; no_letters = el artículo no tiene letras.
  • Si pides una letter de un artículo unsplit, la respuesta es 200 con el artículo entero, letters: [] y selection.status: "article_not_split". ⛔ Nunca un corte inventado.
  • transitional: true lee el artículo transitorio de esa clave; sin él, el permanente.

Errores

Todos con el cuerpo RFC 9457 (application/problem+json), iguales en REST y en MCP:

estado code cuándo
400 validation_error un parámetro desconocido, una letra en mayúscula, una fecha imposible (2026-02-31), subsection fuera de 1–99, un article con / o de más de 40 caracteres
403 forbidden la clave no tiene legal:read
404 not_found la norma no existe; o el artículo, la letra o el inciso no están en el texto de esa fecha
409 ambiguous_selector el texto tiene dos artículos con la misma clave; candidates trae sus nombres. No elegimos uno en silencio
422 out_of_coverage no tenemos texto para responder: con coverage: null, la norma está en el catálogo pero su texto no está cargado; con coverage {from, through}, la fecha cae fuera de las ventanas en que sí lo tenemos (null en un extremo = abierto)

Forma del cuerpo (valores ilustrativos):

{ "type": "https://api.tarno.cl/problems/out_of_coverage", "title": "Business rule not satisfied",
  "status": 422, "code": "out_of_coverage", "requestId": "...",
  "detail": "we have no text of legal norm 1 that applies on 1990-01-01",
  "coverage": { "from": "2006-06-20", "through": null } }

Las respuestas 200 llevan caché de catálogo (Cache-Control: public, max-age=3600, stale-while-revalidate=86400 y Vary: X-API-Key); los errores, no-store.

Dos búsquedas, las dos con permiso legal:read, iguales en REST y en MCP:

qué buscas REST MCP
en los apartados vigentes de los documentos de INAPI (Directrices, circulares, Madrid, tasas) POST /guidance/search search_guidance
artículos de ley, en el texto que regía a una fecha o en todas las vigencias POST /legal-norms/search search_statutes

Sirven para encontrar «qué dice INAPI sobre la coexistencia» o «qué artículo hablaba de la renovación antes de 2022» sin saber el número de apartado ni de artículo. Cada acierto trae la referencia con la que se lee entero (get_guidance_section / get_legal_norm_article) y un extracto literal.

Los tres modos

mode qué hace
hybrid (por defecto) dos canales en paralelo —texto (español, sin acentos ni mayúsculas) y parecido de significado (búsqueda semántica)— fusionados por rango recíproco (RRF)
text sólo palabras. Admite la sintaxis de búsqueda web: "frase exacta", or, -palabra
semantic sólo significado

Cada acierto dice en matchedBy por qué canal salió (text, semantic o los dos). No publicamos puntuaciones: el orden es la respuesta.

⭐ Degradación declarada. Si el canal de significado no puede correr (el servicio de vectores está caído o lento, o la búsqueda vectorial agotó su tiempo), hybrid devuelve lo del texto y lo dice en meta.channels:

"meta": { "dataAsOf": "2026-09-27T05:00:00.000Z", "mode": "hybrid",
          "channels": { "text": "ran", "semantic": "unavailable" } }

En mode: "semantic" no hay nada con qué seguir: la respuesta es 503 service_unavailable. ⛔ Nunca una lista vacía que diga «no hay nada» cuando no se buscó.

En las leyes: asOf o allVersions

  • Por defecto se busca en el texto que rige hoy en Chile, con la misma regla que get_legal_norm_article (Qué texto rige una fecha): buscar y leer dan el mismo texto.
  • asOf: "2015-03-01" busca en el texto que regía ese día.
  • allVersions: true busca en todas las vigencias de todos los textos —para leer contra qué texto se examinó una solicitud antigua—. ⭐ El mismo texto de un artículo repetido en varias vigencias (el DFL 3 tiene cinco) sale una vez, con todas en validity; un texto que cambió es otro acierto.
  • asOf y allVersions juntos son un 400.
  • norm (el id del catálogo) acota a una norma. Sin texto cargado —o sin texto para esa fecha— es 422 out_of_coverage con su coverage, como en la lectura del artículo; inexistente, 404.

Cada acierto de ley trae norm (null si el texto no está enlazado a exactamente una norma del catálogo), document (el texto de BCN: code, title, bcnNormaId), article, articleLabel, transitional, headingPath, excerpt y validity ([{validFrom, validTo}], de la más antigua a la más reciente).

Parámetros

parámetro búsqueda qué es
q las dos lo que buscas, 2–200 caracteres
mode las dos hybrid (defecto), text o semantic
kind Directrices uno o varios de guideline, circular, manual, web_page, fee_schedule
document Directrices sólo ese documento (guideline-35)
norm leyes sólo esa norma del catálogo (su id)
asOf leyes YYYY-MM-DD; por defecto, hoy en Chile
allVersions leyes true para todas las vigencias
limit, cursor las dos 1–50 (defecto 20); cursor es el next de la página anterior, tal cual

Ejemplo: qué artículos hablaban de la renovación, en cualquier vigencia.

curl -sS -X POST "https://api.tarno.cl/legal-norms/search" \
  -H "X-API-Key: $TARNO_API_KEY" -H "Content-Type: application/json" \
  -d '{"q": "renovacion del registro", "allVersions": true}'
{ "name": "search_statutes",
  "arguments": { "q": "renovacion del registro", "allVersions": true } }

Y en las Directrices vigentes:

{ "name": "search_guidance",
  "arguments": { "q": "coexistencia de marcas", "kind": ["guideline"] } }

Errores

estado code cuándo
400 validation_error q sin palabras buscables (sólo palabras vacías: «de la») o que sólo excluye (-marca); q de menos de 2 o más de 200 caracteres; un parámetro desconocido; asOf junto a allVersions
403 forbidden la clave no tiene legal:read
404 not_found norm no existe
422 out_of_coverage norm sin texto cargado (coverage: null) o sin texto para asOf (coverage {from, through})
503 service_unavailable mode: "semantic" y el canal de significado no pudo correr

Una búsqueda no lleva caché de catálogo. meta.dataAsOf es la fecha de su fuente: inapi_documents para las Directrices, bcn_statutes para las leyes.

Tasas

La tabla de tasas de marcas de INAPI, en UTM y literal, con el importe en pesos calculado al leer:

REST MCP
GET /fee-schedule get_fee_schedule

La tabla es la del capítulo 13 de las Directrices de marcas (2026): las cinco tasas (al presentar, al aceptarse a registro, al renovar, anotaciones marginales y apelación) y los seis meses del recargo por renovación tardía. Las otras dos publicaciones de tasas de INAPI (la de 2022 y el anexo antiguo) no se sirven como tabla: sólo se comparan con el cap. 13, y lo que difiere se publica en la nota del recargo.

Cómo se calcula amountClp

  • amountUtm es literal de INAPI (7.2, nunca redondeado).
  • amountClp es un valor DERIVADO al leer: amountUtm × utm.value, exacto y sin redondear (la regla de redondeo de INAPI no es nuestra). Ningún importe en pesos se guarda, así que ninguno caduca.
  • utmMonth (YYYY-MM) elige el mes de la UTM; por defecto, el mes en curso en Chile.
  • utm dice qué UTM se usó:
utm.basis significa
requested_month la UTM del propio utmMonth
latest_published la de ese mes aún no está publicada: se usó la última publicada antes (utm.month dice cuál)
  • Sin ninguna UTM en o antes de utmMonth (la serie del SII empieza en 2013), utm es null y todos los amountClp son null: la tasa en UTM sigue ahí; lo que falta es la conversión.
  • unit: per_class se paga por cada clase de Niza; fixed, una vez por trámite.

Al citar un importe en pesos, di el mes y la fuente: «6 UTM por clase; 430.326 pesos con la UTM de septiembre de 2026».

⭐ Las tasas de un trámite concreto (solicitud + registro, o una renovación con su vencimiento publicado) las calcula POST /fee-schedule/calculate ≡ calculate_fees, con brands:read: ver costos oficiales.

La nota del recargo

La tabla de la sobretasa de las Directrices 2026 (cap. 13; cap. 23 §42) es la regla que se aplica: el 1.er mes en 6 UTM, igual que la renovación en plazo, y así hasta 12 UTM en el 6.º. La nota «(*)» del cap. 13 dice que la renovación se incrementa un 20 % mensual desde la expiración, y otras publicaciones de tasas de INAPI la redactan distinto. Esa discrepancia se publica como nota informativa y no bloquea ningún cálculo (el campo conserva su nombre, surchargeDoubt):

  • surchargeDoubt.description dice cuál es la regla y en qué difieren las notas;
  • surchargeDoubt.notes[] trae las notas literales: primero la del cap. 13 y luego las de las otras publicaciones de INAPI cuya nota difiere (sólo diferencias abiertas), cada una con su documentCode y su documentTitle;
  • las filas a las que se refiere la nota (la renovación y los meses 2.º a 6.º; el 1.er mes lo confirmó INAPI por escrito el 2026-11-04) llevan hasDoubt: true.
curl -sS "https://api.tarno.cl/fee-schedule?utmMonth=2026-09" -H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_fee_schedule", "arguments": { "utmMonth": "2026-09" } }
{ "utm": { "month": "2026-09", "value": 71721, "basis": "requested_month" },
  "items": [ { "itemKey": "renewal_per_class", "amountUtm": 6, "unit": "per_class",
               "amountClp": 430326, "hasDoubt": true },
             { "itemKey": "renewal_surcharge_month_2", "amountUtm": 7.2, "surchargeMonth": 2,
               "amountClp": 516391.2, "hasDoubt": true } ] }
estado code cuándo
400 validation_error utmMonth no es un mes real (2026-13, 2026-9) o un parámetro desconocido
403 forbidden la clave no tiene legal:read
422 out_of_coverage no hay tabla de tasas cargada (coverage: null)

dataAsOf es la fecha de la fuente de documentos de INAPI (inapi_documents). Lleva caché de catálogo.

Indicadores

Los indicadores que publica el SII, por código y rango de fechas:

REST MCP
GET /economic-indicators list_economic_indicators
code qué es un valor por
UTM unidad tributaria mensual mes (fechado el día 1)
UTA unidad tributaria anual mes (fechado el día 1)
IPC índice de precios al consumidor, en puntos (unit: "index_points") mes (fechado el día 1)
UF unidad de fomento — se publica por adelantado día
USD_OBSERVED dólar observado — hasta el día hábil anterior día hábil
  • code es obligatorio; from/to (YYYY-MM-DD, inclusivos) acotan el rango; limit 1–366 (defecto 31) y next paginan. total es exacto.
  • meta.coverage {code, from, through} dice desde y hasta cuándo tenemos ese indicador. Un rango que la solapa en parte devuelve lo que hay; uno enteramente fuera es un 422 out_of_coverage con la cobertura — nunca un 200 vacío que diría «no hubo valores».
  • ⚠ El IPC mezcla bases. El SII lo rebasó: los valores de 2013 dicen «base anual diciembre 2013=100» y los de 2026 «base anual 2023=100». Cada fila trae su baseNote literal, y los puntos de bases distintas no son comparables: no se restan ni se encadenan en una sola cifra.
curl -sS "https://api.tarno.cl/economic-indicators?code=UF&from=2026-09-01&to=2026-09-30" \
  -H "X-API-Key: $TARNO_API_KEY"
{ "name": "list_economic_indicators",
  "arguments": { "code": "IPC", "from": "2025-01-01" } }
estado code cuándo
400 validation_error sin code o con uno desconocido; una fecha imposible; from posterior a to
403 forbidden la clave no tiene legal:read
422 out_of_coverage el rango cae entero fuera de la cobertura (coverage {code, from, through}), o no hay ningún valor del código (coverage: null)

meta.dataAsOf es la fecha de la fuente del SII (sii_indicators).

Cambios de versión

El registro de qué apartados cambiaron cada vez que INAPI publicó otra versión de un documento, o BCN otra vigencia de un texto legal, y cuándo lo detectamos:

REST MCP
GET /guidance/changes list_guidance_changes

Cada cambio trae el document (code, kind, publisher, title), las dos versiones (fromVersion, toVersion: seq y versionTag), detectedAt, effectiveDate, titleChanged, los recuentos (counts {added, removed, modified}) y los apartados que cambiaron (sections [{path, change, headingChanged}]).

  • detectedAt es cuándo lo vimos nosotros (la corrida que bajó la versión nueva), no cuándo el editor la hizo.
  • effectiveDate sólo existe para BCN: la fecha en que el texto nuevo entró en vigor, literal como la da BCN (hay una con 2222-02-02, un marcador de BCN, guardada tal cual). INAPI no publica ninguna: null.
  • A lo sumo 100 apartados por cambio: sectionsTruncated: true dice que hay más, y counts trae siempre los totales. Un apartado se lee con get_guidance_section (el de la versión anterior, con version).
  • Filtros: document, publisher (inapi o bcn) y from/to — el día de detección en hora de Chile. Orden: el más reciente primero; limit 1–100 (defecto 20) y next.
  • ⭐ meta.dataAsOf: con publisher (o con un document), la fecha de su fuente; sin él, la más antigua de inapi_documents y bcn_statutes — el registro mezclado sólo está completo hasta ahí.
{ "name": "list_guidance_changes",
  "arguments": { "publisher": "inapi", "from": "2026-09-01" } }
estado code cuándo
400 validation_error from posterior a to; una fecha imposible; publisher desconocido; limit fuera de 1–100
403 forbidden la clave no tiene legal:read

La cita explicada

Una resolución de INAPI dice «rechazada por el art. 20 letra h) de la Ley 19.039». Con expand=citations, el detalle de esa anotación trae, por cada norma que cita, el texto literal del artículo o la letra que regía en la fecha de la anotación y las señales de las Directrices: los documentos de INAPI que citan ese mismo artículo/letra, con su recuento.

REST MCP
GET /annotations/{id}?expand=citations get_annotation con expand: ["citations"]

⛔ Exige legal:read ADEMÁS de brands:read. Sin él, 403 forbidden que nombra legal:read — y la petición no consume cuota. Sin expand, la anotación es exactamente la de siempre, con brands:read: la clave citations falta.

⛔ Sólo en el detalle. Los listados (GET /trademarks/{n}/annotations, POST /annotations/search, list_trademark_annotations, search_annotations) y GET /trademarks/{n}?expand= rechazan expand=citations con 400: cien anotaciones con sus textos serían una respuesta enorme.

Cada elemento de citations[] (50 como mucho, en el orden en que la resolución las cita; citationsTruncated: true si hay más):

  • lo que la resolución cita: normKind (ley | reglamento), legalNormId (el catálogo de GET /legal-norms), citedNorm (19039), name, article, letter, subsection y span (las palabras literales);
  • text — el texto de ese día, con la misma regla que get_legal_norm_article: asOf (la fecha usada), chosenBy (qué la eligió: act_date, o una de las dos excepciones de abajo), documentCode y bcnNormaId (el texto de BCN), validFrom/validTo (la vigencia de esa versión), articleLabel, split, scope (letter: body es la letra citada; article: body es el artículo entero) y body, literal;
  • textStatus — por qué hay o no hay texto;
  • guidance — las señales (abajo).
textStatus qué significa text
found el artículo (o su letra) que regía ese día sí
letter_not_split el artículo no está partido en letras (nunca se inventa un corte) el artículo entero, scope: "article"
law_not_identified la resolución cita un artículo sin nombrar ninguna ley null, y guidance: []
no_text_loaded la norma está en el catálogo, pero su texto no está cargado null
no_date la anotación no tiene fecha null
out_of_window ningún texto de esa norma regía esa fecha null
article_not_found el texto de ese día no tiene ese artículo null
ambiguous_article el texto de ese día tiene dos artículos permanentes con esa clave (get_legal_norm_article responde 409) null
letter_not_found el artículo no tiene esa letra null

⚠ La fecha usada es la de la anotación, tomada como la de la resolución. Cerca de un cambio de texto (2022-05-09, 2022-08-06) una anotación publicada días después de la resolución leería el texto siguiente: por eso text.asOf dice qué fecha se usó. Y un artículo transitorio no se distingue en la cita: se lee el permanente de ese número.

⚠ Dos excepciones, las dos del Reglamento de la Ley 19.039 y las dos por la plantilla que INAPI copia.

1 · El art. 9 después del 2022-05-09 (chosenBy: "former_regulation_template"). El 2022-05-09 el Decreto 82 derogó el Decreto 236, y su art. 9 cambió de materia: en el DS 236 son las menciones de la solicitud de marca («Toda solicitud para el registro de marcas comerciales contendrá…», letras a-d); en el DS 82, las de patente. INAPI siguió citando en sus resoluciones de marcas la plantilla del DS 236. Cuando la prosa de la anotación lleva la firma textual de esa plantilla —el encabezado «registro de marcas comerciales contendrá» para cualquier letra; «especificación clara de la marca» o «transliteración» para la b; la «Resolución Exenta N° 391» para la c— la cita se lee contra el DS 236 en el último día de su vigencia, y text.asOf es 2022-05-08. Sin firma, el art. 9 sigue la fecha como cualquier otra cita. Medido en producción el 2026-09-29: 254 citas (230 con letra, 24 sin).

2 · El art. 6 y el 7 antes del 2022-05-09 (chosenBy: "later_regulation_template"). La simétrica: desde diciembre de 2017 INAPI citó en sus resoluciones de marcas «art. 6 letra a/b/c/d» y «art. 7 letra b/c» del Reglamento con la numeración y la redacción del DS 82, que entró en vigor el 2022-05-09; los arts. 6 y 7 del DS 236, vigente en esa fecha, no tienen letras, así que la regla de la fecha no encontraba la letra (letter_not_found). Cuando la cita es anterior al 2022-05-09 y la prosa lleva la firma textual de su letra —art. 6: a) «marcas comerciales contendrá»; b) «especificación clara» o «especificar con claridad»; c) «Res. Ex. N° 391 de 2017»; d) «idioma distinto al/del español»; art. 7: b) «nombre propio» o «nombre de una persona»; c) «acompañe poder» o «artículos 15 y 22»— la cita se lee contra el DS 82 en su primer día, y text.asOf es 2022-05-09, posterior al acto: ⚠ ese texto aún no regía en la fecha de la resolución, y chosenBy lo dice para que se pueda advertir. El art. 7 a) y d) (la fórmula «letras a) y d)… nuevos ejemplares», que no casa con el art. 7 d) del DS 82) y cualquier cita sin firma siguen la fecha. Medido en producción el 2026-09-29: 15.353 citas (art. 6: 9.679; art. 7: 5.674), 2017-12-07 → 2022-05-05.

Señales, no veredicto

guidance lista los documentos vigentes de INAPI (Directrices, circulares, manual, página) que citan ese artículo y esa letra, los que más lo citan primero (5 como mucho), cada uno con:

  • citingCount — cuántas citas de ese artículo/letra tiene su versión vigente, y unnamedCount — cuántas no nombran la ley;
  • hasta 3 apartados (path, heading, paragraphNumber, pageFrom, lawNamed): párrafos numerados primero, luego el más corto. Se leen con get_guidance_section (code + path).

⛔ No es «el» apartado que interpreta la cita. Es una señal de dónde habla INAPI de ese artículo, con su recuento; qué apartado aplica al caso lo decide quien lee. (Una heurística que elegía uno eligió en producción el capítulo 43 en vez del 42.)

⭐ Las citas sin ley. En las Directrices de marcas, un «art. 20 letra h)» a secas es la Ley 19.039 (su ley por defecto): esas citas cuentan sólo para citas de la Ley 19.039, y su apartado lo dice con lawNamed: false. Para el Reglamento o cualquier otra ley no se aplica.

curl -H "X-API-Key: $TARNO_API_KEY" \
  "https://api.tarno.cl/annotations/11397483?expand=citations"
{ "name": "get_annotation",
  "arguments": { "id": "11397483", "expand": ["citations"] } }
estado code cuándo
400 validation_error expand distinto de citations; expand en un listado
403 forbidden con expand=citations, la clave no tiene legal:read (o no tiene brands:read)
404 not_found la anotación no existe

Anotaciones por parte y por estado actual

POST /annotations/search ≡ search_annotations (scope brands:read) acepta, desde el 2026-09-28, cinco filtros más. Sin ellos la respuesta es byte a byte la de siempre.

campo qué filtra
partyId los actos de las marcas de esa parte (su id de /parties); uno que no existe ⇒ 404
taxId lo mismo por RUT, con o sin puntos y guion (como mucho uno de partyId/taxId); sin forma de RUT ⇒ 400 invalid_rut
partyRole holder o representative (ausente: los dos); exige parte
relation current (defecto), former (relación retirada) o all; exige parte
trademarkStatus lista de estados: sólo actos de marcas cuyo estado publicado de hoy es uno de ellos — el mismo significado que status de la búsqueda de marcas, nunca el crudo de INAPI
# «¿Qué le pasó este mes a las marcas de este RUT?»
curl -s -X POST "$TARNO_BASE_URL/annotations/search" -H "X-API-Key: $TARNO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"taxId": "76.086.428-5", "dateFrom": "2026-09-01"}'
# «Los actos de este mes sobre marcas hoy registradas, en la sección M5»
curl -s -X POST "$TARNO_BASE_URL/annotations/search" -H "X-API-Key: $TARNO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"trademarkStatus": ["registrada"], "section": "M5", "dateFrom": "2026-09-01"}'

La parte se resuelve primero a los números de sus marcas (hasta 5.000; una parte más grande va por otra forma de la misma consulta), así que el filtro no recorre el corpus por fecha. Medido en producción el 2026-09-28: todos los caminos por debajo de 2 s. El orden (fecha, id) y el cursor son los de siempre. El lote de anotaciones por lista de marcas y el filtro por fecha de detección: más abajo.

El plazo que INAPI imprime en el nombre del acto: inapiTermLabel

Desde el 2026-09-29, cada anotación del recurso —POST /annotations/search ≡ search_annotations, GET /trademarks/{n}/annotations, GET /annotations/{id} ≡ get_annotation y el boletín del día— lleva el campo inapiTermLabel. Algunos actos de INAPI traen en su nombre el plazo que la propia resolución fija («Fondo - Res. Observaciones Escrito (30 días)»); el campo cita ese texto:

{
  "section": "M11",
  "act": "661B",
  "actName": "Fondo - Res. Observaciones Escrito (30 días)",
  "inapiTermLabel": {
    "basis": "inapi_label",
    "text": "30 días",
    "code": "661B",
    "quotedFrom": "actName"
  }
}
  • Sólo una lista cerrada de 14 códigos: las observaciones de escrito administrativas y de forma, fondo y registro (661, 661B, 661D, 813, 813A, 813B, 813D, 931, 931B, 931D) y las de los contenciosos de oposición (738, 964, 925, 926). En cualquier otro acto, null; y también null si el nombre de INAPI no trae el plazo entre paréntesis.
  • Primero el acto: si la anotación tiene act, la cita sale de actName (quotedFrom: "actName"); si no, de sectionName.
  • Fuera, a propósito: la apelación (W146, W148), el pago (W570), W015/W023 y 664B.

⛔ Un rótulo no es un plazo. inapiTermLabel es texto de INAPI citado: no trae fecha, no es un hito y nunca aparece en milestones[]. No se calcula ningún vencimiento a partir de él. Un aviso se redacta como un hecho con su fecha: «El 11-09-2026 INAPI publicó observaciones de fondo; INAPI indica 30 días». La contestación del traslado de oposición, el pago de derechos de concesión y las observaciones siguen sin plazo calculado hasta que haya una norma verificada.

Por lista de marcas y por fecha de detección

Desde el 2026-09-29, POST /annotations/search ≡ search_annotations (scope brands:read) responde en una llamada «qué actos nuevos hay de estas marcas desde la última vez».

campo qué hace
applicationNumbers las anotaciones de hasta 100 marcas, por cursor; los duplicados cuentan una vez. Más de 100 distintas ⇒ 422 batch_too_large; más de 1.000 ⇒ 400. No se combina con applicationNumber, partyId ni taxId (400)
detectedAfter sólo actos que este corpus conoció estrictamente después de este instante (ISO 8601 con zona y con segundos, 2026-10-01T10:00:00Z; sin segundos ⇒ 400; exclusivo). Con applicationNumber o applicationNumbers, los cambios de esas marcas; solo, el feed de todo el corpus
detectedUntil el extremo inclusivo, con el mismo formato (segundos obligatorios). Exige detectedAfter, applicationNumber o applicationNumbers; anterior a detectedAfter ⇒ 400

Cada anotación lleva denomination (la denominación de su marca; cadena vacía si la marca no tiene) y detectedAt: cuándo la conoció este corpus, no cuándo la publicó INAPI (eso es date). Lo importado del legado lleva su fecha de carga (2026-06-28/29, 2026-08-22, 2026-08-27): sirve para «desde ahora», no para reconstruir la historia. Con dedupe (el defecto) un hecho cuenta desde su primera fila: una versión gemela que llega hoy no hace nuevo un hecho viejo.

Con lista o con detección, la respuesta declara meta.detectedThrough, el horizonte seguro: el menor entre ahora y el inicio de cualquier corrida de ingesta en curso. No se sirve nada detectado después, así que ninguna fila de una corrida a medias se salta.

# Primera vez: el estado de mi lista hasta ahora (guarda meta.detectedThrough)
curl -s -X POST "$TARNO_BASE_URL/annotations/search" -H "X-API-Key: $TARNO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"applicationNumbers": ["1510102", "1672581"], "detectedAfter": "2026-09-01T00:00:00Z"}'
# La vez siguiente: «cambios desde X», X = el detectedThrough anterior
curl -s -X POST "$TARNO_BASE_URL/annotations/search" -H "X-API-Key: $TARNO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"applicationNumbers": ["1510102", "1672581"], "detectedAfter": "2026-09-29T13:24:04.323Z"}'

El patrón de cursor: pide con detectedAfter = el detectedThrough de la vez anterior; pagina con cursor y el MISMO detectedUntil = el detectedThrough de la primera página; al terminar, guarda ese valor para la próxima. Ninguna fila se salta ni se repite: lo que el corpus guarde después de ese detectedUntil no entra en el barrido, ni siquiera como versión gemela de un hecho ya servido. Listas de más de 100: trocea en lotes de 100. Medido en producción el 2026-09-29: listas de 100 marcas en 3–15 ms, sin índice nuevo.

El feed de todo el corpus

detectedAfter sin applicationNumber, sin applicationNumbers y sin parte (partyId, taxId) devuelve todos los actos que el corpus conoció desde ese instante, de todas las marcas: quien sigue miles de marcas lee el feed y filtra en su lado, en vez de preguntar lote a lote.

  • Orden de detección, no por fecha del acto: el instante en que el corpus guardó la fila y, a igual instante, su id. Se pagina con cursor. Con dedupe (el defecto) cada hecho sale una vez, en la posición de la fila que lo presenta, y su detectedAt es el de su primera fila: puede ser anterior al de sus vecinos.
  • Sin filtros de contenido. Sólo admite detectedUntil, maxActAgeDays, dedupe, limit y cursor. family, section, citedNorm, article, letter, dateFrom, dateTo, niceClass y trademarkStatus dan 400 nombrando el campo: filtra en tu lado, o nombra las marcas. detectedAfter con partyId o taxId y sin marca también es 400.
  • Cada fila trae lo necesario para avisar sin otra llamada: applicationNumber, denomination, section con sectionName y sectionLabel, date y detectedAt.
  • Antigüedad del acto: maxActAgeDays (entero 0..3650, exige detectedAfter). Sólo salen los actos que tenían como mucho N días cuando el corpus los guardó: su date no es anterior al día UTC de la detección menos N. Un acto fechado después de su detección pasa siempre; uno sin date, nunca. Sirve para que una carga histórica (actos antiguos que el corpus incorpora hoy) no llegue al feed: el servidor no te la envía. El orden, el cursor y meta.detectedThrough no cambian. En el feed, cada página lee un tramo acotado del orden de detección: puede traer menos de limit resultados, o ninguno, con next no nulo — sigue next hasta que sea nulo. También vale con applicationNumber o applicationNumbers.
# Primera página: todo lo conocido desde X (guarda meta.detectedThrough y next)
curl -s -X POST "$TARNO_BASE_URL/annotations/search" -H "X-API-Key: $TARNO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"detectedAfter": "2026-10-03T13:24:04.323Z", "limit": 100}'
# Páginas siguientes: el cursor y, SIEMPRE, detectedUntil = el detectedThrough de la primera página
curl -s -X POST "$TARNO_BASE_URL/annotations/search" -H "X-API-Key: $TARNO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"detectedAfter": "2026-10-03T13:24:04.323Z", "detectedUntil": "2026-10-04T13:20:11.870Z", "limit": 100, "cursor": "<next>"}'
# La próxima vez: detectedAfter = ese detectedThrough

El feed entra por un índice propio, idx_anotacion_created_at_id (migración …513).