Wie importiere ich Profildaten automatisierbar über eine CSV Datei?

Geändert am Mi, 15 Apr um 10:21 NACHMITTAGS

Beachten Sie, dass der Profildatenimport möglicherweise kostenpflichtig ist.

INHALTSVERZEICHNIS

Vorteile dieses Verfahrens
So funktioniert der Import
Wichtige Voraussetzung
Pflichtaufbau der CSV-Datei
Steuerlogik für den Import
Wichtige Mindestfelder für einen Import
Standardfelder im Überblick
Mehrfachfelder
Wichtige Hinweise
Zusammenfassung

Mit diesem Verfahren können Sie Profildaten Ihrer Reisenden automatisiert per CSV-Datei in unser System übertragen. Die Übermittlung erfolgt über einen von uns bereitgestellten sFTP-Server.

Vorteile dieses Verfahrens

Automatisierte Übertragung ohne manuelle Pflege einzelner Profile
Saubere, wiederholbare Datenlieferung aus HR- oder Stammdatensystemen
Schnelle Verarbeitung größerer Datenmengen
Geeignet für regelmäßige Updates, Neueintritte und Austritte

So funktioniert der Import

Wir legen Ihr Unternehmen im System an.
Sie erhalten von uns die sFTP-Zugangsdaten.
Sie erhalten von uns die company.uuid Ihres Unternehmens.
Sie erstellen die CSV-Datei gemäß der vereinbarten Struktur.
Sie laden die CSV-Datei auf den sFTP-Server hoch.
Die Datei wird automatisiert verarbeitet.

Wichtige Voraussetzung

Ihr Unternehmensprofil muss vor dem ersten Import bereits von uns angelegt worden sein. Für die Zuordnung der Reisenden verwenden Sie bitte die von uns bereitgestellte company.uuid.

Pflichtaufbau der CSV-Datei

Die CSV-Datei muss immer wie folgt aufgebaut sein:

Zeile 1: Technische Header-Zeile
Zeile 2: Feldbezeichnungen
Ab Zeile 3: Profildaten

Die ersten beiden Zeilen müssen immer vorhanden sein, damit die Datei korrekt verarbeitet werden kann.

Steuerlogik für den Import

Neue Profile anlegen

metadata.action = SAVE
uuid bleibt leer
company.uuid muss mit der von uns bereitgestellten Unternehmens-ID befüllt werden

Bestehende Profile aktualisieren

metadata.action = SAVE
uuid des bestehenden Reisenden muss vorhanden sein
company.uuid muss gesetzt sein

Profile löschen

metadata.action = DELETE
uuid des zu löschenden Reisenden muss vorhanden sein

Wichtige Mindestfelder für einen Import

Spalte	Bedeutung	Werte / Hinweise
`metadata.action`	Aktion	`SAVE` oder `DELETE`
`uuid`	Eindeutige Profil-ID des Reisenden	Bei Neuanlage leer lassen, bei Updates/Löschungen angeben, ersatzweise erfolt das Matching mit der company.uuid
`username`	Benutzername des Reisenden	Individuell pro Reisendem
`email`	E-Mail-Adresse	Gültige E-Mail-Adresse
`gender`	Anrede / Greeting	`MR`, `MRS`, `U`
`name`	Nachname	Wie im Pass / Reisedokument
`firstname`	Vorname	Wie im Pass / Reisedokument
`company.uuid`	Unternehmens-ID	Wird von uns vorab bereitgestellt und für die Zuordnung verwendet
`company.name`	Unternehmensname	Optional bzw. nach abgestimmtem Aufbau zusätzlich mitführen

Standardfelder im Überblick

Die folgende Tabelle hilft Ihnen, einzelne Spalten gezielt nachzuschlagen. Nicht alle Felder sind für jeden Import erforderlich. Welche Felder Sie tatsächlich verwenden, hängt von Ihrem gewünschten Profilumfang ab.

