Meldungspaket hochladen
- Redakteur (Unlicensed)
- Nicolett Linke
Ablage eines Meldungspakets beim empfangenden Register. Akteur ist das sendende Register. Das Datenpaket wird im empfangenden Register unter senderIK + transportid abgelegt. Die transportid wird vom Absender vergeben (dies ist bereits Teil des KKRTransport Formats). Die in der URL angegebene transportid muss dabei mit der im Paket übergebenen transportid übereinstimmen (sonst Fehlercode 422).
Per Konvention sollten RÜD-Pakete nicht mehr als 5000 Patienten enthalten. Größere Datenlieferungen sollten auf mehrere Pakete gesplittet werden, um technische Verarbeitungsprobleme beim Empfänger zu vermeiden.
Pakete dürfen nicht durch erneutes Hochladen mit derselben transportid aktualisiert werden (Fehlercode 403). Stattdessen muss ein neues Paket hochgeladen werden, das im Feld „replacingTransportId" die ID des zu ersetzenden Pakets enthält. Auf diese Weise ist eine Nachvollziehbarkeit über den Ablauf der Datenlieferungen gegeben. Ein Paket kann nur ersetzt werden, wenn es nicht im Zustand ACCEPTED ist.
Operation
HTTP Operation | PUT |
URL | <URL Empfänger>/rd/<API-Version>/packages/<senderIK>/<transportid> |
Body | KKRTransport |
Format | application/xml |
Antwort im Erfolgsfall
Response Code | 200 OK |
Erläuterung | Upload erfolgreich |
Body | KKRTransportMetadata (das soeben angelegte Element) |
Format | application/xml |
Spezifische Fehlerantworten
Response Code | 403 Forbidden |
Erläuterung | Es wurde versucht, ein Datenpaket mit einer bereits verwendeten TransportID erneut hochzuladen. Um ein Paket zu ersetzen, müsste jedoch ein neues Paket übermittelt werden, bei dem die Transport-ID des zu ersetzenden Pakets im Feld replacingTransportId übergeben wird. |
Body | - |
Format | - |
Spezielle Header | X-Cause <Fehlertext> |
Response Code | 422 Unprocessable Entity |
Erläuterung | Die in der URL angegebene transportid stimmt nicht mit der transportid in den übermittelten Daten überein. |
Body | - |
Format | - |
Spezielle Header | X-Cause <Fehlertext> |
Weitere mögliche Antworten: Siehe Allgemeine Fehlerfälle