Skip to content

Syncing customers

We sync Abacus shoppers to Shopware customers.

Plugin configuration

In the plugin configuration, you can find settings for the customer synchronization. Plugin configuration

  1. The customer sync can be enabled or disabled
  2. With the "Shopper UUID" setting, you can choose between "Account" or "Email" to uniquely identify the shopper.
    • "Account" is the recommended setting because only account is unique in Abacus
    • "Email" will use the email address to identify the shopper (please note that it is possible that multiple shoppers have the same email address. We don't handle this case at the moment)
  3. Only enable this option if you want to send an email to the customer when the customer is created in Shopware. (Careful: this will send an email to all customers that are synced)

Abacus configuration

In the Abacus application settings (621), you can define a collective debtor for all guest orders. This debtor will be used for all guest orders that are created in Shopware. Abacus configuration

Customer synchronization process "Shoppers"

Every 24 hours, all shoppers from Abacus are synchronized to Shopware. The synchronization is done in the background and can be triggered manually through the console.

php
bin/console scheduled-task:run-single webwirkung.abacus.shopper.synchronization
bin/console scheduled-task:run-single webwirkung.abacus.shopper.synchronization

In addition to the scheduled full sync, the plugin also subscribes to Abacus changes and consumes them every 15 minutes. This means that changes in Abacus are quickly reflected in Shopware. This is how a correctly synchronized shopper looks in Shopware: Shopper synchronization example Besides the default shopware customer data, we also store the Abacus customer subject id, the abacus shopper id as well as the abacus debtor number in the custom fields of the customer entity.

Manually creating Shoppers with UUID "Account" in Abacus

When the shopper UUID is set to "Account" in the shopware plugin configuration (mentioned above), the plugin expects the shopper to have an email address in the "Account" field of the shopper. When creating a new shopper manually in Abacus, you need to set the email address in the "Account" field.

This is how it expects the shopper to look like in Abacus:

Shopper Account field

Both account and email field are filled with the email address. In German, the "Account" field is called "Kontoname".