Import/Export: Kunden
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
| Feldname | Beschreibung | Gültige Werte | Besonderheiten |
|---|---|---|---|
| id | Kunden-ID in der Datenbank | Zahl | |
| password | verschlüsseltes Passwort des Kunden | Text | Über das Feld Encoder wird die Verschlüsselung des Passworts angegeben |
| unhashedPassword | unverschlüsseltes Passwort | Text | Wird nur benutzt, wenn "password" leer ist. Das Passwort wird mit der Verschlüsselung aus "Encoder" verschlüsselt |
| encoder | Verschlüsselungsmethode | md5, bcrypt | Muss bei der Übergabe eines Passwortes mit angegeben werden |
| E-Mail-Adresse des Kunden | Das Feld darf nicht leer sein | ||
| active | Legt fest ob das Kundenkonto aktiv ist | boolean (0 oder 1) | Wenn nicht vorhanden, ist das Kundenkonto inaktiv |
| accountMode | Kundenkonto oder Schnellbesteller | boolean (0 oder 1) | |
| paymentID | Zahlungsart-ID | nummerisch | |
| firstLogin | Erster Login | Datum | |
| lastLogin | Letzter Login | Datum | |
| sessionId | ID der aktiven Session | nummerisch | |
| newsletter | Newsletteranmeldung ü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. |
| validation | Datum der Validierung | Date | |
| affiliate | Partner des Shops | Boolean | Kennzeichen ob das Kundenkonto zu einem Partner im Partnerprogramm zugeordnet ist |
| customergroup | Kundengruppe | Text | Angabe des Kürzels, auszulesen unter Einstellungen > Grundeinstellungen > Shopeinstellungen > Kundengruppen |
| paymentPreset | Zahlungsart-ID Vorauswahl | nummerisch | |
| language | Sprache | nummerisch | |
| subshopID | Zuordnung zum jeweiligen Sprach- und Subshop | nummerisch | |
| referer | Zuordnung zum Partner | alphanumerisch | |
| priceGroupId | Id der Preisgruppe | nummerisch | |
| internalComment | Kommentar | Text | |
| failedLogins | Fehlgeschlagene Login-Versuche | nummerisch | |
| lockedUntil | Gesperrt bis | Datum | |
| customerNumber | Kundennummer | Text | Merkmal zur Identifizierung des Kunden, wenn bereits vorhanden erfolgt ein Update |
| birthday | Geburtsdatum | Datum | |
| billingCompany | Rechnungsadresse: Firmenname | Text | |
| billingDepartment | Rechnungsadresse: Abteilung | Text | |
| billingSalutation | Rechnungsadresse: Anrede | Text | |
| billingFirstname | Rechnungsadresse: Vorname | Text | |
| billingLastname | Rechnungsadresse: Nachname | Text | |
| billingStreet | Rechnungsadresse: Straße | Text | |
| billingZipcode | Rechnungsadresse: Postleitzahl | Text | |
| billingCity | Rechnungsadresse: Wohnort | Text | |
| billingPhone | Rechnungsadresse: Telefonnummer | Text | |
| billingCountryID | Rechnungsadresse: Länder-ID | Text | |
| billingStateID | Rechnungsadresse: Bundesland-ID | Text | |
| ustid | Umsatzsteuer-ID | Text | |
| billingAdditionalAddressLine# | Rechnungsadresse: Zusätzliche Addresszeile # | Text | |
| attrBillingText# | Rechnungsadresse: Zusätzliches Attributsfeld # | Text | |
| shippingCompany | Lieferadresse: Firma | Text | |
| shippingDerpartment | Lieferadresse: Abteilung | Text | |
| shippingSalutation | Lieferadresse: Anrede | Text | |
| shippingFirstname | Lieferadresse: Vorname | Text | |
| shippingLastname | Lieferadresse: Nachname | Text | |
| shippingStreet | Lieferadresse: Straßenname | Text | |
| shippingZipcode | Lieferadresse: Postleitzahl | Text | |
| shippingCity | Lieferadresse: Wohnort | Text | |
| shippingCountryID | Lieferadresse: Länder-ID | Text | |
| shippingStateID | Lieferadresse: Bundesland-ID | Text | |
| 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.