1 Der VeKa-Abfrage-Webservice

1.1 Vorwort

Das VeKa-Center stellt ein Abfragemodul in Form eines Webservice bereit.

Dieses Abfragemodul beinhaltet Daten der Versicherer, die die Zustimmung zu der Abfrage gegeben haben.

Die vertraglichen Vereinbarungen sind im Lizenzvertrag und den Richtlinien vorhanden. Dieses Dokument soll vor allem die technische Sicht des Webservice wiedergeben.

Der Webservice hat eine einzige Methode „Query“. Der Inhalt des Inputparameters beinhaltet die Felder, aufgeschlüsselt in XML, die im Vertrag definiert sind. Die Methode liefert wiederum die Felder zurück, die im Vertrag als Rückgabewerte definiert sind. Dort ist auch der fachliche Beschrieb als Anhang definiert. Der eigentliche Datenaustausch wird im SOAP-Body durchgeführt. Dort werden die Daten zum VeKa-Center übermittelt und in der Antwort Struktur zurückgeliefert. Dabei werden die Anfragewerte teilweise kopiert und mit Werten aus dem VeKa-Center ergänzt.

Der Zugriff auf den Webserver wird mit SSL abgesichert. Dabei verlangt der Web-Server nach einem Clientzertifikat. Wird dieses nicht mit der Anfrage übermittelt, so kann keine Abfrage stattfinden.

Weiter verlangt der Webservice eine Benutzer-Passwort Kombination. Nur, wenn das Subject des Zertifikats mit dem Benutzer übereinstimmt und die Benutzer-Passwort Kombination korrekt ist wird die Anfrage behandelt.
Der Webservice ist im WSDL beschrieben:
https://www.versichertenkarte.ch/queryws_1_0/VeKa_Query_1_0.asmx?wsdl

Die korrekten Verbindungsparameter und das Zertifikat werden Ihnen separat mitgeteilt.

Bei der Implementierung ist darauf zu achten, dass keine Kürzel für die Namespaces im Body akzeptiert werden. Der Webservice kann die Inputparameter nicht verarbeiten und somit kommen Fehlermeldungen zurück, dass nicht alle Parameter gefüllt sind.

In der Version 1.2 hat sich geändert, dass neu das Feld basic_insurance_military_delay (Militärversicherung) entfernt wurde, da es von den Versicherern als unnötig deklariert wurde.
Ebenfalls wurden die Stammtabellen im Kapitel 2.5, das Kapitel 2.2 und die Fehlermeldungen
mit den Rückmeldecodes 15/16 ergänzt.

In der Version 1.3 hat sich geändert, dass offizielle Angaben der Zentralen Ausgleichsstelle ZAS zurückgeliefert werden. Dabei handelt es sich um Vornamen, Nachnamen, Geburtsdatum und Geschlecht.

Die ZAS-Attribute sind in einen eigenen Knoten verschoben worden, da die Datenquelle das ZAS ist und nicht das VeKa. Um einen Parallelbetrieb aufrecht zu erhalten werden die Attribute noch bis 31.12.2015 am alten Platz geliefert.

Weiterhin kommt in der Version 2.0 die Blacklist des Kantons hinzu. Die Quelle der Daten an dieser Stelle ist das herausgebende Kanton. Sie werden auch nur angezeigt, wenn der abfragende Leistungserbringer bei LSP der SASIS AG angemeldet ist.

Nähere Informationen finden Sie unter https://www.lsp-online.ch.

Die Blacklist wird immer zum aktuellen Stand abgefragt. Es findet keine Historisierung statt.

In der Version 2.1 wurden im Kapitel 2.4.5 die zusätzliche Felder zum erweiterten Deckungsrecord hinzugefügt und beschrieben.

1.2 Endpoint

Der VeKa-Webservice Endpoint lautet:
https://www.versichertenkarte.ch/queryws_1_0/VeKa_Query_1_0.asmx

1.3 Graphische Darstellung

1.3.1 Request	1.3.2 Rückgabestruktur

→ Für das blau eingefärbte Kreuz (siehe folgende Grafik) ist jeweils Masterdata vorhanden:

1.3.3 Beispiel einer kompletten SOAP Anfrage

Anfragestruktur

Rückgabestruktur

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:veka="http://www.vekacenter.ch/veka_query/">

<soap:Header/>

<soap:Body>

<veka:VeKa_Request>

