Skip to content

Latest commit

 

History

History
366 lines (323 loc) · 25.7 KB

erp_fhirversion.adoc

File metadata and controls

366 lines (323 loc) · 25.7 KB
Raw

E-Rezept FHIR-Package Versionsmanagement gematik logo

Auf dieser Seite finden Sie eine Übersicht der FHIR-Release-Pakete der Prozessbeteiligten KBV, DAV, GKV, PKV und gematik.
Alle Prozessbeteiligten verantworten je mindestens ein FHIR-Profilierungs-Projekt, das im E-Rezept verwendet wird.

Inhaltsverzeichnis

Übersicht Dependencies

fhir dependencies

Weiter unten sind die Releases der Prozessbeteiligten aufgeführt, die gemeinsam gültig sind. Die folgende Tabelle liefert dabei die Anmerkungen zu Übergangszeiträumen und mit welchen Versions-Konstellationen zu rechnen ist.

❗
 Die Hinweise und konkreten Regelungen zu stichtagsbezogenen Versionsübergängen der gemeinsam gültigen FHIR-Profilversionen werden in separaten Verträgen zwischen den Bundesmantelvertragspartnern festgelegt.
💡
 Hinweise zur aktuellen FHIR-Konfiguration des E-Rezept-Fachdienstes in der Referenzumgebung RU finden Sie auf E-Rezept@RU

Übersicht Timeline

❗
 Die Dauer der Übergangsphase für das Profil kbv.ita.erp befindet sich in Abstimmung. Die folgende Abbildung verwendet beispielhaft eine Übergangsfrist vom 1.7.-31.7. in der sowohl die Version 1.0.2 als auch 1.1.0 bei der Verordnung von E-Rezepten genutzt werden kann.

puml fhir version timeline

Versionsübergang 30.06.2023 → 01.07.2023

Details zum Versionsübergang finden Sie auf dieser Seite.

Versionsübergang 30.06.2022 → 01.07.2022

Annahmen:

  • Praxisverwaltungssysteme sind vom neuen Profil eRezeptAbgabedaten nicht betroffen

  • Fachdienst ist vom neuen Profil eRezeptAbgabedaten nicht betroffen

  • Apothekenverwaltungssysteme erhalten Update bis zum 30.06. (Vollziehen den Profilwechsel zum 01.07.)

  • maximale Gültigkeitsdauer E-Rezept (Einlösefrist): 3 Monate

Workflow-Schritt

was passiert

FHIR-Definition

01.01.-31.05. (Status Quo)

01.06.-15.06.

15.06.-30.06.

01.07.-31.07.

01.08.-30.09.

01.10.-…​

$create

Fachdienst erzeugt Task

gematik

1.1.1

1.1.1

1.1.1

1.1.1

1.1.1

1.1.1

$activate

PVS stellt Bundle ein

KBV

1.0.2

1.0.2

1.0.2

1.0.2

1.0.2

1.0.2

$accept

AVS lädt Bundle herunter

gematik
(+ KBV)

1.1.1 + 1.0.2

1.1.1 + 1.0.2

1.1.1 + 1.0.2

1.1.1 + 1.0.2

1.1.1 + 1.0.2

1.1.1 + 1.0.2

$close

AVS erzeugt MedicationDispense

gematik

1.1.1

1.1.1

1.1.1

1.1.1

1.1.1

1.1.1

$close

Fachdienst erzeugt Quittung

gematik

1.1.1

1.1.1

1.1.1

1.1.1

1.1.1

1.1.1

eRezept-Abgabedaten

AVS erzeugt Abgabedaten

DAV

1.1.0

1.1.0

1.1.0

1.2

1.2

1.2

eRezept-Abrechnungs-daten

ARZ erzeugt Abrechnungsdaten

GKV-SV

1.1.0

1.1.0

1.1.0

1.1.0 (für Abrechnungsmonat Juni)

1.2 (für Abrechnungsmonat Juli)

