Ir para o conteúdo

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=opposition sobre 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 seu id, 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 de q ou applicationNumber (um só número: é a marca contra a qual se ordena, não um lote). ⛔ A janela não se combina com similarTo/similarToTrademark — ela já ordena por semelhança ao portfólio —: essa combinação é 400 validation_error. Para «marcas parecidas com X» sem janela, use similarTo (texto livre) ou similarToTrademark (uma marca existente), nunca os dois.

oppositionWindow aceita apenas "open": closed e any não existem e são 400 validation_error. Um applicationNumber de carteira que não está no corpus (ou que nem tem forma de número) é 404 not_found, nunca um 200 vazio: «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&section=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 seu nullReason: 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. weightsApplied diz 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