RE-PS als Akteur

Folgende Interaktionen können durch das RE-PS als Akteur ausgeführt werden, um eine Rechnung zu validieren und in den E-Rechnungsfachdienst einzustellen.


R0: Abfrage des Rechnungsempfängers und dessen Einwilligung zum Rechnungsversand

Die nachfolgende Interaktion ist relevant für den FD als Server, sowie für das RE-PS als Client. Anforderung AF_10132 MUSS durch den FD über die spezifizierte API umgesetzt werden. Die Vorgaben aus "Tabelle 14: Use Case Abfrage des Rechnungsempfängers und dessen Einwilligung zum Rechnungsversand" des Feature-Dokumentes MÜSSEN eingehalten werden durch den FD.

Abfrage des Rechnungsempfängers (Behandelter ist Rechnungsempfänger)

HTTP-Methode GET
Endpunkt /Patient
Suchparameter identifier Kardinalität: 1..1
Type: Token
Hinweis: Hierbei handelt es sich immer um eine KVNR, das System http://fhir.de/sid/gkv/kvid-10 MUSS durch den FD ergänzt werden, falls der Client dies nicht mitliefert.
Suchparameter birthdate Kardinalität: 1..1
Type: date
User-Kontext Telematik-ID Kardinalität: 1..1
Hinweis: Die Telematik-ID ist aus dem Claim idNummer des mitzusendenen Access-Token zu extrahieren.
API-Zustand HTTP-Status-Code
Erfolgsfall 200 - OK
Weitere Parameter in HTTP-Anfrage enthalten 400 - Bad Request
Syntax für FHIR-Suchanfrage ist nicht korrekt oder Kardinalitäten werden nicht eingehalten 400 - Bad Request
KVNR ist syntaktisch nicht korrekt 400 - Bad Request
Kein valides Access-Token wird mitgesendet 401 - Unauthorized
Autorisierter Benutzer verfügt über keine ausreichende Berechtigung die Interaktion auszuführen 403 - Forbidden
Rechnungsempfänger hat dem Rechnungsversand durch diesen Rechnungsersteller widersprochen 404 - Not Found. In diesem Fall: OperationOutcome mit Hinweis, dass Einwilligung nicht vorliegt oder Benutzer nicht vorhanden ist.
Mehr als ein Postfach unter Angabe der Suchparameter gefunden. 404 - Not Found. Dies stellt einen internen Fehler bei der Verwaltung der Postfächer dar.
Rechnungsempfänger verfügt über kein Konto 404 - Not Found. In diesem Fall: OperationOutcome mit Hinweis, dass Einwilligung nicht vorliegt oder Benutzer nicht vorhanden ist
Plausibilisierung zwischen Geburtsdatum und KVNR schlägt fehl 404 - Not Found
Andere HTTP-Methode wird verwendet 405 - Method Not Allowed

Beispiele

HTTP GET [fachdienst-endpunkt]/Patient?identifier=A000000000&birthdate=1970-01-01

Antwort des Endpunktes im Erfolgsfall:

HTTP 200 OK

mit Body:

Bundle
<Bundle xmlns="http://hl7.org/fhir">
    <id value="PatientenBundle" />
    <type value="searchset" />
    <total value="1" />
    <entry>
        <resource>
            <Patient>
                <id value="PatientVater" />
                <identifier>
                    <type>
                        <coding>
                            <system value="http://fhir.de/CodeSystem/identifier-type-de-basis" />
                            <code value="KVZ10" />
                        </coding>
                    </type>
                    <system value="http://fhir.de/sid/gkv/kvid-10" />
                    <value value="A000000000" />
                </identifier>
                <active value="true" />
                <name>
                    <family value="Mustermann" />
                    <given value="Manfred" />
                </name>
                <gender value="male" />
                <birthDate value="1970-01-01" />
            </Patient>
        </resource>
        <search>
            <mode value="match" />
        </search>
    </entry>
</Bundle>
{
    "resourceType": "Bundle",
    "id": "PatientenBundle",
    "type": "searchset",
    "total": 1,
    "entry":  [
        {
            "resource": {
                "resourceType": "Patient",
                "id": "PatientVater",
                "active": true,
                "name":  [
                    {
                        "given":  [
                            "Manfred"
                        ],
                        "family": "Mustermann"
                    }
                ],
                "identifier":  [
                    {
                        "type": {
                            "coding":  [
                                {
                                    "code": "KVZ10",
                                    "system": "http://fhir.de/CodeSystem/identifier-type-de-basis"
                                }
                            ]
                        },
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                ],
                "gender": "male",
                "birthDate": "1970-01-01"
            },
            "search": {
                "mode": "match"
            }
        }
    ]
}

Es MUSS durch den FD sichergestellt werden, dass die zurückgegebene Patient-Ressourcen eine stabile id besitzten.

Die zurückgegebene Patient-Ressource MUSS valide gegen das Profil ERGPKVersichertePerson sein.

CanonicalStatusVersionBasis
https://gematik.de/fhir/erg/StructureDefinition/erg-versichertepersonactive1.0.0-CChttp://hl7.org/fhir/StructureDefinition/Patient

idS Σ1..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeS Σ I1..1CodeableConceptBindingPattern
systemS Σ1..1uriFixed Value
valueS Σ I1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
activeS Σ ?!1..1boolean
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
textS Σ1..1string
familyS Σ1..1string
givenS Σ1..*string
prefixΣ0..*string
suffixΣ0..*string
periodΣ I0..1Period
telecomΣ I0..*ContactPoint
genderΣ0..1codeBinding
birthDateS Σ1..1date
deceasedBooleanboolean
deceasedDateTimedateTime
id0..1string
StadtteilS I0..1Extension(string)
useΣ ?!0..1codeBinding
typeS Σ0..1codeBinding
textΣ0..1string
id0..1string
StrasseS I0..1Extension(string)
HausnummerS I0..1Extension(string)
AdresszusatzS I0..1Extension(string)
PostfachI0..1Extension(string)
value0..1System.String
cityS Σ0..1string
districtΣ0..0string
stateΣ0..1stringBinding
postalCodeS Σ0..1string
countryS Σ0..1stringBinding
periodΣ I0..1Period
maritalStatus0..1CodeableConceptBinding
multipleBirthBooleanboolean
multipleBirthIntegerinteger
photoI0..*Attachment
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
relationship0..*CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
gender0..1codeBinding
organizationI0..1Reference(Organization)
periodI0..1Period
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
language1..1CodeableConceptBinding
preferred0..1boolean
generalPractitionerI0..*Reference(Organization | Practitioner | PractitionerRole)
managingOrganizationΣ I0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
otherΣ I1..1Reference(Patient | RelatedPerson)
typeΣ1..1codeBinding


Folgende Implementierungshinweise sind zu beachten:

Patient.identifier

vgl. Abschnitt 5.4.2.3 Bereitgestellte Claims und Scopes, Feature-Dokument E-Rechnung

Patient.active

Indikation für den Client, dass es sich um eine Person handelt die über ein aktives Postfach im Fachdienst verfügt.

Patient.name

vgl. Abschnitt 5.4.2.3 Bereitgestellte Claims und Scopes, Feature-Dokument E-Rechnung

Patient.birthDate

vgl. Abschnitt 5.4.2.3 Bereitgestellte Claims und Scopes, Feature-Dokument E-Rechnung

R1: Rechnung mit Dokumenten validieren und versenden

Die nachfolgende Interaktion ist relevant für den FD als Server, sowie für das RE-PS als Client. Anwendungsfall AF_10136 MUSS durch den FD über die spezifizierte API umgesetzt werden. Die Vorgaben aus "Tabelle 15: Use Case Rechnung mit Dokumenten validieren und versenden" des Feature-Dokumentes MÜSSEN eingehalten werden durch den FD.

HTTP-Methode POST
Endpunkt /Patient/[id-des-ermittelten-Rechnungsempfängers]

Die Input- und Output-Parameter werden durch die OperationDefinition https://gematik.de/fhir/erg/OperationDefinition/Submit beschrieben. Die ID des Rechnungsempfängers ist zuvor per R0: Abfrage des Rechnungsempfängers und dessen Einwilligung zum Rechnungsversand zu ermitteln.

Invocations

URL: [base]/Patient/[id]/$erechnung-submit

This operation changes content

Parameters (In)

NameCardinalityTypeBindingDocumentation
rechnung1..1DocumentReference

Vollständige E-Rechnung mit verschiedenen Attachments: 1) Rechnungs-PDF 2) Strukturierte Daten OHNE Signatur.

anhang0..*DocumentReference

Weitere Anhänge zur E-Rechnung als PDF.

modus0..1codeERGRechnungSubmitModusVS (required)

Verarbeitungshinweis für die E-Rechnung. Default: normal.

angereichertesPDF0..1boolean

Indikation ob nur das durch den FD erstellte Dokumententoken zurückgegeben werden soll oder das gesamte PDF inkl. Dokumententoken. Default: false.

Return Values (Out)

NameCardinalityTypeDocumentation
token0..*

Token(s) zur eineindeutigen Identifizierung der Rechnungsdokumente/-anhänge (unabhängig von returnTokenPDF). Dieser Parameter ist NUR optional falls modus = 'test'.

token.id1..1id

Randomisiertes Token zur Identifikation eines Dokumentes.

token.docRef1..1Identifier

Eindeutiger Identifikatior der Rechnung und Anhänge auf welche sich das Token bezieht.

token.angereichertesPDF0..1Binary

PDF mit eingebetteten Token und strukturierten Daten, in Abhängigkeit vom angereichertesPDF-Parameter. Vgl. 4.1 Einreichung per Post des Feature-Dokumentes E-Rechnung.

warnungen0..1OperationOutcome

Warnhinweise und Fehlern zur Validierung der E-Rechnung. Diese MÜSSEN in jedem Verarbeitungsmodus ausgegeben werden.

