MitarbeiterWebservice - Vertragsverwaltung
Funktionen
Detaildaten
☛ MitarbeiterWebservice - Vertragsverwaltung - Detaildaten
addVertrag
Legt einen Vertrag an.
Beispiele
POST ${path}/${ma}/vertraege HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Content-Length: 278
Connection: close
{
"Status": "F",
"Gesellschaft": "10330",
"Kunde": "123456",
"Sparte": "050",
"Beitrag": {
"Brutto": 100,
"Zahlweise": "5"
},
"Laufzeit": {
"Beginn": "2010-01-01",
"Ablauf": "2016-12-31"
},
"Risiko": "",
"Antragsnummer": "",
"Versicherungsscheinnummer": "123-546",
"Adresse": "0",
"Bankkonto": {
"IBAN": "",
"BIC": "",
"Inhaber": {
"Abweichend": false
}
}
}
HTTP/1.1 200 OK
Content-Type: application/json
Transfer-Encoding: chunked
Connection: close
{
"Uri": "https:\/\/www.maklerinfo.biz\/service\/bd\/employee\/1.0\/rest\/123456_123456\/vertraege\/1475",
"Id": "1475",
"PublicID": "3b1584f5187fca7",
"Vermittler": "123456",
"Kunde": "123456",
"Sparte": "050",
"Gesellschaft": "10330",
"Versicherungsscheinnummer": "123-546",
"Beitrag": {
"Zahlweise": "5",
"Netto": 84.0336134454,
"Brutto": 100,
"Steuer": 19
},
"Risiko": null,
"Antragsnummer": null,
"Status": "F",
"Laufzeit": {
"Beginn": "2010-01-01",
"Ablauf": "2016-12-31"
},
"Adresse": "0",
"Bankkonto": {
"IBAN": null,
"BIC": null,
"Bankname": null,
"Inhaber": {
"Abweichend": false,
"Vorname": null,
"Nachname": null,
"Geburtsdatum": null,
"Strasse": null,
"Postleitzahl": null,
"Ort": null,
"Land": null
}
}
}
getVertraege
Gibt die Verträge eines Kunden zurück.
getVertragBestandsuebertragungDetails
Gibt die informationen einer Bestandsübertragung eines Vertrages zurück.
getVertragMahnungen
Gibt die Vertrag Mahnungen eines Kunden zurück.
Beispiele
GET ${path}/${ma}/vertraege/${vertrag-id}/mahnungen HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Content-Length: 278
Connection: close
HTTP/1.1 200 OK
Content-Type: application/json
Transfer-Encoding: chunked
Connection: close
[
{
"Datum": "2016-01-12"
},
{
"Datum": "2016-02-23"
},
[...]
]
getVertragsDokumente
Gibt alle dem Vertrag zugeordnete, nicht ausgeblendete Archiveinträge
vom Typ "dokument" und vorhandener Datei zurück.
getVertragStatusAnzahl
Gibt alle VertragStatus zurück und die Anzahl der Verträge in abhängigkeit der gesellschaften
Eingabeparameter:
Gesellschaft-IDs |
string | array |
mind. eine ID muss angegeben werden ( Bsp: gesellschaftIds=00000,11111 oder gesellschaftIds[0]=00000&gesellschaftIds[1]=11111 |
Beispiel
Request GET
GET ${path}/${ma}/vertragstatus-counts/?gesellschaftIds[1]=10002&gesellschaftIds[2]=00000 HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Connection: close
Response
GET ${path}/${ma}/vertragstatus-counts/?gesellschaftIds[1]=10002&gesellschaftIds[2]=00000 HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Connection: close
[
{
"Status": "B",
"Text": "B - beantragt",
"Anzahl": 6,
"Aktiv": false,
"Beantragt": true,
"Storniert": false
},
{
"Status": "A",
"Text": "A - aktiv",
"Anzahl": 2,
"Aktiv": true,
"Beantragt": false,
"Storniert": false
},
[...]
]
getVertragVorversicherung
Gibt die Vorversicherung des Vertrages zurück.
Beispiele
GET ${pfad}/${ma}/vertraege/${Vertrag-Id}/vorversicherung HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
HTTP/1.1 200 OK
Connection: close
Content-Type: application/json
{
"Uri": "https:\/\/www.maklerinfo.biz\/service\/bd\/employee\/1.0\/rest\/999999\/vertraege\/176/vorversicherung",
"Id": "176",
"Vermittler": "999999",
"Policennummer": "2164651679835",
"Gesellschaft": "Tester",
"Beginn": "2019-05-01",
"Ablauf": "2020-05-25",
"Status":"Gek\u00fcndigt durch Gesellschaft"
}
setVertragVorversicherung
Bearbeitung der Vertrags Vorversicherung.
Beispiele
PUT ${pfad}/${ma}/vertraege/${Vertrag-Id}/vorversicherung HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Content-Length: 212
Connection: close
{
"Policennummer": "2164651679835",
"Gesellschaft": "Tester",
"Beginn": "2019-05-01",
"Ablauf": "2020-05-25",
"Status": "ges"
}
HTTP/1.1 200 OK
Connection: close
Content-Type: application/json
{
"Uri": "https:\/\/www.maklerinfo.biz\/service\/bd\/employee\/1.0\/rest\/999999\/vertraege\/176/vorversicherung",
"Id": "176",
"Vermittler": "999999",
"Policennummer": "2164651679835",
"Gesellschaft": "Tester",
"Beginn": "2019-05-01",
"Ablauf": "2020-05-25",
"Status":"Gek\u00fcndigt durch Gesellschaft"
}
getVertragVorschaeden
Gibt die Vorschäden des Vertrages zurück.
Beispiele
GET ${pfad}/{$ma}/vertraege/${Vertrag-Id}/vorschaeden HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
HTTP/1.1 200 OK
Content-Type: application/json
Transfer-Encoding: chunked
Connection: close
{
"Schaeden": [
{
"Id": "ae06d16f",
"Text": "Tester test",
"Datum": null,
"Schadenshoehe": "965.63"
"SchadenZusatzfelder": [
{
"Feld": "art",
"Text": "Art des Schadens",
"Wert": "vk"
}
]
},
{
"Id": "71f2a4f3",
"Text": "Tester test2",
"Datum": "2020-01-27",
"Schadenshoehe": "78.00",
"SchadenZusatzfelder": []
}
]
}
addVertragVorschaeden
Legt einen Vorschaden zum Vertrag an.
Beispiele
POST ${pfad}/{$ma}/vertraege/${Vertrag-Id}/vorschaeden HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Content-Length: 66
Connection: close
{
"Schadenshoehe":"2.99",
"Datum":1580079600,
"Text":"zeh gestossen",
"SchadenZusatzfelder": [
{
"Feld": "art",
"Wert": "vk"
}
]
}
HTTP/1.1 200 OK
Content-Type: application/json
Transfer-Encoding: chunked
Connection: close
{
"Id": "0bd49669"
}
handleServeOrder
serviciert Verträge mit dem Status "E".
Eingabeparameter:
Versand |
boolean |
Wenn der Wert nicht true ist, wird ein neuer Eintrag im Antragspilot angelegt. |
Beispiel
Request POST
POST ${pfad}/{$ma}/vertraege/${Vertrag-Id}/serviciereAntrag HTTP/1.1
Host: www.maklerinfo.biz
${Auth}
Content-Type: application/json
Content-Length: 22
Connection: close
{
"Versand": false
}
Response
HTTP/1.1 200 OK
Content-Length: 42
Content-Type: application/json
{
"Meldungen":"Der Antrag wurde angelegt."
}
Datentypen
Vertrag
Beitrag
Laufzeit
BestandsuebertragungDetails
Bankkonto
KontoInhaber
Abweichend |
boolean |
Ist der Kontoinhaber abweichend zum Versicherungsnehmer des Vertrages |
Vorname |
string |
|
Nachname |
string |
|
Geburtsdatum |
Date |
|
Strasse |
string |
|
Postleitzahl |
string |
|
Ort |
string |
|
Land |
EnumValue |
getLaender |
VertragMahnung
VertragStatusAnzahl
Status |
string |
Vertragsstatus |
Text |
string |
|
Anzahl |
integer |
|
Aktiv |
boolean |
|
Beantragt |
boolean |
|
Storniert |
boolean |
|
Vorversicherung
Vorschaeden
Name |
Datentyp |
Beschreibung |
Id |
string |
|
Text |
string |
|
Datum |
Date |
|
Schadenshoehe |
double |
|
SchadenZusatzfelder |
Array |
ArrayOf VorschaedenZusatzfelder |
VorschaedenZusatzfelder
Name |
Datentyp |
Beschreibung |
Feld |
string |
|
Text |
string |
|
Wert |
string |
|
Vorschaden
Name |
Datentyp |
Beschreibung |
Text |
string |
|
Datum |
Timestamp |
|
Schadenshoehe |
double |
|
SchadenZusatzfelder |
Array |
ArrayOf VorschadenZusatzfelder |
VorschadenZusatzfelder
Name |
Datentyp |
Beschreibung |
Feld |
string |
|
Wert |
string |
|