# FHIR-Code-Systeme

> Welche Code-Systeme jeder FHIR-Ressourcentyp verwendet: LOINC für Messungen und Laborergebnisse, ICD-10 für Zustände, ATC für Medikamente, UCUM-Einheiten und SNOMED CT hinter einer Lizenzflagge.

Source: https://developers.anpheros.com/de/guides/fhir-code-systems

Was die Plattform speichert und was Anpheros Daily (die Patienten-App) über die API schreibt. Anwendungen können jedes Code-System verwenden, das FHIR zulässt; diese Seite gibt an, welche die Plattform erkennt (Anzeige-Lookup, IPS-Prüfungen, Kontext-Engine) und welche Anpheros selbst verwendet. Zuletzt aktualisiert am 22. September 2026.

| Ressource | Element | Code-Systeme | Notizen |
|---|---|---|---|
| Observation (vital-signs) | `code` | LOINC (`http://loinc.org`) | 8867-4 Herzfrequenz, 85354-9 Blutdruck-Panel (8480-6 / 8462-4 Komponenten), 8310-5 Körpertemperatur, 2339-0 Glukose, 29463-7 Körpergewicht, 39156-5 BMI, 59408-5 SpO₂, 8302-2 Körpergröße |
| Observation (laboratory) | `code` | LOINC; lokal `urn:anpheros:lab`, wenn kein LOINC bekannt ist | zugeordnet von Anpheros Daily; Referenzbereich in `referenceRange`, Dokument in `derivedFrom` |
| Observation (symptom) | `code`, `category` | ICD-10 (`http://hl7.org/fhir/sid/icd-10`) Kapitel R; Kategorie `urn:anpheros:observation-category\|symptom`; SNOMED CT hinter einer Flagge | Freitext bleibt in `code.text`; Intensität 1–10 in `valueQuantity` (`{score}`). Ressourcen, die vor dem 13. Oktober 2026 geschrieben wurden, können das HL7 `observation-category`-System mit dem Code `symptom` enthalten; filtern nach Code (`category=symptom`), nicht nach System. Nur Symptome, die der Patient als vorhanden angibt, über sich selbst, werden geschrieben |
| Observation (survey, wellbeing) | `code`, `component` | `urn:anpheros:wellbeing` (Dimension: emotional / mental / physisch) | Intensität als Komponente `valueQuantity` `{score}`; Notiz in `note` |
| Observation (activity, daily watch summaries) | `code` | LOINC: 40443-4 Ruhe-Herzfrequenz, 8867-4 Herzfrequenz (Min/Durchschnitt/Max-Komponenten), 80404-7 HRV (RMSSD), 59408-5 SpO₂, 41950-7 Schritte, 41981-2 Energie, 93832-4 Schlafdauer, 93831-6 / 93830-8 Schlafphasen | `effectivePeriod` deckt den Tag ab; Kategorie `activity` |
| Condition | `code`, `severity`, `clinicalStatus` | ICD-10; SNOMED CT Schweregrad (24484000 schwer, 6736007 moderat, 255604002 mild); `condition-clinical` | Kategorie `problem-list-item` |
| MedicationStatement | `medicationCodeableConcept` | ATC (`http://www.whocc.no/atc`); `code.text` = Produktname | Erweiterung `daily-medication` für App-spezifische Felder |
| MedicationAdministration | `medicationCodeableConcept`, `supportingInformation` | ATC; der Behandlungsplan als `MedicationStatement/{id}` in `supportingInformation` (Suchparameter `statement`) | eine Ressource pro eingenommener oder übersprungener Dosis (`status` abgeschlossen / nicht durchgeführt) |
| Immunization | `vaccineCode` | ATC J07 (`http://www.whocc.no/atc`) oder die nationale Nomenklatur; `vaccineCode.text` immer beibehalten | `occurrenceDateTime` erforderlich für den IPS-Abschnitt; `protocolApplied.doseNumberPositiveInt` für die Dosis |
| AllergyIntolerance | `code`, `reaction.manifestation`, `criticality` | SNOMED CT (hinter einer Flagge) oder nur `code.text`; ATC für Medikamentenallergien | Kategorie Lebensmittel / Medikamente / Umwelt / Biologisch |
| DocumentReference | `type` | LOINC Dokumentenarten (`DOC_KIND_LOINC` in `/v1`) | |
| Encounter | `class`, `type` | v3-ActCode Klasse; SNOMED CT Typ, wenn bekannt | `episodeOfCare` → die EpisodeOfCare einer Schwangerschaft / chronischen Krankheit / Behandlung |
| EpisodeOfCare | `type`, `diagnosis.condition` | `urn:anpheros:episode-type` (Krankheit / Behandlung / Schwangerschaft / Sonstiges); `diagnosis.condition` → die Condition | eine pro Anpheros Daily Zustand ("dosar", 25. September 2026); `period` = Beginn → Ende. Verknüpfte Ressourcen verweisen auf die Condition: `Observation.focus`, `MedicationStatement.reasonReference`, `DocumentReference.context.related`, `Appointment.reasonReference` (Suche: `focus`, `reason-reference`, `related`, `condition`) |
| Appointment | `serviceType` | `service-type` Code-System | |
| RelatedPerson | `relationship` | v3-RoleCode (MTH, FTH, CHILD, SPS, …) | |
| QuestionnaireResponse | `questionnaire` | kanonische URLs unter `https://anpheros.com/fhir/Questionnaire/` | |
| Basic | `code` | `urn:anpheros:basic` | Notfallklappe; jeder hier dokumentierte Code vor der Verwendung |
| Provenance | `agent.type` | `provenance-participant-type` | |

