General configuration ​

Adding the API credentials ​

In order to connect your Abacus installation with the plugin you need to add the API credentials. These can be found in your Abacus installation. These credentials are sensitive and should be stored as encrypted environment variables. For this purpose, we recommend to use Symfony vaults.

Open a terminal and run the following command:

php bin/console secrets:set ABACUS_LIVE_CLIENT_ID
php bin/console secrets:set ABACUS_LIVE_CLIENT_SECRET
php bin/console secrets:set ABACUS_TEST_CLIENT_ID
php bin/console secrets:set ABACUS_TEST_CLIENT_SECRET

php bin/console secrets:set ABACUS_LIVE_CLIENT_ID
php bin/console secrets:set ABACUS_LIVE_CLIENT_SECRET
php bin/console secrets:set ABACUS_TEST_CLIENT_ID
php bin/console secrets:set ABACUS_TEST_CLIENT_SECRET

Be sure not to commit the decryption key to your repository.

To check your secrets run the following command:

bin/console secrets:list --reveal

bin/console secrets:list --reveal

General configurations ​

To configure the plugin, go to the Shopware administration and open the Abacus integration plugin configuration.

Set the operation mode to either "Live" or "Test". In the "Live" mode, the plugin will use the Abacus API live credentials, in the "Test" mode, the plugin will use the Abacus API test credentials.

Abacus API credentials ​

Please add the APP URL and the mandant number.

That's the basic configuration you need to do to get started with the Abacus Shopware integration.

Mapping of objects ​

The following entities need to be manually mapped once in Shopware to ensure a correct synchronization between Abacus and Shopware.

Tax mapping ​

Before you start synchronizing products, you need to map the tax rates from Abacus to Shopware. Please ask your Abacus partner for the correct tax code id's and add them to the custom fields in the tax entity in Shopware.

Salutation mapping ​

During the customer import, we are mapping the salutation from Abacus to Shopware. Please ensure that the salutations are correctly mapped. Simply open the salutations in abacus and check their ID's. Then add them to the custom fields in the salutation entity in Shopware. Unlike the salutations in Abacus, the custom fields in Shopware are language aware, so you can add the ID's for each language you have in your Shopware instance.