Ereignisse
Das folgende Statusdiagramm zeigt die Status und Ereignisse einer Einreichung. Die Status sind als orange Ovale dargestellt. Rechtecke stehen für Ereignisse. Blau dargestellte Ereignisse werden vom Zustelldienst, grüne vom empfangenden System erstellt und signiert.
Statusdiagramm
Einreichung
Antwort
Legende
Das Akzeptieren oder Zurückweisen von Einreichungen findet auf einer rein technischen Ebene statt und trifft keine Aussage über die fachliche Korrektheit der Einreichungen. Gründe für technische Rückweisungen wären beispielsweise Probleme bei der Entschlüsselung oder Validierungsfehler der Datenstrukturen.
Übersicht über zulässige Ereignisse (events
)
In der folgenden Tabelle sind die möglichen Ereignisse, ihre Beschreibungen und die Autoren aufgeführt und beschrieben.
Event | Autor | Bedeutung |
---|---|---|
https://schema.fitko.de/fit-connect/events/create-submission ↓ | Zustelldienst | Die Einreichung wurde durch den Sender angelegt. |
https://schema.fitko.de/fit-connect/events/submit-submission ↓ | Zustelldienst | Die Einreichung wurde durch den Sender abgesendet. |
https://schema.fitko.de/fit-connect/events/notify-submission ↓ | Zustelldienst | Der Subscriber hat Kenntnis von der Einreichung erlangt (der Subscriber wurde per Callback informiert oder hat die Liste der verfügbaren Submissions abgerufen). |
https://schema.fitko.de/fit-connect/events/forward-submission ↓ | Empfangendes System | Ein nachgelagertes System hat die Einreichung zur Weiterleitung übernommen. |
https://schema.fitko.de/fit-connect/events/reject-submission ↓ | Empfangendes System/Zustelldienst | Die Einreichung wurde durch den Empfänger zurückgewiesen oder die Einreichung war mehr als 14 Tage im Status submitted und wurde deshalb vom Zustelldienst zurückgewiesen. |
https://schema.fitko.de/fit-connect/events/accept-submission ↓ | Empfangendes System | Die Einreichung wurde durch den Empfänger akzeptiert. |
https://schema.fitko.de/fit-connect/events/delete-submission ↓ | Zustelldienst | Die Einreichung wurde durch den Zustelldienst gelöscht. |
https://schema.fitko.de/fit-connect/events/create-reply ↓ | Zustelldienst | Die Antwort wurde durch den Subscriber angelegt. |
https://schema.fitko.de/fit-connect/events/submit-reply ↓ | Zustelldienst | Die Antwort wurde durch den Subscriber abgesendet. |
https://schema.fitko.de/fit-connect/events/notify-reply ↓ | Zustelldienst | Der Empfänger (Sender) wurde per Webhook über die Antwort informiert. |
https://schema.fitko.de/fit-connect/events/reject-reply ↓ | Zustelldienst | Die Antwort wurde durch den Empfänger zurückgewiesen oder die Antwort war mehr als 14 Tage im Status submitted und wurde deshalb vom Zustelldienst zurückgewiesen. |
https://schema.fitko.de/fit-connect/events/accept-reply ↓ | Zustelldienst | Die Antwort wurde durch den Empfänger akzeptiert. |
https://schema.fitko.de/fit-connect/events/delete-reply ↓ | Zustelldienst | Die Antwort wurde durch den Zustelldienst gelöscht. |
Submission Events
create-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/create-submission
dokumentiert der Zustelldienst,
dass eine Einreichung angelegt wurde.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "ada1b5b4-1bd2-4fab-b236-c30ef88e8c72",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/create-submission": {
}
}
}
submit-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/submit-submission
dokumentiert der Zustelldienst,
dass die Einreichung abgesendet wurde.
Das Event enthält das Objekt authenticationTags
, das die Authentication Tags der verschlüsselten Inhalte enthält.
metadata
: Authentication Tag des Metadatensatzesdata
: Authentication Tag des Fachdatensatzesattachments
: Objekt mit den Authentication Tags der Anlagen mit ihrenattachmentId
s als Schlüssel
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "25d2eb77-458d-4c9d-991c-6428c4651646",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/submit-submission": {
"authenticationTags": {
"metadata": "XFBoMYUZodetZdvTiFvSkQ",
"data": "UCGiqJxhBI3IFVdPalHHvA",
"attachments": {
"0b799252-deb9-42b0-98d3-c50d24bbafe0": "rT99rwrBTbTI7IJM8fU3El",
"25abf553-0e53-43b9-a14a-1581b32a9ee5": "i7226HEB7IchCxNuh7lCiu",
"046a9fa5-bed6-494b-aab6-d41056c6db79": "d48LxeolRdtFF4nzQibeYO"
}
}
}
}
}
notify-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/notify-submission
dokumentiert der Zustelldienst,
dass das empfangende System Kenntnis von der Einreichung erlangt hat.
Wie dies erfolgt ist, wird mit dem Eintrag notifyType
dokumentiert.
"notifyType": "callback"
- Der Subscriber wurde per Callback informiert.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "116c3c03-5f31-4d4c-9e65-d36e1e3895f7",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/notify-submission": {
"notifyType": "callback"
}
}
}
"notifyType": "polling"
- Der Subscriber hat die Liste der Submission überGET /v1/submissions
abgerufen.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "6127ff87-2786-4d0f-90fe-c531672f5de1",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/notify-submission": {
"notifyType": "polling"
}
}
}
forward-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/forward-submission
dokumentiert ein nachgelagertes System,
dass es die Einreichung zur Weiterleitung übernommen hat.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "c0cda2aa-bf79-4427-86f3-9f973bad2ecd",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/forward-submission": {
}
}
}
reject-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/reject-submission
dokumentiert das empfangende System,
dass die Einreichung zurückgewiesen wird.
Alternativ kann auch der Zustelldienst Einreichungen als rejected
markieren, wenn diese mehr als 14 Tage im Status submitted
verbleiben.
Unter Benachrichtigungen und Löschfristen finden sich hierzu genaue Angaben.
Das Event enthält ein Array problems
, dass die Fehler der Einreichung dokumentiert.
Der Aufbau ist an RFC 7807 angelehnt,
lässt jedoch den Status aus, weil hier kein passender HTTP Status Code angegeben werden kann.
type
: Fehlercode in Form einer URI.title
: Für Menschen verständliche Fehlermeldungdetail
: Details zum Fehler, z.B. eine technische Fehlermeldung (optional)instance
: Betroffener Teil der Übertragung. Mögliche Werte:submission
,metadata
,data
,attachment:
+ UUID des Attachments oderother
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "4ac47caa-bce1-435a-b04f-3322b224b32e",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/reject-submission": {
"problems": [
{
"type": "https://schema.fitko.de/fit-connect/events/problems/authentication-tag-incorrect",
"title": "Das Authentication Tag des Metadatensatzes ist ungültig",
"detail": "Das Authentication Tag des Metadatensatzes stimmt nicht mit dem im Submit-Submission-Event angegebenen Wert überein.",
"instance": "metadata"
}
]
}
}
}
accept-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/accept-submission
dokumentiert das empfangende System,
dass die Einreichung akzeptiert wurde.
Das Event muss eine mit dem submit-submission
Event übereinstimmende Liste von Authentication Tags enthalten.
Das empfangende System dokumentiert damit, dass es die Authentication Tags überprüft hat.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "8538165b-9ce3-4097-871d-5b9581a3b4d9",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "submission:F65FEAB2-4883-4DFF-85FB-169448545D9F",
"txn": "case:F73D30C6-8894-4444-8687-00AE756FEA90",
"events": {
"https://schema.fitko.de/fit-connect/events/accept-submission": {
"authenticationTags": {
"metadata": "XFBoMYUZodetZdvTiFvSkQ",
"data": "UCGiqJxhBI3IFVdPalHHvA",
"attachments": {
"0b799252-deb9-42b0-98d3-c50d24bbafe0": "rT99rwrBTbTI7IJM8fU3El",
"25abf553-0e53-43b9-a14a-1581b32a9ee5": "i7226HEB7IchCxNuh7lCiu",
"046a9fa5-bed6-494b-aab6-d41056c6db79": "d48LxeolRdtFF4nzQibeYO"
}
}
}
}
}
Sofern Probleme in der Einreichung gefunden wurden,
die jedoch nicht zu einer Zurückweisung geführt haben,
werden diese analog zu der problems
Liste in reject-submission
dokumentiert.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "6872b19f-5ee2-47d7-a0e9-ebfe87ab2563",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "submission:F65FEAB2-4883-4DFF-85FB-169448545D9F",
"txn": "case:F73D30C6-8894-4444-8687-00AE756FEA90",
"events": {
"https://schema.fitko.de/fit-connect/events/accept-submission": {
"problems": [
{
"type": "https://schema.fitko.de/fit-connect/events/problems/schema-missing",
"title": "Schemareferenz fehlt im Metadatensatz",
"detail": "Die Referenz auf das Metadatenschema ('$schema') fehlt im Metadatensatz.",
"instance": "metadata"
}
],
"authenticationTags": {
"metadata": "XFBoMYUZodetZdvTiFvSkQ",
"data": "UCGiqJxhBI3IFVdPalHHvA",
"attachments": {
"0b799252-deb9-42b0-98d3-c50d24bbafe0": "rT99rwrBTbTI7IJM8fU3El",
"25abf553-0e53-43b9-a14a-1581b32a9ee5": "i7226HEB7IchCxNuh7lCiu",
"046a9fa5-bed6-494b-aab6-d41056c6db79": "d48LxeolRdtFF4nzQibeYO"
}
}
}
}
}
delete-submission
Mit dem Event https://schema.fitko.de/fit-connect/events/delete-submission
dokumentiert der Zustelldienst, dass die Einreichung gelöscht wurde.
Die Fristen, wann Einreichungen mit welchem Status gelöscht werden,
finden sich unter Benachrichtigungen und Löschfristen.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "29d091aa-86ab-4806-beb5-fb462d18e2a1",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "submission:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/delete-submission": {
}
}
}
Reply Events
create-reply
Mit dem Event https://schema.fitko.de/fit-connect/events/create-reply
dokumentiert der Zustelldienst,
dass eine Antwort angelegt wurde.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "ada1b5b4-1bd2-4fab-b236-c30ef88e8c72",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "reply:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/create-reply": {
}
}
}
submit-reply
Mit dem Event https://schema.fitko.de/fit-connect/events/submit-reply
dokumentiert der Zustelldienst,
dass die Antwort abgesendet wurde.
Das Event enthält das Objekt authenticationTags
, das die Authentication Tags der verschlüsselten Inhalte enthält.
metadata
: Authentication Tag des Metadatensatzesdata
: Authentication Tag des Fachdatensatzesattachments
: Objekt mit den Authentication Tags der Anlagen mit ihrenattachmentId
s als Schlüssel
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "25d2eb77-458d-4c9d-991c-6428c4651646",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "reply:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/submit-reply": {
"authenticationTags": {
"metadata": "XFBoMYUZodetZdvTiFvSkQ",
"data": "UCGiqJxhBI3IFVdPalHHvA",
"attachments": {
"0b799252-deb9-42b0-98d3-c50d24bbafe0": "rT99rwrBTbTI7IJM8fU3El",
"25abf553-0e53-43b9-a14a-1581b32a9ee5": "i7226HEB7IchCxNuh7lCiu",
"046a9fa5-bed6-494b-aab6-d41056c6db79": "d48LxeolRdtFF4nzQibeYO"
}
}
}
}
}
notify-reply
Mit dem Event https://schema.fitko.de/fit-connect/events/notify-reply
dokumentiert der Zustelldienst,
dass das sendende System Kenntnis von der Antwort erlangt hat.
Wie dies erfolgt ist, wird mit dem Eintrag notifyType
dokumentiert.
"notifyType": "callback"
- Der Sender wurde per Callback informiert.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "116c3c03-5f31-4d4c-9e65-d36e1e3895f7",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "reply:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/notify-reply": {
"notifyType": "callback"
}
}
}
"notifyType": "polling"
- Der Sender hat die Liste der Antworten überGET /v1/replys
abgerufen.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "6127ff87-2786-4d0f-90fe-c531672f5de1",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "reply:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/notify-reply": {
"notifyType": "polling"
}
}
}
reject-reply
Mit dem Event https://schema.fitko.de/fit-connect/events/reject-reply
dokumentiert der Zustelldienst,
dass die Antwort zurückgewiesen wird.
Alternativ kann auch der Zustelldienst Antworten als rejected
markieren, wenn diese mehr als 14 Tage im Status submitted
verbleiben.
Unter Benachrichtigungen und Löschfristen finden sich hierzu genaue Angaben.
Das Event enthält ein Array problems
, dass die Fehler der Antwort dokumentiert.
Der Aufbau ist an RFC 7807 angelehnt,
lässt jedoch den Status aus, weil hier kein passender HTTP Status Code angegeben werden kann.
type
: Fehlercode in Form einer URI.title
: Für Menschen verständliche Fehlermeldungdetail
: Details zum Fehler, z.B. eine technische Fehlermeldung (optional)instance
: Betroffener Teil der Übertragung. Mögliche Werte:reply
,metadata
,data
,attachment:
+ UUID des Attachments oderother
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "4ac47caa-bce1-435a-b04f-3322b224b32e",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "reply:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/reject-reply": {
"problems": [
{
"type": "https://schema.fitko.de/fit-connect/events/problems/authentication-tag-incorrect",
"title": "Das Authentication Tag des Metadatensatzes ist ungültig",
"detail": "Das Authentication Tag des Metadatensatzes stimmt nicht mit dem im Submit-Submission-Event angegebenen Wert überein.",
"instance": "metadata"
}
]
}
}
}
accept-reply
Mit dem Event https://schema.fitko.de/fit-connect/events/accept-reply
dokumentiert der Zustelldienst,
dass die Antwort akzeptiert wurde.
Das Event muss eine mit dem submit-reply
Event übereinstimmende Liste von Authentication Tags enthalten.
Das sendende System dokumentiert damit, dass es die Authentication Tags überprüft hat.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "8538165b-9ce3-4097-871d-5b9581a3b4d9",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "reply:F65FEAB2-4883-4DFF-85FB-169448545D9F",
"txn": "case:F73D30C6-8894-4444-8687-00AE756FEA90",
"events": {
"https://schema.fitko.de/fit-connect/events/accept-reply": {
"authenticationTags": {
"metadata": "XFBoMYUZodetZdvTiFvSkQ",
"data": "UCGiqJxhBI3IFVdPalHHvA",
"attachments": {
"0b799252-deb9-42b0-98d3-c50d24bbafe0": "rT99rwrBTbTI7IJM8fU3El",
"25abf553-0e53-43b9-a14a-1581b32a9ee5": "i7226HEB7IchCxNuh7lCiu",
"046a9fa5-bed6-494b-aab6-d41056c6db79": "d48LxeolRdtFF4nzQibeYO"
}
}
}
}
}
Sofern Probleme in der Antwort gefunden wurden,
die jedoch nicht zu einer Zurückweisung geführt haben,
werden diese analog zu der problems
Liste in reject-reply
dokumentiert.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "6872b19f-5ee2-47d7-a0e9-ebfe87ab2563",
"iss": "40847c29-06aa-40e2-bf28-c29884c694c4",
"iat": 1622796532,
"sub": "reply:F65FEAB2-4883-4DFF-85FB-169448545D9F",
"txn": "case:F73D30C6-8894-4444-8687-00AE756FEA90",
"events": {
"https://schema.fitko.de/fit-connect/events/accept-reply": {
"problems": [
{
"type": "https://schema.fitko.de/fit-connect/events/problems/schema-missing",
"title": "Schemareferenz fehlt im Metadatensatz",
"detail": "Die Referenz auf das Metadatenschema ('$schema') fehlt im Metadatensatz.",
"instance": "metadata"
}
],
"authenticationTags": {
"metadata": "XFBoMYUZodetZdvTiFvSkQ",
"data": "UCGiqJxhBI3IFVdPalHHvA",
"attachments": {
"0b799252-deb9-42b0-98d3-c50d24bbafe0": "rT99rwrBTbTI7IJM8fU3El",
"25abf553-0e53-43b9-a14a-1581b32a9ee5": "i7226HEB7IchCxNuh7lCiu",
"046a9fa5-bed6-494b-aab6-d41056c6db79": "d48LxeolRdtFF4nzQibeYO"
}
}
}
}
}
delete-reply
Mit dem Event https://schema.fitko.de/fit-connect/events/delete-reply
dokumentiert der Zustelldienst, dass die Antwort gelöscht wurde.
Die Fristen, wann Antworten mit welchem Status gelöscht werden,
finden sich unter Benachrichtigungen und Löschfristen.
{
"$schema": "https://schema.fitko.de/fit-connect/set-payload/1.2.1/set-payload.schema.json",
"jti": "29d091aa-86ab-4806-beb5-fb462d18e2a1",
"iss": "https://submission-api-dev.fit-connect.fitko.dev",
"iat": 1622796532,
"sub": "reply:02bf1d9f-282d-4abf-810a-c4104baf0afe",
"txn": "case:452b5ee6-35df-441a-bd39-6141723cf914",
"events": {
"https://schema.fitko.de/fit-connect/events/delete-reply": {
}
}
}