1.2
💡
 Im Folgenden sind die Releases inkl. Auszügen der bereitgestellten Releasenotes der Prozessbeteiligten aufgeführt, die jeweils für ein E-Rezept zusammen gültig sind.

2023.07.01

Das Major Release des E-Rezepts zum 01.07.2023 umfasst diverse Anpassungen und Korrekturen, die sich aus Abstimmungen am runden FHIR-Tisch aller E-Rezept-Beteiligten Organisationen, der Technischen Kommission zur Abrechnungsstrecke und diversen Fehler- und Verbesserungstickets ergeben haben.

Versionsnummer Releasenotes Datum Veröffentlichung Datum gültig ab Datum gültig bis

KBV kbv.ita.erp

  • Integration der deutschen Basisprofile von HL7 in der Version 1.3.2 (zur Verbesserung der Interoperabilität)

  • Integration der KBV-Basis-Profile in der Version 1.3.0 (zur Verbesserung der Interoperabilität)

  • Anpassung der FOR-Profile in der Version 1.1.0

  • Ergänzung/Verbesserung von Constraints und Längenbeschränkungen für einzelne Felder

  • Aufnahme der ASV-Fachgruppennummer

  • Aufnahme der Standortnummer

  • Wiederaufnahme KBV_EX_ERP_MEDICATION_CATEGORY

  • Aufnahme der Telematik-ID zur optionalen Übertragung

  • Anpassung der Abbildung von Packungsgrößen

30.09.2022

01.07.2023

-

gematik de.gematik.erezept-workflow.r4

  • Refactoring der Profil-, Canonical- und Dateinamen nach gematik-Namensschema

  • Flowtype für neue Workflows (BtM, T-Rezept, …​)

  • Umstellung von Open Slices auf Closed Slice

  • Bundle.entry der Quittung slicen für die 3 spezifizierten Einträge

  • Neues Profil Provenance für Betäubungsmittelrezepte

  • Profil für Bundle mehrerer MedicationDispenses in $close

  • neues Versionierungsschema x.y für Profile und Ressourcen, Packages bleiben bei x.y.z mit z=Hotfix-Version

  • Umstellung der Toolchain auf FSH und SUSHI

  • Migration auf DE-Basisprofil 1.3.2

  • Separierung der ChargeItem-bezogenen Profile (eingeführt mit PKV) in ein eigenes Package (siehe unten)

  • Aktualisierte Dependency auf KBV.ITA.FOR und KBV.ITA.ERP

  • Angabe der Profilversion in FHIR-Ressource verpflichtend

  • PKV-KVNR Identifier aus KBV.FOR hinzugefügt

05.10.2022

01.07.2023

-

gematik de.gematik.erezept-patientenrechnung.r4

  • Initiale Bereitstellung von ChargeItem-bezogenen Profile (eingeführt mit PKV)

  • 2 neue Communicationsprofile für PKV für Request und Reply zur Korrektur eines ChargeItems

22.12.2022

01.07.2023

-

