Email Spezifikation

Die hier vorliegende E-Mail-Spezifikation ist eine Sammlung an Informationen, an die sich die Datenannahmestellen (DAS) weitesgehend halten sollen, damit eine Übertragung per E-Mail fehlerfrei passieren kann.

Allgemeines

Version dieser Spezifikation

0.2

Changelog

Version Änderungen Datum
0.1 initiales Dokument 2022-03-11
0.2 – Verbesserung: bessere Beschreibung der Syntax für Transaktionsdateien
– Änderung: Namensgebung für Registrierungsnummer 7-stellig ("PB00001") anstatt 5-stellig ("DAS01")
– Korrektur: Namensgebung für Anhang des Protokolls "T-PB00000-2021_09_19_160945.zip.aes" anstatt "47d16341-9e27-4e75-a27e-b791fbbd2dc8_QD_DAS.xml.zip"
2022-04-01

Voraussetzungen

Um eine Datenübertragung DAS -> VPB per E-Mail zu ermöglichen, muss sich die DAS zunächst bei der Versendestelle registrieren. Details hierzu sind zu finden unter https://qs-patientenbefragung.de/.

Glossar

Begriff Erklärung
Exportdatei ist die unverschlüsselte XML-Datei mit den Fällen, wobei die Fälle an sich noch verschlüsselt sind (XML-Tag-Verschlüsselung)
Transaktionsdatei ist die komprimierte AES-128 verschlüsselte Exportdatei
Registrierungsnummer VPB vergibt diese ID
Datenflussprotokoll ist eine Transaktionsdatei mit den Ergebnissen des Datenprüfprogramms
Miniprotokoll ist eine Transaktionsdatei mit Fehlermeldungen, da ein Datenflussprotokoll nicht erstellbar ist

Bennenung der Exportdatei

  • siehe auch Technische Dokumentation für DAS Abschnitt A "Benennung der Exportdatei"
  • Syntax: <GUID>_<Inhaltskennung><Protokolltyp>_<Rolle Absender>.xml
  • GUID: Die verwendete GUID ist die im Dokument verwendete ID des Datenpakets (Abschnitt A „Eindeutige Kennzeichnung der XML-Exportdateien“).
  • Inhaltskennung:
    • Q: QS-Daten
    • S: Sollstatistik
    • R: Routinedaten
  • Protokolltyp
    • T: Transaktionsprotokoll bzw. Empfangsbestätigung
    • D: Datenflussprotokoll
  • Rolle Absender
    • LE: Leistungserbringer
    • DAS: Datenannahmestelle
    • VST: Vertrauensstelle
    • VPB: Versendestelle
    • BAS: Bundesauswertungsstelle
  • Beispiele
    • 47d16341-9e27-4e75-a27e-b791fbbd2dc8_QT_VPB.xml (Empfangsbestätigung)
    • 47d16341-9e27-4e75-a27e-b791fbbd2dc8_QD_VPB.xml (Datenflussprotokoll)
    • 47d16341-9e27-4e75-a27e-b791fbbd2dc8_Q_LE.xml (QS-Daten eines Leistungserbringers)
    • 47d16341-9e27-4e75-a27e-b791fbbd2dc8_Q_DAS.xml (QS-Daten einer Datenannahmestelle)

Bennenung der Transaktionsdatei

  • siehe auch Technische Dokumentation für DAS Abschnitt A "Erzeugung der Transaktionsdatei für die Übertragung via E-Mail"
  • Syntax: <Kürzel>-<Registrierungsnummer>-<Timestamp>[_<TimestampExtended>].zip.aes
  • Kürzel:
    • T: Transaktionsdatei
    • A: Antwort auf Transaktionsdatei
    • z. B. T
  • Registrierungsnummer: die von der VPB vergebene Registrierungsnummer
    • Format: PB<xxxxx> mit x jeweils Zahl oder Buchstabe
    • z.B. PB00001
    • die Registrierungsnummer PB00000 ist die VPB selbst
  • Timestamp:
    • Format: <YYYY>_<MM>_<dd>_<hhmmss>
    • z. B.: 2022_07_01_120000
  • TimestampExtended:
    • optional – sollen nur bei vielen gleichzeitigen Anfragen dafür sorgen, dass die Dateinamen eindeutig bleiben, aber für uns nicht relevant, da wir immer nach dem gleichen Schema antworten und dabei der Zeitstempel identisch bleiben soll
    • Format: <nnn> mit n jeweils Zahlen (Millisekunden)
    • z.B.: 123
  • Bsp. für
    • Transaktionsdatei: T-PB00001-2022_07_01_120000.zip.aes
    • Antwort auf Transaktionsdatei: A-PB00001-2022_07_01_120000.zip.aes

Spezifikation

Mailprotokoll

  • Protokolltyp: SMTP
  • Port: 25

DAS -> VPB (ZIP-Datei)

Die DAS sendet der VPB die Daten zu. Wie diese E-Mail aussehen soll ist hier definiert.

