...

Allgemein

Sobald das Audit erfolgreich abgeschlossen ist und Sie die Zertifizierung erhalten haben, können Sie die Schnittstelle final in die Produktivumgebung Ihrer Software oder Plattform integrieren.

• Hierzu stellt Ihnen die kv.digital einen Zugangslink zur Produktivumgebung sowie die erforderlichen Zugangsdaten bereit (OAuth2 mit dem Client‑Credential‑Flow).

• Für die Nutzung ist außerdem eine VPN‑Verbindung einer Site-to-Site-VPN‑Verbindung (VPN-Verbindung) zwischen den vertrauenswürdigen Umgebungen der Client‑ und der Server‑Systeme erforderlich, die zur sicheren Speicherung des Schlüsselmaterials Client‑seitig in Hardware ausgelegt ist.

...

Voraussetzungen für die Anbindung an das Produktivsystem

Bitte stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

Organisatorisch

• Audit erfolgreich abgeschlossen
• Zertifizierung liegt vor
  (gilt
• Erfolgreich abgeschlossenes Audit
Gültige Zertifizierung (gilt nur
• für die Schnittstelle gemäß § 370a
Absatz
• Abs. 2 SGB V)
• Bereitschaft zur VPN-Anbindung (inkl. sicherer Hardware für Schlüsselmaterial)

Technisch

• Vorbereitung für eine VPN-Verbindung
• Unterstützung von OAuth2
OAuth2-Authentifizierung
• (Client-Credentials-Flow)

...

👉 Details zur VPN-Anbindung finden Sie unter: 116117 Terminservice Schnittstellen – Anbindung via VPN

Hinweise

Die Kommunikation erfolgt ausschließlich im Ticket-System über das Serviceportal der kv.digital. 

Für den sicheren Datenaustausch wird zusätzlich Cryptshare verwendet: Darüber hinaus wird die Plattform Cryptshare (https://tausch.kbv.de) .

Cryptshare wird genutzt für:

den
• Versand der
Zugangsdaten den Empfang des CSRs für die VPN-Verbindung 
• Zugangsdaten
• Übermittlung des CSR für die VPN-Anbindung

Eine Anleitung zur Benutzung der Plattform finden Sie hier.

Wichtig: Planen Sie für die vollständige Anbindung mindestens 20 Arbeitstage  ein. 

Aktuelle Meldungen und Systemstatus

Regelmäßige Wartungsarbeiten sowie planbare Releases finden – soweit möglich – mittwochs ab 18:30 Uhr statt.
In diesem Zeitraum können Komponenten des 116117 Terminservice vorübergehend nicht erreichbar sein.

Sollte eine ungeplante oder zusätzliche Downtime außerhalb dieses Zeitfensters erforderlich sein, wird darüber frühzeitig informiert.

👉 Den aktuellen Systemstatus finden Sie hier:
https://partnerportal.kv-telematik.de/spaces/TSSCA/pages/134881409/Aktuelle+Meldungen+und+Systemstatus

📌 Empfehlung:
Setzen Sie die Seite auf „Beobachten“, um automatisch über Änderungen und Störungen informiert zu werden.

Health Check Endpoint

Der Health-Check-Endpunkt dient dazu, die grundlegende Erreichbarkeit und Funktionsfähigkeit der Anwendung zu prüfen.

Endpoint-Definition

URL:

{baseURL}/api/v2/healthcheck

HTTP-Methode:

GET

FHIR-Kontext:
Es handelt sich ausdrücklich nicht um einen FHIR-Endpunkt.

Request:
Der Endpoint benötigt keine speziellen Header oder Parameter.

Response:
Erfolgreicher Fall
Wenn der Service erreichbar ist und läuft:

HTTP/1.1 200 OK

• Es wird kein Response-Body erwartet.
• Der Statuscode allein signalisiert den erfolgreichen Health-Zustand.

Fehlerfall:
Falls der Service nicht funktionsfähig ist, wird ein HTTP-Statuscode ungleich 200 zurückgegeben.

Schritt 1: Anmeldung zur Integration

...

Erstellen Sie im Serviceportal ein Ticket im Projekt

...

:
„Integrationsportal 116117 Terminservice“

Bitte geben Sie folgende Informationen an:

• Zusammenfassung:
  Produktivgang

...

• <Ihre Organisation> /

...

• <Schnittstelle>

• Beschreibung:

...

• • Ansprechpartner für den Produktivgang
  • E-Mail-Adresse für die Kommunikation

...

• gewünschte Schnittstelle

• geplantes Datum für den Produktivgang

• Optional:
  Weitere Beteiligte hinzufügen (Registrierung erforderlich)

Nach dem Absenden wird Ihr Antrag geprüft:

• Bei vollständigen Angaben → Weiterbearbeitung
• Bei fehlenden Angaben → Rückmeldung zur Ergänzung
• Ohne Audit/Zertifizierung → keine Bearbeitung möglich,

Wichtig: Planen Sie mindestens 20 Arbeitstage für die Anbindung ein. 

Im Anschluss prüft das Team Anwendungen & Support die Angaben auf Richtigkeit und Vollständigkeit:

• Vollständige Angaben → Weiterbearbeitung
• Unvollständige Angaben → Rückfrage zur Ergänzung
Kein Audit/Zertifizierung →
• Ticket wird geschlossen

Schritt 2: Bereitstellung der Zugangsdaten

Nach erfolgreicher Prüfung erstellt erhalten Sie Ihre Zugangsdaten und den Zugangslink 

• Bereitstellung durch das Team Anwendungen & Support

...

• Versand über die

...

• sichere Plattform Cryptshare → Absender: audit@kv.digital
• Passwort wird separat per E-Mail an die angegebene E-Mailadresse gesendet

Wichtig: Die Zugangsdaten sind erst nach erfolgreicher VPN-Einrichtung nutzbar.

...

Für den Zugriff auf die Produktivumgebung ist eine sichere VPN-Verbindung erforderlich.

So gehen Sie vor:

1. Sie erhalten vom Support-Team eine Aufforderung

Erstellen Sie einen

2. den CSR (Certificate Signing Request) bereitzustellen

3. Erstellen Sie einen CSR 

4. Senden Sie den CSR über Cryptshare an audit@kv.digital:digital

5. Senden Sie zusätzlich per E-Mail an audit@kv.digitaldigital:

   • das gewählte Passwort
   • die Tracking-ID

6. Sie erhalten anschließend Ihr signiertes Zertifikat

...

1. über das Ticket

Ergebnis

Nach erfolgreicher Einrichtung können Sie:

• auf die Produktivumgebung zugreifen
• sich sicher authentifizieren
• Termine aus dem 116117 Terminservice über Ihr System vermitteln