Saltar a contenido

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í, /docs es 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:

  • legalBasis cita 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).
  • term dice de dónde sale N. Con businessDays, term.source es caller y term.legalBasis es null: 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 — weekendDays son los sábados y domingos saltados; holidays los 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 (null si no declara ninguna). Ver la cobertura es finita.
  • todayChile, elapsed y businessDaysLeft — se evalúan hoy, en hora de Chile: elapsed es todayChile posterior a date; businessDaysLeft cuenta 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" }
}
  • anchor nombra la anotación de la resolución que ancla (annotationId) y dice cuál es con sectionCode: "024" (rechazo) o "444" (aceptación parcial; lo que se apela es la parte de la cobertura que no se aceptó). anchor.kind es rejection_notice en los dos casos. La fecha se audita con GET /annotations/{id}.
  • Cuando el 024 o el 444 es el movimiento resolutivo MÁS RECIENTE de la marca (la familia 024, 444, M6, M11, 664B, 662B, 484; entre un 024 y un 444 ancla el más reciente y, a igual fecha, gana el 024). Si no hay ninguno de los dos del que partir, no hay fecha y omitted[] 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_day o outside_holiday_calendar — los tres últimos valen igual para un 024 que para un 444. 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, 484 o un M6 sin 024 el mismo día, y antes hay un 024 o un 444, la fecha sí se da, calculada desde el más reciente de los dos, con caveat: "later_resolution_on_record" y laterResolutions[] (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 hito appeal_close en milestones[]. Sin aviso, caveat es null y laterResolutions es [].
  • appealObserved es 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, elapsed y businessDaysLeft se 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; sin brands:read, 403 antes 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
}
  • anchor nombra el acto (annotationId, sectionCode: 029, 911 o 912); manda el más reciente. anchor.kind es acceptance_notice (029) o finality_certificate (911, 912).
  • paymentObserved es el primer pago final (PAG04) que el corpus registra desde el ancla: un hecho, no un veredicto (no dice si fue en plazo, y null no dice que no se pagó).
  • Sin fecha, omitted[] trae kind: "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_day u outside_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" }
}
  • anchor nombra 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.
  • basis es derived cuando el corpus tiene, el mismo día, la notificación y la resolución, y estimated cuando falta una de las dos; estimateReasons dice cuál se dedujo (notification_inferred_from_resolution_date o transfer_resolution_not_in_corpus) y es [] cuando es derived. Mostrad un estimated como estimación.
  • answerObserved es la primera contestación (OPO05) que el corpus registra desde el ancla: un hecho, no un veredicto (no dice si fue en plazo, y null no dice que no se contestó).
  • Sin fecha, omitted[] trae kind: "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_day u outside_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) o renewal.
  • Exactamente uno de niceClassCount (1–45) o applicationNumber (se cuentan sus clases).
  • on: la fecha de pago (hoy en Chile por defecto). utmMonth: el mes de la UTM (por defecto, el de on); si aún no está publicada se usa la última anterior y utm.basis lo 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, o not_due si 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». surchargeMonth es 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 en renewal.surchargeDoubt (con las notas literales) y la fila lleva subjectToDoubt: 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 lleva false), pero no bloquea el total.
  • Pasada la gracia (lapsed): el plazo del art. 24 para ese vencimiento pasó; lines vacío y total null con totalOmittedReason: "lapsed".
  • Renovación ya concedida, vencimiento aún sin actualizar (renewed_expiry_pending, antes o después del vencimiento): lines vacío y total null con totalOmittedReason: "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, withdrawnShare y annulledShare con el mismo denominador. Si decided = 0, los cuatro son null, nunca 0.
  • definition trae 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 en period con defaulted. filedFromYear > filedToYear ⇒ 400 invalid_range; clase fuera de 1–45 ⇒ 400 validation_error.
  • La población (population.filed, el n): 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, grantShare y demás cocientes, null sin decididas).
  • El tiempo hasta el registro (timeToRegistration): los percentiles p25/p50/p75 en días de las marcas con fecha de registro, con su n y 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 su coverageNote.

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. niceClass con un número es un 400; 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; spa sólo como última palabra y nunca en las clases 3 ni 44. Nunca mas, plus, pro ni letras sueltas.
  • corpus_frequency — el vocabulario del sector: la palabra está en al menos max(50, 0,75 % de las marcas de la clase) (count, classSize, threshold), contado en el índice del motor con tope. Así clinica en la 44 o hotel en 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 son null y 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.pendingEmbeddings dice 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.

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, score y signals.visual (entre 0 y 1) y matchedBy: ["visual"]. El score es 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) e image {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.