DAV de.abda.erezeptabgabedaten

  • Change slicing discriminator (DAV-PR-Base-AbgabedatenBundle) from "type:profile path:resource" to "type:value path:resource.meta.profile

  • Fix Constraints

    • Fix Constraints (regular expressions → start & end [^…​$])

    • DAV-EX-ERP-Rezeptaenderung

      • Rezeptaenderung-1 (start & end of strings)

    • DAV-PR-Base-ZusatzdatenHerstellung

      • PR-ZusatzdatenHerstellung-1 (double quotes)

      • PR-ZusatzdatenHerstellung-2 (double quotes)

  • DAV_PR_Base_ZusatzdatenHerstellung

    • set the minimum cardinality

  • DAV_PR_Base_ZusatzdatenEinheit

    • set the minimum cardinality

  • Change Constraint on DAV-PR-Base-Abrechnungszeilen

    • Split PR-Abrechnungszeilen-1 ("code.matches('^\S{8}(\S{2})?$')") to

      • PR-ZusatzdatenEinheit-PZN ("code.matches('^\d{8}$')")

      • PR-ZusatzdatenEinheit-SOK ("code.matches('^\d{8}$')")

      • PR-Abrechnungszeilen-HMNR ("code.matches('^\d{10}$')")

  • Add Constraints on DAV-PR-Base-ZusatzdatenEinheit

    • PR-ZusatzdatenEinheit-PZN ("code.matches('^\d{8}$')")

    • PR-ZusatzdatenEinheit-SOK ("code.matches('^\d{8}$')")

  • Upgrade Namingsystem (Hilfsmittelnummer (gkv-hmnr)) to DE-Basisprofil → (http://fhir.de/sid/gkv/hmnr)

    • DAV-PR-Base-Abrechnungszeilen - Invoice.lineItem.chargeItemCodeableConcept.coding:Hilfsmittelnummer

  • Upgrade Namingsystem (IKNR) to DE-Basisprofil → (http://fhir.de/sid/arge-ik/iknr)

    • DAV-PR-Base-Apotheke - Organization.identifier.system

  • Upgrade PrescriptionIdNS → (https://gematik.de/fhir/erp/NamingSystem/GEM_ERP_NS_PrescriptionId)

    • DAV-PR-Base-AbgabedatenBundle - Bundle.identifier.system

    • DAV-PR-Base-Abgabeinformationen - MedicationDispense.authorizingPrescription.identifier.system

21.12.2022

01.07.2023

-

GKV de.gkvsv.eRezeptAbrechnungsdaten

  • Change slicing discriminator (GKVSV_PR_TA7_Rechnung_Bundle) from "type:profile path:resource" to "type:value path:resource.meta.profile

  • Set GKVSV_PR_Binary (TA7) meta.profile + Version

  • Migration auf DE-Basisprofil 1.3.2

  • GKVSV_PR_TA7_Sammelrechnung_Bundle ersetzt durch GKVSV_PR_TA7_Rechnung_Bundle

  • GKVSV_PR_TA7_Sammelrechnung_Composition ersetzt durch GKVSV_PR_TA7_Rechnung_Composition

    • "Rechnungsnummer" (Composition.identifier) hinzugefügt

    • "Rechnungsart" (Composition.type) hinzugefügt

    • "Rechnungsdatum" (Composition.date.extension:Rechnungsdatum) hinzugefügt

  • GKVSV_PR_TA7_Sammelrechnung_List ersetzt durch GKVSV_PR_TA7_Rechnung_List

    • Die Referenz erfolgt jetzt über den Dateinamen

  • GKVSV_PR_TA7_Rechnung entfernt

    • Folgende Attribute in GKVSV_PR_TA7_Rechnung_Composition verschoben

      • Sammelrechnungsnummer zu Rechnungsnummer umbenannt(!)

      • Rechnungsart

      • Rechnungsdatum

  • GKVSV_EX_ERP_TA7_Abrechnungszeitraum entfernt

  • GKVSV_EX_ERP_TA7_Rechnungsdatum hinzugefügt

  • GKVSV_CS_ERP_TA7

    • Codes R, SR und LSR entfernt

    • Code LR (Liste der Rechnungen) hinzugefügt

    • Code AR (Abrechnungsdaten) hinzugefügt

  • GKVSV_PR_TA7_Rechnung_Bundle hat jetzt den Type "collection"

    • Constraint "dateabrz-1" entfernt

    • Constraint "Dateinummer-Wert" hinzugefügt

      • Der Wert der Dateinummer darf nicht weniger als 00001 betragen

    • Constraint "Dateiname" konkretisiert

      • Im regulären Ausdruck wurde "." durch "[A-Z]" ersetzt

  • GKVSV_PR_TA7_Rechnung_Composition

  • GKVSV_PR_TA7_RezeptBundle (bleibt erhalten)

    • Referenzen auf Gem_erxBinary ersetzt durch GKVSV_PR_Binary

  • GKVSV_PR_ERP_eAbrechnungsdaten

  • GKVSV_PR_Binary hinzugefügt

    • Dadurch kann die Abhängigkeit zu de.gematik.erezept-workflow.r4 entfernt werden

  • GKVSV_PR_TA7_Rechnung_List

    • Constraint "Dateiname" hinzugefügt

  • GKVSV_EX_TA7_IK_Kostentraeger

  • GKVSV_EX_TA7_IK_Empfaenger

  • GKVSV_EX_ERP_RezeptBundleReferenz, GKVSV_EX_ERP_Bin_Bundle, GKVSV_EX_ERP_Bin_Receipt und GKVSV_EX_ERP_Bin_Abgabedaten entfernt

  • GKVSV_CS_ERP_TA7

    • Code AR (wieder) entfernt

    • Code RB (Rezept-Bundle) hinzugefügt

22.12.2022

01.07.2023

-

PKV de.abda.eRezeptAbgabedatenPKV

  • initial final Version

21.12.2022

01.07.2023

-

2022.07.01

Mit dem Release zum 01.07.2022 erfolgt eine Anpassung der Profile von DAV und GKV für die eRezeptAbgabedaten und eRezeptAbrechnungsdaten.
Die Profilanpassungen der KBV und der gematik für die Unterstützung von Betäubungsmittelverordnungen sind erst ab dem 01.01.2023 zu verwenden. Sie behalten ihre Gültigkeit mit den zuletzt veröffentlichten Profilen

Versionsnummer Releasenotes Datum Veröffentlichung Datum gültig ab Datum gültig bis

KBV

-

13.09.2021

01.01.2022

30.06.2023

gematik

-

04.11.2021

01.01.2022

30.06.2023

DAV

  • new versioning scheme (Profile x.y Package x.y.z)

  • define fixed value meta.profile (canonical + version)

  • set mustSupport only on optional fields

  • DAV-PR-Base-ZusatzdatenEinheit (Invoice.lineItem.priceComponent.factor)

    • Change Constraint (PR-ZusatzdatenEinheit-1)

      • old Expression: "toString().matches('^\d{1,5}$')"

      • new Expression: "toString().matches('^\d{1,6}(\.\d{1,6})?$')"

  • Add Keys 0, 4 and 5 to ZusatzattributFAMSchluesselMarkt

  • Add CodeSystem / ValueSet DAV_CS_ERP_ZusatzattributFAMSchluesselImportFAM

    • Binding in profile (DAV-EX-ERP-Zusatzattribute)

  • Add ValueSet DAV-VS-ERP-DEUEV-Anlage-8

  • DAV_PR_Base_Apotheke (Organization.address.country)

    • Set Binding (DAV-VS-ERP-DEUEV-Anlage-8)

    • Set maxLength to 3

  • DAV_PR_Base_Apotheke (Organization.identifier.value)

    • Change contraint "PR-Apotheke-1"

      • Set severity-level to error

  • Remove PKV context profiles

    • DAV_PR_Base_Apotheke (remove Extension DAV_EX_ERP_Bankverbindung)

    • DAV_EX_ERP_Bankverbindung (remove)

    • DAV_EX_ERP_AbrechnungsTyp (remove)

    • DAV_CS_ERP_AbrechnungsTyp (remove)

    • DAV_VS_ERP_AbrechnungsTyp (remove)

  • Change slicing rules to close

    • Invoice.lineItem.chargeItem

    • all extensions

28.12.2021

01.07.2022

30.06.2023

GKV

  • new versioning scheme (Profile x.y Package x.y.z)

  • GKVSV_PR_TA7_Sammelrechnung_Composition um Constraint erweitert

    • Format des letzten Tages des Abrechnungszeitraumes zu JJJJ-MM-TT konkretisiert

    • Format des letzten Tages des Abrechnungszeitraumes zu JJJJ-MM-TT konkretisiert

  • GKVSV_EX_ERP_TA7_Abrechnungszeitraum um Constraint erweitert

    • Format des letzten Tages des Abrechnungszeitraumes zu JJJJ-MM-TT konkretisiert

  • GKVSV_EX_ERP_TA7_Dateinummer Constraint "Dateinummer-length" konkretisiert

    • Nur noch numerische Zeichen erlaubt

  • GKVSV_PR_TA7_Sammelrechnung_Bundle

    • Das Profil GKVSV_PR_TA7_Rechnung hat jetzt eine Kardinalität von 1:1.

    • Kostenträger-Iks aus GKVSV_PR_TA7_Sammelrechnung_Composition und GKVSV_PR_TA7_Rechnung werden auf Gleicheit geprüft

    • Es wird geprüft, dass das Enddatum des Abrechnungszeitraums in der Composition und der TA7_Rechnung identisch sind.

  • GKVSV_PR_ERP_eAbrechnungsdaten

    • Invoice.identifier-Slicing auf "closed" gesetzt

  • GKVSV_PR_TA7_Sammelrechnung_Composition

    • Composition.section-Slicing auf "closed" gesetzt

    • Das Profil GKVSV_PR_TA7_Rechnung hat jetzt eine Kardinalität von 1:1.

  • GKVSV_PR_TA7_Rechnung um Constraint erweitert

    • Die Rechnungsnummer darf nicht die Zeichen "/:?*\"<>|" enthalten.

      • toString().matches('^\\S*[\/:?\\\"<>|]\\S$').not()

31.12.2021

01.07.2022

30.06.2023

2022.01.01

Das Release zum 01.01.2022 ermöglicht das E-Rezept für die neue Benutzergruppe der PKV-Versicherten, zudem wird das E-Rezept zur Pflicht für alle GKV-Versicherten. Weiterhin werden bisherige Unschärfen korrigiert und Kleinere Verbesserungen bzw. Fehlerbeseitigungen in den beteilgiten FHIR-Projekten umgesetzt.

Versionsnummer Releasenotes Datum Veröffentlichung Datum gültig ab Datum gültig bis

KBV

  • Aktualisierung des Profils KBV_PR_ERP_Prescription:

    • Optimierung von drei Contraints

    • Streichung des nicht genutzten Elements dispenseRequest.validityPeriod

    • Korrektur einer Referenzierung im Element insurance

  • Aktualisierung der Profile KBV_PR_ERP_Medication_PZN /KBV_PR_ERP_Medication_Compounding / KBV_PR_ERP_Medication_FreeText / KBV_PR_ERP_Medication_Ingredient:

13.09.2021

01.01.2022

31.12.2022

gematik

  • New Feature "PKV"

  • Minor Changes

    • ErxReceipt with modified cardinality as it will have additional <entry> Binary für ePrescription-Hash (severside generated)

    • Removed unnesecary and unused workFlowTypes in CodeSystem and ValueSet "flowType"

    • modified samples (less handcrafted, connectathon outcome used)

    • removed dependency to KBV Medication-Profiles in MedicationDispense.Medication (switch to base Medication-Resource)

  • New Release "1.1.1" for fxing Bugs in previous version 1.1.0

    • fixed problem with xml-notation in JSon-Files, when downloading snapshot-package

    • removed external extension "KBVEXERPDosageFlag.xml"

    • ChargeItem_example: fixed wrong canonical of "Abgabedatensatz" in ChargeItem.supportingInformation.type

    • Added more information in Description for MedicationDispense.Medication (added names of KBV-Medication profiles)

04.11.2021

01.01.2022

31.12.2022

DAV

  • PackageVersion 1.1.2 ProfileVersion 1.1.0 - KorrekturRelease vom 21.01.2022

    • BaseDefinition de.abda.eRezeptAbgabeBasis (dependencies)

    • DAV-PR-Base-ZusatzdatenHerstellung

    • FIX Constraint Issue

      • Error: Datatype (string) is case sensitiv but used with "Sting" in constraint

        • replace with "exists()" because string must have a value

      • DAV-EX-ERP-Rezeptaenderung - Rezeptaenderung-1 (on extention)

        • error Expression: "(extension('ArtRezeptaenderung').value as CodeableConcept).coding.code.matches('2|3|4|12') implies ((extension('DokumentationRezeptaenderung').value as String).length() > 0)"

        • new Expression: "(extension('ArtRezeptaenderung').value as CodeableConcept).coding.code.matches('2|3|4|12') implies extension('DokumentationRezeptaenderung').exists()"

        • DAV-EX-ERP-Zusatzattribute - PreisguenstigesFAM-1 (on Extension.extension:ZusatzattributFAM.extension:PreisguenstigesFAM)

        • error Expression: "(extension('Schluessel').value as CodeableConcept).coding.code.matches('4') implies ((extension('DokumentationFreitext').value as String).length() > 0)"

        • new Expression: "(extension('Schluessel').value as CodeableConcept).coding.code.matches('4') implies extension('DokumentationFreitext').exists()"

      • DAV-EX-ERP-Zusatzattribute - ImportFAM-1 (on Extension.extension:ZusatzattributFAM.extension:ImportFAM)

        • error Expression: "(extension('Schluessel').value as CodeableConcept).coding.code.matches('4') implies ((extension('DokumentationFreitext').value as String).length() > 0)"

        • new Expression: "(extension('Schluessel').value as CodeableConcept).coding.code.matches('4') implies extension('DokumentationFreitext').exists()"

      • DAV-EX-ERP-Zusatzattribute - Rabattvertragserfuellung-1 (on Extension.extension:ZusatzattributFAM.extension:Rabattvertragserfuellung)

        • error Expression: "(extension('Schluessel').value as CodeableConcept).coding.code.matches('4') implies ((extension('DokumentationFreitext').value as String).length() > 0)"

        • new Expression: "(extension('Schluessel').value as CodeableConcept).coding.code.matches('4') implies extension('DokumentationFreitext').exists()"

    • DAV-PR-Base-ZusatzdatenHerstellung (MedicationDispense.whenPrepared)

      • old definition: Die Angabe muss im Format "JJJJMMTT:HHMM" erfolgen.

      • new definition: Die Angabe muss im Format ISO 8601 (z.B.: YYYY-MM-DDTHH:MM:00Z oder YYYY-MM-DDThh:mm:ss+zz:zz) erfolgen.

    • DAV-PR-Base-Apotheke (Organization.identifier.value)

      • Add contraint "PR-Apotheke-1" Eine IK muss 9-stellig (mit Prüfziffer) sein

        • Expression: matches('[0-9]{9}')

    • DAV-CS-ERP-ZusatzattributSchluesselZuzahlungsstatus

      • Edit Texte (display & definition)

  • PackageVersion 1.1.0 ProfileVersion 1.1.0 BaseDefinition de.abda.eRezeptAbgabeBasis (dependencies)

    • DAV-EX-ERP-Zusatzattribute (structural change)

      • Add Zusatzattribut Zuzahlungsstatus (Änderung des Zuzahlungsstatus nach Ausstellung des E-Rezepts)

      • Add CodeSystem (DAV-CS-ERP-ZusatzattributSchluesselZuzahlungsstatus)

      • Add ValueSet (DAV-VS-ERP-ZusatzattributSchluesselZuzahlungsstatus)

    • DAV-PR-ERP-Abgabeinformationen (structural change)

    • Profile-Optimierungen (contraints)

      • Näheres siehe Package-Release-Notes auf Simplifier

    • Profile-Optimierungen (cardinality)

      • näheres siehe package Release notes auf simplifier

Plan 01.10.2021
KorrekturRelease 21.01.2022

01.01.2022

30.06.2022

GKV

  • Aktualisierung des Profils GKVSV_PR_TA7_RezeptBundle

    • Die Quittung Gem_erxReceipt wird jetzt analog zu KBV_PR_ERP_Bundel und DAV_PR_ERP_AbgabedatenBundle als Binary eingebunden (structural change)

  • Constraint zur Überprüfung der Angabe der Signatur in der Quittung entfernt.

Plan 01.10.2021

01.01.2022

30.06.2022

PKV

initial Version (Release Candidate)

Plan 01.10.2021

tbd

31.12.2022