1 Der VeKa-Abfrage-Webservice
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 |
---|---|
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 | Zuviele Treffer (evtl. auch Fehllieferungen der Versicherer) |
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
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) |
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
|
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. |