Unser neues Fachportal ist online!

Mit der neuen, optimierten Menüführung kommen Sie ab sofort über drei Wege schnell und einfach ans Ziel: über die neue leistungsstarke Suche, den Schnelleinstieg und den zielgruppenspezifischen Seiten mit passgenauen Informationen für Ihre Bedürfnisse.

Der Relaunch ist erst der Anfang, weitere Features folgen noch in diesem Jahr. Sie möchten auf dem Laufenden bleiben? Melden Sie sich zu unserem Newsletter an.

Sie haben Fragen oder Anregungen zum neuen Fachportal? Senden Sie Ihr Feedback gerne an fachportal@gematik.de

Einen guten Start ins neue Jahr wünscht

Ihr Fachportal-Team

15.01.2021 - Veröffentlichung Release 3.1.3 Hotfix 8 und 4.0.1 Hotfix 2:
Mehr erfahren

Zurück

Toolkit

KoPS

Läuft Ihr Primärsystem TI-kompatibel? Mit KoPS wissen Sie es genau!

KoPS – der Konnektorsimulator für Primärsysteme

Mit dem Konnektorsimulator für Primärsysteme steht Ihnen ein flexibles und mächtiges Tool für die Anpassung Ihres Primärsystems zur Anbindung an die Telematikinfrastruktur zur Verfügung. KoPS bildet virtuell die Schnittstellen des Anwendungskonnektors spezifikationsgetreu nach und simuliert alle wesentlichen Anteile der Telematikinfrastruktur, die für den Gesamtablauf der Anwendungen entscheidend sind. Zudem können Sie offline testen, ob Ihr Primärsystem konform mit der Konnektor-Schnittstelle kommuniziert – ohne den Einsatz physischer Komponenten wie Konnektor, Kartenterminals und Karten.

Zusammen mit den integrierten Testfallkatalogen der gematik bietet Ihnen dieses Tool Sicherheit bei der Implementierung der TI-Anwendungen und Dienste, indem es die Reaktionen des Primärsystems validiert und analysiert. Außerdem verfügt es über vielfältige Anpassungs- und weitere Testmöglichkeiten sowie diverse Protokollierungs- und ausführliche Logging-Mechanismen und ermöglicht Ihnen eine effektive Entwicklungsarbeit und schnelle Analyse von Fehlern.

Von KoPS 2.1 zu KoPS 3.1

Der bislang von der gematik angebotene Konnektorsimulator für Primärsysteme KoPS 2.1 wurde für den Online-Produktivbetrieb Stufe 3.1 weiterentwickelt. Die neue Version KoPS 3.1 unterstützt auch die Fachanwendung elektronische Patientenakte.

Für den Einsatz der KoPS-Software ist eine Lizenzdatei erforderlich, die exklusiv von der gematik vertrieben wird. Für KoPS 2.1- und Puppetry-Lizenzinhaber werden entsprechende Upgrade-Möglichkeiten angeboten.

Weitere Informationen zu Installationsvoraussetzungen und den angebotenen Support-Paketen finden Sie auf der Internetseite des Herstellers https://puppetry.ehealthexperts.de/.

Bitte beachten Sie auch unsere Implementierungshinweise für Primärsystemhersteller sowie die FAQ-Section in unserem Fachportal.

Testmöglichkeiten mit dem Konnektorsimulator für Primärsysteme KoPS 3.1

  • Aufrufkontexte für verschiedenste Mandanten- und Arbeitsplatzszenarien, Konfiguration unterschiedlicher Umgebungen bzgl. Mandanten und Kartenterminals möglich
  • unterschiedliche Ausprägungen von Leistungserbringer- und Versichertenkarten (z.B. eGK G1+, eGK G2, eGK G2.1, HBA G2, HBA G2.1 und HBA-Vorläuferkarten, SMCB G2, SMCB G2.1, Krankenversichertenkarten sowie unbekannte/fehlerhafte Karten)
  • Umsetzung aller für VSDM relevanten Services: CardService/CardTerminalService/EventService/Systeminformation-Service/CertificateService/KVKService/VSDService / DVD / SDS
  • intuitive Benutzeroberfläche mit anwendungsspezifischen Ansichten, Daten und Funktionalitäten
  • Nachrichtenempfang über das konnektoreigene Protokoll CETP (Connector Event Transport Protocol)
  • Senden und Empfangen von anwendungsbezogenen SOAP-Nachrichten
  • Unterstützung von sicheren Verbindungen (TLS ohne ClientAuth/TLS mit ClientAuth via Zertifikatsprüfung/TLS mit ClientAuth via BasicAuth)
  • umfangreiche vordefinierte Gut- und Schlecht-Testfälle pro simulierter Fachanwendung
  • Fehleranalyse durch Live-Logging und umfangreiche Protokoll-Dateien (Basis, SOAP, Interface-Aufrufe inkl. CETP)
  • unterstützte Signaturvarianten: XAdES enveloped, XAdES enveloping, CAdES detached, CAdES enveloping, PAdES
  • Simulation der Kommunikation zwischen Clientsystem und Kim Clientmodul/LDAP-Proxy
  • Formular-Ansichten für anwendungsspezifische Daten als Baumstruktur oder im XML-Format
  • dynamische Umsetzung der ePA-Administration (PHRManagement Service) und statisches Dokumentenmanagement (PHRService)

