Import/Export: Kunden

Artikelversion

5.5.0 oder neuer

Inhaltsverzeichnis

Beim Import von Kunden musst Du beachten, dass über den Import nur Kunden aktualisiert oder angelegt werden können. Es ist nicht möglich Kunden über einen Import zu löschen.

Allgemeine Hinweise

Bevor ein Import in das Live-System vorgenommen wird, sollte ein Datenbankbackup vorgenommen werden. In jedem Fall empfiehlt sich auch den Import zuvor in einer Testumgebung oder im Staging-System zu prüfen.

Basis Kunden

Sollten bei einem Import die Felder shipping_ verwendet werden, so sollten diese auch alle gültigen Werte enthalten, da es anonsten dazu kommen kann, dass ein leerer Eintrag in die Datenbank geschrieben wird und somit die Lieferadresse unvollständig ist. Das Feld "unhashedPassword" dient zum Import von Klartext-Passwörtern und wird während des Importes mithilfe des angegebenen Encoders verschlüsselt. Beim Import von Passwörtern ist besonders darauf zu achten, dass der Encoder korrekt angegeben ist.

Das Feld newsletter setzt lediglich ein Kennzeichen. Um einen Kunden als Newsletterempfänger hinzuzufügen gibt es ein eigenes separates Profil.

Unterstützte Felder inkl. Beschreibung

FeldnameBeschreibungGültige WerteBesonderheiten
idKunden-ID in der DatenbankZahl 
passwordverschlüsseltes Passwort des KundenTextÜber das Feld Encoder wird die Verschlüsselung des Passworts angegeben
unhashedPasswordunverschlüsseltes PasswortTextWird nur benutzt, wenn "password" leer ist. Das Passwort wird mit der Verschlüsselung aus "Encoder" verschlüsselt
encoderVerschlüsselungsmethodemd5, bcryptMuss bei der Übergabe eines Passwortes mit angegeben werden
emailE-Mail-Adresse des KundenE-MailDas Feld darf nicht leer sein
activeLegt fest ob das Kundenkonto aktiv istboolean (0 oder 1)Wenn nicht vorhanden, ist das Kundenkonto inaktiv
accountModeKundenkonto oder Schnellbestellerboolean (0 oder 1) 
paymentIDZahlungsart-IDnummerisch 
firstLoginErster LoginDatum 
lastLoginLetzter LoginDatum 
sessionIdID der aktiven Sessionnummerisch 
newsletterNewsletteranmeldung über Kundenkonto (Ja/Nein)boolean (0 oder 1)Trägt den Kunden nicht automatisch als Newsletterempfänger ein! Hiermit wird nur festgelegt, ob das Feld im Kundenkonto gesetzt ist.
validationDatum der ValidierungDate 
affiliatePartner des ShopsBooleanKennzeichen ob das Kundenkonto zu einem Partner im Partnerprogramm zugeordnet ist
customergroupKundengruppeTextAngabe des Kürzels, auszulesen unter Einstellungen > Grundeinstellungen > Shopeinstellungen > Kundengruppen
paymentPresetZahlungsart-ID Vorauswahlnummerisch 
languageSprachenummerisch 
subshopIDZuordnung zum jeweiligen Sprach- und Subshopnummerisch 
refererZuordnung zum Partneralphanumerisch 
priceGroupIdId der Preisgruppenummerisch 
internalCommentKommentarText 
failedLoginsFehlgeschlagene Login-Versuchenummerisch 
lockedUntilGesperrt bisDatum 
customerNumberKundennummerTextMerkmal zur Identifizierung des Kunden, wenn bereits vorhanden erfolgt ein Update
birthdayGeburtsdatumDatum 
billingCompanyRechnungsadresse: FirmennameText 
billingDepartmentRechnungsadresse: AbteilungText 
billingSalutationRechnungsadresse: AnredeText 
billingFirstnameRechnungsadresse: VornameText 
billingLastnameRechnungsadresse: NachnameText 
billingStreetRechnungsadresse: StraßeText 
billingZipcodeRechnungsadresse: PostleitzahlText 
billingCityRechnungsadresse: WohnortText 
billingPhoneRechnungsadresse: TelefonnummerText 
billingCountryIDRechnungsadresse: Länder-IDText 
billingStateIDRechnungsadresse: Bundesland-IDText 
ustidUmsatzsteuer-IDText 
billingAdditionalAddressLine#Rechnungsadresse: Zusätzliche Addresszeile #Text 
attrBillingText#Rechnungsadresse: Zusätzliches Attributsfeld #Text 
shippingCompanyLieferadresse: FirmaText 
shippingDerpartmentLieferadresse: AbteilungText 
shippingSalutationLieferadresse: AnredeText 
shippingFirstnameLieferadresse: VornameText 
shippingLastnameLieferadresse: NachnameText 
shippingStreetLieferadresse: StraßennameText 
shippingZipcodeLieferadresse: PostleitzahlText 
shippingCityLieferadresse: WohnortText 
shippingCountryIDLieferadresse: Länder-IDText 
shippingStateIDLieferadresse: Bundesland-IDText 
shippingAdditionalAddressLine#Lieferadresse: Zusätzliche Addresszeile #Text 
attrShippingText#Lieferadresse: Zusätzliches Attributsfeld #Text 

Minimaler Import

Der minimale Import für Kunden enthält sowohl Mailadresse, Kundenummer, Passwort und Encoder, als auch die Angaben zur Rechnungsadresse, sowie eine Kundengruppe und Zahlungsart. Mit diesem Import kann ein neuer Kunde angelegt werden, dieser ist jedoch noch deaktiviert. Um diesen direkt zu aktivieren muss der Knoten active hinzugefügt und als Wert 1 angegeben werden. 

Das Profil zu diesem Import kannst Du hier herunterladen: CustomersMinimal.json 
Eine Beispiel XML-Datei findest Du hier: CustomersMinimal.xml 
Eine Beispiel CSV-Datei kannst Du hier finden: CustomersMinimal.csv 

Standard Profil

Das Standard Profil enthält alle Pflichfelder, sowie die oft genutzten Detail-Informationen. 


Das Profil zu diesem Import kannst Du aus der Liste der Standard-Profile auswählen unter dem Namen "Kunden (default_customers)". 
Eine Beispiel XML-Datei findest Du hier: Customers.xml 
Eine Beispiel CSV-Datei kannst Du hier finden: Customers.csv 

Profil "Kunden komplett"

Ab der Version 2.4.0 kannst Du im Plugin ein neues Standardprofil namens "Kunden komplett" (default_customers_complete) verwenden. Dieses Profil dient zum reinen Export der personenbezogenen Daten der Kunden, einschließlich den allgemeinen Kundendaten, hinterlegten Adressen und Bestellungen. Du kannst also diese Daten erhalten, indem du das Profil beim Export auswählst. Beachte bitte, das für dieses Profil nur XML als Export-Format zur Verfügung steht.

Es ist weder eine Bearbeitung noch ein Import bei diesem Profil vorgesehen. Entsprechend ist das Profil nur beim Export zu finden und taucht in der Profilübersicht nicht auf.