API-Zustand HTTP-Status-Code
Erfolgsfall 200 - OK
Weitere Parameter in HTTP-Anfrage enthalten 400 - Bad Request
Syntax für Parameter ist nicht korrekt oder Kardinalitäten werden nicht eingehalten 400 - Bad Request
Gravierende Fehler treten während der Validierung auf - Mode = 'normal' 400 - Bad Request
Kein valides Access-Token wird mitgesendet 401 - Unauthorized
Autorisierter Benutzer verfügt über keine ausreichende Berechtigung die Interaktion auszuführen 403 - Forbidden
Fehlende Berechtigung für den Leistungserbringer das Postfach zu verwenden 404 - Not Found In diesem Fall: OperationOutcome mit Hinweis, dass Einwilligung nicht vorliegt oder Benutzer nicht vorhanden ist
Andere HTTP-Methode wird verwendet 405 - Method Not Allowed

Dokumentenvalidierung

Der FD muss die syntaktischen und semantischen Prüfungen der Rechnung durchführen welche in AF_10136 unter 'Ablauf' beschrieben sind. Bei der Verarbeitung einer Rechnungen mit einer bereits im FD bekannten Signatur MUSS eine Validierungswarnung durch den FD herausgegeben werden. Zudem MÜSSEN die übermittelten Dokumente ein valides PDF/A sein. Andernfalls ist der Request mit 400 - Bad Request abzulehnen.

Signatur

Die Signatur wird durch den FD über die Konkatenation aller Base64-kodierten Inhalte der Rechnung (d.h. Rechnungrepräsentation in PDF/A-Form und den strukturierten Rechnungsinhalten) gebildet werden, in der Reihenfolge:

  1. Attachment mit contentType = application/pdf
  2. Attachment mit contentType = application/fhir+xml
  3. Attachment mit contentType = application/fhir+json

Weitere Details zur Signatur, siehe TODO.

Rechnungsrepräsentation

Die DocumentReference-Ressourcen welche über die Parameter rechnung und anhang übermittelt werden MÜSSEN dem Profil https://gematik.de/fhir/StructureDefinition/erg-dokumentenmetadaten entsprechen.

CanonicalStatusVersionBasis
https://gematik.de/fhir/erg/StructureDefinition/erg-dokumentenmetadatenactive1.0.0-CChttp://hl7.org/fhir/StructureDefinition/DocumentReference

idΣ0..1string
id0..1string
markierungS I0..*Extension(Complex)
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
docRef-signatureS I0..1Extension(Signature)
rechnungsdatumS I0..1Extension(dateTime)
zahlungszieldatumS I0..1Extension(dateTime)
gesamtbetragS I0..1Extension(Money)
fachrichtungS I0..1Extension(Coding)
leistungsartS I0..1Extension(Coding)
behandlungsartS I0..1Extension(Coding)
modifierExtension?! I0..*Extension
masterIdentifierΣ0..1Identifier
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
statusS Σ ?!1..1codeBindingPattern
docStatusΣ0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ1..1string
userSelectedΣ0..1boolean
RechnungstypS Σ0..1CodingPattern
textΣ0..1string
categoryΣ0..*CodeableConcept
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ1..1string
dateΣ0..1instant
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierS Σ1..1IdentifierTelematikId
displayS Σ1..1string
authenticatorI0..1Reference(Practitioner | PractitionerRole | Organization)
custodianI0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
codeΣ1..1codeBinding
targetΣ I1..1Reference(DocumentReference)
descriptionS Σ1..1string
securityLabelΣ0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeΣ0..1codeBinding
languageΣ0..1codeBinding
data0..1base64Binary
urlΣ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatΣ0..1CodingBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBindingPattern
languageΣ0..1codeBinding
dataS1..1base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBindingPattern
languageΣ0..1codeBinding
data0..0base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBinding
languageΣ0..1codeBinding
dataS1..1base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBindingPattern
languageΣ0..1codeBinding
dataS1..1base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
encounterI0..*Reference(Encounter | EpisodeOfCare)
event0..*CodeableConcept
periodΣ I0..1Period
facilityType0..1CodeableConcept
practiceSetting0..1CodeableConcept
sourcePatientInfoI0..1Reference(Patient)
patientS I1..1Reference(Patient)
anhaengeS I0..*Reference(DocumentReference)

Folgende Implementierungshinweise sind zu beachten:

DocumentReference.meta.tag:erg-rechnungsstatus

Vgl. Abschnitt 4.4.1 Workflow einer Rechnung des Feature-Dokuments E-Rechnung

DocumentReference.identifier

Eindeutiger Identifikator vergeben durch das RE-PS (z.B. Interne Dokumentennummer). Das System MUSS eindeutig pro Leistungserbringer:in vergeben werden.

DocumentReference.status

Versionierung von Dokumenten ist nicht unterstützt. Nur jeweils die aktuelle Version des Dokumentes wird akzeptiert.

DocumentReference.author.identifier

Der Fachdienst verknüpft alle Rechnungsdokumente mit der Telematik-ID des einreichenden Akteurs.

DocumentReference.description

Menschenlesbarer Titel des Dokumentes, der dem Versicherten in der UI angezeigt wird. Der Titel kann manuell erfasst oder vom Dateinamen/Metadaten abgeleitet werden. z.B. "Laborbefund vom 28.9.2023".

DocumentReference.content.attachment.url

Der FD muss die Base64-kodierten Daten aus attachment.data extrahieren und in eine Binary-Ressource auslagern.

DocumentReference.content:rechnungspdf.attachment.contentType

Zum Zeitpunkt der Veröffentlichung werden nur PDF-Dokumente als Rechnung seitens der Leistungserbringer:in unterstützt.

DocumentReference.content:rechnungspdf.attachment.data

Base64-kodiertes PDF. Dieses Feld muss durch die Applikation der Leistungserbringer:in gefüllt werden.

DocumentReference.content:angereicherteRechnung.attachment.contentType

Zum Zeitpunkt der Veröffentlichung werden nur PDF-Dokumente als Rechnung seitens der Leistungserbringer:in unterstützt.

DocumentReference.content:angereicherteRechnung.attachment.data

Die angereicherte Rechnung wird durch den FD direkt als Binary-Ressource unter attachment.url referenziert.

DocumentReference.content:strukturierterRechnungsinhalt.attachment.contentType

Strukturierte Rechnungsinhalte können seitens der Leistungserbringer:in sowohl als JSON als auch XML übergeben werden.

DocumentReference.content:strukturierterRechnungsinhalt.attachment.data

Base64-kodierte Repräsentation der Rechnungsinhalte. Dieses Feld muss durch die Applikation der Leistungserbringer:in gefüllt werden.

DocumentReference.content:anhang.attachment.contentType

Zum Zeitpunkt der Veröffentlichung werden nur PDF-Dokumente als Rechnungsanhänge seitens der Leistungserbringer:in unterstützt.

DocumentReference.content:anhang.attachment.data

Base64-kodiertes PDF. Dieses Feld muss durch die Applikation der Leistungserbringer:in gefüllt werden.

DocumentReference.context.related

Der Fachdienst verknüpft alle Rechnungsdokumente mit der Rechnungsempfänger:in.

Beispiele

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceRechnung3-LE" />
    <extension url="http://example.org/StructureDefinition/signatur">
        <valueSignature>
            <type>
                <system value="urn:iso-astm:E1762-95:2013" />
                <code value="1.2.840.10065.1.12.1.1" />
                <display value="Author&#39;s Signature" />
            </type>
            <when value="2015-02-07T13:28:17.239+02:00" />
            <who>
                <display value="Arzt" />
            </who>
        </valueSignature>
    </extension>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="AM010106" />
            <display value="Rechnung ambulante/station&#228;re Behandlung" />
        </coding>
    </type>
    <subject>
        <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10" />
            <value value="A000000000" />
        </identifier>
    </subject>
    <description value="Rechnung Reiseimpfung vom 10.01.2024" />
    <content>
        <attachment>
            <contentType value="application/pdf" />
            <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00" />
        </attachment>
    </content>
    <content>
        <attachment>
            <contentType value="application/xml" />
            <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
        </attachment>
        <format>
            <code value="xrechnung" />
        </format>
    </content>
    <content>
        <attachment>
            <contentType value="application/fhir+xml" />
            <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
        </attachment>
        <format>
            <code value="gematik-erechnung" />
        </format>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceRechnung3-LE",
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "AM010106",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Rechnung ambulante/stationäre Behandlung"
            }
        ]
    },
    "description": "Rechnung Reiseimpfung vom 10.01.2024",
    "subject": {
        "identifier": {
            "system": "http://fhir.de/sid/gkv/kvid-10",
            "value": "A000000000"
        }
    },
    "content":  [
        {
            "attachment": {
                "contentType": "application/pdf",
                "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00"
            }
        },
        {
            "format": {
                "code": "xrechnung"
            },
            "attachment": {
                "contentType": "application/xml",
                "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
            }
        },
        {
            "format": {
                "code": "gematik-erechnung"
            },
            "attachment": {
                "contentType": "application/fhir+xml",
                "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
            }
        }
    ],
    "extension":  [
        {
            "url": "http://example.org/StructureDefinition/signatur",
            "valueSignature": {
                "type":  [
                    {
                        "code": "1.2.840.10065.1.12.1.1",
                        "system": "urn:iso-astm:E1762-95:2013",
                        "display": "Author's Signature"
                    }
                ],
                "when": "2015-02-07T13:28:17.239+02:00",
                "who": {
                    "display": "Arzt"
                }
            }
        }
    ]
}
HTTP POST [fachdienst-endpunkt]/Patient/[id-des-ermittelten-Rechnungsempfängers]/$submit
Parameters
<Parameters xmlns="http://hl7.org/fhir">
    <id value="BeispielParameterSubmitInput3-LE" />
    <parameter>
        <name value="rechnung" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceRechnung3-LE" />
                <extension url="http://example.org/StructureDefinition/signatur">
                    <valueSignature>
                        <type>
                            <system value="urn:iso-astm:E1762-95:2013" />
                            <code value="1.2.840.10065.1.12.1.1" />
                            <display value="Author&#39;s Signature" />
                        </type>
                        <when value="2015-02-07T13:28:17.239+02:00" />
                        <who>
                            <display value="Arzt" />
                        </who>
                    </valueSignature>
                </extension>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="AM010106" />
                        <display value="Rechnung ambulante/station&#228;re Behandlung" />
                    </coding>
                </type>
                <subject>
                    <identifier>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="A000000000" />
                    </identifier>
                </subject>
                <description value="Rechnung Reiseimpfung vom 10.01.2024" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00" />
                    </attachment>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/xml" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
                    </attachment>
                    <format>
                        <code value="xrechnung" />
                    </format>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/fhir+xml" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
                    </attachment>
                    <format>
                        <code value="gematik-erechnung" />
                    </format>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
    <parameter>
        <name value="anhang" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceSonstigesDokument3-LE" />
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="PT130102" />
                        <display value="Molekularpathologiebefund" />
                    </coding>
                </type>
                <subject>
                    <reference value="Patient/BeispielPatient3-FD" />
                </subject>
                <description value="Molekularpathologiebefund vom 31.12.21" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00" />
                    </attachment>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
