BSV FHIR: LimitationCode als stabile ClinicalUseDefinition-ID nutzen (Info BAG/EPL)

[zdavatz]

BAG/EPL (Franziska Sendfeld, EPL@bag.admin.ch) hat uns am 03.08.2026 auf unsere Rückfrage hin bestätigt, wie Limitationen im ch-epl FHIR-Export identifiziert werden:

1. Die ID der ClinicalUseDefinition (Ziel der Referenz limitationIndication) entspricht dem LimitationCode und wird im FHIR entsprechend exportiert.
   Zusätzlich wird der LimitationCode neu auch im Excel-Export des Datenstamms angezeigt. Dort kann er mehr als 64 Zeichen umfassen. LimitationCodes mit mehr als 64 Zeichen werden vor der Bereitstellung in FHIR auf 64 Zeichen gekürzt. BAG hat kontrolliert, dass es nach der Kürzung keine Kollisionen gibt (also keine LimitationCodes, die dann identisch wären).

2. Der LimitationCode ist limitationsspezifisch und stabil und ändert auch über die Publikationen hinweg nicht.

Warum das für uns relevant ist

src/plugin/bsv_fhir.rb verarbeitet Limitationstexte und deren FR/IT-Übersetzungen aktuell über einen SwissmedicNo8-basierten Index (merge_translation_limitations), weil eine iksnr über viele Bundles verteilt sein kann. Mit dem LimitationCode steht uns nun ein stabiler Identifikator auf Limitations-Ebene zur Verfügung.

Mögliche Folgearbeiten

• Prüfen, ob der LimitationCode als (zusätzlicher) Schlüssel für das Matching von Limitationen über Publikationen hinweg verwendet werden kann — stabiler als die heutige Zuordnung.
• Prüfen, ob wir den LimitationCode im Modell (limitation_text / sl_entry) speichern und ggf. in Exporten ausgeben wollen.
• Beim Abgleich mit dem Excel-Datenstamm beachten: dort kann der Code länger als 64 Zeichen sein, während die FHIR-ID auf 64 Zeichen gekürzt ist. Ein Vergleich muss also auf die ersten 64 Zeichen normalisieren.

Referenz: ch-epl IG, siehe auch Abschnitt "BSV FHIR Import" in CLAUDE.md.

[zdavatz]

Empirische Bestätigung am aktuellen Export (foph-sl-export-latest-de.ndjson, Stand 02.08.2026)

Die Angaben von Frau Sendfeld lassen sich im aktuellen NDJSON direkt nachvollziehen — die Daten sind bereits vorhanden, wir werten sie nur noch nicht aus:

Vorkommen	Anzahl
ClinicalUseDefinition	6277
limitationIndication	2461
indicationCode (was wir heute lesen)	684

ClinicalUseDefinition.id = LimitationCode, Beispiel:

{"resourceType":"ClinicalUseDefinition","id":"ABEVMY.07","type":"indication",
 "text":{"div":"... Glioblastom Nach Kostengutsprache durch den Krankenversicherer ..."}}

Statistik über die gesehenen ids:

verschiedene ids:          1665
maximale Länge:              64
ids mit genau 64 Zeichen:     8
ids > 64 Zeichen:             0
längste id: "KEYTRUDA.02---Inj-L-s---1L-nicht-plattenepitheliales-NSCLC-KN189"

Die Kürzung auf 64 Zeichen ist damit bestätigt: kein einziger Code ist länger als 64, und genau 8 liegen exakt auf der Grenze (also die gekürzten). Der Aufbau ist offenbar <Präparat>.<Limitations-Nr> bzw. <Präparat>.<Nr>---<Beschreibung>.

Ist-Zustand im Code

extract_limitation_data (src/plugin/bsv_fhir.rb) liest aus RegulatedAuthorization.indication[].extension[regulatedAuthorization-limitation] nur die Sub-Extensions limitationText und indicationCode. Die Referenz limitationIndication und damit der LimitationCode werden nicht ausgewertet. Übersetzungen (FR/IT) werden über SwissmedicNo8 zugeordnet (merge_translation_limitations).

Konsequenz

Der LimitationCode wäre der fachlich richtige Schlüssel auf Limitations-Ebene (stabil über Publikationen hinweg), statt der heutigen Zuordnung über SwissmedicNo8 + Reihenfolge. Beim Abgleich mit dem Excel-Datenstamm gilt weiterhin: dort kann der Code länger als 64 Zeichen sein, in FHIR ist er gekürzt — ein Vergleich muss auf die ersten 64 Zeichen normalisieren.