MitarbeiterWebservice - Vertragsverwaltung - Detaildaten

Funktionen

Name	HTTP	Eingabe	Ausgabe
getSpartenProductTemplate	GET ${pfad}/sparten/${Sparte-Id}/produkttemplate		JSON ProduktTemplate
getVertragProdukte	GET ${pfad}/{$ma}/vertraege/${Vertrag-Id}/produkte		JSON ProduktKomponenten
patchVertragProdukte	PATCH ${pfad}/{$ma}/vertraege/${Vertrag-Id}/produkte	JSON ArrayOf AktualisierungsAnweisung
putVertragProduktKraftfahrtPKWHalterUndFahrer	PUT ${pfad}/{$ma}/vertraege/${Vertrag-Id}/produkte	JSON AnlageAnweisung

getSpartenProductTemplate

Sollte die Sparte des Vertrages keine Detaildaten unterstützen wird ein 404 Fehler zurückgegeben

getVertragProdukte

Sollte die Sparte des Vertrages keine Detaildaten unterstützen wird ein 404 Fehler zurückgegeben

patchVertragProdukte

Sollte die Sparte des Vertrages keine Detaildaten unterstützen wird ein 404 Fehler zurückgegeben

putVertragProduktKraftfahrtPKWHalterUndFahrer

Beispiele

Request (formatiert)

PUT ${pfad}/{$ma}/vertraege/${Vertrag-Id}/produkte
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Content-Length: 976

{
  "Halter": {
    "Beziehungswert": "2",
    "Vorname": "vorname",
    "Nachname": "nachname",
    "Geburtsdatum": "123",
    "Geschlecht": "2",
    "Personentyp": "2",
    "Strasse": "straße",
    "PLZ": "plz",
    "Ort": "ort"
  },
  "Fahrer": [
    {
      "Beziehungswert": "2",
      "Vorname": "Vorname1",
      "Nachname": "Nachname1",
      "Geburtsdatum": "959530413",
      "Geschlecht": "2",
      "Fuehrerschein seit": "1590682413",
      "Teilnahme am begleiteten Fahren": "0",
      "Familienstand": "2",
      "Berufliche Stellung": "1",
      "In haeuslicher Gemeinschaft mit VN": "0"
    },
    {
      "Beziehungswert": "3",
      "Vorname": "Vorname2",
      "Nachname": "Nachname2",
      "Geburtsdatum": "991066413",
      "Geschlecht": "1",
      "Fuehrerschein seit": "1622218413",
      "Teilnahme am begleiteten Fahren": "1",
      "Familienstand": "1",
      "Berufliche Stellung": "2",
      "In haeuslicher Gemeinschaft mit VN": "1"
    }
  ]
}

Response (formatiert)

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 0
Connection: close

Sollte die Sparte des Vertrages keine Detaildaten unterstützen wird ein 404 Fehler zurückgegeben

KomponentenPfad

Die Pfade setzen sich anhand der Definitionen aus dem ProduktTemplate wie folgt zusammen:

DefinitionTyp[Definition.Name]/DefinitionTyp[Definition.Name] ...
Beispiel:

Produkt[Haftpflicht]/Elementarprodukt[Privathaftpflicht]/VersichertesRisikoOderWagniss[Versicherte Person]/VariableWert[Vorname]

Sollten in Definition.Name Schrägstriche "/" enthalten sein, müssen diese mit einem Rückwärtsschrägstrich "\" maskiert werden: Produkt[Haftpflicht]/Elementarprodukt[Privathaftpflicht]/VariableWert[Anmerkungen \/ Besonderheiten]

☛nicht existierende Komponenten werden automatisch erstellt
☛ setzen wird nur für VariableWert unterstützt
☛ löschen wird nicht für VariableWert unterstützt (stattdessen wert auf null setzen)

Beispiel Privathafpflicht: setzen unterschiedlicher Werte sowie löschen des Lebenspartners

[
    {"Setze":"Produkt[Haftpflicht]\/Elementarprodukt[Privathaftpflicht]\/VersichertesRisikoOderWagniss[Versicherte Person]\/VariableWert[Vorname]","Wert":"Max"},
    {"Setze":"Produkt[Haftpflicht]\/Elementarprodukt[Privathaftpflicht]\/VariableWert[Selbstbeteiligung]","Wert":150},
    {"Setze":"Produkt[Haftpflicht]\/Elementarprodukt[Privathaftpflicht]\/VariableWert[Diensthaftpflicht]","Wert":3},
    {"Setze":"Produkt[Haftpflicht]\/Elementarprodukt[Privathaftpflicht]\/VersicherungssummeOderLeistung[Deckungssummen]\/VariableWert[Personensch\u00e4den]","Wert":1000000},
    {"Setze":"Produkt[Haftpflicht]\/Elementarprodukt[Privathaftpflicht]\/VersicherungssummeOderLeistung[Deckungssummen]\/VariableWert[unbegrenzte Sachsch\u00e4den]","Wert":true},
    {"Loesche":"Produkt[Haftpflicht]\/Elementarprodukt[Privathaftpflicht]\/VersichertesRisikoOderWagniss[Lebenspartner]"}
]

Datentypen

ProduktTemplate

Name	Datentyp	Beschreibung
Versicherungsnehmer	DefinitionVersichertesRisikoOderWagniss
Produkte	ArrayOf DefinitionProdukt

Definition

Name	Datentyp	Beschreibung
Id	string
Name	string
Mindestanzahl	integer
Maximalanzahl	integer
Sortierung	integer

DefinitionProduktbaustein

Erbt von Definition

