Saltar a contenido

Changelog del contrato

Cada cambio de la API REST (https://api.tarno.cl) y del servidor MCP (https://mcp.tarno.cl) de Tarno, del 2026-09-17 en adelante, el más reciente primero. REST y MCP son un solo contrato: una ruta y su herramienta gemela (GET /trademarks ≡ search_trademarks) cambian juntas, y cada entrada nombra las dos.

El contrato no lleva versión en la URL: este registro es la versión (ver Versionado y deprecación). El esquema campo a campo vive en la referencia OpenAPI en vivo, https://api.tarno.cl/docs.

Cómo leer una entrada

### fecha · [ETIQUETA] resumen, qué cambió y qué tienes que hacer. Las etiquetas:

etiqueta significado qué tienes que hacer
[BREAK] ruptura: se retira, renombra o cambia de tipo una ruta, un campo, un parámetro o una herramienta cambiar tu código antes de que te afecte; la entrada dice cómo
[BEH] comportamiento: misma forma, otros valores o semántica releer la documentación del campo; tu código sigue compilando
[ADD] adición: una ruta, una herramienta, un campo o un parámetro opcional nuevos nada, salvo ignorar los campos que no conozcas
[FIX] corrección de un fallo, sin cambiar la forma nada
[DATA] se movió el propio corpus (una recuperación, un relleno, una serie corregida) repetir cualquier medición que dependiera de las cifras anteriores
[WITHDRAWN] una entrada anunciada y retirada antes de salir: el contrato no se movió nada

Los cambios internos, sin efecto visible para un cliente, no aparecen aquí.

Noviembre de 2026

2026-11-15 · [BEH] Ficha de la marca: procedureHistory[] ordena los pasos del mismo día según el flujo del procedimiento de INAPI

GET /trademarks/{applicationNumber} ≡ get_trademark.

  • Dentro de un mismo día, las entradas siguen ahora el lugar que ocupa cada código de sección en el flujo del procedimiento de INAPI (por ejemplo, la aceptación a trámite 009 antes que el pago de publicación 439, la concesión 158 antes que el título 1230). Ese lugar se ha aprendido de los índices del expediente de INAPI.
  • Los códigos sin un lugar conocido van detrás de los que lo tienen, y el resto de empates siguen el orden de grabación, como antes.
  • El orden entre fechas distintas no cambia, y las entradas y sus campos tampoco.
  • Medido sobre 1.345 días con varios pasos de 770 expedientes: el nuevo orden por sí solo reproduce el de INAPI en el 71,2 % de los días y lo contradice en el 7,4 %; el resto son empates que decide el orden de grabación. INAPI no publica la posición de cada fila, así que algún día puede seguir saliendo en otro orden.

Qué hacer: nada si muestras la lista tal cual. No la reordenes por annotationId: perderías este orden. Si comparabas el orden con el índice de INAPI, vuelve a medirlo.

2026-11-15 · [DATA] Titulares: 601 titulares anteriores sin RUT retirados en 566 marcas tras su transferencia total (A07T)

Las mismas rutas y herramientas que la entrada anterior sobre titulares y A07T. La forma no cambia.

  • Aplicado el 2026-11-15 a las 18:41 UTC: 601 titulares sin RUT retirados en 566 marcas, cada uno con retiredBy: {kind: "section", section: "A07T"} y retiredOn = la fecha de la última A07T de su marca. Salen de holders y aparecen entre los titulares anteriores.
  • Medición posterior: 0 pendientes en esa población.
  • Quedan fuera: 12 marcas con un titular de nombre gemelo, 77 sin relectura tras la A07T y 13.373 sin A07T. Las 77 se corrigen en su próxima lectura.
  • Caso de control: la marca 1292017.
  • Ninguna petición a INAPI.

Qué hacer: repite cualquier medición que dependa de los titulares vigentes (cifras por titular, cartera de una parte, relaciones de cotitularidad).

2026-11-15 · [BEH] Ficha de la marca: procedureHistory[] separa los pasos del mismo día por su número de escrito y repite los idénticos

GET /trademarks/{applicationNumber} ≡ get_trademark.

  • Dos pasos del mismo día y del mismo código que INAPI distingue solo por el número de escrito que imprime (reference, como C/2023/…) son ahora dos entradas. Antes se mostraba una.
  • Un paso que INAPI lista varias veces igual el mismo día, sin texto ni número que lo distinga, sale tantas veces como lo lista. Todas las copias llevan el mismo annotationId.
  • Parte de la historia se guardó antes de este cambio. En ella, esos pasos salen una sola vez hasta que se recuperan o se vuelve a leer la marca.
  • Las marcas del Protocolo de Madrid no tienen la fila «Expediente inicial (*)» del índice del expediente: la ficha pública de INAPI no la publica, y no se inventa.

Qué hacer: no uses annotationId como clave única dentro de procedureHistory[] (usa la posición). Si comparabas el número de entradas con el índice de INAPI, cuenta con más entradas en los días con varios escritos del mismo código.

2026-11-15 · [BEH] Titulares: tras una transferencia total (A07T), el titular anterior sin RUT deja de ser titular actual

GET /trademarks/{applicationNumber} ≡ get_trademark y las lecturas por vigencia de una parte (GET /parties/{id}/trademarks ≡ list_party_trademarks, GET /parties/{id}/outcomes ≡ get_party_outcomes, GET /parties/{id}/relations ≡ list_party_relations y el filtro por parte de la búsqueda de marcas). Misma forma.

Cuando una marca tiene una transferencia total (A07T) y la ficha de la marca en INAPI, leída con todos sus titulares, ya no nombra a un titular que no tiene RUT (ni por su nombre), ese titular deja de ser actual: sale de holders y aparece entre los titulares anteriores con retiredBy: {kind: "section", section: "A07T"} y retiredOn = la fecha de la última A07T. En las relaciones pasa a ser una arista assigned_to hacia el titular que queda, no un co_holder. Sólo si queda como titular actual alguien que esa lectura nombra; sin A07T, con una transferencia parcial (A07P) o con nombres que coinciden, nada cambia. Se aplica en la siguiente lectura de cada marca; las marcas ya releídas tendrán una entrada aparte con la fecha y las cifras.

Qué hacer: nada si lees holders. Si contabas cotitulares de una marca transferida, deja de contar al titular anterior sin RUT.

2026-11-15 · [BEH] Ficha de la marca: procedureHistory[] reproduce el índice del expediente de INAPI

GET /trademarks/{applicationNumber} ≡ get_trademark. Hasta ahora procedureHistory[] traía sólo los pasos de la tabla de trámites. El índice del expediente de INAPI los mezcla por fecha con las anotaciones numeradas («Anotación de … N°: n», «[N°Anotación:n] Resolución …»), y ahora procedureHistory[] también.

  • Entran las anotaciones numeradas de la ficha (presentaciones como una transferencia o una renovación, y las resoluciones sobre ellas), en orden de fecha entre los pasos.
  • Una presentación que INAPI lista como paso y como anotación numerada sale una sola vez, como la anotación numerada: su annotationId es el de esa fila. Se empareja una a una por fecha y código, así que dos presentaciones del mismo código el mismo día son dos entradas. Si la anotación no trae reference, toma la del paso.
  • El criterio de orden no cambia: fecha y, dentro del mismo día, el orden en que se registraron las filas.
  • annotations[] no cambia.

Qué hacer: si componías el índice uniendo procedureHistory[] y annotations[], deja de hacerlo: saldrían filas repetidas. Si contabas entradas o guardabas el annotationId de una presentación, cuenta con más entradas y con el annotationId de la anotación numerada.

2026-11-15 · [ADD] Ficha de la marca: annotationNumber en cada entrada de procedureHistory[]

GET /trademarks/{applicationNumber} ≡ get_trademark. Cada entrada de procedureHistory[] lleva annotationNumber (entero o null): el número de anotación de INAPI de esa fila, el que se cita en un escrito. Es null en un paso de la tabla de trámites y en una anotación guardada sin su número (falta en parte de la historia).

Qué hacer: nada. Úsalo para mostrar «N°» junto a la fila, o ignóralo.

2026-11-15 · [BEH] Leyendas de sección: OPO16 con su nombre de INAPI, y 449 y 678 sin cortar

Cambia el texto de tres códigos de sección, en todas sus filas: sectionName, procedureHistory[].inapiText, la etiqueta en castellano (sectionLabel, actLabel) y GET /sections ≡ list_sections, igual por REST y por MCP. OPO16 pasa de «Oposición - Pruebas oponente» (el nombre de OPO12, que se le había atribuido por error) a «Oposición - Solicita se cite a oir sentencia», como lo imprime INAPI, y deja de compartir etiqueta con OPO12. 449 pasa de «Resolución de abando» a «Resolución de abandono» y 678 de «… del CPC en oposició» a «… del CPC en oposición»: una de las publicaciones de INAPI los corta y las otras los imprimen enteros. La familia de los tres no cambia. La descripción de inapiText aclara que es la grafía de referencia del código, no la de cada fila: INAPI puede imprimir el mismo código con un prefijo de procedencia («(automático)») o con otra abreviatura.

Qué hacer: si comparabas o guardabas estos textos, usa los nuevos. Mejor aún, compara por code/seccion, no por el texto.

2026-11-13 · [BEH] Filtros de marcas: denomination admite hasta 512 caracteres

El tope de denomination en GET /trademarks, POST /trademarks/search y search_trademarks (y en las estadísticas, la lista de números de solicitud, el calendario de renovación y portfolio.refine) sube de 256 a 512 caracteres. Hay denominaciones reales de más de 256 caracteres (la más larga, 304), y con 256 no se podían buscar enteras. q sigue en 256. Por encima de 512: 400 validation_error (too_big), igual por REST y por MCP.

Qué hacer: nada. Si recortabas denomination a 256 caracteres, ya no hace falta.

2026-11-13 · [BEH] Filtros de marcas: topes en los filtros de catálogo y de número

En GET /trademarks, POST /trademarks/search y search_trademarks (y en las estadísticas, la lista de números de solicitud, el calendario de renovación y portfolio.refine, que usan el mismo filtro), los filtros tienen ahora tope: niceClass hasta 45 valores; status hasta 14; signType hasta 14 valores de hasta 20 caracteres; denomination hasta 256 caracteres, como q; registrationNumber y cada número del lote applicationNumber hasta 17 caracteres. Pasarlo es un 400 validation_error (too_big), igual por REST y por MCP. Ningún valor que pueda casar con una marca queda fuera: los topes son el número de clases de Niza y de códigos de cada catálogo, el código más largo y el número más largo que acepta la forma de un número de INAPI.

Qué hacer: nada si envías valores reales. No repitas valores por encima del tope y recorta a 256 caracteres el texto de denomination.

2026-11-13 · [BEH] Horizonte de vigilancia y señales de registro: el texto ya no nombra la importación inicial

GET /system/vigilance-horizon ≡ get_vigilance_horizon: la rule conserva sólo las dos ramas reales (estado_diario exenta, el resto se conserva 2 meses); horizonDays sigue en 60. GET /trademarks/registration-signals ≡ get_registration_signals: la nota de la señal S5 dice que el recuento de oposición sale de las anotaciones de las fichas de expediente de INAPI o del Estado Diario. Sólo cambia el texto; ninguna cifra ni plazo cambia.

Qué hacer: si comparabas el texto de rule o de la nota S5, deja de hacerlo; usa horizonDays y los campos estructurados.

2026-11-12 · [BEH] Estadísticas de una clase: coverage.annotationSources[] lista dos fuentes

GET /nice-classes/{niceClass}/stats ≡ get_class_stats. La lista de fuentes de las anotaciones de coverage deja de incluir la importación inicial, que no es una fuente: sus anotaciones son de las fichas de expediente de INAPI o del Estado Diario. Quedan buscador y estado_diario, con su descripción de siempre, y la nota de la oposición (actsShare.opposition.coverageNote) dice que se cuenta por las anotaciones de las fichas de expediente de INAPI y del Estado Diario. Ninguna cifra cambia.

Qué hacer: si tenías una rama para legacy_mongo, quítala: ese valor de source ya no llega.

2026-11-11 · [BEH] Ficha de la marca: un paso de procedureHistory[] guardado dos veces sale una sola vez

GET /trademarks/{applicationNumber} ≡ get_trademark. INAPI devuelve algunos pasos de la tabla de trámites unas veces con su observación y otras sin ella, y cada versión quedaba guardada aparte: el mismo paso salía dos veces en procedureHistory[], con la misma fecha y el mismo código.

  • Ahora un paso sin observación que comparte fecha y código con un paso con observación se muestra una sola vez: el annotationId es el de la versión con observación y, si esa versión no lleva reference, se toma la de la otra.
  • Dos pasos con observaciones distintas siguen siendo dos pasos.
  • annotations[] no cambia: con dedupe=false siguen saliendo las dos versiones.
  • Los pasos nuevos ya no se guardan dos veces.

Qué hacer: nada. Si contabas los pasos de procedureHistory[], puede haber alguno menos.

2026-11-05 · [FIX] Descripciones de la referencia y de las herramientas MCP sin vocabulario interno

Las descripciones de la referencia de la API y de las herramientas MCP se han reescrito para decir qué significa cada señal (similitud de trigramas, distancia de edición, similitud fonética, similitud semántica con vectores de significado calculados por Tarno) en lugar de nombrar piezas internas del motor. El 400 por el parámetro retirado offset ya no cita códigos internos: su detail es ahora «offset was withdrawn from the contract: paginate with limit + cursor». Ningún campo, valor, tipo ni comportamiento cambia.

Qué hacer: nada, salvo que compares el texto de detail.

2026-11-05 · [BEH] Renovación: renewed_expiry_pending también antes del vencimiento, sin renewal_window_open

Seguimiento del cambio del mismo día. GET /trademarks/{applicationNumber} ≡ get_trademark, y el mismo renewalStatus en las colecciones, /insights, el informe de cartera, el calendario de renovación y calculate_fees. Una marca cuya renovación INAPI ya concedió, con el vencimiento publicado aún sin actualizar, salía en window_open y con el hito renewal_window_open mientras ese vencimiento no había pasado.

  • En cuanto la concesión de renovación (fechada desde el vencimiento − 6 meses) está registrada, renewalStatus es renewed_expiry_pending antes y después del vencimiento, en lugar de window_open.
  • Esas marcas no publican renewal_window_open (como ya no publicaban grace_end): no salen con milestoneKind=renewal_window_open ni en el calendario de renovación.
  • calculate_fees (renovación) tampoco tasa nada en ese estado antes del vencimiento: lines vacío, total null y totalOmittedReason: "renewed_expiry_pending".
  • not_due no cambia. Ningún valor nuevo.

Qué hacer: trata renewed_expiry_pending como «renovada» también cuando el vencimiento publicado aún no ha llegado: no muestres un aviso de vencimiento próximo para esas marcas.

2026-11-05 · [BREAK] Renovación: nuevo estado renewed_expiry_pending cuando la renovación ya está concedida y el vencimiento aún no se ha actualizado

GET /trademarks/{applicationNumber} ≡ get_trademark, y el mismo renewalStatus en las colecciones, /insights (groupBy=renewalStatus), el informe de cartera, el calendario de renovación y calculate_fees. Hay marcas cuya renovación INAPI ya concedió mientras el vencimiento publicado sigue siendo el anterior; hasta ahora salían en grace o lapsed y con grace_end, como si la renovación estuviera pendiente o el plazo hubiera pasado.

  • renewalStatus gana un quinto valor, renewed_expiry_pending: pasado el vencimiento publicado, la marca tiene una concesión de renovación (un renewals[] con kind: "grant") fechada desde ese vencimiento − 6 meses. Sustituye a grace y lapsed.
  • Esas marcas no publican grace_end: no salen con milestoneKind=grace_end ni en el calendario de renovación. renewal_window_open, not_due y window_open no cambian.
  • El filtro renewalStatus acepta el valor nuevo. calculate_fees (renovación) no tasa nada en ese estado: lines vacío, total null y totalOmittedReason: "renewed_expiry_pending".
  • Cuando el vencimiento se actualiza, la marca vuelve sola a la regla de siempre.

Qué hacer: si tu cliente tipa renewalStatus o totalOmittedReason, añade "renewed_expiry_pending". Léelo como «renovada; vencimiento pendiente de actualizar», no como «no renovó».

2026-11-05 · [ADD] Ficha de la marca: procedureHistory[], la tabla de trámites de INAPI con la referencia de cada paso

GET /trademarks/{applicationNumber} ≡ get_trademark. Campo nuevo, siempre presente ([] si no hay pasos), igual con dedupe o sin él y con cualquier expand: los pasos de la tabla de trámites que INAPI muestra para la solicitud en la ficha pública del expediente en INAPI, sin las filas del Estado Diario y sin la agrupación por hecho de annotations[].

  • Cada paso: annotationId (el mismo id que en annotations[]), date, code, inapiText (la leyenda de INAPI para ese código, la misma que sectionName) y reference, el número de resolución o de escrito que INAPI imprime en el paso (2026/82718, C/2026/123550, A/2026/1447).
  • reference es null cuando INAPI no imprime ninguno o el paso no se ha leído desde que se guarda: hoy lo es en la mayoría de los pasos históricos, y sólo se completa al volver a leer la marca o, en parte, con un relleno.
  • Las anotaciones de la ficha de expediente (transferencias, renovaciones, gravámenes…) se separan de los pasos sólo por el número de anotación de INAPI, que falta en buena parte de la historia: alguna puede aparecer como paso.
  • El orden es por fecha y, dentro del mismo día, por el orden en que se registraron los pasos: la posición de INAPI no se guarda.

Qué tienes que hacer: nada; ignóralo si no lo usas.

2026-11-05 · [BEH] renewal_window_open y calculate_fees.renewal.legalBasis citan también la Ley 19.880 art. 25, como grace_end

Seguimiento del cambio de grace_end del 2026-11-04. GET /trademarks/{applicationNumber} ≡ get_trademark, las colecciones, el calendario de renovación (GET/POST /trademarks/renewal-calendar ≡ get_renewal_calendar) y POST /fee-schedule/calculate ≡ calculate_fees. El hito grace_end ya citaba cuatro normas; ahora las tres fuentes del plazo de renovación (renewal_window_open, grace_end y renewal.legalBasis de la calculadora) citan las mismas cuatro, en el mismo orden: Ley 19.039 art. 24 (term), Decreto 82/2022 art. 27 (regulation), Código Civil art. 48 (computation) y {norm: "Ley 19.880", article: "25", role: "computation"}. Misma forma, un elemento más en la lista: las fechas, rule, anchor, basis y renewalStatus no cambian.

Qué hacer: si validas legalBasis de renewal_window_open o de renewal de la calculadora contra tres entradas fijas, admite la cuarta.

2026-11-05 · [BREAK] Ficha de marca: las resoluciones que no conceden una renovación salen ahora como kind: "outcome" en renewals[]

GET /trademarks/{applicationNumber} ≡ get_trademark. renewals[].kind tenía dos valores, request y grant, y todo acto que no era una concesión salía como request: las resoluciones que no conceden (abandono, desistimiento, rechazo, corrección…) de una solicitud de renovación aparecían como si fueran solicitudes nuevas, y una marca con una sola presentación podía mostrar cuatro «solicitudes».

  • kind gana un tercer valor, outcome: INAPI resuelve la solicitud sin concederla. Esos actos (la sección A4 del Estado Diario) dejan de ser request.
  • request sigue siendo la presentación y la solicitud observada y pendiente. grant no cambia. Ninguna entrada sale de la lista y lastRenewalOn no cambia.

Qué hacer: si tu cliente tipa kind como "request" | "grant", añade "outcome". Para contar solicitudes, cuenta sólo request; un outcome es el resultado de una solicitud, no una solicitud.

2026-11-04 · [BEH] Madrid: una designación concedida tras una cancelación de la OMPI recibida en trámite publica caducado

GET /trademarks/{applicationNumber} ≡ get_trademark y todas las colecciones. Misma forma. Cuando la OMPI comunicó la cancelación o la renuncia de un registro internacional (MAD01, DEATH) mientras la designación de Chile seguía en trámite, e INAPI la concedió después sin que ningún acto posterior la reviva (una renovación, una corrección, una nueva notificación de alta, un cese o una serie adicional del mismo número), la designación publica status: caducado, con statusInapi: "registrada" y statusStale: true, y el hito designation_ceased anclado en esa notificación (anchor.kind: "wipo_death", rule: "wipo_death_received_before_grant", la misma base legal que el cese). El filtro status, groupBy=status, las facetas, sort=status y liveOnly lo siguen. Hoy son cuatro designaciones. El texto de los avisos wipo_designation_ended y wipo_refused_recording ya no dice que el estado sea el que informa INAPI.

Qué hacer: nada en el código; si guardas el estado de marcas Madrid, vuelve a leerlas: alguna pasa de registrada a caducado.

2026-11-04 · [BEH] Anotaciones: la M11 y la fila del mismo acto que publica la ficha de expediente se agrupan en un solo hecho

GET /trademarks/{applicationNumber}?expand=annotations ≡ get_trademark, y las demás lecturas de anotaciones con dedupe. Misma forma. Una anotación M11 («Resoluciones Varias») con act (p. ej. 664B) y la fila que la ficha de expediente publica con ese mismo código de sección, la misma marca y el mismo día, antes salían como dos hechos sueltos (versionsOfFact: 1, sin duplicates[]). Ahora salen como uno: la M11 es la fila principal y la otra viaja en duplicates[], sin perder ninguna. Con dedupe=false siguen las dos filas, ahora con el mismo eventId. Se agrupan sólo los pares exactos (una M11 y una gemela por marca, día y acto); los casos ambiguos quedan como estaban.

Qué hacer: si agrupabas por eventId ?? id, nada; si contabas actos por fila, vuelve a contar (el recuento de actos baja en los pares agrupados).

2026-11-04 · [BREAK] El fin de la gracia de renovación se corre al primer día hábil si cae en sábado, domingo o feriado

GET /trademarks/{applicationNumber} ≡ get_trademark, cada marca de las colecciones (GET /trademarks ≡ search_trademarks, lotes, informes, cartera) y el calendario de renovación (GET/POST /trademarks/renewal-calendar ≡ get_renewal_calendar): el hito grace_end es el vencimiento + 6 meses y, si ese día es sábado, domingo o feriado, el primer día hábil siguiente (el mismo calendario que opposition_close). INAPI confirmó por escrito que la renovación presentada ese día hábil se tiene por presentada dentro de plazo. renewalStatus sigue en grace hasta ese día incluido (también el filtro renewalStatus y groupBy=renewalStatus), y POST /fee-schedule/calculate ≡ calculate_fees cobra ese día como 6.º mes, no como lapsed. El filtro milestoneKind=grace_end casa la fecha nueva y watchEndsOn de la vigilancia la sigue. Cambia la forma del hito:

  • rule pasa de "6_months_after_expiry" a "6_months_after_expiry_next_business_day";
  • legalBasis gana una cuarta norma: {norm: "Ley 19.880", article: "25", role: "computation"} (renewal_window_open y la calculadora siguen con tres);
  • desaparece reservation, y el código non_business_last_day_extended_by_office sale del vocabulario de reservation.code;
  • basis puede ser estimated, con estimateReasons: ["outside_holiday_calendar"], cuando la fecha cae después de la cobertura declarada del calendario de feriados (hoy, hasta el 2030-12-31): el día real es ése o posterior. Las filas del calendario de renovación pueden ser estimated por lo mismo.

Qué hacer: dejar de mostrar la reserva de grace_end y aceptar su ausencia; si comparas rule, usa el valor nuevo; si validas legalBasis, admite la cuarta norma; trata grace_end y las filas del calendario como derived o estimated (muestra el motivo, como en opposition_close); y quita non_business_last_day_extended_by_office de tu lista de códigos de reserva.

2026-11-04 · [FIX] Gravámenes: un alzamiento duplicado que INAPI desistió o rechazó ya no alza una carga

GET /trademarks/{applicationNumber}?expand=encumbrances ≡ get_trademark, y los informes que llevan encumbrances[]. Misma forma. Donde las resoluciones de INAPI llevan el número de anotación, cada presentación se resuelve por su número: un alzamiento presentado dos veces el mismo día cuyo duplicado se desistió o se rechazó cuenta una vez, y deja de dar por alzada (a veces con releaseAttributionCertain y releaseStatusCertain en true) una carga que sigue vigente. Una carga rechazada o abandonada por su número ya no sale vigente, y una inscrita por su número ya no sale abandonada. Si la resolución de inscripción de un alzamiento nombra una carga que no está vigente en la marca, lo que ese alzamiento cierre, y las demás cargas que pudo tomar, sale con releaseAttributionCertain: false y, salvo que todas las cargas del tipo estén alzadas, releaseStatusCertain: false.

Qué hacer: nada en el código; vuelve a leer los gravámenes que guardes: algunas cargas cambian de estado o de fecha de alzamiento.

2026-11-04 · [ADD] Feed de anotaciones: maxActAgeDays, un límite de antigüedad del acto

POST /annotations/search ≡ search_annotations: nuevo parámetro opcional maxActAgeDays (entero 0..3650). Sólo salen los actos que tenían como mucho N días cuando el corpus los conoció: su date no es anterior al día UTC de la detección menos N. Un acto fechado después de su detección pasa siempre; uno sin date, nunca. Exige detectedAfter y vale en el feed de todo el corpus y con applicationNumber o applicationNumbers. El orden, los cursores y meta.detectedThrough no cambian, y ninguna fila dentro del límite se salta ni se repite. En el feed, cada página lee un tramo acotado: puede traer menos de limit resultados, o ninguno, con next no nulo. Con dedupe, todo lo servido cumple también el límite contra su detectedAt.

Qué hacer: si lees el feed para avisar y descartas los actos antiguos en tu lado, pasa maxActAgeDays con tu ventana y sigue next hasta que sea nulo aunque una página venga vacía: una carga histórica de actos antiguos ya no tendrás que leerla para descartarla.

2026-11-03 · [BEH] Búsqueda y parecido: los canales que faltan se declaran, y un resultado parcial vacío es 503

GET /trademarks / POST /trademarks/search ≡ search_trademarks (con q, denomination, text configurado, similarTo o similarToTrademark) ; los informes que usan el motor de parecido (get_clearance_report, get_conflict_landscape, get_opposition_brief, get_registration_signals, get_filing_context) no llevan el campo nuevo, sólo el 503 de abajo. Nuevo campo opcional meta.degradedChannels: los canales de búsqueda (mismo vocabulario que matchedBy) que debían alimentar la página y no lo hicieron (fallaron, no respondieron a tiempo, o se dejaron fuera para que el recorrido con cursor siga con los canales de la primera página); ausente cuando corrieron todos. Con algún canal caído y sin resultados en los demás, la respuesta es ahora el 503 service_unavailable reintentable, nunca un 200 vacío. Una página siguiente cuyo canal de la primera está caído ahora, o una página que no se pudo leer entera, también es 503. En el informe de disponibilidad, el grupo fuzzy se omite si su canal falló, en vez de publicarse vacío.

Qué hacer: tratar el 503 de la búsqueda como reintentable; si quieres, mostrar un aviso cuando venga meta.degradedChannels.

2026-11-03 · [BEH] MCP: argumentos inválidos sin coste y con error Problem Details; leer un recurso gasta cuota

Una llamada a una herramienta MCP cuyos argumentos no cumplen el esquema ya no gasta cuota ni límite de ráfaga (como un 400 en REST), y su error llega en el mismo cuerpo que los demás errores: status: 400, code: "validation_error" y errors[] por campo, en vez del texto plano «Input validation error: …». Leer un recurso con ruta REST gemela (resources/read de iris://catalogs/sections, nice-classes y holidays/{year}) gasta ahora una unidad de cuota y de ráfaga, como su ruta REST gemela (GET /sections, GET /nice-classes, GET /holidays); con la cuota agotada responde 429 quota_exceeded. Listar recursos sigue sin coste.

Qué hacer: si leías el texto del error de validación MCP, lee el JSON (code, errors[]); cuenta las lecturas de recursos en tu consumo.

2026-11-02 · [BEH] Informes compuestos: hasta 2 a la vez; el exceso puede recibir 503 reintentable

GET /reports/clearance ≡ get_clearance_report, GET /reports/portfolio ≡ get_portfolio_report, GET /reports/opposition-brief ≡ get_opposition_brief, y las dos operaciones que ejecutan uno de ellos por dentro (GET /reports/registration-signals ≡ get_registration_signals y GET /reports/filing-context ≡ get_filing_context con type=opposition) se atienden de dos en dos; el resto espera su turno como mucho 10 s y, si no le llega, responde el 503 service_unavailable ya declarado (con la cola llena, al instante). Las agregaciones de GET /insights/trademarks ≡ get_trademark_insights y las facetas del listado sin texto pueden servirse desde una copia de hasta 10 minutos, que se renueva en cuanto se actualiza el corpus (dataAsOf). Las formas y los valores no cambian.

Qué hacer: tratar el 503 de estos informes como reintentable, con espera creciente.

2026-11-02 · [BEH] MCP: sólo acepta POST (los demás métodos dan 405)

El servidor MCP habla JSON-RPC sólo por POST. Cualquier otro método (GET con Accept: text/event-stream, DELETE…) responde ahora 405 Method Not Allowed con Allow: POST y el cuerpo de error estándar (code: method_not_allowed); /health y /metrics no cambian. Una llamada tools/call con un nombre que no es una herramienta registrada devuelve siempre un error JSON-RPC.

Qué hacer: nada si usas un cliente MCP estándar: trata el 405 como «el servidor no ofrece stream» y sigue por POST.

Octubre de 2026

2026-10-29 · [BEH] renewalStatus: "grace" dice ahora que el registro sigue vigente

renewalStatus (en el expediente, cada marca de la colección, la búsqueda, el lote, la similitud, la ventana, las marcas de una parte y los informes ≡ get_trademark, search_trademarks…) no cambia de forma ni de valores, ni de regla: una marca en la gracia sigue diciendo grace. Cambia lo que grace significa: hasta hoy la documentación decía que no afirmaba el estado del registro; desde hoy grace = vigente, en plazo de gracia de renovación. El registro caduca por falta de renovación sólo si la gracia vence sin que se pida la renovación (Ley 19.039 art. 24 inc. 2º); lo renovado rige desde el vencimiento, sin hueco (Decreto 82/2022, art. 27 inc. 2º); la caducidad no es retroactiva (Directrices de INAPI, cap. 23). INAPI cita los registros en gracia como obstáculo del art. 20 h igual que los vigentes. La etiqueta de groupBy=renewalStatus (GET|POST /insights/trademarks ≡ get_trademark_insights) y de byRenewalStatus de la cartera pasa de «En plazo de gracia» a «Vigente, en plazo de gracia de renovación» (en: «In force, in renewal grace period»; pt: «Em vigor, em período de graça de renovação»). lapsed sigue sin afirmar que no se pidiera la renovación. Ver Hitos.

Qué hacer: si mostrabas grace como «estado incierto» o «expirada pero renovable», muéstralo como vigente con la renovación pendiente; si comparabas la etiqueta literal, acepta la nueva.

2026-10-28 · [BEH] Ficha e informe de una marca: clave nueva notices[], avisos comprobados en el expediente y en el registro de la OMPI

GET /trademarks/{applicationNumber} ≡ get_trademark y el informe de la marca: una clave opcional nueva, notices[], con hechos comprobados a mano en el expediente de INAPI y en el Registro Internacional de la OMPI que las fuentes públicas no traen. Dos tipos: wipo_designation_ended, la OMPI inscribió en el Registro Internacional que Chile ya no está designado, y wipo_refused_recording, la OMPI no inscribió la declaración de concesión de protección de INAPI porque Chile no figura entre las Partes Contratantes designadas (éste no lleva cause; su source es el aviso de rechazo de la OMPI).

  • Forma: kind, date (la fecha de la inscripción), cause (renunciation, cancellation, dependency —cancelación por dependencia de la marca de base, art. 6.4 del Protocolo de Madrid—, non_renewal), label (el aviso en es-CL, en y pt-BR), source —la fuente principal: la inscripción de la OMPI, con reference (RNN/2024/11), recordedOn, internationalRegistrationNumber y madridMonitorUrl (el enlace a Madrid Monitor)— y corroboration —el respaldo: el documento del expediente de INAPI, con documentIndex (su posición en el índice), label y date—.
  • Un aviso no cambia nada más: status, statusInapi, statusStale y milestones[] siguen diciendo lo que dice INAPI.
  • La clave se omite (no viaja como [] ni null) en toda marca sin aviso: el resto de las respuestas no cambia.

Qué hacer: si muestras la ficha de una marca, muestra también sus notices junto al estado, con su fuente.

2026-10-28 · [DATA] Tres designaciones Madrid tendrán avisos en notices[] (pendiente)

Pendiente. Las marcas 991718309, 991888075 y 991725022 traerán en notices[] el aviso de que la OMPI inscribió que Chile ya no está designado: 991718309 renuncia RNN/2024/11 (2024-02-15), 991888075 renuncia RNN/2026/19 (2026-04-28) y 991725022 cancelación por dependencia CBN/2025/15 (2025-04-11). 991888075 traerá además wipo_refused_recording: la OMPI no inscribió la concesión de Chile (GP-I/2135499301/BB, 2026-08-18). Su status sigue siendo registrada. Una entrada aparte dará la fecha.

Qué hacer: nada; si guardas copia de la ficha de esas marcas, refréscala cuando anunciemos la entrada.

2026-10-28 · [BEH] Personas: kindSource tiene un valor nuevo, name_pattern

GET /parties ≡ list_parties, GET /parties/{id} ≡ get_party y cada parte embebida en una marca. La forma no cambia; kindSource admite un cuarto valor.

  • name_pattern: el kind (natural o legal) se dedujo de la forma de un nombre que no lleva ni RUT ni sufijo societario (palabras de nombres de persona, o palabras societarias como SOCIEDAD, FUNDACION, GROUP). Es una deducción calibrada contra las partes cuyo tipo fija su RUT, y sólo se aplica donde el límite inferior de Wilson de su acierto es ≥ 98 %.
  • Un RUT que llegue después la sustituye por tax_id.
  • Pendiente: hoy ninguna parte lo lleva. Cuando se aplique la clasificación, decenas de miles de partes que hoy son kind: unknown pasarán a natural o legal. Una entrada aparte dará la fecha y las cifras.

Qué hacer: si validas kindSource contra una lista cerrada, añade name_pattern. Si necesitas certeza sobre el tipo, exige kindSource: tax_id.

2026-10-28 · [BEH] Personas: el RUT propio de una persona ya no entra en su name

GET /parties ≡ list_parties, GET /parties/{id} ≡ get_party y cada parte embebida en una marca. La forma no cambia; name ya admitía null.

  • INAPI imprime a veces un RUT en la casilla del nombre del solicitante. Desde hoy, el RUT propio de la persona (el que lleva como taxId) no entra en name: un nombre que era sólo ese RUT queda en null, y uno con más texto conserva el texto. publishedName sigue siendo el texto de INAPI, con el RUT.
  • Una fila cuyo nombre es sólo un RUT casa con la parte de la marca que lleva ese RUT; si es de titular y la marca ya tiene una empresa como titular vigente, no crea una parte nueva (era la empresa con el RUT de su representante en la casilla del nombre).
  • Las listas de nombres del resumen de una marca (holders, representatives, formerHolders, formerRepresentatives) dejan fuera a la parte sin nombre en vez de devolver una cadena vacía.
  • Pendiente: unas 70 partes que hoy tienen un RUT como nombre cambiarán de name (las empresas toman la razón social de su RUT), 2 se fundirán con la parte que lleva su RUT, y se retirarán 39 titularidades falsas de 31 partes «RUT» (esas marcas conservan a la empresa como titular). Una entrada aparte dará la fecha y las cifras.

Qué hacer: si mostrabas name, muestra publishedName cuando name sea null.

2026-10-28 · [BEH] Estado Diario, boletín de tipo 5: una anotación D5A nueva lleva la fecha del acto, no la del boletín

Sección D5A (actos sobre marcas inscritas): annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin. La forma no cambia; cambia lo que significa date en esta sección.

  • La regla. La fecha (date) de una anotación D5A es la del acto, la que le da la ficha de expediente de INAPI, y no la del boletín que la imprimió. INAPI imprime a veces en el boletín de tipo 5 los actos de 1 a 4 días antes: 31 boletines entre el 2025-05-22 y el 2026-09-22, y sigue pasando (medido el 2026-10-28).
  • Desde hoy, cuando la ficha de expediente ya tiene el número de anotación del acto para esa marca, con una fecha anterior al boletín, la fila nueva lleva esa fecha. Si no, lleva la del boletín, como hasta ahora. Un acto impreso en el boletín del día B puede salir con fecha B−1 … B−4. Un acto ya guardado no se escribe dos veces.
  • get_daily_bulletin del día B lista los D5A con fecha B; la fila altas de la cobertura sigue contando lo que publicó ese boletín, así que en esos días pueden no coincidir. Es esperado, no un hueco.

Qué hacer: si agrupas o cuentas actos D5A por fecha, ten en cuenta que la fecha es la del acto.

2026-10-28 · [DATA] Estado Diario, boletín de tipo 5: 2.281 anotaciones D5A pasarán a la fecha de su acto (pendiente)

Sección D5A: las mismas rutas y herramientas que la entrada anterior. La forma no cambia.

  • Pendiente. 2.281 anotaciones D5A ya existentes de esos 31 boletines pasarán a la fecha de su acto, de 1 a 4 días antes (sólo cambia date). Sólo las que la ficha de expediente fecha sin duda; las demás se quedan como están hasta que la ficha de expediente las feche. No se generará ningún movimiento ni ningún aviso de vigilancia. Una entrada aparte dará la fecha y las cifras reales.

Qué hacer: repite cualquier cuenta de actos D5A por fecha cuando anunciemos la entrada.

2026-10-28 · [BREAK] Madrid: el cese de INAPI tras una notificación DEATH de la OMPI publica caducado y el hito designation_ceased

GET /trademarks/{applicationNumber} ≡ get_trademark y cada marca de las colecciones (GET /trademarks ≡ search_trademarks, lotes, informes): una designación Madrid que INAPI dio por cesada después de una notificación DEATH de la OMPI —cese 1238 (renuncia a Chile), 1240 (cancelación), 1241 (falta de renovación) o 1242 (dependencia de la marca de base), posterior a la última notificación DEATH y a la última PROLONG, sin inscripción del registro posterior— publica ahora status: caducado, con el estado literal de INAPI en statusInapi (hoy, denegada) y statusStale: true. El 1237 (cesión parcial: la protección sigue en la serie nueva) no cuenta. El filtro status=, groupBy=status, las facetas, sort=status y liveOnly siguen la misma regla. La marca trae además un hito nuevo, designation_ceased: basis: "derived", date = anchor.date, anchor {kind: "office_cessation", date, annotationId, sectionCode} (el acto de cese), rule: "office_cessation_after_wipo_death" y legalBasis Protocolo de Madrid arts. 6.3, 6.4 y 9 bis y Reglamento Común reglas 25 y 27, con el papel nuevo extinction. No es filtrable. Es ruptura sólo para un cliente con listas cerradas: crecen milestones[].kind y legalBasis[].role. Afecta hoy a unas 160 marcas Madrid. Ver Hitos.

Qué hacer: aceptar designation_ceased y extinction en tus tipos; si contabas esas marcas como denegada, ahora salen caducado (statusInapi conserva el valor de INAPI).

2026-10-28 · [BREAK] La sobretasa de renovación tardía se calcula con la tabla de las Directrices 2026: el total ya no es null en la gracia

POST /fee-schedule/calculate ≡ calculate_fees: en una renovación pagada dentro de la gracia (renewal.renewalStatus: "grace"), la fila del mes de la tabla de la sobretasa de las Directrices 2026 de INAPI (cap. 13; cap. 23 §42: 1.er mes 6 UTM, hasta 12 UTM en el 6.º, por clase) se aplica como regla vigente y el total se calcula: totalUtm y totalClp traen la cifra y totalOmittedReason es null (antes, null con "surcharge_doubt"). Ejemplo: 3 clases pagadas un día después del vencimiento ⇒ totalUtm: 18; en el 2.º mes, 21,6; en el 6.º, 36. Campo nuevo renewal.surchargeRuleSource: "Directrices 2026"; renewal.ruleIsOpenQuestion pasa a false; totalOmittedReason sólo puede valer ya "lapsed". La discrepancia con la nota «(*)» y con otras publicaciones de tasas de INAPI sigue publicándose, como nota informativa que no bloquea: surchargeDoubt (en GET /fee-schedule ≡ get_fee_schedule y en renewal) conserva su nombre y sus notes[] literales, y su description dice ahora cuál es la regla. subjectToDoubt y hasDoubt conservan sus valores. Ver costos oficiales y la nota del recargo.

Qué hacer: mostrar el total también en la gracia, citando la fuente (surchargeRuleSource) y la nota; si tratabas totalOmittedReason: "surcharge_doubt", ese caso ya no llega.

2026-10-28 · [BEH] RUT de las personas naturales: el servicio puede publicarlo ofuscado (hoy, entero)

El RUT de las personas naturales se sigue publicando entero y se sigue pudiendo buscar por él: hoy no cambia nada. Lo nuevo es que el servicio puede pasar a otro modo, que avisaremos con antelación, y en el que:

  • el taxId de una parte cuyo kind no es legal (natural, y también unknown por prudencia) viaja ofuscado: *** más los 3 últimos dígitos del cuerpo y el dígito verificador (12345678-5 → ***678-5). El * nunca aparece en un RUT real. Las personas jurídicas no cambian. Afecta a las partes de GET /parties ≡ list_parties, GET /parties/{id} ≡ get_party, GET /trademarks/{applicationNumber} ≡ get_trademark, las relaciones, la cartera, los escritos de oposición y el expediente de un escrito;
  • el filtro taxId (partes, marcas y anotaciones) sólo encuentra personas jurídicas: el RUT de una persona natural devuelve una respuesta vacía, no un error;
  • el meta de toda colección trae naturalPersonTaxId: "masked" (y GET /trademarks/application-numbers ≡ list_application_numbers, que no tiene meta, la trae en el primer nivel). Mientras esa clave no aparezca, nada cambia.

Qué hacer: nada hoy. Para estar listo: tratar un taxId con * como ofuscado (mostrarlo tal cual, sin validar su dígito verificador ni usarlo como clave o filtro); identificar a una parte por su id, nunca por su taxId.

2026-10-28 · [DATA] Estado Diario, boletín de tipo 5: 210 actos D5A del 2024-11-13 y del 2025-01-06, y ocho días sin boletín propio (origin: not_published)

Sección D5A (actos sobre marcas inscritas): annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin; y GET /system/coverage ≡ get_system_coverage. La forma no cambia.

  • Desde hoy, el lector lee los boletines que imprimen el número de registro de cada acto en una línea propia, encima de la fila (eran las 211 filas «sin columna de registro»), y comprueba la marca por el número de anotación de INAPI (annotationNumber): si el número y el registro dicen marcas distintas, la fila no se escribe. Para un boletín impreso de la forma habitual no cambia nada.
  • Pendiente. Entrarán 210 actos D5A (100 con fecha 2024-11-13 y 110 con fecha 2025-01-06), cada uno en su marca, comprobada por el número de anotación y por el registro (medido el 2026-10-28: 210 de 210 coinciden). Esos dos días ganarán su fila altas en la cobertura. Una fila del 2026-09-24, sin registro impreso, sigue fuera.
  • Pendiente. Ocho días en que INAPI no publicó un boletín de tipo 5 propio (el PDF de ese día repite uno anterior, o no existe) tendrán su fila altas con acts: 0 y el valor nuevo de origin not_published: 2024-05-29, 2025-05-16, 2025-06-16, 2025-08-13, 2025-10-01, 2025-10-09, 2025-10-23 y 2025-10-30. No se añade ninguna anotación: los actos de esos días ya están, por la ficha de expediente.
  • Las filas nuevas llevarán como fecha de detección (detectedAfter) el día en que entren. No se generará ningún movimiento ni ningún aviso de vigilancia. Una entrada aparte dará la fecha y las cifras reales.

Qué hacer: si lees origin de la cobertura, acepta not_published (un día sin boletín propio, no un hueco de la ingesta). Cuando anunciemos la entrada, repite cualquier cuenta de actos D5A o de días altas.

2026-10-28 · [BEH] El fin de la gracia de renovación lleva su reserva: grace_end con reservation

GET /trademarks/{applicationNumber} ≡ get_trademark y cada marca de las colecciones (GET /trademarks ≡ search_trademarks, lotes, informes): el hito grace_end (vencimiento + 6 meses, Ley 19.039 art. 24) trae ahora reservation, con el código nuevo non_business_last_day_extended_by_office y su texto en español, inglés y portugués. La fecha no cambia: es el vencimiento más seis meses exactos y no se corre cuando cae en sábado, domingo o feriado. La reserva dice que INAPI ha admitido desde octubre de 2024 la renovación presentada el primer día hábil siguiente (Ley 19.880, art. 25 inc. 3º), de modo que la fecha publicada es el último día seguro, no el último día posible. Misma forma: reservation ya existía en grant_fee_close; reservation.code gana un valor. También en el calendario de renovación (GET/POST /trademarks/renewal-calendar ≡ get_renewal_calendar): cada fila grace_end trae la reserva (las filas renewal_window_open, no). Ver Hitos.

Qué hacer: mostrar la fecha de grace_end con su reserva, como la de grant_fee_close; si validas reservation.code contra una lista cerrada, añade el valor nuevo.

2026-10-28 · [FIX] Documentación: el ancla de opposition_close es la última publicación del extracto

Sólo documentación: ningún valor cambia. Cuando INAPI deja sin efecto la publicación de un extracto y lo republica, cuenta los 30 días hábiles de oposición desde la última publicación, y ésa es la fecha que publica como fecha de publicación de la marca. opposition_close ≡ oppositionWindow.deadline ya se anclan en ella (anchor.date); la tabla de hitos ahora lo dice.

Qué hacer: nada; si calculabas tú el cierre desde la primera publicación, usa anchor.date del hito.

2026-10-26 · [BREAK] La fecha en que se resolvió la solicitud: el hito resolution en milestones[]

GET /trademarks/{applicationNumber} ≡ get_trademark y cada marca de las colecciones (GET /trademarks ≡ search_trademarks, lotes, búsquedas) traen un tipo de hito nuevo, resolution: la fecha del acto con que INAPI aceptó o rechazó la solicitud (no es un plazo). basis: "derived", date = anchor.date, anchor {kind: "acceptance" | "rejection", date, annotationId, sectionCode}, rule: "latest_acceptance_or_rejection" y legalBasis Ley 19.039 art. 13 con el papel nuevo notification (la resolución se notifica por el Estado Diario). Cuenta el acto de aceptación o rechazo más reciente, incluidos los que cumplen un fallo del TDPI que otorga el registro. No sale si la solicitud no llegó a resolverse (p. ej. 428 «tener por no presentada»), si un acto posterior del TDPI la altera sin decir hacia dónde, o en un expediente de renovación. No es filtrable. Es ruptura sólo para un cliente con listas cerradas: crecen milestones[].kind y legalBasis[].role. Ver Hitos.

Qué hacer: aceptar resolution y notification en tus tipos; si fechabas tú la resolución de una solicitud, lee el hito.

2026-10-26 · [BEH] MCP: explain_section_code explica tres códigos más

Sólo MCP. explain_section_code explica ahora 33 códigos: se suman 428 (resolución de tener por no presentada una solicitud cuyo extracto no se publicó en plazo; termina el procedimiento sin aceptarla ni rechazarla), 961 (concesión de una renovación pre-aprobada, usada de 2014 a 2017, sin resolución de aceptación previa) y W231 (aceptación de una renovación en la nomenclatura anterior a 2012). Antes respondían known: false / no_se_sabe. Las explicaciones de los otros 30 códigos no cambian; knowledgeRevision pasa a la nueva revisión en todas las respuestas. Misma forma.

Qué hacer: nada; si guardabas en caché un no_se_sabe de estos tres códigos, vuelve a preguntar.

2026-10-26 · [ADD] El calendario de renovación de una cartera: POST /trademarks/renewal-calendar con portfolio

Nueva POST /trademarks/renewal-calendar ≡ get_renewal_calendar: la misma respuesta que la GET por el cuerpo JSON, más el objeto portfolio (party, refine, includeApplicationNumber, excludeApplicationNumber), el mismo de POST /trademarks/search y POST /trademarks/application-numbers. Una marca añadida a mano está en el calendario aunque no cumpla refine; una excluida a mano no está nunca. El cursor va atado al filtro entero, portfolio incluido (con otro, 400 validation_error sobre cursor). Con portfolio, party, includeApplicationNumber o excludeApplicationNumber de primer nivel son 400. La GET no cambia.

Qué hacer: nada; para el calendario de una cartera con marcas añadidas a mano, usa la POST (o get_renewal_calendar) con portfolio (ver Informes).

2026-10-26 · [BEH] MCP: explain_section_code explica cuatro códigos más

Sólo MCP. explain_section_code explica ahora 30 códigos: se suman C12C (fallos de juicios de Caducidad), C13L (ejecutorias en juicios de Cancelación y de Limitación Territorial; el nombre es nuestro, no el encabezado literal de INAPI, y la explicación lo dice), C16C (resoluciones varias en juicios de Caducidad) y MSO08 (cesión de una solicitud en trámite, que no dice a favor de quién). Antes respondían known: false / no_se_sabe. Las explicaciones de los otros 26 códigos no cambian; knowledgeRevision pasa a la revisión del 2026-10-26 en todas las respuestas. Misma forma.

Qué hacer: nada; si guardabas en caché un no_se_sabe de estos cuatro códigos, vuelve a preguntar.

2026-10-25 · [ADD] Lo que dice el SII de una parte: sii en GET /parties/{id} y GET /parties

GET /parties/{id} ≡ get_party y cada parte de GET /parties ≡ list_parties llevan un campo nuevo, sii: para una parte con RUT chileno que figura en la nómina de personas jurídicas del SII, la razón social, el subtipo (código del SII y etiqueta en es-CL/en/pt-BR), el inicio de actividades, el término de giro, el comuna (con su código CUT) y región del domicilio vigente según el SII (la calle y el número no se publican) y las sucursales vigentes por comuna. Cada bloque lleva source: "sii" y asOf = la fecha del fichero del SII. El domicilio del SII es el actual, no el de la solicitud (territory). sii es null sin RUT chileno, si el SII no lista la parte o si la parte está fundida en otra. Nada de lo que ya existía cambia.

Qué hacer: nada; si te sirve, lee sii (ver Búsqueda de personas).

2026-10-24 · [BEH] Titulares de una marca con cesión de la solicitud (MSO08), y relaciones co_holder

Cuando una solicitud en trámite se cede (código INAPI MSO08, que no dice a favor de quién), el titular que la cedió deja de figurar como titular actual: en GET /trademarks/{id} ≡ get_trademark sale de holders y aparece entre los titulares anteriores con retiredBy: {kind: "section", section: "MSO08"} y retiredOn = la fecha de la cesión; si los datos abiertos de INAPI lo nombran como representante, pasa a representatives y no figura como titular anterior. Sólo cuando los datos son inequívocos: un nombre truncado o escrito de otra forma no se toca. En GET /parties/{id}/relations ≡ list_party_relations, un titular retirado así no es cotitular anterior (co_holder) del que quedó. No es una transferencia: assigned_to/assigned_from y groupBy=transferYear no cambian. Misma forma. Ese titular cuenta como anterior en todas las lecturas por vigencia: GET /parties/{id}/trademarks ≡ list_party_trademarks y GET /parties/{id}/outcomes ≡ get_party_outcomes con relation=former, y el filtro por parte de la búsqueda de marcas sólo lo encuentra con includeFormer=true.

Qué hacer: nada; si guardas titulares, vuelve a leer las marcas con una cesión de solicitud.

2026-10-23 · [BEH] review.reason de una parte: código nuevo holder_tax_id_on_representative

review.reason (en GET /parties/{id} ≡ get_party y en las partes embebidas) admite un valor nuevo, holder_tax_id_on_representative: un representante llegó a INAPI con el RUT del propio titular de la marca. Ese RUT ya no se le asigna al representante, que se identifica por su nombre, y el titular deja de aparecer también como representante (ambas) de su propia marca.

Qué hacer: si comparas review.reason contra una lista cerrada, añade este código.

2026-10-21 · [ADD] POST /trademarks/search ≡ search_trademarks, GET /trademarks y /trademarks/application-numbers ≡ list_application_numbers: el objeto de búsqueda de texto text

Campo opcional nuevo text, con el vocabulario de Algolia: { query, queryType, typoTolerance, minWordSizefor1Typo, minWordSizefor2Typos, exactOnSingleWordQuery, removeWordsIfNoResults, phonetic, semantic, getRankingInfo }. Con todas las opciones por defecto responde exactamente lo mismo que q. Configurado, la respuesta tiene dos bloques: primero el de palabras clave, un conjunto determinista y completo (queryType prefixNone/prefixLast/prefixAll/contains/exact, typoTolerance true/false/min/strict con los tamaños mínimos de palabra, removeWordsIfNoResults none/lastWords/allOptional), ordenado exacta → prefijo → más palabras → menos errores → sort → número; después, con phonetic o semantic, las parecidas aproximadas (en orden de relevancia). Sin aproximadas, total es exacto; con ellas total no viaja, meta.keywordTotal es el tamaño exacto del bloque de palabras clave y meta.estimatedTotal cuenta los dos (cota inferior). Como mucho 16 palabras. getRankingInfo: true añade rankingInfo a cada acierto. En GET va aplanado: text=…&textQueryType=…&textTypoTolerance=…. En /trademarks/application-numbers y en portfolio.refine.text vale como conjunto: exige phonetic: false y semantic: false. text con q, denomination, el lote, la similitud o la ventana de oposición es un 400, igual que minScore con text configurado. Código nuevo 422 text_set_too_large: más de 50.000 candidatas en el bloque de palabras clave.

Qué hacer: para una búsqueda literal (la caja de una cartera), envía text: { query, queryType: "contains", typoTolerance: false, phonetic: false, semantic: false }; para el orden exacta → prefijo → aproximada, configura text en vez de q.

2026-10-22 · [ADD] Anotaciones y gravámenes: el número de anotación de INAPI (annotationNumber)

Cada anotación (get_trademark con anotaciones, get_annotation, search_annotations, el informe) lleva annotationNumber: el «N° de anotación» de INAPI, el que se cita en un escrito. Una resolución lleva el de la anotación que resuelve. Cada entrada de encumbrances[] lleva annotationNumber (la carga) y releaseAnnotationNumber (el alzamiento emparejado). null si no se conoce: el Estado Diario no lo imprime, y el historial antiguo se va numerando.

Qué hacer: nada; úsalo para citar la anotación. No lo inventes donde viene null.

2026-10-22 · [BEH] Gravámenes: dos cargas iguales del mismo día son dos entradas, y el alzamiento se empareja con la carga que INAPI dice que alza

encumbrances[] (GET /trademarks/{applicationNumber}?expand=encumbrances ≡ get_trademark, y el informe) usa ahora el número de anotación de INAPI. Dos cargas del mismo tipo, día y texto (dos prendas al mismo acreedor presentadas juntas) eran una sola entrada y ahora son dos; cargas del mismo día a acreedores distintos, también. Cuando INAPI indica qué carga levanta un alzamiento, el emparejado deja de ser una convención: releaseAttributionCertain y releaseStatusCertain salen true. Las marcas cuyo historial todavía no lleva números se leen como antes, y se van actualizando.

Qué hacer: nada en tu código (misma forma). Una marca puede mostrar una carga active más que ayer: es una carga que existía y no se veía.

2026-10-21 · [ADD] Gravámenes: releaseStatusCertain dice si el estado de una carga es seguro

Cada entrada de encumbrances[] (GET /trademarks/{applicationNumber}?expand=encumbrances ≡ get_trademark) gana releaseStatusCertain (booleano). Responde «¿sigue vigente esta carga?»: true cuando su state (active o released) es seguro, aunque releaseAttributionCertain sea false porque qué alzamiento levantó qué carga es sólo una atribución. releaseAttributionCertain conserva su significado. Dos reglas hacen seguro el estado con un emparejado dudoso: cuando todas las cargas del tipo de la marca están alzadas, cada una está alzada con seguridad (sólo su releasedOn sigue siendo una atribución); y una carga presentada el mismo día que un alzamiento nunca es la que ese alzamiento levantó. Es false siempre que releaseObservable sea false. Unas cuatro de cada cinco cargas alzadas que llevaban releaseAttributionCertain: false llevan ahora releaseStatusCertain: true.

Límite conocido: si INAPI inscribió dos cargas idénticas del mismo tipo el mismo día y el registro sólo muestra una, el estado puede ser erróneo; lo mismo vale para las cargas que ya eran seguras.

Qué hacer: para decir si una carga está vigente, lee releaseStatusCertain; deja releaseAttributionCertain para saber si releasedOn es la fecha del alzamiento de esa carga.

2026-10-21 · [FIX] GET /trademarks/renewal-calendar ≡ get_renewal_calendar: el cursor sólo vale con el filtro con el que se emitió

Un cursor obtenido con un filtro y usado con otro respondía 200 con una página que no era la siguiente de nada. Ahora el cursor va atado al filtro (todos los campos salvo limit y cursor; from y to incluidos, limit puede cambiar): con otro filtro, 400 validation_error con una entrada sobre cursor, igual en REST y en MCP y con el mismo patrón que /trademarks/application-numbers. Un cursor emitido antes de este cambio es ilegible (mismo 400).

Qué hacer: pide cada página con el mismo filtro y el next de la anterior; ante el 400, empieza de nuevo sin cursor.

2026-10-21 · [BEH] review.reason de una parte: código nuevo representative_tax_id_on_holder

review.reason (en GET /parties/{id} ≡ get_party y en las partes embebidas) admite un valor nuevo, representative_tax_id_on_holder: el titular llegó a INAPI con el RUT de un estudio o abogado que lo representa. Ese RUT ya no se le asigna al titular, que se identifica por su nombre, y el estudio deja de aparecer como cotitular de la marca de su cliente.

Qué hacer: si comparas review.reason contra una lista cerrada, añade este código.

2026-10-19 · [ADD] POST /trademarks/search y POST /trademarks/application-numbers ≡ search_trademarks y list_application_numbers: el objeto portfolio

Una solicitud añadida a mano a una cartera ya no se pierde por no cumplir los refinamientos de la cartera. Campo opcional nuevo portfolio, { party, refine, includeApplicationNumber, excludeApplicationNumber }: resultado = (((partes ∩ refine) ∪ incluidas) − excluidas) ∩ los filtros de primer nivel. refine acepta los filtros de predicado de la lista de números y acota sólo las marcas de las partes; los filtros de primer nivel son los del listado y se aplican a todo, también a las incluidas. Dentro de portfolio cada lista admite hasta 10.000 números. Con portfolio, party, includeApplicationNumber o excludeApplicationNumber de primer nivel son 400 validation_error; sin él, nada cambia. Ruta nueva POST /trademarks/application-numbers: la misma respuesta que el GET (cursor, limit, 409 cursor_stale), con el filtro en el cuerpo; el cursor está atado al filtro entero, portfolio incluido. GET /trademarks sigue plano.

Qué hacer: para una cartera, manda sus partes, sus refinamientos y sus listas dentro de portfolio y deja en el primer nivel sólo los filtros del listado.

2026-10-19 · [BREAK] GET /trademarks/application-numbers ≡ list_application_numbers: por páginas, con cursor; truncated se retira

La lista de números de un filtro ya no se corta en 10.000: se recorre por páginas. Parámetros nuevos limit (1..10.000, por defecto 10.000) y cursor; la respuesta trae next, el cursor de la página siguiente (null en la última), y deja de traer truncated (next distinto de null lo sustituye). total (exacto, del conjunto entero), cap y dataAsOf siguen, y total y dataAsOf son los mismos en todas las páginas de un recorrido. El orden no cambia (número como texto) y ningún número se repite ni se pierde entre páginas. El cursor sólo vale con el mismo filtro (con otro, 400 validation_error sobre cursor) y con el corpus de la página uno: si una sincronización empezó o terminó entre páginas, la siguiente responde 409 cursor_stale.

Qué hacer: deja de leer truncated; mientras next no sea null, pide la página siguiente con cursor=<next> y el mismo filtro. Ante un 409 cursor_stale, empieza de nuevo sin cursor.

2026-10-19 · [BEH] GET /parties ≡ list_parties ya no devuelve partes fundidas; GET /parties/{id} ≡ get_party añade mergedInto

Cuando una ficha de parte se funde en otra (eran la misma parte), sus marcas y anotaciones pasan a la que sobrevive. La búsqueda de partes deja de devolver la ficha fundida, en cualquier orden y filtro (antes salía con trademarkCount: 0). GET /parties/{id} sobre ella la sigue devolviendo, con un campo nuevo, mergedInto: el id de la parte que tiene hoy sus marcas (el final de la cadena si hubo varias fusiones). En cualquier otra parte, mergedInto es null. Las demás lecturas por id (/trademarks, /relations, /outcomes, la cartera) responden por la ficha pedida, que tras la fusión no tiene marcas.

Qué hacer: si guardas id de partes, al leer una con mergedInto distinto de null, sustitúyelo por ese valor.

2026-10-18 · [ADD] GET /trademarks/application-numbers ≡ list_application_numbers: todos los números de solicitud de un filtro, de una vez

Una ruta nueva y su herramienta gemela: los números de solicitud de todas las marcas que casan con el filtro de GET /trademarks (lote, party, includeApplicationNumber/excludeApplicationNumber, niceClass, status, partes, fechas, hitos, renewalStatus…), ordenados por número como texto (no numérico), en una sola respuesta sin paginar: { applicationNumbers, total, truncated, cap, dataAsOf, coverageThrough }. Como mucho 10.000 números (cap); si casan más, la lista trae los primeros 10.000, truncated es true y total es el recuento exacto. q, denomination, similarTo, similarToTrademark, allClasses, oppositionWindow, facets y los filtros de norma son un 400 validation_error que nombra el campo; no hay limit, cursor, sort ni minScore. Scope brands:read.

Qué hacer: nada; úsala cuando necesites el conjunto entero de un filtro y sólo los números. Si truncated es true, acota el filtro.

2026-10-18 · [FIX] %, _ y \ en un filtro de subcadena casan literalmente

holder y representative (GET /trademarks ≡ search_trademarks y los demás que usan el filtro de marcas), denomination como subcadena (estadísticas y calendario de renovación), GET /parties?q= ≡ list_parties y GET /legal-norms?q= ≡ list_legal_norms: un valor con %, _ o \ no devolvía nada; ahora cada uno de esos caracteres casa consigo mismo y sólo consigo mismo (holder=A_B encuentra «A_B 50% LTDA» y no «AXB…»). Los valores sin esos caracteres no cambian. Misma forma.

Qué hacer: nada.

2026-10-18 · [BEH] Cuota mensual y topes de vigilancia: los del plan de tu organización

Cada organización tiene un plan. Su cuota mensual puede valer para todas sus claves juntas, además de la cuota propia de cada clave: cuenta la que antes se agote, con el mismo 429 quota_exceeded y su Retry-After, y las cabeceras RateLimit-* y quota de GET /system/me describen esa. El tope diario de altas de vigilancia (429 watch_daily_limit_reached) también pasa a ser del plan, como ya lo era el de solicitudes vigiladas a la vez. Hoy todas las organizaciones están en el plan de siempre: los números no cambian (sin cuota de organización, 500 vigiladas, 500 altas al día).

Qué hacer: nada; si tu integración lee RateLimit-Limit, sigue leyéndolo: es el límite que te aplica.

2026-10-17 · [BEH] GET /watch/hits ≡ list_similarity_hits: una vigilada de 1–2 caracteres sólo recibe parecidas cortas

Si la denominación vigilada tiene 1 o 2 letras o cifras («Q», «TE», «+B»; sin contar signos ni espacios), la vigilancia sólo guarda parecidas de 1 a 3 letras o cifras, con cualquier score: las idénticas y las cortas que suenan igual («Q» → «K», «W» → «V»). Deja fuera los nombres largos que llevan esa letra o una inicial que suena igual («TE» → «THE JUNGLE BOOK», «G» → «G T D INTERNET»), que antes entraban con score 1 y daban cientos de parecidas por sigla. Las vigiladas de 3 caracteres o más no cambian. Misma forma, menos filas. La búsqueda de parecidas (similarTo, similarToTrademark), la ventana de oposición y la disponibilidad no cambian.

Qué hacer: nada; si vigilas siglas cortas, espera muchas menos parecidas.

2026-10-16 · [BEH] GET /trademarks ≡ search_trademarks: una coma ya no separa nombres en holder, representative y taxId

Un valor de holder, representative o taxId es un nombre entero, con sus comas y demás signos: holder=PEPSICO, INC. busca ese nombre, y no PEPSICO o INC. como hasta hoy. Para varios nombres (OR), repite el parámetro (?holder=A&holder=B) o usa un elemento del array por nombre en el cuerpo de POST /trademarks/search y en MCP. Además, en esos tres filtros: se recortan los espacios de los extremos y los seguidos cuentan como uno; un valor vacío o sólo de espacios, uno de menos de 2 caracteres o uno sin letra ni dígito es 400 validation_error (antes un valor vacío quitaba el filtro y holder=% acababa en 504). taxId sigue exigiendo forma de RUT (400 invalid_rut). También en /insights/trademarks y el calendario de renovación. Las listas de números, ids y vocabulario (niceClass, status, party, includeApplicationNumber…) siguen admitiendo a,b. Y GET /legal-norms?q= ≡ list_legal_norms trata % y _ como caracteres, no como comodines.

Qué hacer: si enviabas varios nombres separados por comas en un solo holder, representative o taxId, repite el parámetro. Codifica cada valor (la coma viaja como %2C, un + como %2B).

2026-10-16 · [ADD] GET /trademarks ≡ search_trademarks: incluir y excluir solicitudes a mano en una cartera

Parámetros nuevos includeApplicationNumber y excludeApplicationNumber, repetibles o separados por comas (hasta 500 cada uno): resultado = ((filtros de parte ∪ incluidas) − excluidas) ∩ demás filtros. Los filtros de parte (party, holder, representative, taxId) forman el ámbito de la cartera; las incluidas se le suman y las excluidas se quitan siempre, aunque casen. Los demás filtros (estado, clase, texto, fechas…) se aplican después, también a las incluidas. Sin filtro de parte, las incluidas son la cartera. Orden, cursor, total y facetas, sobre el conjunto final. También en POST /trademarks/search, /insights/trademarks y el calendario de renovación. Un número mal formado, una lista vacía o más de 500 es 400 validation_error; con oppositionWindow, un 400.

Qué hacer: nada; para una cartera con solicitudes añadidas o quitadas a mano, una sola petición.

2026-10-16 · [ADD] GET /trademarks ≡ search_trademarks: filtro party por id de parte y papel

Parámetro nuevo party=<id>:<papel>, repetible (hasta 20): las marcas de unas partes por su id interno (el de GET /parties?q=), cada una con su papel, holder o representative. Varios valores se suman (OR); party se combina con AND con los demás filtros, y relation elige vínculos actuales (defecto), anteriores o todos. El papel significa lo mismo que en GET /parties/{id}/trademarks?role=, así que party=<id>:representative devuelve las mismas marcas que esa ruta, ahora filtrables, ordenables y con facetas. Sirve para partes sin RUT. También en POST /trademarks/search, /insights/trademarks (≡ get_trademark_insights) y el calendario de renovación (≡ get_renewal_calendar). Un valor mal formado o más de 20 es 400 validation_error; con oppositionWindow, un 400.

Qué hacer: nada; para una cartera de partes elegidas por id, usa party en vez del nombre.

2026-10-16 · [BEH] GET /watch/hits ≡ list_similarity_hits: entre 0,7 y 0,8 la vigilancia sólo guarda parecidas que llevan una palabra de la vigilada

La vigilancia sigue guardando sólo parecidas con score ≥ 0,7, y desde 0,8 no cambia nada. Entre 0,7 y 0,8 guarda una parecida sólo si lleva una palabra de la denominación vigilada, igual o a una letra de distancia («NOMADES» → «NOMADE», «CMP» → «CMPC»). Cuentan las palabras propias de la vigilada poco frecuentes en sus clases (menos de 50 marcas), sin sus términos genéricos; si no tiene ninguna, vale cualquiera de las suyas. Las cifras pegadas a letras se separan antes de comparar («NOMADE98» → «nomade 98»). Deja fuera las parecidas que sólo comparten una palabra corriente del oficio («SL Abogados» → «Abogados Cordillera»): en esa franja eran 9 de cada 10. Misma forma, menos filas; las parecidas ya guardadas siguen la regla desde este cambio. La búsqueda de parecidas (similarTo, similarToTrademark), la ventana de oposición y la disponibilidad no cambian.

Qué hacer: nada; si contabas parecidas por solicitud vigilada, espera menos entre 0,7 y 0,8.

2026-10-16 · [ADD] GET /trademarks ≡ search_trademarks: cada marca trae publishedOn y registeredOn

Cada elemento de la colección de marcas (lista, búsqueda, lote por número, similitud, ventana de oposición y marcas de una parte, y las marcas dentro de los informes) trae ahora publishedOn (fecha de publicación) y registeredOn (fecha de registro), YYYY-MM-DD o null, con el mismo valor que la ficha GET /trademarks/{applicationNumber} ≡ get_trademark. Son las fechas por las que ya se podía ordenar y filtrar. Los demás campos no cambian.

Qué hacer: nada; si ordenas por esas fechas, puedes mostrar y comprobar el orden sin pedir la ficha de cada marca.

2026-10-16 · [ADD] GET /trademarks/{applicationNumber}?expand=encumbrances ≡ get_trademark: qué fecha es recordedOn y qué alzamientos se atribuyeron por antigüedad

Cada entrada de encumbrances[] trae dos campos nuevos; ningún campo existente cambia de valor.

  • recordedOnBasis ("recordal", "filing" o null) dice qué fecha es recordedOn. En una carga moderna (A0xI) vigente o alzada es "filing": la fecha es la de presentación de la anotación, no la de su inscripción. En una carga de 2007–2011 es "recordal": la fecha de su inscripción. null cuando recordedOn es null.
  • releaseAttributionCertain es false cuando un alzamiento llegó con dos o más cargas de su tipo vigentes y se emparejó con la más antigua: los datos no dicen cuál levantó. Lo llevan todas las cargas que estaban vigentes en ese momento: la que sale released puede seguir vigente y una active puede ser la alzada.

Qué hacer: no escribas «inscrita el…» sobre un recordedOn con recordedOnBasis: "filing" («presentada el…»). Con releaseAttributionCertain: false, no afirmes qué acreedor sigue vigente: di que hay alzamientos inscritos y que no consta a cuál de las cargas corresponden.

2026-10-15 · [BEH] GET /trademarks/{applicationNumber} ≡ get_trademark: un número base de Madrid sin expediente propio en Chile responde con su expediente con letra

Algunos registros internacionales tienen en Chile sólo un expediente con letra (<base>-A): el registro base nunca designó a Chile. Esas marcas se publican con el número con letra (applicationNumber = <base>-<letra>, con baseApplicationNumber y seriesSuffix), con todos sus datos e historial. Pedir el número base en GET /trademarks/{applicationNumber} ≡ get_trademark, en /deadlines ≡ get_deadlines y en /annotations ≡ list_trademark_annotations responde 200 con esa marca, en lugar de 404. En el lote por número, en la búsqueda y en la vigilancia el número base no se reconoce.

Qué hacer: si guardas el número base de una de esas marcas, usa el applicationNumber que devuelve la ficha (el número con letra).

2026-10-14 · [BEH] POST /annotations/search ≡ search_annotations: detectedAfter y detectedUntil exigen segundos

Los dos filtros siguen el formato RFC 3339, que exige segundos cuando la hora lleva Z o un desfase. 2026-10-01T10:00Z (sin segundos) se aceptaba y ahora devuelve 400 validation_error; 2026-10-01T10:00:00Z y 2026-10-01T10:00:00.000Z siguen valiendo. Todo instante que el contrato devuelve (meta.detectedThrough, dataAsOf, …) ya lleva segundos, así que el patrón de cursor no cambia. El documento OpenAPI publica además niceClass de GET /reports/clearance, /reports/conflict-landscape y /reports/registration-signals como obligatorio (required: true): ya lo era, omitirlo daba 400.

Qué hacer: si envías detectedAfter/detectedUntil sin segundos, añade :00. Si generas el cliente desde el OpenAPI, regenéralo: niceClass pasa a ser obligatorio en esas tres rutas.

2026-10-14 · [FIX] stale descuenta sólo las horas de domingo ya transcurridas

GET /system/freshness ≡ get_system_freshness, sólo sin thresholdHours. Hasta ahora el domingo se descontaba entero desde las 00:00: una fuente que ya era stale el sábado (la sincronización del sábado no llegó) volvía a parecer fresca a las 00:00 del domingo y así seguía hasta la tarde. Ahora se descuenta sólo el tiempo de domingo que ya ha pasado: el domingo la edad deja de crecer y el lunes sigue donde se quedó.

  • Un fin de semana normal se ve igual: una ingesta del sábado no es stale en todo el domingo ni el lunes hasta 24 h netas después.
  • Una fuente stale el sábado sigue stale todo el domingo.
  • Misma forma; stalenessSeconds sigue siendo la edad real; con thresholdHours explícito no cambia nada.

Qué hacer: nada.

2026-10-14 · [BEH] Expediente de la marca: cada renovación dice si es la solicitud o la concesión, y lastRenewalOn sólo cuenta concesiones

GET /trademarks/{applicationNumber} ≡ get_trademark. renewals[] contaba como renovación la solicitud de renovación (la presentación del escrito), así que una marca cuya renovación se pidió y después se abandonó o se rechazó salía con esa fecha como «última renovación».

  • Cada entrada de renewals[] trae un campo nuevo, kind: request (la renovación está pedida: presentada, u observada o en trámite; aún no concedida en esa fecha) o grant (INAPI la concede, la acepta o la inscribe). Ninguna entrada sale de la lista.
  • lastRenewalOn es ahora la fecha del último grant, y se omite si no hay ninguno. Medido el 2026-10-14 sobre 212.708 marcas con lastRenewalOn: 208.921 no cambian, en 1.265 retrocede a una concesión anterior y 2.522 lo pierden (1.891 de ellas caducadas).

Qué hacer: si mostrabas lastRenewalOn como «última renovación», ya puedes hacerlo. Si pintas renewals[], distingue kind: una request no es una renovación hecha.

2026-10-11 · [ADD] El OpenAPI publicado dice qué significa su versión y trae info.x-revision

GET /docs/openapi.json. info.version sigue siendo la fecha de la última tanda cortada del contrato, no un contador de cambios: no se mueve con cada entrada de este registro. Ahora el documento lo dice en info.description y trae un campo nuevo, info.x-revision: la fecha de la entrada más reciente de este registro con efecto visible en el documento (no cuentan [INT], [DATA] ni [WITHDRAWN]). El ETag de la respuesta, que ya existía, identifica su contenido exacto. El servidor MCP no cambia: su versión sigue siendo la misma fecha de corte.

Qué hacer: para saber si tienes que releer el contrato, compara info.x-revision (o, mejor, el ETag con If-None-Match) con lo que guardaste, no info.version. Si x-revision falta, no la supongas.

2026-10-11 · [BEH] Búsqueda por texto: deja de esperar a un canal que no ha respondido en 3 s

GET /trademarks ≡ search_trademarks y POST /trademarks/search con q o denomination (sin similarTo). La forma no cambia.

Una búsqueda por texto consulta cuatro canales a la vez (exacto, aproximado, fonético y por significado) y hasta ahora esperaba a los cuatro: un solo canal lento podía alargar la respuesta a más de 10 s. Desde hoy, pasados 3 s y con al menos un canal que ya haya encontrado coincidencias, la búsqueda responde 200 con los canales que tiene. El canal que queda fuera se comporta como uno que falló: sus coincidencias no están en la página, su etiqueta no aparece en matchedBy ni en matchedFields[].kind, y si es el canal por significado signals.semantic puede venir null. Nunca devuelve por esto una página vacía ni un error.

Qué hacer: nada. Si repites la misma búsqueda unos segundos después puede traer más coincidencias y un orden algo distinto; no mezcles páginas de dos ejecuciones separadas por una espera larga. El objetivo de latencia de la búsqueda sigue siendo p95 < 3 s (SLA).

2026-10-11 · [DATA] Estado Diario: recuperadas 9.492 anotaciones del 2024-09-30 al 2026-09-02

Anotaciones de una marca (GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin). La forma no cambia.

Aplicado el 2026-10-11 entre las 01:02 y las 01:23 UTC. Son publicaciones del boletín diario de INAPI que el corpus no tenía:

  • 2.657 de juicios de nulidad, caducidad y cancelación (secciones C9N a C16N, y cuatro de C16C, C12C y C13L), que hasta septiembre de 2026 no se leían.
  • 2.420 de marcas con número de solicitud de seis cifras (presentadas entre 1995 y 2012), casi todas «Resoluciones varias» (M11).
  • 4.097 segundas resoluciones del mismo día para la misma marca y sección (casi todas M11): antes se guardaba una sola por día.
  • 318 de otras secciones A, C y M.
  • Nacen con fecha de detección del 2026-10-11: si paginas por detectedAfter, las verás como recién detectadas, con date entre el 2024-09-30 y el 2026-09-02. Filtra por date si sólo quieres lo reciente.
  • Las cuatro anotaciones de C16C, C12C y C13L salen con sectionName: null hasta que esos códigos tengan nombre.
  • No hay marcas nuevas, ni movimientos, ni avisos de vigilancia.

Qué hacer: repetir cualquier medición que dependiera del recuento de anotaciones de ese periodo; si consumes el feed por detección, filtrar por date.

2026-10-11 · [BEH] Secciones: una familia nueva, cancelacion_y_limitacion_territorial, y tres códigos del Estado Diario dejan de ir sin nombre

GET /sections ≡ list_sections, y sectionFamily/sectionName/sectionLabel en toda anotación. La forma no cambia (family y sectionFamily siguen siendo texto o null), pero aparece un valor que antes no existía: cancelacion_y_limitacion_territorial. Las familias pasan de nueve a diez.

código nombre familia anotaciones
C16C Resoluciones varias en juicios de Caducidad caducidad 2
C12C Fallos de juicios de Caducidad caducidad 1
C13L Ejecutorias en juicios de Cancelación y de Limitación Territorial cancelacion_y_limitacion_territorial 1
  • Esas 4 anotaciones (medido en producción el 2026-10-11 a la 01:46 UTC, sólo lectura) dejan de traer sectionName y sectionLabel nulos y sectionFamily pasa de null a la familia.
  • family=caducidad pasa de seis a ocho códigos; family=cancelacion_y_limitacion_territorial devuelve C13L.
  • ⚠ INAPI imprime cada sección C*L dos veces, una para Cancelación y otra para Limitación Territorial, y el código no dice cuál. La única fila salió bajo Cancelación; el nombre y la familia dicen los dos juicios a propósito. Es un rótulo nuestro, no el encabezado literal.
  • Ningún código cambia de familia: family=opposition y las demás devuelven lo mismo. meta.dataAsOf de GET /sections pasa al 2026-10-11.
  • Quedan sin familia: CAN08 y CAN99 (cancelación de IG/DO, otra materia) y las cancelaciones administrativas de un registro (CANT sigue en resolucion).

Qué hacer: si validas family o sectionFamily contra una lista cerrada, añade cancelacion_y_limitacion_territorial y trata cualquier valor que no conozcas como otra familia, no como un error. La lista vigente se lee de GET /sections.

2026-10-10 · [DATA] Estado Diario: recuperadas 354 anotaciones del 16 al 21 de mayo de 2024

Actos sobre marcas inscritas, sección D5A (GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin). La forma no cambia.

INAPI no publicó este boletín el 16, el 17 ni el 20 de mayo de 2024: publicó uno solo, con fecha 21 (feriado), con los actos de esos días. Aplicado el 2026-10-10 a las 23:09 UTC: entran 354 anotaciones, cada una con la fecha de su acto — 82 el 2024-05-16, 139 el 2024-05-17 y 133 el 2024-05-20.

  • 37 llevan el día hábil anterior al que INAPI les da: 12 actos del sábado 18 y el domingo 19 van con el viernes 17, y 25 del martes 21 (feriado) con el lunes 20. Es lo que INAPI hace en sus boletines corrientes.
  • Nacen con fecha de detección del 2026-10-10: si paginas por detectedAfter, las verás como recién detectadas, con date de mayo de 2024.
  • No hay marcas nuevas ni avisos de vigilancia.

Qué hacer: nada, salvo repetir una medición que dependiera del recuento de anotaciones de esos días.

2026-10-10 · [DATA] Estado Diario: recuperadas 22 anotaciones del 2026-03-30

Anotaciones de una marca (GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin). La forma no cambia.

Aplicado el 2026-10-10 a las 21:10 UTC. Aparecen 22 anotaciones con fecha 2026-03-30: 12 de marcas de la serie Madrid cuyo número el boletín imprimió partido en dos líneas, y 10 de secciones de nulidad que entonces no se leían. No hay marcas nuevas ni avisos de vigilancia.

  • Nacen con fecha de detección del 2026-10-10: si paginas por detectedAfter, las verás como recién detectadas.

Qué hacer: nada, salvo repetir una medición que dependiera del recuento de anotaciones de ese día.

2026-10-10 · [DATA] Libro del Estado Diario: 553 días del 2024-04-19 al 2026-08-06 ganan su fila del boletín de altas (aplicado el 2026-10-10 a las 21:21 UTC)

GET /system/coverage ≡ get_system_coverage y bulletins[] de GET /reports/daily-bulletin ≡ get_daily_bulletin. La forma no cambia.

El libro de días procesados no tenía fila del boletín altas para los días anteriores al 2026-08-07, aunque sus actos D5A ya están en el corpus. Se han sembrado 553 días (61.376 actos), del 2024-04-19 al 2026-08-06, con acts = el número de D5A del día y origin = seed. Tras la siembra, 596 días con D5A tienen su fila altas (65.945 actos, 2024-04-19 → 2026-10-08).

  • Sólo el 2025-12-13 (73 actos, un boletín repetido sin fila de tipo 2) sigue sin ella.
  • Ningún dato de marca ni de anotación cambia. Una fila con origin: "seed" está reconstruida desde el corpus: no significa «leído por el barrido diario».

Qué hacer: nada, salvo repetir cualquier cuenta de días o actos altas del libro de cobertura.

2026-10-10 · [BEH] Secciones: nueva familia caducidad para los actos de los juicios de caducidad

GET /sections ≡ list_sections, y sectionFamily en toda anotación. Los actos de un juicio de caducidad por falta de uso forman desde hoy una familia propia. La forma no cambia (family y sectionFamily siguen siendo texto o null), pero aparece un valor que antes no existía: caducidad. Las familias pasan de ocho a nueve.

  • Seis códigos pasan de null a caducidad: C11C «Citaciones a oír sentencia en juicios de Caducidad», CAD04 «Caducidad - Certificación de notificación por Receptor u otro ministro de fe», CAD06 «Caducidad - Contestación del traslado», CAD08 «Caducidad - Demanda de caducidad del registro», CAD10 «Caducidad - Otras peticiones» y CAD99 «Caducidad - Varios (sin nro de demanda)». Son 21 anotaciones de 16 marcas, del 2022-07-19 al 2026-02-23.
  • El filtro family=caducidad las devuelve, y GET /sections?family=caducidad lista los seis códigos.
  • Ningún código cambia de familia: family=opposition y las demás devuelven lo mismo que antes. Las estadísticas por clase, los informes, los plazos y los estados no cambian.
  • Siguen sin familia las demandas reconvencionales de caducidad presentadas dentro de una oposición o de una nulidad (1121, 1122, OPO24, OPO26, NUL30, NUL31).
  • caducidad no es el estado caducado de una marca: la familia nombra actos de un juicio, y la marca demandada puede seguir registrada.

Qué hacer: si validas family o sectionFamily contra una lista cerrada, añade caducidad y trata cualquier valor que no conozcas como otra familia, no como un error. La lista vigente se lee de GET /sections.

2026-10-10 · [BEH] Vigilancia: una organización dada de baja deja de vigilarse, y recupera su lista si se reactiva

GET /watch/applications ≡ list_watched_applications, GET /watch/hits ≡ list_similarity_hits. La forma no cambia, y una organización activa no nota nada.

  • Mientras una organización está dada de baja (sus claves responden 401), el servicio deja de vigilar para ella. Su lista se conserva.
  • Si se reactiva, la lista vuelve sola como mucho un minuto después, con el watchedSince que tenía y sin gastar el tope diario. Las solicitudes que sólo ella vigilaba pasan un rato por baselineStatus: "pending".
  • En GET /watch/hits, lo que vuelve a poder leer sale después del cursor que guardó, con los mismos id: recibirá otra vez parecidas ya leídas, además de las nuevas.

Qué hacer: nada si tu organización no se da de baja. Si se reactiva, espera un minuto antes de leer la lista y trata por id las parecidas repetidas.

2026-10-10 · [BREAK] Dos plazos nuevos con su artículo: contestar el traslado de una oposición y pagar los derechos de concesión

GET /trademarks… ≡ search_trademarks / get_trademark (milestones[]), GET /reports/filing-context ≡ get_filing_context y GET /trademarks/{applicationNumber}/deadlines ≡ get_deadlines. Crecen listas cerradas, get_deadlines pasa a distinguir sus entradas por kind y un nombre cambia en get_filing_context.

  • opposition_response_close (hito, plazo de get_deadlines y plazo de get_filing_context con type=opposition_response): el último día para contestar el traslado de una oposición, el 30.º día hábil posterior a su notificación, improrrogable (Ley 19.039 art. 9 y art. 11; Ley 19.880 art. 25; Decreto 82/2022 art. 24). No contestar no es abandono. derived cuando el corpus tiene la notificación del Estado Diario y la resolución de traslado; estimated (notification_inferred_from_resolution_date o transfer_resolution_not_in_corpus) cuando falta una de las dos.
  • grant_fee_close (hito, y plazo de get_deadlines): el último día para acreditar el pago de los derechos de concesión, el 60.º día hábil posterior a la notificación de la aceptación o de la certificación de ejecutoria; sin pago, la solicitud se tiene por abandonada (Ley 19.039 art. 18 bis E y art. 11; Ley 19.880 art. 25). Siempre estimated (anchor_by_office_practice) y con un campo nuevo, reservation {code, text {es, en, pt}}: la ley cuenta desde que la resolución queda ejecutoriada e INAPI desde su notificación; la fecha sigue lo que INAPI aplica.
  • El anchor de estos dos hitos trae además el acto del que sale la fecha (annotationId, sectionCode).
  • En get_deadlines, deadlines[] y omitted[] pasan a llevar tres kind (appeal_close, grant_fee_close y opposition_response_close), cada uno con sus campos: las entradas appeal_close no cambian, pero ya no son las únicas. El plazo de contestación trae estimateReasons ([] si es derived) y answerObserved (el primer OPO05 desde el ancla, un hecho). Una marca cuyo acto más reciente es una aceptación parcial trae ahora en omitted[] el pago con acceptance_not_final, además de su plazo de apelación.
  • En get_filing_context, el plazo omitido opposition_response_term (no_legal_basis_in_knowledge_base) deja de emitirse: se llama opposition_response_close y, cuando no se da, el motivo es no_transfer_on_record, madrid_designation, prior_legal_regime, anchor_on_non_business_day u outside_holiday_calendar. Hay un hecho nuevo, opposition.transfer.
  • Los dos plazos existen sólo en marcas nacionales y con ancla desde el 2022-05-09. Ninguno se filtra con milestoneKind. Las respuestas a observaciones de escrito (661B, 813B, 931, 925) siguen sin fecha: no tienen artículo.

Qué tienes que hacer: en get_deadlines, filtra deadlines[] y omitted[] por kind antes de leer sus campos (no leas la posición 0); en get_filing_context, cambia opposition_response_term por opposition_response_close. Si validas milestones[].kind, estimateReasons, deadlines[].kind u omitted[].kind contra una lista cerrada, amplíala. Muestra grant_fee_close con su reservation, nunca como fecha cierta, y un estimated como estimación.

2026-10-10 · [BEH] Relaciones de una parte: las de oposición (opposed, opposed_by) cubren desde el 2024-04-19

GET /parties/{id}/relations ≡ list_party_relations. Desde que el corpus lee los boletines del Estado Diario del 2024-04-19 al 2024-09-27, las oposiciones de ese periodo ya están enlazadas a sus partes: de las 12.402 anotaciones con partes de esos meses, las 12.402 tienen su oponente enlazado (en 4.998 el oponente se identifica con una parte; el 40,3 %, frente al 43,2 % desde el 2024-09-30).

  • coverageFrom de opposed y opposed_by pasa a 2024-04-19 (antes 2024-09-30). La forma no cambia; los otros cinco tipos siguen igual. Los bloques de oposiciones de los informes y de get_filing_context declaran la misma fecha.
  • Una parte que se opuso o a la que se opusieron entre el 2024-04-19 y el 2024-09-27 gana esas aristas: firstOn, lastOn, trademarkCount y evidence pueden cambiar. Un oponente cuyo nombre impreso casa con ninguna parte o con varias sigue sin generar arista (meta.unresolvedOpponentMentions).
  • La nota actsShare.opposition.coverageNote de GET /nice-classes/{niceClass}/stats ≡ get_class_stats dice ahora «desde el 2024-04-19»; las estadísticas no cambian.

Qué hacer: «no se opuso nunca» se lee ahora «no desde el 2024-04-19». Si guardaste aristas de oposición o tu propia fecha de cobertura, vuelve a leerlas.

2026-10-10 · [BEH] Informe de la marca: renewals[] deja de repetir la renovación de un establecimiento que ya publica el Estado Diario

renewals[] del informe de la marca. La renovación de una marca de establecimiento que además extiende su cobertura territorial salía dos veces: una como la sección A5 del Estado Diario (acto AREPTLT o ARENTLT) y otra como la resolución 1108 (establecimiento comercial) o 1123 (industrial, como servicios de clase 40) de la ficha de expediente. Es el mismo acto, de la misma marca y el mismo día: de las 1.196 A5, 989 tienen su 1108 o 1123 ese mismo día (las 176 anteriores al 2024-09-30, todas).

  • 1108 y 1123 cuentan como el mismo acto que un AREPTLT de la otra fuente, de la misma marca y el mismo día: unas 959 entradas menos en todo el corpus. lastRenewalOn no cambia (misma fecha).
  • Siguen saliendo dos veces las 28 A5 con ARENTLT y una 1108 o 1123: el par no se adivina. annotations[] y eventId no cambian.

Qué hacer: si contabas las renovaciones de una marca por renewals[], vuelve a contarlas; ya no se cuenta dos veces la de estos establecimientos.

2026-10-10 · [DATA] Estado Diario, anotaciones del boletín de tipo 5: se leen también los boletines que imprimen el número de anotación junto al acto

Toda vista de anotaciones (annotations[] del informe de marca, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin). La forma no cambia.

Nueve boletines de 2026 (17 y 18 de febrero; 8, 10, 21, 29 y 30 de abril; 4 de mayo; 9 de julio) imprimen el número de anotación y el acto en un mismo texto, y sus anotaciones sobre marcas registradas (renovaciones, transferencias, cambios de nombre…) no se leían: esos nueve días no tienen ninguna.

  • Desde hoy, un boletín nuevo impreso así se lee como cualquier otro. Para un boletín impreso de la forma habitual no cambia nada.
  • Los nueve días pasados ya están recuperados (2026-10-10, 21:06 UTC): 997 anotaciones nuevas, con fecha entre el 17 de febrero y el 9 de julio de 2026. En detectedAfter aparecen como detectadas el 10 de octubre: no son actos nuevos, y no generan movimientos ni alertas.
  • El 13 de agosto de 2025 INAPI no publicó este boletín: las anotaciones de ese día sólo constan en el historial de cada marca.

Qué hacer: si tratas detectedAfter como «acto reciente», filtra además por la fecha del acto.

2026-10-10 · [DATA] Estado Diario: un número de solicitud de la serie Madrid impreso en dos líneas (7 + 2 cifras) se lee entero; 22 anotaciones del 2026-03-30 pendientes de recuperar

Anotaciones de una marca (GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin). La forma no cambia.

El boletín diario de INAPI imprime a veces el número de una marca de la serie Madrid (nueve cifras) partido en dos líneas. Cuando el corte dejaba siete cifras arriba y dos abajo, la publicación no se leía. Medido sobre los 616 boletines del archivo (2024-04-19 → 2026-10-09): pasó en un solo boletín, el del 2026-03-30, con 12 publicaciones. No se publicó ningún dato equivocado; esas 12 anotaciones faltan.

  • Desde hoy una publicación así se lee con su número completo.
  • Pendiente: recuperar 22 anotaciones del 2026-03-30 (las 12 y otras 10 de secciones de nulidad que entonces no se leían). Una entrada aparte lo anunciará. No habrá marcas nuevas ni avisos de vigilancia.

Qué hacer: nada.

2026-10-10 · [DATA] Estado Diario, solicitudes nuevas del boletín de tipo 5: el nombre de la marca se lee en su columna aunque INAPI cambie el ancho de las columnas

denomination de una marca recién presentada (GET /trademarks/{n} ≡ get_trademark, GET /trademarks ≡ search_trademarks y toda vista que muestre el nombre). La forma no cambia.

Una solicitud nueva entra primero por el boletín diario de INAPI y, horas después, se completa con su ficha. El boletín no imprime siempre las columnas con el mismo ancho: medido sobre 618 boletines (2024-04-19 → 2026-10-08), en 201 alguna columna quedaba desplazada y en 9 la tabla no se leía. En esos días, hasta que llegaba la ficha, la marca nueva podía aparecer con sus clases de Niza como nombre, con el nombre vacío, o no aparecer.

  • Desde hoy la marca nueva aparece con su nombre desde el primer momento, también en esos días. Para un boletín impreso de la forma habitual no cambia nada.
  • Lo ya publicado está bien salvo una marca. La ficha de INAPI sustituye el nombre cuando llega, y había llegado para todas menos una: una marca tridimensional (sin texto) que muestra su clase como denomination. Se corrigió el 2026-10-10 a las 19:25 UTC (denomination vacío; su vector de texto se borró y el siguiente delta de embeddings crea el nuevo).

Qué hacer: nada.

2026-10-10 · [DATA] Estado Diario, sección D5A: 111 actos de un boletín repetido pasan del 2025-10-09 al 2025-10-10 (aplicado el 2026-10-10 a las 19:53 UTC)

Corrige, para un par de fechas, la entrada de este mismo día «se retiraron 945 actos que un boletín repetido dejó con dos fechas». Aquella limpieza conservó la primera fecha en los ocho boletines repetidos. Una medición posterior muestra que INAPI registra el acto con la primera fecha en todos menos uno: los 111 actos del par 2025-10-09 / 2025-10-10 llevan en la ficha de expediente de INAPI la fecha 2025-10-10 (111 de 111). El boletín que INAPI sirve con fecha del 9 trae la tabla del 10.

  • Aplicado el 2026-10-10 a las 19:53 UTC (lote d5a-boletin-repetido-par-261010): 111 filas restauradas con su id, 111 gemelas retiradas. Tras aplicar, el 2025-10-09 tiene 0 filas D5A del boletín y el 2025-10-10 tiene 111.
  • Las 111 anotaciones retiradas el 2026-10-10 a las 10:22 UTC con fecha 2025-10-10 vuelven a existir, tal como eran: mismo id, mismos campos.
  • Sus 111 gemelas con fecha 2025-10-09 se retiran: su id deja de existir y GET /annotations/{id} responde 404. El 2025-10-09 queda sin ninguna anotación D5A.
  • El total de anotaciones no cambia (+111 −111). No cambia ninguna marca, y esto no genera avisos de vigilancia.
  • Unas 80 anotaciones que la ficha de expediente fecha el 2025-10-09 no están en ningún boletín: siguen como anotación de la ficha de expediente en su marca, sin fila D5A.

Qué hacer: si guardas anotaciones D5A del 2025-10-09 o del 2025-10-10, o sus id, vuelve a leerlas: ya está aplicado.

2026-10-10 · [DATA] Las marcas del import antiguo: 32.500 leídas de la ficha de expediente de INAPI; ganan categoría, tipo de signo y fechas de registro y vencimiento

Hasta hoy, las marcas que llegaron el 2026-06-29 sólo con el import del sistema antiguo (presentadas entre 1995 y 2008, más 812 de Madrid) no habían sido leídas nunca de la ficha de expediente. Terminada la carga a las 06:24 UTC del 2026-10-10: 32.500 marcas leídas, 32.500 peticiones (una por marca), todas con resultado cambio, ninguna ficha ajena, ninguna recuperada por búsqueda ni reintento pendiente. Ninguna denominación ni número de registro cambió con la visita. Afecta a GET /trademarks/{applicationNumber} ≡ get_trademark, al calendario de renovaciones, a GET /nice-classes/{niceClass}/stats ≡ get_class_stats y al feed por detectedAfter.

  • Cada marca leída pasa por el escritor de siempre: gana su categoría, tipo de signo y fechas de registro y vencimiento cuando la ficha de expediente las informa, y su updatedAt se mueve. Quedan sin categoría 1 marca (eran 27.301 tras el relleno de la entrada del 2026-10-09).
  • Las anotaciones posteriores a la última lectura del sistema antiguo salen en el feed por detección (detectedAfter) como recién detectadas, con su fecha real, que puede ser de hace meses.
  • Los números base de Madrid con un expediente con letra (135) quedaron congelados antes de la carga y no se leyeron.
  • La forma no cambia.

Qué hacer: si guardas copia de estas marcas, vuelve a leerlas; repite cualquier medición de estadísticas por clase o de vencimientos que las contara como sin categoría o sin fecha.

2026-10-10 · [BEH] Estadísticas por clase: la observación de fondo cuenta las decisiones anteriores a 2012 que citan una causal; W152 y W147 pasan a la familia resolucion

GET /nice-classes/{niceClass}/stats ≡ get_class_stats, y el catálogo de secciones (GET /sections ≡ list_sections, sectionFamily en las anotaciones). La forma no cambia.

actsShare.substantiveObjection. Hasta febrero de 2012 INAPI no publicaba la observación de fondo como un acto propio: de antes sólo queda la decisión final. Desde hoy la cifra cuenta, además de los actos de la familia fondo, la marca cuya decisión final de esa época —el rechazo W160 «Rechaza Resolucion (Plazo 15 Apelacion)» o la aceptación parcial W152 «Aceptada parcial (c/limitacion)»— cita el artículo 19 o el 20 de la Ley 19.039 (las causales de rechazo). Un W160 que no cita ninguno de los dos, por ejemplo el que rechaza una renovación, no cuenta.

año de presentación antes ahora marcas
2009 160 (0,3 %) 3.599 (6,8 %) 52.975
2010 590 (1,0 %) 4.341 (7,5 %) 57.501
2011 6.670 (9,8 %) 6.940 (10,2 %) 67.859
2004–2008 12 137 6.208
2012 en adelante sin cambio sin cambio

(Todas las clases; una marca cuenta una vez por clase.) Por clase y para 2009–2011, por ejemplo: clase 35, de 834 a 1.621 de 13.376; clase 41, de 544 a 1.274 de 10.515.

  • La cifra de esos años es un mínimo: una observación que el solicitante superó no dejó acto. La nota substantive_objection_history_limited, el coverageNote del campo y definition lo dicen con el texto nuevo, en los tres idiomas. El código de la nota no cambia; ahora sale también cuando el periodo empieza en 2011 (antes, sólo si empezaba antes de 2011): las marcas de 2011 también ganan decisiones y su cifra también es un mínimo.
  • El periodo por defecto (los últimos cinco años) no cambia, así que la señal de observación de fondo de GET /reports/registration-signals ≡ get_registration_signals tampoco.
  • dataAsOf de las estadísticas pasa al momento de este cambio.

Catálogo de secciones. W152 «Aceptada parcial (c/limitacion)» (499 anotaciones) y W147 «Fallo Notif. Aceptada Parcial (15 ds.Ap)» (310): sectionFamily pasa de null a resolucion, la familia de sus equivalentes actuales 444 y 485. El filtro family=resolucion devuelve 809 anotaciones más. W160 sigue en resolucion, y la familia fondo no cambia: es el examen (formular la observación y resolverla); la decisión final es resolucion.

Ningún plazo, alerta ni estado cambia.

Qué hacer: repite cualquier medición de actsShare.substantiveObjection que incluya años anteriores a 2012, y no la presentes como comparable con la de los años posteriores. Si guardas familias de sección, vuelve a leer GET /sections.

2026-10-10 · [DATA] Estado Diario, segunda tabla del boletín de tipo 5: se leen tres formas de fila que el lector saltaba; el 2026-10-10 entraron 1.007 actos de los días pasados

Sección D5A (actos sobre marcas inscritas): annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin. La forma no cambia.

Medido sobre los 617 boletines de tipo 5 del archivo (2024-04-19 → 2026-10-07): quedaban 1.321 filas sin leer en 92 boletines. Desde hoy se leen tres formas: el número de registro impreso con seis cifras, sin el cero a la izquierda (637 filas); el acto partido en dos líneas (232); y la página compuesta con otros márgenes (241).

  • Desde hoy, un boletín impreso de cualquiera de esas tres formas se lee como los demás. Para un boletín impreso de la forma habitual no cambia nada.
  • Aplicado el 2026-10-10 a las 10:21 UTC (lote boletines-archivo-261010-formas): entraron 1.007 anotaciones D5A nuevas en 78 días, del 2025-09-11 al 2026-09-28: 473 con el registro de seis cifras, 232 con el acto en dos líneas, 231 de páginas con otros márgenes y 71 filas más del boletín del sábado 2025-12-13 (73 ese día en total), que se había dejado fuera de la recuperación del 2026-10-09. Ninguna se completó, y las 7.100 filas de esos días que ya estaban no se tocaron. Anotaciones: 11.476.209 → 11.477.216 (+1.007). Marcas (846.141), cola de la ficha de expediente y movement_log no se movieron.
  • No se leen 211 filas de 3 boletines (2024-11-13, 2025-01-06 y una del 2026-09-24) que no imprimen el número de registro: sin él no se puede saber con seguridad de qué marca es el acto.
  • Las filas nuevas llevan como fecha de detección (detectedAfter) el día en que entraron (2026-10-10), con date de 2025 y 2026. No se generó ningún movimiento ni ningún aviso de vigilancia.

Qué hacer: filtra también por date o ignora ese lote en el feed por detección, y repite cualquier medición que contara anotaciones D5A de esos días.

2026-10-10 · [DATA] Estado Diario, sección D5A: se retiraron 945 actos que un boletín repetido dejó con dos fechas: queda sólo la primera

Doce boletines de tipo 5 traen, con su propia fecha, la segunda tabla de un boletín anterior: los mismos actos, con el mismo número de anotación de INAPI. Ocho de ellos se ingirieron, así que el mismo acto figura dos veces, con dos fechas. Vale la primera fecha.

  • Aplicado el 2026-10-10 a las 10:22 UTC (lote d5a-boletin-repetido-261010): se retiró la copia de la fecha posterior, 945 anotaciones, del 2025-05-16 (113), 2025-05-20 (81), 2025-06-16 (110), 2025-09-10 (125), 2025-10-01 (171), 2025-10-10 (111), 2026-06-05 (93) y 2026-07-03 (141). Cada una tenía su gemela exacta (misma marca, misma sección, mismo texto) en la fecha primera (2025-05-15, 05-19, 06-13, 09-09, 09-29 o 09-30, 10-09, 2026-06-04 y 07-02), que se queda; ninguna colgaba de otra fila. Anotaciones: 11.477.216 → 11.476.271 (−945).
  • El id de una anotación retirada deja de existir: GET /annotations/{id} responde 404.
  • Los otros cuatro boletines repetidos (2025-10-23, 2025-10-30, 2025-11-20 y 2026-09-14) nunca entraron y siguen fuera: sus actos ya están con la primera fecha.
  • No cambia ninguna marca, y esto no genera avisos de vigilancia.

Qué hacer: si guardas anotaciones D5A de esas ocho fechas, o sus id, vuelve a leerlas.

2026-10-10 · [BEH] Los domingos no hay sincronización: dataAsOf no avanza ese día y stale no cuenta los domingos

GET /system/freshness ≡ get_system_freshness, meta.dataAsOf y el aviso «sync terminado». Misma forma; cambia la cadencia. La sincronización diaria deja de correr los domingos (hora de Chile; INAPI no publica Estado Diario en domingo). De lunes a sábado corre como antes.

  • El domingo dataAsOf no avanza (sigue en el sábado) y no se envía el aviso sync.finished. El lunes la sincronización recoge todo lo acumulado y no se pierde nada.
  • stale no da falsa alarma por el domingo: sin thresholdHours, cada domingo de Chile entre la última ingesta de la fuente y ahora se descuenta de su edad antes de compararla con el umbral (24 h). Si la del lunes no llega, la fuente pasa a stale; una caída entre semana sigue marcándose a las 24 h.
  • stalenessSeconds es siempre la edad real. Con thresholdHours explícito el umbral significa exactamente eso, sin descuento.

Qué hacer: nada, salvo no esperar un dataAsOf nuevo ni un webhook sync.finished los domingos. Si fijas thresholdHours, súmale tú el domingo (p. ej. 54).

2026-10-09 · [DATA] Registros de Madrid con divisionales: la ficha del número base deja de recibir los datos de otra serie

GET /trademarks/{applicationNumber} ≡ get_trademark. En hasta 58 registros del Protocolo de Madrid, la fuente respondía a la consulta por el número base con los datos de una solicitud divisional del mismo registro, y la ficha del número base los mostraba. Desde hoy una respuesta que no corresponde al número consultado no se guarda: la ficha pasa a mostrar sus propios datos cuando la fuente los entrega, y si no, conserva los que tenía. Sin cambio de forma.

Qué hacer: si guardas copia de marcas del Protocolo de Madrid (números de 9 cifras), vuelve a leerlas; clases, estado, número de registro e historial pueden cambiar en esas pocas marcas.

2026-10-09 · [DATA] Estado Diario del 2024-10-03 al 2026-10-07: entran 10.159 actos de la segunda tabla del boletín de tipo 5 que el barrido diario no leía

El barrido diario no leía la segunda tabla del boletín de tipo 5 (actos sobre marcas inscritas, sección D5A) cuando el número de registro salía de su columna. Medido sobre el archivo propio, 511 boletines de tipo 5 del 2024-09-30 al 2026-10-07: 111 con la tabla fuera de banda, 10.775 filas perdidas, la primera el 2024-10-03. En producción entran 10.159 anotaciones nuevas en 106 días (2024-10-03 → 2026-10-07; annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin).

  • Anotaciones: 11.463.897 → 11.474.056 (+10.159). Las D5A con fecha desde el 2024-10-01: 43.057 → 53.216. Sin duplicados. No se crea ninguna marca ni se completa ninguna anotación existente.
  • De las 10.775 filas, 60 repiten dentro del lote la misma marca y el mismo acto, y 556 no entran: cuatro boletines que repiten los actos del día hábil anterior (2025-10-23, 2025-10-30, 2025-11-20 y 2026-09-14; 484 filas) y el del sábado 2025-12-13 (72 filas). Aparte, 1.321 filas que ningún lector lee todavía. Se deciden aparte.
  • Desde el boletín del 2026-10-08 el barrido diario lee esa tabla por sí mismo (ese día: 130 actos, en banda).
  • Los contadores diarios de altas de 15 de esos días, que ya tenían fila, suman ahora 1.252 (/system/coverage).

⚠ Las filas nuevas se crearon el 2026-10-09, la fecha que usa detectedAfter, así que 10.159 actos antiguos salen como detectados hoy aunque su date sea de 2024 a 2026. No se generó ningún movimiento, ninguna petición a la ficha de expediente ni ninguna alerta de vigilancia.

La forma no cambia: ningún campo se añade ni se quita.

Qué hacer: filtra también por date o ignora el lote del 2026-10-09. Repite cualquier medición que contara anotaciones D5A desde el 2024-10-03.

2026-10-09 · [BEH] Vigilancia: el aviso de serie llega también al empezar a vigilar y en la revisión diaria

El aviso directo de una serie del registro que vigilas (relation: "series" en GET /watch/hits ≡ list_similarity_hits) ya no depende sólo de la pasada que sigue a una carga de series. Misma forma, mismos campos y mismos valores; cambia cuándo llega. Todavía no hay ninguna serie adicional cargada: ninguna respuesta cambia hoy.

  • Al empezar a vigilar una solicitud de un registro de Madrid —el número base o una serie—, normalmente al terminar su búsqueda inicial ya tienes las demás series vivas del registro, compartan o no clase con la tuya; en todo caso, como muy tarde con la revisión diaria siguiente (por ejemplo, si vuelves a vigilar una solicitud que habías dejado hace poco, su búsqueda no se repite). Antes sólo llegaban al momento las que compartían clase.
  • Una serie que estaba en estado terminal y revive se avisa en la revisión diaria siguiente. Antes podía quedarse sin aviso.
  • La revisión diaria avisa también de cualquier otra serie viva de tu registro que todavía no tuvieras en la lista. Puede tardar hasta un día.
  • origin conserva sus tres valores y sigue diciendo quién escribió el elemento: un aviso de serie puede llevar baseline (la búsqueda inicial), sync (la revisión diaria) o series_load (la pasada que sigue a una carga). No distingue un aviso de una parecida: eso lo dice relation.
  • Siguen igual: un elemento por solicitud vigilada y serie, nunca la serie que ya vigilas ni el número base, nunca una serie en estado terminal, «lo propio no es amenaza» y el cursor. Un aviso que ya tenías no se repite ni cambia de id.

Detalle: Aviso directo: una serie nueva del registro que vigilas.

Qué hacer: nada si distingues el aviso por relation === "series". Si lo detectabas con origin === "series_load", cambia a relation.

2026-10-09 · [BREAK] Vigilancia: aviso directo de una serie nueva del registro que vigilas — relation: "series", score puede ser null, origin gana series_load

Quien vigila una solicitud de un registro de Madrid —su número base (991652209) o una de sus series (991652209-2)— recibe en GET /watch/hits ≡ list_similarity_hits un elemento por cada una de las demás series adicionales de ese registro (991652209-3), aunque no comparta ninguna clase con la vigilada: la búsqueda de parecidas, que trabaja dentro de las clases de la solicitud vigilada, nunca la habría encontrado. Todavía no hay ninguna serie adicional cargada: ninguna respuesta cambia hoy. Va como [BREAK] porque un campo cambia de tipo y un vocabulario crece.

  • relation (nuevo, opcional; único valor "series"): sólo presente cuando la solicitud de matched es una serie adicional del mismo registro que la solicitud vigilada (sea ésta el número base u otra serie). En una parecida corriente la clave no viaja.
  • score: de number a number | null. null sólo en un elemento con relation que el motor de parecido no encontró; no se inventa un puntaje, y signals es entonces {}. Sin relation es siempre un número.
  • origin: gana series_load (lo escribió la pasada que sigue a una carga de series), junto a baseline y sync.
  • Si la serie además comparte clase y el motor la encuentra, es el mismo elemento (un solo id), con relation: "series" y su score real: nunca dos elementos por la misma serie.
  • El cursor, el filtro applicationNumber, «lo propio no es amenaza» y el cierre por estado terminal funcionan igual. No se cierra por «ya no se parece»: sólo pierde el score.
  • Recibe el aviso quien vigila el número base y quien vigila otra serie del registro. Es un elemento por solicitud vigilada: si vigilas a la vez 991652209 y 991652209-2, la serie 991652209-3 te llega dos veces, una bajo cada una (como cualquier parecida de dos de tus vigiladas). Nunca se avisa de la serie que ya vigilas, ni del número base: sólo son noticia las series adicionales.
  • Una parecida sin relation, y la respuesta entera de quien no vigila ningún registro con series, no cambian.

Detalle y ejemplo: Aviso directo: una serie nueva del registro que vigilas.

Qué hacer: aceptar score: null y origin: "series_load" en los elementos de GET /watch/hits, y distinguir el aviso por relation === "series": preséntalo como una serie nueva de tu registro, no como una marca parecida, y no des por hecho que score es un número al ordenar o filtrar.

2026-10-09 · [DATA] category se lee también de la ficha de expediente de INAPI: las marcas que sólo conoce la ficha de expediente dejan de salir sin categoría

La ficha de expediente de INAPI informa la categoría de registro de cada marca (marca, marca del Protocolo de Madrid, frase de propaganda…) y hasta hoy ese dato no se leía. Una marca cuya única fuente era la ficha de expediente salía sin category en GET /trademarks/{applicationNumber} ≡ get_trademark. La forma no cambia y no hay códigos nuevos: son los mismos siete.

  • Desde hoy, cada marca que se actualiza desde la ficha de expediente recibe su category (y categoryLabel) si no la tenía. Una categoría que ya estaba no se sustituye.
  • Aplicado el 2026-10-10 (00:02 UTC), lote categoria-detalle-261010. Las marcas actualizadas antes se rellenaron con lo que la ficha de expediente ya había informado: 5.820 marcas ganaron su categoría (792 del Protocolo de Madrid); las marcas sin categoría pasaron de 33.121 a 27.301. Ninguna dudosa ni en conflicto.
  • Las 27.301 restantes no tenían detalle guardado: las cubrió la carga de las marcas del import antiguo (entrada del 2026-10-10 más arriba), tras la cual queda 1 marca sin categoría. Nada se adivina.
  • Ganar la categoría no cuenta como un cambio de la marca: no genera avisos de vigilancia ni anotaciones nuevas.
  • GET /nice-classes/{niceClass}/stats ≡ get_class_stats: una marca que resulta ser de categoría marca pasa de population.excludedUnknownCategory a population.filed en cada una de sus clases; una que resulta ser de otra categoría sale de excludedUnknownCategory sin entrar en filed. Las del Protocolo de Madrid nunca se contaron en ninguna de las dos cifras: para ellas no cambia nada.
  • scope no cambia: la ficha de expediente no informa el ámbito de protección.

Qué hacer: nada. Si guardas copia de las marcas, vuelve a leer las que tengas sin category; si muestras excludedUnknownCategory, espera que baje.

2026-10-09 · [DATA] Citas de norma de las 6.450 anotaciones de 2024 con el texto completo: 5.010 añadidas; 302 que el texto completo ya no respalda, retiradas el 2026-10-10

Continúa la entrada del 2026-10-08 (6.450 anotaciones M del Estado Diario de 2024 pasaron a llevar el texto completo del boletín). Afecta a las citas de norma de esas anotaciones: GET /annotations/{id}?expand=citations ≡ get_annotation, GET /trademarks/{n}?expand=norms ≡ get_trademark, los filtros citedNorm, article y letter de las búsquedas, las citedNorms de los informes y los artículos de GET /legal-norms ≡ list_legal_norms. La forma no cambia.

  • Hecho. Del texto que faltaba se leyeron 5.010 citas nuevas en 2.118 anotaciones (4.865 de la Ley 19.039, 125 de su Reglamento, 19 de la Ley 19.880 y 1 de la Ley 18.575). Las anotaciones del grupo con alguna cita pasan de 6.044 a 6.279.
  • Retiradas el 2026-10-10 (00:06 UTC), lote normas-prosa-261010. El texto cortado producía algunas citas que el completo no respalda: un «artículo 1» que era el principio de un «artículo 19», un artículo 20 sin la letra que el texto completo sí trae, una cita sin ley cuya ley ahora se lee. Se retiraron 302 citas en 262 anotaciones, ninguna de las que nombran su ley de forma expresa. Las citas de las 6.450 anotaciones pasan de 23.664 a 23.362; una anotación queda sin ninguna cita. Marcas, anotaciones y enlaces de persona no se mueven.
  • No se añade ni se quita ninguna anotación ni ninguna marca, y esto no genera avisos de vigilancia.

Qué hacer: nada. Si contaste o guardaste citas de norma de anotaciones M de 2024, repite la medición desde el 2026-10-10.

2026-10-08 · [ADD] Series de un registro de Madrid: baseApplicationNumber, seriesSuffix y relatedSeries; una serie se puede vigilar

Un registro internacional (Protocolo de Madrid) puede tener más de una serie en Chile. INAPI numera cada serie adicional con el número de la primera más un sufijo (991652209-2) y la trata como una solicitud aparte; el contrato la sirve como una marca más, con su número de registro, sus clases y su historial. Todavía no hay ninguna serie adicional cargada: esta entrada describe la forma con la que llegarán.

  • baseApplicationNumber y seriesSuffix: sólo en una serie adicional, en la colección, la búsqueda, la similitud, el lote, las marcas de una parte, los informes y la ficha (GET /trademarks, POST /trademarks/search ≡ search_trademarks, GET /trademarks/{applicationNumber} ≡ get_trademark, GET /parties/{id}/trademarks ≡ list_party_trademarks y los informes).
  • relatedSeries[]: en la ficha de cualquier serie de un registro con varias; lista las otras, con applicationNumber, seriesSuffix (null en la serie 1), registrationNumber, status, classes y registeredOn.
  • Los tres campos se omiten en cualquier otra marca: su respuesta no cambia.
  • En búsquedas, similitud, lote y cartera la marca sale una vez por serie. En GET /trademarks/renewal-calendar ≡ get_renewal_calendar sale una línea por registro: una serie adicional nunca tiene fila propia.
  • POST /watch/applications ≡ watch_application (y DELETE ≡ unwatch_application, y el filtro applicationNumber de GET /watch/hits ≡ list_similarity_hits) aceptan, además de 1 a 12 dígitos, el número de una serie (991652209-2). Cualquier otra forma sigue siendo 400 validation_error.

Detalle y ejemplos: Series de un registro de Madrid.

Qué hacer: aceptar un número de solicitud con guion y sufijo (letras o dígitos) allí donde hoy exijas sólo dígitos, y no quitar el sufijo al normalizar: 991652209-2 y 991652209 son dos marcas distintas. Si muestras la ficha, pinta relatedSeries como «este registro internacional tiene N series».

2026-10-08 · [BEH] Estadísticas por clase: coverage deja de declarar una ventana con boletín sólo del import antiguo

GET /nice-classes/{niceClass}/stats ≡ get_class_stats avisaba de que, del 2024-04-19 al 2024-09-29, el único boletín del corpus era el de la importación antigua. Desde hoy el corpus tiene el Estado Diario de esos días, así que el aviso se retira. Ninguna cifra cambia: las estadísticas nunca se calcularon distinto dentro de esa ventana.

  • coverage.windows sale siempre como lista vacía (traía un elemento, legacy_only_bulletin_window). El campo sigue.
  • coverage.notes[] deja de emitir y de declarar legacy_only_bulletin_window; quedan cinco códigos.
  • coverage.annotationSources[]: la descripción de estado_diario dice «ingerido desde 2024-04-19» (antes 2024-09-30) y la de legacy_mongo ya no dice que sea el único boletín de ningún periodo.
  • No cambia la nota de actsShare.opposition: las relaciones de oposición siguen existiendo sólo desde el 2024-09-30.

Qué hacer: si enumerabas los códigos de coverage.notes[].code, retira legacy_only_bulletin_window; si mostrabas el aviso de esa ventana, deja de mostrarlo.

2026-10-08 · [BEH] C11N y C11C ganan nombre; C11N entra en la familia oposicion

Dos códigos de sección que llegaron con el Estado Diario de 2024 no tenían nombre. Ahora traen el encabezado literal del boletín: C11N «Citaciones a oír sentencia en juicios de Nulidad» y C11C «Citaciones a oír sentencia en juicios de Caducidad». Sus 24 anotaciones (23 y 1) dejan de salir con sectionName: null, y GET /sections ≡ list_sections los devuelve con label en los tres idiomas.

  • C11N toma la familia oposicion, la de sus hermanas de la serie de nulidad: sus 23 anotaciones responden al filtro family=oposicion. C11C sigue con family: null.
  • Por eso actsShare.opposition de get_class_stats puede subir en unas pocas marcas (como mucho 23 anotaciones en todas las clases) tras el siguiente recálculo.
  • meta.dataAsOf de GET /sections ≡ list_sections pasa a 2026-10-08T00:00:00.000Z.

Qué hacer: nada, salvo que hubieras guardado el nombre nulo de esos dos códigos.

2026-10-08 · [DATA] Estado Diario 2024: 6.450 anotaciones con el texto cortado pasan a llevar el texto completo del boletín

El import antiguo guardó la observation de muchas anotaciones del Estado Diario de 2024 cortada hacia los 2.000–2.500 caracteres. En producción se sustituyó el texto de 6.450 anotaciones de la familia M por el texto completo del boletín (observation en todas las vistas de anotación: annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin).

  • Por sección: M3 2.770 · M6 1.647 · M11 1.468 · M1 259 · M4 232 · M2 68 · M7 6. Longitud mediana 2.186 → 4.353 caracteres.
  • En 2.069 el texto completo es nuevo para el contrato. En el resto ya se servía por observationDerived (lo traía la hermana de la ficha de expediente): ahí observation pasa a estar completa.
  • 24 anotaciones se dejaron fuera a propósito (su hermana de la ficha de expediente habría dejado de ser comparable).
  • No cambia nada más: no se añade ni se quita ninguna anotación, y el id, la fecha y las demás columnas conservan su valor. El texto nuevo es la lectura de nuestro lector del boletín, así que algunas palabras que el import antiguo había pegado ahora salen separadas. La cadena de esa noche añade citas de norma a partir del texto largo (unas +5.010 previstas, aún sin medir).

La forma no cambia: ningún campo se añade ni se quita.

Qué hacer: si guardaste o calculaste huellas del texto de estas anotaciones, vuelve a leerlas. Repite cualquier medición que buscara o contara palabras en anotaciones M de 2024.

2026-10-08 · [DATA] Estado Diario del 2024-04-19 al 2024-09-27: entran 681 actos que el lector de PDF no leía

El lector de PDF se saltaba algunas entradas de los boletines de 2024. Con el lector arreglado entran 681 anotaciones nuevas, casi todas de la sección D5A, en 11 días (annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin): 2024-04-19 1 · 04-30 77 · 05-16 2 · 05-20 1 · 05-23 145 · 06-13 2 · 06-26 87 · 07-03 129 · 08-22 62 · 08-26 103 · 09-24 72. Los 77 del 2024-04-30 llegaban con el acto pegado al nombre de la marca; se guardan con el acto separado (57 «Anotación de Cambio de nombre» y 20 «Anotación de Transferencia total»).

  • Anotaciones del periodo: 438.815 → 439.496, sin duplicados. No se completa ninguna existente ni se crea ninguna marca.
  • No entran: las 354 entradas del boletín de tipo 5 archivado bajo el 2024-05-21, feriado en Chile. El fichero no trae fecha impresa y tiene 53 páginas frente a las 17–19 habituales; la hipótesis de que acumula los de tipo 5 del 16, 17 y 20 de mayo no está confirmada. Esperan a que INAPI aclare la fecha de notificación.

⚠ Las filas nuevas se crearon el 2026-10-08, la fecha que usa detectedAfter, así que los 681 actos antiguos salen como detectados hoy aunque su date sea de 2024.

La forma no cambia: ningún campo se añade ni se quita.

Qué hacer: filtra también por date o ignora el lote del 2026-10-08. Repite cualquier medición que contara anotaciones de 2024 de la sección D5A o de esos días.

2026-10-08 · [DATA] Estado Diario del 2024-04-19 al 2024-09-27: entran 927 «segundos actos» más, y el trabajo de 2024 queda completo

Un «segundo acto» es una entrada del boletín sobre la misma marca, día y sección que otra, pero que dice algo distinto (por ejemplo, una segunda resolución el mismo día). Se dejaron fuera del primer lote a propósito; ya están dentro.

  • 927 anotaciones nuevas, todas de la sección M11, repartidas en 106 de los 108 días hábiles (annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin).
  • 4 entradas no se insertan (todas del 2024-06-17, M11): tres son la misma resolución que una fila que ya existe y una es un acto distinto cuyo texto el lector de PDF destrozó. Su revisión sigue abierta.
  • En total, el trabajo del archivo de 2024: 45.672 anotaciones nuevas (44.745 + 927) y 69.532 existentes completadas. Anotaciones del periodo: 393.143 → 438.815, sin duplicados. No se crea ninguna marca.

⚠ Igual que el primer lote: las filas nuevas se crearon el 2026-10-08, la fecha que usa detectedAfter, así que salen como recién detectadas aunque su date sea de 2024.

La forma no cambia: ningún campo se añade ni se quita.

Qué hacer: filtra también por date o ignora el lote del 2026-10-08. Repite cualquier medición que contara anotaciones de 2024 de la sección M11.

2026-10-08 · [DATA] Estado Diario del 2024-04-19 al 2024-09-27: entran 44.745 anotaciones que faltaban y 69.532 existentes ganan sus partes

El corpus tenía el Estado Diario de esos 108 días hábiles sólo como lo dejó la importación antigua: únicamente la familia M, con representante, solicitante y tipo_resolucion vacíos. Ahora tiene también los boletines mismos, leídos de un archivo público (213 PDF).

  • 44.745 anotaciones nuevas (annotations[] de la ficha, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, POST /annotations/search ≡ search_annotations, get_daily_bulletin): familia A 20.330, familia C 12.721, D5A 10.901, familia M 793. Antes no había ninguna fila de las familias A, C ni D5A del Estado Diario en ese periodo.
  • 69.532 anotaciones existentes de la familia M ganan sus partes (representante, solicitante) y tipo_resolucion, que tenían vacíos. Su texto, su id y su fecha no cambian.
  • Anotaciones del periodo: 393.143 → 437.888, sin duplicados. No se crea ninguna marca.
  • No entran: el boletín de tipo 5 del 2024-05-29 (INAPI publicó ahí el del 2024-04-29), los actos D5A del 16, 17 y 20 de mayo de 2024 (ese boletín no está en el archivo), 14 entradas de marcas que no están en el corpus, 78 actos que el lector no resuelve y los «segundos actos» del mismo día, que entraron después en un lote propio (ver la entrada siguiente).

⚠ Las filas nuevas se crearon el 2026-10-08, y esa es la fecha que usa el filtro de detección: POST /annotations/search ≡ search_annotations con detectedAfter las devuelve como recién detectadas aunque su date sea de 2024.

La forma no cambia: ningún campo se añade ni se quita.

Qué hacer: si tratas cada resultado de detectedAfter como una novedad, filtra también por date o ignora el lote del 2026-10-08 (~45.000 actos antiguos). Repite cualquier medición que contara anotaciones de 2024 por familia o sección.

2026-10-07 · [BEH] Los parámetros booleanos sólo admiten true o false: cualquier otro valor es un 400 validation_error

Hasta hoy, liveOnly, allClasses y transitional leían como false cualquier valor que no fuera true o 1: GET /trademarks?liveOnly=yes respondía 200 con el resultado sin filtrar y sin avisar, aunque la referencia declara el parámetro como booleano. Desde hoy un valor que no sea exactamente true o false (en minúsculas) responde 400 validation_error, con el parámetro en errors[].field, igual que el resto de parámetros inválidos. Eso incluye yes, si, TRUE, el valor vacío (?liveOnly=), el parámetro repetido y también 1 y 0, que antes se aceptaban.

  • liveOnly: GET /trademarks, POST /trademarks/search ≡ search_trademarks; GET /trademarks/renewal-calendar ≡ get_renewal_calendar; GET /insights/trademarks, POST /insights/trademarks/search ≡ get_trademark_insights.
  • allClasses: GET /trademarks, POST /trademarks/search ≡ search_trademarks.
  • transitional: GET /legal-norms/{id}/articles/{article}.

En el cuerpo JSON y en el MCP el valor es un booleano de JSON (true / false); un texto como "yes" o un número, que antes se leían como false, ahora se rechazan. true, false y el parámetro ausente devuelven exactamente lo mismo que antes. dedupe ya se comportaba así y no cambia.

Qué hacer: si envías liveOnly=1, allClasses=1 o transitional=1, cámbialo por true; si envías 0, por false o quita el parámetro. Si enviabas otro valor, el filtro no se estaba aplicando: revisa los resultados que obtuviste con él.

2026-10-07 · [BEH] Secciones: D5A son anotaciones presentadas, W088 y W635 llevan el nombre de INAPI, y renewals[] deja de contar D5A

Cambian valores del catálogo de secciones (GET /sections ≡ list_sections) y de los campos que lo citan en las anotaciones (sectionName, sectionLabel, sectionFamily). La forma no cambia.

  • D5A pasa de «Anotaciones inscritas (segunda tabla del boletín de altas)» a «Anotaciones presentadas (segunda tabla del boletín de altas)». Esa tabla del Estado Diario lista los escritos de anotación presentados ese día: la inscripción llega después (unos 34 días de mediana) o no llega (algunas se rechazan o se abandonan).
  • renewals[] y lastRenewalOn (GET /trademarks/{applicationNumber} ≡ get_trademark) ya no cuentan ninguna fila D5A. Hasta hoy sólo quedaba fuera D5A + ARENTLT; con otros actos de renovación (AREPTLT, AREN, AREP) la fila salía como renovación. Las filas siguen en annotations[].
  • W088: «Aceptase Tramitación (Publicación)» → «Por Cumplido lo Ordenado»; sectionFamily pasa de publicacion a null. W635: «Cúmplase» → «Por interpuesto recurso de apelacion.-»; sectionFamily pasa de resolucion a null. Son los nombres que publica INAPI; los anteriores eran deducidos. Afecta a anotaciones de 2002 a 2012.
  • W160 «Rechaza Resolucion (Plazo 15 Apelacion)» y W148 «Fallo Notif. Rechazado (15 dias Apela)»: sectionFamily pasa de null a resolucion, la familia de sus equivalentes actuales 024 y 486. Son los rechazos anteriores a febrero de 2012; el filtro family=resolucion ahora los devuelve.
  • meta.dataAsOf de GET /sections pasa al 2026-10-07.

Las estadísticas por clase no cambian: ningún código W entra en la familia fondo.

Qué hacer: si guardaste nombres o familias de sección, vuelve a leer GET /sections. Si mostrabas una fila D5A como anotación inscrita o como renovación hecha, muéstrala como presentada; la renovación consumada está en renewals[].

2026-10-07 · [FIX] MCP: el guion weekly_watch pagina mientras hasMore sea true, y las descripciones de las herramientas dicen lo que hacen

El guion weekly_watch pedía recorrer list_similarity_hits «hasta que next sea nulo»; desde hoy esa lista devuelve siempre next, así que el guion no terminaba. Ahora pagina mientras hasMore sea true. availability_check y la descripción de search_trademarks nombran los canales reales del motor de parecido de similarTo (fonético, léxico, semántico y de elemento distintivo) y remiten a matchedBy. get_party, get_legal_norm, get_section, get_system_freshness y list_sync_runs dicen qué permiso exigen y qué devuelven ante un identificador desconocido. Sin cambios en entradas, respuestas ni en la API REST.

Qué hacer: nada. Si copiaste el guion weekly_watch en tu propio agente, cambia la condición de parada a hasMore.

2026-10-07 · [FIX] Subencargados: Supabase sólo interviene en la aplicación Tarno

La lista de subencargados y el encargo de tratamiento describían a Supabase como almacén de la vigilancia y de los trabajos por lotes. La vigilancia se guarda en la base de datos del Servicio y los trabajos por lotes ya no existen. Supabase sigue siendo subencargado sólo para la aplicación Tarno (cuentas de usuario y datos de la aplicación). El encargo de tratamiento deja de listar los trabajos por lotes y su plazo de supresión de 30 días.

Qué hacer: nada. Los datos que tu organización escribe en la API y el MCP no salen hacia Supabase.

2026-10-07 · [BEH] GET /trademarks/{applicationNumber}/deadlines ≡ get_deadlines: se publica la fecha límite para apelar una aceptación parcial (444)

Hasta hoy la fecha límite de apelación sólo se daba para un rechazo (024); una marca cuyo movimiento resolutivo más reciente era una aceptación parcial (444) salía en omitted[] con partial_acceptance_not_published. Ahora el 444 ancla igual que el 024: el 15.º día hábil estrictamente posterior a su publicación en el Estado Diario, con las mismas tres normas (Ley 19.039 art. 17 bis B y art. 11, Ley 19.880 art. 25). INAPI cuenta el plazo desde el Estado Diario, y su Res. Ex. 138/2022 dice que el correo es un aviso de cortesía que no sustituye la notificación legal.

  • deadlines[].anchor.sectionCode puede valer "024" o "444" (antes, siempre "024"). anchor.kind sigue siendo rejection_notice: en una aceptación parcial se apela la parte de la cobertura que no se aceptó.
  • Entre un 024 y un 444 ancla el más reciente; a igual fecha, el 024. Si después hay resoluciones que no anclan, la fecha se calcula desde el más reciente de los dos, con caveat: later_resolution_on_record.
  • omitted[].reason deja de emitir y de declarar partial_acceptance_not_published; quedan cuatro valores. Una designación de Madrid, un ancla en día inhábil o un tramo fuera del calendario declarado se siguen omitiendo con su motivo, también para un 444; nunca se estima.
  • El hito appeal_close de milestones[] aparece ahora también en las marcas cuyo movimiento resolutivo más reciente es un 444, con la misma forma. En una solicitud vigilada en rechazada o denegada con un 444 como movimiento más reciente, watchEndsOn pasa a ser esa fecha (watchEndBasis: "appeal_close").

Qué hacer: acepta "444" en anchor.sectionCode; si enumerabas los motivos de omitted[].reason, retira partial_acceptance_not_published; y cuenta con el hito appeal_close en marcas con una aceptación parcial.

2026-10-07 · [BEH] POST /watch/applications ≡ watch_application: el tope del plan es el de la organización, el mismo para todas sus claves

El tope de solicitudes vigiladas activas (watch_limit_reached, limit) es ahora el de tu organización, la misma unidad sobre la que siempre se contaron las solicitudes vigiladas. Antes se leía de la clave que hacía la petición: con dos claves de una organización y topes distintos, una podía dar de alta una solicitud y la otra recibía 422 watch_limit_reached con el mismo recuento. Ahora todas las claves de la organización ven el mismo limit. Misma forma, códigos y estados; sin tope contratado, limit sigue siendo 500.

Qué hacer: nada. Si repartías solicitudes vigiladas entre claves de una misma organización, cuenta con un único tope para todas.

2026-10-07 · [ADD] Documentos legales publicados: términos de servicio, política de datos personales, encargo de tratamiento (DPA) y subencargados

Nueva sección Legal en esta documentación, versión vigente del 2026-10-07: los términos de servicio (qué es y qué no es el servicio, clave, permisos, uso aceptable, suspensión y baja), la política de datos personales del corpus (qué datos de personas hay, de qué fuente de INAPI vienen, para qué se tratan, cuánto se guardan y cómo ejercer los derechos), el encargo de tratamiento de los datos que tu organización escribe en el servicio y la lista de subencargados. El contrato de la API no cambia.

Qué hacer: leerlos. En particular, los términos § 7.3: los datos personales que obtengas del servicio se usan sólo para identificar al titular o al representante de una marca y no se comunican a terceros fuera de esa finalidad.

2026-10-07 · [ADD] SLA publicado: disponibilidad mensual 99,5 %, RPO 24 h, RTO 4 h y ventana de mantenimiento con aviso

La página Nivel de servicio deja de ser de mejor esfuerzo y pasa a ser el SLA de la API REST y del MCP: 99,5 % de disponibilidad mensual y menos del 0,5 % de respuestas 5xx; pérdida máxima de datos (RPO) de 24 h, y de 1 h para las claves de API y las organizaciones; tiempo de recuperación (RTO) de 4 h dentro del horario de soporte; mantenimiento sólo en la ventana declarada (domingos 02:00–06:00, America/Santiago, como máximo 4 h al mes), avisado con 48 h. La sincronización diaria no es mantenimiento: no corta el servicio. La página explica cómo se mide cada cifra, las exclusiones (fuerza mayor, indisponibilidad de INAPI, uso fuera de cuota) y los objetivos de latencia p95. El contrato de la API no cambia.

Qué hacer: nada. Si tu integración dependía de «sin garantía numérica», ya puedes contar con estas cifras.

2026-10-07 · [BEH] GET /sections ≡ list_sections: meta.dataAsOf dice el día de la última lectura de la leyenda de códigos de INAPI

Hasta hoy era el único catálogo con meta.dataAsOf: null. Ahora es el día en que se leyó por última vez, en una publicación de INAPI (respuestas de la ficha de expediente, boletines del Estado Diario, índice del expediente digital), la leyenda de los códigos de sección que sirve el catálogo, expresado como el comienzo de ese día en UTC (hoy 2026-10-02T00:00:00.000Z). Es un día y no un instante: esas lecturas se fechan por día, y el comienzo del día nunca es posterior a la lectura real. meta.coverageThrough sigue en null. Misma forma.

Qué hacer: nada. Si tratabas el null de /sections como «sin fecha», ya puedes mostrar la fecha.

2026-10-07 · [FIX] POST /annotations/search ≡ search_annotations y webhook sync.finished: con dedupe (por defecto), un acto repetido ya no sale como acto nuevo

Con dedupe las filas que describen el mismo acto se presentan una sola vez, con la fecha de detección de la primera. Ese agrupamiento se calcula después de cada sincronización diaria, y en el rato entre el fin de la sincronización y el agrupamiento una fila repetida podía salir en «cambios desde» como un acto nuevo (la copia tardía de un acto que ya habías recibido, o las dos filas de un acto de esa noche como dos actos), y después dejaba de salir. Ahora, con dedupe, detectedThrough no pasa del último agrupamiento completado: lo posterior se sirve en cuanto se agrupa. El webhook anuncia ese mismo horizonte. Misma forma; detectedThrough sólo puede ser igual o anterior a antes. Con dedupe: false nada cambia.

Qué hacer: nada. Sigue pidiendo con detectedAfter = el detectedThrough anterior. Si guardaste actos recibidos en ese intervalo, puede haber copias del mismo acto: vuelve a pedirlos por su id (GET /annotations/{id}) y agrúpalos por eventId ?? id.

2026-10-07 · [BEH] Catálogos: meta.dataAsOf dice la fecha de su fuente y GET /holidays ≡ list_holidays gana meta.coverageThrough

Misma forma; cambian dos valores del sobre en GET /nice-classes ≡ list_nice_classes, GET /legal-norms ≡ list_legal_norms, GET /holidays ≡ list_holidays y GET /sections ≡ list_sections. meta.dataAsOf es la última carga o verificación correcta de la fuente de cada catálogo, nunca la hora de tu petición: en las clases de Niza, la última verificación de los encabezamientos contra la OMPI (antes null); en las normas, la última sincronización con la BCN (antes null); en los feriados, la última carga del calendario (antes, la última actualización del corpus de marcas). En las secciones sigue en null: su fecha de carga no queda registrada. meta.coverageThrough sigue en null en los catálogos (no tienen «hasta»), salvo en los feriados: el último día con calendario declarado (hoy 2030-12-31, el mismo valor que meta.coverage.to); los plazos que acaban hasta esa fecha se cuentan con feriados declarados. Los catálogos se sirven con caché de hasta una hora.

Qué hacer: nada. Si mostrabas dataAsOf de los feriados como frescura del corpus, usa la de una colección de marcas.

2026-10-07 · [FIX] POST /annotations/search ≡ search_annotations y webhook sync.finished: detectedThrough ya no adelanta a los actos que aún se están cargando

detectedThrough es el horizonte seguro: preguntar después con detectedAfter = ese valor no debe saltar nada. Con algunas cargas del corpus que no pasan por la sincronización diaria, el horizonte podía adelantarse a actos que aún no se veían y que, al confirmarse, quedaban antes de él: esos actos no aparecían nunca en «cambios desde». Ahora el horizonte espera también a esas cargas. Misma forma; detectedThrough sólo puede ser igual o anterior a antes.

Qué hacer: nada. Sigue pidiendo con detectedAfter = el detectedThrough anterior.

2026-10-07 · [FIX] Webhook sync.finished: los días perdidos por una caída del emisor se envían al volver, y una cadena relanzada corrige el cuerpo pendiente

Tres correcciones del envío, sin cambiar la forma del cuerpo ni sus cabeceras. Un fallo del emisor podía dejar a un suscriptor sin el aviso del día: ahora la cola no se bloquea y un aviso que no llega se detecta y se avisa al operador. Si el emisor estuvo caído más de 24 h, los días que no salieron se envían al volver (hasta 7 días atrás), cada uno con su corpusDate. Si la cadena del día se vuelve a correr antes de que tu entrega se complete, los reintentos llevan el cuerpo nuevo (mismo id). Y una entrega ya recibida ya no puede volver a llegar porque el registro de su éxito fallara un instante.

Qué hacer: nada si deduplicas por id; procesa los avisos en el orden de corpusDate, no en el de llegada.

2026-10-07 · [FIX] MCP por HTTP: si la clave no se puede verificar, la respuesta es el mismo 503 service_unavailable que REST

En una avería pasajera del servicio que valida las claves, y para una clave que el servidor no había visto en los últimos minutos, REST respondía 503 service_unavailable y el MCP podía atender la llamada igualmente, sin descontarla de la cuota mensual ni del límite de ráfaga. Ahora el MCP responde lo mismo que REST: HTTP 503 con el cuerpo de error habitual (code: "service_unavailable", el mismo requestId que la cabecera X-Correlation-ID), sin ejecutar la herramienta. Cualquier otro fallo al verificar la clave es el 500 internal_error neutro, como en REST.

Qué hacer: nada, si ya reintentas los 503 de REST: trata igual un HTTP 503 del MCP (reintenta con espera).

2026-10-07 · [BREAK] GET /watch/hits ≡ list_similarity_hits: la lista se lee en el orden en que tu organización pudo ver cada parecida, next viene siempre y los cursores anteriores empiezan de nuevo; campo nuevo visibleSince

Antes la lista se paginaba por el id de la parecida y terminaba con next: null. Un cliente que guardaba «el id más alto leído» perdía, sin aviso, las parecidas que pasaban a ser legibles para él más tarde con un id antiguo: las de una solicitud a la que se suscribía cuando otra organización ya la vigilaba, y las que reaparecen al dejar de vigilar una marca propia.

  • Orden: visibleSince ascendente y, a igualdad, id. visibleSince es nuevo en cada parecida: desde cuándo tu organización puede leerla (instante ISO en UTC, con microsegundos) — lo más tardío entre su detección, el inicio de tu suscripción vigente a la solicitud vigilada y la última vez que dejaste de vigilar la solicitud parecida.
  • next viene siempre, también en la última página y con la lista vacía. El fin de la lectura es hasMore: false. Guarda el último next y envíalo más tarde como cursor: recibes sólo lo que pudiste leer después.
  • Una parecida puede llegarte otra vez con su mismo id (reaparece, o te diste de baja y de alta de nuevo). Una que se cerró y vuelve llega con id nuevo, como antes.
  • Un cursor es de su filtro: el obtenido con applicationNumber=N sólo continúa esa lectura; con otro filtro se lee desde el principio.
  • Los cursores emitidos antes de este cambio no se reconocen: la lectura empieza desde el principio. No es un error.
  • Garantía: la lista sólo sirve lo ya asentado, así que una parecida que termina de guardarse tarde no queda detrás de tu cursor: se retrasa (milisegundos; segundos durante una tarea de mantenimiento), no se pierde. No cubre una operación del servicio de más de 60 segundos, una corrección manual de datos ni un cambio del umbral de score. Una lectura sin cursor recorre siempre todo.

GET /watch/applications ≡ list_watched_applications no cambia.

Qué hacer: (1) pagina mientras hasMore sea true — un bucle «hasta que next sea nulo» ya no termina; (2) guarda el último next y úsalo como cursor en la lectura siguiente, en vez de guardar el id más alto y releer la lista; (3) inserta o actualiza por id; (4) descarta los cursores guardados antes de hoy; (5) guarda un cursor por cada filtro que uses. Guía: Vigilancia de parecidos.

2026-10-07 · [BEH] Vigilancia (GET /watch/applications ≡ list_watched_applications): watchEndsOn nunca es anterior al día en que la solicitud se vio terminal

Cuando una solicitud vigilada pasaba a estado terminal con su último día de vigilancia ya vencido (un vencimiento publicado tarde, un rechazo más antiguo que su margen), la vigilancia terminaba en la misma revisión y watchEndsOn no llegaba a leerse. Ahora ese último día es, como mínimo, el día en que el servicio la vio terminal: la vigilancia se anuncia ese día y termina al siguiente. Los campos y sus valores posibles no cambian.

Qué hacer: nada.

2026-10-07 · [BEH] Vigilancia (GET /watch/hits ≡ list_similarity_hits, GET /watch/applications ≡ list_watched_applications): una solicitud que no está en el corpus un solo día ya no cierra nada

Si una solicitud deja de estar en el corpus, su vigilancia ya no termina ni sus parecidas dejan de listarse en la primera revisión diaria que no la encuentra: hace falta que la revisión del día siguiente tampoco la encuentre. Tarda, por tanto, entre uno y dos días en vez de hasta uno; mientras tanto la parecida sigue saliendo, con matched: null. Una parecida que dejó de listarse por ese motivo vuelve —con un id nuevo, como cualquier otra que vuelve— si su solicitud reaparece y está viva. La forma de las respuestas no cambia.

Qué hacer: nada.

2026-10-07 · [FIX] OpenAPI y MCP: la versión del contrato pasa a 2026-10-04, el título es «Tarno Read-API» y el servidor MCP se llama tarno-read-mcp

Sólo cambia el texto publicado: ningún campo, ruta, herramienta, alcance ni código cambia. info.version del OpenAPI, la versión del servidor MCP y contractVersion del manifiesto decían 2026-09-29 aunque ya regían los cambios del 1 al 4 de octubre; ahora dicen 2026-10-04. El OpenAPI se titula «Tarno Read-API» y la respuesta a initialize del MCP nombra al servidor tarno-read-mcp, como siempre dijo la guía MCP. GET /watch/applications, DELETE /watch/applications/{applicationNumber}, GET /watch/hits y GET /system/me ganan en el OpenAPI la descripción que sus gemelas MCP ya tenían.

Qué hacer: nada, salvo que compares la versión del contrato o el nombre del servidor MCP: actualiza el valor esperado.

2026-10-04 · [FIX] GET /trademarks ≡ search_trademarks (con q o similarTo): los canales léxicos vuelven a funcionar con liveOnly, status=caducado y los filtros de vencimiento, hitos y renovación

Desde el 2026-10-03, con liveOnly=true, status=caducado, expiresFrom/expiresTo, milestoneFrom/milestoneTo (milestoneKind expiry, renewal_window_open, grace_end o sin milestoneKind) o renewalStatus, los canales léxicos (exact, fuzzy) no corrían: la respuesta venía sólo de los canales fonético y semántico. Ahora vuelven a correr: el motor de texto puntúa las coincidencias de q y el filtro se aplica después. Con esos filtros reaparecen resultados con matchedBy exact/fuzzy; en particular similarTo vuelve a encontrar marcas que sólo difieren por una errata o un sufijo. Con cualquier otro filtro, misma lista y mismo orden.

La primera búsqueda de una solicitud vigilada ya no termina en done si algún canal falló: se reintenta, y baselineStatus sigue en pending mientras tanto.

Qué hacer: nada.

2026-10-04 · [BEH] Vigilancia: las parecidas se mueven solas (cruce diario, cierre por estado) y WatchedApplication gana terminalSince, watchEndsOn y watchEndBasis

Mismas cuatro operaciones, entradas, alcances y códigos; cambia lo que ves con el tiempo en GET /watch/hits ≡ list_similarity_hits y GET /watch/applications ≡ list_watched_applications:

  • Tras cada sincronización completa, cada solicitud vigilada se cruza con las solicitudes vivas que cambiaron: las parecidas nuevas llegan con origin: "sync".
  • Una parecida deja de listarse si pasa a estado terminal (se revisa una vez al día) o deja de alcanzar el umbral; si vuelve, aparece como fila nueva (nuevo id y detectedAt).
  • baselineStatus puede volver a pending si cambian la denominación o las clases de la solicitud vigilada.
  • Si la solicitud vigilada pasa a terminal, se sigue vigilando hasta watchEndsOn; al día siguiente desaparece del listado, sus parecidas dejan de verse y deja de contar para el tope del plan (DELETE responde 404; un nuevo POST, 422 application_terminal).

Campos nuevos, null mientras la solicitud está viva: terminalSince (instante ISO), watchEndsOn (YYYY-MM-DD, último día de vigilancia; no es un plazo legal) y watchEndBasis (appeal_close, grace_end, rejection_margin o expiry_margin).

Qué hacer: relee las parecidas por cursor y guarda el id más alto leído; no supongas que una parecida listada sigue ahí. Opcionalmente, muestra watchEndsOn.

2026-10-04 · [BREAK] Vigilancia: se retiran las diez operaciones de watchlists; cuatro operaciones vigilan una solicitud por su número

Se retiran, en REST y MCP y sin periodo de convivencia: POST/GET /watchlists, GET/PATCH/DELETE /watchlists/:id, POST/GET /watchlists/:id/items, DELETE /watchlists/:id/items/:itemId, GET /watchlists/:id/hits y GET /watchlists/:id/deliveries (≡ create_watchlist, list_watchlists, get_watchlist, update_watchlist, delete_watchlist, add_watchlist_item, list_watchlist_items, remove_watchlist_item, list_watchlist_hits, list_watchlist_deliveries). Con ellas desaparecen los ítems por denominación, los filters por cliente, el webhook por lista con X-Tarno-Signature, Idempotency-Key y los códigos watchlist_too_large, watchlist_retired, idempotency_conflict y concurrent_modification.

Las sustituyen (alcances watch:read/watch:write; la clave debe tener organización):

  • POST /watch/applications ≡ watch_application — cuerpo { applicationNumber }; 201 (o 200 si ya la vigilabas) con un WatchedApplication.
  • DELETE /watch/applications/{applicationNumber} ≡ unwatch_application — 204.
  • GET /watch/applications ≡ list_watched_applications y GET /watch/hits ≡ list_similarity_hits — sobre común con cursor y limit (50 por defecto, máximo 200).

Códigos nuevos: 422 application_terminal (con applicationStatus), 422 watch_limit_reached (con limit) y 429 watch_daily_limit_reached (con limit y resetsAt, sin Retry-After). El prompt MCP weekly_watch toma applicationNumber en vez de watchlistId. No hay webhook ni parámetros por cliente; las listas existentes no se migran.

Qué hacer: deja de llamar a /watchlists; da de alta cada solicitud con POST /watch/applications y lee las parecidas con GET /watch/hits. Detalle completo en la guía de Vigilancia.

2026-10-04 · [ADD] POST /annotations/search ≡ search_annotations: detectedAfter solo es el feed de actos de todo el corpus, y cada anotación trae denomination

detectedAfter (con detectedUntil opcional) ya no exige una marca: sin applicationNumber, applicationNumbers, partyId ni taxId devuelve todos los actos que el corpus conoció desde ese instante, en orden de detección, por cursor y con meta.detectedThrough. En ese modo sólo se aceptan detectedUntil, dedupe, limit y cursor; cualquier otro filtro es un 400 que lo nombra. Antes { detectedAfter } solo era un 400.

Cada Annotation (búsqueda, GET /trademarks/{n}/annotations ≡ list_trademark_annotations, GET /annotations/{id} ≡ get_annotation y el boletín diario) gana denomination, la denominación de la marca (cadena vacía si no tiene). Además, un barrido con detectedUntil fijo queda congelado: las filas guardadas después no entran, ni siquiera en el colapso de dedupe.

Qué hacer: nada; si sigues miles de marcas, puedes leer el feed y filtrar de tu lado en vez de preguntar en tandas.

2026-10-04 · [ADD] Webhook sync.finished: un aviso firmado cuando el corpus del día está listo

Al terminar la sincronización diaria, Tarno envía un POST por día a cada suscriptor, con X-Tarno-Event: sync.finished y firma X-Tarno-Signature: t=<unix>,v1=<HMAC-SHA256 de "t.rawBody"> (tolerancia ±300 s). El cuerpo (versión 1) trae id (sync.finished:<fecha>, para idempotencia), corpusDate, ok, syncExitCode, dataAsOf, coverageThrough, detectedThrough, watchWatermark y conteos por fuente; ningún dato de clientes. Se envía aunque falle una fuente (ok: false). Reintentos a 1 min, 5 min, 15 min, 1 h y 4 h.

La suscripción (URL y secreto de firma) la configura Tarno por ahora; no hay ruta REST ni herramienta MCP para ello. Ninguna ruta existente cambia.

Qué hacer: si quieres el aviso, pide la suscripción y verifica la firma; puedes dejar de consultar la frescura por sondeo.

2026-10-04 · [BEH] POST /watch/applications ≡ watch_application: puede responder 503 service_unavailable si no se puede leer el tope del plan

El tope del plan de solicitudes vigiladas (watch_limit_reached, limit) se lee ahora de otro origen. El valor, la forma y los códigos no cambian. El único resultado nuevo: si ese origen no responde mientras se da de alta una solicitud, la llamada falla con 503 service_unavailable (reintentable) en ambos transportes, en vez de un error interno. Listar, dejar de vigilar y leer parecidas no se ven afectados.

Qué hacer: trata ese 503 como cualquier otro: reintenta más tarde.

2026-10-04 · [ADD] Webhook sync.finished: entregas de prueba marcadas con X-Tarno-Test: true

Tarno puede enviar a un suscriptor una entrega de prueba a pedido. Lleva el último aviso real byte a byte (mismo id, así que un receptor que deduplica por id la ignora) o, si aún no hubo aviso, un cuerpo sintético con type, version, un id que empieza por sync.finished:test: y "test": true. Va firmada como cualquier entrega, añade la cabecera X-Tarno-Test: true y su propio X-Tarno-Delivery (test-<uuid>), es un solo intento y no reemplaza la entrega del día.

Qué hacer: si recibes X-Tarno-Test: true, verifica la firma, responde 2xx y no hagas nada más.

2026-10-04 · [ADD] GET /system/me ≡ get_system_me: usageHistory, el uso contabilizado de la clave en los últimos 12 meses

Campo nuevo usageHistory, siempre presente y con el mismo JSON en ambos transportes: windowMonths (12), asOf (último registro de uso de la clave, o null) y months, del más reciente al más antiguo, una entrada por mes UTC con uso registrado: month (YYYY-MM), requests, quotaUnits, rejectedRequests (429), logoAnalyses y byScope (scope, requests, quotaUnits, rejectedRequests). Es sólo la clave presentada, sin otras claves de la organización.

Un mes ausente significa que no hubo uso registrado (la contabilidad empieza el 2026-10-03), nunca un cero calculado. El mes en curso puede ir alrededor de un minuto por detrás de quota.consumed.

Qué hacer: nada; úsalo si quieres mostrar el consumo histórico de la clave.

2026-10-02 · [BEH] expiresOn, milestones[] y status: una marca de Madrid sigue la renovación (MAD02) y la extinción (MAD01) notificadas por la OMPI

Una marca de Madrid (applicationNumber de 9 dígitos) registrada, con un MAD02 desde un año antes del vencimiento de INAPI y sin MAD01 posterior, publica ahora expiresOn = vencimiento de INAPI + 10 años por ciclo (Protocolo de Madrid, art. 7.1). Su hito expiry pasa a basis: "derived", con anchor inapi_expiry, rule: "10_years_after_previous_expiry_on_wipo_renewal" y legalBasis art. 7.1. Los filtros y agrupaciones por vencimiento usan la fecha publicada; sort=expiresOn sigue ordenando por la fecha de INAPI.

Si su último MAD01 cae en o después del vencimiento y después del último MAD02, publica status: "caducado", statusInapi: "registrada", statusStale: true; los filtros, facetas y liveOnly lo siguen. Mueven su vencimiento 157 marcas y 61 pasan a caducado. Mismas formas.

Qué hacer: nada.

2026-10-02 · [BREAK] encumbrances[] (GET /trademarks/{applicationNumber}?expand=encumbrances ≡ get_trademark): un gravamen moderno sólo rige cuando INAPI lo inscribe; nuevo state rejected

Una anotación moderna A0xI es la presentación de un gravamen, no su inscripción. Hasta ahora todas salían active (o released); ahora cada una se resuelve con las resoluciones de INAPI:

  • inscrita (1104, 638, o 639 para un alzamiento) → active / released, como antes;
  • rejected (valor nuevo) — rechazada (537); nunca rigió;
  • abandoned — 536, 637 o 927; nunca rigió;
  • filed — aún sin resolución que la cierre.

Un alzamiento (A0xA) sólo levanta cuando se inscribe. Un gravamen que nunca rigió trae filedOn (fecha de su A0xI) y recordedOn: null; uno vigente o alzado conserva recordedOn y filedOn: null. Ni filed, ni rejected, ni abandoned cuentan como gravamen vigente ni deben disparar alertas. De 4.691 gravámenes modernos, active baja de 2.267 a 1.677; aparecen 186 rejected, 464 abandoned y 1 filed. 312 marcas quedan sin ninguno vigente.

Qué hacer: un switch exhaustivo sobre state debe manejar rejected; cuenta como vigentes sólo active.

2026-10-02 · [DATA] La sección 1076 es «Resolución de aceptación e inscripción de renovación TLT» y ahora cuenta como renovación

El código 1076 tenía el nombre de OBS03 («Escrito de anotación - Cumplimiento de observaciones»). Se corrige: sus 87.483 anotaciones (87.349 marcas) traen ahora sectionName «Resolución de aceptación e inscripción de renovación TLT», su propia sectionLabel y sectionFamily renovacion en vez de presentacion, así que el listado de secciones por familia y el filtro family=renewal la incluyen.

En el informe de marca (renewals[], lastRenewalOn), 1076 se suma a los actos de renovación: 2 marcas ganan su primera renovación y en 54.860 lastRenewalOn pasa a la fecha de inscripción de la renovación. Un mismo acto ya no sale dos veces (también 1077 con A3 + AREPTLT). renewalStatus, expiresOn y los hitos no cambian. Mismas formas.

Qué hacer: nada.

2026-10-02 · [FIX] status y registrationNumber: una concesión invalidada después (Ley 19.880) ya no deriva registrada

El status derivado promovía a registrada/concedida una marca en estado previo a la concesión si había un testigo de la concesión (número de registro, anotación de concesión o clase C), sin mirar una invalidación posterior. Ahora, si la última anotación de invalidación (957 o 957B) es posterior a la última de concesión, status es el valor de INAPI, statusInapi es null y statusStale es false; además registrationNumber es null en listados y se omite en el informe. Una concesión nueva posterior restablece la derivación. El filtro status=, groupBy=status, las facetas y sort=status siguen la misma regla. Hoy afecta a una marca. Mismas formas.

Qué hacer: nada.

2026-10-02 · [DATA] Anotaciones D5A del Estado Diario: cada acto pasa a la marca cuyo número de registro imprime el boletín

La sección D5A («Anotaciones inscritas») imprime el número de registro de la marca; desde el 2026-09-03 se guardaba como número de solicitud, así que cada anotación D5A quedaba en otra marca. Ahora se resuelve la marca correcta:

  • annotations[] (informe, list_trademark_annotations, search_annotations, get_daily_bulletin): 41.375 filas pasan a su marca, con el mismo id, fecha y texto. 37.187 marcas pierden actos que no eran suyos y 37.182 ganan los suyos.
  • 6 filas cuyo número de registro no tiene ninguna marca se eliminan: su id responde 404.
  • renewals[]/lastRenewalOn, transferencias (A07T) y cambios de nombre (A01) bajo D5A se mueven con sus filas. D5A + ARENTLT sigue fuera de renewals[] por ahora.

Mismas formas.

Qué hacer: si guardaste anotaciones D5A por marca, vuelve a leerlas.

2026-10-02 · [BREAK] encumbrances[]: gravámenes anteriores a 2012, dos valores nuevos de state y filedOn

Los gravámenes presentados antes del cambio de códigos de INAPI de 2012 (W340 medida precautoria, W360 prenda, W370 prohibición) aparecen ahora en encumbrances[], con registrationSection el código antiguo y el acreedor en beneficiary.

  • state gana filed (presentado, sin inscripción) y abandoned (aceptado y caducado por falta de pago; nunca rigió).
  • Campo nuevo filedOn en cada entrada: fecha de presentación de un gravamen antiguo; null en los modernos.
  • Un alzamiento moderno levanta el gravamen antiguo de su tipo si sólo hay uno abierto. Con dos o más, el alzamiento sale huérfano (released, recordedOn: null) y esos gravámenes quedan active con releaseObservable: false.

Cambia la respuesta de 88 marcas; las demás sólo ganan filedOn: null.

Qué hacer: un switch exhaustivo sobre state debe manejar filed y abandoned; ninguno de los dos es un gravamen vigente.

2026-10-02 · [BEH] 128 códigos de sección ganan el nombre oficial de INAPI: sectionName/sectionLabel y /sections ≡ list_sections/get_section

128 códigos que no tenían nombre (8.130 anotaciones, casi todas antiguas) toman el que les da el índice del Expediente Digital de INAPI; entre ellos A08I/A08A «Anotación de Quiebra», A09A, A03M/A05M y las familias 705A-D/773A-D. Esas anotaciones pasan de sectionName: null al literal de INAPI; sectionLabel trae siempre es-CL y en/pt-BR en 112 de los 128. El catálogo queda en 674 códigos, 671 con nombre. Mismas formas; los catálogos (/sections) pueden servirse con caché de hasta un día.

Qué hacer: nada.

2026-10-02 · [BEH] GET /trademarks?similarTo= ≡ search_trademarks: las páginas de una búsqueda por parecido ya no repiten ni saltan marcas

El canal distinctive depende de un detector de términos genéricos cuyo resultado podía variar entre páginas, de modo que el cursor repetía o saltaba marcas. Ahora el cursor next lleva lo que hizo el canal en la primera página (el núcleo distintivo que buscó, o que no corrió) y todas las páginas siguientes recorren el mismo conjunto. El cursor sigue siendo opaco y crece un poco; los cursores anteriores siguen funcionando. Si el detector falla en una página posterior, se omiten en ella meta.genericTerms, distinctiveCore y decompounded.

Qué hacer: nada; trata el cursor como opaco.

2026-10-02 · [BEH] POST /logos/analyze ≡ analyze_logo: un 429 logo_global_quota_exceeded ya no gasta la cuota diaria de logos de la clave

Cuando se llena el tope diario de análisis de logos de todo el servicio, la llamada se rechaza con 429 logo_global_quota_exceeded como antes, pero la unidad tomada de la cuota diaria de logos de la clave (20 por defecto) se devuelve. Antes, reintentar en un día lleno podía agotar la cuota propia sin un solo análisis. Mismas formas, códigos y Retry-After. La cuota mensual general sigue descontándose antes de ejecutar la herramienta, también en un 503 logo_analysis_not_configured.

Qué hacer: nada.

2026-10-01 · [BEH] PATCH /watchlists/:id ≡ update_watchlist: una watchlist retirada ya no se puede editar ni reactivar → 409 watchlist_retired

Una watchlist retirada con DELETE /watchlists/:id (delete_watchlist) pasó a ser terminal: cualquier PATCH/update_watchlist sobre ella, en particular {"status":"active"} o "paused", respondía 409 con el código watchlist_retired y no escribía nada. Para volver a vigilar había que crear una watchlist nueva. GET, parecidas y entregas de una retirada no cambiaban. Las watchlists se retiraron por completo el 2026-10-04.

Qué hacer: nada; usa la vigilancia por solicitud.

2026-10-01 · [BEH] Los filtros de parte holder, representative y taxId admiten como mucho 20 valores de hasta 256 caracteres

Los tres filtros de parte eran listas sin tope. Ahora, en GET /trademarks, POST /trademarks/search, GET /insights/trademarks, POST /insights/trademarks/search, GET /trademarks/renewal-calendar y sus gemelas MCP (search_trademarks, get_trademark_insights, get_renewal_calendar), cada uno admite hasta 20 valores (desde el 2026-10-16, varios valores se envían repitiendo el parámetro: una coma ya no separa nombres) y cada valor hasta 256 caracteres, el mismo tope que q.

Superar el tope es un 400 validation_error con errors[].code = "too_big" en el campo (por MCP, el error de entrada equivalente; un valor demasiado largo se señala como holder.0, holder.1…). Con 20 valores o menos no cambia nada.

Qué hacer: nada si envías un valor por filtro. Si envías la lista de partes de una cartera, pártela en peticiones de 20.

2026-10-01 · [DATA] GET /system/coverage ≡ get_system_coverage: acts deja de publicar ceros falsos

acts valía 0 en días cuyo boletín sí está en el corpus: los tipo2 del 2026-08-26 al 2026-09-08, varias filas del 2026-08-26 y las altas anteriores al 2026-09-09 (entre 950 y 1.615 actos por día). Ahora cada fila nace con los actos de ese boletín que el corpus ya tiene, y las filas históricas se corrigieron: los valores de esas fechas pasan de 0 a su recuento real. La forma no cambia.

Los actos que entran después por rutas que no registran el día siguen sin sumarse: acts puede quedarse corto, nunca inflarse. El mismo valor se lee en meta.bulletins[].acts de GET /reports/daily-bulletin ≡ get_daily_bulletin.

Qué hacer: nada. Si guardaste acts de esas fechas, vuelve a leerlo.

2026-10-01 · [BEH] La búsqueda con todos sus canales caídos responde 503 service_unavailable, no 200 vacío

Afecta a GET /trademarks y POST /trademarks/search ≡ search_trademarks cuando llevan texto (q o denomination). La búsqueda corre varios canales (texto exacto, texto difuso, fonético y, si está disponible, semántico); el que falla se descarta y se sigue con los demás. Hasta ahora, si fallaban todos, la respuesta era 200 con results: [], un «ninguna marca coincide» falso. Ahora es 503 service_unavailable (application/problem+json, reintentable), igual por REST y MCP.

Si falla alguno pero no todos, nada cambia. Un canal sin coincidencias no es un fallo: una búsqueda sin resultados sigue siendo 200 vacío. La búsqueda por parecido (similarTo, similarToTrademark, oppositionWindow: "open") y los informes que la usan ya respondían con error en este caso. Sin cambios de forma: 503 ya estaba declarado en el OpenAPI.

Qué hacer: trata el 503 service_unavailable de la búsqueda como «inténtalo de nuevo», no como «no hay coincidencias».

Septiembre de 2026

2026-09-30 · [BEH] MCP: explain_section_code responde con contenido (antes, siempre no_se_sabe)

Sólo MCP. Hasta ahora la herramienta respondía known: false / no_se_sabe a cualquier código. Ahora explica 23 códigos (012, 024, 444, 484, 485, 486, 576, 662B, 664B, 911, 912, A09I, E1, M6, M7, M8, M11, REC02, REC03, REC08, W148, W160, W230).

La respuesta gana campos: explanation (markdown), title, status (measured · confirmed · contradictory · hypothesis), lastReviewed (YYYY-MM-DD, la fecha del dato), sources ([{ source, date }]) y knowledgeRevision ({ commit, date }). Para un código desconocido, los nuevos campos van a null (sources: []). code, known y note no cambian de significado; un código sin ficha sigue siendo no_se_sabe y un code mal formado, 400 validation_error.

Qué hacer: muestra lastReviewed junto a la explicación y ten en cuenta status: hypothesis o contradictory no son un hecho cerrado.

2026-09-30 · [BEH] Los recursos MCP iris://catalogs/* exigen clave y alcance; el de feriados deja de salir vacío

resources/read pide ahora la misma clave y el mismo alcance que la ruta REST gemela: brands:read para iris://catalogs/states, iris://catalogs/sections e iris://catalogs/nice-classes (≡ GET /sections, GET /nice-classes) e insights:read para iris://catalogs/holidays/{year} (≡ GET /holidays). Sin clave responde el error de autenticación de las herramientas; sin el alcance, el de permiso. resources/list sigue abierto, como tools/list.

Además, iris://catalogs/holidays/{year} devolvía holidays: [] para cualquier año; ahora devuelve los feriados del año pedido, con la misma cobertura declarada.

Qué hacer: envía la clave también al leer recursos MCP, con el alcance correspondiente.

2026-09-30 · [BREAK] formerParties[].retiredBy pasa de cadena a objeto { kind, section }

Afecta a GET /trademarks/{applicationNumber} ≡ get_trademark cuando se expanden las partes (detalle e informe), en formerParties[].retiredBy. Nada más cambia de forma.

antes: "A07T"                 ahora: { "kind": "section", "section": "A07T" }
antes: "authority_withdrew"   ahora: { "kind": "authority_withdrew", "section": null }

La cadena mezclaba dos clases de valor: un código de sección de INAPI y un código neutral propio, y había que saber que authority_withdrew no es una sección. Ahora la clase va en kind y el código de INAPI, tal cual y de vocabulario abierto, en section; puede llegar un código que no esté en ninguna lista, y se interpreta con GET /sections/{code} ≡ get_section. Los valores no cambian: cada parte retirada publica la misma sección o el mismo authority_withdrew que antes, sólo que envuelto.

Qué hacer: donde leas retiredBy como cadena, lee retiredBy.kind y, si es "section", retiredBy.section. Si validas el esquema de forma estricta, actualízalo al objeto.

2026-09-30 · [FIX] Sin permiso, el 403 (y sin clave, el 401) sale antes que el 400 de validación, en REST y MCP

Una clave sin el alcance necesario que enviaba una entrada inválida recibía 400 validation_error en vez de 403 forbidden, y una petición sin clave recibía 400 antes que 401: el error de validación describía la forma de la entrada a quien no estaba autorizado. Pasaba en todas las rutas y herramientas con alcance.

Ahora el orden es el mismo por los dos transportes: 401 → 403 → 400 → límite de ráfaga/cuota. Una entrada inválida sigue sin gastar cuota. Los alcances que exige una expansión (expand=citations, expand=norms, expand=legalTexts ⇒ legal:read) se deciden sobre la consulta recibida. Siguen saliendo antes el 400 de un cuerpo que no es JSON legible y el 413 de tamaño. Una entrada válida con permiso no cambia.

Qué hacer: nada, salvo que trates el 400 como señal de que la clave y el permiso son válidos.

2026-09-30 · [FIX] MCP: cinco códigos de error salen con el status de su gemelo REST (antes 400)

Por MCP, el sobre de estos errores decía status: 400 / title: "Request validation failed". Ahora status y title son los de REST:

code herramientas ahora
query_timeout (tope total de la herramienta) todas 504
watchlist_too_large create_watchlist, add_watchlist_item 422
unsafe_callback create_watchlist, update_watchlist 422
idempotency_conflict create_watchlist 409
coverage_not_declared (antes service_unavailable) list_holidays 503

En list_holidays cambia además el code, al mismo de GET /holidays.

Qué hacer: si ramificas por status en MCP, estos casos ya no llegan como 400. Si comparas el code de list_holidays, cambia service_unavailable por coverage_not_declared.

2026-09-30 · [BEH] Almacén de vigilancias no disponible: 503 service_unavailable por REST y MCP

Cuando el almacén de vigilancias no está disponible, las rutas /watchlists* respondían 500 internal_error (que oculta que se puede reintentar) y sus herramientas MCP, service_unavailable con status: 400 (que culpa al cliente). Ahora las dos responden 503 service_unavailable, con el mismo detail neutro (The watch store is temporarily unavailable.). Es reintentable y la forma del cuerpo no cambia.

Qué hacer: trata el 503 de /watchlists* como pasajero y reintenta con espera.

2026-09-30 · [BEH] REST: una falta de recursos del servidor responde 503 service_unavailable (antes 500 internal_error)

Un fallo pasajero por falta de recursos del almacenamiento (disco, memoria) respondía 500 internal_error por REST y 503 service_unavailable por MCP: el mismo fallo se podía reintentar por un lado y no por el otro. Ahora REST responde lo mismo que MCP: 503, code: service_unavailable, con un detail neutro (The corpus service is temporarily unavailable. Please retry shortly.). Cualquier otro error interno sigue siendo 500 internal_error. El OpenAPI documenta ahora el 503 en todas las operaciones.

Qué hacer: trata el 503 como pasajero (reintento con espera), igual que el 504.

2026-09-29 · [BEH] MCP: siete herramientas de catálogo y de sistema gastan cuota y ráfaga, como sus gemelas REST

list_legal_norms, get_legal_norm, list_sections, get_section, explain_section_code, get_system_coverage y get_vigilance_horizon no gastaban cuota mensual ni límite de ráfaga por clave, mientras sus gemelas REST (GET /legal-norms, GET /legal-norms/{id}, GET /sections, GET /sections/{code}, GET /system/coverage, GET /system/vigilance-horizon) sí. Ahora gastan una unidad por llamada, igual que en REST. El alcance que piden (brands:read para catálogos, insights:read para sistema) y la respuesta no cambian.

Además, explain_section_code rechaza con 400 validation_error un code que no tenga forma de código de sección (^[A-Z0-9_]{1,10}$ tras pasarlo a mayúsculas); los códigos reales (024, M11, 664B, A07T…) siguen valiendo.

Qué hacer: nada, salvo que contaras con que estas llamadas por MCP no gastaban cuota.

2026-09-29 · [BEH] MCP: los lotes JSON-RPC (un array en el cuerpo) se rechazan con 400 / -32600

El transporte HTTP del MCP aceptaba un array de mensajes JSON-RPC y los ejecutaba todos con una sola unidad de ráfaga. Ahora un cuerpo que es un array (también vacío o de un elemento) se responde con HTTP 400 y {"jsonrpc":"2.0","error":{"code":-32600,"message":"JSON-RPC batch requests are not supported: …"},"id":null}, antes de autenticar, cobrar o ejecutar nada. La especificación MCP retiró los lotes en 2025-06-18 y los clientes oficiales del SDK no los envían. REST no cambia.

Qué hacer: nada si usas un cliente MCP oficial. Si un cliente propio agrupa mensajes en un array, envíalos uno por petición.

2026-09-29 · [BEH] El texto de búsqueda q (y similarTo) admite como mucho 256 caracteres

q no tenía longitud máxima. Ahora q y similarTo en GET /trademarks, POST /trademarks/search, GET /insights/trademarks, POST /insights/trademarks/search ≡ search_trademarks / get_trademark_insights, y q en GET /parties ≡ list_parties, admiten hasta 256 caracteres. Más es un 400 validation_error (o el mismo error de entrada por MCP) con errors[].code = "too_big" en el campo. Los informes (text, hasta 200) y la base documental (q, hasta 200) ya tenían su tope y no cambian.

Qué hacer: si envías texto pegado por el usuario, recórtalo o valídalo a 256 caracteres antes de llamar.

2026-09-29 · [BEH] Desde el 2027-01-01, el catálogo de clases de Niza sirve los encabezamientos de la edición 13-2027

Hasta el 2026-12-31 (hora de Chile) no cambia nada. Desde el 2027-01-01, list_nice_classes ≡ GET /nice-classes, el recurso iris://catalogs/nice-classes y los heading de recommend_nice_classes ≡ POST /nice-classes/recommend llevan los encabezamientos de la 13-2027, la edición vigente desde esa fecha.

  • Cambian 7 encabezamientos: las clases 6 y 9 en es-CL y en, y las clases 21, 29 y 31 sólo en es-CL. Las demás son idénticas. es-CL y en son copia literal de la OMPI, sin punto final.
  • pt-BR sigue siendo una traducción propia de Tarno, no oficial; en la 13-2027 cambia en las clases 6, 9, 29 y 31.
  • El recomendador, con fecha de referencia desde el 2027-01-01, devuelve ahora heading["pt-BR"] relleno (antes null).

Qué hacer: nada obligatorio. Si guardas en caché los títulos de las clases, invalídalos el 2027-01-01. Lee la edición desde edition en la respuesta del recomendador; no la supongas.

2026-09-29 · [BEH] Las marcas ya no pierden su categoría cuando se actualizan desde la ficha de expediente de INAPI (category, protectionScope, get_class_stats)

Miles de marcas presentadas en 2025–2026 salían sin categoría (13.526 al 2026-09-29): una actualización desde la ficha de expediente de INAPI, que no informa subtipo, borraba el subtipo, la categoría y el ámbito de protección, y la planilla de INAPI los devolvía al día siguiente.

  • Ahora una fuente que no informa subtipo, categoría o ámbito no los borra; si los informa, manda.
  • Nada se adivina: una marca cuya fuente no dice la categoría sigue saliendo sin ella, y get_class_stats la sigue contando en excludedUnknownCategory. Unas 1.100 marcas de 2026 están así porque INAPI las publica sin tipo ni subtipo.
  • Las marcas afectadas se corrigen solas con la siguiente actualización de la planilla de cada año; excludedUnknownCategory debería bajar en días.

Qué hacer: nada. Si muestras excludedUnknownCategory, espera que baje.

2026-09-29 · [BEH] get_deadlines da la fecha límite de apelación desde el último 024 cuando hay resoluciones posteriores, con aviso

Cuando el movimiento resolutivo más reciente de una marca no sirve de ancla (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 rechazo 024 sin una aceptación parcial 444 en medio, get_deadlines ≡ GET /trademarks/{applicationNumber}/deadlines deja de omitir la fecha (latest_resolution_not_anchoring) y la calcula desde ese último 024, con caveat: "later_resolution_on_record" y las resoluciones posteriores en laterResolutions[]. En el corpus al 2026-09-29, 786 marcas pasan de omitted[] a deadlines[].

No cambian: la 444 como más reciente (partial_acceptance_not_published), los casos sin 024 anterior o con una 444 en medio, y Madrid, ancla en día inhábil o fuera de calendario, que siguen omitidos. El hito appeal_close de milestones[] no se publica en este caso.

Qué hacer: si esas marcas llegaban sólo en omitted[], ahora llegan en deadlines[]: lee caveat antes de avisar con esa fecha. Nunca es un veredicto sobre si el plazo aplica.

2026-09-29 · [ADD] get_deadlines: caveat y laterResolutions en cada plazo

Cada elemento de deadlines[] de GET /trademarks/{applicationNumber}/deadlines ≡ get_deadlines gana dos campos, siempre presentes:

  • caveat: null o "later_resolution_on_record" (vocabulario cerrado).
  • laterResolutions[]: las resoluciones con fecha estrictamente posterior al ancla, de la más antigua a la más reciente, con annotationId, sectionCode, sectionName (el nombre de INAPI en el catálogo, o null) y date. Es [] exactamente cuando caveat es null.

REST y MCP devuelven lo mismo.

Qué hacer: si validas TrademarkDeadline de forma estricta, acepta los dos campos.

2026-09-29 · [ADD] Fecha límite para apelar un rechazo: hito appeal_close y GET /trademarks/{applicationNumber}/deadlines ≡ get_deadlines

Se publica la fecha límite para apelar un rechazo (024) ante el Tribunal de Propiedad Industrial: el 15.º día hábil estrictamente posterior a su notificación en el Estado Diario (sin sábados, domingos ni feriados). Base legal, en el campo: Ley 19.039 art. 17 bis B, Ley 19.039 art. 11 y Ley 19.880 art. 25.

  • Hito appeal_close en milestones[] (expediente, colección, lote, parte, informes): basis: "derived", anchor: {kind: "rejection_notice", date}, rule: "15_business_days_after_notification" y las tres normas. No es filtrable: milestoneKind=appeal_close da 400 validation_error.
  • Operación nueva (brands:read): deadlines[] con el ancla auditable (annotationId, sectionCode: "024"), appealObserved (la primera apelación REC03 posterior, un hecho del corpus), businessDaysLeft/elapsed hoy en Chile; omitted[] con lo que no se publica y por qué (latest_resolution_not_anchoring, partial_acceptance_not_published, madrid_designation, anchor_on_non_business_day, outside_holiday_calendar); calendar; meta.dataAsOf. Marca inexistente: 404 not_found.
  • Sólo ancla el 024 cuando es el movimiento resolutivo más reciente. Se omite con motivo, nunca se estima; sin margen de seguridad.

Qué hacer: si validas Milestone.kind de forma estricta, acepta appeal_close. Cita los artículos y trata omitted[] como «no lo sabemos», no como «no hay plazo».

2026-09-29 · [FIX] MCP: un recurso inexistente sale con status: 404 (antes 400), como en REST

Por MCP, el error de un recurso que no existe (o que es de otra organización, en las vigilancias) pasa de status: 400 / title: "Request validation failed" a status: 404 / title: "Not found", con el detail de la ruta REST gemela (p. ej. trademark 123 not found). El cuerpo es el de REST campo a campo, salvo requestId, vacío en MCP.

Afecta a 18 herramientas: get_annotation, list_trademark_annotations, get_legal_norm, get_section, get_party, list_party_trademarks, list_party_relations, get_portfolio_report, get_opposition_brief, get_opposition_response_brief, get_trademark, get_watchlist, delete_watchlist, list_watchlist_hits, list_watchlist_deliveries, add_watchlist_item, list_watchlist_items y remove_watchlist_item. En update_watchlist sólo cambia el detail. El code sigue siendo not_found; REST no cambia.

Qué hacer: si ramificas por code, nada. Si ramificas por status, lee 404 como «no existe (o no es tuyo)». Si comparabas el texto de detail, compara el code.

2026-09-29 · [ADD] Operación futura declarada: POST /logos/similar ≡ find_similar_logos responde 503 image_similarity_not_available

La búsqueda de marcas parecidas a un logo queda declarada en el contrato (entrada y forma futura de la salida), con alcance propio logo:similar, pero aún no está disponible: hoy responde siempre 503 image_similarity_not_available. En el OpenAPI lleva x-availability: planned.

  • Entrada: image {mediaType, dataBase64} (la misma definición que analyze_logo), niceClasses opcional (1..45) y limit opcional (1..50).
  • Salida futura: results[] con applicationNumber, denomination, niceClasses, signType, imageUrl, score, signals {visual}, matchedBy ["visual"], y meta con dataAsOf, model, coverage, disclaimer e image. Hoy no se emite.
  • Hoy: valida la imagen igual que analyze_logo (mismo 400 invalid_image) y responde el 503, igual por REST y MCP. La imagen no se guarda.
  • Sin logo:similar, 403. Ninguna clave tiene ese alcance todavía.

Cuando esté disponible se anunciará en otra entrada.

Qué hacer: nada si no la usas. Si la programas ya, trata el 503 image_similarity_not_available como «aún no disponible» y no lo reintentes; no lo presentes como «no hay marcas parecidas».

2026-09-29 · [ADD] search_annotations por lista de marcas y por fecha de detección: applicationNumbers, detectedAfter/detectedUntil, detectedAt y meta.detectedThrough

POST /annotations/search ≡ search_annotations permite vigilar una lista de marcas y preguntar «qué actos nuevos hay desde la última vez» en una llamada.

  • applicationNumbers: hasta 100 marcas por llamada (duplicados una vez). Más de 100 ⇒ 422 batch_too_large; más de 1.000 ⇒ 400. No se combina con applicationNumber, partyId ni taxId.
  • detectedAfter (exclusivo) y detectedUntil (inclusivo): instantes ISO 8601 con zona sobre cuándo lo conoció el corpus, no la fecha del acto. Exigen applicationNumber o applicationNumbers.
  • detectedAt en toda Annotation: cuándo el corpus conoció la fila, no cuándo la publicó INAPI. Lo importado de la carga inicial lleva su fecha de carga. Con dedupe (por defecto), un hecho cuenta desde su primera fila.
  • meta.detectedThrough: horizonte seguro, presente sólo con esos parámetros; no se sirve nada detectado después.

Patrón: pide con detectedAfter = el detectedThrough anterior; pagina con cursor y el mismo detectedUntil = el detectedThrough de la primera página; guárdalo para la próxima vez.

Qué hacer: acepta detectedAt si validas Annotation de forma estricta. Para vigilar listas, usa applicationNumbers en lotes de 100 con este patrón.

2026-09-29 · [ADD] Las anotaciones citan el plazo que imprime INAPI: inapiTermLabel

Cada Annotation (POST /annotations/search ≡ search_annotations, GET /trademarks/{n}/annotations, GET /annotations/{id} ≡ get_annotation y el boletín del día, get_daily_bulletin) gana el campo siempre presente inapiTermLabel: { "basis": "inapi_label", "text": "30 días", "code": "661B", "quotedFrom": "actName" } o null. No lo ganan las anotaciones del expediente ni del informe de una marca.

Es el texto entre paréntesis del nombre que INAPI publica para el acto («Fondo - Res. Observaciones Escrito (30 días)» ⇒ "30 días"), citado tal cual, sólo para 14 códigos: 661, 661B, 661D, 738, 813, 813A, 813B, 813D, 925, 926, 931, 931B, 931D, 964. Se cita de actName si hay acto; si no, de sectionName. No es una fecha ni un plazo calculado, y nunca entra en milestones[].

Qué hacer: acepta el campo si validas Annotation de forma estricta. Úsalo como un hecho citado («INAPI indica 30 días»), nunca como «vence el…».

2026-09-29 · [BEH] analyze_logo ≡ POST /logos/analyze: description se redacta al estilo de las descripciones de etiqueta del registro de INAPI

La forma no cambia; cambia la redacción de description.es, ajustada al estilo medido en unas 100.000 descripciones de etiqueta del registro:

  • abre con «Etiqueta consistente en…» («La marca tridimensional consiste en…» para una forma tridimensional; una frase corta con «Denominación "…"» para un signo sólo de palabras);
  • sitúa los elementos unos respecto de otros, cita el texto literal y asocia cada color a su elemento con nombres usados en Chile («naranjo», «celeste», «café»), sin códigos Pantone/RGB/hex, y cierra con el fondo;
  • una a tres frases, unos 150–300 caracteres;
  • no escribe «se reivindican los colores» ni frases sobre el alcance de la protección.

Lo demás sigue igual: ninguna opinión de registrabilidad, códigos de Viena del catálogo, generatedBy y disclaimer.

Qué hacer: nada obligatorio. Sigue mostrando el disclaimer (la descripción la genera un modelo, no INAPI). Revisa cualquier texto que asumiera otra redacción (p. ej. que empieza por «Logo…»).

2026-09-29 · [BEH] Búsqueda por parecido: el canal distinctive pesa 2 (antes 1,5) y no corre con un núcleo de menos de 3 caracteres

Afecta a POST /trademarks/search con similarTo ≡ search_trademarks, GET /reports/clearance ≡ get_clearance_report, GET /reports/conflict-landscape ≡ get_conflict_landscape y GET /reports/registration-signals ≡ get_registration_signals.

  • Cambia el orden: el peso del canal distinctive pasa de 1,5 a 2, y con él qué marcas entran en el grupo distinctive. Ejemplo: «ALTODESEMPEÑO CONSULTORES» / 35 ⇒ «MAS Desempeño» sube del puesto 77 al 32.
  • El canal no corre si el núcleo distintivo tiene menos de 3 letras o dígitos (p. ej. «AB CONSULTORES» ⇒ «ab»): no hay grupo distinctive, ninguna marca lleva distinctive en matchedBy y genericTerms/distinctiveCore/decompounded no viajan.
  • Sin cambios de forma; sólo se actualiza la descripción de distinctiveCore en el OpenAPI.

Qué hacer: nada obligatorio. Si guardas posiciones de la búsqueda por parecido, espera otro orden para textos con términos genéricos; el grupo distinctive puede faltar con núcleos cortos.

2026-09-29 · [FIX] Los demás 400 validation_error también llevan errors[], una entrada por campo

Los 400 validation_error que nacen de una regla entre campos (no del esquema de un campo) respondían sólo con texto en detail, sin errors[]. Ahora todos llevan una entrada por campo, { "field", "code", "detail" }, con code de un vocabulario cerrado:

errors[].code cuándo
not_combinable el campo choca con otro presente; detail dice con cuál
custom otra regla del contrato (campo no admitido aquí, campo que exige otro, texto sin nada buscable)
too_big / too_small tamaño o rango fuera de límite
unrecognized_keys el parámetro retirado offset

Cubre la búsqueda de marcas (GET /trademarks, POST /trademarks/search ≡ search_trademarks), GET /trademarks/renewal-calendar, GET /insights/trademarks, los informes /reports/*, la base documental y las leyes, y GET /holidays. No cambian el estado 400, el code de primer nivel ni el detail. REST y MCP publican el mismo cuerpo.

Qué hacer: nada obligatorio. Para saber qué parámetro falló, lee errors[].field en vez de analizar detail.

2026-09-29 · [BEH] Los arts. 6 y 7 del Reglamento de la Ley 19.039 citados antes del 2022-05-09 se leen contra el DS 82

GET /annotations/{id}?expand=citations ≡ get_annotation con citations. Desde fines de 2017 INAPI citó «art. 6 letra a/b/c/d» y «art. 7 letra b/c» del Reglamento con la numeración del DS 82, vigente sólo desde el 2022-05-09. Esas citas salían con text: null y textStatus: "letter_not_found". Ahora, si la anotación lleva la redacción característica de la letra, se leen contra el DS 82 en su primer día: textStatus: "found", scope: "letter", text.asOf: "2022-05-09" (posterior al acto) y documentCode: "bcn-1175783".

text.chosenBy gana el valor later_regulation_template. El art. 7 a) y d), y las citas sin esa redacción, no cambian. Afecta a 15.353 citas en 13.879 anotaciones.

Qué hacer: si validas text.chosenBy contra una lista cerrada, agrega later_regulation_template. Al mostrar el texto, advierte que aún no regía en la fecha del acto.

2026-09-29 · [BEH] El art. 9 del Reglamento de la Ley 19.039 que copia la plantilla de marcas se lee contra el DS 236, y text.chosenBy lo indica

GET /annotations/{id}?expand=citations ≡ get_annotation con citations. El 2022-05-09 el DS 82 reemplazó al DS 236 y su art. 9 pasó a tratar de patentes. INAPI siguió citando la plantilla de marcas del DS 236, y la regla «la fecha del acto elige el texto» servía el artículo de patentes (letter_not_split).

  • text gana el campo chosenBy, siempre presente: act_date (regla general) o former_regulation_template.
  • Una cita del art. 9 posterior al 2022-05-08 que lleva la redacción de la plantilla de marcas se lee contra el DS 236: textStatus: "found", text.asOf: "2022-05-08", documentCode: "bcn-244450". Cambian 254 citas.

Qué hacer: si validas la forma de text de manera estricta, acepta el campo chosenBy.

2026-09-29 · [BEH] La nota de frescura de las oposiciones explica cuánto tarda en llegar un acto de oposición

El texto de freshnessNote cambia; ningún esquema cambia. Aparece en meta de GET /trademarks/{applicationNumber}/annotations ≡ list_trademark_annotations y de POST /annotations/search ≡ search_annotations cuando se pide la familia de oposición, y como prefijo de las notas de get_class_stats y get_registration_signals.

La nota dice ahora que el primer C1 del Estado Diario llega entre 55 y 375 días después de la publicación, así que la ausencia de actos de oposición durante la ventana, y meses después, no prueba que no haya oposición. La ventana (publicación + 30 días hábiles, art. 5 Ley 19.039) sigue siendo el único plazo derivado. La versión del contrato (info.version del OpenAPI y serverInfo.version del MCP) pasa a 2026-09-29.

Qué hacer: nada si muestras la nota tal cual. Si la comparas con un literal, actualízalo o comprueba sólo que exista.

2026-09-29 · [BEH] get_filing_context (opposition): una marca sin denominación comparable omite la comparación, no el expediente

GET /reports/filing-context ≡ get_filing_context con type=opposition y ownApplicationNumber: si una de las dos marcas no tiene denominación comparable (figurativa o de sólo signos), el expediente entero respondía 422 no_comparable_denomination. Ahora llega completo, con comparison: null y un hecho comparison.omitted en facts por cada marca afectada (valor no_comparable_denomination, source.kind: "trademark_comparison", source.ref = su número de solicitud). Una marca propia inexistente sigue respondiendo 404.

Qué hacer: si asumías que comparison nunca es null al pasar ownApplicationNumber, revisa comparison.omitted en facts.

2026-09-29 · [BEH] analyze_logo: una imagen que el proveedor no puede procesar es 422 logo_image_rejected, no un 503

POST /logos/analyze ≡ analyze_logo. La validación local lee sólo la cabecera de la imagen: un fichero truncado o con basura tras una cabecera válida la pasa, y el proveedor lo rechaza. Hasta ahora eso respondía 503 logo_analysis_unavailable («reintente más tarde»), y cada reintento de la misma imagen gastaba cuota. Ahora responde 422 logo_image_rejected en los dos transportes, no reintentable. 503 logo_analysis_unavailable queda para la indisponibilidad real. El 422 cuenta en la cuota diaria y en la mensual.

Qué hacer: trata 422 logo_image_rejected como un error de la imagen (pide otra al usuario) y no lo reintentes.

2026-09-29 · [BEH] El detector de términos genéricos tiene topes, y frequency.notEvaluated declara lo que no examinó

Afecta al canal distinctive de POST /trademarks/search ≡ search_trademarks con similarTo, a la disponibilidad, a POST /trademarks/compare ≡ compare_trademarks y a GET /reports/filing-context ≡ get_filing_context. Sin cambiar la entrada:

  • una palabra de más de 30 letras no se examina;
  • sólo se examinan las primeras 12 palabras distintas del texto;
  • hay un máximo de sondas por detección.

Lo que queda sin examinar va a frequency.notEvaluated y, con clases, frequency.state es partial. En la búsqueda por parecido, esa palabra simplemente no aparece en decompounded ni en genericTerms y sigue en distinctiveCore.

Qué hacer: nada. Si muestras notEvaluated, su descripción explica los motivos.

Requiere el permiso propio logo:analyze. Es la única operación del contrato que usa un modelo de lenguaje (Anthropic), y la respuesta lo declara en generatedBy.

  • Entrada: image {mediaType, dataBase64}: PNG, JPEG, GIF o WebP, hasta 700 KB y 2.000 px por lado. Nunca una URL (400).
  • Respuesta: disclaimer, description, elements, suggestedSignType, viennaCodes[] (sólo códigos que existen en VCL10, con etiqueta de la OMPI en inglés y francés; es siempre null), discardedCodes, viennaCatalog e image (con sha256; la imagen no se guarda).
  • Cuota propia: 20 por clave y día de Chile, 200 por día en total ⇒ 429 logo_quota_exceeded / 429 logo_global_quota_exceeded con Retry-After.
  • Errores: 400 invalid_image (con reason), 422 logo_analysis_refused, 502 logo_analysis_invalid_output, 503 logo_analysis_not_configured, 503 logo_analysis_unavailable, 503 logo_quota_unavailable.

Ninguna clave lo recibe por defecto. No opina sobre registrabilidad.

Qué hacer: para usarlo, concede logo:analyze a la clave escribiendo la lista completa de sus permisos. Muestra siempre el disclaimer y la atribución de la OMPI; trata 503 logo_analysis_not_configured como «todavía no disponible» y el 429 diario aparte del mensual.

2026-09-29 · [ADD] Expediente de hechos para un escrito: GET /reports/filing-context ≡ get_filing_context

Informe con permiso propio reports:filing-context:read (también lo concede reports:read).

  • Entrada: type (power_of_attorney, opposition, opposition_response, office_action_response, withdrawal), applicationNumber, annotationId (obligatorio con office_action_response), ownApplicationNumber (sólo opposition) y expand=legalTexts.
  • Respuesta: trademark, facts[] ({key, value, source}), milestones, milestonesOmitted[], citedNorms[], normSignals[], comparison, outline (estructura sin texto), dataAsOf, coverageThrough.
  • El único plazo publicado es el cierre de oposición (opposition_close, art. 5 Ley 19.039). Los plazos sin artículo verificado van en milestonesOmitted con no_legal_basis_in_knowledge_base.
  • expand=legalTexts exige además legal:read; sin él, 403 forbidden sin consumir cuota.
  • No redacta ni da veredictos. third_party_observations no es un tipo (400). Marca inexistente ⇒ 404.

Qué hacer: para usarlo, concede reports:filing-context:read (o reports:read) y, si quieres los textos legales, legal:read, escribiendo la lista completa de permisos. No muestres como plazo nada que no venga en milestones.

2026-09-29 · [ADD] Recomendación de clases de Niza: POST /nice-classes/recommend ≡ recommend_nice_classes

Permiso brands:read. Entrada: description (3–500 caracteres) y limit (1–10, por defecto 5); sólo palabras vacías ⇒ 400 validation_error.

Respuesta: edition (la vigente en Chile: 13-2026 hasta el 2026-12-31, 13-2027 desde el 2027-01-01), editionSelection, listVersion, candidates[] (clase, encabezado en tres idiomas, signals, ranks, hasta 5 officialTerms[] y 3 corpusExamples[]), method, meta {channels, pendingEmbeddings}, attribution (OMPI, CC BY 4.0) y dataAsOf. Cada vía declara su estado en meta.channels: ran, degraded, not_configured, pending_embeddings o not_loaded.

Qué hacer: nada si no lo usas. Si lo muestras, cita attribution y la edition, y trata not_loaded/pending_embeddings como «todavía no», no como error. Es una señal, no una clasificación oficial.

2026-09-29 · [ADD] Índice orientativo de registro: GET /reports/registration-signals ≡ get_registration_signals

Informe con permiso propio reports:registration-signals:read (también lo concede reports:read; reports:clearance:read no basta).

  • Entrada: text (1–200) y niceClass (1 a 3 clases; 4 ⇒ 400).
  • Respuesta: perClass[] con signals[] (S1…S6, cada una con valor, fuente y evidencia), signalIndex (0–100 o null) y weightsApplied; además formula, weights (provisionales), indexLabel («no es un veredicto», tres idiomas), method, el descuento de genéricos, dataAsOf y coverageThrough.
  • Una señal nula queda fuera y su peso se reparte. Antes del primer cálculo de las estadísticas de clase, S3 y S4 salen null con class_stats_pending.

Qué hacer: para usarlo, concede reports:registration-signals:read (o reports:read). Muestra las señales con su fuente y siempre indexLabel junto al índice; no lo conviertas en «bajo/medio/alto».

2026-09-29 · [ADD] Panorama de conflicto: GET /reports/conflict-landscape ≡ get_conflict_landscape

Informe con permiso propio reports:conflict-landscape:read (también lo concede reports:read). Entrada: text (1–200) y niceClass (1 a 10).

Toma las 60 marcas más parecidas del mismo motor que get_clearance_report, se queda con las vivas y las agrupa por las partes con relación vigente. Respuesta: representatives[] y holders[] (hasta 20), cada una con party, similarTrademarks, evidence[] (≤ 5), evidenceTruncated y totalTrademarksInClass[]; además partiesTotal, method, el descuento de genéricos, dataAsOf y coverageThrough. Sin el permiso, 403 forbidden sin consumir cuota.

Qué hacer: para usarlo, concede reports:conflict-landscape:read (o reports:read). Muestra siempre totalTrademarksInClass junto a similarTrademarks: son señales, no una conclusión sobre una parte.

2026-09-29 · [ADD] Estadísticas de una clase: GET /nice-classes/{niceClass}/stats ≡ get_class_stats

Permiso brands:read. Entrada: la clase (1–45) y filedFromYear/filedToYear (por defecto, los cinco últimos años completos). Rango invertido ⇒ 400 invalid_range.

Respuesta: period, population, grupos de desenlace con grantShare, refusedShare, withdrawnShare y annulledShare (misma definición que get_party_outcomes), timeToRegistration (percentiles aproximados, ±15 días), actsShare, coverage {notes[]}, definition y dataAsOf. Las cifras se recalculan en cada sincronización; antes del primer cálculo, 503 class_stats_pending.

Qué hacer: nada si no lo usas. Si lo muestras, cita population.filed y el periodo, di que los tiempos son aproximados y lee coverage.notes. Trata 503 class_stats_pending como «todavía no calculado».

2026-09-29 · [BEH] La búsqueda por parecido y la disponibilidad descuentan los términos genéricos: canal distinctive

POST /trademarks/search ≡ search_trademarks con similarTo y GET /reports/clearance ≡ get_clearance_report ganan un cuarto canal, distinctive: busca el núcleo distintivo del texto, sin los términos genéricos de sus clases y con las palabras pegadas separadas.

  • matchedBy[] y similar[].channel ganan el valor distinctive.
  • Campos nuevos opcionales, sólo cuando el canal corrió: genericTerms[], distinctiveCore, decompounded[]. Si no hay nada que descontar, la respuesta es la de antes.
  • No cambian signals, score, similarToTrademark ni la vigilancia.

Qué hacer: si validas matchedBy o similar[].channel contra una lista cerrada, acepta distinctive. Que un término sea genérico no es un veredicto.

2026-09-29 · [BEH] El canal semántico desempata por número de solicitud: el mismo similarTo da el mismo orden

POST /trademarks/search ≡ search_trademarks (con q, similarTo o similarToTrademark), los informes que buscan marcas parecidas y la vigilancia. Dos marcas con el mismo vector (p. ej. marcas sonoras sin nombre) empataban en el canal semántico en un orden no determinista, lo que podía cambiar su score y el orden de items entre dos llamadas idénticas. Ahora esos empates se resuelven por applicationNumber ascendente: entre marcas con el mismo vector, la de número menor puntúa un poco más, siempre la misma. El orden entre marcas que no empatan no cambia. La forma de la respuesta no cambia.

Qué hacer: nada.

2026-09-29 · [FIX] El 400 del lote con parámetros no admitidos lleva errors[], uno por campo

GET /trademarks, POST /trademarks/search ≡ search_trademarks. applicationNumber combinado con lo que el lote no admite (cursor, limit, sort, minScore, q, denomination, facets, similarTo, similarToTrademark, allClasses) respondía 400 validation_error sin errors[]. Ahora trae una entrada por campo no admitido, en orden estable:

{ "field": "cursor", "code": "not_combinable", "detail": "…" }

No cambian el estado, el code de primer nivel ni detail. REST y MCP devuelven el mismo cuerpo.

Qué hacer: nada obligatorio. Si hoy analizas detail para saber qué campo sobra, puedes leer errors[].field.

2026-09-29 · [DATA] Catálogo de normas: 39 normas, 38 con título

/legal-norms, /legal-norms/{id} ≡ list_legal_norms / get_legal_norm, y el filtro citedNorm. Tras la limpieza del catálogo: sale la norma id 48 (un «reglamento 19.880» inexistente; sus citas pasan al Reglamento de la Ley 19.039) y 15 normas que eran erratas, cuyas citas se reapuntan a la Ley 19.039, su Reglamento o la Ley 19.880. La norma id 112 (Reglamento de la Ley 20.000) recibe su título oficial, y entran las leyes 1.552, 19.496 y 19.996. Sólo la ley 19.037 (id 59) sigue sin título, a propósito. La forma no cambia.

Qué hacer: un id guardado de una norma retirada responde 404; si listas las normas, aparecen cuatro más con título.

2026-09-29 · [DATA] act deja de ser null en 103 anotaciones de C7/C8

Annotation, REST ≡ MCP. 103 anotaciones de C7/C8 cuyo encabezado se había guardado cortado recuperan el encabezado completo desde el boletín archivado, y con él se identifica su acto: pasan de act: null / actStatus: "unidentified" a 738 (47), 741 (33), 919 (9), 964 (8) y 925 (6), con su actName/actLabel y actStatus: "identified". Ningún otro campo cambia. Otras anotaciones siguen unidentified porque el boletín no permite identificarlas.

Qué hacer: nada; un recuento de anotaciones sin acto baja en 103.

2026-09-29 · [DATA] act deja de ser null en 592 anotaciones de la familia A

Annotation, REST ≡ MCP. Las 592 anotaciones de la familia A cuya observation se completó (entrada más abajo) pasan de act: null a su código de INAPI, leído del encabezado de subsección del boletín archivado, con su nombre y etiqueta; su actStatus pasa a identified. Ningún otro campo cambia.

Qué hacer: nada; un recuento de anotaciones sin acto baja en 592.

2026-09-29 · [DATA] Citas: el Protocolo de Madrid y el Código Civil dejan de contarse como Ley 19.039; el CPC pasa a la Ley 1.552

citedNorm, /legal-norms ≡ list_legal_norms / get_legal_norm, expand=citations y las citas de las Directrices. Las citas a los arts. 4 y 5 del Protocolo de Madrid y 16 y 17 de su Reglamento Común se registraban como artículos de la Ley 19.039 y de su Reglamento; dejan de ser citas, igual que las del Código Civil (≈44.100 citas en total). Las del Código de Procedimiento Civil pasan a la Ley 1.552 (≈11.200). En las Directrices, ≈105 citas pasan a la 1.552 y «artículo 6 ter del CP» (Convenio de París) deja de ser una cita. La forma no cambia.

Qué hacer: rehaz cualquier recuento de citedNorm=19039 con article 4 o 5, del Reglamento con 16 o 17, o de citas sin ley; citedNorm=1552 devuelve las del CPC.

2026-09-29 · [ADD] Tres leyes nuevas en el catálogo: 1.552 (CPC), 19.496 y 19.996

/legal-norms ≡ list_legal_norms / get_legal_norm, get_legal_norm_article. Entran con su título oficial de BCN: Ley 1.552 «Código de Procedimiento Civil», Ley 19.496 (protección de los derechos de los consumidores) y Ley 19.996 (modifica la Ley 19.039). Su texto se carga con todas sus versiones en la actualización semanal desde BCN. Los artículos del CPC responden xml_missing, porque BCN no sirve su texto estructurado. En /legal-norms sólo la 1.552 trae articles.

Qué hacer: nada; si listas las normas, aparecen tres más.

2026-09-29 · [BEH] Los artículos transitorios citados: article = '3 transitorio' y su texto es el del transitorio

GET /annotations/{id}?expand=citations ≡ get_annotation con citations, y las citas de /guidance/*. «Artículo 3° transitorio de la Ley 19.996» se publicaba como el artículo 3 permanente, con su texto. Ahora:

  • article lleva el sufijo ('3 transitorio'; «octavo transitorio» ⇒ '8 transitorio'). Sin sufijo sigue siendo el permanente.
  • text es el del artículo transitorio (found), o article_not_found, o ambiguous_article si casan dos. Nunca el permanente.
  • Un transitorio sin ley escrita (p. ej. estatutos de una sociedad) deja de publicarse como cita.

Se añaden 15 citas y se retiran 19 que eran transitorios. La forma no cambia.

Qué hacer: si interpretas article como número, acepta el sufijo transitorio.

2026-09-29 · [DATA] Anotaciones de la familia A: observation completa donde antes estaba cortada

Annotation, REST ≡ MCP. 592 anotaciones del Estado Diario de la familia A (A1 391 · A4 156 · A3 45; 2024-09-30 → 2026-08-07) tenían la observation cortada en el salto de página del boletín. Ahora traen el texto completo: el nuevo empieza literalmente por el anterior y continúa (de ~95 a ~1.831 caracteres de media). El id, parties[] y el resto de campos no cambian; pueden aparecer citas nuevas que estén en el texto añadido. La forma no cambia.

Qué hacer: nada; si guardas observation, refréscala.

2026-09-29 · [BREAK] extractionStatus gana el valor ocr, y cada resultado de search_guidance lo trae

Un documento de INAPI publicado solo como imagen (por ejemplo, el capítulo 21 de las Directrices, un diagrama) podía estar en image_only, sin texto. Tras leerlo a máquina pasa a ocr: tiene un apartado por página (path ocr.p1, kind block) que se lee con get_guidance_section y aparece en search_guidance, pero su texto no es literal: alguna palabra puede estar mal leída y las etiquetas de un diagrama salen en orden de página.

Dos cambios en /guidance/* ≡ list_guidance_documents, get_guidance_document, get_guidance_section, search_guidance:

  • extractionStatus admite ocr además de pending, extracted, partial, image_only y failed. Rompe solo a quien valide la lista cerrada (un switch exhaustivo o un enum estricto).
  • Cada resultado de POST /guidance/search ≡ search_guidance trae version.extractionStatus (campo nuevo, siempre presente). Su excerpt es literal salvo cuando vale ocr.

Qué hacer: acepta ocr y, cuando aparezca, presenta el texto como «leído a máquina de una imagen» y enlaza al PDF (sourceUrl) para citar. Ningún campo existente cambia de nombre ni de tipo.

2026-09-29 · [DATA] partial pasa a significar solo «árbol incompleto»: 18 capítulos de las Directrices pasan a extracted

Hasta ahora un capítulo quedaba partial también cuando el título de un apartado estaba redactado distinto en el Sumario y en el cuerpo. Ahora partial significa solo árbol incompleto: una entrada del Sumario sin cuerpo, o un título del cuerpo que el Sumario no lista. Además, se reconoce un título impreso a tamaño de texto y el pie de página ya no se cuela en el texto.

Resultado sobre los 50 capítulos: de 18 extracted / 31 partial a 35 extracted / 14 partial (el capítulo 11 baja a partial). Rutas y texto idénticos en 47 capítulos; en el capítulo 10 aparece II y sus § 3 y § 4 pasan de I.B.§3/I.B.§4 a II.§3/II.§4; en los capítulos 9 y 32 desaparecen 9 recuadros (…sidebarN) que eran solo pie de página y los siguientes se renumeran.

Qué hacer: si guardaste referencias a esos apartados, vuelve a resolverlas por (code, version, path).

2026-09-28 · [ADD] Comparar dos marcas vía por vía: POST /trademarks/compare ≡ compare_trademarks

Permiso brands:read. Entrada: a y b, cada uno exactamente uno de {text, niceClass?} o {applicationNumber}. Combinación inválida ⇒ 400 validation_error; número inexistente ⇒ 404; marca sin denominación comparable ⇒ 422 no_comparable_denomination.

Respuesta: por lado, texto, clase, clave fonética, genericTerms[], decompounded[] y distinctiveCore; signals (léxica, distancia de edición, fonética, semántica, términos compartidos), distinctiveSignals, classes, goodsAndServices (sólo marca contra marca), method, meta y dataAsOf. Sin puntuación global, sin nivel ni «riesgo». semantic: null significa no evaluado, nunca 0.

Qué hacer: muestra las vías por separado con su method y, si resumes, cita genericTerms. No combines las señales en un porcentaje.

2026-09-28 · [ADD] search_trademarks: partyRole limita taxId a un papel

GET /trademarks, POST /trademarks/search y search_trademarks aceptan partyRole (holder | representative) junto a taxId: el RUT casa sólo con las marcas donde la parte tiene ese papel, en todos los motores. Sin partyRole nada cambia. partyRole sin taxId ⇒ 400 validation_error, igual en REST y MCP. Mismo vocabulario que partyRole de search_annotations.

Qué hacer: nada si no lo usas. Para «las marcas que representa este RUT», agrega partyRole=representative.

2026-09-28 · [ADD] search_annotations: filtros por parte y por estado actual de la marca

POST /annotations/search ≡ search_annotations acepta cinco campos opcionales:

  • partyId o taxId (como mucho uno): sólo anotaciones de las marcas de esa parte. partyId inexistente ⇒ 404; taxId sin forma de RUT ⇒ 400 invalid_rut.
  • partyRole (holder | representative) y relation (current por defecto | former | all): sólo con parte; si no, 400 validation_error.
  • trademarkStatus: sólo anotaciones de marcas cuyo estado publicado actual está en la lista (misma semántica que status de la búsqueda de marcas).

Sin estos campos la respuesta no cambia.

Qué hacer: nada si no lo usas. «¿Qué le pasó esta semana a las marcas de este RUT?» es ahora { "taxId": "…", "dateFrom": "…" }.

2026-09-28 · [ADD] Desenlaces de una parte: GET /parties/{id}/outcomes ≡ get_party_outcomes

Permiso brands:read. Entrada: role (representative por defecto, o holder), relation (all por defecto), niceClass, filedFrom, filedTo.

Respuesta: party, population, groups[] (registered_ever, refused, withdrawn_or_abandoned, annulled, pending, cada uno con su lista de estados), unclassified, decided, pending, grantShare, refusedShare, withdrawnShare, annulledShare (sobre las decididas; null, nunca 0, si no hay), definition en tres idiomas y dataAsOf. Parte inexistente ⇒ 404; filedFrom > filedTo ⇒ 400 invalid_range. No es una «tasa de éxito»: es una señal descriptiva.

Qué hacer: si lo muestras, acompaña el cociente con population.trademarks y la definición.

2026-09-28 · [ADD] Tasas oficiales de INAPI: POST /fee-schedule/calculate ≡ calculate_fees

Permiso brands:read (la tabla completa, GET /fee-schedule, sigue en legal:read).

  • Entrada: procedure (application_and_registration | renewal), exactamente uno de niceClassCount (1–45) o applicationNumber, on (fecha de pago) y utmMonth.
  • Respuesta: lines[] con montos en UTM y pesos, totalUtm, totalClp, totalOmittedReason (surcharge_doubt | lapsed | null), utm, renewal, excluded, trademark, source, dataAsOf.
  • En la gracia de renovación el total es null (surcharge_doubt); pasada la gracia, lapsed.
  • Errores: 404, 422 renewal_not_applicable, 422 no_nice_classes.

Qué hacer: si muestras costos, muestra excluded y, con totalOmittedReason, explica por qué no hay total en vez de sumar las líneas.

2026-09-28 · [BEH] MCP: un rechazo por permiso sale con status: 403 (antes 400), como en REST

Por MCP, una herramienta llamada con una clave sin el permiso que exige pasa de status: 400 / title: "Request validation failed" a status: 403 / title: "Forbidden", con el mismo detail que REST (API key lacks required scope: brands:read). Una clave ausente, desconocida o revocada pasa de 400 a 401 / "Unauthorized". El code no cambia (forbidden / unauthorized). REST no cambia.

Qué hacer: si tu cliente MCP decide por code, nada. Si decide por status, interpreta 403 como «falta un permiso» y 401 como «clave inválida», no como error de entrada.

2026-09-28 · [ADD] Calculadora de días hábiles: GET /business-days ≡ compute_business_days

Permiso brands:read. Entrada: from (YYYY-MM-DD) y exactamente uno de businessDays (1–250) o preset (sólo opposition); anchorKind opcional. Combinación inválida ⇒ 400 validation_error.

Respuesta: anchor, businessDays, date (el N.º día hábil estrictamente posterior a from, sin fines de semana ni feriados), term, legalBasis, calendar, skipped, basis (derived | estimated), estimateReasons, todayChile, elapsed y businessDaysLeft. Sin preset, term.source: "caller" y term.legalBasis: null: un número no es un plazo. Con preset=opposition (art. 5 Ley 19.039, N = 30) cita sus normas.

Qué hacer: muestra la fecha con legalBasis, di «estimación» cuando basis sea estimated y no presentes como plazo legal un conteo con term.source: "caller".

2026-09-28 · [ADD] Las normas citadas en el expediente: GET /trademarks/{n}?expand=norms ≡ get_trademark

norms ya era un valor aceptado de expand, pero no devolvía nada. Ahora el expediente trae dos campos siempre presentes: norms y normsTruncated (ambos null si no se piden). norms[] trae una entrada por (tipo, norma, artículo, letra, inciso) citada en las anotaciones de la marca: normKind (ley|reglamento), legalNormId (null si el acto cita un artículo sin nombrar la ley; esa cita se incluye igual), citedNorm, name, article, letter, subsection, annotationCount, firstCitedOn, lastCitedOn y annotationIds (hasta 20, las más recientes). Primero las más citadas; como máximo 100 entradas (normsTruncated: true si hay más). Con dedupe=true (por defecto) annotationCount cuenta hechos, no filas.

El texto de la ley no viaja aquí: se lee con GET /annotations/{id}?expand=citations usando uno de los annotationIds. Pedir norms exige legal:read además de brands:read; sin él, 403 forbidden que nombra legal:read, antes de consumir cuota. Hasta ahora esa misma petición respondía 200.

Qué hacer: si pides expand=…,norms con una clave sin legal:read, quita norms o pide el permiso. Para mostrar las normas del expediente, lee norms[] en vez de recorrer annotations[].

2026-09-28 · [BEH] El error de las corridas documentales ya no incluye el mensaje completo de la base de datos — GET /system/sync-runs ≡ list_sync_runs

En las corridas con source inapi_documents, bcn_statutes y sii_indicators, un fallo de base de datos aparecía en error con el mensaje completo, que podía arrastrar valores de la fila que falló. Ahora aparece solo un código de error estándar, más los nombres de tabla, restricción o columna cuando existen. Un error de conexión publica solo su código (ECONNREFUSED). Las demás fuentes no cambian y error sigue siendo texto libre.

Qué hacer: nada, salvo que analices el texto de error; el formato general (código (motivo); …) no cambia.

2026-09-28 · [ADD] La cita explicada: GET /annotations/{id}?expand=citations ≡ get_annotation con expand

El detalle de una anotación puede traer, por cada norma que cita la resolución, el texto literal del artículo o letra vigente en la fecha de la anotación y las señales de las Directrices. La ruta admite solo expand=citations; exige legal:read además de brands:read (sin él, 403 forbidden antes de consumir cuota).

La respuesta suma citations[] (hasta 50, en el orden de la resolución) y citationsTruncated. Cada cita trae normKind, legalNormId, citedNorm, name, article, letter, subsection, span; text (asOf, documentCode, validFrom, validTo, articleLabel, scope, body…) o null, con la misma regla de vigencias que get_legal_norm_article; textStatus (found, letter_not_split, law_not_identified, no_text_loaded, no_date, out_of_window, article_not_found, ambiguous_article, letter_not_found); y guidance[] (hasta 5 documentos de INAPI que citan ese artículo, con sus apartados). Son señales: ningún campo dice qué apartado interpreta la cita. En listas y en GET /trademarks/{n}, expand=citations es 400 validation_error. Sin expand, la respuesta es idéntica a la anterior.

Qué hacer: nada si no muestras normas. Si sí: pide expand=citations solo al abrir una anotación, muestra text.asOf junto al texto y textStatus cuando no hay texto.

2026-09-28 · [ADD] Tasas, indicadores y cambios de versión: get_fee_schedule, list_economic_indicators y list_guidance_changes

Tres lecturas nuevas de la base documental, con permiso legal:read:

  • GET /fee-schedule ≡ get_fee_schedule: la tabla de tasas del cap. 13 de las Directrices en UTM. Entrada utmMonth? (YYYY-MM). Devuelve items[] con amountUtm, unit (per_class|fixed), amountClp (calculado al leer: amountUtm × utm.value; null sin UTM), hasDoubt, además de utm {month, value, basis} y surchargeDoubt, que expone la duda abierta del recargo por renovación tardía. Sin tabla, 422 out_of_coverage.
  • GET /economic-indicators ≡ list_economic_indicators: code obligatorio (UTM, UTA, IPC, UF, USD_OBSERVED), from/to, limit (1–366), cursor. Filas {code, date, value, unit, baseNote} y meta.coverage. Rango fuera de cobertura, 422; from > to, 400.
  • GET /guidance/changes ≡ list_guidance_changes: cambios de versión de documentos de INAPI y textos de BCN, con filtros document, publisher, from/to, y por cambio fromVersion/toVersion, detectedAt, counts y sections[] (hasta 100).

Qué hacer: nada si no los usas. Si sí: la clave necesita legal:read; al mostrar pesos, muestra también utm.month, y no mezcles valores del IPC con baseNote distinta.

2026-09-28 · [ADD] Buscar en la base documental: search_guidance ≡ POST /guidance/search y search_statutes ≡ POST /legal-norms/search

Dos búsquedas nuevas con permiso legal:read. search_guidance busca en los apartados de la versión vigente de cada documento de INAPI (q, mode, kind, document, limit, cursor); cada resultado trae document, version, path, heading, paragraphNumber, páginas, excerpt y matchedBy. search_statutes busca artículos de ley en el texto vigente hoy; asOf elige una fecha y allVersions: true busca en todas las vigencias (el mismo texto sale una vez, con todas en validity[]). norm acota a una norma.

mode: hybrid (por defecto, texto + parecido de significado), text (admite "frase", or, -palabra) o semantic. meta.channels declara qué canal corrió; si el semántico no está disponible, hybrid devuelve solo el texto con semantic: "unavailable" y semantic responde 503 service_unavailable. excerpt es literal, sin puntuaciones. Bordes: q sin palabras buscables o solo con exclusiones, o asOf junto a allVersions, 400; norm inexistente, 404; sin texto cargado, 422 out_of_coverage.

Qué hacer: nada si no buscas. Si sí: pide legal:read, muestra validity en los resultados de leyes y avisa cuando la búsqueda fue solo por palabras.

2026-09-28 · [ADD] Las Directrices de INAPI, legibles: get_guidance_section, list_guidance_documents y get_guidance_document ≡ /guidance/documents/*

Los documentos que publica INAPI (capítulos de las Directrices, circulares, manual y página de Madrid, tasas) se leen por el contrato, con permiso legal:read:

  • GET /guidance/documents/{code}/section ≡ get_guidance_section: un apartado literal con sus páginas, su version (con extractionStatus), sus children[] y las normas que cita (citations[]). Se elige por path o por paragraph, uno solo.
  • GET /guidance/documents ≡ list_guidance_documents: la colección, con currentVersion y filtros kind (guideline, circular, manual, web_page, fee_schedule) y q.
  • GET /guidance/documents/{code} ≡ get_guidance_document: el documento, todas sus versions[] y su Sumario (outline[], sin cuerpos).

La referencia estable de un apartado es (code, version.seq, path). Una versión image_only responde 422 out_of_coverage al pedir un apartado. path y paragraph juntos o ninguno, 400; párrafo repetido, 409 ambiguous_selector con candidates; inexistente, 404. dataAsOf es el de la fuente documental, no el del corpus de marcas.

Qué hacer: nada si no muestras las Directrices. Si sí: pide legal:read, cita por code + version.seq + path y muestra extractionStatus cuando no sea extracted.

2026-09-28 · [ADD] get_legal_norm_article ≡ GET /legal-norms/{id}/articles/{article} y el permiso legal:read

Nuevo permiso legal:read para la base documental, denegado por defecto: una clave con scopes vacío, la clave de prueba, reports:read o brands:read no lo reciben y obtienen 403 forbidden que lo nombra.

La herramienta devuelve el texto literal de un artículo de ley. Entrada: id (de /legal-norms), article (20, 17 bis a), y opcionales letter, subsection, asOf (por defecto hoy, hora de Chile) y transitional. Salida: norm, asOf, text (qué texto de BCN se leyó y su vigencia), article, articleLabel, headingPath, body, letters[], subsections[], notes[], selection y dataAsOf. Errores: norma inexistente o artículo ausente, 404; norma sin texto cargado o fecha fuera de vigencia, 422 out_of_coverage; dos artículos con la misma clave, 409 ambiguous_selector (código nuevo) con candidates; letra pedida en un artículo no dividido, 200 con el artículo entero y selection.status: "article_not_split".

Qué hacer: pide legal:read para la clave que lea la base documental. Al concederlo, escribe la lista de scopes completa: pasar de [] a ["legal:read"] quitaría las demás lecturas.

2026-09-28 · [DATA] Tres fuentes documentales nuevas en GET /system/sync-runs ≡ list_sync_runs

Pueden aparecer tres valores nuevos de source: inapi_documents (semanal), bcn_statutes (semanal) y sii_indicators (diaria). Guardan lo que publican INAPI, BCN y el SII. dataAsOf del corpus de marcas no cambia: estas corridas no cuentan para su cálculo. source ya era un texto abierto.

Qué hacer: nada, salvo filtrar por source si muestras el estado de la sincronización: una corrida del SII no dice nada sobre la frescura de las marcas.

2026-09-27 · [DATA] act identifica los dos actos de C15N (832 y 833)

Los dos encabezados de subsección de C15N («Cúmplase en juicios de Nulidad») se reconocen como los actos 832 y 833. Las 8 anotaciones que salían con act: null y actStatus: "unidentified" pasan a act 832/833 con identified. Quedan 1.993 anotaciones unidentified. La forma no cambia.

Qué hacer: nada.

2026-09-27 · [DATA] Normas: 19 títulos más, 5 erratas de la 19.039 y 5 reglamentos vacíos retirados

El catálogo de /legal-norms ≡ list_legal_norms pasa de 63 a 51 normas, 34 con título. Diecinueve leyes reciben su título oficial de BCN (entre ellas 21.045, 21.094, 20.606, 20.285, 17.336). Doce normas dejan de existir y su id responde 404 en /legal-norms/{id} ≡ get_legal_norm: las variantes mal tecleadas de la 19.039 (1039, 13039, 15039, 18039, 1903), cuyas 16 citas pasan a la 19.039, y 5 reglamentos sin citas (18.445, 17.336, 18.455, 21.355, 19.031). Otras 10 citas duplicadas dejan de contarse bajo otras leyes. La forma no cambia.

Qué hacer: un id guardado de esas 12 normas deja de resolver; citedNorm con 1039, 13039, 15039, 18039 o 1903 deja de devolver resultados (usa 19039).

2026-09-26 · [BEH] C13N y C15N ganan nombre y etiqueta

Dos códigos de la serie de nulidad no tenían nombre. Ahora traen el encabezado literal del Estado Diario: C13N «Ejecutorias en juicios de Nulidad» y C15N «Cúmplase en juicios de Nulidad». Sus 16 anotaciones pasan de sectionName: null a traer nombre; sectionLabel trae es-CL en ambos y en/pt-BR en C13N (en C15N son null). También cambia source.label/label en /sections ≡ list_sections/get_section. El catálogo queda en 674 códigos, 543 con nombre. Los catálogos pueden tardar hasta un día en reflejarlo por caché.

Qué hacer: nada.

2026-09-26 · [BEH] POST /annotations/search ≡ search_annotations con section= deja de devolver 504

Con el filtro section=, la búsqueda de anotaciones agotaba el tiempo (504 query_timeout) en las secciones que empiezan tarde en el corpus (M5, ARENTLT, D5A, M11, C2…). Ahora responde con normalidad. No cambian la forma, el orden (date ASC NULLS LAST, id ASC) ni los cursores.

Qué hacer: nada. Si evitabas section= o reintentabas, ya puedes usarlo directamente.

2026-09-25 · [BEH] GET /parties/{id}/trademarks ≡ list_party_trademarks filtra por la identidad de la parte, no por su nombre

Con el papel holder o representative, la lista filtraba por subcadena del nombre: la cartera de «ACME» traía también las marcas de «ACME CHILE». Ahora filtra por la identidad de la parte, así que solo devuelve las marcas de las que es titular o representante. La forma no cambia; cambia el conjunto devuelto. Sin papel y con RUT, el comportamiento no cambia.

Qué hacer: nada. Si dependías de recibir marcas de nombres parecidos, dejan de llegar, que es lo correcto.

2026-09-25 · [BREAK] Se retira expiresOn de la anotación: publicaba la fecha de presentación, no un vencimiento

La anotación (GET /trademarks/{n}/annotations, POST /annotations/search, el expediente, los informes y sus gemelas MCP) publicaba expiresOn, pero en casi todas las filas ese valor era la fecha de presentación de la marca, no un vencimiento. Leído como vencimiento, generaba avisos falsos. El campo se retira.

La fecha del hecho sigue en date. El vencimiento de la marca (y su hito expiry) sigue en expiresOn del resumen de la marca, sin cambios.

Qué hacer: si leías expiresOn en una anotación, deja de existir: usa date para la fecha del hecho o expiresOn de la marca para el vencimiento.

2026-09-25 · [DATA] 18.951 anotaciones enlazadas con sus partes: parties[] las recoge

Se enlazaron 18.951 nombres del boletín con sus partes: 16.552 resueltos a una parte y 2.399 marcados como ambiguos o sin candidata. Entre ellos, 103 anotaciones del Estado Diario que habían recuperado representante y solicitante. Esas anotaciones pasan a traer parties[].

Qué hacer: nada; vuelve a leer parties[] de las anotaciones recientes si las guardaste vacías.

2026-09-25 · [ADD] get_renewal_calendar ≡ GET /trademarks/renewal-calendar: el calendario de renovación de un conjunto de marcas

Entrada: el filtro de marcas de GET /trademarks (lote applicationNumber de hasta 100, renewalStatus, holder, niceClass, status, fechas…) más from/to obligatorios (YYYY-MM-DD, inclusivos, como máximo 366 días), limit y cursor. Sin rango o con más de 366 días, 400 validation_error; from > to, 400 invalid_range; lote de 101, 422 batch_too_large; q, similarTo, similarToTrademark, allClasses, oppositionWindow, facets, citedNorm, article y letter, 400.

Salida: una fila por (marca, hito de renovación) en el rango, ordenadas por fecha y número: {applicationNumber, kind, date, basis, anchor, rule, legalBasis}, con kind renewal_window_open o grace_end; cada fila es el mismo hito que la marca publica en milestones[]. total exacto. Permiso brands:read.

Qué hacer: nada si no lo usas. Ejemplo: GET /trademarks/renewal-calendar?applicationNumber=…&from=2026-01-01&to=2026-12-31.

2026-09-25 · [ADD] groupBy=renewalStatus y la cartera por estado de renovación

GET|POST /insights/trademarks ≡ get_trademark_insights admiten groupBy=renewalStatus: un grupo {key, label, count} por estado (not_due, window_open, grace, lapsed), con etiquetas en tres idiomas que describen el plazo, no el estado jurídico. meta.undatedCount (marcas sin fecha de vencimiento) también viaja con este groupBy, y meta.notApplicableCount (nuevo) cuenta las marcas con fecha a las que la regla no se aplica. La suma de los count más ambos campos es el total filtrado.

GET /reports/portfolio ≡ get_portfolio_report gana byRenewalStatus {groups, undatedCount, notApplicableCount}, coherente con el renewalStatus de cada marca.

Qué hacer: nada si no lo usas. Al graficar el reparto, muestra undatedCount («sin fecha») y notApplicableCount («no aplica») aparte, nunca como un estado.

2026-09-25 · [ADD] Filtro renewalStatus y milestoneKind de renovación (renewal_window_open, grace_end)

renewalStatus es un parámetro nuevo del filtro de marcas (GET /trademarks, POST /trademarks/search ≡ search_trademarks, GET|POST /insights/trademarks ≡ get_trademark_insights): una lista (O) de not_due, window_open, grace, lapsed, evaluada en la fecha de la respuesta (hora de Chile). Una marca devuelta por renewalStatus=grace trae renewalStatus: "grace"; las de null no salen con ningún valor. Otro valor es 400 validation_error. Funciona en colección, búsqueda, lote, similitud, ventana de oposición e insights.

milestoneKind admite además renewal_window_open y grace_end (antes 400), y casa exactamente la fecha que la marca publica en milestones[].

Qué hacer: nada si no lo usas. Ejemplo: GET /trademarks?applicationNumber=…&renewalStatus=grace.

2026-09-25 · [BEH] milestoneFrom/milestoneTo sin milestoneKind incluyen también los hitos de renovación

Sin milestoneKind, el filtro de hitos casa las marcas con cualquier tipo filtrable en el rango. Ahora son cuatro: expiry, opposition_close, renewal_window_open y grace_end. Una llamada sin tipo trae también las marcas cuya única fecha en el rango es la apertura de la ventana de renovación o el fin del período de gracia (para octubre de 2026: 12.905 marcas, frente a 8.056 antes). La cartera no cambia.

Qué hacer: si filtras por hitos esperando solo vencimientos (o vencimientos y cierres de oposición), pasa milestoneKind explícito.

2026-09-25 · [DATA] Partes: 1.843 fichas duplicadas fusionadas en 1.480

Había partes duplicadas por un nombre guardado con saltos de línea o espacios dobles (misma entidad, mismo país, a lo sumo un RUT en el grupo). En cada grupo una ficha se queda y las demás se funden en ella: 1.480 grupos, 1.843 fichas fundidas, 524 vínculos marca–parte movidos (ninguna marca pierde titular) y 2 enlaces de parties[] en anotaciones. Afecta a /parties, /parties/{id}, /parties/{id}/trademarks ≡ list_parties/get_party/list_party_trademarks, las partes del expediente y la búsqueda por parte.

Las fichas fundidas siguen existiendo con trademarkCount: 0; su /trademarks sale vacío. Las partes con RUT distintos no se tocaron.

Qué hacer: vuelve a medir lo que dependa de recuentos por parte. Si guardaste el id de una ficha fundida, sus marcas están ahora en la otra ficha del mismo nombre.

2026-09-25 · [ADD] renewalStatus y los hitos renewal_window_open / grace_end (art. 24, Ley 19.039)

Campo nuevo renewalStatus (not_due | window_open | grace | lapsed | null, siempre presente) en el expediente (GET /trademarks/{n} ≡ get_trademark) y en cada marca de la colección, búsqueda, lote, similitud, ventana, list_party_trademarks y los informes de disponibilidad y cartera. Se ancla en expiresOn y se evalúa en la fecha de la respuesta, hora de Chile. Regla vigente (vencimientos desde 2022-05-09): not_due antes de vencimiento − 6 meses; window_open hasta el vencimiento; grace hasta vencimiento + 6 meses; lapsed después. Para vencimientos anteriores rige el régimen antiguo (30 días hábiles). null = la regla no se aplica: sin fecha de vencimiento, ni registrada ni esperando_renovacion, o vía Madrid.

milestones[] gana dos hitos derived: renewal_window_open (rule: "6_months_before_expiry") y grace_end (rule: "6_months_after_expiry"), con legalBasis de tres normas: Ley 19.039 art. 24 (term), Decreto 82/2022 art. 27 (regulation, valor nuevo de role) y Código Civil art. 48 (computation). grace no afirma que el registro esté vigente, y lapsed no afirma que no se pidiera la renovación. Los escritos de oposición no traen renewalStatus.

Qué hacer: nada si no lo usas. Lee null como «no se sabe», no como «no hay que renovar», y recuerda que el valor es el del día de la respuesta.

2026-09-25 · [BEH] renewals[] publica una sola vez el acto de renovación que traen las dos fuentes el mismo día

En el expediente, un mismo acto de renovación llegado por el Estado Diario y por la ficha de expediente el mismo día salía dos veces en renewals[]. Ahora se deduplica por (fecha, código) entre fuentes, por recuento: si una fuente trae 2 filas y la otra 1, se publican 2. Dos entradas de la misma fuente el mismo día no se juntan (pueden ser dos actos), y sin fecha no se deduplica. annotations[], eventId y lastRenewalOn no cambian.

Qué hacer: nada.

2026-09-25 · [BEH] Una fecha imposible en los filtros de marcas es 400, no 500

milestoneFrom/milestoneTo, filedFrom/filedTo, expiresFrom/expiresTo, registeredFrom/registeredTo y publishedFrom/publishedTo validaban solo la forma YYYY-MM-DD: 2026-02-30 o 2026-13-45 respondían 500 internal_error. Ahora se validan como días reales del calendario (igual que dateFrom/dateTo de /annotations/search) y responden 400 validation_error, también el año 0000. Vale en REST y en MCP.

Qué hacer: nada; si reintentabas ese 500, ahora es un 400 que no se reintenta.

2026-09-25 · [ADD] Filtro milestoneKind=opposition_close por fecha de cierre de la ventana de oposición

milestoneKind=opposition_close con milestoneFrom/milestoneTo (basta uno) devuelve las marcas cuyo cierre de oposición cae en el rango, en GET /trademarks, POST /trademarks/search ≡ search_trademarks (búsqueda, lote de 100, similitud, ventana de oposición) y GET|POST /insights/trademarks ≡ get_trademark_insights. Casa exactamente el hito opposition_close publicado en milestones[], sea derived o estimated. Sin tope de rango. Un tipo desconocido sigue siendo 400 validation_error.

?milestoneKind=opposition_close&milestoneFrom=2026-09-28&milestoneTo=2026-10-04

Qué hacer: nada si no lo usas. Para avisos de cierre, basta una llamada con el lote y el rango.

2026-09-25 · [BEH] milestoneFrom/milestoneTo sin milestoneKind incluyen opposition_close

Hasta ahora, sin milestoneKind el filtro de hitos equivalía a expiresFrom/expiresTo. Ahora casa las marcas con algún hito filtrable en el rango: su vencimiento o su cierre de oposición. Una llamada que ya funcionaba puede traer más marcas; ninguna pasa a dar error. Los hitos próximos de /reports/portfolio siguen siendo solo expiry.

Qué hacer: si llamas sin milestoneKind esperando solo vencimientos, añade milestoneKind=expiry.

El cierre de la ventana de oposición pasa a ser un hito: {kind: "opposition_close", date, basis, anchor: {kind: "publication", date}, rule: "30_business_days_after_publication", legalBasis}. Viaja en el expediente y en cada marca de la colección, búsqueda, lote, similitud, ventana, list_party_trademarks y los informes. Su date es el deadline de oppositionWindow. milestones[] va ordenado por fecha.

legalBasis cita tres normas: Ley 19.039 art. 5 (term), Ley 19.039 art. 11 (business_days) y Ley 19.880 art. 25 (computation). basis: "estimated" (valor nuevo) añade estimateReasons cuando el cierre no se puede afirmar: published_on_non_business_day (publicación en día inhábil) u outside_holiday_calendar (tramo fuera del calendario de feriados declarado; el cierre real cae ese día o después). Sin fecha de publicación no hay hito. oppositionWindow gana legalBasis y, si es estimado, estimateReasons.

Qué hacer: nada si no lo usas. Si muestras la fecha de cierre, distingue estimated de derived.

2026-09-25 · [BREAK] legalBasis de un hito calculado pasa de objeto a lista {norm, article, role}

En milestones[], la variante derived declaraba legalBasis: {norm, article} (un objeto). Ahora es una lista no vacía de {norm, article, role} (role: term | business_days | computation), para citar todas las normas del plazo. Vale igual para estimated y para oppositionWindow.legalBasis. Hasta ahora no se había emitido ningún hito derivado, así que cambia la forma declarada en el OpenAPI, no ninguna respuesta ya servida. expiry no lleva legalBasis.

antes:   "legalBasis": {"norm": "Ley 19.039", "article": "5"}
después: "legalBasis": [{"norm": "Ley 19.039", "article": "5", "role": "term"}, …]

Qué hacer: si generaste tipos desde el OpenAPI, regenéralos y lee legalBasis como lista.

2026-09-25 · [DATA] Anotaciones del Estado Diario: el texto que el boletín truncó

Algunas entradas del boletín se habían guardado cortadas. Se releyeron los boletines originales y se completaron 186 anotaciones del Estado Diario (2024-10 a 2026-08), solo donde el texto guardado era el principio literal del impreso. En 72 anotaciones observation pasa a traer el texto completo (de ~2.266 a ~5.990 caracteres de media) y observationDerived pasa a null. En una de ellas (id 10416963), las dos versiones del hecho dejan de coincidir y versionsDiffer pasa a true. Las citas de norma de esas anotaciones solo se amplían.

Qué hacer: nada obligatorio. Si guardaste el observation de esas anotaciones, reléelo: puede ser más largo.

2026-09-25 · [BEH] act publica el código de INAPI del encabezado de subsección del Estado Diario

Hasta ahora act solo traía el acto de los encabezados A1, A3, A4, A5 y D5A. Ahora trae también el acto impreso como encabezado de subsección: bajo M11 «Resoluciones Varias», «Fondo-Res. Favorable Escrito» es el acto 664B. 84.888 anotaciones pasan de act: null a un código; en total, 198.080 tienen act. Un mismo encabezado puede ser actos distintos según la sección (614 en C8, 969 en C3, 966 en C2). Todos son códigos de INAPI, sin códigos propios. actName/actLabel siguen al código y son null en códigos que INAPI nunca nombró. Por esto entran en renewals[] del informe 29 anotaciones 664C. Cambia en colección, anotación suelta, búsqueda transversal, boletín del día, expediente e informe.

Qué hacer: si tratabas act como «solo familia A», revisa el código, no la sección: ahora puede ser 664B, 428, 431… bajo M11, C8, M8.

2026-09-25 · [ADD] actStatus en la anotación: identified | unidentified | not_applicable

Un act: null podía significar «la sección ya es el acto» o «no sabemos qué acto es». actStatus lo distingue y viaja siempre (nunca omitido ni null) en toda anotación completa: colección, suelta, transversal, boletín del día, expediente e informe.

actStatus act significa
identified el código acto identificado
unidentified null la anotación nombra un acto que no se pudo identificar
not_applicable null la sección ya es el acto

No indica de dónde salió el código. Las variantes de duplicates[] y los eventos de oposición no lo llevan.

Qué hacer: si muestras act, usa actStatus para decidir qué mostrar cuando es null: «no aplica» o «acto sin identificar».

2026-09-25 · [DATA] Normas: 14 títulos oficiales, erratas de la 19.039 reapuntadas y anáfora corregida

Cambios en /legal-norms, /legal-norms/{id} ≡ list_legal_norms/get_legal_norm y el filtro citedNorm; la forma no cambia.

  • 14 normas reciben su título oficial de BCN en name (la Ley 19.039 y su Reglamento, 20.254, 19.799, 19.880, entre otras). La 19.039 pasa de «Ley de Propiedad Industrial» al título oficial.
  • Las 18 «leyes» que eran la 19.039 mal tecleada dejan de existir y su id responde 404 (p. ej. 90). Sus citas pasan a la 19.039 o se retiran por duplicadas.
  • «Del Reglamento de la citada ley» se resuelve ahora a la última ley nombrada: 239 citas pasan al reglamento de la 19.039.
  • Quedan 5 reglamentos sin citas y 4 citas mal atribuidas a un «reglamento 19.880».

Los catálogos pueden tardar hasta un día en reflejarlo por caché.

Qué hacer: vuelve a medir recuentos por norma y marcas que casan con citedNorm. No uses ids de norma guardados antes del 2026-09-25.

2026-09-25 · [BEH] 27 códigos de sección ganan nombre y etiqueta

27 códigos reciben su nombre literal de INAPI y etiqueta en es-CL, en y pt-BR. 27.170 anotaciones (sobre todo de 2012–2020) pasan de sectionName: null a traer nombre y etiqueta, y en /sections ≡ list_sections/get_section esos códigos ganan source.label y label. El catálogo queda en 673 códigos, 541 con nombre; sectionName: null sigue significando que INAPI nunca publicó el nombre. W177 conserva la grafía de INAPI tal cual (Notificaci¢n Ejecutoria Rechazada). A06A no cambia. Los catálogos pueden tardar hasta un día en reflejarlo por caché.

Qué hacer: nada. Donde mostrabas el código o «—», ahora verás el nombre.

2026-09-25 · [BEH] carriesParties y emittedBy medidos en el corpus — /sections ≡ list_sections/get_section

Los dos campos se rellenan con lo que el corpus sostiene, sin pisar valores existentes. emittedBy: 548 códigos pasan de [] a tener valor (544 con la ficha de expediente como emisora y 4 ["estado_diario"]: C9N, C12N, C14N, C16N); 99 siguen en []. carriesParties: C9N, C12N, C14N y C16N pasan a true, y D5A a false. null sigue significando «no lo sabemos», nunca «no trae personas»; los códigos que solo vienen de la ficha de expediente no reciben carriesParties. La forma no cambia.

Qué hacer: nada. emittedBy: [] sigue significando «no medido» para los 99 restantes.

2026-09-24 · [BEH] La ventana de oposición abierta excluye también las marcas registrada y concedida

Una marca registrada o concedida ya no admite oposición, aunque su 30.º día hábil tras la publicación siga por delante. Desde ahora, la pertenencia a la ventana exige además que su status (derivado) no sea registrada ni concedida. Afecta a oppositionWindow: "open" en POST /trademarks/search ≡ search_trademarks, a inOppositionWindow de get_clearance_report y de get_portfolio_report.

liveOnly no cambia (una marca registrada sigue viva), y el objeto oppositionWindow de la marca (deadline/businessDaysLeft/expired) tampoco: publica el plazo, no la pertenencia. Por eso !expired deja de equivaler a «en ventana»; la pertenencia la deciden oppositionWindow: "open" e inOppositionWindow.

Qué hacer: nada. Si mostrabas «en ventana» para una marca registrada, ya no ocurrirá.

2026-09-24 · [ADD] Escritos de oposición: GET /reports/opposition-brief ≡ get_opposition_brief y GET /reports/opposition-response-brief ≡ get_opposition_response_brief

Dos informes nuevos de una llamada que completan la familia /reports/*.

  • Presentar una oposición (applicationNumber = la marca objetivo, ownApplicationNumber opcional, limit 1–20): la ficha de la marca con milestones[], inOppositionWindow, similarity (sólo con marca propia: posición del objetivo entre las 100 más parecidas, o found: false; sin marca propia la clave se omite), los titulares con sus oposiciones presentadas y recibidas, citedNorms y coverageFrom = 2024-09-30. Marca propia inexistente ⇒ 404; igual al objetivo ⇒ 400; fuera de la cobertura de feriados ⇒ 422 out_of_coverage.
  • Responder a una oposición (applicationNumber = la marca atacada, limit): oppositionActs colapsados por hecho (hasta 50 + hasMore), opponents resueltos por su identificador de parte (nunca por el nombre) y unresolvedOpponentMentions (se cuentan, no se nombran).

Ninguno trae veredictos, fecha de cierre de oposición fuera de milestones ni estado de renovación. Permisos reports:read o el del escrito (reports:opposition-brief:read, reports:opposition-response-brief:read), denegados por defecto; una unidad de cuota por llamada.

Qué hacer: nada si no los usas. Para usarlos, pide al operador reports:read o el permiso del escrito.

2026-09-24 · [BEH] La ventana de oposición abierta deja de salir siempre vacía

oppositionWindow: "open" en POST /trademarks/search ≡ search_trademarks devolvía siempre una página vacía (estimatedTotal: 0), get_clearance_report marcaba siempre inOppositionWindow: false y get_portfolio_report traía siempre inOppositionWindow.trademarks: []: se exigía un estado publicada que INAPI nunca emite.

Ahora una marca está en ventana cuando tiene publishedOn, su 30.º día hábil tras la publicación es hoy o después (días de Chile, con el calendario de feriados) y su status no es terminal. Es la misma ventana y la misma aritmética que el objeto oppositionWindow de la marca, que también cuenta «hoy» en hora de Chile. Si el calendario no cubre los días necesarios, la respuesta es 422 out_of_coverage con details.coverage. Tras el cambio, 7.526 marcas están en ventana.

Qué hacer: nada en el código. Si tratabas «ventana vacía» como «nada que vigilar», esa respuesta era falsa hasta hoy.

2026-09-24 · [ADD] La cartera de una parte: GET /reports/portfolio ≡ get_portfolio_report

Informe de una llamada con la cartera de una parte. Entrada: partyId (obligatorio), relation (current por defecto, former, all) y horizonDays (1–366, defecto 90). Se construye por el identificador de la parte, nunca por el nombre («ACME» no arrastra a «ACME CHILE»).

Trae party, trademarkCount, byStatus[] y byClass[], upcomingMilestones (hitos entre hoy y hoy + horizonDays, hasta 50 + hasMore), inOppositionWindow (pertenencia, sin fecha de cierre), oppositionsReceived, representatives y relations[], con dataAsOf/coverageThrough. No trae estado de renovación ni veredictos.

Permiso reports:read o reports:portfolio:read, denegados por defecto; una unidad de cuota por llamada. Parte inexistente ⇒ 404 not_found.

Qué hacer: nada si no lo usas. Para usarlo, pide al operador reports:read o reports:portfolio:read.

2026-09-24 · [BEH] liveOnly excluye los siete estados terminales (antes tres)

liveOnly=true excluía sólo denegada, vencida y anulada. Ahora excluye los siete estados que cierran el ciclo de vida: rechazada, denegada, desistida, abandonada, anulada, caducado, vencida. Una marca sin estado conocido se sigue conservando.

Cambia en todos los lugares que aceptan liveOnly: GET /trademarks, POST /trademarks/search ≡ search_trademarks (incluidas la similitud y la ventana de oposición), /insights/trademarks ≡ get_trademark_insights y la vigilancia: una lista con filters.liveOnly: true deja de producir aciertos sobre marcas en esos cuatro estados nuevos.

Qué hacer: nada si liveOnly significaba «vivas». Si necesitas las rechazadas, desistidas, abandonadas o caducadas, deja de enviar liveOnly o filtra por status.

2026-09-24 · [BEH] Similitud y ventana de oposición: un taxId inválido o un rango de fechas invertido son 400

Con similarTo/similarToTrademark u oppositionWindow: "open", un taxId sin forma de RUT o un rango con From > To (filedFrom/filedTo, expiresFrom/expiresTo, registeredFrom/registeredTo, publishedFrom/publishedTo) respondían 200 con una lista vacía. Ahora responden 400 con el mismo código que la colección, invalid_rut o invalid_range, en REST y en MCP.

Qué hacer: si enviabas esos valores, ahora recibirás el error en vez de un vacío engañoso.

2026-09-24 · [ADD] Informes de una llamada: GET /reports/daily-bulletin ≡ get_daily_bulletin y GET /reports/clearance ≡ get_clearance_report

Nace la familia /reports/*, con permisos propios denegados por defecto: reports:read concede todos y reports:<informe>:read uno. Una clave con scopes vacío no los recibe (403 forbidden). Una unidad de cuota por llamada.

  • get_daily_bulletin (date obligatoria, section, limit ≤ 100, cursor): lo que publicó el Estado Diario ese día, fila a fila con partes, total exacto, meta.bulletins y meta.sections (índice del día entero en tres idiomas). Un día sin boletín es 422 out_of_coverage con coverage: {from, through}, nunca una lista vacía.
  • get_clearance_report (text ≤ 200, niceClass 1 a 10 clases): señales, nunca un veredicto. similar[] por canal (phonetic, fuzzy, semantic) con inOppositionWindow, dominantHolders[] y citedNorms[]. No existe ningún campo registrable/available/risk/infringes.

Qué hacer: nada si no los usas. Para usarlos, pide al operador reports:read o el permiso del informe.

2026-09-24 · [ADD] milestones[] en la marca y los filtros milestoneFrom/milestoneTo/milestoneKind

Cada marca publica sus hitos con fecha en milestones[], siempre presente ([] si no hay ninguno): en GET /trademarks/{n} ≡ get_trademark y en cada marca de GET /trademarks, POST /trademarks/search ≡ search_trademarks y GET /parties/{id}/trademarks ≡ list_party_trademarks. Un hito es source ({kind, date, basis, field}) o derived (con anchor, rule y legalBasis obligatorios). Por ahora sólo sale expiry, tomado de expiresOn.

Filtros nuevos milestoneFrom/milestoneTo (YYYY-MM-DD, inclusivos) y milestoneKind en la colección, la búsqueda, el lote, la similitud, la ventana de oposición y /insights. milestoneFrom > milestoneTo ⇒ 400 invalid_range; milestoneKind sin rango o con un tipo no publicado ⇒ 400 validation_error. La instantánea de vigilancia y el webhook no cambian.

Qué hacer: nada si no los usas (campo y parámetros nuevos).

2026-09-24 · [BEH] oppositionWindow con varios applicationNumber es 400

Con oppositionWindow, applicationNumber es una sola marca de cartera contra la que se ordena la ventana, no un lote. Antes, con varios números se usaba el primero y el resto se ignoraba en silencio; ahora la petición responde 400 validation_error, en REST y en MCP.

Qué hacer: envía un único applicationNumber junto a oppositionWindow.

2026-09-24 · [ADD] Las relaciones de una parte: GET /parties/{id}/relations ≡ list_party_relations

Ruta y herramienta nuevas, con el sobre común de colección (sin total) y permiso brands:read. Entrada: type (lista; por defecto los siete), relation (current, former, all), limit ≤ 100 y cursor. Parte inexistente ⇒ 404.

Siete tipos de arista, construidos por identificador de parte: co_holder, represents/represented_by, assigned_to/assigned_from (transferencias A07T, desde 2011-08-01) y opposed/opposed_by (desde 2024-09-30). Cada arista trae label, party, trademarkCount, firstOn/lastOn, hasta 5 números en evidence, evidenceTruncated y coverageFrom. Los oponentes que no se pueden identificar no generan arista: se cuentan en meta.unresolvedOpponentMentions. No hay aristas de «mismo grupo» ni por parecido de nombre: son señales, no veredictos.

Qué hacer: nada si no la usas.

2026-09-24 · [BEH] /parties ≡ list_parties: meta.coverageThrough llega con valor y hasMore es correcto con limit=100

En GET /parties ≡ list_parties:

  • meta.coverageThrough llega con su fecha (antes siempre null).
  • Con limit=100 y más de 100 partes, la respuesta decía hasMore: false y next: null; ahora dice hasMore: true y entrega el cursor.
  • sort=name responde lo mismo, pero mucho más rápido con cualquier filtro.

Qué hacer: nada. Si tratabas meta.coverageThrough de /parties como siempre null, ahora recibirás una fecha. Para recorrer el padrón completo, usa sort=name.

2026-09-24 · [ADD] /insights: groupBy=expiresMonth (con meta.undatedCount) y groupBy=transferYear

Dos valores nuevos de groupBy en GET /insights/trademarks, POST /insights/trademarks/search y get_trademark_insights, con la misma forma { key, label, count }.

  • expiresMonth: marcas por mes de vencimiento; key = primer día del mes (2027-03-01), label en tres idiomas. Las marcas sin fecha de vencimiento no caen en ningún mes y se declaran en meta.undatedCount (presente sólo con este groupBy, también cuando vale 0): Σ count + undatedCount = marcas filtradas.
  • transferYear: por año del acto, las marcas con una transferencia (A07T) que retiró a un titular. Una marca cuenta en cada año en que tuvo una. Cobertura desde 2011-08-01.

Qué hacer: nada si no los usas. Un switch exhaustivo sobre groupBy o sobre las claves de meta recibe valores nuevos.

2026-09-24 · [BEH] /insights?groupBy=niceClass: el rótulo de clase llega en los tres idiomas

En GET /insights/trademarks, POST /insights/trademarks/search y get_trademark_insights, el label de cada clase pasa de {"es-CL":"Clase 35","en":null,"pt-BR":null} a {"es-CL":"Clase 35","en":"Class 35","pt-BR":"Classe 35"}. Es el número rotulado, no el enunciado de la clase (que vive en /nice-classes). Misma forma; un null pasa a cadena.

Qué hacer: nada.

2026-09-24 · [BREAK] MCP: se retiran las herramientas gemelas list_trademarks y search_trademark_insights

Sólo cambia el MCP; REST no cambia. El servidor pasa de 33 a 31 herramientas. Las dos retiradas eran copias exactas de otra herramienta (mismo esquema de entrada y misma respuesta):

retirada se usa ahora
list_trademarks search_trademarks (lote de applicationNumber incluido, con meta.notFound)
search_trademark_insights get_trademark_insights

Llamar a un nombre retirado devuelve herramienta desconocida. Las rutas REST GET /trademarks y POST /insights/trademarks/search siguen. El guion availability_check usa ahora search_trademarks. El manifiesto MCP publicado anuncia los guiones que el servidor sirve de verdad (availability_check, case_history, weekly_watch) y sus cuatro recursos.

Qué hacer: en MCP, cambia list_trademarks por search_trademarks y search_trademark_insights por get_trademark_insights, con los mismos argumentos. En REST, nada.

2026-09-24 · [BEH] La fecha de contrato sube a 2026-09-24

La versión que declaran el OpenAPI (info.version), el servidor MCP (serverInfo.version) y el manifiesto pasa de 2026-09-23 a 2026-09-24, la fecha de vigencia de los cambios de este día. Misma forma, otro valor.

Qué hacer: nada, salvo que compares la versión con un valor fijo.

2026-09-24 · [BEH] La similitud y la ventana de oposición aplican los filtros que antes ignoraban; sort y combinaciones no soportadas son 400

Con similarTo/similarToTrademark en POST /trademarks/search ≡ search_trademarks, los filtros holder, representative, taxId (con relation), las cuatro parejas de fechas, registrationNumber y liveOnly ahora se aplican; antes se aceptaban e ignoraban. niceClass con varias clases devuelve la unión (antes, una lista vacía). oppositionWindow: "open" aplica los mismos filtros y acepta varias clases.

Ahora son 400 validation_error: sort distinto de relevance con similitud u oposición; denomination y facets con similitud u oposición; allClasses con similarTo o oppositionWindow. La vigilancia no cambia.

Qué hacer: revisa si enviabas esos filtros (ahora filtran de verdad) o esas combinaciones (ahora son error).

2026-09-24 · [BEH] GET /trademarks publica un total exacto cuando es posible; si no, omite la clave (antes null)

Las colecciones de marcas enviaban "total": null cuando el total no era exacto. Ahora, como el resto de colecciones:

  • Sin filtros, total es el número exacto de marcas del corpus, mientras siga siendo exacto; si no, se omite.
  • Con filtros y hasta 10.000 resultados, se publica la cuenta exacta.
  • Con más de 10.000, con q, con similitud o con ventana de oposición, la clave se omite.

meta.estimatedTotal no cambia. El lote por applicationNumber ya publicaba su total exacto. REST ≡ MCP.

Qué hacer: trata total como opcional; no esperes null.

2026-09-24 · [DATA] /nice-classes pasa a los encabezamientos de la OMPI 13-2026: title.en y title.pt-BR dejan de ser null

GET /nice-classes, list_nice_classes y el recurso iris://catalogs/nice-classes sirven los encabezamientos de la Clasificación de Niza, edición 13-2026 (la que Chile aplica desde el 2026-01-01). La forma no cambia; cambian los valores de title:

  • title.es-CL: traducción oficial de la OMPI (antes, la del clasificador de INAPI, de ediciones anteriores). Cambian las clases 1, 10, 35, 36, 40, 42 y 45.
  • title.en: texto auténtico de la OMPI (antes null).
  • title.pt-BR: traducción propia de Tarno, no oficial (antes null).

Qué hacer: nada en el código. Si guardabas el title.es-CL anterior, verás textos distintos en esas siete clases. Si muestras pt-BR a un abogado, indica que es una traducción.

2026-09-23 · [BREAK] Sobre único en las colecciones de marcas, parámetros desconocidos → 400, dedupe por defecto y filtro goodsAndServices

Cambio que cierra el corte del contrato, en REST y MCP a la vez:

  • GET /trademarks, POST /trademarks/search, el lote y GET /parties/{id}/trademarks responden el sobre común { results, limit, next, hasMore, meta }, y dejan de enviar ETag e Iris-Data-As-Of (la frescura va en meta.dataAsOf/meta.coverageThrough).
  • Facetas, matchedFields[].field, highlight.field y kindSource usan nombres en inglés.
  • Todo parámetro de consulta, clave de cuerpo o argumento MCP no declarado es 400 validation_error (code: "unrecognized_keys").
  • GET /trademarks/{n} colapsa por evento por defecto (dedupe=true); GET /trademarks/{n}/annotations acepta dedupe.
  • El lote aplica los demás filtros; meta.notFound lista sólo lo que no existe.
  • /insights rellena meta.dataAsOf y meta.coverageThrough.
  • Los catálogos envían Cache-Control de catálogo sólo en respuestas 2xx.
  • Filtro nuevo goodsAndServices (texto de productos y servicios, 2–200 caracteres).
  • sort=status ordena por el status publicado.

El mapa completo antes→después está en la guía de migración.

Qué hacer: aplica la guía de migración: lee las colecciones de marcas desde results/meta y elimina los parámetros no declarados.

2026-09-23 · [DATA] Fusión de partes duplicadas: 20.731 grupos

El 2026-09-09 se fusionaron partes duplicadas del corpus: 20.731 grupos, con 25.152 registros de parte absorbidos por la parte que se conserva. El registro anterior sólo recogía una pasada previa de 179 grupos.

Qué hacer: si guardaste identificadores de parte o cifras de partes obtenidas antes del 2026-09-09, vuelve a consultarlas.

2026-09-23 · [BEH] GET /trademarks y POST /trademarks/search rechazan citedNorm/article/letter en vez de ignorarlos

GET /trademarks?citedNorm=19039 (o search_trademarks con ese argumento) devolvía un 200 con la primera página sin filtrar. Ahora responde 400 validation_error nombrando el campo, en REST y MCP: citedNorm, article y letter filtran anotaciones por la norma que citan, no marcas.

Qué hacer: para filtrar por norma citada, usa POST /annotations/search ≡ search_annotations.

2026-09-23 · [BREAK] status lleva el estado derivado; el literal de INAPI viaja en statusInapi; se retira derivedStatus

INAPI escribe el número de registro y publica la concesión antes de actualizar su estado. Ahora status publica el estado derivado: una marca que INAPI aún llama en_tramite (u otro estado en trámite) pasa a registrada si tiene número o fecha de registro, y a concedida si tiene una anotación de concesión o una clase concedida. En otro caso, es el literal de INAPI.

  • statusInapi: el literal de INAPI sólo cuando difiere; null si coincide. Siempre presente.
  • statusStale: en todas las vistas de marca; true si INAPI aún no lo actualiza.
  • derivedStatus: retirado.
  • El filtro status, groupBy=status y la faceta status operan sobre el derivado.

Aplica a todas las vistas de marca en REST y MCP. Las instantáneas de vigilancia anteriores conservan su status con statusInapi y statusStale en null. Afecta a unas 660 marcas (0,08 %).

Qué hacer: lee el estado de status (no derivedStatus), usa statusStale y statusInapi para indicar que INAPI no lo ha actualizado, y revisa conteos fijos por estado. Detalle en la guía de migración.

2026-09-23 · [BEH] /insights aplica el filtro completo de marcas o responde 400

GET /insights/trademarks, POST /insights/trademarks/search y get_trademark_insights aceptaban el filtro completo de marcas, pero sólo aplicaban nueve campos y, en niceClass/status/signType, sólo el primer valor: las cifras filtradas publicadas hasta hoy eran incorrectas.

Ahora se aplican q (coincidencia léxica exacta, sin tope), liveOnly, relation, registrationNumber, applicationNumber (lote, máximo 100), los rangos de fechas y todos los valores de niceClass, status y signType. Responden 400 validation_error: similarTo, similarToTrademark, allClasses, oppositionWindow, citedNorm, article, letter, facets y minScore.

Qué hacer: vuelve a pedir toda cifra de insights obtenida con filtros.

2026-09-23 · [BEH] POST /annotations/search deja de agotar el tiempo, versionsOfFact cuenta el hecho entero y se aplican cuatro filtros

En POST /annotations/search ≡ search_annotations:

  1. La búsqueda sin filtros (o con citedNorm) ya no responde 504. Los cursores emitidos antes siguen valiendo.
  2. versionsOfFact cuenta todas las versiones del hecho, no sólo las que pasan el filtro.
  3. dateFrom/dateTo (YYYY-MM-DD, inclusivos), niceClass (1–45) y dedupe se aplican; antes se descartaban sin error.

dedupe vale true por defecto: cada hecho sale una vez, con sus otras versiones en duplicates[]. Las páginas cambian de longitud.

Qué hacer: si necesitas cada versión como fila propia, envía dedupe: false. Los filtros de fecha o clase que ya enviabas empiezan a filtrar.

2026-09-23 · [BREAK] Las siete etiquetas que quedaban en español pasan al inglés

Sólo renombre, en REST y MCP: mismos datos y tipos. eventoId → eventId (anotaciones); categoria/categoriaEtiqueta → category/categoryLabel y ambito/ambitoEtiqueta → scope/scopeLabel (GET /trademarks/{n} ≡ get_trademark); titular → holders en cada marca de las colecciones y en el snapshot de los aciertos de vigilancia; observacion → observation en la parte embebida; filters.clase → filters.niceClass en las listas de vigilancia. El kind de la parte embebida pasa a natural/legal/unknown, como en /parties.

Los valores en español no cambian. La parte embebida empieza a incluir observation, que antes no llegaba. Las listas de vigilancia existentes no hay que recrearlas.

Qué hacer: renombra estas claves al leer y escribe filters.niceClass en las listas de vigilancia (filters.clase ya es un error). Mapa completo en la guía de migración.

2026-09-23 · [BREAK] /holidays y /system/coverage filtran por from/to; los nombres en castellano son 400

GET /holidays ≡ list_holidays y GET /system/coverage ≡ get_system_coverage sólo entendían desde/hasta (y anio/tipo) e ignoraban from/to, devolviendo todo el calendario o toda la cobertura.

antes:  ?desde=…&hasta=…&anio=…&tipo=…   meta.coverage { desde, hasta }
ahora:  ?from=…&to=…&year=…&type=…       meta.coverage { from, to }

Los nombres viejos y cualquier otro parámetro desconocido responden 400 validation_error; el detail indica el nombre nuevo (p. ej. `desde` was renamed: use `from`).

Qué hacer: renombra los cuatro parámetros y lee meta.coverage.to en vez de meta.coverage.hasta.

2026-09-23 · [BEH] GET /parties/{id}/trademarks deja de responder siempre 400

La ruta respondía siempre 400 validation_error (id: expected string) salvo que se repitiera el identificador como ?id=. Ahora el id viaja sólo en la ruta y el querystring acepta role, relation, limit y cursor. La herramienta list_party_trademarks ya funcionaba y no cambia.

Qué hacer: nada; si añadías ?id=, quítalo.

2026-09-23 · [BEH] Las anotaciones con partes dejan de responder 500

Toda respuesta que incluía una anotación con partes fallaba con 500: GET /annotations/{id}, GET /trademarks/{n}/annotations, GET /trademarks/{n}?expand=annotations y sus gemelas get_annotation y list_trademark_annotations. Afectaba a 462.439 anotaciones de 187.886 marcas. Ahora se entregan con la forma publicada en el contrato: parties[] con role, name, method, candidates y partyId.

Qué hacer: nada si ya leías esos campos como dice el contrato.

2026-09-23 · [BREAK] El OpenAPI publicado deja de declarar /watchlists/ con barra final

El documento OpenAPI generado declaraba la colección de vigilancia como /watchlists/; ahora dice /watchlists, como el resto de rutas. El servidor siempre respondió en /watchlists, así que ninguna petición cambia; sólo cambia el camino que lee un generador de clientes.

Qué hacer: si generaste un cliente a partir del OpenAPI, regenéralo.

2026-09-23 · [BREAK] El corte: /v1 deja de responder

El prefijo /v1 deja de responder: sin redirección, sin periodo de gracia y sin cabecera de versión. Una URL vieja devuelve 404. Rutas, nombres de campo, sobre de colección, paginación, errores y herramientas MCP cambian a la vez; no hay un periodo en que convivan las dos formas.

Atención a RateLimit-Reset, que sustituye a X-Quota-Reset: es un número de segundos que faltan, no un instante absoluto. Renombrar la cabecera sin cambiar el cálculo produce esperas absurdamente largas.

No cambian los valores de código (siguen en español: status: "en_tramite"), los identificadores naturales ni los datos del corpus.

Qué hacer: migra de una sola vez siguiendo la guía de migración, que tiene el mapa completo de rutas, campos y herramientas antes→después.

2026-09-23 · [BREAK] La fecha de contrato pasa a ser la de vigencia: 2026-09-23

La versión que declaran el OpenAPI, el servidor MCP y el manifiesto pasa de 2026-09-20 a 2026-09-23. Desde ahora la fecha de contrato es la de vigencia: identifica el contrato que se está sirviendo, no el día en que se diseñó, y sube cuando cambia la superficie.

Qué hacer: si comparas la versión con un valor fijo, actualízalo a 2026-09-23.

2026-09-22 · [BEH] liveOnly=true vuelve a excluir las marcas vencida

El renombre de campos al inglés cambió por error un valor de código: el filtro liveOnly=true excluía un estado expired que no existe, y por eso devolvía como «vivas» las marcas en estado terminal vencida. Se restaura vencida. Los valores de código siguen en castellano; sólo cambian los nombres de campo.

La forma de la respuesta no cambia: con liveOnly=true el conjunto vuelve a excluir de verdad las marcas vencidas.

Qué hacer: nada. Si filtraste a mano las vencidas como solución temporal, ya puedes quitar ese filtro.

2026-09-22 · [BREAK] Los tokens de sort se publican sólo en inglés

Los tokens de ordenación seguían aceptando alias en español junto a los ingleses. Ahora el contrato usa un solo idioma. Se retiran relevancia (→ relevance), recientes (→ filedOn:desc) y antiguas (→ filedOn:asc), y estado, estado:asc y estado:desc pasan a status, status:asc y status:desc. El documento OpenAPI publicado refleja la lista nueva.

Qué hacer: reemplaza los tokens en español por sus equivalentes en inglés. La tabla completa está en la guía de migración.

2026-09-22 · [BEH] Los gravámenes vuelven a devolver datos y territory.regionCode deja de venir vacío

Por un defecto del renombre de campos, encumbrances[] salía siempre como [] aunque la marca tuviera gravámenes inscritos. Ahora devuelve los gravámenes reales. El mismo defecto dejaba sin valor territory.regionCode en el recurso de partes, y también quedó corregido.

Qué hacer: nada. Si guardaste en caché respuestas con encumbrances: [] o regionCode vacío, vuelve a pedirlas.

2026-09-22 · [BREAK] Se retira la ordenación por fechaActualizacion

fechaActualizacion:desc y fechaActualizacion:asc desaparecen. Ordenaban por la fecha en que nuestra ingesta tocó el registro, no por un hecho de INAPI, y el contrato no publica ese campo. Se mantienen las otras diez ordenaciones (filedOn, denomination, status, expiresOn, registeredOn y publishedOn, cada una con asc|desc), y todas tienen un rendimiento garantizado.

Qué hacer: si usabas fechaActualizacion, cámbiala por otra ordenación publicada. Para seguir cambios recientes, usa la vigilancia. Detalles en la guía de migración.

2026-09-22 · [BREAK] El documento OpenAPI se genera de los esquemas, se versiona por fecha y declara el dominio

El documento OpenAPI publicado ya no se escribe a mano: se genera de los mismos esquemas que usa el servidor. Esto trae tres cambios visibles:

  • info.version deja 1.0.0 y pasa a ser la fecha del contrato (2026-09-20), la misma que declara el servidor MCP. El contrato se versiona por fecha y su historial está en este registro de cambios.
  • servers[0].url es https://api.tarno.cl.
  • No se publica ningún SDK: el documento es el contrato, y puedes generar tu propio cliente a partir de él.

El documento ya no lista GET /trademarks/{applicationNumber}/encumbrances (los gravámenes se piden con expand=encumbrances) y agrega GET /system/vigilance-horizon.

Qué hacer: si comparabas info.version con un número semántico, compara la fecha. Apunta tus clientes a api.tarno.cl.

2026-09-22 · [ADD] GET /system/me, caché con ETag y la clave de prueba pública

Cambios aditivos:

  • GET /system/me ≡ get_system_me: devuelve tu identidad (organización), tus alcances, la cuota consumida, el límite y cuándo se reinicia la ventana. Sólo muestra datos tuyos y la respuesta va con no-store.
  • Los objetos individuales llevan ETag. Si repites la lectura con If-None-Match, recibes 304 sin cuerpo cuando nada cambió. Los catálogos se sirven con caché larga.
  • Clave de prueba pública: 1.000 peticiones al mes, sin alcances de vigilancia (ni watch:read ni watch:write). El paso a una clave de pago se gestiona a mano con Tarno.

Qué hacer: nada. Opcional: usa If-None-Match para no descargar lo que no cambió.

2026-09-22 · [BREAK] Las herramientas MCP se renombran como sus rutas y se agregan recursos, guiones y versión

Los nombres de las herramientas MCP pasan a coincidir con el contrato nuevo, sin alias ni periodo de transición. Algunos ejemplos: search_brands → list_trademarks, find_similar_brands → search_trademarks con similarTo, get_brand_detail/get_brand_report → get_trademark (con expand=), get_brand_opposition → list_trademark_annotations con family=opposition, watch_* → create_watchlist, list_watchlists, get_watchlist, update_watchlist, delete_watchlist… y list_system_coverage → get_system_coverage.

Novedades: los catálogos como recursos (iris://catalogs/states, iris://catalogs/sections, iris://catalogs/nice-classes, iris://catalogs/holidays/{year}), tres guiones (availability_check, case_history, weekly_watch), la herramienta explain_section_code (si un código no tiene leyenda, responde que no se sabe) y la versión del servidor igual a la fecha del contrato (2026-09-20), con las cuatro reglas de uso en sus instrucciones.

Qué hacer: actualiza los nombres de herramienta según el mapa MCP de la guía de migración.

2026-09-22 · [BREAK] La vigilancia pasa a /watchlists, con el sobre común y un cuerpo de webhook fijo

  • Las rutas /v1/watch/* se reemplazan por /watchlists, /watchlists/{id}, /watchlists/{id}/items, /watchlists/{id}/hits y /watchlists/{id}/deliveries.
  • Las colecciones de vigilancia dejan los arreglos sueltos y {items,nextCursor}, y usan el sobre común (results[], limit, next, hasMore, total, meta).
  • El parámetro since se reemplaza por el cursor común.
  • El cuerpo del webhook queda fijo: { watchlistId, sweepAt, newHits, fetchUrl }, firmado con X-Tarno-Signature (HMAC-SHA256). Cualquier cambio futuro en él se anunciará como [BREAK].
  • Un identificador de otro inquilino sigue respondiendo igual que uno inexistente: 404.

Qué hacer: migra rutas, lectura del sobre y paginación según la guía de migración, y valida la firma del webhook.

2026-09-22 · [ADD] Cobertura día a día, horizonte de vigilancia e identificador de cada gravamen

  • GET /system/coverage ≡ get_system_coverage muestra, día por día, qué boletines se procesaron y cuántos actos trajo cada uno, y marca los feriados. Así puedes distinguir un día sin boletín por feriado de un hueco real, y un año no declarado de uno sin problemas.
  • GET /system/vigilance-horizon ≡ get_vigilance_horizon indica hasta cuánto tiempo atrás puedes preguntar por cambios (hoy, 2 meses).
  • Cada gravamen tiene un identificador estable, derivado de la anotación que lo inscribe. Así se pueden distinguir dos gravámenes del mismo tipo sobre una misma marca.

Qué hacer: nada. Son funciones nuevas.

2026-09-22 · [ADD] Se publican las citas de norma y el catálogo de secciones

  • Cada anotación trae las normas que cita, con artículo, letra e inciso. El catálogo GET /legal-norms y GET /legal-norms/{id} (≡ list_legal_norms / get_legal_norm) entrega cada norma con sus artículos dentro del objeto. Las anotaciones y la búsqueda de marcas aceptan los filtros citedNorm, article y letter.
  • GET /sections y GET /sections/{code} (≡ list_sections / get_section) enumeran los códigos de sección con su familia, sus fuentes, si llevan partes y sus equivalencias confirmadas. Un código sin leyenda publica la etiqueta como null, nunca un nombre inventado.

Qué hacer: nada. Son funciones nuevas.

2026-09-22 · [BEH] Las anotaciones se agrupan por hecho de forma predeterminada, y se avisa cuando las versiones difieren

Antes, un mismo hecho publicado en dos fuentes se devolvía una vez por cada copia, salvo que pidieras dedupe=true. Ahora cada hecho se devuelve una sola vez de forma predeterminada. Las copias se pueden ver con dedupe=false y siguen en duplicates[]: la agrupación no borra nada.

Cada anotación trae siempre dos campos nuevos: versionsOfFact (cuántas filas describen ese hecho) y versionsDiffer (true si hay otra versión que no es idéntica ni está contenida en esta). Hay 593 pares que dicen cosas distintas, sobre 580.218 hechos. El aviso no dice qué fuente publicó cada versión. retiredBy, en las partes históricas, pasa a un código neutral (authority_withdrew) y conserva los códigos de sección de INAPI. renewals y lastRenewalOn dan el mismo resultado con cualquier valor de dedupe.

Qué hacer: si necesitas todas las copias, envía dedupe=false. Revisa versionsDiffer.

2026-09-22 · [BREAK] Los nombres de campo pasan al inglés y las etiquetas vienen en tres idiomas

Las etiquetas (seccionEtiqueta, seccionActoEtiqueta, categoriaEtiqueta, ambitoEtiqueta, la de renovación) ya no se eligen con Accept-Language. Cada una es un objeto con los tres idiomas a la vez (es-CL, en, pt-BR), con null donde falta la traducción. La respuesta es la misma con cualquier Accept-Language.

Unos 180 nombres de campo pasan al inglés. Por ejemplo:

nroSolicitud → applicationNumber   denominacion → denomination
estado → status   fechaPresentacion → filedOn   personas → parties
anotaciones → annotations   variantes → duplicates   soloVigentes → liveOnly

No cambian los valores de código (status sigue siendo "en_tramite"), los literales de INAPI (códigos de sección, texto de la anotación, RUT) ni categoria/ambito.

Qué hacer: renombra los campos con el mapa completo de la guía de migración y lee las etiquetas como objeto de tres idiomas.

2026-09-21 · [BREAK] Las personas pasan a ser parties, una entidad con un rol

GET /v1/personas y search_personas se reemplazan por GET /parties, GET /parties/{id} y GET /parties/{id}/trademarks (≡ list_parties, get_party, list_party_trademarks). Titular, solicitante, representante y oponente son una misma entidad con un role, y la misma parte ya no aparece repetida.

Cambios de forma: tipo/tipoOrigen → kind/kindSource (este último ahora acepta null), revision → review con su motivo como código, region/comuna → territory (regionCode, regionName, communeCode, communeName, unknownCommune; null para partes extranjeras) y marcasTotal → trademarkCount. Las 25.645 partes sin marcas siguen apareciendo, con cero.

Qué hacer: migra a /parties con el mapa de la guía de migración.

2026-09-21 · [ADD] GET /nice-classes: el catálogo de clases de Niza

Nuevo catálogo con las 45 clases de Niza y sus enunciados, según el clasificador de INAPI. GET /nice-classes ≡ list_nice_classes. Se puede guardar en caché por un año.

Qué hacer: nada. Es una función nueva.

2026-09-21 · [BREAK] El calendario de feriados pasa a una sola ruta, /holidays

/v1/feriados y /v1/feriados/cobertura se unen en GET /holidays, y get_feriados + get_feriados_cobertura se unen en list_holidays. La cobertura declarada viene siempre en meta.coverage. Pedir una fecha fuera de la cobertura sigue respondiendo 422 out_of_coverage.

Qué hacer: usa /holidays y lee la cobertura en meta.coverage. Detalles en la guía de migración.

2026-09-21 · [BREAK] La frescura y las corridas de sincronización pasan a /system

/v1/freshness y /v1/sync-runs pasan a GET /system/freshness y GET /system/sync-runs. Las herramientas get_freshness y get_sync_runs pasan a llamarse get_system_freshness y list_sync_runs. Así lo operativo queda separado del catálogo de negocio.

Qué hacer: actualiza las rutas y los nombres de herramienta según la guía de migración.

2026-09-21 · [BREAK] Las estadísticas pasan de cinco rutas a una con groupBy

Las cinco rutas /v1/insights/* y sus cinco herramientas se reemplazan por GET /insights/trademarks?groupBy=… y POST /insights/trademarks/search (≡ get_trademark_insights / search_trademark_insights). Equivalencias de groupBy: filings-over-time → filedMonth, by-estado → status, by-class → niceClass, by-holder → holder, by-representante → representative.

Todas devuelven elementos { key, label, count } dentro de results[]. label trae los tres idiomas (es-CL, en, pt-BR).

Qué hacer: reemplaza cada ruta por su groupBy según la guía de migración.

2026-09-21 · [BREAK] Las anotaciones llegan al MCP y se retira get_brand_opposition

El MCP gana las mismas tres formas de pedir anotaciones que REST: get_annotation (≡ GET /annotations/{id}), search_annotations (≡ POST /annotations/search) y list_trademark_annotations (≡ GET /trademarks/{n}/annotations). get_brand_opposition se retira: su reemplazo es list_trademark_annotations con family: "opposition". Los filtros son los mismos en ambos transportes.

Corrección: las tres formas ignoraban offset y devolvían la primera página con 200. Ahora un offset responde 400 validation_error en REST y en MCP.

Qué hacer: reemplaza get_brand_opposition y pagina con el cursor. Consulta la guía de migración.

2026-09-21 · [BREAK] Las seis herramientas MCP de marca se reducen a tres

search_brands y get_brands_batch pasan a list_trademarks (el lote se pide con applicationNumber: [a, b, c], máximo 100, y devuelve { items, notFound }; un lote vacío devuelve un lote vacío). find_similar_brands y get_open_oppositions pasan a search_trademarks con similarTo / similarToTrademark u oppositionWindow: "open", que no se pueden combinar (400 validation_error). get_brand_detail y get_brand_report pasan a get_trademark con expand (classes, parties, annotations, encumbrances, norms): null significa «no se pidió» y [] significa «no hay».

Qué hacer: actualiza las llamadas según el mapa MCP de la guía de migración.

2026-09-21 · [BREAK] La ventana de oposición y la nota de frescura cambian de lugar

Lo que traía la línea de tiempo de oposición se reparte así: ventanaOposicion pasa al objeto marca (GET /trademarks/{applicationNumber}), siempre presente. Vale null cuando la marca no tiene fecha de publicación, lo que no significa «sin oposición». freshnessNote pasa a meta.freshnessNote, sólo cuando se piden anotaciones de la familia opposition, y advierte que una oposición reciente puede no aparecer todavía.

Además, meta.coverageThrough de la colección de anotaciones, que siempre venía null, ahora trae la fecha real.

Qué hacer: lee la ventana en el objeto marca y la nota en meta. Consulta la guía de migración.

2026-09-21 · [BREAK] /v1/brands y /v1/oppositions dejan de existir

Se retiran todas sus rutas. Puntos a cuidar al migrar:

  • La similitud son dos filtros: similarTo (texto libre) y similarToTrademark (excluye a la marca de origen y se limita a sus clases; allClasses amplía la búsqueda).
  • relation (current/former/all, vínculo de la parte) no es lo mismo que liveOnly (excluye las marcas en estado terminal).
  • holder, representative y taxId aceptan varios valores, combinados con O.
  • Un lote vacío devuelve un lote vacío. Si se supera el tope, la respuesta sigue siendo 422 batch_too_large.
  • El OpenAPI ahora documenta las respuestas de error de todas las rutas.

Qué hacer: migra con el mapa de rutas de la guía de migración.

2026-09-21 · [BREAK] Las anotaciones pasan a ser un recurso con identificador y sin fuente

Hay tres formas nuevas de pedir anotaciones: GET /annotations/{id}, GET /trademarks/{n}/annotations?family=opposition (reemplaza a GET /v1/brands/{n}/opposition) y POST /annotations/search. Se ordenan cronológicamente (fecha ascendente, sin fecha al final) y el cursor es compuesto.

Cada acto de oposición trae ahora su identificador, para pedirlo, citarlo o cruzarlo con sus citas de norma. El campo fuente sale del contrato: indicaba por qué vía lo ingerimos, no un hecho de INAPI.

Qué hacer: deja de leer fuente y usa las rutas nuevas según la guía de migración.

2026-09-21 · [BREAK] Las marcas pasan de seis rutas a cuatro formas

GET /v1/brands → GET /trademarks. El lote → GET /trademarks?applicationNumber=a,b,c (hasta 100). La similitud y las oposiciones abiertas → POST /trademarks/search con similarTo u oppositionWindow: "open". El detalle y el informe → GET /trademarks/{applicationNumber}?expand=parties,annotations,encumbrances,classes,norms. En expand, [] significa «no hay» y null significa «no se pidió».

Hay un solo juego de filtros en inglés para /trademarks, /trademarks/search e /insights. relation=current|former|all reemplaza a soloVigentes, y se conservan minScore, denomination, registrationNumber, expiresFrom/To, registeredFrom/To, publishedFrom/To y facets. oppositionWindow: "closed" y "any" responden 422 opposition_window_unsupported.

Qué hacer: migra con el mapa de rutas de la guía de migración.

2026-09-21 · [BREAK] La marca usa un solo criterio para «sin valor»: null

El detalle publicaba null para los campos sin valor, mientras que el informe los omitía. Ahora, en ambos casos, once campos siempre están presentes y valen null cuando no tienen valor: nroRegistro, estado, tipoSigno, fechaPresentacion, fechaVencimiento, fechaPublicacion, fechaRegistro, traduccion, descripcionEtiqueta, protectionDescription e imagenUrl. Excepción: categoria, ambito y sus etiquetas se siguen omitiendo cuando no se conocen. El valor '0' que INAPI usa para indicar «sin número» sigue sin publicarse: ahora sale como null.

Qué hacer: si comprobabas si la clave existía, comprueba si vale null. Detalles en la guía de migración.

2026-09-21 · [BREAK] Los errores pasan al formato RFC 9457 y cambian tres códigos

Todos los errores, en REST y MCP, usan application/problem+json con type, title, status, detail, code, requestId y errors[]. El formato anterior era { error: { code, message, requestId } }. Un 400 ahora indica en errors[] qué parámetro falló. Los estados quedan así: 400 = validación, 404 = no existe o no es tuyo, 422 = regla de negocio. Un 5xx no incluye detalles internos.

Códigos renombrados: fuera_de_cobertura → out_of_coverage, cobertura_no_declarada → coverage_not_declared, invalid_input → validation_error (MCP) e invalid_input → batch_too_large (tope del lote, 422 también en MCP).

Qué hacer: adapta el manejo de errores al cuerpo nuevo y a los códigos nuevos. Consulta la guía de migración.

2026-09-21 · [BREAK] Cabeceras: correlación, cuota con nombres estándar, ETag y version

X-Request-Id → X-Correlation-ID, que puedes enviar tú y que vuelve en todas las respuestas, también en MCP. X-Quota-Limit/-Remaining/-Reset → RateLimit-Limit/-Remaining/-Reset. Ojo: RateLimit-Reset pasa de un instante absoluto a los segundos que faltan. Desaparecen las cabeceras x-ratelimit-*, y Retry-After no cambia.

Los objetos individuales traen ETag (If-None-Match → 304) y también Iris-Data-As-Of e Iris-Coverage-Through. Los catálogos declaran Cache-Control. Las listas de vigilancia publican un version: si lo envías en la edición y no es el vigente, recibes 409 concurrent_modification con currentVersion. Si lo omites, la edición funciona como antes.

Qué hacer: renombra las cabeceras y recalcula la espera con RateLimit-Reset. Consulta la guía de migración.

2026-09-21 · [BREAK] Un mismo sobre para todas las colecciones y una sola forma de paginar

Todas las colecciones responden con la misma forma:

{ "results": [ … ], "limit": 20, "next": "…", "hasMore": true, "total": 14,
  "meta": { "dataAsOf": "…", "coverageThrough": "…" } }

Reemplaza a data, items, nextCursor y a los arreglos sueltos. total sólo viene cuando es exacto. La estimación de la búsqueda va en meta.estimatedTotal. Se retira ?envelope=: ningún parámetro cambia el tipo de una respuesta.

La paginación es limit + cursor. offset sale del contrato. El cursor es opaco: no lo construyas tú. En ordenaciones profundas tiene un tope. Un cursor de otra ordenación vuelve a la página uno.

Qué hacer: lee results[] y pagina con next. Consulta la guía de migración.

2026-09-18 · [BREAK] El informe deja de publicar la cadena de renovación (renovadaDe, renovadaPor)

renovadaDe y renovadaPor desaparecen del informe de registrabilidad (REST y MCP). Indicaban qué solicitud renovó a cuál, pero INAPI renueva sobre la misma solicitud, y ninguna fuente actual trae esa cadena: sólo existía en 606 marcas (0,07 %), heredadas de una carga histórica.

antes:    { "renovadaDe": "1700100", "renovadaPor": "1700200", "renovaciones": [ … ] }
después:  { "renovaciones": [ … ], "ultimaRenovacion": "2026-09-17" }

Qué hacer: usa renovaciones[] y ultimaRenovacion (hoy renewals[] y lastRenewalOn). Consulta la guía de migración.

2026-09-18 · [BREAK] El informe cambia texto libre por código y etiqueta, y publica los actos de renovación

En el informe de registrabilidad (REST y MCP) desaparecen tipoNombre y subtipoNombre, que mezclaban tres dimensiones. Entran categoria (7 códigos, como marca o frase_propaganda) y ambito (5 códigos, como productos_servicios), cada uno con su etiqueta (categoriaEtiqueta, ambitoEtiqueta). Si no se conocen, se omiten. Un valor inventado responde 400.

Además, renovaciones[] (siempre presente) y ultimaRenovacion: cada acto trae anotacionId, fecha, codigo, nombre y etiqueta. Hay 17 códigos, que suman 693.357 anotaciones de 211.921 marcas (25,1 % del corpus). Se excluyen los códigos que niegan una renovación.

Qué hacer: lee los códigos en lugar del texto libre y usa renovaciones[]. Los nombres actuales están en la guía de migración.

2026-09-17 · [BREAK] Se retira apellido de personas[] y de las estadísticas por titular y representante

El campo apellido desaparece de las partes en el detalle y el informe de marca, y de las filas de insights/by-holder e insights/by-representante, en REST y en MCP. Siempre valía null (0 valores en 397.878 personas): INAPI nunca publica el nombre separado en nombre y apellidos, y el nombre completo está en nombre.

antes:    { "id": "42", "nombre": "ESTUDIO CAREY LIMITADA", "apellido": null, "pais": "CL" }
después:  { "id": "42", "nombre": "ESTUDIO CAREY LIMITADA", "pais": "CL" }

Qué hacer: nada, salvo quitar apellido de tus tipos si lo declarabas obligatorio.