<veka:requestDate>2013-08-13T00:00:00</veka:requestDate>

<veka:questioners>

<veka:questioners>Abfragedienst-Name</veka:questioners>

<veka:user>User-Name</veka:user>

<veka:password>********</veka:password>

<veka:language>D</veka:language>

</veka:questioners>

<veka:provider>

<veka:ZSR>T000001</veka:ZSR>

</veka:provider>

<veka:insurance/>

<veka:patient>

<veka:card_id>80756012340000000527</veka:card_id>

<veka:treatment_date>2013-08-13</veka:treatment_date>

</veka:patient>

</veka:VeKa_Request>

</soap:Body>

</soap:Envelope>

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<soap:Body>

<VeKa_Response xmlns="http://www.vekacenter.ch/veka_query/">

<request_ID>109783678</request_ID>

<version_no>1.3.0.2</version_no>

<version_date>2013-03-26T18:15:00+01:00</version_date>

</version>

</provider>

<ean_party>7600000000000</ean_party>

<BAG_insurance_id>1234</BAG_insurance_id>

<name>sanacur (Testversicherer)</name>

<description>Servicecenter</description>

<e_mail>info@sanacur.ch</e_mail>

<name1>Irgendeine Versicherung</name1>

<street>Strasse 1</street>

<postbox>Postfach. 1234</postbox>

<city>Zürich</city>

</address>

</insurance>

<card_id>80756012340000000527</card_id>

<assured_id>52</assured_id>

<unique_id>7569999999472</unique_id>

<familyname>Devon</familyname>

<gender>female</gender>

<street>Sonnenpark 20b</street>

<city>Zürich</city>

</address>

</basicData>

<KVG>

<basic_insurance>

<Text>Deckung OKP gems KVG</Text>

</basic_insurance>

<basic_insurance_model>

<Text>Standard-Modell gemäss KVG</Text>

</basic_insurance_model>

<basic_insurance_description/>

<basic_insurance_region>ZH</basic_insurance_region>

<basic_insurance_accident>

<Text>Keine Unfalldeckung gemäss KVG</Text>

</basic_insurance_accident>

<basic_insurance_data_locked_insured>false

</basic_insurance_data_locked_insured>

<basic_insurance_benefit_delay>false</basic_insurance_benefit_delay>

<basic_insurance_product>

<Text>Testprodukt OKP 1</Text>

</basic_insurance_product>

</KVG>

<drugs>

<drugs_Hors_Liste>

<Text>Keine Deckung für Medikamente gemäss Hors Liste</Text>

</drugs_Hors_Liste>

<drugs_Hors_Liste_accident>

<Text>Unfalldeckung für Medikamente gemäss Hors Liste</Text>

</drugs_Hors_Liste_accident>

<drugs_complementary>

<Text>Keine Deckung für Medikamente Komplementärmedizin</Text>

</drugs_complementary>

<drugs_complementary_accident>

<Text>Keine Unfalldeckung für Medikamente Komplementärmedizin</Text>

</drugs_complementary_accident>

<drugs_benefit_delay>false</drugs_benefit_delay>

</drugs>

<hospital_unit>

<Text>Private Spitalabteilung VVG</Text>

</hospital_unit>

<hospital_model>

<Text>Einzelzimmer mit freier Arztwahl</Text>

</hospital_model>

<hospital_accident>

<Text>Keine Unfalldeckung für Spitalversicherung gemäss VVG</Text>

</hospital_accident>

<hospital_benefit_delay>false</hospital_benefit_delay>

</hospital>

<vvg_product>

</vvg_product>

<treatment_date>2013-08-13T00:00:00</treatment_date>

</patient>

<ZAS>

<official_familynames>Devon-Miller</official_familynames>

<official_givennames>Annemaria</official_givennames >

<official_birthdate>1987-02-14T00:00:00</official_birthdate>

<official_gender>female</official_gender>

</ZAS>

<canton_name>SH</canton_name>

</blacklist >

<canton_name>TI</canton_name>

</blacklist >

</canton>

</VeKa_Response>

</soap:Body>

</soap:Envelope>

1.4 Rückmeldungen (ReturnValue) des Webservice

Im Moment werden folgende Rückmeldungen generiert. Diese Meldungen sind nicht fix und werden bei Bedarf ausgebaut.