</Parameters>
{
    "resourceType": "Parameters",
    "id": "BeispielParameterSubmitInput3-LE",
    "parameter":  [
        {
            "name": "rechnung",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceRechnung3-LE",
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "AM010106",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Rechnung ambulante/stationäre Behandlung"
                        }
                    ]
                },
                "description": "Rechnung Reiseimpfung vom 10.01.2024",
                "subject": {
                    "identifier": {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00"
                        }
                    },
                    {
                        "format": {
                            "code": "xrechnung"
                        },
                        "attachment": {
                            "contentType": "application/xml",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
                        }
                    },
                    {
                        "format": {
                            "code": "gematik-erechnung"
                        },
                        "attachment": {
                            "contentType": "application/fhir+xml",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
                        }
                    }
                ],
                "extension":  [
                    {
                        "url": "http://example.org/StructureDefinition/signatur",
                        "valueSignature": {
                            "type":  [
                                {
                                    "code": "1.2.840.10065.1.12.1.1",
                                    "system": "urn:iso-astm:E1762-95:2013",
                                    "display": "Author's Signature"
                                }
                            ],
                            "when": "2015-02-07T13:28:17.239+02:00",
                            "who": {
                                "display": "Arzt"
                            }
                        }
                    }
                ]
            }
        },
        {
            "name": "anhang",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceSonstigesDokument3-LE",
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "PT130102",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Molekularpathologiebefund"
                        }
                    ]
                },
                "description": "Molekularpathologiebefund vom 31.12.21",
                "subject": {
                    "reference": "Patient/BeispielPatient3-FD"
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00"
                        }
                    }
                ]
            }
        }
    ]
}

Antwort des Fachdienstes im Erfolgsfall:

Rückgabe von Rechung und Anhang jeweils mit aufgebrachtem Token und separiertem Inhalt. Bei Verwendung des Parameters "returnTokenPDF" werden die Binaries mit den PDF/A-Dokumenten (incl. Token-Barcode) als Parameter direkt mit ausgegeben.

HTTP 200 OK

mit Body:

Parameters
<Parameters xmlns="http://hl7.org/fhir">
    <id value="BeispielParameterSubmitOutput3-FD" />
    <parameter>
        <name value="rechnung" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceRechnung3-FD" />
                <identifier>
                    <system value="https://gematik.de/fhir/sid/erg-token" />
                    <value value="123-456-789" />
                </identifier>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="AM010106" />
                        <display value="Rechnung ambulante/station&#228;re Behandlung" />
                    </coding>
                </type>
                <subject>
                    <identifier>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="A000000000" />
                    </identifier>
                </subject>
                <relatesTo>
                    <code value="transforms" />
                    <target>
                        <reference value="DocumentReference/BeispielDocumentReferenceRechnung3-LE" />
                    </target>
                </relatesTo>
                <description value="Rechnung Reiseimpfung vom 10.01.2024" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <url value="[FD-endpunkt]/Binary/pdf-mit-token-barcode" />
                    </attachment>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/xml" />
                        <url value="[FD-endpunkt]/Binary/xrechnung" />
                    </attachment>
                    <format>
                        <code value="xrechnung" />
                    </format>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/fhir+xml" />
                        <url value="[FD-endpunkt]/Binary/invoice" />
                    </attachment>
                    <format>
                        <code value="gematik-erechnung" />
                    </format>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
    <parameter>
        <name value="anhang" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceSonstigesDokument3-FD" />
                <identifier>
                    <system value="https://gematik.de/fhir/sid/erg-token" />
                    <value value="987-654-321" />
                </identifier>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="PT130102" />
                        <display value="Molekularpathologiebefund" />
                    </coding>
                </type>
                <subject>
                    <reference value="Patient/BeispielPatient3-FD" />
                </subject>
                <relatesTo>
                    <code value="transforms" />
                    <target>
                        <reference value="DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE" />
                    </target>
                </relatesTo>
                <description value="Molekularpathologiebefund vom 31.12.21" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <url value="[FD-endpunkt]/Binary/patho-mit-token-barcode" />
                    </attachment>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
</Parameters>
{
    "resourceType": "Parameters",
    "id": "BeispielParameterSubmitOutput3-FD",
    "parameter":  [
        {
            "name": "rechnung",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceRechnung3-FD",
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/erg-token",
                        "value": "123-456-789"
                    }
                ],
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "AM010106",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Rechnung ambulante/stationäre Behandlung"
                        }
                    ]
                },
                "description": "Rechnung Reiseimpfung vom 10.01.2024",
                "subject": {
                    "identifier": {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "url": "[FD-endpunkt]/Binary/pdf-mit-token-barcode"
                        }
                    },
                    {
                        "format": {
                            "code": "xrechnung"
                        },
                        "attachment": {
                            "contentType": "application/xml",
                            "url": "[FD-endpunkt]/Binary/xrechnung"
                        }
                    },
                    {
                        "format": {
                            "code": "gematik-erechnung"
                        },
                        "attachment": {
                            "contentType": "application/fhir+xml",
                            "url": "[FD-endpunkt]/Binary/invoice"
                        }
                    }
                ],
                "relatesTo":  [
                    {
                        "code": "transforms",
                        "target": {
                            "reference": "DocumentReference/BeispielDocumentReferenceRechnung3-LE"
                        }
                    }
                ]
            }
        },
        {
            "name": "anhang",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceSonstigesDokument3-FD",
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/erg-token",
                        "value": "987-654-321"
                    }
                ],
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "PT130102",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Molekularpathologiebefund"
                        }
                    ]
                },
                "description": "Molekularpathologiebefund vom 31.12.21",
                "subject": {
                    "reference": "Patient/BeispielPatient3-FD"
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "url": "[FD-endpunkt]/Binary/patho-mit-token-barcode"
                        }
                    }
                ],
                "relatesTo":  [
                    {
                        "code": "transforms",
                        "target": {
                            "reference": "DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE"
                        }
                    }
                ]
            }
        }
    ]
}

Verarbeitungsschritte im FD

