Informes y oposiciones
Esta guía cubre las lecturas enfocadas en registrabilidad y oposiciones del contrato de Tarno y los
informes de una llamada (/reports/*). Las cuatro lecturas usan el scope brands:read; los informes
llevan su propio permiso (ver Scopes). Todo tiene equivalente MCP.
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 y enlaza a esa referencia — no reformula el esquema. La referencia es autoritativa para la lista de campos.
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é cubre esta guía
Cuatro lecturas, todas sin prefijo de versión y con scope brands:read:
- Informe de registrabilidad — ya no es una ruta: es el detalle de una marca con
expand=parties,annotations,encumbrances,classes,norms. Un solo objeto con una sola semántica de nulos. - Timeline de oposiciones — ya no es una ruta: es el filtro
family=oppositionsobre las anotaciones de una marca. - Oposiciones abiertas — ya no es una ruta: es la búsqueda con
oppositionWindow: "open". - Calendario de renovación —
GET /trademarks/renewal-calendar≡get_renewal_calendar: las fechas de renovación (art. 24) de un lote o de un filtro en un rango de hasta 366 días (detalle).
Y los informes de una llamada (los más recientes tienen su sección más abajo), con permiso propio (reports:read o el del informe):
- Boletín del día —
GET /reports/daily-bulletin≡get_daily_bulletin: lo que el Estado Diario publicó en una fecha, por sección y con partes. - Disponibilidad —
GET /reports/clearance≡get_clearance_report: qué hay parecido a un nombre en una o varias clases, como señales (nunca «registrable»). - Cartera de una parte —
GET /reports/portfolio≡get_portfolio_report: las marcas de una parte (por suid, nunca por su nombre) con sus recuentos, hitos próximos, ventanas de oposición, oposiciones recibidas, representantes y relaciones. - Escrito para presentar una oposición —
GET /reports/opposition-brief≡get_opposition_brief: la marca objetivo, si está hoy en ventana, su parecido con tu marca y el historial de oposiciones de sus titulares. - Escrito para responder a una oposición —
GET /reports/opposition-response-brief≡get_opposition_response_brief: los actos de oposición sobre tu marca, quién se opone, con qué normas y con qué historial. - Expediente de hechos de un escrito —
GET /reports/filing-context≡get_filing_context: los hechos de un poder, una oposición, una contestación, una respuesta a observaciones o un desistimiento, cada uno con su fuente, sin redacción (detalle).
⛔ Todos dan señales, nunca veredictos: ninguno dice si una marca es registrable, si una oposición prosperará o si hay riesgo — la decisión jurídica es del lector.
Estas lecturas son de solo lectura y honestas por diseño: nunca fabrican fechas ni plazos que el corpus no puede sustentar.
Informe de registrabilidad
GET /trademarks/{applicationNumber}?expand=parties,annotations,encumbrances,classes,norms — scope
brands:read (y además legal:read si expand lleva norms). MCP: get_trademark con expand.
El informe es el detalle de la marca con sus secciones expandidas: parties, annotations,
encumbrances, classes y norms. Un solo objeto con una sola semántica de nulos — el defecto que
tenía dos rutas (detalle e informe) con la misma forma y dos semánticas queda cerrado.
⚠ null NO es [], y la diferencia es todo el mecanismo:
| valor | significa |
|---|---|
[] |
pregunté y esta marca no tiene ninguna |
null |
no pregunté (no venía en expand=) |
Los gravámenes (encumbrances)
encumbrances[] trae una entrada por carga sobre la marca —prenda, medida precautoria, embargo o
prohibición— con su inscripción emparejada al alzamiento que la levantó. Las activas primero.
state |
significa |
|---|---|
active |
inscrita y sin alzamiento inscrito que la cierre |
released |
un alzamiento inscrito la cerró (recordedOn: null si su inscripción es anterior al corpus) |
filed |
presentada, sin resolución que la cierre (hoy, presentaciones de 2024–2026 en trámite) |
rejected |
INAPI la rechazó (537); nunca rigió |
abandoned |
abandonada sin inscribirse (falta de pago, observaciones sin cumplir o desistimiento); nunca rigió |
Una carga sólo rige si INAPI la inscribe: la anotación A0xI es la presentación, y lo que la hace
regir es la resolución de inscripción (1104, 638, o su publicación en el Estado Diario). Un alzamiento
(A0xA) sólo alza si se inscribe (639). filed, rejected y abandoned no son gravámenes vigentes ni
deben disparar avisos; traen filedOn (fecha de presentación) y recordedOn: null.
Las cargas de 2007–2011 (registrationSection W340, W360 o W370) traen siempre filedOn, la fecha
de presentación; recordedOn es la de su inscripción. En una carga moderna vigente o alzada, filedOn es
null y recordedOn es la fecha de su A0xI. ⚠ Con releaseObservable: false una carga
active puede haberse alzado: la marca tiene, después de su inscripción, un alzamiento que el corpus no
puede atribuir a una carga concreta (el expediente de INAPI nombra el nº de anotación; el corpus no lo
guarda). Esos alzamientos salen aparte como released con recordedOn: null.
recordedOnBasis dice qué fecha es recordedOn: "filing" en una carga moderna (es la fecha de
presentación de su A0xI; la inscripción es una resolución posterior que no se publica como fecha),
"recordal" en una de 2007–2011 (su inscripción), null cuando recordedOn es null. No escribas
«inscrita el…» sobre una fecha "filing".
⚠ Con releaseAttributionCertain: false qué carga levantó un alzamiento es una atribución, no un
dato: el alzamiento llegó con dos o más cargas de su tipo vigentes y se emparejó con la más antigua. Lo
llevan todas las que estaban vigentes en ese momento; la que sale released puede seguir vigente y una
active puede ser la alzada. Cuántos alzamientos hubo es seguro; a cuál corresponde cada uno, no.
releaseStatusCertain responde otra pregunta: si el estado (active / released) es seguro aunque
el emparejado no lo sea. Es true cuando la atribución ya es segura, cuando todas las cargas del tipo de la marca están alzadas (cada una lo
está con seguridad; sólo su releasedOn es una atribución) o cuando el alzamiento sólo pudo levantar una
carga, porque la otra se presentó ese mismo día. Es false siempre que releaseObservable sea false.
Para decir «sigue vigente» o «se alzó», usa releaseStatusCertain; para decir «se alzó el …», además
releaseAttributionCertain. Donde el historial lleva el número de anotación de
INAPI, dos cargas idénticas del mismo día son dos entradas, y cuando INAPI dice qué carga levanta un
alzamiento el emparejado es seguro. Límite: en una marca cuyo historial aún no lleva números, dos cargas
idénticas del mismo tipo presentadas el mismo día pueden verse como una, y entonces el estado puede ser
erróneo.
Donde las resoluciones de INAPI llevan el número de anotación, cada presentación se resuelve por su
número: un alzamiento presentado dos veces el mismo día cuyo duplicado se desistió o se rechazó cuenta una
sola vez, y una carga rechazada o abandonada por su número no se publica como vigente aunque otra del mismo
día se inscribiera. Si la resolución de inscripción de un alzamiento (639) nombra una carga que no está
vigente en la marca, ese alzamiento nunca toma una carga que otro 639 nombra, y lo que cierre por
antigüedad, y las demás cargas que pudo tomar, sale con releaseAttributionCertain: false y, salvo que todas las cargas del tipo estén
alzadas, releaseStatusCertain: false.
Cada entrada lleva además annotationNumber, el número de anotación de INAPI de la carga (el que se
cita), y releaseAnnotationNumber, el del alzamiento que la levantó; null cuando no se conoce.
Las normas citadas en el expediente (norms)
norms[] trae una entrada por (tipo, norma, artículo, letra, inciso) citada en las anotaciones de la
marca: normKind, legalNormId (null si el acto cita un artículo sin nombrar ley — se incluye igual),
citedNorm, name, article, letter, subsection, annotationCount, firstCitedOn, lastCitedOn y
hasta 20 annotationIds (las más recientes). Las más citadas primero, a lo sumo 100 (normsTruncated).
Con dedupe=true (el defecto) cuenta hechos, y los ids son los de annotations[]. No trae el texto
de la ley: para leerlo, GET /annotations/{id}?expand=citations con uno de los annotationIds.
⚠ norms exige el permiso legal:read además de brands:read, como expand=citations: sin él la
petición entera responde 403 forbidden que nombra legal:read, sin consumir cuota. Una clave sin
legal:read pide expand=parties,annotations,encumbrances,classes.
curl -sS "https://api.tarno.cl/trademarks/123456?expand=parties,annotations,encumbrances,classes,norms" \
-H "X-API-Key: $TARNO_API_KEY"
const res = await fetch(
"https://api.tarno.cl/trademarks/123456?expand=parties,annotations,encumbrances,classes,norms",
{ headers: { "X-API-Key": process.env.TARNO_API_KEY! } },
);
if (!res.ok) {
const problem = await res.json(); // application/problem+json (RFC 9457)
throw new Error(`${problem.status} ${problem.code}: ${problem.detail} (requestId=${problem.requestId})`);
}
const trademark = await res.json(); // objeto marca con las secciones pedidas
console.log(trademark.status, trademark.statusInapi, trademark.classes); // status = derivado (D11)
El acto de cada anotación (annotations[]): además de section, cada anotación lleva act —el
código de INAPI del acto concreto que nombra (p. ej. «Fondo-Res. Favorable Escrito» bajo M11 es
664B)— con actName/actLabel, y actStatus, que viaja siempre y dice qué significa un act
nulo: not_applicable (la sección ya es el acto), unidentified (nombra un acto que no se pudo
identificar: «no lo sabemos», nunca un código plausible) o identified.
Para la lista completa de campos de la marca (y de cada sección expandida), consulta la referencia
https://api.tarno.cl/docs — no se duplica aquí. Conserva la frescura en cabeceras (Iris-Data-As-Of,
Iris-Coverage-Through) y ETag + If-None-Match → 304.
Timeline de oposiciones de una marca
GET /trademarks/{applicationNumber}/annotations?family=opposition — scope brands:read. MCP:
list_trademark_annotations con family: "opposition".
La línea de tiempo de oposición es el filtro family=opposition sobre las anotaciones de una marca: una
colección cronológica de los actos de oposición, con el sobre común { results[], limit, next, hasMore, total,
meta }.
curl -sS "https://api.tarno.cl/trademarks/123456/annotations?family=opposition" \
-H "X-API-Key: $TARNO_API_KEY"
La ventana de oposición (publicación + 30 días hábiles) vive en el objeto marca (oppositionWindow),
no en esta colección. null significa que la marca no tiene fecha de publicación, así que no hay ventana que
computar — nunca se fabrica sin su fecha de origen.
Las fechas con nombre de la marca viajan en milestones[] (en el objeto marca y en cada marca de
una colección); la lista de tipos, con qué publica cada uno y cuándo es una estimación, está en
Hitos. El cierre de esta ventana viaja ahí como opposition_close, con su
base legal (Ley 19.039 arts. 5 y 11, Ley 19.880 art. 25) —derived, o estimated y marcado cuando no
se puede afirmar—, y oppositionWindow lleva la misma legalBasis.
Oposiciones abiertas en una clase
POST /trademarks/search con oppositionWindow: "open" — scope brands:read. MCP: search_trademarks.
Lista marcas con ventana de oposición abierta, rankeadas por similitud a un portafolio. El caso de
uso: vigilar amenazas de registro en tu clase. El portafolio contra el que se ordena es q (texto
libre) o applicationNumber (UNA marca tuya existente), y la clase es obligatoria:
curl -sS -X POST "https://api.tarno.cl/trademarks/search" \
-H "X-API-Key: $TARNO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"oppositionWindow":"open","niceClass":[43],"q":"cafe example"}'
Las reglas de la ventana.
niceClasses obligatoria (una o varias clases) y hay que enviar exactamente uno deqoapplicationNumber(un solo número: es la marca contra la que se ordena, no un lote). ⛔ La ventana no se combina consimilarTo/similarToTrademark— ya ordena por parecido al portafolio —: esa combinación es400 validation_error. Para «marcas parecidas a X» sin ventana, usasimilarTo(texto libre) osimilarToTrademark(una marca existente), nunca los dos a la vez.
oppositionWindowadmite sólo"open":closedyanyno existen y son400 validation_error. UnapplicationNumberde cartera que no está en el corpus (o que ni tiene forma de número) es404 not_found, nunca un200vacío: «ninguna parecida en ventana» se dice sobre una marca que existe.
Qué marca está «en ventana». La que (1) tiene fecha de publicación (publishedOn, la publicación en
el Diario Oficial), (2) cuyo 30.º día hábil tras publicarse es hoy o después — días de Chile,
contados con el calendario de feriados — y (3) cuyo status no es terminal
(rechazada, denegada, desistida, abandonada, anulada, caducado, vencida; la lista de
liveOnly) y (4) cuyo status tampoco es registrada ni concedida — una marca registrada o
concedida ya no admite oposición (liveOnly, en cambio, la conserva: está viva). Usa el mismo plazo que el objeto marca publica en oppositionWindow, con la misma
aritmética: no un plazo aparte. Pero oppositionWindow publica el plazo sin mirar el estado: una marca
registrada/concedida puede traer expired: false y no estar en ventana — no deduzcáis la
pertenencia de !expired. En la práctica son marcas en_tramite — INAPI no emite el estado
publicada. Si el calendario no cubre de hoy − 90 a hoy + 60 días, la respuesta es 422 out_of_coverage, nunca una
lista calculada con feriados que faltan. La misma regla da el «en ventana» de la disponibilidad y de la
cartera (inOppositionWindow).
Los demás filtros se aplican (ya no se ignoran en silencio): status, signType,
holder/representative/taxId (con relation), las cuatro parejas de fechas (filedFrom/To,
registeredFrom/To, expiresFrom/To, publishedFrom/To), registrationNumber, liveOnly y
varias clases (niceClass como lista). La ventana de oposición acepta también varias clases. Todos
entran dentro de cada canal de parecido, no como filtro posterior (salvo en los canales léxicos con
liveOnly, status=caducado, vencimiento, hitos o renewalStatus, donde se aplican tras puntuar: mismo
resultado y mismo orden).
sort sólo admite relevance: el resultado ordena por parecido, y ordenar por fecha o denominación
lo destruiría. denomination y facets no se combinan con la similitud ni con la oposición. Cualquiera
de estas combinaciones es un 400 validation_error.
Y los mismos errores que la colección: un taxId sin forma de RUT es 400 invalid_rut, y un rango con
From > To (filedFrom/To, expiresFrom/To, registeredFrom/To, publishedFrom/To, milestoneFrom/To)
es 400 invalid_range — con el mismo mensaje. Nunca un 200 con la lista vacía.
liveOnly=true excluye las marcas en uno de los siete estados terminales (rechazada, denegada, desistida, abandonada, anulada, caducado, vencida); una
marca sin estado se conserva.
La respuesta es el sobre común { results[], limit, next, hasMore, total, meta }, paginado por keyset.
Calendario de renovación
GET /trademarks/renewal-calendar?from=…&to=… — scope brands:read. MCP: get_renewal_calendar.
Las fechas de renovación de un conjunto de marcas en una llamada: una fila por (marca, hito) cuya
fecha cae en el rango, ordenadas por fecha y número. Los hitos son los dos de la ventana de renovación
del art. 24 de la Ley 19.039 —renewal_window_open (vencimiento − 6 meses) y grace_end (vencimiento + 6
meses, corrido al primer día hábil si es inhábil)— y cada fila es el hito tal como la marca lo publica en sus milestones[] (misma fecha, ancla,
regla y legalBasis), más su applicationNumber.
| parámetro | qué es |
|---|---|
from / to |
obligatorios (YYYY-MM-DD, inclusivos); como mucho 366 días contando los dos extremos. Más, 400 validation_error; from > to, 400 invalid_range |
| filtros de marca | los de GET /trademarks: el lote (applicationNumber, hasta 100), renewalStatus, holder, niceClass, status, fechas… denomination acota por subcadena. q, la similitud, la ventana de oposición, facets y los filtros de norma son 400 |
limit / cursor |
la paginación de siempre (defecto 20, máximo 100); total es exacto. El cursor sólo vale con el mismo filtro (rango incluido; limit sí puede cambiar): con otro, 400 validation_error sobre cursor |
Una marca del régimen anterior al 2022-05-09, vía Madrid, sin fecha de vencimiento o que no está
registrada ni esperando_renovacion no publica esos hitos y no aporta filas; tampoco una en
renewalStatus: renewed_expiry_pending (la renovación ya está concedida y el vencimiento publicado aún no
se ha actualizado, antes o después de ese vencimiento). El calendario publica
fechas; a quién avisar y cuándo lo decide el consumidor.
# «Las fechas de renovación de mi lista este año» — el lote de hasta 100, en una llamada.
curl -sS "https://api.tarno.cl/trademarks/renewal-calendar?applicationNumber=1161630,1197627,1192677&from=2026-01-01&to=2026-12-31" \
-H "X-API-Key: $TARNO_API_KEY"
# → results = [{ "applicationNumber": "1161630", "kind": "renewal_window_open", "date": "2026-01-18",
# "basis": "derived", "anchor": { "kind": "expiry", "date": "2026-07-18" },
# "rule": "6_months_before_expiry", "legalBasis": [ … art. 24 … ] }, …]
{ "name": "get_renewal_calendar", "arguments": { "applicationNumber": ["1161630"], "from": "2026-01-01", "to": "2026-12-31" } }
La cartera como objeto: POST /trademarks/renewal-calendar. La misma respuesta por el cuerpo JSON,
más el objeto portfolio (party, refine, includeApplicationNumber, excludeApplicationNumber), el
mismo de POST /trademarks/search y POST /trademarks/application-numbers: conjunto =
(((partes ∩ refine) ∪ incluidas) − excluidas) ∩ filtros de primer nivel. refine acota sólo las marcas de
las partes, así que una marca añadida a mano está en el calendario aunque no cumpla refine, y una
excluida a mano no está nunca. Hasta 10.000 números por lista. Con portfolio, party,
includeApplicationNumber o excludeApplicationNumber de primer nivel son 400 validation_error. El cursor
va atado al filtro entero, portfolio incluido. get_renewal_calendar acepta el mismo portfolio; la GET
sigue plana.
curl -sS -X POST "https://api.tarno.cl/trademarks/renewal-calendar" \
-H "X-API-Key: $TARNO_API_KEY" -H "Content-Type: application/json" \
-d '{ "from": "2026-01-01", "to": "2026-12-31",
"portfolio": { "party": ["123:holder"], "refine": { "niceClass": [9] },
"includeApplicationNumber": ["1161630"], "excludeApplicationNumber": ["1197627"] } }'
Boletín del día
GET /reports/daily-bulletin?date=YYYY-MM-DD — permiso reports:read o reports:daily-bulletin:read. MCP:
get_daily_bulletin.
Lo que el Estado Diario publicó en una fecha, en una llamada: cada acto del día con la forma
publicada de la anotación (partes incluidas), en el sobre común paginado (limit ≤ 100, cursor), y
total exacto. En meta:
| campo | qué es |
|---|---|
meta.date |
la fecha pedida |
meta.sections[] |
el índice del día entero: { code, label, count } por sección, con label en es-CL/en/pt-BR — no cambia aunque filtres por section |
meta.bulletins[] |
los boletines ingeridos ese día (tipo2, altas) con los actos que registró la ingesta |
meta.coverageThrough |
⭐ el último boletín del Estado Diario ingerido: el mismo valor que coverage.through del 422 out_of_coverage (no la fecha de presentación del corpus, que es la de las demás rutas) |
section (lista, ?section=M5,OPO08 o repetida) acota las filas. Las filas no se colapsan por
evento: el boletín es lo publicado; versionsOfFact sigue diciendo si el hecho tiene otras versiones.
Cada fila lleva también act y actStatus, como en el informe: bajo el encabezado de subsección
que imprime el boletín («Fondo-Res. Favorable Escrito» en M11) act trae el código de INAPI de ese
acto (664B); actStatus dice si está identified, si el boletín nombra un acto que no se pudo
identificar (unidentified) o si la sección ya es el acto (not_applicable).
⛔ Un día sin boletín ingerido es 422 out_of_coverage, con coverage: { from, through } en el cuerpo
del error — nunca una lista vacía: «no pasó nada» y «no lo leímos» son respuestas distintas. Un fin de
semana o un feriado tampoco tiene boletín; GET /system/coverage distingue el feriado del hueco.
curl -sS "https://api.tarno.cl/reports/daily-bulletin?date=2026-09-22§ion=M5&limit=50" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_daily_bulletin", "arguments": { "date": "2026-09-22", "section": ["M5"], "limit": 50 } }
Disponibilidad (señales, no veredictos)
GET /reports/clearance?text=…&niceClass=… — permiso reports:read o reports:clearance:read. MCP:
get_clearance_report.
Qué hay parecido a un nombre en una o varias clases (niceClass, de 1 a 10, obligatoria), en una
llamada, como un conjunto de señales con su fuente. ⛔ No dice si el nombre es registrable,
disponible, arriesgado ni si infringe: eso es una opinión jurídica, y es del lector. Ningún informe
publica un campo así (lo impide una prueba del contrato).
| campo | qué es |
|---|---|
similar[] |
los confundibles por canal del motor de parecido: phonetic, fuzzy (léxico; se omite si su canal falló en este informe), semantic (se omite si no se evaluó o no aportó nada — nunca vacío) y distinctive (el elemento distintivo, sin los términos genéricos; sólo si el canal corrió), hasta 20 por canal, cada uno con su score/signals y inOppositionWindow |
genericTerms, distinctiveCore, decompounded |
sólo si corrió el canal distinctive: qué términos se trataron como genéricos y por qué, qué se buscó y qué palabras pegadas se separaron |
dominantHolders[] |
los 10 titulares con más marcas en esas clases ({ key: partyId, label, count }, cualquier estado) |
citedNorms[] |
las normas/artículos citados en las anotaciones de los confundibles, con trademarkCount, annotationCount y hasta 5 números de evidence (los más parecidos primero) |
dataAsOf, coverageThrough |
la frescura, en el cuerpo (y en cabeceras) |
inOppositionWindow es pertenencia (la marca está hoy dentro de sus 30 días hábiles de oposición);
la fecha de cierre viaja en los milestones[] de la marca como opposition_close, con su artículo. Una norma citada es una señal de lo que
se ha invocado alrededor de marcas parecidas, no una causal aplicada a tu nombre.
El grupo distinctive («Parecido en el elemento distintivo»). Cuando el texto lleva términos genéricos
en las clases pedidas («ALTODESEMPEÑO CONSULTORES» en la 35), el informe añade un grupo con lo que se parece
a lo que queda: en ese caso encuentra «MAS DESEMPEÑO», que los otros tres canales no veían. Cómo se decide
qué es genérico y cuánto pesa el canal está en Búsqueda. Sin nada que
descontar, o si lo que queda tiene menos de 3 letras, ni hay grupo ni viajan las tres claves: el informe es
el de antes. Latencia: con términos genéricos, el informe tarda del orden
de 0,7 s más (medido el 2026-09-28). ⛔ Que un término sea genérico no es un veredicto.
curl -sS "https://api.tarno.cl/reports/clearance?text=cafe%20andino&niceClass=43,30" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_clearance_report", "arguments": { "text": "cafe andino", "niceClass": [43, 30] } }
Panorama de conflicto
GET /reports/conflict-landscape?text=…&niceClass=… — permiso reports:read o
reports:conflict-landscape:read. MCP: get_conflict_landscape.
«¿Quién representa, y quién es titular de, las marcas parecidas a la mía?», en una llamada. Parte del
mismo motor y los mismos canales que la disponibilidad (fonético, léxico, semántico y del
elemento distintivo): las 60 marcas más parecidas al texto en las clases (niceClass, 1 a 10,
obligatoria). De ellas se quedan las vivas: las de estado terminal se cuentan y se dejan fuera. Luego
se agrupan por las partes con relación vigente.
| campo | qué es |
|---|---|
representatives[], holders[] |
hasta 20 partes por lado (primero las que más parecidas llevan) |
└ party |
{ id, name } — el id de /parties |
└ similarTrademarks |
cuántas de las parecidas vivas lleva la parte, con relación vigente |
└ evidence[] |
hasta 5 de esas marcas (las más parecidas primero), con applicationNumber, denomination y matchedBy; evidenceTruncated si hay más |
└ totalTrademarksInClass[] |
por cada clase pedida, todas las marcas de la parte en ese lado (cualquier estado): el tamaño contra el que se lee similarTrademarks |
partiesTotal |
cuántas partes había en cada lista antes del corte en 20 |
method |
el umbral (similarLimit = 60), cuántas devolvió el motor, cuántas vivas y cuántas terminales quedaron fuera, los estados terminales y relation: current, con la descripción en tres idiomas |
genericTerms, distinctiveCore, decompounded |
el descuento del motor, sólo si corrió el canal distinctive (igual que en la disponibilidad) |
dataAsOf, coverageThrough |
la frescura |
⛔ Son señales del corpus. No dicen nada sobre una parte, un conflicto ni la registrabilidad del
nombre. Que un representante lleve muchas marcas parecidas en una clase puede significar solo que es
grande: por eso viaja totalTrademarksInClass.
Permiso propio: se construye sobre la disponibilidad, que es un informe que se vende, así que tiene su
propio permiso. Ni reports:clearance:read ni una clave sin restricción lo reciben. Sin él, 403
forbidden que nombra reports:conflict-landscape:read, sin consumir cuota.
curl -sS "https://api.tarno.cl/reports/conflict-landscape?text=altodesempe%C3%B1o%20consultores&niceClass=35" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_conflict_landscape", "arguments": { "text": "ALTODESEMPEÑO CONSULTORES", "niceClass": [35] } }
Índice orientativo (señales, no un veredicto)
GET /reports/registration-signals?text=…&niceClass=… — permiso reports:read o
reports:registration-signals:read. MCP: get_registration_signals.
«¿Qué señales de conflicto tiene este nombre en estas clases, y de dónde sale cada una?», en una
llamada. No es un «riesgo» con nivel: es un desglose de señales, cada una con su valor, su n, su
evidencia y su fuente, y un signalIndex de 0 a 100 cuya fórmula viaja en la respuesta. niceClass
es obligatoria, de 1 a 3 clases (el informe hace una disponibilidad y las estadísticas de cada clase;
con 4 ⇒ 400).
Por cada clase (perClass[]), seis señales:
| señal | qué mide | de dónde sale | cómo se normaliza |
|---|---|---|---|
| S1 | el parecido máximo con una marca viva de la clase | la disponibilidad (una llamada, todas las clases): el score de las parecidas vivas |
max(score); 0 si no hay ninguna |
| S2 | cuántas marcas vivas son muy parecidas | la disponibilidad: las de score ≥ 0,8 |
min(1, log10(1+n)/log10(21)): llega a 1 con 20 |
| S3 | la proporción de denegadas entre las decididas de la clase | get_class_stats, periodo por defecto |
refusedShare = denegadas / decididas |
| S4 | la proporción con observación de fondo en la clase | get_class_stats |
actsShare.substantiveObjection.share |
| S5 | la proporción de las parecidas vivas con un acto de oposición | las anotaciones de familia oposicion de esas marcas |
con acto / parecidas vivas, con su coverageNote |
| S6 | las parecidas vivas hoy en ventana de oposición | la disponibilidad (inOppositionWindow) |
ninguna: un recuento, fuera del índice |
Cada señal trae id, name (tres idiomas), value, n, inIndex, weight, nullReason, source,
normalization y evidence (hasta 5 marcas en el orden de parecido, o el cociente con su periodo y su
dataAsOf). Las vivas son las de estado publicado fuera de los terminales (method.terminalStatuses),
el mismo criterio que el panorama de conflicto.
La fórmula (campo formula, literal, y weights):
signalIndex = round(100 × (0.35·S1 + 0.20·S2 + 0.20·S3 + 0.15·S4 + 0.10·S5))
- Una señal nula (
value: null, con sunullReason:class_stats_pending,no_decided_in_period,no_population_in_period,no_live_similar) queda fuera y su peso se reparte entre las demás en proporción a sus pesos.weightsApplieddice los pesos aplicados (redondeados a 4 decimales), y el índice se reproduce exactamente con ellos:round(100 × Σ weightsApplied·value). - Los pesos son provisionales (
method.weightsProvisional: true): los aprobó el equipo de Tarno para revisarlos, no salen de una calibración. Se revisan con el uso. indexLabel: «Índice orientativo: no es un veredicto», en los tres idiomas. Citadlo con el índice.
⛔ Lo que NO es. No dice si un nombre se puede registrar, ni si infringe, ni un nivel (bajo, medio, alto), ni una recomendación de presentar o no. Son señales del corpus con su fuente; la decisión jurídica es de quien lee. Mostrad las señales, no sólo el número.
Antes del primer cálculo de las estadísticas de clase (justo tras un despliegue), S3 y S4 salen
nulas con class_stats_pending y su peso se reparte: el índice se calcula con S1, S2 y S5, y lo dice.
Permiso propio: se construye sobre la disponibilidad, que es un informe que se vende. Ni
reports:clearance:read ni una clave sin restricción lo reciben. Sin él, 403 forbidden que nombra
reports:registration-signals:read, sin consumir cuota. Latencia: la de la disponibilidad (1–4 s).
curl -sS "https://api.tarno.cl/reports/registration-signals?text=altodesempe%C3%B1o%20consultores&niceClass=35" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_registration_signals", "arguments": { "text": "ALTODESEMPEÑO CONSULTORES", "niceClass": [35] } }
Cartera de una parte
GET /reports/portfolio?partyId=… — permiso reports:read o reports:portfolio:read. MCP:
get_portfolio_report.
La cartera de una parte en una llamada. ⛔ Se construye por su identidad (partyId: el id de
GET /parties/{id} / get_party, o el partyId de una anotación), nunca por su nombre: holder es
una subcadena, y la cartera de «ACME» por nombre traería las marcas de «ACME CHILE».
| parámetro | qué es |
|---|---|
partyId |
obligatorio — el id de la parte |
relation |
current (titular hoy, defecto), former (lo fue) o all; acota las marcas de la cartera; las secciones de relaciones lo aplican como list_party_relations (sobre los dos puentes de cada arista: con former, un representante sustituido en una marca que la parte aún tiene cuenta) |
horizonDays |
los días hacia adelante en que se buscan los hitos: defecto 90, máximo 366 |
| campo | qué es |
|---|---|
party |
{ id, name, taxId, kind } |
trademarkCount, byStatus[], byClass[] |
cuántas marcas, y el recuento por estado publicado y por clase ({ key, label, count }) |
byRenewalStatus |
⭐ { groups, undatedCount, notApplicableCount }: las marcas por renewalStatus ({ key, label, count }, sólo los estados presentes), las que no tienen fecha de vencimiento y las que tienen fecha pero la regla no se les aplica (Madrid, o ni registrada ni esperando_renovacion). Las tres suman trademarkCount; es el mismo agregado que groupBy=renewalStatus |
upcomingMilestones |
from/to (hoy y hoy + horizonDays) y las marcas con un hito en ese rango, la más próxima primero, cada una con sus milestones[] completos. ⚠ La cartera lista las marcas por su vencimiento (expiry): una marca cuyo único hito en el horizonte es su opposition_close no entra aquí (sale en inOppositionWindow); hasta 50 + hasMore |
inOppositionWindow |
las marcas hoy en ventana de oposición — pertenencia; el cierre, en los milestones[] de cada una como opposition_close; hasta 50 + hasMore |
oppositionsReceived |
quién se opuso (las aristas opposed_by de las relaciones, hasta 20), unresolvedOpponentMentions (menciones que no casan con una sola parte: existen, no se nombran) y coverageFrom (hay oposiciones en el corpus sólo desde esa fecha) |
representatives |
sus representantes (aristas represented_by, hasta 20) |
relations[] |
una fila por tipo de relación con partyCount y trademarkCount |
dataAsOf, coverageThrough |
la frescura, en el cuerpo (y en cabeceras) |
⭐ Cada marca trae renewalStatus (not_due | window_open | grace | lapsed | renewed_expiry_pending, o null si la
regla no se aplica: sin fecha de vencimiento, ni registrada ni esperando_renovacion, o vía Madrid), evaluado en la fecha de la
respuesta (hora de Chile), y sus milestones[] los hitos de renovación renewal_window_open y
grace_end (Ley 19.039, art. 24; ninguno en renewed_expiry_pending) — la regla, en Hitos; byRenewalStatus los
cuenta con la misma regla y el mismo «hoy». Las fechas de renovación de toda la cartera en un rango
salen del calendario con holder o el lote. No hay veredictos ni fechas de cierre de oposición fuera de
milestones. Una parte inexistente es 404 not_found.
curl -sS "https://api.tarno.cl/reports/portfolio?partyId=920&horizonDays=180" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_portfolio_report", "arguments": { "partyId": "920", "horizonDays": 180 } }
Escrito para presentar una oposición
GET /reports/opposition-brief?applicationNumber=… — permiso reports:read o
reports:opposition-brief:read. MCP: get_opposition_brief.
Lo que necesitas para preparar una oposición contra una marca, en una llamada, como señales con su evidencia.
| parámetro | qué es |
|---|---|
applicationNumber |
obligatorio — la marca objetivo |
ownApplicationNumber |
opcional — tu marca; sin ella no hay señal de parecido |
limit |
tope de cada lista (titulares, aristas): defecto 10, máximo 20 |
| campo | qué es |
|---|---|
trademark |
la marca como la publica la colección (clases, estado, milestones[]), más publishedOn tal cual y currentHolders/currentRepresentatives por su id |
inOppositionWindow |
true si está hoy en su ventana de oposición — pertenencia; el cierre está en trademark.milestones como opposition_close |
similarity |
sólo con ownApplicationNumber: la posición del objetivo entre las 100 marcas más parecidas a la tuya en sus clases (rank, score, matchedBy, signals), o found: false. Sin tu marca, la clave no viaja (no se rellena) |
holders |
cada titular vigente del objetivo con oppositionsFiled (a quién se ha opuesto: aristas opposed) y oppositionsReceived (quién se le ha opuesto: aristas opposed_by, más unresolvedOpponentMentions), cada uno con partyCount, trademarkCount y las aristas más frecuentes |
citedNorms |
las normas citadas en los actos de oposición recibidos por las marcas vigentes de esos titulares, con recuento y hasta 5 números de evidencia (el objetivo primero) |
coverageFrom |
hay oposiciones en el corpus sólo desde esa fecha |
dataAsOf, coverageThrough |
la frescura, en el cuerpo (y en cabeceras) |
⛔ Ninguna fecha de cierre de oposición fuera de milestones (viaja en milestones como opposition_close, con su artículo), ningún
veredicto, ningún renewalStatus (un escrito no publica un estado que cambia cada día; las fechas de la
ventana de renovación sí viajan en milestones). Objetivo o marca propia inexistentes: 404 not_found; la misma
marca en los dos parámetros: 400.
curl -sS "https://api.tarno.cl/reports/opposition-brief?applicationNumber=1712345&ownApplicationNumber=1698765" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_opposition_brief", "arguments": { "applicationNumber": "1712345", "ownApplicationNumber": "1698765" } }
Escrito para responder a una oposición
GET /reports/opposition-response-brief?applicationNumber=… — permiso reports:read o
reports:opposition-response-brief:read. MCP: get_opposition_response_brief.
Lo que necesitas para responder a las oposiciones que ha recibido tu marca, en una llamada.
| parámetro | qué es |
|---|---|
applicationNumber |
obligatorio — la marca atacada |
limit |
tope de cada lista (oponentes, aristas, marcas): defecto 10, máximo 20 |
| campo | qué es |
|---|---|
trademark |
la misma ficha que en el escrito para presentar |
oppositionActs |
los actos de oposición sobre la marca, colapsados por hecho (versionsOfFact), del más antiguo al más reciente, hasta 50 + hasMore: fecha, section con sectionLabel en los tres idiomas, citedNorms del acto, opponents resueltos (por su id) y unresolvedOpponentMentions |
opponents |
cada oponente resuelto (los de más actos primero): actsOnTrademark, oppositionsFiled (sus aristas opposed) y trademarksInClasses — sus marcas vigentes en las clases de la marca atacada |
unresolvedOpponentMentions |
la suma de las menciones sin resolver |
coverageFrom, dataAsOf, coverageThrough |
como arriba |
⛔ Las marcas de un oponente se buscan por su persona_id, nunca por su nombre: por el nombre, «ACME»
arrastraría las de «ACME CHILE». ⛔ Una mención de oponente que no casa con una parte se cuenta y
no se nombra: su texto no aparece en la respuesta. Tampoco hay veredictos ni fechas de cierre fuera de
milestones. Marca inexistente: 404 not_found.
curl -sS "https://api.tarno.cl/reports/opposition-response-brief?applicationNumber=1712345" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_opposition_response_brief", "arguments": { "applicationNumber": "1712345" } }
Expediente de hechos de un escrito
GET /reports/filing-context?type=…&applicationNumber=… — permiso reports:read o
reports:filing-context:read. MCP: get_filing_context.
Los hechos que necesita un escrito sobre una marca, cada uno con su fuente, en una llamada. ⛔ El core da los hechos; la redacción es vuestra. No hay borrador, ni prosa jurídica, ni argumentos, ni un LLM: la redacción, las plantillas por organización y el documento final son del consumidor.
| parámetro | qué es |
|---|---|
type |
obligatorio — power_of_attorney (poder simple), opposition (oposición), opposition_response (contestación de una oposición), office_action_response (respuesta a observaciones de INAPI), withdrawal (desistimiento) |
applicationNumber |
obligatorio — la marca del escrito (la marca objetivo en una oposición; la marca que recibió la oposición u observación en una respuesta) |
annotationId |
el acto que se responde: obligatorio con office_action_response y opcional con opposition_response (un acto de oposición en vez de todos). Tiene que ser un acto de esa marca (si no, 404); con los demás tipos, 400 |
ownApplicationNumber |
sólo con opposition: tu marca, para añadir la comparación con la objetivo; con los demás tipos, 400 |
expand=legalTexts |
el texto de los artículos citados (ver abajo); exige además legal:read |
| tipo | qué hechos trae |
|---|---|
power_of_attorney |
la marca, sus clases, sus titulares vigentes y su representante vigente, cada uno con su identificador (RUT) |
opposition |
la marca objetivo (publicación, clases, estado, partes), si está hoy en su ventana de oposición (pertenencia), las oposiciones que ya recibió (cada acto con su fecha), el historial de oposiciones de sus titulares, las normas citadas en esos actos, las señales de normas de los actos de oposición que recibieron las marcas de sus titulares (normSignals) y, con tu marca, la comparación vía por vía (comparison, la de compare_trademarks) |
opposition_response |
los actos de oposición sobre la marca (o el que indicas), sus oponentes resueltos con su identificador, las menciones sin resolver contadas y las normas citadas |
office_action_response |
el acto (act.section, act.sectionName, act.date) y las normas que cita |
withdrawal |
la marca, su titular, su estado publicado y sus clases |
| campo | qué es |
|---|---|
trademark |
la ficha de la marca (con sus milestones, publishedOn tal cual y sus partes vigentes con taxId) |
facts[] |
{key, value, source} — source {kind, ref, date} dice de dónde sale el dato (trademark, party, annotation, opposition_brief, opposition_response_brief) y qué pedir para volver a leerlo (ref: el número de solicitud, el id de la parte o el de la anotación). ⛔ Un hecho sin valor se omite, no se rellena |
milestones |
los plazos del escrito con su norma y su artículo: el cierre de oposición (opposition) y la contestación del traslado (opposition_response) |
milestonesOmitted[] |
los plazos que no se dan, y por qué (kind, reason, section) |
citedNorms[] |
las normas citadas en los actos del escrito, cada una con su acto (source, section); citedNormsTruncated si hay más de 20 actos |
normSignals[] |
sólo en opposition: normas de los actos de oposición que recibieron las marcas de los titulares, con recuento y evidencia — señales, no causales |
comparison |
sólo en opposition con ownApplicationNumber: tu marca (A) frente a la objetivo (B); null si no. También null si una de las dos no tiene denominación comparable (una figurativa, sólo signos): el expediente llega igual, con un hecho comparison.omitted (valor no_comparable_denomination, source.ref = el número de esa marca) |
outline |
una estructura genérica (generic: true): las secciones header, parties, facts, grounds, requests y signature, y qué claves de hechos (o campos) llenan cada una. Sin texto y sin la marca de nadie |
coverageFrom, dataAsOf, coverageThrough |
desde cuándo hay oposiciones en el corpus y la frescura |
Los plazos: sólo con su artículo. El expediente publica dos plazos, los MISMOS hitos que publica la
marca. En opposition, el cierre de oposición (opposition_close): 30 días hábiles desde la
publicación del extracto, con su base legal en el campo (Ley 19.039 art. 5 y art. 11; Ley 19.880 art. 25).
Sin fecha de publicación no hay ancla: se omite con no_publication_date.
⭐ En opposition_response, la contestación del traslado (opposition_response_close, desde el
2026-10-10): el 30.º día hábil posterior a la notificación del traslado, improrrogable (Ley 19.039 art. 9
y art. 11; Ley 19.880 art. 25; Decreto 82/2022 art. 24). No contestar no es abandono: vencido el
plazo el procedimiento sigue. El anchor trae el acto del que sale la fecha (annotationId,
sectionCode), que además viaja como hecho opposition.transfer. Es derived cuando el corpus tiene
la notificación del Estado Diario (C1) y la resolución de traslado el mismo día, y estimated —
decidlo así— cuando falta una de las dos (estimateReasons). Por ejemplo, el traslado del expediente
1605530, notificado el 2025-05-22, da el 2025-07-04, la misma fecha que INAPI anotó como «Fin de
plazo». Cuando no se da, milestonesOmitted dice por qué: no_transfer_on_record (el corpus aún no
tiene el traslado: llega semanas después de la oposición), madrid_designation (INAPI fija otro plazo a
una designación de Madrid), prior_legal_regime (traslado anterior al 2022-05-09, notificado por carta
certificada), anchor_on_non_business_day u outside_holiday_calendar. Es «no lo sabemos», nunca «no
hay plazo».
Los plazos que no tienen artículo no se dan: la respuesta a una observación de escrito
(office_action_response_term, con su section: 661B, 813B, 931, 925) se lista en
milestonesOmitted con reason: "no_legal_basis_in_knowledge_base" — los fija cada resolución y son
prorrogables. ⛔ No calculéis ni mostréis una fecha para ellos como si fuera un plazo del core.
expand=legalTexts añade a cada citedNorms[] el texto literal del artículo/letra que regía en la
fecha del acto (text, textStatus) y los documentos de INAPI que lo citan (guidance, señales con
recuento): la misma cita explicada de get_annotation?expand=citations. Exige
además legal:read: sin él, 403 forbidden que nombra legal:read, sin consumir cuota. Sin expand,
esas tres claves no están.
Las observaciones de terceros no son un tipo de escrito. Se comprobó en el repositorio de conocimiento de
INAPI y no las registra como un escrito distinto de la oposición — allí, las «observaciones» son
resoluciones de INAPI sobre un escrito (661B, 813B…), que ya cubre office_action_response. Pedir
type=third_party_observations es un 400. Si el repositorio llega a registrarlas con su norma, serán un
sexto tipo.
Permiso propio: ni una clave sin restricción, ni la clave de prueba, ni los permisos de los escritos de
oposición (reports:opposition-brief:read, reports:opposition-response-brief:read) lo reciben. Sin él,
403 forbidden que nombra reports:filing-context:read, sin consumir cuota. Marca inexistente: 404.
curl -sS "https://api.tarno.cl/reports/filing-context?type=opposition&applicationNumber=1712345&ownApplicationNumber=1698765" \
-H "X-API-Key: $TARNO_API_KEY"
{ "name": "get_filing_context", "arguments": { "type": "office_action_response", "applicationNumber": "1712345", "annotationId": "84213", "expand": ["legalTexts"] } }
Scopes
Las cuatro lecturas requieren el scope brands:read. Un arreglo de scopes vacío no tiene restricción
para ellas (misma regla que en el resto del contrato).
Los informes tienen permiso propio: reports:read concede todos, y reports:<informe>:read uno
(reports:daily-bulletin:read, reports:clearance:read, reports:portfolio:read,
reports:opposition-brief:read, reports:opposition-response-brief:read,
reports:conflict-landscape:read, reports:registration-signals:read, reports:filing-context:read). ⛔ Se conceden explícitamente: una clave
con scopes vacíos no los recibe, ni la clave de prueba. Sin el permiso, 403 forbidden. Cada llamada
a un informe cuenta una unidad de cuota. Consulta la guía de autenticación.
MCP
REST es equivalente a MCP: misma clave, mismos scopes, mismos esquemas.
| Herramienta MCP | Equivalente REST |
|---|---|
get_trademark (con expand) |
GET /trademarks/{applicationNumber}?expand=… |
list_trademark_annotations (family=opposition) |
GET /trademarks/{applicationNumber}/annotations?family=opposition |
search_trademarks (oppositionWindow) |
POST /trademarks/search |
get_renewal_calendar |
POST /trademarks/renewal-calendar (sin portfolio, también GET) |
get_daily_bulletin |
GET /reports/daily-bulletin |
get_clearance_report |
GET /reports/clearance |
get_conflict_landscape |
GET /reports/conflict-landscape |
get_registration_signals |
GET /reports/registration-signals |
get_portfolio_report |
GET /reports/portfolio |
get_opposition_brief |
GET /reports/opposition-brief |
get_opposition_response_brief |
GET /reports/opposition-response-brief |
get_filing_context |
GET /reports/filing-context |
Errores
Todos los errores usan el cuerpo RFC 9457 descrito en primeros pasos.
| HTTP | code |
Cuándo |
|---|---|---|
| 401 | unauthorized |
Clave ausente, malformada, desconocida o revocada. |
| 403 | forbidden |
Falta el scope brands:read, o el permiso del informe (reports:read o el suyo), o legal:read con expand=legalTexts. |
| 404 | not_found |
Marca inexistente (también el objetivo o la marca propia de un escrito), o parte inexistente en la cartera; en el expediente, un annotationId que no es un acto de esa marca. |
| 400 | invalid_rut / invalid_range |
taxId sin forma de RUT, o un rango con From > To — también con similitud y ventana de oposición. |
| 400 | validation_error |
Faltan parámetros requeridos, un parámetro desconocido, similarTo con similarToTrademark, la ventana de oposición combinada con la similitud, o un calendario de renovación sin from/to o de más de 366 días. |
| 422 | out_of_coverage |
Boletín de un día sin boletín ingerido, o ventana de oposición con un calendario de feriados que no cubre de hoy − 90 a hoy + 60 días (lleva coverage). |
Ver también
- Autenticación y scopes —
X-API-Key,brands:read. - Conecta tu agente de IA (MCP) — las mismas lecturas vía MCP.
- Primeros pasos — sobre, paginación por keyset, cuerpo de error.
- La referencia OpenAPI en vivo en
https://api.tarno.cl/docs.