Ok = 0	Abfrage konnte korrekt durchgeführt werden
NoMatch = 1	Keine Treffer
ToMuchMatches = 2	Kein eindeutiger Treffer: Bitte verwenden Sie die 20-stellige Versichertenkartennummer um ein eindeutiges Resultat zu erhalten.
NoEnoughInformationForQuery = 4	Die Abfragestruktur wurde nicht korrekt gefüllt (Mussfelder sind leer, Felder nicht korrekt gefüllt)
UserDoesntMatchCertificate = 5	Der User passt nicht zum Zertifikat
UserPasswordNotFound = 6	User/Passwort-Kombination falsch
NoCertificate = 7	Der Zugriff erfolgt ohne gültiges Zertifikat (Wird schon vom Internetserver abgefangen)
UserLocked = 8	Der User ist gesperrt
ZSRNotForProvider = 9	Die Anfragende Zahlstelle wurde für das Zertifikat nicht freigeschaltet
BAGNrLocked = 10	Es konnte ein Treffer gelandet werden, die ZSR oder der Provider hat jedoch keine Freischaltung des Versicherers
NoFurtherRightsForQuery= 11	Es wurde mit den eingestellten Rechten kein Treffer gelandet
WrongCity= 12	Es konnte ein Treffer gelandet werden, der übergebene Ort stimmt jedoch nicht mit dem Ort im VeKa-Center überein
ZSRNotForUser = 13	Die übergebene ZSR-Nummer (Provider) ist nicht für den übergebenen User freigeschaltet
CardNotValid = 14	Die übergebene Kartennummer konnte zwar gefunden werden, jedoch ist die Karte nicht mehr gültig (wg. Neuer Karte, Sperrung, Austritt)
NewCardInInsurance = 15	Die mitgelieferte Kartenummer ist nicht mehr aktiv, es wurde eine aktive Kartennummer innerhalb des gleichen Versicherers gefundent.
OtherInsurance = 16	Die mitgelieferte Kartenummer ist nicht mehr aktiv, es wurde eine aktive Kartennummer innerhalb eines anderen Versicherers gefundent.
UnknownError = 999	Unbekannter Fehler, ReturnMessage beachten (Normalerweise ein Programmfehler)

2 Detaillierte Beschreibung der Knoten

2.1 Einleitung

Da jeder Versicherer selbst über seine Daten bestimmt ist es möglich, dass bestimmte Informationen bei bestimmten Leistungserbringern nicht freigeschaltet sind oder dass die Versicherung die Daten nicht liefert. Dies kann dazu führen, dass einzelne Knoten ausgeblendet werden und als Serverrückmeldung eine entsprechende Meldung kommt.

2.2 Allgemeine Datentypen

Beschreibung	Einschränkung
Beinhaltet die eine EAN-Nummer.	String: (20[0-9]{11}\|76[0-9]{11})

Beschreibung	Einschränkung
Beinhaltet die eine BAG-Nummer.	Integer von 1 bis 9999

Beschreibung	Einschränkung
Beinhaltet die eine Karten-Nummer.	String, (80756[0-9]{15}\|80438[0-9]{15})

Beschreibung	Einschränkung
Beinhaltet eine Zeichenkette.	String maximale Länge 2 Zeichen

Beschreibung	Einschränkung
Beinhaltet eine Zeichenkette.	String maximale Länge 20 Zeichen

Beschreibung	Einschränkung
Beinhaltet eine Zeichenkette.	String maximale Länge 40 Zeichen

Beschreibung	Einschränkung
Beinhaltet eine Zeichenkette.	String maximale Länge 100 Zeichen

Beschreibung	Einschränkung
Beinhaltet eine Sozialversicherungsnummer.	String, (756[0-9]{10})

Beschreibung	Einschränkung
Beinhaltet eine Zahlstellenregister Nummer.	String, ([A-Z][0-9]{6})

Beschreibung	Einschränkung
Beinhaltet die Abfragesprache.	String(1), (D/F/I)

Beschreibung	Einschränkung
Beinhaltet das Geschlecht.	String, Enumeration (male/female)

2. 3 Abfrage beim VeKa (Request)

2.3.1 Abfragestruktur «VeKa Request»

Beschreibung

Element	Beschreibung
requestDate	In diesem Tag wird das Abfragedatum des Clients übergeben.
questioners	Siehe Das Element «questioners» (typeQRY_questioners)
biller	Siehe Das Element «biller» (typeQRY_biller)
provider	Siehe Das Element «provider» (typeQRY_provider)
insurance	Siehe Das Element «insurance» (typeQRY_insurance)
patient	Siehe Das Element «patient» (typeQRY_patient)