Bei der Entgegennahme der Dokumente MÜSSEN durch den FD die nachfolgenden Schritte durchgeführt werden. Es ist zu beachten, dass dies asynchron durchgeführt werden kann durch den FD. Lediglich MUSS der FD sicherstellen, dass dieser Prozess vor dem Abruf der Dokumente durch das eRg FdV oder dem RE-PS abgearbeitet wurde.

  • DocumentReference.attachment.data muss aus der übermittelten DocumentReference herausgelöst werden. Der Inhalt MUSS in einer durch den FD neu angelegten Binary-Ressource gespeichert werden. Die Binary-Ressource MUSS unter attachment.url mit einer absoluten URL referenziert werden. DocumentReference.attachment.data ist anschließend zu löschen. Dies gilt für alle durch den Client übermittelte Dokumente.

  • Die originale Rechnung (DocumentReference.type = IHEXDStypeCode#ABRE) MUSS angereichert werden mit den strukturierten Rechnungsinhalten. Der FD MUSS die Inhalte strukturiert im FHIR-Format innerhalb eines PDF/A einbetten.

  • Das neu erzeugte PDF/A muss als Binary nach den Vorgaben von DocumentReference.content:angereicherteRechnung aus dem oben aufgeführten Profil hinterlegt werden.

  • Für jedes PDF/A-Dokument MUSS der FD ein Token unter Einhaltung einer ausreichenden Entropie erstellen. Der FD MUSS zusätzlich einen Barcode auf dem Rechnungs- oder Anhangdokument unterbringen welcher das Dokumententoken kodiert enthält. Die Lesbarkeit der Inhalte des Dokumtes darf hierdurch nicht eingeschränkt werden. Die Zugehörigkeit eines Tokens zu einem Dokument MUSS gespeichert werden, um den Abruf eines Dokumentes mit diesem Token zu ermöglichen.

  • DocumentReference.context.related MUSS durch den FD auf die ID des ermittelten Rechnungsempfängers gesetzt werden.

  • DocumentReference.author.identifier MUSS durch den FD auf die im Access-Token enthaltene Telematik-ID gesetzt werden. Durch den Client übermittelte Angaben in DocumentReference.author sind zu überschreiben.

  • Hinweis: In der FHIR-Repräsentation erfolgt keine Differenzierung zwischen dem Datenobjekt für die Rechnungsdokumente und dem Rechnungsworkflow. Der Workflowstatus wird somit innerhalb der DocumentReference abgebildet. DocumentReference.meta.tag:erg-rechnungsstatus MUSS durch den FD auf "Offen" gesetzt werden beim Empfang der Rechnung.

Hinweise zur Abbildung des Workflow-Objektes (fachliches Datenmodell)

Im fachlichen Datenmodell des Feature-Dokuments E-Rechnung ist dargestellt, dass jede Rechnung,sowie jedes ergänzende Dokument mit einem Rechnungsworkflow-Objekt verbunden ist. Dieses Workflow-Objekt bündelt das Rechnungsdokument sowie die Anhänge zusammen und gibt diesen Dokumenten einen gemeinsamen Status. Zur Vereinfachung der Implementierung seitens des FD und des eRg FDV wird in der FHIR-Repräsentation kein weiteres Datenobjekt hierfür verwendet. Hingegen enthält das Profil 'ERGDokumentenmetadaten' eine Extension 'erg-rechnungsstatus' für diesen Zweck. Der Status zusammenhängender Dokumente MUSS stets synchron gehalten werden. Diese Extension gilt für das Rechnungsdokument sowie alle Anhänge, die innerhalb einer Submit-Operation im gleichen Kontext übermittelt worden sind wie die Rechnung. Der FD MUSS den Zusammenhang zwischen diesen Dokumenten in der Verarbeitungslogik vorhalten.

Beispiele

Beispiel: Rechnungsdokument nach Verarbeitung auf Server

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceRechnung3-FD" />
    <identifier>
        <system value="https://gematik.de/fhir/sid/erg-token" />
        <value value="123-456-789" />
    </identifier>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="AM010106" />
            <display value="Rechnung ambulante/station&#228;re Behandlung" />
        </coding>
    </type>
    <subject>
        <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10" />
            <value value="A000000000" />
        </identifier>
    </subject>
    <relatesTo>
        <code value="transforms" />
        <target>
            <reference value="DocumentReference/BeispielDocumentReferenceRechnung3-LE" />
        </target>
    </relatesTo>
    <description value="Rechnung Reiseimpfung vom 10.01.2024" />
    <content>
        <attachment>
            <contentType value="application/pdf" />
            <url value="[FD-endpunkt]/Binary/pdf-mit-token-barcode" />
        </attachment>
    </content>
    <content>
        <attachment>
            <contentType value="application/xml" />
            <url value="[FD-endpunkt]/Binary/xrechnung" />
        </attachment>
        <format>
            <code value="xrechnung" />
        </format>
    </content>
    <content>
        <attachment>
            <contentType value="application/fhir+xml" />
            <url value="[FD-endpunkt]/Binary/invoice" />
        </attachment>
        <format>
            <code value="gematik-erechnung" />
        </format>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceRechnung3-FD",
    "identifier":  [
        {
            "system": "https://gematik.de/fhir/sid/erg-token",
            "value": "123-456-789"
        }
    ],
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "AM010106",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Rechnung ambulante/stationäre Behandlung"
            }
        ]
    },
    "description": "Rechnung Reiseimpfung vom 10.01.2024",
    "subject": {
        "identifier": {
            "system": "http://fhir.de/sid/gkv/kvid-10",
            "value": "A000000000"
        }
    },
    "content":  [
        {
            "attachment": {
                "contentType": "application/pdf",
                "url": "[FD-endpunkt]/Binary/pdf-mit-token-barcode"
            }
        },
        {
            "format": {
                "code": "xrechnung"
            },
            "attachment": {
                "contentType": "application/xml",
                "url": "[FD-endpunkt]/Binary/xrechnung"
            }
        },
        {
            "format": {
                "code": "gematik-erechnung"
            },
            "attachment": {
                "contentType": "application/fhir+xml",
                "url": "[FD-endpunkt]/Binary/invoice"
            }
        }
    ],
    "relatesTo":  [
        {
            "code": "transforms",
            "target": {
                "reference": "DocumentReference/BeispielDocumentReferenceRechnung3-LE"
            }
        }
    ]
}

Beispiel: sonstiges Dokument nach Verarbeitung auf Server

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceSonstigesDokument3-FD" />
    <identifier>
        <system value="https://gematik.de/fhir/sid/erg-token" />
        <value value="987-654-321" />
    </identifier>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="PT130102" />
            <display value="Molekularpathologiebefund" />
        </coding>
    </type>
    <subject>
        <reference value="Patient/BeispielPatient3-FD" />
    </subject>
    <relatesTo>
        <code value="transforms" />
        <target>
            <reference value="DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE" />
        </target>
    </relatesTo>
    <description value="Molekularpathologiebefund vom 31.12.21" />
    <content>
        <attachment>
            <contentType value="application/pdf" />
            <url value="[FD-endpunkt]/Binary/patho-mit-token-barcode" />
        </attachment>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceSonstigesDokument3-FD",
    "identifier":  [
        {
            "system": "https://gematik.de/fhir/sid/erg-token",
            "value": "987-654-321"
        }
    ],
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "PT130102",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Molekularpathologiebefund"
            }
        ]
    },
    "description": "Molekularpathologiebefund vom 31.12.21",
    "subject": {
        "reference": "Patient/BeispielPatient3-FD"
    },
    "content":  [
        {
            "attachment": {
                "contentType": "application/pdf",
                "url": "[FD-endpunkt]/Binary/patho-mit-token-barcode"
            }
        }
    ],
    "relatesTo":  [
        {
            "code": "transforms",
            "target": {
                "reference": "DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE"
            }
        }
    ]
}

R2: Rechnung validieren/einreichen (Bulk)

Die nachfolgende Interaktion ist relevant für den FD als Server, sowie für das RE-PS als Client. Anwendungsfall AF_10136 MUSS durch den FD über die spezifizierte API umgesetzt werden. Die Vorgaben aus "Tabelle 15: Use Case Rechnung mit Dokumenten validieren und versenden" des Feature-Dokumentes MÜSSEN eingehalten werden durch den FD.

HTTP-Methode POST
Endpunkt /Patient/[id-des-ermittelten-Rechnungsempfängers]

Die Input- und Output-Parameter werden durch die OperationDefinition https://gematik.de/fhir/erg/OperationDefinition/Submit beschrieben. Die ID des Rechnungsempfängers ist zuvor per R0: Abfrage des Rechnungsempfängers und dessen Einwilligung zum Rechnungsversand zu ermitteln.

Invocations

URL: [base]/Patient/[id]/$erechnung-submit

This operation changes content

Parameters (In)

NameCardinalityTypeBindingDocumentation
rechnung1..1DocumentReference

Vollständige E-Rechnung mit verschiedenen Attachments: 1) Rechnungs-PDF 2) Strukturierte Daten OHNE Signatur.

anhang0..*DocumentReference

Weitere Anhänge zur E-Rechnung als PDF.

modus0..1codeERGRechnungSubmitModusVS (required)

Verarbeitungshinweis für die E-Rechnung. Default: normal.

angereichertesPDF0..1boolean

Indikation ob nur das durch den FD erstellte Dokumententoken zurückgegeben werden soll oder das gesamte PDF inkl. Dokumententoken. Default: false.

Return Values (Out)

NameCardinalityTypeDocumentation
token0..*

Token(s) zur eineindeutigen Identifizierung der Rechnungsdokumente/-anhänge (unabhängig von returnTokenPDF). Dieser Parameter ist NUR optional falls modus = 'test'.

token.id1..1id

Randomisiertes Token zur Identifikation eines Dokumentes.

token.docRef1..1Identifier

Eindeutiger Identifikatior der Rechnung und Anhänge auf welche sich das Token bezieht.

token.angereichertesPDF0..1Binary

PDF mit eingebetteten Token und strukturierten Daten, in Abhängigkeit vom angereichertesPDF-Parameter. Vgl. 4.1 Einreichung per Post des Feature-Dokumentes E-Rechnung.

warnungen0..1OperationOutcome

Warnhinweise und Fehlern zur Validierung der E-Rechnung. Diese MÜSSEN in jedem Verarbeitungsmodus ausgegeben werden.

API-Zustand HTTP-Status-Code
Erfolgsfall 200 - OK
Weitere Parameter in HTTP-Anfrage enthalten 400 - Bad Request
Syntax für Parameter ist nicht korrekt oder Kardinalitäten werden nicht eingehalten 400 - Bad Request
Gravierende Fehler treten während der Validierung auf - Mode = 'normal' 400 - Bad Request
Kein valides Access-Token wird mitgesendet 401 - Unauthorized
Autorisierter Benutzer verfügt über keine ausreichende Berechtigung die Interaktion auszuführen 403 - Forbidden
Fehlende Berechtigung für den Leistungserbringer das Postfach zu verwenden 404 - Not Found In diesem Fall: OperationOutcome mit Hinweis, dass Einwilligung nicht vorliegt oder Benutzer nicht vorhanden ist
Andere HTTP-Methode wird verwendet 405 - Method Not Allowed

Dokumentenvalidierung

Der FD muss die syntaktischen und semantischen Prüfungen der Rechnung durchführen welche in AF_10136 unter 'Ablauf' beschrieben sind. Bei der Verarbeitung einer Rechnungen mit einer bereits im FD bekannten Signatur MUSS eine Validierungswarnung durch den FD herausgegeben werden. Zudem MÜSSEN die übermittelten Dokumente ein valides PDF/A sein. Andernfalls ist der Request mit 400 - Bad Request abzulehnen.

Signatur

Die Signatur wird durch den FD über die Konkatenation aller Base64-kodierten Inhalte der Rechnung (d.h. Rechnungrepräsentation in PDF/A-Form und den strukturierten Rechnungsinhalten) gebildet werden, in der Reihenfolge:

  1. Attachment mit contentType = application/pdf
  2. Attachment mit contentType = application/fhir+xml
  3. Attachment mit contentType = application/fhir+json

