Análisis y cálculo
Herramientas neutrales que hacen un cálculo o reúnen señales sobre el corpus y lo devuelven con su fuente: qué datos usaron, con qué regla y de qué fecha. Nunca dan un veredicto — ni «esta marca es registrable», ni «este plazo vence tal día» sin el artículo que lo sostiene. La decisión jurídica es de quien lee.
El esquema completo y siempre actualizado por campo vive en la referencia OpenAPI interactiva en
/docs(Scalar). Esta guía explica el contrato y enlaza a esa referencia — no reformula el esquema. Cuando un campo no está documentado aquí,/docses autoritativo.
A lo largo de la guía la URL base se escribe como $TARNO_BASE_URL y la clave como $TARNO_API_KEY,
y cada llamada lleva el encabezado X-API-Key. Cada operación REST tiene una herramienta MCP
gemela que devuelve el mismo JSON, byte a byte.
Calculadora de días hábiles
GET /business-days · scope brands:read · equivalente MCP: compute_business_days
Cuenta N días hábiles estrictamente después de una fecha y dice todo lo que usó para contarlos. Es el mismo cómputo que el corpus usa para la ventana de oposición de una marca: lunes a viernes, sin los feriados del calendario, empezando el día siguiente al ancla.
curl -sS "$TARNO_BASE_URL/business-days?from=2026-09-14&businessDays=5" -H "X-API-Key: $TARNO_API_KEY"
{
"anchor": { "date": "2026-09-14", "kind": null, "onBusinessDay": true },
"businessDays": 5,
"date": "2026-09-22",
"term": { "source": "caller", "preset": null, "legalBasis": null },
"legalBasis": [
{ "norm": "Ley 19.039", "article": "11", "role": "business_days" },
{ "norm": "Ley 19.880", "article": "25", "role": "computation" }
],
"calendar": { "table": "feriado", "coverage": { "from": "2013-01-01", "through": "2030-12-31" } },
"skipped": {
"weekendDays": 2,
"holidays": [{ "date": "2026-09-18", "name": "Independencia Nacional", "type": "regular" }]
},
"basis": "derived",
"todayChile": "2026-09-28",
"elapsed": true,
"businessDaysLeft": 0
}
| Parámetro | Qué hace |
|---|---|
from |
La fecha ancla (YYYY-MM-DD, una fecha real: 2026-02-31 es un 400). Se cuenta desde el día siguiente. |
businessDays |
Cuántos días hábiles contar (1…250). El número lo pones tú. |
preset |
Un plazo con su artículo, por nombre. Hoy sólo opposition. |
anchorKind |
Una etiqueta libre para el ancla (≤ 60 caracteres, p. ej. notification); vuelve en anchor.kind y no cambia el cálculo. |
Hay que mandar exactamente uno de businessDays o preset: los dos a la vez, o ninguno, es un
400 validation_error que lo dice, igual por REST que por MCP.
Un número no es un plazo — term
Contar 10 días hábiles es aritmética; decir que un plazo vence ese día exige la norma que fija el plazo. La respuesta separa las dos cosas:
legalBasiscita SIEMPRE las normas del método de conteo: la Ley 19.039 art. 11 (los plazos de la ley son de días hábiles) y la Ley 19.880 art. 25 (qué días son inhábiles y desde qué día se cuenta).termdice de dónde sale N. ConbusinessDays,term.sourceescalleryterm.legalBasisesnull: el 10 lo pusiste tú y el sistema no afirma que sea un plazo legal.
El único preset: opposition
preset=opposition cuenta 30 días hábiles desde la publicación del extracto (Ley 19.039 art. 5).
Con él, term.source es preset, term.legalBasis cita el art. 5 y legalBasis trae los tres
artículos — la misma base legal y la misma fecha que el cierre de oposición del expediente de una
marca (opposition_close en milestones).
curl -sS "$TARNO_BASE_URL/business-days?from=2026-09-14&preset=opposition" -H "X-API-Key: $TARNO_API_KEY"
{
"anchor": { "date": "2026-09-14", "kind": "publication", "onBusinessDay": true },
"businessDays": 30,
"date": "2026-10-28",
"term": {
"source": "preset",
"preset": "opposition",
"legalBasis": [{ "norm": "Ley 19.039", "article": "5", "role": "term" }]
},
"legalBasis": [
{ "norm": "Ley 19.039", "article": "5", "role": "term" },
{ "norm": "Ley 19.039", "article": "11", "role": "business_days" },
{ "norm": "Ley 19.880", "article": "25", "role": "computation" }
],
"skipped": { "weekendDays": 12, "holidays": [ … "2026-09-18" …, … "2026-10-12" … ] },
"basis": "derived",
…
}
¿Por qué no hay más presets? Porque un preset es una promesa de que el plazo tiene artículo, y hoy
sólo la oposición lo tiene verificado. Los plazos de 30, 10 o 60 días que acompañan a otras
resoluciones de INAPI (las observaciones de fondo, por ejemplo) no tienen una norma verificada que los
fije, así que no se ofrecen por nombre: si los necesitas, cuéntalos con businessDays y la respuesta
dirá que N lo pusiste tú. Tampoco se aplican ampliaciones de plazo por resolución exenta.
Cuándo la fecha es una estimación — basis
basis: "derived" significa que la fecha se puede afirmar. basis: "estimated" viene con
estimateReasons, que dice por qué no:
| motivo | qué pasó | qué significa |
|---|---|---|
anchor_on_non_business_day |
el ancla cae en sábado, domingo o feriado | la ley no dice desde qué día se cuenta entonces; se cuenta desde el día siguiente igual |
outside_holiday_calendar |
el tramo [ancla, fecha] sale de la cobertura declarada del calendario (calendar.coverage) |
se descontaron fines de semana y sólo los feriados que el calendario conoce: la fecha real cae el mismo día o después, nunca antes |
Una estimación se presenta como estimación. Nunca como una fecha derivada.
Lo demás de la respuesta
skipped—weekendDaysson los sábados y domingos saltados;holidayslos feriados que cayeron en día laborable, con su nombre y su tipo. Un feriado en sábado o domingo cuenta como fin de semana. Siempre se cumple: días naturales entre el ancla y la fecha = N +weekendDays+ feriados saltados.calendar— la tabla usada (feriado) y la cobertura que el calendario afirma cubrir (nullsi no declara ninguna). Ver la cobertura es finita.todayChile,elapsedybusinessDaysLeft— se evalúan hoy, en hora de Chile:elapsedestodayChileposterior adate;businessDaysLeftcuenta los días hábiles del conteo que aún no han pasado (0 cuando ya pasó). Por eso esta respuesta no se cachea.
Por MCP
{ "name": "compute_business_days", "arguments": { "from": "2026-09-14", "businessDays": 5 } }
Devuelve el mismo JSON que GET /business-days. Un agente debe decir la fecha con su artículo
cuando usa el preset, y decir que es un conteo cuando N lo puso quien pregunta.
Permiso
brands:read, el mismo de las lecturas de marca: una clave sin restricción de scopes y la clave de
prueba lo tienen. Una clave sin él recibe 403 forbidden que nombra brands:read, antes de
consumir cuota — en REST y en MCP (ver Autenticación y scopes).
Plazo para apelar un rechazo o una aceptación parcial
GET /trademarks/{applicationNumber}/deadlines · scope brands:read · equivalente MCP: get_deadlines
La fecha límite para apelar un RECHAZO (024) o una ACEPTACIÓN PARCIAL (444) ante el Tribunal
de Propiedad Industrial: el 15.º día hábil ESTRICTAMENTE posterior a la publicación de esa resolución
en el Estado Diario (día 1 = el hábil siguiente; sin sábados, domingos ni los feriados del calendario — el
mismo conteo que la calculadora con N = 15). El plazo se cuenta desde el Estado Diario
porque así lo cuenta INAPI: su Res. Ex. INAPI 138/2022 dice que el correo es un aviso de cortesía que no
sustituye la notificación legal. Por ejemplo, la aceptación parcial del expediente 1554544, publicada
el 2024-05-15, da el 2024-06-06 (el feriado del 2024-05-21 no cuenta), la misma fecha que INAPI escribió
como vencimiento en su resolución. Viaja con sus tres normas: Ley 19.039 art. 17 bis B
(term: «deberá interponerse en el plazo de quince días, contado desde la notificación de la
resolución»), Ley 19.039 art. 11 (business_days) y Ley 19.880 art. 25 (computation). Es la
MISMA fecha que el hito appeal_close de milestones[] (Hitos); esta operación
añade lo que un hito no puede llevar.
Ejemplo — expediente 1606887 (hasta su recurso: el REC03 llegó el día 16 y fue declarado
extemporáneo):
{
"applicationNumber": "1606887",
"todayChile": "2026-09-29",
"deadlines": [
{
"kind": "appeal_close",
"date": "2025-09-16",
"basis": "derived",
"anchor": { "kind": "rejection_notice", "date": "2025-08-26", "annotationId": "8841468", "sectionCode": "024" },
"rule": "15_business_days_after_notification",
"legalBasis": [
{ "norm": "Ley 19.039", "article": "17 bis B", "role": "term" },
{ "norm": "Ley 19.039", "article": "11", "role": "business_days" },
{ "norm": "Ley 19.880", "article": "25", "role": "computation" }
],
"businessDaysLeft": 0,
"elapsed": true,
"appealObserved": { "annotationId": "8841469", "date": "2025-09-17" },
"caveat": null,
"laterResolutions": []
}
],
"omitted": [],
"calendar": { "table": "feriado", "coverage": { "from": "2013-01-01", "through": "2030-12-31" } },
"meta": { "dataAsOf": "2026-09-29T11:59:09.379Z" }
}
anchornombra la anotación de la resolución que ancla (annotationId) y dice cuál es consectionCode:"024"(rechazo) o"444"(aceptación parcial; lo que se apela es la parte de la cobertura que no se aceptó).anchor.kindesrejection_noticeen los dos casos. La fecha se audita conGET /annotations/{id}.- Cuando el
024o el444es el movimiento resolutivo MÁS RECIENTE de la marca (la familia024,444,M6,M11,664B,662B,484; entre un024y un444ancla el más reciente y, a igual fecha, gana el024). Si no hay ninguno de los dos del que partir, no hay fecha yomitted[]dice por qué, con uno de cuatro motivos:latest_resolution_not_anchoring(el más reciente no es un rechazo ni una aceptación parcial),madrid_designation,anchor_on_non_business_dayooutside_holiday_calendar— los tres últimos valen igual para un024que para un444. Es «no lo sabemos», nunca «no hay plazo»: el core no estima esta fecha. - ⭐ Resoluciones posteriores a la que ancla («opción C», 2026-09-29): si el más reciente es un
M11(p. ej. «no ha lugar por extemporáneo»),664B,662B,484o unM6sin024el mismo día, y antes hay un024o un444, la fecha sí se da, calculada desde el más reciente de los dos, concaveat: "later_resolution_on_record"ylaterResolutions[](annotationId,sectionCode,sectionName,date, de la más antigua a la más reciente): la fecha puede no aplicar ya. Es un hecho con su contexto, no un veredicto. En ese caso no hay hitoappeal_closeenmilestones[]. Sin aviso,caveatesnullylaterResolutionses[]. appealObservedes el primer recurso (REC03) que el corpus registra tras el ancla: un hecho, no un veredicto (no dice si fue en plazo ni si prosperará).todayChile,elapsedybusinessDaysLeftse evalúan hoy, en hora de Chile.- El core no aplica margen de seguridad ni avisa a nadie: a quién avisar y con cuánta antelación lo
decide el consumidor. Una marca inexistente es
404 not_found; sinbrands:read,403antes de consumir cuota.
Pago de los derechos de concesión
⭐ Desde el 2026-10-10 la misma operación da un segundo plazo, kind: "grant_fee_close": el último día
para acreditar el pago de los derechos de concesión de una solicitud aceptada — el 60.º día hábil
ESTRICTAMENTE posterior a la notificación de la resolución de aceptación (029) o, tras una aceptación
parcial (444) o un fallo de oposición (484, 485), de la certificación de ejecutoria (911, 912).
Sin pago, la solicitud se tiene por abandonada. Sus normas: Ley 19.039 art. 18 bis E (term), Ley
19.039 art. 11 (business_days) y Ley 19.880 art. 25 (computation). Es la MISMA fecha que el hito
grant_fee_close de milestones[].
La reserva, siempre a la vista. La ley cuenta los 60 días «desde la fecha en que quede ejecutoriada
la resolución que autoriza la inscripción»; INAPI escribe en su resolución que se cuentan «desde la fecha
de la notificación de esta resolución». La fecha publicada sigue lo que INAPI aplica: por eso es
siempre estimated (estimateReasons: ["anchor_by_office_practice"]) y trae reservation, con
su código y su texto en español, inglés y portugués. ⛔ Mostrad la fecha con esa reserva, nunca como
una fecha cierta. Por ejemplo, la aceptación del expediente 1633868, notificada el 2026-03-10, da el
2026-06-05 — el día que INAPI anotó como «Fin de plazo»:
{
"kind": "grant_fee_close",
"date": "2026-06-05",
"basis": "estimated",
"estimateReasons": ["anchor_by_office_practice"],
"anchor": { "kind": "acceptance_notice", "date": "2026-03-10", "annotationId": "9886756", "sectionCode": "029" },
"rule": "60_business_days_after_notification",
"legalBasis": [
{ "norm": "Ley 19.039", "article": "18 bis E", "role": "term" },
{ "norm": "Ley 19.039", "article": "11", "role": "business_days" },
{ "norm": "Ley 19.880", "article": "25", "role": "computation" }
],
"reservation": {
"code": "statute_counts_from_finality",
"text": { "es": "La ley cuenta los 60 días «desde la fecha en que quede ejecutoriada la resolución que autoriza la inscripción» […]", "en": "The law counts the 60 days […]", "pt": "A lei conta os 60 dias […]" }
},
"businessDaysLeft": 0,
"elapsed": true,
"paymentObserved": null
}
anchornombra el acto (annotationId,sectionCode:029,911o912); manda el más reciente.anchor.kindesacceptance_notice(029) ofinality_certificate(911,912).paymentObservedes el primer pago final (PAG04) que el corpus registra desde el ancla: un hecho, no un veredicto (no dice si fue en plazo, ynullno dice que no se pagó).- Sin fecha,
omitted[]traekind: "grant_fee_close"y uno de cinco motivos:acceptance_not_final(el acto más reciente es una aceptación parcial o un fallo de oposición y su certificación de ejecutoria aún no está en el corpus: el plazo corre desde ella),madrid_designation(las tasas de una designación se pagan por la OMPI),prior_legal_regime(aceptada antes del 2022-05-09: INAPI contaba de otro modo),anchor_on_non_business_dayuoutside_holiday_calendar.
Contestación del traslado de una oposición
⭐ Y un tercer plazo, kind: "opposition_response_close": el último día para que el solicitante
conteste el traslado de una oposición — el 30.º día hábil ESTRICTAMENTE posterior a la notificación
del traslado, improrrogable. Sus normas: Ley 19.039 art. 9 (term), Ley 19.039 art. 11
(business_days), Ley 19.880 art. 25 (computation) y Decreto 82/2022 art. 24 (regulation).
⛔ No contestar no es abandono: vencido el plazo, «se haya o no evacuado el traslado», el
procedimiento sigue. Es la MISMA fecha que el hito opposition_response_close de milestones[]
(Hitos) y que el plazo del expediente de un escrito.
Por ejemplo, el traslado del expediente 1605530, notificado el 2025-05-22, da el 2025-07-04 — el día
que INAPI anotó como «Fin de plazo»:
{
"kind": "opposition_response_close",
"date": "2025-07-04",
"basis": "derived",
"estimateReasons": [],
"anchor": { "kind": "transfer_notice", "date": "2025-05-22", "annotationId": "11199786", "sectionCode": "C1" },
"rule": "30_business_days_after_notification",
"legalBasis": [
{ "norm": "Ley 19.039", "article": "9", "role": "term" },
{ "norm": "Ley 19.039", "article": "11", "role": "business_days" },
{ "norm": "Ley 19.880", "article": "25", "role": "computation" },
{ "norm": "Decreto 82/2022", "article": "24", "role": "regulation" }
],
"businessDaysLeft": 0,
"elapsed": true,
"answerObserved": { "annotationId": "…", "date": "2025-06-17" }
}
anchornombra el acto (annotationId) y su código:C1, la notificación del Estado Diario, cuando el corpus la tiene; si no, la resolución de traslado (458,647,1197,1198). Manda el traslado más reciente de la marca.basisesderivedcuando el corpus tiene, el mismo día, la notificación y la resolución, yestimatedcuando falta una de las dos;estimateReasonsdice cuál se dedujo (notification_inferred_from_resolution_dateotransfer_resolution_not_in_corpus) y es[]cuando esderived. Mostrad unestimatedcomo estimación.answerObservedes la primera contestación (OPO05) que el corpus registra desde el ancla: un hecho, no un veredicto (no dice si fue en plazo, ynullno dice que no se contestó).- Sin fecha,
omitted[]traekind: "opposition_response_close"y uno de cuatro motivos:madrid_designation(a una designación de Madrid INAPI le fija otro plazo),prior_legal_regime(traslado anterior al 2022-05-09, notificado por carta certificada),anchor_on_non_business_dayuoutside_holiday_calendar. Una marca sin traslado en el corpus no trae ninguna entrada: el traslado llega al corpus semanas después de la oposición.
Costos oficiales de INAPI
POST /fee-schedule/calculate · scope brands:read · equivalente MCP: calculate_fees
Calcula las tasas oficiales de INAPI de una solicitud o de una renovación sobre la tabla del cap. 13 de las Directrices (Tasas): los importes son los literales en UTM de la tabla y los pesos se derivan al leer con la UTM del mes, exactos y sin redondear.
curl -s -X POST "$TARNO_BASE_URL/fee-schedule/calculate" -H "X-API-Key: $TARNO_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"procedure": "application_and_registration", "niceClassCount": 3}'
# → lines: 1 UTM × 3 (solicitud) + 2 UTM × 3 (registro); totalUtm 9; totalClp = 9 × UTM del mes
curl -s -X POST "$TARNO_BASE_URL/fee-schedule/calculate" -H "X-API-Key: $TARNO_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"procedure": "renewal", "applicationNumber": "1234567", "on": "2026-09-11"}'
procedure:application_and_registration(solicitud + registro, por clase) orenewal.- Exactamente uno de
niceClassCount(1–45) oapplicationNumber(se cuentan sus clases). on: la fecha de pago (hoy en Chile por defecto).utmMonth: el mes de la UTM (por defecto, el deon); si aún no está publicada se usa la última anterior yutm.basislo dice.
Lo que NO se incluye — siempre en excluded: la publicación en el Diario Oficial (no es una tasa de
INAPI) y los honorarios profesionales.
La renovación y la sobretasa
Con applicationNumber, la renovación usa el vencimiento publicado de la marca y la MISMA regla que
su renewalStatus (Ley 19.039 art. 24), evaluada en la fecha de pago:
- En plazo (
window_open, onot_duesi aún no se abre): 6 UTM por clase y el total. - En la gracia (
grace): el recargo del art. 18 bis B inc. 2º se cuenta «por cada mes o fracción de mes posterior a la expiración».surchargeMonthes el mes de pago contado por meses calendario desde el vencimiento, de fecha a fecha (un día después del vencimiento ya es el mes 1; nunca bloques de 30 días). Se aplica la fila de ese mes de la tabla de la sobretasa de las Directrices 2026 de INAPI (cap. 13; cap. 23 §42), que es la regla vigente (renewal.surchargeRuleSource: "Directrices 2026",renewal.ruleIsOpenQuestion: false), y el total se calcula. La nota «(*)» de esa tabla y otras publicaciones de tasas de INAPI lo redactan distinto: esa discrepancia viaja como nota informativa enrenewal.surchargeDoubt(con las notas literales) y la fila llevasubjectToDoubt: true(meses 2.º a 6.º; el 1.er mes —6 UTM por clase, sin sobretasa— lo confirmó INAPI por escrito el 2026-11-04 y llevafalse), pero no bloquea el total. - Pasada la gracia (
lapsed): el plazo del art. 24 para ese vencimiento pasó;linesvacío y totalnullcontotalOmittedReason: "lapsed". - Renovación ya concedida, vencimiento aún sin actualizar (
renewed_expiry_pending, antes o después del vencimiento):linesvacío y totalnullcontotalOmittedReason: "renewed_expiry_pending".
Con niceClassCount no hay vencimiento conocido: la renovación se tasa en plazo y
renewal.expiresOn es null.
Errores: marca inexistente ⇒ 404; una marca a la que la regla de renovación no se aplica (no
registrada, vía Madrid, sin vencimiento) ⇒ 422 renewal_not_applicable; una marca sin clases ⇒
422 no_nice_classes; los dos de niceClassCount/applicationNumber a la vez, o ninguno ⇒ 400.
Desenlaces de las marcas de una parte
GET /parties/{id}/outcomes · scope brands:read · equivalente MCP: get_party_outcomes
«¿Cómo les va a las marcas que presenta este representante?», contado del corpus con la definición a la
vista. Cada marca en que la parte figura con el papel role (representative por defecto, o holder)
y la relación relation (all por defecto: la trayectoria incluye relaciones retiradas; current,
former) cuenta una vez, por su estado publicado de hoy (el mismo que status), acotada por
niceClass y filedFrom/filedTo (devueltos en population.filters).
| grupo | estados publicados |
|---|---|
registered_ever |
concedida, registrada, esperando_renovacion, vencida, caducado |
refused |
rechazada, denegada |
withdrawn_or_abandoned |
desistida, abandonada |
annulled |
anulada |
pending |
en_tramite, observacion_de_fondo, publicada, oposicion |
decided= registered_ever + refused + withdrawn_or_abandoned + annulled; las pendientes y las marcas sin estado (unclassified) quedan fuera del denominador.grantShare= registered_ever / decided;refusedShare,withdrawnShareyannulledSharecon el mismo denominador. Sidecided = 0, los cuatro sonnull, nunca 0.definitiontrae la definición entera en los tres idiomas, para citarla.
⛔ No es una «tasa de éxito» ni un juicio sobre la parte: el desenlace de una marca depende de
muchos factores ajenos a quien la presenta. Citad siempre population.trademarks (el n).
Estadísticas de una clase
GET /nice-classes/{niceClass}/stats · scope brands:read · equivalente MCP: get_class_stats
«En la clase 25, de las presentadas en 2021–2025, ¿qué parte se registró, cuánto tardó la mediana y
cuántas tuvieron oposición?», calculado del corpus, con su n, su fecha y lo que no cubre.
curl -sS "$TARNO_BASE_URL/nice-classes/25/stats?filedFromYear=2021&filedToYear=2025" \
-H "X-API-Key: $TARNO_API_KEY"
- El periodo va en años enteros de presentación (
filedFromYear,filedToYear). Por defecto, los cinco últimos años completos en Chile (hoy, 2021–2025), devueltos enperiodcondefaulted.filedFromYear > filedToYear⇒400 invalid_range; clase fuera de 1–45 ⇒400 validation_error. - La población (
population.filed, eln): las solicitudes de categoría marca con la clase y presentadas en el periodo. El Protocolo de Madrid y las demás categorías no entran; las que aún no tienen categoría se cuentan aparte (excludedUnknownCategory). - Los desenlaces: los mismos grupos que los desenlaces de una parte (misma lista de
estados publicados, mismo
decided,grantSharey demás cocientes,nullsin decididas). - El tiempo hasta el registro (
timeToRegistration): los percentilesp25/p50/p75en días de las marcas con fecha de registro, con suny el histograma del que salen. ⚠ Son aproximados (approximate: true): salen de cubos de 30 días, con un error máximo de 15 días (precisionDays). Nunca una media. Las fechas de registro anteriores a la presentación quedan fuera y se cuentan (excludedInvalidDates). - Los actos (
actsShare): qué parte de la población tiene al menos una anotación de fondo (substantiveObjection), de forma (formalObjection) y de oposición (opposition). Una marca con varios actos de la familia cuenta una vez. La oposición se cuenta por anotaciones, nunca por las relaciones (que sólo existen desde el 2024-04-19), y lleva siempre sucoverageNote.
La cobertura, dicha — coverage
annotationSources: las fuentes de las que salen los actos. Son dos: las fichas de expediente de INAPI (la historia completa de cada marca,buscador) y el Estado Diario (desde el 2024-04-19,estado_diario).windows: las ventanas de fechas en las que los actos salen de una sola fuente. Hoy es una lista vacía: no hay ninguna.notes: lo que esta respuesta no cubre, con un código estable y su texto en tres idiomas:
| código | cuándo |
|---|---|
madrid_and_other_categories_excluded |
siempre |
unknown_category_excluded |
hay solicitudes sin categoría todavía (las más recientes, y todas las anteriores a 2009) |
current_year_partial |
el periodo incluye el año en curso |
substantive_objection_history_limited |
el periodo empieza antes de 2012: hasta febrero de 2012 INAPI no publicaba la observación de fondo como acto propio. En esos años la cifra cuenta, además de las marcas con actos de fondo, las marcas cuya decisión final (rechazo W160 o aceptación parcial W152) cita una causal de los artículos 19 o 20 de la Ley 19.039. Es un mínimo, porque una observación superada no dejó acto (medido el 2026-10-10, todas las clases: 3.599 de 52.975 de 2009, 4.341 de 57.501 de 2010, 6.940 de 67.859 de 2011). La proporción se publica tal cual, nunca se rellena |
refreshed_before_latest_sync |
una sincronización del corpus empezó después del cálculo |
De dónde sale y cuándo — dataAsOf
Las cifras se calculan una vez por sincronización, al final de la cadena, en una vista del corpus
(agregarlas en cada petición costaba 2,5 s en la clase 35, medido en producción). dataAsOf es la
hora de ese cálculo. Antes del primer cálculo, la operación responde 503 class_stats_pending:
nunca unas cifras a medias.
⛔ Es una señal descriptiva de la clase, no una predicción para una solicitud concreta. Citad
siempre population.filed y el periodo.
Comparar dos marcas
POST /trademarks/compare · scope brands:read · equivalente MCP: compare_trademarks
Dos marcas, vía por vía, con las MISMAS medidas y el mismo plegado (sin acentos ni mayúsculas)
que el motor de parecidos. Cada lado (a, b) es exactamente uno de:
{ "text": "…", "niceClass": [35] }— un texto (1–200 caracteres, al menos una letra o cifra) con clases opcionales;{ "applicationNumber": "1510102" }— una marca del corpus: su denominación, sus clases, sus productos y servicios y su vector semántico guardado.niceClasscon un número es un400; un número que no existe,404.
curl -s -X POST "$TARNO_BASE_URL/trademarks/compare" -H "X-API-Key: $TARNO_API_KEY" \
-H "content-type: application/json" \
-d '{"a":{"text":"ALTODESEMPEÑO CONSULTORES","niceClass":[35]},"b":{"applicationNumber":"1510102"}}'
Las vías — signals
| vía | qué mide |
|---|---|
lexical.wordSimilarityAB / …BA |
similitud de trigramas por palabra en los dos sentidos (no es simétrica): cuánto de A aparece como un tramo de B, y al revés |
lexical.trigramSimilarity |
similitud de trigramas sobre los textos enteros |
editDistance.levenshtein / normalized |
ediciones para convertir A en B (distancia de Levenshtein) y la misma cifra dividida por el largo del texto más largo (0 = idénticos) |
phonetic.wordSimilarity / keysEqual |
la clave fonética española (seseo, yeísmo, betacismo, h muda, qu/k): keysEqual: true = suenan igual |
semantic |
similitud semántica (coseno) reescalada contra la línea base de pares sin relación (method.semanticBaseline, 0,78) |
sharedTokens |
las palabras plegadas que están en los dos |
classes dice las clases de Niza en común y aparte (null si un lado no tiene). Con dos marcas por
número, goodsAndServices.perSharedClass lista, por clase compartida, las raíces de palabra en español
presentes en las dos descripciones («camisas» da camis), con tope de 50
(truncated).
El semántico. Un texto va como query: y el otro como passage: (así se calibró la línea base);
una marca por número aporta su vector guardado sin pedir nada al sidecar. meta.semanticPairing dice
el emparejamiento (query_passage, o passage_passage con dos marcas). ⚠ semantic: null significa
no evaluado, nunca un 0: meta.channels.semantic dice por qué — degraded (el sidecar tardó más
de 800 ms o falló; el resto de la respuesta sale igual), not_configured (sin sidecar) o
not_embedded (la marca aún no tiene vector).
Lo que NO devuelve, y por qué
No hay puntuación global, ni nivel (alto/medio/bajo), ni «riesgo», ni un artículo de ley como
fundamento. Cada vía es una señal medida con su función; combinarlas en un veredicto de
confundibilidad es una decisión jurídica que el corpus no toma. method explica cada vía en los tres
idiomas para citarla.
Términos genéricos y núcleo distintivo
Cada lado declara qué palabras no distinguen en SUS clases, y por qué (genericTerms[].reasons):
curated— la lista neutral aprobada por el equipo de Tarno (method.genericTerms.listVersion): conectores (de, la, the…), formas societarias (ltda, grupo… y las frases «s.a.», «s.p.a.», «e.i.r.l.» reconocidas antes de trocear), gentilicios (chile…), dominios (cl, com); comercio (store, tienda, distribuidora…) sólo en 35 y 25; servicios profesionales (consultores, servicios, soluciones…) sólo en 35 y 42;spasólo como última palabra y nunca en las clases 3 ni 44. Nuncamas,plus,proni letras sueltas.corpus_frequency— el vocabulario del sector: la palabra está en al menosmax(50, 0,75 % de las marcas de la clase)(count,classSize,threshold), contado en el índice del motor con tope. Asíclinicaen la 44 ohotelen la 43 se descuentan sin estar en la lista.
decompounded separa una palabra pegada de 8 o más letras sólo si las dos partes existen como
palabra del corpus y la palabra entera no lo es («altodesempeno» ⇒ «alto» + «desempeno»).
distinctiveCore es lo que queda (coreStatus: reduced); null si no había nada que descontar
(unchanged) o si sólo quedaban genéricos (only_generic_terms) — nunca un núcleo vacío presentado
como distintivo.
distinctiveSignals repite las vías léxica, de edición y fonética sobre los núcleos (sin
semántico). Es un descuento declarado: signals no cambia nunca.
El caso que lo motivó. La disponibilidad de «ALTODESEMPEÑO CONSULTORES» en la clase 35 devolvía 40
de 40 parecidas por «CONSULTORES» y no veía «MAS Desempeño» (medido en producción el 2026-09-28).
Comparadas, A declara consultores genérica en la 35 y altodesempeno separada; su núcleo es «alto
desempeno», y distinctiveSignals pone a la vista lo que tienen en común: sharedTokens: ["desempeno"].
Permiso: brands:read. Una llamada = una unidad de cuota.
Recomendar clases de Niza
POST /nice-classes/recommend · scope brands:read · equivalente MCP: recommend_nice_classes
«Voy a vender ropa deportiva por internet: ¿en qué clases?». Una descripción libre (3 a 500 caracteres) ⇒ las clases de Niza de la edición vigente, cada una con el término oficial de la OMPI, el encabezamiento y ejemplos reales del corpus, y con cada vía por separado.
curl -sS -X POST "$TARNO_BASE_URL/nice-classes/recommend" \
-H "X-API-Key: $TARNO_API_KEY" -H "Content-Type: application/json" \
-d '{"description": "venta de ropa deportiva por internet", "limit": 5}'
La edición (edition, editionSelection): la vigente en Chile en la fecha de hoy. Es la
13-2026 hasta el 2026-12-31 y la 13-2027 desde el 2027-01-01, sin que nadie cambie nada. La
respuesta dice cuál usó y desde cuándo rige. ⛔ Nunca la 12.ª edición ni el clasificador de INAPI de
ediciones anteriores. listVersion es la versión de la lista oficial cargada (20260101), o null si
esa edición aún no está cargada. Los encabezamientos (heading) son los de esa misma edición: desde el
2027-01-01, los de la 13-2027, con pt-BR (traducción propia de Tarno) también en ella.
Las cuatro vías, cada una en signals y su posición en ranks:
| vía | qué compara | valor |
|---|---|---|
termSemantic |
la descripción con los términos oficiales de la OMPI (≈ 10.000, con su número de base), por significado | similitud semántica (coseno) cruda del término más cercano de la clase |
termLexical |
las palabras de la descripción con el texto de esos términos | el mejor rango de texto (0–1) de un término de la clase |
headingSemantic |
la descripción con los 45 encabezamientos, por significado | similitud semántica (coseno) cruda |
corpusEvidence |
las descripciones de productos y servicios de marcas reales del corpus que casan con la descripción (las primeras 1.000, method.corpusSample) |
cuántas son de la clase, sobre cuántas se miró |
Cada vía ordena las clases y se fusionan con RRF (k = 60, el mismo criterio que la búsqueda). Por
cada clase candidata: officialTerms[] (hasta 5: número de base, término en es y en, y por qué vía
salió) y corpusExamples[] (hasta 3: número de solicitud y un extracto literal de su descripción,
con excerptOffset). ⚠ El coseno semántico comprime los pares sin relación en ~0,75–0,80: sirve para
comparar clases entre sí, no como una puntuación absoluta.
Cuando algo falta, se dice (meta.channels):
degraded— el servicio de vectores falló o tardó más de 800 ms: las vías por significado sonnully las otras se sirven igual.pending_embeddings— la lista oficial todavía se está preparando para la búsqueda por significado (se hace de noche, entre las 00:00 y las 07:00 de Chile, unos días tras cada carga).meta.pendingEmbeddingsdice cuántas filas faltan. La vía por texto de la lista sigue.not_loaded— no hay lista cargada para la edición vigente: sólo corre la evidencia del corpus.not_configured— el despliegue no tiene servicio de vectores.
Atribución (attribution): los términos y los encabezamientos son de la OMPI (Clasificación de
Niza, CC BY 4.0). Citad la atribución cuando los mostréis. dataAsOf.officialList es la fecha de la
lista; dataAsOf.corpus, la del corpus.
Bordes: una descripción con sólo palabras vacías (de la para) o sólo exclusiones (-calzado) ⇒
400 validation_error; menos de 3 o más de 500 caracteres, o limit fuera de 1–10 ⇒ 400.
⛔ Es una señal para elegir clases, no una clasificación oficial: la decide quien presenta y la revisa INAPI.
Permiso: brands:read. Una llamada = una unidad de cuota.
Análisis de un logo
POST /logos/analyze · scope logo:analyze · equivalente MCP: analyze_logo
⛔ La descripción la genera un modelo de lenguaje (Anthropic, claude-sonnet-5 por defecto), no
INAPI ni una persona. Es la única operación del contrato que usa un modelo de lenguaje, y la
respuesta lo dice en generatedBy y en disclaimer. Citad el aviso junto al resultado.
Una imagen ⇒ lo que muestra, en los términos de INAPI: los elementos denominativos (el texto,
literal), los figurativos, los colores, la tipografía y el tipo de signo que el modelo
sugiere (denominativa, figurativa, mixta, etiqueta, tridimensional o null); y los códigos
de la Clasificación de Viena, 10.ª edición (VCL10), en vigor desde el 2026-01-01.
El estilo de description (desde el 2026-09-29) es el de las descripciones de etiqueta del
registro de INAPI, medido sobre 99.996 descripciones de marcas mixtas y figurativas presentadas en
2021–2024: abre con «Etiqueta consistente en …» (la apertura más frecuente: 40,6 % de las mixtas y
50,5 % de las figurativas; «La marca tridimensional consiste en …» para una forma tridimensional, y
una frase corta con «Denominación "…"» para un signo sólo de palabras, que en el registro no lleva
descripción); recorre los elementos en orden de lectura y los sitúa unos respecto de otros
(«sobre», «bajo», «en su interior», «a la izquierda», «en la parte superior»); cita el texto
literal; describe las letras con palabras llanas («letras mayúsculas de color negro», «letras
estilizadas»); pega cada color a su elemento, con los nombres de Chile («naranjo», «celeste»,
«café») y sin códigos Pantone/RGB; y cierra con el fondo («Todo sobre fondo blanco.»). Una a tres
frases, unos 150–300 caracteres (la mediana del registro es 212). ⛔ No escribe la fórmula «se
reivindican los colores» (0,1 % del registro) ni frases sobre el alcance de la protección («sin
protección a las demás palabras…»): no describen la imagen.
curl -sS -X POST "$TARNO_BASE_URL/logos/analyze" \
-H "X-API-Key: $TARNO_API_KEY" -H "Content-Type: application/json" \
-d "{\"image\": {\"mediaType\": \"image/png\", \"dataBase64\": \"$(base64 < logo.png | tr -d '\n')\"}}"
La imagen va en el cuerpo, en base64 (sin prefijo data: ni saltos de línea): PNG, JPEG, GIF o
WebP, comprobado por la cabecera del fichero (un PNG declarado como image/jpeg es un 400), hasta
700 KB decodificada y 2.000 px por lado. ⛔ Nunca una URL: el core no descarga imágenes.
Qué pasa con la imagen: se envía a Anthropic para el análisis (junto con el catálogo de Viena y
las instrucciones; nada más: ni vuestra clave ni quién llama) y no se guarda ni se registra en
ninguna parte del core. De ella sólo vuelve su huella: image {mediaType, width, height, bytes,
sha256} — el sha256 sirve para no pedir dos veces el mismo logo.
Los códigos de Viena (viennaCodes): sólo los que el modelo propone y existen en VCL10; cada uno
con la etiqueta de la OMPI en sus dos lenguas auténticas (en, fr), nunca con las palabras del
modelo. ⚠ es es siempre null: ni la OMPI ni INAPI publican etiquetas en español, y el core no las
traduce. discardedCodes cuenta los códigos propuestos que no existen (se descartan, no se
muestran). viennaCatalog.attribution es el reconocimiento del copyright de la OMPI: citadlo con los
códigos.
Cuotas propias (además de la unidad de la cuota mensual, como cualquier llamada): 20 análisis por
clave y día de Chile, y 200 por día entre todas las claves. Pasarse ⇒ 429 logo_quota_exceeded
(la clave) o 429 logo_global_quota_exceeded (el servicio), con Retry-After hasta la medianoche de
Chile y retryAfterSeconds en el cuerpo — distinto del 429 quota_exceeded de la cuota mensual.
Bordes:
| estado | code |
cuándo |
|---|---|---|
400 |
invalid_image |
la imagen no es base64 canónico, no es PNG/JPEG/GIF/WebP, no casa con mediaType, pasa de 700 KB o de 2.000 px (reason dice cuál) |
400 |
validation_error |
la entrada tiene un campo de más (una url, p. ej.) o un mediaType que no es de los cuatro |
422 |
logo_analysis_refused |
el modelo se negó a describir la imagen |
422 |
logo_image_rejected |
el proveedor no pudo procesar la imagen (pasó la comprobación de la cabecera, pero el fichero está dañado o no es lo que dice): no reintentéis la misma imagen. La llamada se hizo y cuenta en la cuota del día |
429 |
logo_quota_exceeded / logo_global_quota_exceeded |
la cuota diaria |
502 |
logo_analysis_invalid_output |
la salida del modelo no cumplió el esquema (se valida siempre; nunca se interpreta texto libre) |
503 |
logo_analysis_not_configured |
el servidor no tiene clave del proveedor: la operación existe y responde esto |
503 |
logo_analysis_unavailable |
el proveedor no responde o está saturado: reintentad más tarde |
503 |
logo_quota_unavailable |
el contador de la cuota no responde: sin contador no se llama al modelo |
⛔ No es una resolución de INAPI ni opina sobre si la marca se puede registrar, es distintiva o choca con otra. Describe la imagen y propone códigos; la clasificación la hace INAPI.
Permiso: logo:analyze, concedido explícitamente (una clave sin restricción no lo tiene, ni la
de prueba, ni reports:read). Una llamada = una unidad de cuota mensual + una del día.
Parecido por imagen (operación futura)
POST /logos/similar · scope logo:similar · equivalente MCP: find_similar_logos
⛔ OPERACIÓN FUTURA, todavía no disponible. «Dame las marcas cuyo logo se parece a esta imagen» está
declarada en el contrato —su entrada y la forma de su salida— para que podáis programar contra ella,
pero hoy no tiene procedimiento: con una imagen válida y el permiso responde siempre 503
image_similarity_not_available, nunca resultados. Cuando exista, lo anunciará una entrada nueva del
changelog del contrato.
curl -sS -X POST "$TARNO_BASE_URL/logos/similar" \
-H "X-API-Key: $TARNO_API_KEY" -H "Content-Type: application/json" \
-d "{\"image\": {\"mediaType\": \"image/png\", \"dataBase64\": \"$(base64 < logo.png | tr -d '\n')\"}, \"niceClasses\": [25], \"limit\": 20}"
{
"type": "https://api.tarno.cl/problems/image_similarity_not_available",
"title": "Service unavailable",
"status": 503,
"detail": "Image similarity search is a declared future operation and is not available on this server yet.",
"code": "image_similarity_not_available",
"requestId": "…"
}
La entrada: image {mediaType, dataBase64} —la misma que en analyze_logo: PNG, JPEG,
GIF o WebP en base64, comprobado por la cabecera, hasta 700 KB y 2.000 px por lado, nunca una URL—;
niceClasses (opcional, clases de Niza 1..45: sólo marcas con alguna de ellas) y limit (opcional,
1..50). La imagen se valida con la misma función que analyze_logo: una imagen mala es el mismo 400
invalid_image con el mismo reason. No se guarda ni se registra.
La salida futura (hoy no se emite), en el sobre de colección de siempre:
results[]:applicationNumber,denomination,niceClasses,signType,imageUrl,scoreysignals.visual(entre 0 y 1) ymatchedBy: ["visual"]. Elscorees un parecido visual: una señal, nunca una opinión sobre si la marca se puede registrar o si choca con otra.meta:dataAsOf,model {name, dimensions, embeddedAt},coverage {trademarksWithImage, trademarksEmbedded, asOf}(qué parte del corpus pudo ver la búsqueda: una marca fuera de ella no es «sin parecido»),disclaimer(tres idiomas) eimage {mediaType, width, height, bytes, sha256}.
Bordes hoy:
| estado | code |
cuándo |
|---|---|---|
400 |
invalid_image |
la misma validación de la imagen que analyze_logo (reason dice cuál) |
400 |
validation_error |
un campo de más (una url, p. ej.), clases fuera de 1..45 o limit fuera de 1..50 |
403 |
forbidden |
la clave no tiene logo:similar |
503 |
image_similarity_not_available |
siempre, con una imagen válida y el permiso. ⛔ No reintentéis: a diferencia de service_unavailable, no es una caída pasajera |
Diferencia con analyze_logo: analyze_logo describe una imagen con un modelo de un tercero y
propone códigos de Viena; find_similar_logos buscará en el corpus las marcas con un logo parecido.
Son permisos distintos: logo:analyze no abre logo:similar ni al revés.
Permiso: logo:similar, concedido explícitamente (ni una clave sin restricción, ni la de prueba,
ni reports:read, ni logo:analyze). ⚠ No se concede a ninguna clave mientras la operación no esté
disponible: no lo pidáis hasta su anuncio.