Element	Beschreibung
questioners	Abfragestelle: Wird vom VeKa-Center vergeben
user	User: Wird vom VeKa-Center vergeben
password	Passwort: Wird vom VeKa-Center vergeben
language	Sprache der Antwort (D, F, I)

Element	Beschreibung
ean_party	EAN
ZSR	ZSR
invoice_id	RechnungsNr
invoice_date	RechnungsDatum

Element	Beschreibung
ean_party	EAN
ZSR	ZSR

Element	Beschreibung
ean_party	EAN
BAG_insurance_id	BAGNr
name	Bezeichnung

Element	Beschreibung
card_id	Kartennummer von VeKa-Center
assured_id	VersichertenNummer
unique_id	Sozialversicherungsnummer
familyname	Hauptname
givenname	Vorname
birthdate	Geburtsdatum
gender	Geschlecht
zip	Postleitzahl des Wohnorts des Patienten
treatment_date	Behandlungsbeginn

2. 4 Rückmeldung beim VeKa (Response)

2.4.1 Abfragestruktur «VeKa Response»

Beschreibung

Element	Beschreibung
returnCode	Siehe Beispiel einer kompletten SOAP Anfrage - Rückgabestruktur
returnMessage	Siehe Beispiel einer kompletten SOAP Anfrage - Rückgabestruktur
requestDate	Datum der Anfrage vom Server
request_ID	Eindeutige Anfragenummer
version	Versionsnummer des Abfragemoduls
biller	Siehe Abfragestruktur «biller» (typeRES_biller)
provider	Siehe Abfragestruktur «provider» (typeRES_provider)
patient	Siehe Abfragestruktur «patient» (typeRES_patient) Abfragestruktur «patient/basicData» (typeRES_basicData) Abfragestruktur «patient/insurance» (typeRES_insurance) Abfragestruktur «patient/KVG» (typeRES_basic_insurance_KVG) Abfragestruktur «patient/drugs“ (typeRES_drugs) Abfragestruktur «patient/hospital» (typeRES_hospital) Abfragestruktur «patient/vvg_zvs» (typeRES_vvg_zvs)
ZAS	Offizielle Attribute der zurückgelieferten AHV-Nummer. Siehe 2.4.10 Einschränkungen: · Sollte vertraglich keine Vereinbarung über diese Attribute bestehen so werden sie nicht mit ausgeliefert. · Bei Roaming anfragen werden diese Daten nicht gefüllt.
canton	Meldungen des Kantons zu der AHV-Nummer. Siehe 2.4.8 Einschränkungen: · Dieser Knoten wird nur ausgeliefert, wenn der Leistungserbringer dem ordentlichen Meldeverfahren von LSP beigetreten ist. Nähere Informationen siehe https://www.lsp-online.ch oder unter https://www.sasis.ch.

Element	Beschreibung
ean_party	EAN
ZSR	ZSR
invoice_id	RechnungsNr
invoice_date	RechnungsDatum

Element	Beschreibung
version_No	2.0.0.0
version_date	Datum der Version

Element	Beschreibung
ean_party	EAN
ZSR	ZSR
message	Jeder Versicherer kann jedem Versicherten in der Kombination mit dem Leistungserbringer bzw. dessen Partnerart wie sie im SASIS Zahlstellenregister definiert ist Meldungen bzw. Hinweise zukommen lassen.

Element	Beschreibung
message_query	Rückmeldung des Servers bei etwaigen Besonderheiten des Tags bei der Versicherung
validFrom	Ab wann gilt die Deckung
validUntil	Bis wann gilt die Deckung
cardValidFrom	Beginndatum, das auf der Versichertenkarte aufgedruckt ist
cardValidUntil	Endedatum, das auf der Versichertenkarte aufgedruckt ist
language	Sprache des Versicherten (D, F, I, E, R)
insurance	Versicherung: Siehe 2.4.5.2
basicData	Basisdaten: Siehe 2.4.5.1
KVG	Grundversicherung KVG: Siehe 2.4.5.3
drugs	Medikamente: Siehe 2.4.5.4
hospital	Spitalzusatzversicherung: Siehe 2.4.5.5
vvg_zvs	Zusatzversicherung VVG mit Spezialversicherungen: Siehe 0
vvg_product	Alle VVG-Produkte, die der Versicherte bei der Versicherung hat. Siehe 2.5.16
treatment_date	Datum der Behandlung