Spalte	Bedeutung	Werte / Format / Hinweise
`metadata.action`	Aktion	`SAVE`, `DELETE`
`uuid`	Profil-ID des Reisenden	Bei neuen Profilen leer
`username`	Benutzername	Individuell pro Reisendem
`email`	E-Mail-Adresse	Gültige E-Mail-Adresse
`language`	Sprache	`de_DE`, `en_GB`, `en_US`, `fr_FR` etc.
`gender`	Anrede	`MR`, `MRS`, `U`
`title`	Titel	`DR`, `PROF`
`name`	Nachname	Wie im Pass
`middlename`	Weiterer Vorname / Mittelname	Optional
`firstname`	Vorname	Wie im Pass
`birthdate`	Geburtsdatum	Format: `dd.mm.yyyy`
`nationality`	Staatsangehörigkeit	2-stelliger Ländercode, z. B. `DE`, `CH`
`additionalFormOfPayment`	Weitere Zahlungsart	`CASH`, `INV`
`hotelGuarantee`	Hotelgarantie	`T/00` bis `T/02` oder `C/00` bis `C/02`
`carGuarantee`	Mietwagengarantie	`T/00` bis `T/02` oder `C/00` bis `C/02`
`webPayment`	Webcard	`T/00` bis `T/02` oder `C/00` bis `C/02`
`phoneBusiness`	Telefon geschäftlich	Freitext / Nummer
`phonePrivate`	Telefon privat	Freitext / Nummer
`phoneMobile`	Mobilnummer	Freitext / Nummer
`receivedocs`	Versand Reiseunterlagen / E-Ticket	`true`, `false`
`preferredSeat`	Sitzplatzwunsch	`A` = Gang, `W` = Fenster
`preferredFood`	Mahlzeitenwunsch	z. B. `VGML`
`smoker`	Raucher	`true`, `false`
`traveller`	Reisender	`true`, `false`
`arranger`	Assistenz / Arranger	`true`, `false`
`approver`	Genehmiger	`true`, `false`
`comment`	Allgemeiner Kommentar	Freitext
`company.recordlocator`	Unternehmens-/Profilnummer	Optional
`company.uuid`	Unternehmens-ID	Von uns bereitgestellt
`company.name`	Unternehmensname	Optional bzw. nach abgestimmtem Aufbau
`railExtension.delivery`	Bahn: Zustellung	`BAHNTIX`, `ONLINE`, `PAPERTICKET`
`railExtension.wagonType`	Bahn: Wagentyp	`COMPARTMENT`, `PREFER_WIDEBODY`, `REQUIRE_WIDEBODY`, `SINGLE`, `TABLE`
`railExtension.wagonExtraType`	Bahn: Zusatzbereich	`PHONEAREA`, `QUIETAREA`
`railExtension.seatpref`	Bahn: Sitzpräferenz	`AISLE`, `WINDOW`
`railExtension.railclass`	Bahn: Klasse	`FIRST`, `SECOND`
`railExtension.idInfo`	Bahn: Karten-/Bankdateninfo	Optional
`sortedRailCards0.cardtype`	Bahncard-Typ	Je nach Bahnsystem definierte Werte
`sortedRailCards0.cardnumber`	Bahncard-Nummer	Freitext
`sortedRailCards0.cardExpiration`	Bahncard-Ablauf	Format: `dd.mm.yyyy`
`residentExtension.area`	Residentenrabatt-Gebiet	`CANARY`, `BALEARIC`, `CEUTA`, `MELILLA`
`residentExtension.areaCode`	Gebiets-/Postleitzahl	Numerisch
`residentExtension.cardType`	Ausweistyp	`NATIONAL_ID`, `MINOR_RESIDENT`, `RESIDENT_CARD`, `TEMP_RESIDENT`
`residentExtension.cardNumber`	Ausweisnummer	Freitext
`residentExtension.firstSurname`	Erster Nachname	Optional
`residentExtension.secondSurname`	Zweiter Nachname	Optional
`flightmemberships0.alliance`	Vielfliegerprogramm: Airline	2-stelliger Airline-Code, z. B. `LH`
`flightmemberships0.membernumber`	Vielfliegernummer	Freitext
`flightmemberships0.additionalinfo`	Zusatzinfo / PIN	Optional
`hotelmemberships0.alliance`	Hotelprogramm: Kette	2-stelliger Hotelcode

Mehrfachfelder

Einige Felder können mehrfach vorkommen, zum Beispiel Vielfliegerprogramme, Hotelprogramme oder Karteninformationen. Diese Felder werden nummeriert.

flightmemberships0.alliance = erster Eintrag
flightmemberships1.alliance = zweiter Eintrag
flightmemberships2.alliance = dritter Eintrag

Die Nummerierung beginnt bei 0.

Wichtige Hinweise

Verwenden Sie immer die von uns bereitgestellte company.uuid.
Ändern Sie Spaltennamen und Dateistruktur nicht eigenständig.
Verwenden Sie für Anlegen und Aktualisieren SAVE, für Löschungen DELETE.

Zusammenfassung

Für den automatisierten Profilimport laden Sie eine korrekt aufgebaute CSV-Datei auf den bereitgestellten sFTP-Server hoch. Entscheidend für die korrekte Verarbeitung sind die beiden Kopfzeilen, die richtige Steuerung über metadata.action, die korrekte Verwendung der Reisenden-uuid sowie die von uns vorab bereitgestellte company.uuid.