Weitere Details zur Signatur, siehe TODO.

Rechnungsrepräsentation

Die DocumentReference-Ressourcen welche über die Parameter rechnung und anhang übermittelt werden MÜSSEN dem Profil https://gematik.de/fhir/StructureDefinition/erg-dokumentenmetadaten entsprechen.

CanonicalStatusVersionBasis
https://gematik.de/fhir/erg/StructureDefinition/erg-dokumentenmetadatenactive1.0.0-CChttp://hl7.org/fhir/StructureDefinition/DocumentReference

idΣ0..1string
id0..1string
markierungS I0..*Extension(Complex)
versionIdΣ0..1id
lastUpdatedΣ0..1instant
sourceΣ0..1uri
profileΣ0..*canonical(StructureDefinition)
securityΣ0..*CodingBinding
id0..1string
extensionI0..*Extension
systemS Σ1..1uri
versionΣ0..1string
codeS Σ1..1code
displayΣ0..1string
userSelectedΣ0..1boolean
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
docRef-signatureS I0..1Extension(Signature)
rechnungsdatumS I0..1Extension(dateTime)
zahlungszieldatumS I0..1Extension(dateTime)
gesamtbetragS I0..1Extension(Money)
fachrichtungS I0..1Extension(Coding)
leistungsartS I0..1Extension(Coding)
behandlungsartS I0..1Extension(Coding)
modifierExtension?! I0..*Extension
masterIdentifierΣ0..1Identifier
id0..1string
extensionI0..*Extension
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemS Σ1..1uri
valueS Σ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(Organization)
statusS Σ ?!1..1codeBindingPattern
docStatusΣ0..1codeBinding
id0..1string
extensionI0..*Extension
id0..1string
extensionI0..*Extension
systemS Σ1..1uriPattern
versionΣ0..1string
codeS Σ1..1code
displayS Σ1..1string
userSelectedΣ0..1boolean
RechnungstypS Σ0..1CodingPattern
textΣ0..1string
categoryΣ0..*CodeableConcept
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierΣ0..1Identifier
displayS Σ1..1string
dateΣ0..1instant
id0..1string
extensionI0..*Extension
referenceΣ I0..1string
typeΣ0..1uriBinding
identifierS Σ1..1IdentifierTelematikId
displayS Σ1..1string
authenticatorI0..1Reference(Practitioner | PractitionerRole | Organization)
custodianI0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
codeΣ1..1codeBinding
targetΣ I1..1Reference(DocumentReference)
descriptionS Σ1..1string
securityLabelΣ0..*CodeableConceptBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeΣ0..1codeBinding
languageΣ0..1codeBinding
data0..1base64Binary
urlΣ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatΣ0..1CodingBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBindingPattern
languageΣ0..1codeBinding
dataS1..1base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBindingPattern
languageΣ0..1codeBinding
data0..0base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBinding
languageΣ0..1codeBinding
dataS1..1base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
contentTypeS Σ1..1codeBindingPattern
languageΣ0..1codeBinding
dataS1..1base64Binary
urlS Σ0..1url
sizeΣ0..1unsignedInt
hashΣ0..1base64Binary
titleΣ0..1string
creationΣ0..1dateTime
formatS Σ1..1CodingBindingPattern
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
encounterI0..*Reference(Encounter | EpisodeOfCare)
event0..*CodeableConcept
periodΣ I0..1Period
facilityType0..1CodeableConcept
practiceSetting0..1CodeableConcept
sourcePatientInfoI0..1Reference(Patient)
patientS I1..1Reference(Patient)
anhaengeS I0..*Reference(DocumentReference)

Folgende Implementierungshinweise sind zu beachten:

DocumentReference.meta.tag:erg-rechnungsstatus

Vgl. Abschnitt 4.4.1 Workflow einer Rechnung des Feature-Dokuments E-Rechnung

DocumentReference.identifier

Eindeutiger Identifikator vergeben durch das RE-PS (z.B. Interne Dokumentennummer). Das System MUSS eindeutig pro Leistungserbringer:in vergeben werden.

DocumentReference.status

Versionierung von Dokumenten ist nicht unterstützt. Nur jeweils die aktuelle Version des Dokumentes wird akzeptiert.

DocumentReference.author.identifier

Der Fachdienst verknüpft alle Rechnungsdokumente mit der Telematik-ID des einreichenden Akteurs.

DocumentReference.description

Menschenlesbarer Titel des Dokumentes, der dem Versicherten in der UI angezeigt wird. Der Titel kann manuell erfasst oder vom Dateinamen/Metadaten abgeleitet werden. z.B. "Laborbefund vom 28.9.2023".

DocumentReference.content.attachment.url

Der FD muss die Base64-kodierten Daten aus attachment.data extrahieren und in eine Binary-Ressource auslagern.

DocumentReference.content:rechnungspdf.attachment.contentType

Zum Zeitpunkt der Veröffentlichung werden nur PDF-Dokumente als Rechnung seitens der Leistungserbringer:in unterstützt.

DocumentReference.content:rechnungspdf.attachment.data

Base64-kodiertes PDF. Dieses Feld muss durch die Applikation der Leistungserbringer:in gefüllt werden.

DocumentReference.content:angereicherteRechnung.attachment.contentType

Zum Zeitpunkt der Veröffentlichung werden nur PDF-Dokumente als Rechnung seitens der Leistungserbringer:in unterstützt.

DocumentReference.content:angereicherteRechnung.attachment.data

Die angereicherte Rechnung wird durch den FD direkt als Binary-Ressource unter attachment.url referenziert.

DocumentReference.content:strukturierterRechnungsinhalt.attachment.contentType

Strukturierte Rechnungsinhalte können seitens der Leistungserbringer:in sowohl als JSON als auch XML übergeben werden.

DocumentReference.content:strukturierterRechnungsinhalt.attachment.data

Base64-kodierte Repräsentation der Rechnungsinhalte. Dieses Feld muss durch die Applikation der Leistungserbringer:in gefüllt werden.

DocumentReference.content:anhang.attachment.contentType

Zum Zeitpunkt der Veröffentlichung werden nur PDF-Dokumente als Rechnungsanhänge seitens der Leistungserbringer:in unterstützt.

DocumentReference.content:anhang.attachment.data

Base64-kodiertes PDF. Dieses Feld muss durch die Applikation der Leistungserbringer:in gefüllt werden.

DocumentReference.context.related

Der Fachdienst verknüpft alle Rechnungsdokumente mit der Rechnungsempfänger:in.

Beispiele

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceRechnung3-LE" />
    <extension url="http://example.org/StructureDefinition/signatur">
        <valueSignature>
            <type>
                <system value="urn:iso-astm:E1762-95:2013" />
                <code value="1.2.840.10065.1.12.1.1" />
                <display value="Author&#39;s Signature" />
            </type>
            <when value="2015-02-07T13:28:17.239+02:00" />
            <who>
                <display value="Arzt" />
            </who>
        </valueSignature>
    </extension>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="AM010106" />
            <display value="Rechnung ambulante/station&#228;re Behandlung" />
        </coding>
    </type>
    <subject>
        <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10" />
            <value value="A000000000" />
        </identifier>
    </subject>
    <description value="Rechnung Reiseimpfung vom 10.01.2024" />
    <content>
        <attachment>
            <contentType value="application/pdf" />
            <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00" />
        </attachment>
    </content>
    <content>
        <attachment>
            <contentType value="application/xml" />
            <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
        </attachment>
        <format>
            <code value="xrechnung" />
        </format>
    </content>
    <content>
        <attachment>
            <contentType value="application/fhir+xml" />
            <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
        </attachment>
        <format>
            <code value="gematik-erechnung" />
        </format>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceRechnung3-LE",
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "AM010106",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Rechnung ambulante/stationäre Behandlung"
            }
        ]
    },
    "description": "Rechnung Reiseimpfung vom 10.01.2024",
    "subject": {
        "identifier": {
            "system": "http://fhir.de/sid/gkv/kvid-10",
            "value": "A000000000"
        }
    },
    "content":  [
        {
            "attachment": {
                "contentType": "application/pdf",
                "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00"
            }
        },
        {
            "format": {
                "code": "xrechnung"
            },
            "attachment": {
                "contentType": "application/xml",
                "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
            }
        },
        {
            "format": {
                "code": "gematik-erechnung"
            },
            "attachment": {
                "contentType": "application/fhir+xml",
                "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
            }
        }
    ],
    "extension":  [
        {
            "url": "http://example.org/StructureDefinition/signatur",
            "valueSignature": {
                "type":  [
                    {
                        "code": "1.2.840.10065.1.12.1.1",
                        "system": "urn:iso-astm:E1762-95:2013",
                        "display": "Author's Signature"
                    }
                ],
                "when": "2015-02-07T13:28:17.239+02:00",
                "who": {
                    "display": "Arzt"
                }
            }
        }
    ]
}
HTTP POST [fachdienst-endpunkt]/Patient/[id-des-ermittelten-Rechnungsempfängers]/$submit
Parameters
<Parameters xmlns="http://hl7.org/fhir">
    <id value="BeispielParameterSubmitInput3-LE" />
    <parameter>
        <name value="rechnung" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceRechnung3-LE" />
                <extension url="http://example.org/StructureDefinition/signatur">
                    <valueSignature>
                        <type>
                            <system value="urn:iso-astm:E1762-95:2013" />
                            <code value="1.2.840.10065.1.12.1.1" />
                            <display value="Author&#39;s Signature" />
                        </type>
                        <when value="2015-02-07T13:28:17.239+02:00" />
                        <who>
                            <display value="Arzt" />
                        </who>
                    </valueSignature>
                </extension>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="AM010106" />
                        <display value="Rechnung ambulante/station&#228;re Behandlung" />
                    </coding>
                </type>
                <subject>
                    <identifier>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="A000000000" />
                    </identifier>
                </subject>
                <description value="Rechnung Reiseimpfung vom 10.01.2024" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00" />
                    </attachment>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/xml" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
                    </attachment>
                    <format>
                        <code value="xrechnung" />
                    </format>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/fhir+xml" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00" />
                    </attachment>
                    <format>
                        <code value="gematik-erechnung" />
                    </format>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
    <parameter>
        <name value="anhang" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceSonstigesDokument3-LE" />
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="PT130102" />
                        <display value="Molekularpathologiebefund" />
                    </coding>
                </type>
                <subject>
                    <reference value="Patient/BeispielPatient3-FD" />
                </subject>
                <description value="Molekularpathologiebefund vom 31.12.21" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <data value="DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00" />
                    </attachment>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