Element	Beschreibung
message_query	Rückmeldung des Servers bei etwaigen Besonderheiten des Tags bei der Versicherung
card_id	Kartennummer
assured_id	VersichertenNummer
unique_id	SozialversicherungsNummer
familyname	Hauptname
givenname	Vorname
birthdate	Geburtsdatum
gender	Geschlecht
Address	Wohnadresse des Patienten, siehe 2.4.6
official_familynames (bis 31.12.2015)	Offizielle(r) Familienname(n) gemäss ZAS
official_givennames (bis 31.12.2015)	Offizielle(r) Vorname(n) gemäss ZAS
official_birthdate (bis 31.12.2015)	Offizielles Geburtsdatum gemäss ZAS
official_gender (bis 31.12.2015)	Offizielles Geschlecht (Inhalt siehe 2.2.11)

Element	Beschreibung
ean_party	EAN-Nummer der Versicherung
BAG_insurance_id	Zulassungsnummer der Versicherung beim Bundesamt für Gesundheit
name	Name der Versicherung
description	Kontaktstelle: Bezeichnung
phone	Kontaktstelle: Telefonnummer
e_mail	Kontaktstelle: E-Mail Adresse
name1	Kontaktstelle: Name 1
name2	Kontaktstelle: Name 2
address	Kontaktstelle: Adresse der Kontaktstelle. Siehe 2.4.6
dateofimport	Datum des letzten Imports der Versicherung

Element	Beschreibung
message_query	Rückmeldung des Servers bei etwaigen Besonderheiten des Tags bei der Versicherung
basic_insurance	Basisversicherung: siehe 2.5.1
basic_insurance_model	Modell Grundversicherung: siehe 2.5.2
basic_insurance_description	Beschreibung Grundversicherung
basic_insurance_region	Wohnkanton des Patienten, siehe 2.5.3
basic_insurance_accident	Unfall Grundversicherung: siehe 2.5.4
basic_insurance_data_locked_insured	Der Versicherte hat die Daten für die Online-Abfrage gesperrt
basic_insurance_remark	Bemerkungen Grundversicherung
basic_insurance_benefit_delay	Tiers garant (ja oder nein)
basic_insurance_product	KVG-Produkte, die der Versicherte bei der Versicherung hat. Siehe 2.5.15

Element	Beschreibung
message_query	Rückmeldung des Servers bei etwaigen Besonderheiten des Tags bei der Versicherung
drugs_Hors_Liste	Medikamente Hors Liste: siehe 2.5.5
drugs_Hors_Liste_accident	Medikamente Hors Liste Unfall: siehe 2.5.6
drugs_complementary	Medikamente Komplementär: siehe 2.5.7
drugs_complementary_accident	Medikamente Komplementär Unfall: siehe 2.5.8
drugs_remark	Bemerkung Medikamente
drugs_benefit_delay	Deckungsunterbruch

Element	Beschreibung
message_query	Rückmeldung des Servers bei etwaigen Besonderheiten des Tags bei der Versicherung
hospital_unit	Spitalabteilung: siehe 2.5.9
hospital_model	Spitalmodell: siehe 2.5.10
hospital_accident	Spital Unfallversicherung: siehe 2.5.11
hospital_akutsomatik	Vergütung/Sperrung besonderer akutsomatischer Leistungen siehe 2.5.12
hospital_psychiatry	Vergütung/Sperrung besonderer psychiatrische Leistungen siehe 2.5.13
hospital_list	Spitallisten-Modell: Listentyps siehe 2.5.14
hospital_remark	Bemerkung Spital
hospital_benefit_delay	Deckungsunterbruch

	Element	Beschreibung
ambulant_private	message_query	Rückmeldung des Servers bei etwaigen Besonderheiten des Tags bei der Versicherung
	ambulant_private	Ambulant Privat
	ambulant_private_accident	Unfalldeckung Ambulant Privat
	ambulant_private_accident_add1	Ambulant Privat-Zusatzfeld 1 (Sperre Online)
	ambulant_private_accident_add2	Ambulant Privat-Zusatzfeld 2
	ambulant_private_accident_add3	Ambulant Privat-Zusatzfeld 3
	ambulant_private_accident_add4	Ambulant Privat-Zusatzfeld 4
	ambulant_private_remark1	Bemerkung 1 Ambulant Privat
	ambulant_private_remark2	Bemerkung 2 Ambulant Privat
