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
scopesvacío) no lo tiene; - la clave de prueba tampoco;
brands:readyreports:readno 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 elpathdel 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 conparagraph=7. Si ese número se repite dentro de la versión (INAPI numera a veces dos veces), la respuesta es409 ambiguous_selectorcon lospathcandidatos, y se vuelve a pedir porpath. - Sin
versionse lee la versión vigente; conversionse lee una anterior (INAPI no conserva las versiones viejas en su web; nosotros sí). El historial está enget_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
letterde un artículounsplit, la respuesta es200con el artículo entero,letters: []yselection.status: "article_not_split". ⛔ Nunca un corte inventado. transitional: truelee 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.
Buscar en la base documental
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: truebusca 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 envalidity; un texto que cambió es otro acierto.asOfyallVersionsjuntos son un400.norm(eliddel catálogo) acota a una norma. Sin texto cargado —o sin texto para esa fecha— es422 out_of_coveragecon sucoverage, 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
amountUtmes literal de INAPI (7.2, nunca redondeado).amountClpes 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.utmdice 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),utmesnully todos losamountClpsonnull: la tasa en UTM sigue ahí; lo que falta es la conversión. unit:per_classse 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, conbrands: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.descriptiondice 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 sudocumentCodey sudocumentTitle;- 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 |
codees obligatorio;from/to(YYYY-MM-DD, inclusivos) acotan el rango;limit1–366 (defecto 31) ynextpaginan.totales 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 un422 out_of_coveragecon la cobertura — nunca un200vací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
baseNoteliteral, 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}]).
detectedAtes cuándo lo vimos nosotros (la corrida que bajó la versión nueva), no cuándo el editor la hizo.effectiveDatesólo existe para BCN: la fecha en que el texto nuevo entró en vigor, literal como la da BCN (hay una con2222-02-02, un marcador de BCN, guardada tal cual). INAPI no publica ninguna:null.- A lo sumo 100 apartados por cambio:
sectionsTruncated: truedice que hay más, ycountstrae siempre los totales. Un apartado se lee conget_guidance_section(el de la versión anterior, conversion). - Filtros:
document,publisher(inapiobcn) yfrom/to— el día de detección en hora de Chile. Orden: el más reciente primero;limit1–100 (defecto 20) ynext. - ⭐
meta.dataAsOf: conpublisher(o con undocument), la fecha de su fuente; sin él, la más antigua deinapi_documentsybcn_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 deGET /legal-norms),citedNorm(19039),name,article,letter,subsectionyspan(las palabras literales); text— el texto de ese día, con la misma regla queget_legal_norm_article:asOf(la fecha usada),chosenBy(qué la eligió:act_date, o una de las dos excepciones de abajo),documentCodeybcnNormaId(el texto de BCN),validFrom/validTo(la vigencia de esa versión),articleLabel,split,scope(letter:bodyes la letra citada;article:bodyes el artículo entero) ybody, 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, yunnamedCount— 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 conget_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énnullsi el nombre de INAPI no trae el plazo entre paréntesis. - Primero el acto: si la anotación tiene
act, la cita sale deactName(quotedFrom: "actName"); si no, desectionName. - Fuera, a propósito: la apelación (
W146,W148), el pago (W570),W015/W023y664B.
⛔ 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 concursor. Condedupe(el defecto) cada hecho sale una vez, en la posición de la fila que lo presenta, y sudetectedAtes el de su primera fila: puede ser anterior al de sus vecinos. - Sin filtros de contenido. Sólo admite
detectedUntil,maxActAgeDays,dedupe,limitycursor.family,section,citedNorm,article,letter,dateFrom,dateTo,niceClassytrademarkStatusdan400nombrando el campo: filtra en tu lado, o nombra las marcas.detectedAfterconpartyIdotaxIdy sin marca también es400. - Cada fila trae lo necesario para avisar sin otra llamada:
applicationNumber,denomination,sectionconsectionNameysectionLabel,dateydetectedAt. - Antigüedad del acto:
maxActAgeDays(entero 0..3650, exigedetectedAfter). Sólo salen los actos que tenían como mucho N días cuando el corpus los guardó: sudateno es anterior al día UTC de la detección menos N. Un acto fechado después de su detección pasa siempre; uno sindate, 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 ymeta.detectedThroughno cambian. En el feed, cada página lee un tramo acotado del orden de detección: puede traer menos delimitresultados, o ninguno, connextno nulo — siguenexthasta que sea nulo. También vale conapplicationNumberoapplicationNumbers.
# 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).