R5: Abruf von Rechnungen (Rechnungsempfänger)
Die nachfolgende Interaktion ist relevant für den FD als Server, sowie für das DiPag FdV als Client. Anwendungsfall AF_10138 MUSS durch den FD über die spezifizierte API umgesetzt werden. Die Vorgaben aus "Tabelle 18: Use Case Abruf von Rechnungen (Rechnungsempfänger)" des Feature-Dokumentes MÜSSEN eingehalten werden durch den FD.
| HTTP-Methode | GET |
| Endpunkt | /DocumentReference |
Suchparameter _tag |
Kardinalität: 0..1 Rechnungsstatus Type: token Der FD MUSS den Modifier :not unterstützen. |
Suchparameter subject:text |
Kardinalität: 0..1 Name Rechnungsempfänger/Behandelte Person Type: string Der Suchparameter MUSS durch den Client mit dem Modifier :text verwendet werden. Dieser Suchmodifier ermöglicht eine Suche auf DocumentReference.subject.display. |
Suchparameter author:text |
Kardinalität: 0..1 Name des Leistungserbringer Type: string Der Suchparameter MUSS durch den Client mit dem Modifier :text verwendet werden. Dieser Suchmodifier ermöglicht eine Suche auf DocumentReference.author.display. |
Suchparameter type |
Kardinalität: 0..1 Dokumententyp (z.B. Rechnung) Type: token Der FD MUSS den Modifier :not unterstützen. |
Suchparameter dipag-makierung |
Kardinalität: 0..1 Manuelle Markierungen Type: token |
Suchresultatparameter _sort |
Als Sortierkriterien können die oben genannten Suchparameter inkl. Custom SearchParameter verwendet werden für die Inhalte die als Sortierkriterien in Tabelle 18: Use Case Abruf von Rechnungen (Rechnungsempfänger) - Feature-Dokument Digitale Patientenrechnung genannt sind |
Suchresultatparameter _count |
Durch den Client gewünschte Page-Size, der FD KANN Vorgaben für die Maximale Page-Size definieren |
User-Kontext KVNR |
Kardinalität: 1..1 Hinweis: Die KVNR ist aus dem Claim urn:telematik:claims:id 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 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 |
| Andere HTTP-Methode wird verwendet | 405 - Method Not Allowed |
Als Antwort MUSS der FD ein FHIR-SearchSet-Bundle zurückliefern, welches eingegrenzt ist auf die, durch den Client übermittelten Suchparameter.
Beispiele
Suche anhand der Art des Dokumentes (nur Rechnungen):
HTTP GET [fachdienst-endpunkt]/DocumentReference?type=ABRE
und/oder anhand des Status
HTTP GET [fachdienst-endpunkt]/DocumentReference?_tag=offen
HTTP GET [fachdienst-endpunkt]/DocumentReference?_tag:not=papierkorb
Antwort des Endpunktes im Erfolgsfall:
HTTP 200 OK
mit Body:
| Bundle |
| id : ExampleR5Bundle |
| type : searchset |
| total : 1 |
| entry |
| resource |
| id : ExampleR5DocumentReference |
| meta |
| profile : https://gematik.de/fhir/dipag/StructureDefinition/dipag-dokumentenmetadaten |
| tag |
| system : https://gematik.de/fhir/dipag/CodeSystem/dipag-rechnungsstatus-cs |
| code : offen |
| display : Offen |
| extension |
| url : https://gematik.de/fhir/dipag/StructureDefinition/dipag-documentreference-rechnungsdatum |
| value : 2023-09-28T13:00:00.123+02:00 |
| extension |
| url : https://gematik.de/fhir/dipag/StructureDefinition/dipag-documentreference-zahlungszieldatum |
| value : 2023-10-28T13:00:00.123+02:00 |
| extension |
| url : https://gematik.de/fhir/dipag/StructureDefinition/dipag-documentreference-gesamtbetrag |
| value |
| value : 16.2 |
| currency : EUR |
| identifier |
| system : http://example.com/fhir/identifiers |
| value : 123456789 |
| status : current |
| type |
| coding |
| system : http://dvmd.de/fhir/CodeSystem/kdl |
| code : AM010106 |
| display : Rechnung ambulante/stationäre Behandlung |
| subject |
| display : Max Mustermann |
| author |
| identifier |
| system : https://gematik.de/fhir/sid/telematik-id |
| value : 987654321 |
| display : Dr. Hausarzt |
| description : Laborbefund vom 28.9.2023 |
| content |
| attachment |
| contentType : application/pdf |
| data : DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00 |
| url : http://example.com/fhir/binary/123 |
| format |
| system : https://gematik.de/fhir/dipag/CodeSystem/dipag-attachment-format-cs |
| code : dipag |
| content |
| attachment |
| contentType : application/pdf |
| url : http://example.com/fhir/binary/456 |
| format |
| system : https://gematik.de/fhir/dipag/CodeSystem/dipag-attachment-format-cs |
| code : angereichertesPDF |
| content |
| attachment |
| contentType : application/json |
| data : DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00 |
| url : http://example.com/fhir/binary/789 |
| format |
| system : https://gematik.de/fhir/dipag/CodeSystem/dipag-attachment-format-cs |
| code : rechnungsinhalt |
| content |
| attachment |
| contentType : application/pdf |
| data : DIESISTNUREINBEISPIELDIESISTKEINVALIDESPDF00 |
| url : http://example.com/fhir/binary/101112 |
| format |
| system : https://gematik.de/fhir/dipag/CodeSystem/dipag-attachment-format-cs |
| code : rechnungsanhang |
| search |
| mode : match |
Verarbeitungsschritte im FD
Der FD MUSS die Suche auf DocumentReference-Ressourcen begrenzen die unter DocumentReference.related auf einen Benutzer verweisen welcher durch die KVNR aus dem Access-Token identifiziert wird, um sicherzustellen, dass nur DocumentReference-Ressourcen aus dem Postfach des angemeldeten Rechnungsempfängers zurückgegeben werden.
Der FD MUSS die Signatur-Extension (DocumentReference.extension:docRef-signature) vor der Rückgabe an den Client entfernen.
Falls es sich bei der DocumentReference um ein Rechnungsdokument handelt, MUSS der FD das Content-Element für das Rechnungspdf entfernen, sodass nur die Content-Elemente für das angereicherte PDF/A, sowie die strukturierten Rechnungsinhalte zurückgegeben werden.
Der FD MUSS sicherstellen, dass die Abfrage einer Binary-Ressource, welche unter
DocumentReference.content.attachment.urlreferenziert wird, nur erfolgen kann, wenn:- ein valides Access-Token mitgeliefert wird UND
DocumentReference.subjectzeigt auf einen Benutzeraccount mit einer KVNR, die identisch ist mit der KVNR aus dem Access-Token.
Es gelten die Festlegungen der FHIR-Kernspezifikation zur Handhabung von Binary-Ressourcen.
Der FD MUSS unter DocumentReference.context.related:anhaenge Referenzen auf alle Anhänge zurückgeben die im Kontext der initialen Einreichung (vgl. R1: Rechnung mit Dokumenten validieren und versenden) übergeben wurden an den FD. Die Anhänge MÜSSEN als DocumentReference-Ressourcen im SearchResult-Bundle zurückgegeben werden mit einem Hinweis, dass diese zusätzlich inkludiert wurden (Bundle.entry.search.mode = include).