## Identifikatoren und Erweiterungen

- Lokale Identifikatoren von Anpheros Daily-Zeilen: `urn:anpheros:daily:{vital|medication|condition|episode|lab|symptom|document|weight|wellbeing|intake|immunization|allergy|health-day}`.
- Bedingungserweiterung `daily-condition` (25. Sep. 2026): `kind` (Krankheit / Behandlung / Schwangerschaft / Sonstiges), `color` (App-Farbpalettenschlüssel), `source`, `due_date` (Schwangerschaft). Eine Schwangerschaft ohne geschriebenen Code trägt ICD-10 `Z33`.
- Erweiterungen leben unter `https://anpheros.com/fhir/StructureDefinition/daily-*` (`daily-medication`, `daily-symptom`, `daily-condition`, …).
- Einheiten sind UCUM (`http://unitsofmeasure.org`), überall dort, wo eine Menge geschrieben wird.

## Symptomkonzepte (Release 2026.10.2, 16. Oktober 2026)

`GET /v1/terminology/symptoms?q=&icd10=&kind=symptom|finding|all&lang=&limit=&offset=` und `GET /v1/terminology/symptoms/{concept_id}` dienen den Anpheros-Symptomkonzepten: eine stabile Kennung (`SYM-0001`…, niemals wiederverwendet; System `https://anpheros.com/fhir/CodeSystem/symptom`), die ICD-10-Zuordnung mit ihrer Äquivalenz (`equivalent` oder `broader`, wenn der ICD-10-Code mehr als das Konzept abdeckt), die Bezeichnungen und die Trefferbegriffe, die verwendet werden, um das Konzept im Freitext zu finden.