therapy_alternative	therapy_alternative	Therapien Alternativ
	accident_therapy_alternative	Unfalldeckung Therapien Alternativ
	accident_therapy_alternative_add1	Therapien Alternativ-Zusatzfeld 1 (Sperre Online)
	accident_therapy_alternative_add2	Therapien Alternativ-Zusatzfeld 2
	accident_therapy_alternative_add3	Therapien Alternativ-Zusatzfeld 3
	accident_therapy_alternative_add4	Therapien Alternativ-Zusatzfeld 4
	therapy_alternative_remark1	Bemerkung 1 Therapien Alternativ
	therapy_alternative_remark2	Bemerkung 2 Therapien Alternativ
EUP	hospital_unit_eup	Spitalabteilung Spezialversich. EUP
	hospital_model_eup	Spital-Modell Spezialversich. EUP
	insurance_accident_eup	Unfalldeckung Spitalversich. Spezial_EUP
	hospital_special_add1_eup	Spital-Zusatzfeld 1 Spezial_EUP
	hospital_special_add2_eup	Spital-Zusatzfeld 2 Spezial_EUP
	hospital_special_add3_eup	Spital-Zusatzfeld 3 Spezial_EUP
	hospital_special_add4_eup	Zusatzfeld 4 (Sperre Online) EUP
	remark1_eup	Bemerkung 1 Spitalversich. Spezial_EUP
	remark2_eup	Bemerkung 2 Spitalversich. Spezial_EUP
KLV	basic_insurance_amb_klv	Basisversicherung ambulant nach KLV aus VVG
	basic_insurance_stat_klv	Basisversicherung stationär nach KLV aus VVG
	name_basic_insurance_klv	Bezeichnung Basisversicherung nach KLV aus VVG
	basic_insurance_accident_klv	Unfalldeckung Basisversicherung KLV aus VVG
	basic_insurance_klv_add1	Basisversicherung nach KLV Zusatzfeld 1 Spezial
	basic_insurance_klv_add2	Basisversicherung nach KLV Zusatzfeld 2 Spezial
	basic_insurance_klv_add3	Basisversicherung nach KLV Zusatzfeld 3 Spezial
	basic_insurance_klv_add4	Basisvers. nach KLV Zusatzfeld 4 (Sperre Online)
	basic_insurance_klv_remark1	Bemerkung 1 Basisversicherung nach KLV
	basic_insurance_klv_remark2	Bemerkung 2 Basisversicherung nach KLV
drugs_prevention	drugs_hors_liste_prevention	Medikamente Hors Liste (HL) Prävention
drugs_prevention	drugs_complementary_prevention	Medikamente Komplementärmedizin (KM) Prävention
Gatekeeper	ZSR	ZSR-Nummer des Gatekeepers
	name1	Nachname des Gatekeepers
	name2	Vorname des Gatekeepers
Free_text	Free_text4	Freier Text 04
	Free_text5	Freier Text 05
	Free_text6	Freier Text 06
	Free_text7	Freier Text 07
	Free_text8	Freier Text 08
	Free_text9	Freier Text 09
	Free_text10	Freier Text 10

Element	Beschreibung
street	Strasse
postbox	Adresszusatz
zip	Postleitzahl
city	Ort
countrycode	Land

Element	Beschreibung
Code	StammID der Daten
Text	Stammdatenwert in der übergebenen Sprache (siehe 2.3.2)

Element	Beschreibung
canton_name	Kantone, 2 stelliges offizielles Kürzel, siehe 2.5.3
remark	Bemerkung des Kantons
valid_from	Ab wann ist die AHV-Nummer auf der schwarzen Liste
valid_until	Wenn leer dann ist die AHV Nummer aktuell auf der Liste

Element	Beschreibung
canton_name	Kantone, 2 stelliges offizielles Kürzel, siehe 2.5.3
remark	Bemerkung des Kantons
valid_from	Ab wann ist die AHV-Nummer auf der schwarzen Liste
valid_until	Wenn leer dann ist die AHV Nummer aktuell auf der Liste

Element	Beschreibung
official_familynames	Offizielle(r) Familienname(n) gemäss ZAS
official_givennames	Offizielle(r) Vorname(n) gemäss ZAS
official_birthdate	Offizielles Geburtsdatum gemäss ZAS
official_gender	Offizielles Geschlecht (Inhalt siehe 2.2.11)

