Mit diesem Webservice können Sie Verträge aus dem FKS System abrufen. Entweder über GET- oder POST-Requests (Formular,Link). Der Service ist gewöhnlich durch ein ht-access geschützt. Den vollständigen aufrufenden Link erhalten Sie von FKS, sowie Passwort und Username (username, password). Die Werte „username“, „password“ und „orgid“ bleiben immer konstant.

Dem Aufruf muss die Variable „customerid“ mitgegeben werden, um alle Verträge zu einem Kunden abzufragen. Die „cutomerid“ entspricht der KONTAKT_ID in FKS (eindeutige ID), die man über den Web-Service „doc_contacts_json.php“ abfragen kann.

Nur wenn man die Variable „$TAG“ mit sendet (siehe Einschränkungen weiter unten), kann man die Variable „customerid“ leer lassen oder nicht mitgeben.

Skriptpfad: json/doc_contracts_json.php

Beispielaufruf: http://www.fks-xxxxx.de/soap_xxx/doc_contracts_json.php?username=xxxxxxx&password=f4ebdf8bf01ac377xxxxxxxx&orgid=999&customerid=13

Folgende Felder können über den Service abgefragt werden:

„kunden_vertraege“ Tabelle (und diverse Untertabellen):

$VERTRAGSNUMMER
$ANTRAGSNUMMER
$VERTRAGSSTATUS_GESAMT –> der Status des Vertrags über alle Tarife (z.B. policiert, storniert…)
$VU –> (Versicherungs-) Gesellschaft (VU)
$SPARTE –> z.B. Krankenversicherung, Lebensversicherung….
$BEGINN –> Vertragsbeginn - Format: YYYY-mm-dd
$ANTRAG_AM –> Antragsdatum des Vertrags - Format: YYYY-mm-dd
$POLICIERT_AM –> Policierungsdatum des Vertrags - Format: YYYY-mm-dd
$STORNIERT_AM –> Stornierungsdatum des Vertrags - Format: YYYY-mm-dd
$LZ –> Laufzeit (1, 24….)
$LZ_ART –> Laufzeit Art: Jahr, Monate
$ZW –> Zahlweise (monatlich, jährlich…)
$TARIFE –> (siehe Tabelle „kunden_vertraege_tarife“, 1:n)
$KUNDEN_VERTRAEGE_ID –> eindeutige FKS interne ID des Vertrages
$KATEGORIE –> Unterkategorie der Sparte (Risikolebensversicherung, Hundehaftpflichtversicherung….)
$KONTAKT_ID_KUNDE –> eindeutige FKS ID mit Bezug zum Kunden (KONTAKT_ID)
$HAUPTFAELLIGKEIT_MONAT –> Monat der nächsten Zahlungshauptfälligkeit (z.B. „4“)
$HAUPTFAELLIGKEIT_TAG –> Tag der nächsten Zahlungshauptfälligkeit (z.B. „31“)
$ABLAUF_AM –> Ablaufsdatum des Vertrags (automatisch über Laufzeit berechnet) - Format: YYYY-mm-dd
$ABLAUF_MANUELL –> Ablaufsdatum des Vertrags manuell überschrieben (manuell gepflegt) - Format: YYYY-mm-dd\
$LETZTE_AENDERUNG –> Zeitstempel der letzten Änderung - Format: YYYY-mm-dd HH:ii:ss

„kunden_vertraege_tarife“ Tabelle (und diverse Untertabellen):

$TARIF –> Name des Tarifs
$VERTRAGSSTATUS –> Status des Einzeltarifs (z.B. policiert, storniert…)
$NETTO_PA –> Beitrag pro Jahr ohne Versicherungssteuer, Abschläge, Zuschläge, Gebühren….
$BRUTTO_PA –> Beitrag pro Jahr inkl. Versicherungssteuer, Abschläge, Zuschläge, Gebühren….
$BRUTTO_ZW –> Beitrag nach Zahlweise inkl. Versicherungssteuer, Abschläge, Zuschläge, Gebühren….
$NETTO_ZW –> Beitrag nach Zahlweise ohne Versicherungssteuer, Abschläge, Zuschläge, Gebühren….
$VS_STEUER –> Versicherungssteuer in Prozent
$BWS –> Bewertungssumme (Provisions relevant)
$RISIKO –> Risiko des Tarifs: z.B. Adresse, Person, KFZ….
$DYNAMIK –> Dynamik in Prozent
$VS –> Versicherungssumme
$RISIKOZUSCHLAG –> Risikozuschlag in Prozent
$RATENZUSCHLAG –> Ratenzuschlag in Prozent
$SONSTIGERZUSCHLAG –> sonstiger Zuschlag in Prozent
$GEBUEHR –> Gebühr als Betrag
$ABWEICHENDER_ZAHLBEITRAG –> Zahlbeitrag des Kunden, abweichend vom provisionsrelevanten Beitrag
$MONATLICHE_RENTE –> monatliche Rentenauszahlung

Einschränkungen:

Die Abfrage kann durch folgende Parameter eingeschränkt werden:

$einschraenkung_test2: Diese Variable ist nur zu Testzwecken; hier kann der erlaubte Export eingeschränkt werden

$TAG: Wenn Sie hier z.B. den Wert 5 mitgeben, werden alle Kontakte exportiert, die sich in den letzten 5 Tagen verändert haben

Pflichtfelder $customerid oder $TAG,$username,$orgid,$password

— Bernd Diederich 2015/05/19 14:11