</Parameters>
{
    "resourceType": "Parameters",
    "id": "BeispielParameterSubmitInput3-LE",
    "parameter":  [
        {
            "name": "rechnung",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceRechnung3-LE",
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "AM010106",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Rechnung ambulante/stationäre Behandlung"
                        }
                    ]
                },
                "description": "Rechnung Reiseimpfung vom 10.01.2024",
                "subject": {
                    "identifier": {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00"
                        }
                    },
                    {
                        "format": {
                            "code": "xrechnung"
                        },
                        "attachment": {
                            "contentType": "application/xml",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
                        }
                    },
                    {
                        "format": {
                            "code": "gematik-erechnung"
                        },
                        "attachment": {
                            "contentType": "application/fhir+xml",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESXML00"
                        }
                    }
                ],
                "extension":  [
                    {
                        "url": "http://example.org/StructureDefinition/signatur",
                        "valueSignature": {
                            "type":  [
                                {
                                    "code": "1.2.840.10065.1.12.1.1",
                                    "system": "urn:iso-astm:E1762-95:2013",
                                    "display": "Author's Signature"
                                }
                            ],
                            "when": "2015-02-07T13:28:17.239+02:00",
                            "who": {
                                "display": "Arzt"
                            }
                        }
                    }
                ]
            }
        },
        {
            "name": "anhang",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceSonstigesDokument3-LE",
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "PT130102",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Molekularpathologiebefund"
                        }
                    ]
                },
                "description": "Molekularpathologiebefund vom 31.12.21",
                "subject": {
                    "reference": "Patient/BeispielPatient3-FD"
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "data": "DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00"
                        }
                    }
                ]
            }
        }
    ]
}

Antwort des Fachdienstes im Erfolgsfall:

Rückgabe von Rechung und Anhang jeweils mit aufgebrachtem Token und separiertem Inhalt. Bei Verwendung des Parameters "returnTokenPDF" werden die Binaries mit den PDF/A-Dokumenten (incl. Token-Barcode) als Parameter direkt mit ausgegeben.

HTTP 200 OK

mit Body:

Parameters
<Parameters xmlns="http://hl7.org/fhir">
    <id value="BeispielParameterSubmitOutput3-FD" />
    <parameter>
        <name value="rechnung" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceRechnung3-FD" />
                <identifier>
                    <system value="https://gematik.de/fhir/sid/erg-token" />
                    <value value="123-456-789" />
                </identifier>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="AM010106" />
                        <display value="Rechnung ambulante/station&#228;re Behandlung" />
                    </coding>
                </type>
                <subject>
                    <identifier>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="A000000000" />
                    </identifier>
                </subject>
                <relatesTo>
                    <code value="transforms" />
                    <target>
                        <reference value="DocumentReference/BeispielDocumentReferenceRechnung3-LE" />
                    </target>
                </relatesTo>
                <description value="Rechnung Reiseimpfung vom 10.01.2024" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <url value="[FD-endpunkt]/Binary/pdf-mit-token-barcode" />
                    </attachment>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/xml" />
                        <url value="[FD-endpunkt]/Binary/xrechnung" />
                    </attachment>
                    <format>
                        <code value="xrechnung" />
                    </format>
                </content>
                <content>
                    <attachment>
                        <contentType value="application/fhir+xml" />
                        <url value="[FD-endpunkt]/Binary/invoice" />
                    </attachment>
                    <format>
                        <code value="gematik-erechnung" />
                    </format>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
    <parameter>
        <name value="anhang" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceSonstigesDokument3-FD" />
                <identifier>
                    <system value="https://gematik.de/fhir/sid/erg-token" />
                    <value value="987-654-321" />
                </identifier>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="PT130102" />
                        <display value="Molekularpathologiebefund" />
                    </coding>
                </type>
                <subject>
                    <reference value="Patient/BeispielPatient3-FD" />
                </subject>
                <relatesTo>
                    <code value="transforms" />
                    <target>
                        <reference value="DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE" />
                    </target>
                </relatesTo>
                <description value="Molekularpathologiebefund vom 31.12.21" />
                <content>
                    <attachment>
                        <contentType value="application/pdf" />
                        <url value="[FD-endpunkt]/Binary/patho-mit-token-barcode" />
                    </attachment>
                </content>
            </DocumentReference>
        </resource>
    </parameter>
</Parameters>
{
    "resourceType": "Parameters",
    "id": "BeispielParameterSubmitOutput3-FD",
    "parameter":  [
        {
            "name": "rechnung",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceRechnung3-FD",
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/erg-token",
                        "value": "123-456-789"
                    }
                ],
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "AM010106",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Rechnung ambulante/stationäre Behandlung"
                        }
                    ]
                },
                "description": "Rechnung Reiseimpfung vom 10.01.2024",
                "subject": {
                    "identifier": {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "url": "[FD-endpunkt]/Binary/pdf-mit-token-barcode"
                        }
                    },
                    {
                        "format": {
                            "code": "xrechnung"
                        },
                        "attachment": {
                            "contentType": "application/xml",
                            "url": "[FD-endpunkt]/Binary/xrechnung"
                        }
                    },
                    {
                        "format": {
                            "code": "gematik-erechnung"
                        },
                        "attachment": {
                            "contentType": "application/fhir+xml",
                            "url": "[FD-endpunkt]/Binary/invoice"
                        }
                    }
                ],
                "relatesTo":  [
                    {
                        "code": "transforms",
                        "target": {
                            "reference": "DocumentReference/BeispielDocumentReferenceRechnung3-LE"
                        }
                    }
                ]
            }
        },
        {
            "name": "anhang",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceSonstigesDokument3-FD",
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/erg-token",
                        "value": "987-654-321"
                    }
                ],
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "PT130102",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Molekularpathologiebefund"
                        }
                    ]
                },
                "description": "Molekularpathologiebefund vom 31.12.21",
                "subject": {
                    "reference": "Patient/BeispielPatient3-FD"
                },
                "content":  [
                    {
                        "attachment": {
                            "contentType": "application/pdf",
                            "url": "[FD-endpunkt]/Binary/patho-mit-token-barcode"
                        }
                    }
                ],
                "relatesTo":  [
                    {
                        "code": "transforms",
                        "target": {
                            "reference": "DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE"
                        }
                    }
                ]
            }
        }
    ]
}

Verarbeitungsschritte im FD