2. 5 Stammdaten

2.5.1 Basisversicherung (GV)

ID	Bezeichnung Basisversicherung KVG
00	Keine Deckung OKP gemäss KVG
01	Deckung OKP gemäss KVG

Abschliessende Definition

2.5.2 Modell Grundversicherung (GV-MODELL)

ID	*Bezeichnung Modell Grundversicherung KVG*
00	Keine Grundversicherung
01	Standard-Modell gemäss KVG
02	Hausarzt-Modell gemäss KVG
03	HMO-Modell gemäss KVG
04	Listen-Modell gemäss KVG
05	Telefonmodell gemäss KVG
06	Apotheken-Modell
99	Spezialmodell gemäss KVG (genauere Bezeichnung ins Bemerkungsfeld)

Abschliessende Definition

2.5.3 Wohnkanton (KANTON)

ID	*Bezeichnung Wohnkanton für KVG-Deckung*
00	Keine Grundversicherung
AG	Aargau
AI	Appenzell Innerrhoden
AR	Appenzell Ausserrhoden
BE	Bern
BL	Basel-Landschaft
BS	Basel-Stadt
FR	Freiburg
GE	Genf
GL	Glarus
GR	Graubünden
JU	Jura
LU	Luzern
NE	Neuenburg
NW	Nidwalden
OW	Obwalden
SG	St. Gallen
SH	Schaffhausen
SO	Solothurn
SZ	Schwyz
TG	Thurgau
TI	Tessin
UR	Uri
VD	Waadt
VS	Wallis
ZG	Zug
ZH	Zürich
99	Ausland
FL	Fürstentum Liechtenstein

Abschliessende Definition gemäss Autokennzeichen, ohne FL

2.5.4 Unfalldeckung Grundversicherung (GV-UNFALL)

ID	*Bezeichnung Unfalldeckung Grundversicherung*
00	Keine Unfalldeckung gemäss KVG
01	Unfalldeckung gemäss KVG

Abschliessende Definition

2.5.5 Medikamente Hors Liste (MEDI-HL)

ID	*Bezeichnung Hors Liste (HL)*
00	Keine Deckung für Medikamente gemäss Hors Liste
01	Deckung für Medikamente gemäss Hors Liste
02	Eingeschränkte Deckung für Medikamente gemäss Hors Liste

Abschliessende Definition

2.5.6 Unfalldeckung Hors Liste (MEDI-HL_UNFALL)

ID	*Bezeichnung Unfalldeckung für Hors Liste (HL)*
00	Keine Unfalldeckung für Medikamente gemäss Hors Liste
01	Unfalldeckung für Medikamente gemäss Hors Liste

Abschliessende Definition

2.5.7 Medikamente Komplemetärmedizin (MEDI-KM)

ID	*Bezeichnung Komplementärmedizin (KM)*
00	Keine Deckung für Medikamente Komplementärmedizin
01	Deckung für Medikamente Komplementärmedizin
02	Eingeschränkte Deckung für Medikamente Komplementärmedizin

Abschliessende Definition

2.5.8 Unfalldeckung KM (MEDI-KM-UNFALL)

ID	*Bezeichnung Unfalldeckung Komplementärmedizin (KM)*
00	Keine Unfalldeckung für Medikamente Komplementärmedizin
02	Eingeschränkte Unfalldeckung für Medikamente Komplementärmedizin
01	Unfalldeckung für Medikamente Komplementärmedizin

Abschliessende Definition

2.5.9 Spitalabteilung VVG (ABT)

ID	*Bezeichnung VVG-Spitalabteilung*
00	Keine VVG-Spitalabteilung
01	Allgemeine Spitalabteilung ganze Schweiz
02	Halbprivate Spitalabteilung VVG
03	Private Spitalabteilung VVG
04	Summenversicherung VVG
05	Privat-Abteilung Weltweit VVG
06	Privat-Abteilung Europa VVG

Abschliessende Definition

2.5.10 Spitalabteilungsmodell Zusatzversicherung (ZV-MODELL)

