Saltar a contenido

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.

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.