Saltar a contenido

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=opposition sobre 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 su id, 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. niceClass es obligatoria (una o varias clases) y hay que enviar exactamente uno de q o applicationNumber (un solo número: es la marca contra la que se ordena, no un lote). ⛔ La ventana no se combina con similarTo/similarToTrademark — ya ordena por parecido al portafolio —: esa combinación es 400 validation_error. Para «marcas parecidas a X» sin ventana, usa similarTo (texto libre) o similarToTrademark (una marca existente), nunca los dos a la vez.

oppositionWindow admite sólo "open": closed y any no existen y son 400 validation_error. Un applicationNumber de cartera que no está en el corpus (o que ni tiene forma de número) es 404 not_found, nunca un 200 vací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&section=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 su nullReason: 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. weightsApplied dice 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