Modelo de datos del contrato
Esta página describe lo que la API te devuelve: las entidades del contrato, sus campos principales y
cómo se relacionan. Los nombres de campo son exactamente los de las respuestas, en REST y en MCP (los dos
transportes devuelven la misma forma). No es la lista completa: el esquema exhaustivo, campo a campo y
siempre al día, vive en la referencia OpenAPI interactiva en
https://api.tarno.cl/docs. Cuando un campo no aparece aquí, la referencia
es la autoridad.
Cada sección dice qué es la entidad, sus campos con tipo y significado, y la operación de la referencia
donde la lees. Un campo cuyo valor no se conoce viaja como null o se omite: significa «no lo sabemos», nunca un
valor rellenado.
Cómo se relacionan
erDiagram
trademark ||--o{ annotation : "su historia"
trademark }o--|{ niceClass : "protege en"
trademark }o--o{ party : "titulares y representantes"
annotation }o--o{ party : "partes del acto"
annotation }o--o{ legalNorm : "cita"
party }o--o{ party : "relaciones"
guidanceDocument }o--o{ legalNorm : "interpreta"
report }o--o{ trademark : "reúne"
watchedApplication }o--|| trademark : "vigila"
watchedApplication ||--o{ similarityHit : "produce"
similarityHit }o--|| trademark : "la parecida"
Marca
Una solicitud o registro de marca ante INAPI: el signo, quién lo pide, para qué clases y en qué punto de su
tramitación está. La lees con GET /trademarks/{applicationNumber} (operación getTrademark); las
listas y la búsqueda (listTrademarks, searchTrademarks) devuelven la misma marca en forma resumida.
| campo | tipo | significado |
|---|---|---|
applicationNumber |
string | Número de solicitud: la clave de la marca en todo el contrato. |
registrationNumber |
string | Número de registro, cuando la marca está registrada. |
denomination |
string | La denominación del signo, tal como la publica INAPI. |
signType |
string | Tipo de signo (código: "mixta", "denominativa"…). |
category |
enum | Qué se protege: marca, frase_propaganda, colectiva, denominacion_origen… |
scope |
enum | Productos, servicios o establecimiento. |
status |
string | Estado publicado (código del catálogo de estados). |
statusInapi |
string | El estado literal de INAPI, sólo cuando difiere de status. |
filedOn |
fecha | Fecha de presentación. |
publishedOn |
fecha | Fecha de publicación de la solicitud. |
registeredOn |
fecha | Fecha de registro. |
expiresOn |
fecha | Fecha de vencimiento del registro. |
classes |
objeto[] | Las clases de Niza de la marca: number, goodsAndServices y status de cada una. |
holders |
objeto[] | Los titulares actuales (cada uno, una parte). |
representatives |
objeto[] | Los representantes actuales (también partes). |
annotations |
objeto[] | Las anotaciones de la marca. |
procedureHistory |
objeto[] | El índice del expediente de INAPI: los pasos de la tabla de trámites y las anotaciones numeradas, por fecha (y, dentro del día, por el flujo del procedimiento), con date, code, inapiText, reference (número de resolución o escrito) y annotationNumber (null en un paso). |
renewals |
objeto[] | La cadena de renovaciones: cada paso con su date, code y kind (request, grant u outcome). |
lastRenewalOn |
fecha | La renovación concedida más reciente. |
renewalStatus |
enum | Dónde está el plazo de renovación hoy: not_due, window_open, grace, lapsed, renewed_expiry_pending. |
milestones |
objeto[] | Los hitos con fecha (vencimiento, cierre de oposición, apertura de la renovación…), cada uno con su basis. |
oppositionWindow |
objeto | El plazo de oposición: deadline, businessDaysLeft y su legalBasis. |
dataAsOf |
fecha-hora | La fecha del dato de esta respuesta. |
coverageThrough |
fecha | Hasta dónde llega la cobertura del corpus. |
Un hito calculado o estimado (basis: "derived" o "estimated") y el plazo de oposición llevan su norma y
artículo en legalBasis: un plazo sin artículo no es un plazo que puedas comprobar. Un hito que es una fecha
publicada por INAPI (basis: "source") no lleva legalBasis: dice en field de qué campo sale (p. ej.
expiresOn). Para buscar marcas por campos, ver
Búsqueda por campos.
Anotación
Un acto que INAPI publica sobre una solicitud en el Estado Diario: una resolución, una oposición, una
transferencia, una renovación… Las anotaciones de una marca vienen en su annotations; una sola, con
GET /annotations/{id} (getAnnotation); todas las de una marca, con listTrademarkAnnotations; y la
búsqueda por texto, con searchAnnotations.
| campo | tipo | significado |
|---|---|---|
id |
string | Identificador de la anotación. |
applicationNumber |
string | La marca a la que pertenece. |
date |
fecha | La fecha del acto, según INAPI. |
section |
string | El código de sección de INAPI (p. ej. M11). |
sectionName |
string | El nombre de la sección, tal como lo escribe INAPI. |
sectionLabel |
objeto | Ese nombre en es-CL, en y pt-BR. |
act |
string | El código del acto concreto que nombra la anotación, cuando se identifica. |
actStatus |
enum | Qué significa act: identified, unidentified («no lo sabemos») o not_applicable. |
observation |
string | El texto de la anotación, literal. |
parties |
objeto[] | Las partes que nombra el acto: role, name y, si se identificó, partyId. |
citations |
objeto[] | Con expand=citations: las normas que cita, con legalNormId, article, letter y el texto aplicable ese día. |
detectedAt |
fecha-hora | Cuándo el servicio conoció el acto (no cuándo lo publicó INAPI: eso es date). |
Para interpretar un código de sección, GET /sections/{code} (getSection) te da su significado.
Parte
Una persona natural o jurídica que aparece como titular, representante u oponente en una marca. La lees con
GET /parties/{id} (getParty); sus marcas, con listPartyTrademarks; sus relaciones con otras partes,
con listPartyRelations. Ver Búsqueda de personas.
| campo | tipo | significado |
|---|---|---|
id |
string | Identificador de la parte (lo usa el filtro party de la búsqueda). |
name |
string | El nombre, tal como aparece en las solicitudes. |
kind |
enum | natural, legal o unknown. |
taxId |
string | El RUT (cuerpo-DV) cuando se conoce. El de una persona natural puede venir enmascarado. |
country |
string | País de la parte. |
territory |
objeto | Comuna y región declaradas en la solicitud (communeName, regionName). |
trademarkCount |
integer | Cuántas marcas tiene. |
mergedInto |
string | Si la parte se fundió en otra, el id de la que tiene hoy sus marcas. |
sii |
objeto | Lo que dice el SII de una persona jurídica con RUT chileno (legalName, activityStartedOn…), con su propia fecha asOf. |
En las relaciones (listPartyRelations), cada entrada dice el type (co_holder, represents,
represented_by, assigned_to, assigned_from, opposed, opposed_by), la otra party, el
trademarkCount que lo prueba y las fechas firstOn y lastOn.
Clase de Niza
Una de las 45 clases de la Clasificación de Niza en la que una marca protege productos o servicios. El
catálogo, con GET /nice-classes (listNiceClasses); las estadísticas de una clase, con getClassStats.
| campo | tipo | significado |
|---|---|---|
number |
integer | El número de la clase, de 1 a 45. |
title |
objeto | El encabezamiento de la clase en los tres idiomas. |
goodsAndServices |
string | En una marca, el texto de productos y servicios que protege en esa clase. |
Norma y Directriz
La base documental: las leyes y reglamentos que citan los actos de INAPI, y los documentos con que INAPI los interpreta (Directrices, circulares, manuales). Ver Base documental.
Una norma se lee con GET /legal-norms/{id} (getLegalNorm) y un artículo con su texto vigente en una
fecha, con getLegalNormArticle; la búsqueda en el texto de las leyes es searchStatutes.
| campo | tipo | significado |
|---|---|---|
id |
string | Identificador de la norma en el catálogo. |
kind |
string | ley o reglamento. |
name |
string | El título oficial. |
articles |
objeto[] | Sus artículos (article, letter). |
body |
string | En un artículo: su texto literal. |
asOf |
fecha | En un artículo: la fecha para la que se eligió el texto. |
Un documento (Directriz, circular…) se lee con GET /guidance/documents/{code}
(getGuidanceDocument); una sección, con getGuidanceSection.
| campo | tipo | significado |
|---|---|---|
code |
string | El código estable del documento (guideline-35). |
title |
string | El título que le da INAPI. |
version |
objeto | La versión servida, con su seq y desde cuándo se ve publicada (firstSeenAt). |
outline |
objeto[] | Sus secciones en orden (path, heading), sin el texto. |
sourceUrl |
string | Dónde lo publica INAPI. |
Informe
Una respuesta compuesta que reúne marcas, partes y normas para una pregunta concreta. Da señales, no veredictos: dice qué encontró y con qué parecido, nunca si una marca es registrable o infringe. Ver Informes y oposiciones.
| informe | operación | qué responde |
|---|---|---|
| Disponibilidad | getClearanceReport |
Qué marcas parecidas hay a un texto en unas clases (similar), con los titulares con más marcas en esas clases y las normas citadas en los actos de las parecidas. |
| Panorama de conflicto | getConflictLandscape |
Qué titulares y representantes están detrás de las marcas vivas parecidas. |
| Cartera | getPortfolioReport |
Las marcas de una parte, por estado, clase y plazo de renovación, con sus próximos hitos. |
| Escrito de oposición | getOppositionBrief |
Los hechos para oponerte a una solicitud: la marca, el parecido con la tuya, sus titulares y las normas citadas en las oposiciones que recibieron. |
Campos principales, con el informe que los lleva:
| campo | tipo | significado |
|---|---|---|
similar |
objeto[] | Disponibilidad: las marcas parecidas, agrupadas por canal de parecido. |
dominantHolders |
objeto[] | Disponibilidad: los titulares con más marcas en las clases pedidas. |
holders |
objeto[] u objeto | Panorama: la lista de titulares de las marcas vivas parecidas. Escrito de oposición: un objeto con los titulares de la marca a la que te opones (parties). |
representatives |
objeto[] | Panorama: los representantes de las marcas vivas parecidas. |
method |
objeto | Panorama: cómo se construyó, con el umbral y lo que se dejó fuera. |
party |
objeto | Cartera: la parte de la que es la cartera. |
byStatus |
objeto[] | Cartera: cuántas marcas tiene la parte en cada estado. |
trademark |
objeto | Escrito de oposición: la marca a la que te opones. |
citedNorms |
objeto[] | Disponibilidad y escrito de oposición: las normas citadas en los actos relacionados, con article y letter. |
coverageFrom |
fecha | Escrito de oposición: desde cuándo hay oposiciones en el corpus. |
dataAsOf |
fecha-hora | Todos: la fecha del dato del informe. |
Vigilancia
Una solicitud que tu organización vigila, y las marcas parecidas que el servicio encuentra para ella. Se
vigila con POST /watch/applications (watchApplication), se listan las vigiladas con
listWatchedApplications y las parecidas con GET /watch/hits (listSimilarityHits). Ver
Vigilancia de parecidos.
Solicitud vigilada:
| campo | tipo | significado |
|---|---|---|
applicationNumber |
string | La solicitud que vigilas. |
watchedSince |
fecha-hora | Desde cuándo la vigilas. |
baselineStatus |
enum | La búsqueda inicial de parecidas: pending o done. |
terminalSince |
fecha-hora | Desde cuándo la solicitud está en un estado terminal; null mientras está viva. |
watchEndsOn |
fecha | El último día de vigilancia de una solicitud terminal, con su motivo en watchEndBasis. |
Parecida:
| campo | tipo | significado |
|---|---|---|
id |
number | Identificador de la parecida mientras sigue abierta (no es el orden de la lista). |
watchedApplicationNumber |
string | Tu solicitud vigilada. |
matchedApplicationNumber |
string | La solicitud parecida. |
score |
number | El parecido, de 0 a 1. Puede ser null sólo en un aviso de serie (relation: "series", una serie adicional del mismo registro de Madrid) que el motor de parecido no puntuó. |
signals |
objeto | Qué vio el parecido: los canales que coinciden (matchedBy) y la fuerza de cada uno (lexical, semantic, phonetic). |
origin |
enum | Quién la detectó primero: baseline (la búsqueda inicial), sync (la revisión diaria) o series_load (una carga de series de Madrid). |
detectedAt |
fecha-hora | Cuándo se detectó (puede ser anterior a tu alta: la vigilancia es global). |
visibleSince |
fecha-hora | Desde cuándo tu organización puede leerla; es el orden de la lista. |
matched |
objeto | La marca parecida, en forma resumida y con su estado de hoy; null si la solicitud ya no existe. |
La fecha del dato
Toda respuesta lleva su fecha: dataAsOf (hasta cuándo está al día el dato) y coverageThrough (hasta
dónde llega la cobertura); en las colecciones, dentro de meta, y en los objetos sueltos que no la llevan en
el cuerpo, en las cabeceras de la respuesta. Las fuentes con su propio ritmo (el SII de una parte, el texto
de una ley, un documento de INAPI) traen además su propia fecha (asOf, dataAsOf).
Muéstrala siempre a quien lee el dato. Un corpus de ayer presentado como de hoy es un dato falso que parece un dato. Ver Cobertura histórica y Estado.