Bei der Entgegennahme der Dokumente MÜSSEN durch den FD die nachfolgenden Schritte durchgeführt werden. Es ist zu beachten, dass dies asynchron durchgeführt werden kann durch den FD. Lediglich MUSS der FD sicherstellen, dass dieser Prozess vor dem Abruf der Dokumente durch das eRg FdV oder dem RE-PS abgearbeitet wurde.

  • DocumentReference.attachment.data muss aus der übermittelten DocumentReference herausgelöst werden. Der Inhalt MUSS in einer durch den FD neu angelegten Binary-Ressource gespeichert werden. Die Binary-Ressource MUSS unter attachment.url mit einer absoluten URL referenziert werden. DocumentReference.attachment.data ist anschließend zu löschen. Dies gilt für alle durch den Client übermittelte Dokumente.

  • Die originale Rechnung (DocumentReference.type = KDL#AM010106) MUSS angereichert werden mit den strukturierten Rechnungsinhalten. Der FD MUSS die Inhalte strukturiert im FHIR-Format innerhalb eines PDF/A einbetten.

  • Das neu erzeugte PDF/A muss als Binary nach den Vorgaben von DocumentReference.content:angereicherteRechnung aus dem oben aufgeführten Profil hinterlegt werden.

  • Für jedes PDF/A-Dokument MUSS der FD ein Token unter Einhaltung einer ausreichenden Entropie erstellen. Der FD MUSS zusätzlich einen Barcode auf dem Rechnungs- oder Anhangdokument unterbringen welcher das Dokumententoken kodiert enthält. Die Lesbarkeit der Inhalte des Dokumtes darf hierdurch nicht eingeschränkt werden. Die Zugehörigkeit eines Tokens zu einem Dokument MUSS gespeichert werden, um den Abruf eines Dokumentes mit diesem Token zu ermöglichen.

  • DocumentReference.context.related MUSS durch den FD auf die ID des ermittelten Rechnungsempfängers gesetzt werden.

  • DocumentReference.author.identifier MUSS durch den FD auf die im Access-Token enthaltene Telematik-ID gesetzt werden. Durch den Client übermittelte Angaben in DocumentReference.author sind zu überschreiben.

  • Hinweis: In der FHIR-Repräsentation erfolgt keine Differenzierung zwischen dem Datenobjekt für die Rechnungsdokumente und dem Rechnungsworkflow. Der Workflowstatus wird somit innerhalb der DocumentReference abgebildet. DocumentReference.meta.tag:erg-rechnungsstatus MUSS durch den FD auf "Offen" gesetzt werden beim Empfang der Rechnung.

Hinweise zur Abbildung des Workflow-Objektes (fachliches Datenmodell)

Im fachlichen Datenmodell des Feature-Dokuments E-Rechnung ist dargestellt, dass jede Rechnung,sowie jedes ergänzende Dokument mit einem Rechnungsworkflow-Objekt verbunden ist. Dieses Workflow-Objekt bündelt das Rechnungsdokument sowie die Anhänge zusammen und gibt diesen Dokumenten einen gemeinsamen Status. Zur Vereinfachung der Implementierung seitens des FD und des eRg FDV wird in der FHIR-Repräsentation kein weiteres Datenobjekt hierfür verwendet. Hingegen enthält das Profil 'ERGDokumentenmetadaten' eine Extension 'erg-rechnungsstatus' für diesen Zweck. Der Status zusammenhängender Dokumente MUSS stets synchron gehalten werden. Diese Extension gilt für das Rechnungsdokument sowie alle Anhänge, die innerhalb einer Submit-Operation im gleichen Kontext übermittelt worden sind wie die Rechnung. Der FD MUSS den Zusammenhang zwischen diesen Dokumenten in der Verarbeitungslogik vorhalten.

Beispiele

Beispiel: Rechnungsdokument nach Verarbeitung auf Server

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceRechnung3-FD" />
    <identifier>
        <system value="https://gematik.de/fhir/sid/erg-token" />
        <value value="123-456-789" />
    </identifier>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="AM010106" />
            <display value="Rechnung ambulante/station&#228;re Behandlung" />
        </coding>
    </type>
    <subject>
        <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10" />
            <value value="A000000000" />
        </identifier>
    </subject>
    <relatesTo>
        <code value="transforms" />
        <target>
            <reference value="DocumentReference/BeispielDocumentReferenceRechnung3-LE" />
        </target>
    </relatesTo>
    <description value="Rechnung Reiseimpfung vom 10.01.2024" />
    <content>
        <attachment>
            <contentType value="application/pdf" />
            <url value="[FD-endpunkt]/Binary/pdf-mit-token-barcode" />
        </attachment>
    </content>
    <content>
        <attachment>
            <contentType value="application/xml" />
            <url value="[FD-endpunkt]/Binary/xrechnung" />
        </attachment>
        <format>
            <code value="xrechnung" />
        </format>
    </content>
    <content>
        <attachment>
            <contentType value="application/fhir+xml" />
            <url value="[FD-endpunkt]/Binary/invoice" />
        </attachment>
        <format>
            <code value="gematik-erechnung" />
        </format>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceRechnung3-FD",
    "identifier":  [
        {
            "system": "https://gematik.de/fhir/sid/erg-token",
            "value": "123-456-789"
        }
    ],
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "AM010106",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Rechnung ambulante/stationäre Behandlung"
            }
        ]
    },
    "description": "Rechnung Reiseimpfung vom 10.01.2024",
    "subject": {
        "identifier": {
            "system": "http://fhir.de/sid/gkv/kvid-10",
            "value": "A000000000"
        }
    },
    "content":  [
        {
            "attachment": {
                "contentType": "application/pdf",
                "url": "[FD-endpunkt]/Binary/pdf-mit-token-barcode"
            }
        },
        {
            "format": {
                "code": "xrechnung"
            },
            "attachment": {
                "contentType": "application/xml",
                "url": "[FD-endpunkt]/Binary/xrechnung"
            }
        },
        {
            "format": {
                "code": "gematik-erechnung"
            },
            "attachment": {
                "contentType": "application/fhir+xml",
                "url": "[FD-endpunkt]/Binary/invoice"
            }
        }
    ],
    "relatesTo":  [
        {
            "code": "transforms",
            "target": {
                "reference": "DocumentReference/BeispielDocumentReferenceRechnung3-LE"
            }
        }
    ]
}

Beispiel: sonstiges Dokument nach Verarbeitung auf Server

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceSonstigesDokument3-FD" />
    <identifier>
        <system value="https://gematik.de/fhir/sid/erg-token" />
        <value value="987-654-321" />
    </identifier>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="PT130102" />
            <display value="Molekularpathologiebefund" />
        </coding>
    </type>
    <subject>
        <reference value="Patient/BeispielPatient3-FD" />
    </subject>
    <relatesTo>
        <code value="transforms" />
        <target>
            <reference value="DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE" />
        </target>
    </relatesTo>
    <description value="Molekularpathologiebefund vom 31.12.21" />
    <content>
        <attachment>
            <contentType value="application/pdf" />
            <url value="[FD-endpunkt]/Binary/patho-mit-token-barcode" />
        </attachment>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceSonstigesDokument3-FD",
    "identifier":  [
        {
            "system": "https://gematik.de/fhir/sid/erg-token",
            "value": "987-654-321"
        }
    ],
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "PT130102",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Molekularpathologiebefund"
            }
        ]
    },
    "description": "Molekularpathologiebefund vom 31.12.21",
    "subject": {
        "reference": "Patient/BeispielPatient3-FD"
    },
    "content":  [
        {
            "attachment": {
                "contentType": "application/pdf",
                "url": "[FD-endpunkt]/Binary/patho-mit-token-barcode"
            }
        }
    ],
    "relatesTo":  [
        {
            "code": "transforms",
            "target": {
                "reference": "DocumentReference/BeispielDocumentReferenceSonstigesDokument3-LE"
            }
        }
    ]
}

R3: Abfrage von angereicherten PDF/A per Token (Rechnungsersteller)

Die nachfolgende Interaktion ist relevant für den FD als Server, sowie für das RE-PS als Client. Anwendungsfall AF_10271 MUSS durch den FD über die spezifizierte API umgesetzt werden. Die Vorgaben aus "Tabelle 17: Use Case Abfrage von angereicherten PDF/A per Token (Rechnungsersteller)" des Feature-Dokumentes MÜSSEN eingehalten werden durch den FD.

HTTP-Methode POST oder GET
Endpunkt /DocumentReference/$retrieve

Die Input- und Output-Parameter werden durch die OperationDefinition https://gematik.de/fhir/erg/OperationDefinition/Retrieve beschrieben.

Invocations

URL: [base]/DocumentReference/$retrieve

This operation does NOT change content

Parameters (In)

NameCardinalityTypeDocumentation
token1..1string

Dokumentoken zur Identifikation des Dokuments, welches abgerufen werden soll

strukturierterRechnungsinhalt0..1boolean

Angabe, ob die strukturierten Rechnungsinhalte neben dem angereicherten Rechnungsdokument zurückgegeben werden sollen als 'content'-Element. Default: false

originaleRechnung0..1boolean

Angabe ob die originale Rechnung inkl. Signatur neben dem angereicherten Rechnungsdokument zurückgegeben werden soll als 'content'-Element. Default: false. Die originale Rechnung ist nur vom FdV an das ITSys-KTR direkt weiterzugeben. Falls das Rechnungsdokument ausgedruckt werden sollte durch immer das angereicherte PDF inkl. Barcode zu verwenden.

Return Values (Out)

NameCardinalityTypeDocumentation
dokument1..1DocumentReference

DocumentReference-Ressource die das angefragte Rechnungsdokument, sowie die strukturierten Rechnungsinhalte enthält (in Abhängigkeit vom strukturierterRechnungsinhalt- und originaleRechnung-Parameter).

API-Zustand HTTP-Status-Code
Erfolgsfall 200 - OK
Weitere Parameter in HTTP-Anfrage enthalten 400 - Bad Request
Syntax für Parameter ist nicht korrekt oder Kardinalitäten werden nicht eingehalten 400 - Bad Request
Kein valides Access-Token wird mitgesendet 401 - Unauthorized
Autorisierter Benutzer verfügt über keine ausreichende Berechtigung die Interaktion auszuführen 403 - Forbidden
Fehlende Berechtigung für den Leistungserbringer das Dokument abzurufen (z.B. falls ein invalides Rechnungstoken verwendet wird) 404 - Not Found
Dokumnent kann anhand des Rechnungstokens nicht gefunden werden 404 - Not Found
Andere HTTP-Methode wird verwendet 405 - Method Not Allowed

Anhand des übermittelten Dokumententokens MUSS der FD die entsprechende DocumentReference suchen. Das originale Rechnungsdokument MUSS durch den FD unter DocumentReference.content:rechnungspdf ausgeblendet werden. Dies gilt ebenfalls für die Signatur-Extension.

Die DocumentReference-Ressource KANN direkt an den Client zurückgegeben werden ohne, dass diese in eine Parameter-Ressource eingebettet wird.

Das Abrufen eines Rechnungsdokumentes durch ein RE-PS hat keine Auswirkungen auf den Rechnungsstatus (DocumentReference.meta.tag:ergpkv-status) des Dokumentes.

Beispiele

HTTP GET [fachdienst-endpunkt]/DocumentReference/$retrieve
Parameters
<Parameters xmlns="http://hl7.org/fhir">
    <id value="BeispielParameterRetrieveInput" />
    <parameter>
        <name value="token" />
        <valueString value="123-456-789" />
    </parameter>
    <parameter>
        <name value="strukturierterRechnungsinhalt" />
        <valueBoolean value="false" />
    </parameter>
    <parameter>
        <name value="originaleRechnung" />
        <valueBoolean value="false" />
    </parameter>
</Parameters>
{
    "resourceType": "Parameters",
    "id": "BeispielParameterRetrieveInput",
    "parameter":  [
        {
            "name": "token",
            "valueString": "123-456-789"
        },
        {
            "name": "strukturierterRechnungsinhalt",
            "valueBoolean": false
        },
        {
            "name": "originaleRechnung",
            "valueBoolean": false
        }
    ]
}

Antwort des Fachdienstes im Erfolgsfall:

HTTP 200 OK

mit Body:

