Webhook API - Kunden erstellen

Sie senden Ihre Kunden-Daten an unsere API und wir erstellen Ihnen diesen Kunden in unserem System. Wenn der Kunden bereits existiert, wird dieser aktualisiert.

Kunden-Daten

Parameter Datentyp Beschreibung Notwendigkeit
login_token UUID (v5)
char(36)
Authentifizierungs-Token Pflichtfeld
id integer
mediumint(8) unsigned
Policenwerk-Makler-ID unterhalb derer der Kunde angelegt/geupdated wird Pflichtfeld
anrede integer
tinyint(3)
Anrede (siehe Vordefinierte Werte) Optional
titel integer
tinyint(3)
Titel (siehe Vordefinierte Werte) Optional
vorname string
varchar(100)
Vorname des Kunden Pflichtfeld
nachname string
varchar(100)
Nachname des Kunden Pflichtfeld
geburtstag date
YYYY-MM-DD
Geburtstag des Kunden Pflichtfeld
strasse string
varchar(150)
Strasse Pflichtfeld
hausnr string
varchar(10)
Hausnummer Pflichtfeld
plz string
varchar(7)
Postleitzahl Pflichtfeld
ort string
varchar(100)
Wohnort Pflichtfeld
land integer
tinyint(3) unsigned
Länderkennzeichen, erlaubte Werte: 1=DE, 2=AT, 3=CH. Kunden aus anderen Ländern werden nicht angenommen. Pflichtfeld
tel string
varchar(20)
Telefon oder Mobil-Nummer Optional
email string
varchar(100)
E-Mail Adresse Optional
kontoinhaber string
varchar(200)
Kontoinhaber (falls abweichend) Optional
iban string
varchar(22)
IBAN Bankverbindung Pflichtfeld

Nur bei Kunden mit Firmenadresse

Parameter Datentyp Beschreibung Notwendigkeit
firma string
varchar(50)
Firmenname (vollständig mit Rechtsform) Optional
ustid string
varchar(20)
Umsatzsteuer ID Nummer Optional
handelsr_nr string
varchar(20)
Handelsregister Nummer Optional
handelsr string
varchar(100)
Handelsregister Optional

URL

https://login.policenwerk.de/api/createCustomer.php

Antwort bei Erfolg (JSON)

Antwort bei Fehler (JSON)

Beispiel Webhook