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.
Asynchrone Verarbeitung
Diese Interaktion ist aufgrund potenziell großer Datenmengen asynchron vom FD auszuführen.
Dies MUSS der Client mittels eines Prefer: respond-async-Headers nach RFC7240 dem FD signalisieren.
| API-Zustand | HTTP-Status-Code |
|---|---|
| Erfolgsfall | 202 - Accepted |
| 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 |
In einem Location-Header MUSS der FD dem RE-PS eine absolute URL mitteilen unter welcher das RE-PS per Polling prüfen kann, ob die Interaktion abgeschlossen wurde und entsprechende Rückgabewerte seitens der $retrieve-Operation vorliegen. Der Aufbau der Location-URL MUSS aus kryptografisch zufälligen Teilen bestehen, sodass der Aufbau nicht deterministisch ermittelt oder erraten werden kann. Der Server SOLLTE RE-PS-Clients mit einem HTTP-Status-Code 429 Too Many Requests abweisen, falls nach dem Ermessen des FDs die Location-URL zu häufig geprüft wird. Der FD SOLLTE einen Retry-After-Header entsprechend den Vorgaben aus der FHIR-Kernspezifikation verwenden.
Nach der Verarbeitung des batch-Bundles MUSS der FD das batch-response-Bundle unter der Location-URL bereitstellen, welches die Ergebnisse entsprechnd der Verarbeitung der einzelnen Dokumente nach AF_10271 enthält. Es ist zu beachten, dass der FD die Autorisierung für jedes Dokument gemäß den Vorgaben zu AF_10271 individuell prüfen MUSS. Der FD MUSS sicherstellen, dass das batch-response-Bundle nur einem validen Access-Token abgerufen werden kann.
Beispiel
HTTP POST [fachdienst-endpunkt]/
| Bundle |
| id : BulkRetrieveExampleInput |
| type : batch |
| entry |
| resource |
| id : BeispielParameterRetrieveInput |
| parameter |
| name : token |
| value : 123-456-789 |
| parameter |
| name : strukturierterRechnungsinhalt |
| value : False |
| parameter |
| name : originaleRechnung |
| value : False |
| request |
| method : POST |
| url : $retrieve |
| entry |
| resource |
| id : BeispielParameterRetrieveInput2 |
| parameter |
| name : token |
| value : 123-456-123 |
| request |
| method : POST |
| url : $retrieve |
Antwort des Fachdienstes nach der Verarbeitung des batch-Bundles:
HTTP 200 OK
mit Body:
| Bundle |
| id : BulkRetrieveExampleOutput |
| type : batch-response |
| entry |
| fullUrl : [FD-endpunkt]/DocumentReference/BeispielDocumentReferenceRechnungRetrieve |
| resource |
| id : BeispielDocumentReferenceRechnungRetrieve |
| identifier |
| system : https://gematik.de/fhir/sid/dipag-token |
| value : 123-456-789 |
| status : current |
| type |
| coding |
| system : http://dvmd.de/fhir/CodeSystem/kdl |
| code : AM010106 |
| display : Rechnung ambulante/stationäre Behandlung |
| subject |
| identifier |
| system : http://fhir.de/sid/gkv/kvid-10 |
| value : A000000000 |
| description : Rechnung Reiseimpfung vom 10.01.2024 |
| content |
| attachment |
| contentType : application/xml |
| url : [FD-endpunkt]/Binary/xrechnung |
| format |
| code : xrechnung |
| entry |
| fullUrl : [FD-endpunkt]/DocumentReference/BeispielDocumentReferenceRechnungRetrieve2 |
| resource |
| id : BeispielDocumentReferenceRechnungRetrieve2 |
| identifier |
| system : https://gematik.de/fhir/sid/dipag-token |
| value : 123-456-123 |
| status : current |
| type |
| coding |
| system : http://dvmd.de/fhir/CodeSystem/kdl |
| code : AM010106 |
| display : Rechnung ambulante/stationäre Behandlung |
| subject |
| identifier |
| system : http://fhir.de/sid/gkv/kvid-10 |
| value : A000000000 |
| description : Rechnung Reiseimpfung vom 11.01.2024 |
| content |
| attachment |
| contentType : application/xml |
| url : [FD-endpunkt]/Binary/xrechnung |
| format |
| code : xrechnung |