Anforderungen

Kriterien sind wie folgt definiert:

  • hart: wenn nicht erfüllt, wird die Sendung abgewiesen
  • weich: wenn nicht erfüllt, wird ein Vermerk erstellt, die Sendung aber angenommen
  • kein: ob angegeben oder nicht, diese Angabe wird vollständig ignoriert
Element Tag/Abschnitt Wert Beispiel Kriterium Erklärung
Header Subject Datentransfer-Versendestelle $ZIP-Dateiname$ z.B. Datentransfer-Versendestelle T-PB00001-2021_09_19_160945.zip.aes weich Betreff muss nicht gesetzt sein
Header From <$DAS-Mail$> z.B. <transfer@kv-wunderland.de> hart Wenn der Absender nicht korrekt gesetzt ist, wird die Mail ignoriert
Header To <$VPB-Mail$> z.B. <example@vpb.de> hart Wenn der Empfänger nicht korrekt gesetzt ist, kommt die Mail nicht an. Der Empfänger ist dem Registrierungsbrief zu entnehmen!
Body Inhalt kein Inhalte werden ignoriert
Body Anhang genau 1 Anhang mit genau 1 Transaktionsdatei 1 Anhang der Datei T-PB00001-2021_09_19_160945.zip.aes hart Sollten mehr Anhänge in der E-Mail enthalten sein, wird die Lieferung abgewiesen!
Body Anhang Dateiname der Transaktionsdatei wie im Abschnitt "Bennenung der Transaktionsdatei" vorgegeben 1 Anhang der Datei T-PB00001-2021_09_19_160945.zip.aes hart Sollten der Name vom Dateianhang nicht dem Schema entsprechen, wird die Lieferung abgewiesen! Der Dateiname soll den korrekten Registrierungsnamen der DAS enthalten. Siehe auch Abschnitt "Sicherheit der Datenübertragung per E-Mail" in der Technischen Dokumentation
Body Anhang Dateiname der Exportdatei, die in der Transaktionsdatei enthalten ist, ist wie im Abschnitt "Bennenung der Exportdatei" vorgegeben die angehängte Datei kann entpackt werden und in entpackte Datei trägt den Namen 47d16341-9e27-4e75-a27e-b791fbbd2dc8_Q_DAS.xml hart Sollte sich die angehängte Datei nicht entschlüsseln lassen zu einer Exportdatei, die dem Schema entspricht, wird die Lieferung abgewiesen!
Body Anhang 0 MB < Anhang < 25 MB Anhang ist 200 kB groß hart Sollte die Dateigröße nicht eingehalten werden, wird die Lieferung abgewiesen

Beispiel E-Mail als Plaintext

Subject: Datentransfer-Versendestelle
To: <SIEHE-REGISTRIERUNGSBRIEF>
From: <IHRE-E-MAIL>
MIME-Version: 1.0

--------------DdoJRBQu3FRdc2p0OJ3EzTiX
Content-Type: application/octet-stream;
 name="T-PB00001-2021_09_19_160945.zip.aes"
Content-Disposition: attachment; filename="T-PB00001-2021_09_19_160945.zip.aes"
Content-Transfer-Encoding: base64

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
bdi8pvLl7mD1B7TBkbSfIOF7yJiaH5ue

--------------DdoJRBQu3FRdc2p0OJ3EzTiX--

VPB -> DAS (Protokoll)

Die VPB sendet den DAS als Antwort ein Protokoll zurück. Wie diese E-Mail aussehen soll ist hier definiert.

Anforderungen

Kriterien sind wie folgt definiert:

  • hart: wenn nicht erfüllt, wird die Sendung abgewiesen
  • weich: wenn nicht erfüllt, wird ein Vermerk erstellt, die Sendung aber angenommen
  • kein: ob angegeben oder nicht, diese Angabe wird vollständig ignoriert
Element Tag/Abschnitt Wert Beispiel Kriterium Erklärung
Header Subject PROTOKOLL: Datentransfer-Versendestelle $Zip-Dateiname$ PROTOKOLL: Datentransfer-Versendestelle [T-PB00000-2021_09_19_160945.zip.aes] weich Betreff ist nicht zwangsläufig gesetzt
Header From <$VPB-Mail$> <example@vpb.de> hart Die VPB wird immer dieselbe Absenderadresse verwenden
Header To <$DAS-Mail$> <transfer@kv-wunderland.de> hart Wenn die VPB nicht die richtige Adresse wählt, kann die Mail nicht ankommen
Body Inhalt $ANY$ Sehr geehrte Damen und Herren, hiermit übersenden wir Ihnen das Datenflussprotokoll für die überprüfte Datei. weich
Body Anhang genau 1 Anhang mit genau 1 Datenflussprotokoll 1 Anhang der Datei T-PB00000-2021_09_19_160945.zip.aes hart Die Datei ist eine AES-verschlüsselte ZIP-Datei