Relatórios e oposições
Este guia cobre as leituras focadas em registrabilidade e oposições do contrato do Tarno e os
relatórios de uma chamada (/reports/*). As quatro leituras usam o escopo brands:read; os relatórios
levam permissão própria (veja Escopos). Tudo tem gêmeo MCP.
O schema completo, sempre atualizado e por campo, vive na referência OpenAPI interativa em
https://api.tarno.cl/docs(Scalar). Este guia explica como pedir essas leituras e aponta para essa referência — não reformula o schema. A referência é autoritativa para a lista de campos.
Ao longo do guia a URL base é https://api.tarno.cl e cada chamada leva o cabeçalho X-API-Key.
O que este guia cobre
Quatro leituras, todas sem prefixo de versão e com escopo brands:read:
- Relatório de registrabilidade — não é mais uma rota: é o detalhe da marca com
expand=parties,annotations,encumbrances,classes,norms. Um objeto com uma única semântica de nulo. - Linha do tempo de oposições — não é mais uma rota: é o filtro
family=oppositionsobre as anotações de uma marca. - Oposições abertas — não é mais uma rota: é a busca com
oppositionWindow: "open". - Calendário de renovação —
GET /trademarks/renewal-calendar≡get_renewal_calendar: as datas de renovação (art. 24) de um lote ou de um filtro em um intervalo de até 366 dias (detalhe).
E os relatórios de uma chamada (os mais recentes têm sua seção mais abaixo), com permissão própria (reports:read ou a do relatório):
- Boletim do dia —
GET /reports/daily-bulletin≡get_daily_bulletin: o que o Estado Diario publicou em uma data, por seção e com partes. - Disponibilidade —
GET /reports/clearance≡get_clearance_report: o que se parece com um nome em uma ou várias classes, como sinais (nunca «registrável»). - Carteira de uma parte —
GET /reports/portfolio≡get_portfolio_report: as marcas de uma parte (pelo seuid, nunca pelo nome) com as contagens, marcos próximos, janelas de oposição, oposições recebidas, representantes e relações. - Peça para apresentar uma oposição —
GET /reports/opposition-brief≡get_opposition_brief: a marca alvo, se está hoje na janela, sua semelhança com a sua marca e o histórico de oposições dos seus titulares. - Peça para responder a uma oposição —
GET /reports/opposition-response-brief≡get_opposition_response_brief: os atos de oposição sobre a sua marca, quem se opõe, com quais normas e com qual histórico. - Dossiê de fatos de uma peça —
GET /reports/filing-context≡get_filing_context: os fatos de uma procuração, uma oposição, uma contestação, uma resposta a observações ou uma desistência, cada um com sua fonte, sem redação (detalhe).
⛔ Todos dão sinais, nunca veredictos: nenhum diz se uma marca é registrável, se uma oposição vai prosperar ou se há risco — a decisão jurídica é do leitor.
Essas leituras são somente leitura e honestas por desenho: nunca fabricam datas nem prazos que o corpus não sustenta.
Relatório de registrabilidade
GET /trademarks/{applicationNumber}?expand=parties,annotations,encumbrances,classes,norms — escopo
brands:read (e também legal:read se expand incluir norms). MCP: get_trademark com expand.
O relatório é o detalhe da marca com as seções expandidas: parties, annotations,
encumbrances, classes e norms. Um objeto com uma única semântica de nulo — o defeito de duas rotas
(detalhe e relatório) com a mesma forma e duas semânticas fica fechado.
⚠ null NÃO é [], e a diferença é todo o mecanismo:
| valor | significa |
|---|---|
[] |
eu perguntei, e esta marca não tem nenhuma |
null |
eu não perguntei (não veio em expand=) |
Os gravames (encumbrances)
encumbrances[] traz uma entrada por ônus sobre a marca —penhor, medida cautelar, penhora ou proibição—
com a inscrição emparelhada ao levantamento que a encerrou. As ativas primeiro.
state |
significa |
|---|---|
active |
inscrita e sem levantamento inscrito que a encerre |
released |
um levantamento inscrito a encerrou (recordedOn: null se a inscrição é anterior ao corpus) |
filed |
apresentado, sem resolução que o encerre (hoje, apresentações de 2024–2026 em trâmite) |
rejected |
o INAPI o rejeitou (537); nunca vigorou |
abandoned |
abandonado sem inscrição (falta de pagamento, observações não cumpridas ou desistência); nunca vigorou |
Um ônus só vigora quando o INAPI o inscreve: a anotação A0xI é a apresentação, e o que o faz vigorar
é a resolução de inscrição (1104, 638, ou sua publicação no Estado Diario). Um levantamento (A0xA) só
levanta quando inscrito (639). filed, rejected e abandoned não são gravames vigentes nem devem
disparar alertas; trazem filedOn (data de apresentação) e recordedOn: null.
Os ônus de 2007–2011 (registrationSection W340, W360 ou W370) trazem sempre filedOn, a data de
apresentação; recordedOn é a da inscrição. Num ônus moderno vigente ou levantado, filedOn é null e
recordedOn é a data do seu A0xI. ⚠ Com releaseObservable: false um ônus active pode
ter sido levantado: a marca tem, depois da inscrição, um levantamento que o corpus não consegue atribuir a
um ônus concreto (o processo do INAPI cita o nº da anotação; o corpus não o guarda). Esses levantamentos
aparecem à parte como released com recordedOn: null.
recordedOnBasis diz que data é recordedOn: "filing" num ônus moderno (a data de apresentação
do seu A0xI; a inscrição é uma resolução posterior que não se publica como data), "recordal" num de
2007–2011 (a sua inscrição), null quando recordedOn é null. Não escreva «inscrito em…» sobre uma data
"filing".
⚠ Com releaseAttributionCertain: false, que ônus um levantamento levantou é uma atribuição, não um
dado: o levantamento chegou com dois ou mais ônus do seu tipo vigentes e foi emparelhado com o mais antigo.
Levam-no todos os vigentes nesse momento; o que sai released pode continuar vigente e um active pode ser
o levantado. Quantos levantamentos houve é certo; a que ônus corresponde cada um, não.
releaseStatusCertain responde a outra pergunta: se o estado (active / released) é certo mesmo
que o emparelhamento não o seja. É true quando a atribuição já é certa, quando todos os ônus do tipo da marca estão levantados (cada um
está, com certeza; só o seu releasedOn é uma atribuição) ou quando o levantamento só pôde levantar um ônus,
porque o outro foi apresentado nesse mesmo dia. É false sempre que releaseObservable for false. Para
dizer «continua vigente» ou «foi levantado», use releaseStatusCertain; para dizer «levantado em …», também
releaseAttributionCertain. Onde o histórico traz o número de anotação
do INAPI, dois ônus idênticos do mesmo dia são duas entradas, e quando o INAPI diz que ônus um
levantamento levanta o emparelhamento é certo. Limite: numa marca cujo histórico ainda não traz números,
dois ônus idênticos do mesmo tipo apresentados no mesmo dia podem aparecer como um, e então o estado pode
estar errado.
Onde as resoluções do INAPI trazem o número de anotação, cada apresentação é resolvida pelo seu
número: um levantamento apresentado duas vezes no mesmo dia cuja duplicata foi desistida ou rejeitada conta
uma só vez, e um ônus rejeitado ou abandonado pelo seu número não é publicado como vigente mesmo que outro
do mesmo dia tenha sido inscrito. Se a resolução de inscrição de um levantamento (639) nomeia um ônus que
não está vigente na marca, esse levantamento nunca toma um ônus que outro 639 nomeia, e o que fechar por
antiguidade, e os demais ônus que podia tomar, sai com releaseAttributionCertain: false e, salvo se todos os ônus do tipo estiverem
levantados, releaseStatusCertain: false.
Cada entrada traz também annotationNumber, o número de anotação do INAPI do ônus (o que se cita),
e releaseAnnotationNumber, o do levantamento que o levantou; null quando não se conhece.
As normas citadas no processo (norms)
norms[] traz uma entrada por (tipo, norma, artigo, letra, inciso) citada nas anotações da marca:
normKind, legalNormId (null quando o ato cita um artigo sem nomear a lei — incluída mesmo assim),
citedNorm, name, article, letter, subsection, annotationCount, firstCitedOn, lastCitedOn e
até 20 annotationIds (as mais recentes). As mais citadas primeiro, no máximo 100 (normsTruncated). Com
dedupe=true (o padrão) conta fatos, e os ids são os de annotations[]. Não traz o texto da lei:
para lê-lo, GET /annotations/{id}?expand=citations com um dos annotationIds.
⚠ norms exige o escopo legal:read além de brands:read, como expand=citations: sem ele a
requisição inteira responde 403 forbidden nomeando legal:read, sem consumir cota. Uma chave sem
legal:read pede 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 com as seções pedidas
console.log(trademark.status, trademark.statusInapi, trademark.classes); // status = derivado (D11)
O ato de cada anotação (annotations[]): além de section, cada anotação traz act —o código
do INAPI do ato concreto que ela nomeia (p. ex. «Fondo-Res. Favorable Escrito» sob M11 é
664B)— com actName/actLabel, e actStatus, que viaja sempre e diz o que significa um act
nulo: not_applicable (a seção já é o ato), unidentified (nomeia um ato que não pôde ser
identificado: «não sabemos», nunca um código plausível) ou identified.
Para a lista completa de campos da marca (e de cada seção expandida), veja a referência
https://api.tarno.cl/docs — não é duplicada aqui. A atualidade viaja em cabeçalhos (Iris-Data-As-Of,
Iris-Coverage-Through) e ETag + If-None-Match → 304.
Linha do tempo de oposições de uma marca
GET /trademarks/{applicationNumber}/annotations?family=opposition — escopo brands:read. MCP:
list_trademark_annotations com family: "opposition".
A linha do tempo de oposição é o filtro family=opposition sobre as anotações de uma marca: uma coleção
cronológica dos atos de oposição, com o envelope comum { results[], limit, next, hasMore, total, meta }.
curl -sS "https://api.tarno.cl/trademarks/123456/annotations?family=opposition" \
-H "X-API-Key: $TARNO_API_KEY"
A janela de oposição (publicação + 30 dias úteis) vive no objeto marca (oppositionWindow), não nesta
coleção. null significa que a marca não tem data de publicação, então não há janela a computar — nunca
fabricada sem sua data de origem.
As datas com nome da marca viajam em milestones[] (no objeto marca e em cada marca de uma
coleção); a lista de tipos, o que cada um publica e quando é uma estimativa, está em
Marcos. O fechamento desta janela viaja ali como opposition_close, com seu
base legal (Ley 19.039 arts. 5 e 11, Ley 19.880 art. 25) —derived, ou estimated e marcado quando não
pode ser afirmado—, e oppositionWindow leva a mesma legalBasis.
Oposições abertas em uma classe
POST /trademarks/search com oppositionWindow: "open" — escopo brands:read. MCP: search_trademarks.
Lista marcas com janela de oposição aberta, ranqueadas por similaridade a um portfólio. O caso de uso:
vigiar ameaças de registro na sua classe. O portfólio contra o qual se ordena é q (texto livre)
ou applicationNumber (UMA marca sua existente), e a classe é obrigatória:
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"}'
As regras da janela.
niceClassé obrigatória (uma ou várias classes) e é preciso enviar exatamente um deqouapplicationNumber(um só número: é a marca contra a qual se ordena, não um lote). ⛔ A janela não se combina comsimilarTo/similarToTrademark— ela já ordena por semelhança ao portfólio —: essa combinação é400 validation_error. Para «marcas parecidas com X» sem janela, usesimilarTo(texto livre) ousimilarToTrademark(uma marca existente), nunca os dois.
oppositionWindowaceita apenas"open":closedeanynão existem e são400 validation_error. UmapplicationNumberde carteira que não está no corpus (ou que nem tem forma de número) é404 not_found, nunca um200vazio: «nenhuma parecida na janela» só se diz sobre uma marca que existe.
Qual marca está «na janela». A que (1) tem data de publicação (publishedOn, a publicação no Diario
Oficial), (2) cujo 30.º dia útil após a publicação é hoje ou depois — dias do Chile, contados com o
calendário de feriados — e (3) cujo status não é terminal (rechazada, denegada,
desistida, abandonada, anulada, caducado, vencida; a lista de liveOnly) e (4) cujo status
tampouco é registrada nem concedida — uma marca registrada ou concedida já não admite oposição
(liveOnly, ao contrário, a conserva: está viva). Usa o mesmo prazo
que o objeto marca publica em oppositionWindow, com a mesma aritmética: não um prazo à parte. Mas
oppositionWindow publica o prazo sem olhar o estado: uma marca registrada/concedida pode trazer
expired: false e não estar na janela — não deduzam o pertencimento de !expired. Na prática
são marcas en_tramite — o INAPI nunca emite o estado publicada. Se o calendário não cobre de hoje − 90 a hoje + 60
dias, a resposta é 422 out_of_coverage, nunca uma lista calculada com feriados faltando. A mesma
regra dá o «na janela» da disponibilidade e da carteira (inOppositionWindow).
Os demais filtros são aplicados (não são mais ignorados em silêncio): status, signType,
holder/representative/taxId (com relation), os quatro pares de datas (filedFrom/To,
registeredFrom/To, expiresFrom/To, publishedFrom/To), registrationNumber, liveOnly e
várias classes (niceClass como lista). A janela de oposição também aceita várias classes. Todos
entram dentro de cada canal de semelhança, não como filtro posterior (salvo nos canais léxicos com
liveOnly, status=caducado, vencimento, marcos ou renewalStatus, onde se aplicam depois de pontuar: mesmo
resultado e mesma ordem).
sort só aceita relevance: o resultado ordena por semelhança, e ordenar por data ou denominação
o destruiria. denomination e facets não se combinam com a semelhança nem com a oposição. Qualquer
dessas combinações é um 400 validation_error.
E os mesmos erros da coleção: um taxId sem forma de RUT é 400 invalid_rut, e um intervalo com
From > To (filedFrom/To, expiresFrom/To, registeredFrom/To, publishedFrom/To, milestoneFrom/To)
é 400 invalid_range — com a mesma mensagem. Nunca um 200 com a lista vazia.
liveOnly=true exclui as marcas em um dos sete status terminais (rechazada, denegada, desistida, abandonada, anulada, caducado, vencida); uma marca
sem status conhecido é mantida.
A resposta é o envelope comum { results[], limit, next, hasMore, total, meta }, paginado por keyset.
Calendário de renovação
GET /trademarks/renewal-calendar?from=…&to=… — escopo brands:read. MCP: get_renewal_calendar.
As datas de renovação de um conjunto de marcas em uma chamada: uma linha por (marca, marco) cuja
data cai no intervalo, ordenadas por data e número. Os marcos são os dois da janela de renovação do art. 24
da Ley 19.039 —renewal_window_open (vencimento − 6 meses) e grace_end (vencimento + 6 meses, deslocado ao primeiro dia útil quando não é útil)— e cada
linha é o marco tal como a marca o publica em seus milestones[] (mesma data, âncora, regra e
legalBasis), mais seu applicationNumber.
| parâmetro | o que é |
|---|---|
from / to |
obrigatórios (YYYY-MM-DD, inclusivos); no máximo 366 dias contando os dois extremos. Mais é 400 validation_error; from > to é 400 invalid_range |
| filtros de marca | os de GET /trademarks: o lote (applicationNumber, até 100), renewalStatus, holder, niceClass, status, datas… denomination restringe por substring. q, a similaridade, a janela de oposição, facets e os filtros de norma são 400 |
limit / cursor |
a paginação de sempre (padrão 20, máximo 100); total é exato. O cursor só vale com o mesmo filtro (intervalo incluído; limit pode mudar): com outro, 400 validation_error sobre cursor |
Uma marca do regime anterior a 2022-05-09, via Madri, sem data de vencimento ou que não está registrada
nem esperando_renovacion não publica esses marcos e não contribui linhas; tampouco uma em
renewalStatus: renewed_expiry_pending (a renovação já foi concedida e o vencimento publicado ainda não
foi atualizado, antes ou depois desse vencimento). O calendário publica
datas; a quem avisar e quando é decisão do consumidor.
# «As datas de renovação da minha lista este ano» — o lote de até 100, em uma chamada.
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" } }
A carteira como objeto: POST /trademarks/renewal-calendar. A mesma resposta pelo corpo JSON, mais o
objeto portfolio (party, refine, includeApplicationNumber, excludeApplicationNumber), o mesmo de
POST /trademarks/search e POST /trademarks/application-numbers: conjunto =
(((partes ∩ refine) ∪ incluídas) − excluídas) ∩ filtros de primeiro nível. refine restringe só as marcas
das partes, então uma marca adicionada à mão está no calendário mesmo sem cumprir refine, e uma
excluída à mão nunca está. Até 10.000 números por lista. Com portfolio, party,
includeApplicationNumber ou excludeApplicationNumber de primeiro nível são 400 validation_error. O
cursor fica preso ao filtro inteiro, portfolio incluído. get_renewal_calendar aceita o mesmo
portfolio; a GET continua 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"] } }'
Boletim do dia
GET /reports/daily-bulletin?date=YYYY-MM-DD — permissão reports:read ou reports:daily-bulletin:read.
MCP: get_daily_bulletin.
O que o Estado Diario publicou em uma data, em uma chamada: cada ato do dia na forma publicada da
anotação (partes incluídas), no envelope comum paginado (limit ≤ 100, cursor), com total
exato. Em meta:
| campo | o que é |
|---|---|
meta.date |
a data pedida |
meta.sections[] |
o índice do dia inteiro: { code, label, count } por seção, label em es-CL/en/pt-BR — não muda ao filtrar por section |
meta.bulletins[] |
os boletins ingeridos naquele dia (tipo2, altas) com os atos que a ingestão registrou |
meta.coverageThrough |
⭐ o último boletim do Estado Diario ingerido: o mesmo valor que coverage.through do 422 out_of_coverage (não a data de apresentação do corpus, usada pelas demais rotas) |
section (lista, ?section=M5,OPO08 ou repetida) restringe as linhas. As linhas não se colapsam por
evento: o boletim é o que foi publicado; versionsOfFact continua dizendo se o fato tem outras versões.
Cada linha traz também act e actStatus, como no relatório: sob o cabeçalho de subseção que o
boletim imprime («Fondo-Res. Favorable Escrito» em M11) act traz o código do INAPI desse ato
(664B); actStatus diz se está identified, se o boletim nomeia um ato que não pôde ser identificado
(unidentified) ou se a seção já é o ato (not_applicable).
⛔ Um dia sem boletim ingerido é 422 out_of_coverage, com coverage: { from, through } no corpo do
erro — nunca uma lista vazia: «não aconteceu nada» e «não lemos» são respostas diferentes. Fins de
semana e feriados também não têm boletim; GET /system/coverage distingue o feriado da lacuna.
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 } }
Disponibilidade (sinais, não veredictos)
GET /reports/clearance?text=…&niceClass=… — permissão reports:read ou reports:clearance:read. MCP:
get_clearance_report.
O que se parece com um nome em uma ou várias classes (niceClass, de 1 a 10, obrigatória), em uma
chamada, como um conjunto de sinais com sua fonte. ⛔ Não diz se o nome é registrável, disponível,
arriscado nem se infringe: isso é uma opinião jurídica, e é do leitor. Nenhum relatório publica um campo
assim (um teste do contrato o impede).
| campo | o que é |
|---|---|
similar[] |
as marcas confundíveis por canal do motor de semelhança: phonetic, fuzzy (léxico; omitido quando o seu canal falhou neste relatório), semantic (omitido quando não foi avaliado ou não contribuiu nada — nunca vazio) e distinctive (o elemento distintivo, sem os termos genéricos; só quando o canal rodou), até 20 por canal, cada uma com score/signals e inOppositionWindow |
genericTerms, distinctiveCore, decompounded |
só quando o canal distinctive rodou: quais termos foram tratados como genéricos e por quê, o que se buscou e quais palavras coladas foram separadas |
dominantHolders[] |
os 10 titulares com mais marcas nessas classes ({ key: partyId, label, count }, qualquer estado) |
citedNorms[] |
as normas/artigos citados nas anotações das confundíveis, com trademarkCount, annotationCount e até 5 números de evidence (as mais parecidas primeiro) |
dataAsOf, coverageThrough |
o frescor, no corpo (e nos cabeçalhos) |
inOppositionWindow é pertencimento (a marca está hoje dentro dos seus 30 dias úteis de oposição);
a data de fechamento viaja nos milestones[] da marca como opposition_close, com seu artigo. Uma norma citada é um sinal do que
foi invocado em torno de marcas parecidas, não uma causa aplicada ao seu nome.
O grupo distinctive («Semelhança no elemento distintivo»). Quando o texto leva termos genéricos nas
classes pedidas («ALTODESEMPEÑO CONSULTORES» na 35), o relatório acrescenta um grupo com o que se parece com
o que resta: nesse caso encontra «MAS DESEMPEÑO», que os outros três canais não viam. Como se decide o que é
genérico e quanto pesa o canal está em Busca. Sem nada a descontar, ou se o que
resta tem menos de 3 letras, não há grupo e as três chaves não viajam: o relatório é o de antes. Latência: com termos genéricos, o relatório demora cerca de 0,7 s
a mais (medido em 2026-09-28). ⛔ Um termo ser genérico não é um 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 conflito
GET /reports/conflict-landscape?text=…&niceClass=… — permissão reports:read ou
reports:conflict-landscape:read. MCP: get_conflict_landscape.
«Quem representa, e quem é titular das, marcas parecidas com a minha?», numa chamada. Parte do
mesmo motor e dos mesmos canais da disponibilidade (fonético, léxico, semântico e do
elemento distintivo): as 60 marcas mais parecidas com o texto nas classes (niceClass, 1 a 10,
obrigatória). Delas ficam as vivas: as de status terminal são contadas e deixadas de fora. Depois
agrupam-se pelas partes com relação vigente.
| campo | o que é |
|---|---|
representatives[], holders[] |
até 20 partes por lado (primeiro as que têm mais parecidas) |
└ party |
{ id, name } — o id de /parties |
└ similarTrademarks |
quantas das parecidas vivas a parte tem, com relação vigente |
└ evidence[] |
até 5 dessas marcas (as mais parecidas primeiro), com applicationNumber, denomination e matchedBy; evidenceTruncated se houver mais |
└ totalTrademarksInClass[] |
para cada classe pedida, todas as marcas da parte nesse lado (qualquer status): o tamanho contra o qual se lê similarTrademarks |
partiesTotal |
quantas partes havia em cada lista antes do corte em 20 |
method |
o limiar (similarLimit = 60), quantas o motor devolveu, quantas vivas e quantas terminais ficaram de fora, os status terminais e relation: current, com a descrição em três idiomas |
genericTerms, distinctiveCore, decompounded |
o desconto do motor, só se o canal distinctive correu (como na disponibilidade) |
dataAsOf, coverageThrough |
a atualidade |
⛔ São sinais do corpus. Não dizem nada sobre uma parte, um conflito nem a registrabilidade do nome.
Um representante com muitas marcas parecidas numa classe pode apenas ser grande: por isso viaja
totalTrademarksInClass.
Permissão própria: constrói-se sobre a disponibilidade, que é um relatório vendido, por isso tem a sua
própria permissão. Nem reports:clearance:read nem uma chave sem restrição a recebem. Sem ela,
403 forbidden que nomeia reports:conflict-landscape:read, sem consumir cota.
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 (sinais, não um veredito)
GET /reports/registration-signals?text=…&niceClass=… — permissão reports:read ou
reports:registration-signals:read. MCP: get_registration_signals.
«Que sinais de conflito tem este nome nestas classes, e de onde sai cada um?», em uma chamada. Não é
um «risco» com nível: é um desdobramento de sinais, cada um com o seu valor, o seu n, a sua
evidência e a sua fonte, e um signalIndex de 0 a 100 cuja fórmula viaja na resposta. niceClass é
obrigatória, de 1 a 3 classes (o relatório faz uma disponibilidade e as estatísticas de cada classe;
com 4 ⇒ 400).
Por classe (perClass[]), seis sinais:
| sinal | o que mede | de onde sai | como se normaliza |
|---|---|---|---|
| S1 | a semelhança máxima com uma marca viva da classe | a disponibilidade (uma chamada, todas as classes): o score das parecidas vivas |
max(score); 0 se não houver nenhuma |
| S2 | quantas marcas vivas são muito parecidas | a disponibilidade: as de score ≥ 0,8 |
min(1, log10(1+n)/log10(21)): chega a 1 com 20 |
| S3 | a proporção de indeferidas entre as decididas da classe | get_class_stats, período padrão |
refusedShare = indeferidas / decididas |
| S4 | a proporção com objeção de fundo na classe | get_class_stats |
actsShare.substantiveObjection.share |
| S5 | a proporção das parecidas vivas com um ato de oposição | as anotações da família oposicion dessas marcas |
com ato / parecidas vivas, com a sua coverageNote |
| S6 | as parecidas vivas hoje em janela de oposição | a disponibilidade (inOppositionWindow) |
nenhuma: uma contagem, fora do índice |
Cada sinal traz id, name (três idiomas), value, n, inIndex, weight, nullReason, source,
normalization e evidence (até 5 marcas na ordem de semelhança, ou o quociente com o seu período e o seu
dataAsOf). Vivas são as de status publicado fora dos terminais (method.terminalStatuses), o mesmo
critério do panorama de conflito.
A fórmula (campo formula, literal, e weights):
signalIndex = round(100 × (0.35·S1 + 0.20·S2 + 0.20·S3 + 0.15·S4 + 0.10·S5))
- Um sinal nulo (
value: null, com o seunullReason:class_stats_pending,no_decided_in_period,no_population_in_period,no_live_similar) fica fora e o seu peso é repartido entre os demais na proporção dos seus pesos.weightsApplieddiz os pesos aplicados (arredondados a 4 casas), e o índice se reproduz exatamente com eles:round(100 × Σ weightsApplied·value). - Os pesos são provisórios (
method.weightsProvisional: true): aprovados pela equipe do Tarno para revisão, não saem de uma calibração. São revistos com o uso. indexLabel: «Índice orientativo: não é um veredito», nos três idiomas. Cite-o com o índice.
⛔ O que NÃO é. Não diz se um nome pode ser registrado, nem se infringe, nem um nível (baixo, médio, alto), nem uma recomendação de depositar ou não. São sinais do corpus com a sua fonte; a decisão jurídica é de quem lê. Mostre os sinais, não só o número.
Antes do primeiro cálculo das estatísticas de classe (logo após um deploy), S3 e S4 saem nulos com
class_stats_pending e o seu peso é repartido: o índice é calculado com S1, S2 e S5, e diz isso.
Permissão própria: é construído sobre a disponibilidade, que é um relatório vendido. Nem
reports:clearance:read nem uma chave sem restrição o recebem. Sem ela, 403 forbidden que nomeia
reports:registration-signals:read, sem consumir cota. Latência: a da disponibilidade (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] } }
Carteira de uma parte
GET /reports/portfolio?partyId=… — permissão reports:read ou reports:portfolio:read. MCP:
get_portfolio_report.
A carteira de uma parte em uma chamada. ⛔ É construída pela identidade da parte (partyId: o
id de GET /parties/{id} / get_party, ou o partyId de uma anotação), nunca pelo nome: holder
é uma substring, e a carteira de «ACME» pelo nome traria as marcas de «ACME CHILE».
| parâmetro | o que é |
|---|---|
partyId |
obrigatório — o id da parte |
relation |
current (titular hoje, padrão), former (foi) ou all; delimita as marcas da carteira; as seções de relações o aplicam como list_party_relations (sobre as duas pontes de cada aresta: com former, um representante substituído numa marca que a parte ainda tem conta) |
horizonDays |
quantos dias à frente procurar marcos: padrão 90, máximo 366 |
| campo | o que é |
|---|---|
party |
{ id, name, taxId, kind } |
trademarkCount, byStatus[], byClass[] |
quantas marcas, e a contagem por status publicado e por classe ({ key, label, count }) |
byRenewalStatus |
⭐ { groups, undatedCount, notApplicableCount }: as marcas por renewalStatus ({ key, label, count }, só os status presentes), as sem data de vencimento e as com data às quais a regra não se aplica (Madri, ou nem registrada nem esperando_renovacion). As três somam trademarkCount; é o mesmo agregado que groupBy=renewalStatus |
upcomingMilestones |
from/to (hoje e hoje + horizonDays) e as marcas com um marco nesse intervalo, a mais próxima primeiro, cada uma com seus milestones[] completos. ⚠ A carteira lista as marcas pelo vencimento (expiry): uma marca cujo único marco no horizonte é o seu opposition_close não entra aqui (aparece em inOppositionWindow); até 50 + hasMore |
inOppositionWindow |
as marcas hoje na janela de oposição — pertinência; o fechamento, nos milestones[] de cada uma como opposition_close; até 50 + hasMore |
oppositionsReceived |
quem se opôs (as arestas opposed_by das relações, até 20), unresolvedOpponentMentions (menções que não casam com uma única parte: existem, não são nomeadas) e coverageFrom (há oposições no corpus só desde essa data) |
representatives |
seus representantes (arestas represented_by, até 20) |
relations[] |
uma linha por tipo de relação com partyCount e trademarkCount |
dataAsOf, coverageThrough |
o frescor, no corpo (e nos cabeçalhos) |
⭐ Cada marca traz renewalStatus (not_due | window_open | grace | lapsed | renewed_expiry_pending, ou null quando a
regra não se aplica: sem data de vencimento, nem registrada nem esperando_renovacion, ou via Madri), avaliado na data da resposta
(hora do Chile), e seus milestones[] trazem os marcos de renovação renewal_window_open e grace_end
(Ley 19.039, art. 24; nenhum em renewed_expiry_pending) — a regra, em Marcos; byRenewalStatus as conta com a mesma
regra e o mesmo «hoje». As datas de renovação de toda a carteira em um intervalo saem do
calendário com holder ou o lote. Não há veredictos nem datas de fechamento de oposição fora de milestones. Uma
parte inexistente é 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 } }
Peça para apresentar uma oposição
GET /reports/opposition-brief?applicationNumber=… — permissão reports:read ou
reports:opposition-brief:read. MCP: get_opposition_brief.
O que você precisa para preparar uma oposição contra uma marca, em uma chamada, como sinais com a sua evidência.
| parâmetro | o que é |
|---|---|
applicationNumber |
obrigatório — a marca alvo |
ownApplicationNumber |
opcional — a sua marca; sem ela não há sinal de semelhança |
limit |
limite de cada lista (titulares, arestas): padrão 10, máximo 20 |
| campo | o que é |
|---|---|
trademark |
a marca como a coleção a publica (classes, status, milestones[]), mais publishedOn tal qual e currentHolders/currentRepresentatives pelo id |
inOppositionWindow |
true se está hoje na sua janela de oposição — pertinência; o fechamento está em trademark.milestones como opposition_close |
similarity |
só com ownApplicationNumber: a posição do alvo entre as 100 marcas mais parecidas com a sua nas classes dele (rank, score, matchedBy, signals), ou found: false. Sem a sua marca a chave não viaja (não é preenchida) |
holders |
cada titular vigente do alvo com oppositionsFiled (a quem se opôs: arestas opposed) e oppositionsReceived (quem se opôs a ele: arestas opposed_by, mais unresolvedOpponentMentions), cada um com partyCount, trademarkCount e as arestas mais frequentes |
citedNorms |
as normas citadas nos atos de oposição recebidos pelas marcas vigentes desses titulares, com contagem e até 5 números de evidência (o alvo primeiro) |
coverageFrom |
só há oposições no corpus desde essa data |
dataAsOf, coverageThrough |
o frescor, no corpo (e nos cabeçalhos) |
⛔ Nenhuma data de fechamento de oposição fora de milestones (viaja em milestones como opposition_close, com o seu artigo), nenhum
veredicto, nenhum renewalStatus (um escrito não publica um status que muda todo dia; as datas da janela
de renovação viajam em milestones). Alvo ou marca própria inexistentes: 404 not_found; a mesma marca
nos dois 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" } }
Peça para responder a uma oposição
GET /reports/opposition-response-brief?applicationNumber=… — permissão reports:read ou
reports:opposition-response-brief:read. MCP: get_opposition_response_brief.
O que você precisa para responder às oposições que a sua marca recebeu, em uma chamada.
| parâmetro | o que é |
|---|---|
applicationNumber |
obrigatório — a marca atacada |
limit |
limite de cada lista (oponentes, arestas, marcas): padrão 10, máximo 20 |
| campo | o que é |
|---|---|
trademark |
a mesma ficha da peça para apresentar |
oppositionActs |
os atos de oposição sobre a marca, colapsados por fato (versionsOfFact), do mais antigo ao mais recente, até 50 + hasMore: data, section com sectionLabel nos três idiomas, citedNorms do ato, opponents resolvidos (pelo id) e unresolvedOpponentMentions |
opponents |
cada oponente resolvido (os de mais atos primeiro): actsOnTrademark, oppositionsFiled (suas arestas opposed) e trademarksInClasses — suas marcas vigentes nas classes da marca atacada |
unresolvedOpponentMentions |
a soma das menções não resolvidas |
coverageFrom, dataAsOf, coverageThrough |
como acima |
⛔ As marcas de um oponente são buscadas pelo seu persona_id, nunca pelo nome: pelo nome, «ACME»
arrastaria as de «ACME CHILE». ⛔ Uma menção de oponente que não casa com uma parte é contada e
não é nomeada: o seu texto não aparece na resposta. Também não há veredictos nem datas de fechamento
fora 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" } }
Dossiê de fatos de uma peça
GET /reports/filing-context?type=…&applicationNumber=… — permissão reports:read ou
reports:filing-context:read. MCP: get_filing_context.
Os fatos de que uma peça sobre uma marca precisa, cada um com sua fonte, em uma chamada. ⛔ O core dá os fatos; a redação é sua. Não há rascunho, nem prosa jurídica, nem argumentos, nem LLM: a redação, os modelos por organização e o documento final são do consumidor.
| parâmetro | o que é |
|---|---|
type |
obrigatório — power_of_attorney (procuração simples), opposition (oposição), opposition_response (contestação de uma oposição), office_action_response (resposta a observações do INAPI), withdrawal (desistência) |
applicationNumber |
obrigatório — a marca da peça (a marca-alvo numa oposição; a marca que recebeu a oposição ou a observação numa resposta) |
annotationId |
o ato que se responde: obrigatório com office_action_response e opcional com opposition_response (um ato de oposição em vez de todos). Tem de ser um ato dessa marca (senão, 404); com os outros tipos, 400 |
ownApplicationNumber |
só com opposition: sua marca, para acrescentar a comparação com a alvo; com os outros tipos, 400 |
expand=legalTexts |
o texto dos artigos citados (ver abaixo); exige também legal:read |
| tipo | que fatos traz |
|---|---|
power_of_attorney |
a marca, suas classes, seus titulares vigentes e seu representante vigente, cada um com seu identificador (RUT) |
opposition |
a marca-alvo (publicação, classes, estado, partes), se está hoje em sua janela de oposição (pertencimento), as oposições que já recebeu (cada ato com sua data), o histórico de oposições de seus titulares, as normas citadas nesses atos, os sinais de normas dos atos de oposição recebidos pelas marcas de seus titulares (normSignals) e, com sua marca, a comparação via por via (comparison, a de compare_trademarks) |
opposition_response |
os atos de oposição sobre a marca (ou o que você indicar), seus oponentes resolvidos com seu identificador, as menções não resolvidas contadas e as normas citadas |
office_action_response |
o ato (act.section, act.sectionName, act.date) e as normas que cita |
withdrawal |
a marca, seu titular, seu estado publicado e suas classes |
| campo | o que é |
|---|---|
trademark |
a ficha da marca (com seus milestones, publishedOn tal qual e suas partes vigentes com taxId) |
facts[] |
{key, value, source} — source {kind, ref, date} diz de onde vem o dado (trademark, party, annotation, opposition_brief, opposition_response_brief) e o que pedir para relê-lo (ref: o número do pedido, o id da parte ou o da anotação). ⛔ Um fato sem valor é omitido, nunca preenchido |
milestones |
os prazos da peça com sua norma e seu artigo: o encerramento da oposição (opposition) e a contestação do traslado (opposition_response) |
milestonesOmitted[] |
os prazos que não são dados, e por quê (kind, reason, section) |
citedNorms[] |
as normas citadas nos atos da peça, cada uma com seu ato (source, section); citedNormsTruncated se houver mais de 20 atos |
normSignals[] |
só em opposition: normas dos atos de oposição recebidos pelas marcas dos titulares, com contagem e evidência — sinais, não fundamentos |
comparison |
só em opposition com ownApplicationNumber: sua marca (A) frente à alvo (B); null caso contrário. Também null quando uma das duas não tem denominação comparável (uma figurativa, só sinais): o dossiê chega igual, com um fato comparison.omitted (valor no_comparable_denomination, source.ref = o número dessa marca) |
outline |
uma estrutura genérica (generic: true): as seções header, parties, facts, grounds, requests e signature, e quais chaves de fatos (ou campos) preenchem cada uma. Sem texto e sem a marca de ninguém |
coverageFrom, dataAsOf, coverageThrough |
desde quando há oposições no corpus, e o frescor |
Os prazos: só com seu artigo. O dossiê publica dois prazos, os MESMOS marcos que a marca publica. Em
opposition, o encerramento da oposição (opposition_close): 30 dias úteis a partir da publicação do
extrato, com sua base legal no campo (Ley 19.039 art. 5 e art. 11; Ley 19.880 art. 25). Sem data de
publicação não há âncora: é omitido com no_publication_date.
⭐ Em opposition_response, a contestação do traslado (opposition_response_close, desde
2026-10-10): o 30.º dia útil posterior à notificação do traslado, improrrogável (Ley 19.039 art. 9 e art.
11; Ley 19.880 art. 25; Decreto 82/2022 art. 24). Não contestar não é abandono: vencido o prazo, o
procedimento segue. O anchor traz o ato de que sai a data (annotationId, sectionCode), que também
viaja como fato opposition.transfer. É derived quando o corpus tem a notificação do Estado Diario
(C1) e a resolução de traslado no mesmo dia, e estimated — diga-o assim — quando falta uma das duas
(estimateReasons). Por exemplo, o traslado do processo 1605530, notificado em 2025-05-22, dá
2025-07-04, a mesma data que o INAPI anotou como «Fin de plazo». Quando não é dado, milestonesOmitted diz
por quê: no_transfer_on_record (o corpus ainda não tem o traslado: chega semanas depois da oposição),
madrid_designation (o INAPI fixa outro prazo para uma designação de Madrid), prior_legal_regime
(traslado anterior a 2022-05-09, notificado por carta registrada), anchor_on_non_business_day ou
outside_holiday_calendar. É «não sabemos», nunca «não há prazo».
Os prazos que não têm artigo não são dados: a resposta a uma exigência sobre uma petição
(office_action_response_term, com sua section: 661B, 813B, 931, 925) aparece em
milestonesOmitted com reason: "no_legal_basis_in_knowledge_base" — cada resolução os fixa e são
prorrogáveis. ⛔ Não calcule nem mostre uma data para eles como se fosse um prazo do core.
expand=legalTexts acrescenta a cada citedNorms[] o texto literal do artigo/letra vigente na
data do ato (text, textStatus) e os documentos do INAPI que o citam (guidance, sinais com
contagem): a mesma citação explicada de get_annotation?expand=citations. Exige
também legal:read: sem ela, 403 forbidden que nomeia legal:read, sem consumir cota. Sem expand,
essas três chaves não estão.
As observações de terceiros não são um tipo de peça. Foi verificado no repositório de conhecimento do
INAPI e ele não as registra como uma peça distinta da oposição — lá, as «observações» são resoluções
do INAPI sobre uma peça (661B, 813B…), que office_action_response já cobre. Pedir
type=third_party_observations é um 400. Se o repositório passar a registrá-las com sua norma, serão um
sexto tipo.
Permissão própria: nem uma chave sem restrição, nem a chave de teste, nem as permissões das peças de
oposição (reports:opposition-brief:read, reports:opposition-response-brief:read) a recebem. Sem ela,
403 forbidden que nomeia reports:filing-context:read, sem consumir cota. 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"] } }
Escopos
As quatro leituras exigem o escopo brands:read. Um array de escopos vazio é irrestrito para elas (mesma
regra do resto do contrato).
Os relatórios têm permissão própria: reports:read concede todos, e reports:<relatório>:read um
(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). ⛔ São concedidos explicitamente: uma chave
com array de escopos vazio não os recebe, nem a chave de teste. Sem a permissão, 403 forbidden. Cada
chamada a um relatório conta uma unidade de cota. Veja o guia de autenticação.
MCP
REST é equivalente a MCP: mesma chave, mesmos escopos, mesmos schemas.
| Ferramenta MCP | Equivalente REST |
|---|---|
get_trademark (com 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 (sem portfolio, também 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 |
Erros
Todos os erros usam o corpo RFC 9457 descrito em primeiros passos.
| HTTP | code |
Quando |
|---|---|---|
| 401 | unauthorized |
Chave ausente, malformada, desconhecida ou revogada. |
| 403 | forbidden |
Falta o escopo brands:read, ou a permissão do relatório (reports:read ou a sua), ou legal:read com expand=legalTexts. |
| 404 | not_found |
Marca inexistente (também o alvo ou a marca própria de uma peça), ou parte inexistente na carteira; no dossiê, um annotationId que não é um ato dessa marca. |
| 400 | invalid_rut / invalid_range |
taxId sem forma de RUT, ou um intervalo com From > To — também com semelhança e janela de oposição. |
| 400 | validation_error |
Faltam parâmetros obrigatórios, um parâmetro desconhecido, similarTo com similarToTrademark, a janela de oposição combinada com a similaridade, ou um calendário de renovação sem from/to ou de mais de 366 dias. |
| 422 | out_of_coverage |
Boletim de um dia sem boletim ingerido, ou janela de oposição com um calendário de feriados que não cobre de hoje − 90 a hoje + 60 dias (leva coverage). |
Veja também
- Autenticação e escopos —
X-API-Key,brands:read. - Conecte seu agente de IA (MCP) — as mesmas leituras via MCP.
- Primeiros passos — envelope, paginação por keyset, corpo de erro.
- A referência OpenAPI ao vivo em
https://api.tarno.cl/docs.