Datenmapping und Output

Datenmapping

Die API unterstützt mehrere Datenfeld-Mappings, was bedeutet, dass spezifische Mappings für verschiedene Datentypen definiert werden können, z.B. separate Mappings für Privatpersonen und Firmen oder für bestimmte Kundengruppen. Pro Batch-Verarbeitungslauf lässt sich das passende Mapping auswählen, wobei wir empfehlen, das initiale Mapping möglichst stabil zu halten, um Konsistenz zu gewährleisten.

Unser Data-Mapper ermöglicht es, die Datenfelder im Rahmen des Projekts präzise auf unsere Strukturen abzustimmen.

Output-Datensatz

Format: Der Output wird als Textdatei im TSV-Format (UTF-8) bereitgestellt.

Datenfelder

Feld	Bezeichnung	Hinweis
input_customerId	Kunden-ID
input_uid	Unternehmens-Identifikationsnummer UID
input_chnr	Handelsregisternummer
input_egid	Eidgenössische Gebäudeidentifikator (EGID)
input_postaddressId	Postadresse-ID
input_name	Name
input_company	Firma
input_firstname	Vorname
input_street	Strasse
input_houseNo	Hausnummer
input_zip	Postleitzahl
input_location	Ort
input_birthdate	Geburtsdatum
input_email	E-Mail
input_phone	Telefonnummer
input_mobile	Mobiltelefon
input_firstname_notexists	Boolesches Feld, das angibt, ob ein Eingabefeld übergeben wurde
input_lastname_notexists
input_zip_notexists
input_ziprange_notexists
input_town_notexists
input_street_notexists
input_hno_notexists
output_status	Status	Aktualisierungs-Status
output_dwhid	DWH-ID
output_source	Quelle
output_salutation	Anrede
output_acadtitle	Akademischer Titel
output_acadtitlelabel	Akademischer Titel
output_company	Firma
output_name	Nachname
output_firstname	Vorname
output_careof1	Care-of 1
output_careof2	Care-of 2
output_street	Strasse
output_streetadditional	Zusätzliche Strasse
output_houseno	Hausnummer
output_zip	Postleitzahl
output_zip6	Postleitzahl (6-stellig)
output_location	Ort
output_countrycode	Ländercode
output_postboxflag	Postfachadresse ja / nein
output_postbox	Postfach
output_postboxzip	Postfach PLZ
output_postboxzip6	Postfach PLZ (6-stellig)
output_postboxlocation	Postfach Ort
output_language	Sprache
output_addresslabel1	Felder für die Postanschrift, formatiert für den Briefaufdruck
output_addresslabel2
output_addresslabel3
output_addresslabel4
output_addresslabel5
output_addresslabel6
output_lettersalutation	Briefanrede
output_dub_head	Dubletten-Kopf	Alle erkannten Dubletten werden in Gruppen zusammengefasst. Innerhalb jeder Gruppe wird ein Datensatz als sogenannter Group Head gekennzeichnet – bei diesem ist das Feld output_dub_head = 1. Alle weiteren Dubletten derselben Gruppe erhalten den Wert 0.
output_dub_group	Dubletten-Gruppe	Eindeutige Kennung der Dubletten-Gruppe. Jede Gruppe erhält eine fortlaufende Nummer zur Identifikation.
criteria1_id	Zusatzkriterium 1 ID	Falls Sie Zusatzkriterien beziehen, werden sie dem letzten Output-Feld ‘output_lettersalutation’ aufgeführt.
criteria1	Zusatzkriterium 1	Je nach Konfiguration oder Lizenz können 0 bis n Zusatzkriterien definiert werden.

Aktualisierungs-Status

Die Aktualisierungs-Status geben Auskunft über die Art der Überprüfung, Bestätigung oder Aktualisierung des Datensatzes. Sie helfen, die Qualität und den aktuellen Zustand der Daten zuverlässig einzuschätzen.

Status	Erklärung
Reference	Die Person oder Firma ist in mindestens einer unserer Quellen an der angegebenen Postadresse als aktiv bekannt.
History	Die Person oder Firma ist nicht mehr an der Postadresse wohnhaft oder ansässig. Es liegt jedoch eine neue Adresse vor.
Died	Die Person ist verstorben oder die Firma wurde aufgelöst.
Building	Die Person oder Firma ist in keiner unserer Quellen an der Postadresse verzeichnet. Die Gebäudeanschrift konnte jedoch über die kbDATA Building-Datenbank als gültig referenziert werden.
Unclassified	Die Person oder Firma ist uns zwar bekannt, jedoch keinem spezifischen Status zuordenbar. Es kann keine Aussage zur Qualität gemacht werden.
Lost	Die Person oder Firma hat die Postadresse verlassen, ohne dass eine neue Adresse bekannt ist.
Unknown	Weder die Person/Firma noch die betreffende Postadresse sind in einer Quelle vorhanden.