Name	Datentyp	Beschreibung
Variablen	ArrayOf DefinitionVariable
VersicherteRisikenUndWagnisse	ArrayOf DefinitionVersichertesRisikoOderWagniss
VersicherungssummenUndLeistungen	ArrayOf DefinitionVersicherungssummeOderLeistung

DefinitionProdukt

Erbt von DefinitionProduktbaustein

Name	Datentyp	Beschreibung
Elementarprodukte	ArrayOf DefinitionElementarprodukt

DefinitionElementarproduktProdukt

Erbt von DefinitionProduktbaustein

DefinitionVersichertesRisikoOderWagniss

Erbt von Definition

Name	Datentyp	Beschreibung
Variablen	ArrayOf DefinitionVariable
VersicherteRisikenUndWagnisse	ArrayOf DefinitionVersichertesRisikoOderWagnissBeziehung

DefinitionVersichertesRisikoOderWagnissBeziehung

Name	Datentyp	Beschreibung
Rolle	string
Mindestanzahl	integer
Maximalanzahl	integer
Sortierung	integer
Beziehungsvariable	DefinitionVariable
VersichertesRisikoOderWagniss	DefinitionVersichertesRisikoOderWagniss

DefinitionVersicherungssummeOderLeistung

Erbt von Definition

Name	Datentyp	Beschreibung
Variablen	ArrayOf DefinitionVariable

DefinitionVariable

Erbt von Definition

Name	Datentyp	Beschreibung
Datentyp	string	boolean,integer,decimal,amount,text,date,list
Standardwert	je nach Datentyp
Eigenschaften	object	je nach Datentyp
Gruppe	string	variablen der gleichen Gruppe können zusammengefasst werden

ProduktKomponenten

Name	Datentyp	Beschreibung
Versicherungsnehmer	VersichertesRisikoOderWagniss
Produkte	ArrayOf Produkt

Komponente

Name	Datentyp	Beschreibung
Id	string
Definition	string	Id der Definition
Titel	string	kann den Namen der Definition überschreiben

Produktbaustein

Erbt von Komponente

Name	Datentyp	Beschreibung
Werte	ArrayOf VariableWert
VersicherteRisikenUndWagnisse	ArrayOf VersichertesRisikoOderWagniss
VersicherungssummenUndLeistungen	ArrayOf VersicherungssummeOderLeistung

Produkt

Erbt von Produktbaustein

Name	Datentyp	Beschreibung
Elementarprodukte	ArrayOf Elementarprodukt

Elementarprodukt

Erbt von Produktbaustein

VersichertesRisikoOderWagniss

Erbt von Komponente

Name	Datentyp	Beschreibung
Werte	ArrayOf VariableWert
VersicherteRisikenUndWagnisse	ArrayOf VersichertesRisikoOderWagniss

VersichertesRisikoOderWagnissBeziehung

Name	Datentyp	Beschreibung
Rolle	string
Beziehungswert	je nach Datentyp
VersichertesRisikoOderWagniss	VersichertesRisikoOderWagniss

VersicherungssummeOderLeistung

Erbt von Komponente

Name	Datentyp	Beschreibung
Werte	ArrayOf VariableWert

VariableWert

Name	Datentyp	Beschreibung
Id	string	Id der Definition
Wert	je nach Datentyp	wenn Maximalanzahl in der Definition gleich 1
Werte	ArrayOf je nach Datentyp		wenn Maximalanzahl in der Definition größer als 1

AktualisierungsAnweisung

abstrakt SetzAnweisung oder LoeschAnweisung

SetzAnweisung

Name	Datentyp	Beschreibung
Setze	string	KomponentenPfad zur Variablen dessen Wert geändert werden soll
Wert	je nach Datentyp

LoeschAnweisung

Name	Datentyp	Beschreibung
Loesche	string	KomponentenPfad zur Komponente die gelöscht werden soll

AnlageAnweisung

Name	Datentyp	Beschreibung
Halter	Halter	Vertragsdetails eines Halters
Fahrer	ArrayOf Fahrer	Vertragsdetails von Fahrern

Halter

Name	Datentyp	Beschreibung
Beziehungswert	StringOf Halter-Beziehungswert	Haltertyp
Vorname	string
Nachname	string
Geburtsdatum	StringOf UTC-Zeitstempel
Geschlecht	StringOf [1,2]	1 = männlich, 2 = weiblich
Personentyp	StringOf [1,2]	1 = natürliche Person, 2 = juristische Person (Firma)
Strasse	string
PLZ	string
Ort	string

Fahrer

Name	Datentyp	Beschreibung
Beziehungswert	StringOf Fahrer-Beziehungswert	Fahrer-Typ
Vorname	string
Nachname	string
Geburtsdatum	StringOf UTC-Zeitstempel
Geschlecht	StringOf [1,2]	1 = männlich, 2 = weiblich
Fuehrerschein seit	StringOf UTC-Zeitstempel
Teilnahme am begleiteten Fahren	StringOf [0,1]	0 = Nein, 1 = Ja
Familienstand	StringOf [1,2,3]	1 = ledig, 2 = verheiratet, 3 = Lebensgemeinschaft
Berufliche Stellung	string
In haeuslicher Gemeinschaft mit VN	StringOf [0,1]	0 = Nein, 1 = Ja

Halter-Beziehungswert

Name	Value
Versicherungsnehmer	1
Ehe-/Lebenspartner	2
Sohn/Tochter des Versicherungsnehmers	3
behindertes Kind	4
Leasinggeber	5
Sonstige	6

Fahrer-Beziehungswert

Name	Value
Versicherungsnehmer	1
Ehe-/Lebenspartner	2
Kind	3
Sonstige	4
Beliebige	5