Kundenimporter – Benutzerhandbuch
Kundendaten aus einem anderen Gambio-Shop importieren, synchronisieren und exportieren.
1 · Was das Modul macht
Der Kundenimporter überträgt Kundenkonten aus einem anderen Gambio-Shop („Quell-Shop“, im Modul EXTERN genannt) in Ihren aktuellen Shop (INTERN). Übertragen werden Stammdaten, alle Adressen, Kundeninfos, Memos, Warenkörbe und Wunschlisten. Vergleichskriterium ist immer die Kundennummer (Customer-ID).
Das Modul bietet drei Werkzeuge, jeweils in einem eigenen Reiter:
| Reiter | Zweck |
|---|---|
| Kundenim-/exporter | Kunden, die es hier noch nicht gibt, aus dem Quell-Shop neu anlegen. |
| Kundensynchronisierer | Kunden, die es in beiden Shops gibt, mit den Daten des Quell-Shops aktualisieren. |
| Kundenexporter | Die Kunden dieses Shops als CSV-Datei exportieren. |
2 · Bevor Sie starten
Sie benötigen die Datenbank-Zugangsdaten des Quell-Shops:
- Server (Host)
- Datenbankname
- Datenbankbenutzer
- Datenbankpasswort
3 · Schritt 1 – Zugangsdaten hinterlegen
Öffnen Sie im Admin das Modul-Setup („Kundenimporter Setup“) und tragen Sie ein:
- Quelle: DB-Server
- Quelle: DB-Name
- Quelle: DB-User
- Quelle: DB-Passwort
Stellen Sie den Modulstatus auf Eingeschaltet und speichern Sie.
4 · Schritt 2 – Modul öffnen
Im Admin-Menü unter Xycons → Kundenimporter. Oben auf jeder Seite sehen Sie den Vergleich beider Kundenstämme: wie viele Konten extern, wie viele intern gefunden wurden – und wie viele fehlen bzw. übereinstimmen.
5 · Schritt 3a – Kunden importieren
- Reiter Kundenim-/exporter öffnen.
- Kontrollzeile prüfen: „… Kundenkonten fehlen in diesem Shop“.
- Auf Starten klicken.
- Der Fortschrittsbalken läuft schrittweise bis 100 %.
Was passiert: Nur Kunden, deren Kundennummer hier noch nicht existiert, werden angelegt – mit allen Adressen und zugehörigen Daten. Bereits vorhandene Kunden bleiben unberührt.
6 · Schritt 3b – Kunden synchronisieren
- Reiter Kundensynchronisierer öffnen.
- Kontrollzeile prüfen: „… Kundenkonten, die in beiden Shops vorhanden sind“.
- Auf Starten klicken.
Was passiert: Konten, die es in beiden Shops gibt, werden mit den Daten des Quell-Shops überschrieben. Der Quell-Shop ist der „Master“. Nur hier vorhandene Konten bleiben unverändert.
7 · Schritt 3c – Kunden als CSV exportieren
- Reiter Kundenexporter öffnen.
- Auf Starten klicken – der Fortschrittsbalken läuft bis 100 %.
- Nach Abschluss erscheint der Link „CSV-Datei herunterladen“. Datei speichern.
Exportiert werden die Basisdaten der Kunden dieses Shops mit ihrer Hauptadresse (Name, E-Mail, Telefon, Firma, Anschrift). Die Datei ist mit Semikolon getrennt und UTF-8-kodiert – direkt in Excel oder LibreOffice zu öffnen.
8 · Während des Laufs
- Seite nicht neu laden, keine Links anklicken, den Tab nicht schließen, bis 100 % erreicht sind.
- Große Bestände werden automatisch in Schritten verarbeitet – bei tausenden Konten etwas Geduld.
9 · Nach dem Lauf – prüfen
- Anzahl und Kundennummern unter Kunden → Kunden stichprobenartig prüfen.
- Bei einem Testkunden Adresse, Warenkorb und Wunschliste kontrollieren.
10 · Wenn etwas nicht klappt
| Symptom | Ursache / Lösung |
|---|---|
| „0 Kundenkonten in externer DB gefunden“ | Zugangsdaten im Setup falsch, oder Quell-DB nicht erreichbar. |
| Fehlermeldung beim Start (ERROR / DB_CONNECTION) | DB-Zugangsdaten prüfen; Remote-Zugriff/Firewall zum Quell-DB-Server freigeben. |
| Meldung „MODULE_OFF“ / roter Hinweis | Modul ist ausgeschaltet – im Setup unter „Modulstatus“ einschalten. |
| Fortschritt scheint zu stehen | Seite nicht neu laden – warten. Bleibt es dauerhaft hängen, Log prüfen. |
| Sitzung abgelaufen (INVALID_TOKEN) | Seite einmal neu laden (dadurch neuer Sicherheits-Token) und erneut starten. |
Protokoll der Läufe: xycons_m0128_importer_logfile (Xycons-Logverzeichnis).
11 · Modul ein- und ausschalten
Im Setup steuert der Modulstatus das gesamte Modul. Ist er auf Ausgeschaltet, finden keine Importe, Synchronisationen oder Exporte statt, und es wird keine Verbindung zum Quell-Shop aufgebaut. Auf den Modulseiten erscheint dann ein rot hinterlegter Hinweis, und der Start-Button ist ausgeblendet.
12 · Datenschutz-Hinweis
Sie übertragen personenbezogene Kundendaten (Namen, Adressen, teils IP-Adressen, Passwort-Hashes) zwischen zwei Systemen. Stellen Sie sicher, dass Sie dazu berechtigt sind (Rechtsgrundlage, ggf. Auftragsverarbeitung, Löschkonzept) und dass beide Shops in Ihrer Verantwortung liegen.