- 86 Konzepte: 70 Symptome und 16 Befunde (R70–R94). Symptome verwenden ICD-10 R00–R69 und, wo die WHO das Symptom anders klassifiziert, den WHO-Code: G47 Schlafstörungen, H53.2 Doppeltsehen, H53.8 verschwommenes Sehen (breiter), H93.1 Tinnitus, K59.0 Verstopfung, L29.9 Juckreiz, M25.5 Gelenkschmerzen, M54 Rückenschmerzen.
- Jeder Code und jeder englische Titel wurde am 15. Oktober 2026 gegen den WHO ICD-10 Version 2019 Browser geprüft, einschließlich seiner Ein- und Ausschlussnotizen; `icd10.display` ist der WHO-Titel.
- Jedes Konzept wird auch **ICD-11 MMS 2025-01** zugeordnet (`icd11`: Code, WHO-Titel, Äquivalenz `equivalent | wider | narrower | inexact`) and to a **body system** (`body_system`: the ICD-11 chapter 21 block of that code, e.g. `nervous`, `digestive`). Der Symptomcode aus Kapitel 21 wird anstelle eines Krankheitscodes verwendet (Kopfschmerz → MB4D, nicht 8A8Z); jede Abweichung von der WHO ICD-10 → ICD-11-Zuordnungstabelle ist in `release.json` (`icd11_departures`) aufgeführt. Filtern mit `?icd11=MB4D` oder `?body_system=digestive`.
- Bezeichnungen tragen einen `review`-Status: `source` (der offizielle englische WHO-Titel), `in_use` (die rumänischen Bezeichnungen und Trefferbegriffe, die Anpheros Daily verwendet) oder `ai_reviewed` (allgemeine Bezeichnungen in 19 Sprachen: maschinelle Übersetzungen, die Begriff für Begriff gegen die WHO-Titel mit KI-Unterstützung geprüft wurden, **nicht** von einem Kliniker oder professionellen medizinischen Übersetzer). `display` ist die bevorzugte Bezeichnung in `lang`, andernfalls die allgemeine Bezeichnung, andernfalls Englisch; `display_lang` gibt an, welche.
- Warnhinweise: 32 Einträge für 14 Konzepte, wörtlich zitiert von öffentlichen Seiten der CDC und NIDDK, jeweils mit Quelle, `review: source_verified` und einem Hinweis "keine Diagnose". Keine Ursachen oder Krankheitsassoziationen. Jedes Konzept trägt `clinical_review: false`, bis ein qualifizierter Kliniker die Freigabe überprüft.
- Die Daten befinden sich in `app/terminology/symptoms/` (`concepts.csv`, `labels.csv`, `release.json` mit Quellen); eine Änderung ist ein geprüfter Commit und eine neue Release-Nummer.
- Anpheros Daily fügt das Konzept als zweite Kodierung neben ICD-10 bei Symptom-Observations hinzu.
- Walkthrough mit Anfragen und Antworten: [Symptom Data API](https://developers.anpheros.com/de/guides/symptom-data-api).

### Dieselben Konzepte als FHIR-Terminologie (15. Oktober 2026)

Schreibgeschützt, aus derselben Freigabe, mit derselben Veröffentlichungsregel (nur geprüfte Bezeichnungen):

| Resource | Read | Notes |
|---|---|---|
| CodeSystem | `GET /fhir/R4/CodeSystem/anpheros-symptom`, `GET /fhir/R4/CodeSystem?url=https://anpheros.com/fhir/CodeSystem/symptom` | `content: complete`, `status: draft` bis klinisch geprüft; Eigenschaften `kind`, `status`, `icd10`, `icd11`, `body_system`; rumänische Bezeichnungen, Trefferbegriffe und die allgemeinen Bezeichnungen als Bezeichnungen |
| CodeSystem/$lookup | `GET /fhir/R4/CodeSystem/$lookup?system=https://anpheros.com/fhir/CodeSystem/symptom&code=SYM-0047&displayLanguage=ro` | `Parameters` mit Anzeige, Bezeichnungen und Eigenschaften |
| ValueSet | `GET /fhir/R4/ValueSet/anpheros-symptoms`, `GET /fhir/R4/ValueSet/$expand?url=https://anpheros.com/fhir/ValueSet/anpheros-symptoms&filter=&displayLanguage=&count=&offset=` | aktive Symptome (Befunde ausgeschlossen) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd10` | `equivalent` oder `wider`, wenn der ICD-10-Code mehr als das Konzept abdeckt (H53.8) |
| ConceptMap | `GET /fhir/R4/ConceptMap/anpheros-symptom-to-icd11` | ICD-11 MMS 2025-01 (`http://id.who.int/icd/release/11/mms`), mit `equivalent`, `wider`, `narrower` oder `inexact` |

**Profile `anpheros-symptom`** (`POST /fhir/R4/Observation/$validate?profile=anpheros-symptom`, kanonisch `https://anpheros.com/fhir/StructureDefinition/anpheros-symptom-observation`): Kategorie `urn:anpheros:observation-category|symptom` (der HL7 `observation-category`-Code wird abgelehnt), die Worte der Person in `code.text`, das Anpheros-Konzept im Einklang mit dem ICD-10-Code, Subjekt = Patient, Status final / amended / corrected / entered-in-error, effective[x] mit `effectivePeriod.end` nicht vor `start`, Intensität als UCUM `{score}` 0–10. Wie die anderen Profile meldet es Probleme und lehnt Schreibvorgänge nicht ab.

## Lizenzen

LOINC, ATC (WHO), ICD-10 (WHO) und UCUM werden unter ihren öffentlichen Lizenzen verwendet. SNOMED CT erfordert eine
nationale oder angeschlossene Lizenz: Die Mapping-Tabellen werden mit dem Code geliefert, aber SNOMED-Codes werden nur geschrieben, wenn `TERMINOLOGY_SNOMED_ENABLED` aktiviert ist (vorbehaltlich der Lizenz für Rumänien).

Wie Daten aus verschiedenen Quellen auf diese Codesysteme abgebildet werden, mit Einheiten, Daten und Validierung: [Wie medizinische Daten normalisiert werden](https://developers.anpheros.com/de/guides/normalize-medical-data).

Wo diese Codesysteme nachgeschlagen werden können und was der gebündelte Subset abdeckt: [Medical terminology API](https://developers.anpheros.com/de/guides/medical-terminology-api).