Das Wichtigste zuerst:
Registrierung
Damit Sie das Informationsangebot der SVC in vollem Umfang nutzen können, registrieren Sie sich bitte unter support@svc.co.at.
Für die Registrierung werden folgende Daten benötigt:
- Firma
- Unternehmenstätigkeit
- Anschrift
- Kontaktperson (Position)
- Telefon
- E‑Mail
- Web-Adresse
Ihre Kontaktdaten, bestehend aus den Namensdaten (inkl. Titel und Anrede), der Berufsbezeichnung im Unternehmen und die Adressdaten (Bezeichnung des Unternehmens, Unternehmenstätigkeit, Unternehmensadressdaten, Telefonnummern, E‑Mail-Adressen, Website-Adressen) werden von uns zum Zweck der Information über Neuerungen und Änderungen im e‑card System verarbeitet. Sollten sich Ihre Kontaktdaten ändern, teilen Sie uns das bitte via E‑Mail an support@svc.co.at mit.
Die Registrierung kann jederzeit via E‑Mail an support@svc.co.at widerrufen werden. Die Rechtmäßigkeit der bis zum Widerruf verarbeiteten Daten bleibt dadurch unberührt. Die Kontaktdaten werden nach Widerruf gelöscht.
Falls Fragen zur Verarbeitung der Daten auftreten oder Sie von Ihrem Auskunftsrecht Gebrauch machen wollen, senden Sie bitte eine E‑Mail an datenschutz@svc.co.at.
Der Weg zum Entwicklungsstart: e‑card Testumgebung
Um die Services des e‑card Systems in der eigenen Software-Lösung zu implementieren, benötigen Sie einen Test-Anschluss*Der Test-Anschluss selbst muss in Österreich lokalisiert sein. Sofern Sie keine Niederlassung bzw. keinen Standort in Österreich haben, können Sie den Anschluss bei einem Partner oder Kunden in Österreich einrichten lassen und über VPN darauf zuzugreifen.. Mit diesem erhalten Sie Zugriff auf eine umfangreiche Testumgebung (VPSWH), in der mit Test-Identitäten bzw. mit sogenannten Pseudo-Admin-Karten und Pseudo-e-cards (Patientenkarten) gearbeitet wird.
Weitere Informationen zur Bestellung eines Testanschlusses und Testkarten finden Sie hier.
e‑card System: Services
Im e‑card System gibt es eine Reihe von Services, die u.a. miteinander interagieren ( GINS*Gesundheitsinformationsnetz Services (Siehe auch die Netzwerk-Anfoderungen https://www.chipkarte.at/cdscontent/?contentid=10007.895058&portal=ecardportal.)). Um festzustellen, welche Services für Ihre Kundengruppe(n) relevant sind, steht Ihnen eine umfangreiche Übersicht mit detaillierten Service-Beschreibungen zur Verfügung.
Informationen zur Relevanz der e‑card Services abhängig von der Benutzergruppe finden Sie hier.
e‑card System: Schnittstellenbeschreibung
Aus technischer Sicht erfolgt die Nutzung der e‑card Services über eine Webservice-Schnittstelle via SOAP/XML bzw. REST/JSON. Die SOAP-Schnittstelle ist in der e‑card Schnittstellenbeschreibung (JavaDoc) beschrieben. (Siehe auch die Navigationshilfe "How‑to JavaDoc").
Mit jeder Änderung des e‑card Systems wird die Schnittstellenbeschreibung aktualisiert und hier veröffentlicht.
Die Verwaltung der Kartenlesegeräte GINO und der direkte Zugriff darauf erfolgt über eine REST/JSON API. Die Dokumentation ist als Swagger UI abgelegt.
"Hello World!" - "Hello GINS!"
Ist der Test-Anschluss eingerichtet, kann die Software-Entwicklung starten!
Der Einstieg in die SOAP-Schnittstelle erfolgt unter folgender URL: https://services-a.ecard-test.sozialversicherung.at/[service-kürzel]/[service-version]
(z.B. https://services-a.ecard-test.sozialversicherung.at/auth/1)
Zu Beginn empfehlen wir die Implementierung folgender Services:
REST:
- CRS (Card Reader Service)
Zur Abfrage der verfügbaren angeschlossenen Kartenlesegeräte GINO. - GINO
Beim Kartenzugriff wird ein sogenannter cardToken der jeweiligen Karte erzeugt. Der Lesezugriff wird durch das REST-Service GINO ausgelöst. Dabei kann entweder eine sogenannte VP-Signatur (für die Anmeldung am e-card System) oder eine SV-Signatur (zur Identifikation der Patientin bzw. des Patienten) erstellt werden.
SOAP:
- Servicemanager
Aus Entwicklungssicht ist das Service "Servicemanager" ein guter Einstiegspunkt. Dieses beinhaltet genau eine Funktion - getServices() - welche die Endpoint URLs aller verfügbaren Services zurückliefert.
Hinweis: Im e-card System wird auch QoS (Quality of Service) eingesetzt. Die Priorisierung der Datenübertragung spiegelt sich in folgenden URLs wider, welche auch vom Servicemanager retourniert werden:- (1) services.ecard.sozialversicherung.at
- (2) elga.ecard.sozialversicherung.at
- (3) transfer.ecard.sozialversicherung.at
- AUTH
Zur Authentifizierung des Vertragspartners im e‑card System und zum Aufbau von "Dialogen" (erforderlich für die Nutzung des e‑card Systems) - BASE
Zum Abruf von „allgemeinen“ Informationen, für die ein aufgebauter Dialog notwendig ist.
Nützliche Funktionen wären: getVertraege(), getMessages() oder getBerechtigungen()
Exemplarische Workflows und Beispiel-Requests können in den SoapUI Beispielprojekten eingesehen und getestet werden.
Support & Kontakt
Während des gesamten Implementierungsprozesses unterstützt Sie gerne das Team des SVC Partnersupports.
E‑Mail: support@svc.co.at
Hinweis: Wir bitten um Verständnis, dass wir nur die Anbindung an das e‑card System selbst supporten und bei betriebssystem- oder programmiersprachenspezifischen Fragen nicht unterstützen können.
Zudem informieren wir gerne regelmäßig über verschiedene Events, sowie Entwicklungen und Neuerungen im e‑card System via Newsletter!
Zertifizierung
Der Dachverband der Sozialversicherungsträger bietet Arztsoftware-Herstellern die Möglichkeit, Software zur elektronischen Rechnungslegung zertifizieren zu lassen. (Es gibt aktuell keine Zertifizierung für die Implementierung des e‑card Systems bzw. der e‑card Services selbst.)