Einreichung versenden

Die Einreichung kann abgeschlossen werden, indem der Metadatensatz und der Fachdatensatz über den Endpunkt PUT /v1/submissions/{submissionId} hochgeladen werden.

Diese PUT Methode kann nur erfolgreich durchgeführt werden, wenn folgende Bedingungen vorliegen:

• Es muss immer ein Metadatensatz hochgeladen werden.
• Alle angekündigten Anlagen (announcedAttachments im Endpunkt POST /v1/submissions) wurden hochgeladen.
• Sowohl der Metadatensatz als auch der Fachdatensatz müssen verschlüsselt im JWE-Format vorliegen.

Wenn die Nutzung dieses Endpunkts erfolgreich war, wechselt die Einreichung in den Status submitted und die vollständige Einreichung (Anlagen, Metadatensatz und Fachdatensatz) liegt nun für das empfangende System zum Abruf bereit. Bei nicht erfolgter Abholung einer Einreichung durch ein empfangendes System (Verwaltungssystem) erfolgt eine Benachrichtigung des technischen Kontakts auf Empfängerseite 3 Tage nach Eingang der Einreichung. Sollte sich eine Einreichung mehr als 14 Tage im Status submitted befinden, wird diese automatisch vom Server abgewiesen und in den Status rejected überführt.

Der Endpunkt erwartet die ID der Einreichung (submissionId), die verschlüsselten Metadaten im JWE-Format (encryptedMetadata) sowie die verschlüsselten Fachdaten im JWE-Format (encryptedData).

Ein Beispiel für die Nutzung des Endpunkt ist im Folgenden Ausschnitt dargestellt:

.NET (SDK)

Das folgende Beispiel zeigt, wie Sie das .NET-SDK nutzen, um eine Einreichung (Submission) zu senden. Vor dem Senden müssen Sie zunächst eine Submission anlegen. Im Artikel Einreichung anlegen finden Sie ein Beispiel dazu.
Um eine Submission zu senden, erzeugen Sie zunächst ein Objekt der Klasse Sender. Dafür benötigen Sie die Endpunkte der jeweiligen Betriebsumgebung der FIT-Connect-Infrastruktur. Eine Beschreibung der Umgebungen (Environments) finden Sie im Artikel Betriebsumgebungen der FIT-Connect-Infrastruktur. Das folgende Beispiel nutzt FitConnectEnvironment.Testing. Zudem benötigen Sie eine ClientId und ein ClientSecret. Auf der Seite Accountregistrierung und Client-Verwaltung ist beschrieben, wie Sie diese Credentials erhalten. Das Beispiel verwendet Platzhalter für die Werte in clientId und clientSecret.
Der Parameter logger ist optional:

var clientId = "YOUR CLIENT ID"
var clientSecret = "YOUR CLIENT SECRET";

// Sender erstellen
var sender = ClientFactory.GetSenderClient(FitConnectEnvironment.Testing, clientId, clientSecret, logger);

Um eine Submission an den Zustelldienst zu senden, rufen Sie die Methode SendAsync(sendableSubmission) am Sender auf und übergeben ihr die sendbare Submission:

await sender.SendAsync(sendableSubmission);

Der Quellcode oben ist ein Auszug aus dem Projekt ConsoleAppExample, das im Repository Codebeispiele - examples von FIT-Connect hinterlegt ist. Eine Beschreibung des .NET-SDKs finden Sie im Hauptmenü unter "SDKs > .NET-SDK".

---

curl

$ export SUBMISSION_API=https://submission-api-testing.fit-connect.fitko.dev
$ export JWT_TOKEN=eyJhbGciOiJIUzI1NiJ9.eyJJc3N1Z...NL-MKFrDGvn9TvkA
$ export SUBMISSION_ID=63f0c991-0635-4e18-8a4b-fb0c01de9f5c
$ export ENC_META_DATA=6r4H2H_WIzCv8Pd-uetmcbK...iVBKF3ylHRUahmZ
$ curl -L -X PUT "$SUBMISSION_API/v1/submissions/$SUBMISSION_ID" \
  -H "Authorization: Bearer $JWT_TOKEN" \
  -H "Content-Type: application/json" \
  --data-raw "{ \"encryptedMetadata\": \"$ENC_META_DATA\" }"

Java (SDK)

const axios = require('axios');

const data = JSON.stringify({
  "encryptedMetadata": "eyJhbGciOi...H82t9kVSf3Q"
});

const SUBMISSION_ID = "a562cf6a-3860-4a7e-96e3-1d01f8a5252d"
const ATTACHMENT_ID = "12399641-2067-4e8b-b049-91b2a6c90544"
const TOKEN = "eyJraWQiOiJHb2JOIiwi...NtPaYZ8YWHXh1TWcb2uhLVVnDBQ"
const SUBMISSION_API = "https://submission-api-testing.fit-connect.fitko.dev"

const config = {
  method: 'put',
  url: SUBMISSION_API + '/v1/submissions/' + SUBMISSION_ID,
  headers: {
    'Authorization': 'Bearer ' + TOKEN,
    'Content-Type': 'application/json'
  },
  data : data
};

axios(config)
.then(response => console.log(JSON.stringify(response.data)))
.catch(error => console.log(error));

JavaScript

Eine Einreichung kann mit Hilfe des Java-SDK relativ einfach eingereicht und verschickt werden, Voraussetzung hierfür ist die korrekte Konfiguration und Erzeugung eines SenderClient sowie einer SendableSubmission-Instanz:

  var config = ApplicationConfigLoader.loadConfigFromPath(...);
  var senderClient = ClientFactory.createSenderClient(config);

  var destinationID = UUID.fromString("aa3704d6-8bd7-4d40-a8af-501851f93934");
  var serviceIdentifier = "urn:de:fim:leika:leistung:99400048079000";
  var serviceSchema = URI.create("https://schema.fitko.de/fim/s00000114_1.1.schema.json");
  var jsonData = "{ ... }";

  var submission = SendableSubmission.Builder()
    .setDestination(destinationID)
    .setServiceType(serviceIdentifier, "My-Service")
    .setJsonData(jsonData, serviceSchema)
    .build();

  var sentSubmission = senderClient.send(submission);

Zu beachten ist hierbei, dass das Java-SDK die JSON Daten anhand des angegebene Fachschemas validiert und ggf. ablehnt. Im Erfolgsfall werden die Fachdaten verschlüsselt und die entsprechenden Aufrufe der FIT-Connect API durchgeführt.