DocumentReference
<DocumentReference xmlns="http://hl7.org/fhir">
    <id value="BeispielDocumentReferenceRechnungRetrieve" />
    <identifier>
        <system value="https://gematik.de/fhir/sid/erg-token" />
        <value value="123-456-789" />
    </identifier>
    <status value="current" />
    <type>
        <coding>
            <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
            <code value="AM010106" />
            <display value="Rechnung ambulante/station&#228;re Behandlung" />
        </coding>
    </type>
    <subject>
        <identifier>
            <system value="http://fhir.de/sid/gkv/kvid-10" />
            <value value="A000000000" />
        </identifier>
    </subject>
    <description value="Rechnung Reiseimpfung vom 10.01.2024" />
    <content>
        <attachment>
            <contentType value="application/xml" />
            <url value="[FD-endpunkt]/Binary/xrechnung" />
        </attachment>
        <format>
            <code value="xrechnung" />
        </format>
    </content>
</DocumentReference>
{
    "resourceType": "DocumentReference",
    "id": "BeispielDocumentReferenceRechnungRetrieve",
    "identifier":  [
        {
            "system": "https://gematik.de/fhir/sid/erg-token",
            "value": "123-456-789"
        }
    ],
    "status": "current",
    "type": {
        "coding":  [
            {
                "code": "AM010106",
                "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                "display": "Rechnung ambulante/stationäre Behandlung"
            }
        ]
    },
    "description": "Rechnung Reiseimpfung vom 10.01.2024",
    "subject": {
        "identifier": {
            "system": "http://fhir.de/sid/gkv/kvid-10",
            "value": "A000000000"
        }
    },
    "content":  [
        {
            "format": {
                "code": "xrechnung"
            },
            "attachment": {
                "contentType": "application/xml",
                "url": "[FD-endpunkt]/Binary/xrechnung"
            }
        }
    ]
}

Verarbeitungsschritte im FD

  • Der FD MUSS aus dem Access-Token die Telematik-ID extrahieren falls es sich bei dem anfragenden System um ein RE-PS handelt. Der FD MUSS sicherstellen, dass nur DocumentReference-Ressourcen abgerufen werden können in denen DocumentReference.author.identifier auf die zugehörige Telematik-ID verweist.

  • Der FD MUSS sicherstellen, dass bei einer Abfrage einer Binary-Ressource welche unter DocumentReference.content.attachment.url referenziert wird nur erfolgen kann, wenn ein valides Access-Token mitgeliefert wird und das Binary in einer DocumentReference referenziert wird in der DocumentReference.author.identifier identisch ist mit der Telematik-ID aus dem Access-Token.

  • Es gelten die Festlegungen der FHIR-Kernspezifikation zur Handhabung von Binary-Ressourcen.


R4: Abfrage von angereicherten PDF/A per Token (Rechnungsersteller) (Bulk)

Die nachfolgende Interaktion ist relevant für den FD als Server, sowie für das RE-PS als Client. Anwendungsfall AF_10271 MUSS durch den FD über die spezifizierte API umgesetzt werden. Die Vorgaben aus "Tabelle 17: Use Case Abfrage von angereicherten PDF/A per Token (Rechnungsersteller)" des Feature-Dokumentes MÜSSEN eingehalten werden durch den FD.

HTTP-Methode POST
Endpunkt / (Root-Endpunkt)

Für die Ausführung der Operation gelten die gleichen Vorgaben wie aus R1: Rechnung mit Dokumenten validieren und versenden. Die Operation $retrieve kann für innerhalb eines Batch-Bundles mehrfach, auch für unterschiedliche Dokumente aufgerufen werden. Es gelten die entsprechenden Vorgaben aus der FHIR-Kernspezifikation.

Beispiel

HTTP GET [fachdienst-endpunkt]/
Bundle
<Bundle xmlns="http://hl7.org/fhir">
    <id value="BulkRetrieveExampleInput" />
    <type value="transaction" />
    <entry>
        <resource>
            <Parameters>
                <id value="BeispielParameterRetrieveInput" />
                <parameter>
                    <name value="token" />
                    <valueString value="123-456-789" />
                </parameter>
                <parameter>
                    <name value="strukturierterRechnungsinhalt" />
                    <valueBoolean value="false" />
                </parameter>
                <parameter>
                    <name value="originaleRechnung" />
                    <valueBoolean value="false" />
                </parameter>
            </Parameters>
        </resource>
        <request>
            <method value="POST" />
            <url value="$retrieve" />
        </request>
    </entry>
    <entry>
        <resource>
            <Parameters>
                <id value="BeispielParameterRetrieveInput2" />
                <parameter>
                    <name value="token" />
                    <valueString value="123-456-123" />
                </parameter>
            </Parameters>
        </resource>
        <request>
            <method value="POST" />
            <url value="$retrieve" />
        </request>
    </entry>
</Bundle>
{
    "resourceType": "Bundle",
    "id": "BulkRetrieveExampleInput",
    "type": "transaction",
    "entry":  [
        {
            "request": {
                "method": "POST",
                "url": "$retrieve"
            },
            "resource": {
                "resourceType": "Parameters",
                "id": "BeispielParameterRetrieveInput",
                "parameter":  [
                    {
                        "name": "token",
                        "valueString": "123-456-789"
                    },
                    {
                        "name": "strukturierterRechnungsinhalt",
                        "valueBoolean": false
                    },
                    {
                        "name": "originaleRechnung",
                        "valueBoolean": false
                    }
                ]
            }
        },
        {
            "request": {
                "method": "POST",
                "url": "$retrieve"
            },
            "resource": {
                "resourceType": "Parameters",
                "id": "BeispielParameterRetrieveInput2",
                "parameter":  [
                    {
                        "name": "token",
                        "valueString": "123-456-123"
                    }
                ]
            }
        }
    ]
}

Antwort des Fachdienstes im Erfolgsfall:

HTTP 200 OK

mit Body:

Bundle
<Bundle xmlns="http://hl7.org/fhir">
    <id value="BulkRetrieveExampleOutput" />
    <type value="transaction-response" />
    <entry>
        <fullUrl value="[FD-endpunkt]/DocumentReference/BeispielDocumentReferenceRechnungRetrieve" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceRechnungRetrieve" />
                <identifier>
                    <system value="https://gematik.de/fhir/sid/erg-token" />
                    <value value="123-456-789" />
                </identifier>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="AM010106" />
                        <display value="Rechnung ambulante/station&#228;re Behandlung" />
                    </coding>
                </type>
                <subject>
                    <identifier>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="A000000000" />
                    </identifier>
                </subject>
                <description value="Rechnung Reiseimpfung vom 10.01.2024" />
                <content>
                    <attachment>
                        <contentType value="application/xml" />
                        <url value="[FD-endpunkt]/Binary/xrechnung" />
                    </attachment>
                    <format>
                        <code value="xrechnung" />
                    </format>
                </content>
            </DocumentReference>
        </resource>
    </entry>
    <entry>
        <fullUrl value="[FD-endpunkt]/DocumentReference/BeispielDocumentReferenceRechnungRetrieve2" />
        <resource>
            <DocumentReference>
                <id value="BeispielDocumentReferenceRechnungRetrieve2" />
                <identifier>
                    <system value="https://gematik.de/fhir/sid/erg-token" />
                    <value value="123-456-123" />
                </identifier>
                <status value="current" />
                <type>
                    <coding>
                        <system value="http://dvmd.de/fhir/CodeSystem/kdl" />
                        <code value="AM010106" />
                        <display value="Rechnung ambulante/station&#228;re Behandlung" />
                    </coding>
                </type>
                <subject>
                    <identifier>
                        <system value="http://fhir.de/sid/gkv/kvid-10" />
                        <value value="A000000000" />
                    </identifier>
                </subject>
                <description value="Rechnung Reiseimpfung vom 11.01.2024" />
                <content>
                    <attachment>
                        <contentType value="application/xml" />
                        <url value="[FD-endpunkt]/Binary/xrechnung" />
                    </attachment>
                    <format>
                        <code value="xrechnung" />
                    </format>
                </content>
            </DocumentReference>
        </resource>
    </entry>
</Bundle>
{
    "resourceType": "Bundle",
    "id": "BulkRetrieveExampleOutput",
    "type": "transaction-response",
    "entry":  [
        {
            "fullUrl": "[FD-endpunkt]/DocumentReference/BeispielDocumentReferenceRechnungRetrieve",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceRechnungRetrieve",
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/erg-token",
                        "value": "123-456-789"
                    }
                ],
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "AM010106",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Rechnung ambulante/stationäre Behandlung"
                        }
                    ]
                },
                "description": "Rechnung Reiseimpfung vom 10.01.2024",
                "subject": {
                    "identifier": {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                },
                "content":  [
                    {
                        "format": {
                            "code": "xrechnung"
                        },
                        "attachment": {
                            "contentType": "application/xml",
                            "url": "[FD-endpunkt]/Binary/xrechnung"
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "[FD-endpunkt]/DocumentReference/BeispielDocumentReferenceRechnungRetrieve2",
            "resource": {
                "resourceType": "DocumentReference",
                "id": "BeispielDocumentReferenceRechnungRetrieve2",
                "identifier":  [
                    {
                        "system": "https://gematik.de/fhir/sid/erg-token",
                        "value": "123-456-123"
                    }
                ],
                "status": "current",
                "type": {
                    "coding":  [
                        {
                            "code": "AM010106",
                            "system": "http://dvmd.de/fhir/CodeSystem/kdl",
                            "display": "Rechnung ambulante/stationäre Behandlung"
                        }
                    ]
                },
                "description": "Rechnung Reiseimpfung vom 11.01.2024",
                "subject": {
                    "identifier": {
                        "system": "http://fhir.de/sid/gkv/kvid-10",
                        "value": "A000000000"
                    }
                },
                "content":  [
                    {
                        "format": {
                            "code": "xrechnung"
                        },
                        "attachment": {
                            "contentType": "application/xml",
                            "url": "[FD-endpunkt]/Binary/xrechnung"
                        }
                    }
                ]
            }
        }
    ]
}