ID	*Bezeichnung für VVG-Spitalmodell (Komfort und Arztwahl)*
10	Mehrbettzimmer ohne freier Arztwahl (ABT=01)
20	Zweierzimmer mit freier Arztwahl (ABT=02, 01)
30	Einerzimmer mit freie Arztwahl (ABT=03, 02, 01)
40	Wahl der Spitalabteilung bei Eintritt (ABT=01, 04)
50	Zweierzimmer ohne freie Arztwahl (ABT=01)
60	Einerzimmer ohne freie Arztwahl (ABT=01)
70	Mehrbettzimmer mit freier Arztwahl (ABT=01, 04)
00	Keine VVG-Spitaldeckung (ABT=00)

Abschliessende Definition

2.5.11 Unfalldeckung Zusatzvers. Spitalabteilung (ZV-UNFALL)

ID	*Bezeichnung Unfalldeckung Spitalversicherung*
00	Keine Unfalldeckung für Spitalversicherung gemäss VVG
01	Unfalldeckung für Spitalversicherung gemäss VVG

Abschliessende Definition

2.5.12 Einschränkung Spitaldeckung (ZV-AKUT)

ID	*Bezeichnung Einschränkungen Akutsomatik (ohne persönliche Vorbehalte)*
01	Keine Einschränkung Akutsomatik VVG
02	Mit Einschränkung Akutsomatik VVG (z.B. Mutterschaft)
00	Keine Deckung Akutsomatik VVG

Abschliessende Definition

2.5.13 Einschränkung Spitaldeckung (ZV-PSYCH)

ID	*Bezeichnung Einschränkungen Psychiatrie (ohne persönliche Vorbehalte)*
01	Keine Einschränkung Psychiatrie VVG
02	Mit Einschränkung Psychiatrie VVG (Limitierte Beträge und Dauer)
00	Keine Deckung Psychiatrie VVG

Abschliessende Definition

2.5.14 Einschränkung Spitaldeckung (ZV-LISTE)

ID	*Bezeichnung Einschränkungen Spitalliste (ohne persönliche Vorbehalte)*
01	Keine Einschränkung durch Spitalliste VVG (ganze CH, öffentliche/private Spitäler
02	Mit Einschränkung durch Spitalliste VVG (Spitalliste Versicherer)
00	Keine Deckung Spitalliste VVG

Abschliessende Definition

2.5.15 Produkte Versicherer GV (GV-PROD)

ID	*Bezeichnung Produkt Grundversicherung*
01	Produkt X
02	Produkt Y

2.5.16 Produkte Versicherer ZV (ZV-PROD)

ID	*Bezeichnung Produkt Zusatzversicherung*
01	Produkt X
02	Produkt Y

Page tree

VeKa-Center Webservice

1 Der VeKa-Abfrage-Webservice

1.1 Vorwort

1.2 Endpoint

1.3 Graphische Darstellung

1.3.1 Request

1.3.2 Rückgabestruktur

1.3.3 Beispiel einer kompletten SOAP Anfrage

Anfragestruktur

Rückgabestruktur

1.4 Rückmeldungen (ReturnValue) des Webservice

2 Detaillierte Beschreibung der Knoten

2.1 Einleitung

2.2 Allgemeine Datentypen

2. 3 Abfrage beim VeKa (Request)

2.3.1 Abfragestruktur «VeKa Request»

2. 4 Rückmeldung beim VeKa (Response)

2.4.1 Abfragestruktur «VeKa Response»

2. 5 Stammdaten

2.5.1 Basisversicherung (GV)

2.5.2 Modell Grundversicherung (GV-MODELL)

2.5.3 Wohnkanton (KANTON)

2.5.4 Unfalldeckung Grundversicherung (GV-UNFALL)

2.5.5 Medikamente Hors Liste (MEDI-HL)

2.5.6 Unfalldeckung Hors Liste (MEDI-HL_UNFALL)

2.5.7 Medikamente Komplemetärmedizin (MEDI-KM)

2.5.8 Unfalldeckung KM (MEDI-KM-UNFALL)

2.5.9 Spitalabteilung VVG (ABT)

2.5.10 Spitalabteilungsmodell Zusatzversicherung (ZV-MODELL)

2.5.11 Unfalldeckung Zusatzvers. Spitalabteilung (ZV-UNFALL)

2.5.12 Einschränkung Spitaldeckung (ZV-AKUT)

2.5.13 Einschränkung Spitaldeckung (ZV-PSYCH)

2.5.14 Einschränkung Spitaldeckung (ZV-LISTE)

2.5.15 Produkte Versicherer GV (GV-PROD)

2.5.16 Produkte Versicherer ZV (ZV-PROD)