Kunden synchronisieren
Wir synchronisieren Abacus shoppers zu Shopware-Kunden.
Plugin-Konfiguration
In der Plugin-Konfiguration finden Sie Einstellungen für die Kundensynchronisation und die Bestellungsabwicklung.
- Die Kundensynchronisation kann aktiviert oder deaktiviert werden
- Mit der Einstellung "Shopper UUID" können Sie zwischen "Account" oder "E-Mail" wählen, um den Shopper eindeutig zu identifizieren.
- "Account" ist die empfohlene Einstellung, da nur der Account in Abacus eindeutig ist
- "E-Mail" verwendet die E-Mail-Adresse zur Identifizierung des Shoppers (bitte beachten Sie, dass es möglich ist, dass mehrere Shopper dieselbe E-Mail-Adresse haben. Wir fangen diesen Fall momentan nicht ab.)
- Aktivieren Sie diese Option nur, wenn Sie eine E-Mail an den Kunden senden möchten, sobald er in Shopware angelegt wird. (Vorsicht: Dies sendet eine E-Mail an alle Kunden, die synchronisiert sind)
Abacus-Konfiguration
In den Einstellungen der Abacus-Anwendung (621) können Sie einen Sammeldebitor für alle Gastbestellungen definieren. Dieser Debitor wird für alle Gastbestellungen, die in Shopware angelegt werden, verwendet. Bitte stellen Sie sicher, dass der Debitor unter "Zusatz" -> "Debitor-Einstellungen" die Checkbox "Sammeldebitor" aktiviert hat.
Kundensynchronisations-Prozess "Shopper"
Alle 24 Stunden werden alle Shopper von Abacus mit Shopware synchronisiert. Die Synchronisation erfolgt im Hintergrund und kann manuell über die Konsole ausgelöst werden.
bin/console scheduled-task:run-single webwirkung.abacus.shopper.synchronization
bin/console scheduled-task:run-single webwirkung.abacus.shopper.synchronization
Zusätzlich zur geplanten Vollsynchonisation registriert das Plugin auch Änderungen von Abacus Shoppers und verarbeitet diese alle 15 Minuten. Dies bedeutet, dass Änderungen in Abacus schnell in Shopware widergespiegelt werden.
So sieht ein korrekt synchronisierter Shopper in Shopware aus: Neben den Standard-Kundendaten von Shopware speichern wir auch die Abacus Customer Subject Id, die Abacus Shopper Id sowie die Abacus Debtor Number in den Zusatzfeldern des Kunden.
Manuelles Erstellen von Shoppern mit UUID „Account“ in Abacus
Wenn in der Shopware-Plugin-Konfiguration (siehe oben) die Shopper-UUID auf „Account“ gesetzt ist, erwartet das Plugin, dass der Shopper im Feld „Account“ (Kontoname) eine E-Mail-Adresse hat.
Beim manuellen Anlegen eines neuen Shoppers in Abacus müssen Sie daher die E-Mail-Adresse im Feld „Account“ eintragen.
So sollte der Shopper in Abacus aussehen:
Sowohl das Feld „Account“ als auch das Feld „E-Mail“ sind mit der E-Mail-Adresse ausgefüllt.
Im Deutschen heisst das Abacus Feld „Account“ „Kontoname“.
Technische Informationen über Abacus Shopper
Der Abacus Shopper ist ein Konzept in Abacus, das einen Kunden repräsentiert, der in einem Onlineshop einkauft. Ein Shopper ist mit einem Debitor (Kunde) in Abacus verknüpft und kann mehrere Adressen haben.
Über die API erhalten wir folgende Adressinformationen zu einem Shopper. Ein frisch erstellter Shopper in Abacus:
"Id": "e6c7e1be-84c3-8926-2422-5df4d6f775a0",
"EMail": "shopper.shoppi@webwirkung.ch",
"Account": "shopper.shoppi@webwirkung.ch",
[...]
"DebtorNumber": 1,
"CustomerSubjectId": 15,
"CustomerContactSubjectId": 292,
"BillingSubjectId": 0,
"BillingContactSubjectId": 0,
"ShippingSubjectId": 0,
"ShippingContactSubjectId": 0,
[...]
"Id": "e6c7e1be-84c3-8926-2422-5df4d6f775a0",
"EMail": "shopper.shoppi@webwirkung.ch",
"Account": "shopper.shoppi@webwirkung.ch",
[...]
"DebtorNumber": 1,
"CustomerSubjectId": 15,
"CustomerContactSubjectId": 292,
"BillingSubjectId": 0,
"BillingContactSubjectId": 0,
"ShippingSubjectId": 0,
"ShippingContactSubjectId": 0,
[...]
Nach der ersten Bestellung erhält der Shopper in der Regel eine BillingSubjectId und eine ShippingSubjectId. Abhängig vom Mapping, das bei der Verarbeitung der Bestellung in Abacus durchgeführt wird, werden auch die BillingContactSubjectId und ShippingContactSubjectId gesetzt.
"Id": "e6c7e1be-84c3-8926-2422-5df4d6f775a0",
"EMail": "shopper.shoppi@webwirkung.ch",
"Account": "shopper.shoppi@webwirkung.ch",
[...]
"DebtorNumber": 1,
"CustomerSubjectId": 15,
"CustomerContactSubjectId": 0,
"BillingSubjectId": 15,
"BillingContactSubjectId": 292,
"ShippingSubjectId": 15,
"ShippingContactSubjectId": 292,
[...]
"Id": "e6c7e1be-84c3-8926-2422-5df4d6f775a0",
"EMail": "shopper.shoppi@webwirkung.ch",
"Account": "shopper.shoppi@webwirkung.ch",
[...]
"DebtorNumber": 1,
"CustomerSubjectId": 15,
"CustomerContactSubjectId": 0,
"BillingSubjectId": 15,
"BillingContactSubjectId": 292,
"ShippingSubjectId": 15,
"ShippingContactSubjectId": 292,
[...]
Bitte beachten: Alle Adressänderungen, die in Shopware vorgenommen werden, erfordern eine manuelle Anpassung in Abacus in J15, bevor eine Bestellung verarbeitet werden kann. Weitere Informationen finden Sie in der Dokumentation zum Bestellprozess.