Versionsübersicht

Die nachfolgende Tabelle listet die aktuell gültigen Versionen von KoPS, die dazugehörigen Testdaten sowie Testfallkataloge.

Das aktuelle KoPS-3.1-Paket (KoPS-3.1-Software inklusive OpenJDK, KoPS-3.1-Software ohne OpenJDK, Release Notes, KoPS-3.1-Handbuch sowie Hinweise zur Einrichtung von KIM finden Sie im Ordner KoPS3.1 in der gematik-Cloud.

Hinweise

Bitte beachten Sie, dass der Vertrieb und die Pflege von KoPS 2.1 eingestellt wurden. Die erforderlichen Testberichte erstellen Sie mit der Version KoPS 3.1.

Prüfen Sie die von Ihnen verwendeten Versionen und aktualisieren Sie diese gegebenenfalls.
Wenn Sie aktuell eine Bestätigung vorbereiten, stellen Sie bei der Erstellung des Testberichtes sicher, dass Sie die jeweils aktuellen Testfallkataloge und Testdaten gemäß der Übersicht zur KoPS 3.1 verwenden.

KoPS 3.1 V3.1.8 (Release Date 03.12.2020) VSDM NFDM eMP/AMTS KIM QES TBAuth ePA
Testdaten 1.0.6 1.1.8 1.1.5 1.1.3 1.0.3 - 1.1.1
Testfallkataloge 1.0.7 1.1.11 1.1.8 1.1.8 1.0.4 - 1.2.7
Einreichung Testbericht möglich ja ja ja ja - -

ja

 

Bestellung und Preise

1. Bestellformular ausfüllen und als Excel und Scan versenden

Um KoPS-3.1-Lizenzen zu bestellen, laden Sie bitte das Bestellformular herunter und senden sowohl die vollständig ausgefüllte Excel-Datei als auch einen Scan des unterschriebenen Bestellformulars an: betrieb[at]gematik(dot)de.

Registrierung für Jira Service Desk

Zusätzlich zur Angabe der Kontaktdaten für die Bestellung, Rechnungslegung und Auftragsabwicklung können Sie in dem Bestellformular auch Nutzer für den Jira Service Desk benennen. Mit dem Jira Service Desk steht Ihnen ein ansprechendes und modernes Ticketsystem zur Verfügung, in dem Sie Ihre Anfragen zu Spezifikation, KoPS-Testfällen und Testdaten sowie den jeweiligen Bearbeitungsstatus online einsehen können. Nach Eingang Ihrer Bestellung werden die von Ihnen gewünschten Nutzerkonten angelegt und den neuen Nutzern E-Mails mit einem Link zur Registrierung gesendet.

Bitte beachten Sie die Nutzungsbedingungen der gematik für die Verwendung und die Bestellung von KoPS 3.1. Beachten Sie bitte ebenso die Datenschutzerklärung der gematik.

Nutzungsbedingungen/Lizenzvertrag für die Nutzung der Software „KoPS 3.1"

pdf | 134 KB | 01.03.2020

Download

Upgrade von Lizenzen

Wenn Sie eine KoPS-3.1-Voll-Lizenz benötigen oder von KoPS 2.1 auf KoPS 3.1 upgraden möchten, nutzen Sie bitte die folgenden Anträge:

Voll-Lizenz oder Upgrade für KoPS 2.1

Wenn Sie eine KoPS-3.1-Voll-Lizenz benötigen oder von Puppetry auf KoPS 3.1 upgraden möchten:

Voll-Lizenz oder Upgrade für Puppetry

2. Auftragsbestätigung

Nach Eingang Ihrer Bestellung erhalten Sie per E-Mail eine Auftragsbestätigung von der gematik.

3. Rechnung und Lizenzdatei

Nach erfolgreicher Prüfung Ihrer Bestellung erhalten Sie von der gematik eine Rechnung mit den Zahlungskonditionen sowie eine E-Mail  mit der für den Einsatz von KoPS 3.1 erforderlichen Lizenzdatei und einer Information zum Ablageort.

4. Rechnung begleichen

Bitte begleichen Sie die Rechnung innerhalb von 14 Tagen.

5. Download und Installation

Die Bereitstellung der Software für den Konnektorsimulator für Primärsysysteme erfolgt ausschließlich als Download über die gematik-Cloud.

Das aktuelle KoPS-3.1-Paket (KoPS-3.1-Software inklusive OpenJDK, KoPS-3.1-Software ohne OpenJDK, Release Notes, KoPS-3.1-Handbuch, Hinweise zur Einrichtung von KIM) finden Sie im Ordner „KoPS 3.1“ in unserer gematik-Cloud unter: cloud.gematik.de/index.php/s/QNGzF4wCd5jtoSd

Bitte entpacken Sie die heruntergeladene Zip-Datei in einem geeigneten Ordner im Dateisystem Ihres Rechners und kopieren Sie die Lizenzdatei in das Installationsverzeichnis.

Informationen zum Start des Konnektorsimulators für Primärsysteme entnehmen Sie bitte dem Handbuch.

Preise für KoPS

Der Preis für eine KoPS-3.1-Voll-Lizenz beträgt 5.900,- Euro (zzgl. MwSt.).

Pro bestellter KoPS-3.1-Lizenz können die vollen Kosten in Höhe von 4.700,- Euro (zzgl. MwSt.) für eine bereits erworbene KoPS-2.1-Lizenz oder die vollen Kosten in Höhe von 2.800,- Euro (zzgl. MwSt.) für eine bereits erworbene Puppetry-Lizenz angerechnet werden.

Bitte tragen Sie hierzu in das jeweilige Bestellformular für jede anrechnungsfähige Puppetry- oder KoPS 2.1-Lizenz die zugehörige Puppetry- oder KoPS-2.1-Lizenznummer in das Bestellformular ein, damit eine Zuordnung vorgenommen werden kann. Jede bereits erworbene Puppetry- oder KoPS 2.1-Lizenz kann nur einmal angerechnet werden.

Kontakt

Vertrieb
Gern beantworten wir Ihre Fragen zu KoPS. Senden Sie dazu bitte eine E-Mail an industriebetreuung@gematik.de

Testfallkatalog und Testdaten
Sie sind bereits registrierter Nutzer haben Fragen zum Testfallkatalog und zu den Testdaten? Dann wenden Sie sich als an den Jira Service Desk der gematik unter gematik.atlassian.net/servicedesk/customer/user/login

Produktsupport
Bei Fragen zum Produktsupport wenden Sie sich bitte direkt an den Produkthersteller unter https://puppetry.ehealthexperts.de/.

FAQ

Bitte prüfen Sie, ob im Konsolenfenster Fehlermeldungen mit dem Text „java.net.BindException: Address already in use: bind“ ausgegeben werden. Wenn ja, prüfen Sie, ob die konfigurierten Ports (zu finden unter Oberfläche => Einstellungen) frei sind (z.B. unter Windows mit „netstat -an -p TCP“). Die Standardports 80 bzw. 443 können ggf. von anderen Anwendungen belegt sein. In diesem Fall müssen Sie die Standardports ändern. Bitte prüfen Sie nach der Änderung das KoPS-Konsolenfenster erneut auf Fehlermeldungen. Tritt keine Fehlermeldung mit dem Text „java.net.BindException: Address already in use: bind“ auf, ist KoPS richtig konfiguriert.

Der Testsuite liegt folgende Anforderung aus der gematik-Spezifikation „Implementierungsleitfaden Primärsysteme“ [gemILF_PS] zugrunde:

TIP1-A_4959: Konfigurierbarkeit von Kontext-Parametern

Innerhalb des Primärsystems MUSS eine Konfigurationsverwaltung vorhanden sein, welche die Parameter MandantId, ClientSystemId, WorkplaceId und UserId entsprechend Abb_LFPS_01_Element Context gemäß ConnectorContext.xsd” abbildet. Die Parameter sind alphanumerisch und haben eine Maximallänge von 64 Zeichen.

Die Überprüfung dieser MUSS-Anforderung erfolgt mithilfe von unverändlichen Clienttparametern.

Bitte hängen Sie allen im Testschritt „Screenshots anhängen“ beschriebenen Prüfpunkten ein Screenshot an.

Es wird eine Fehlermeldung im Primärsystem mit den folgenden Aussagen erwartet: „Der Typ der Karte ist unbekannt.“

Mögliche Fehlerursachen können sein:

  • keine eGK/KVK gesteckt
  • Karte nicht lesbar
  • Karte falsch gesteckt
  • „alte“ eGK gesteckt

Im Fall einer „alten“ elektronischen Gesundheitskarte (älter als G2; siehe Kartenaufdruck) besteht kein Leistungsanspruch. Bitte erkundigen Sie sich beim Versicherten, ob die gesteckte eGK die aktuelle elektronische Gesundheitskarte ist. Verweisen Sie ggf. an die Krankenversicherung für einen Austausch der Karten.

Die Fehlermeldung zu Fehlercode 105 muss einen Hinweis enthalten wie „Die eGK ist fehlerhaft/defekt. Bitte setzen Sie sich mit Ihrer Krankenversicherung in Verbindung.“

Im Falle einer gesperrten PIN (nach mehrfacher Falscheingabe der PIN) muss das Primärsystem zur Eingabe der PUK auffordern, nicht der PIN.

Die VSDM-Testfallkataloge sind in der aktuellen Version 1.0.6 für KoPS Puppetry und KoPS 2.1 inhaltlich identisch und damit derzeit gleichwertig in puncto Bestätigungsverfahren für die Konformität des Primärsystems zur Konnektorschnittstelle. Somit kann derzeit eine Bestätigung der VSDM-Funktionalität sowohl mit KoPS Puppetry als auch mit KoPS 2.1 erfolgen.

Das Fachmodul prüft das XML-Dokument gegen das Schema sowie alle in [gemSpec_InfoNFDM/gemSpec_Info_AMTS] aufgeführten Validitätskriterien. Schlägt die Validierung fehl, bricht das Fachmodul die Operation mit dem Fehler 5017 (NFDM) bzw. dem Fehler 6058 (AMTS) ab. KoPS 2.1 gibt ab Version 2.1.16 Detailinformationen zu den fehlgeschlagenen Validitätskriterien t, um Ihnen die Fehlersuche zu erleichtern. Diese Detailinformationen werden unter Umständen von den Konnektoren nicht in die Response generiert. Die Syntax der Detailinformation bildet den Pfad zu dem Element/Attribut, welches fehlerhaft ist. Das ist also der technische Pfad, wie er in der XSD bzw. im übersetzen Java-Code abgebildet ist.

Zum Beispiel bedeutet die Meldung amts.mp.s.0.mOrXOrR.0.m.ps [Das Element darf nicht vorhanden sein.]: Der Fehler liegt hier im „AMTS-Dokument“ [amts] > im „MP-Datensatz“ [mp] > in der 0-ten (Nullten) „Gruppierung von Medikationseinträgen“ [s.0] > im 0-ten (Nullten) meTyp (also „Medikation“ oder „Freitextzeile“ oder „Rezeptur“) [mOrXOrR.0] > der meTyp ist eine „Medikation“ [m] > im „Code-System PZN“ [ps].

Gemäß Spezifikation für den Konnektor dienen die veröffentlichten Schnittstellenbeschreibungen als Grundlage für die Implementierung. Daher ist die Bereitstellung der WSDLs zur Laufzeit nicht notwendig. Ein Primärsysystem muss ohne WSDLs mit dem Konnektor kommunizieren können. Zur Laufzeit stellt der Konnektor den Dienstverzeichnisdienst zur Verfügung.

KoPS 2.1 stellt nur den DVD, nicht die WSDL zur Verfügung.