Configuration glossary
Every setting in the Abacus integration plugin configuration, grouped by the card it appears under in Settings → Extensions → Abacus Integration → Configuration.
For boolean settings, "off" means unset/disabled unless the admin enables it.
General
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Operating mode | operatingMode | Single-select (live, test) | test | Selects which credential set (Live or Test) the plugin uses. |
| Abacus version | abacusVersion | Single-select (2024, 2025, 2026+) | empty | Required. 2026+ uses the Entity API change tracking for the subscriptions and the higher API rate limits. Empty = 2025. |
| Currency decimal places | currencyDecimalPlaces | Integer | empty | Optional override for currency decimals; leave empty to use the Shopware default. |
Abacus API live credentials
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| API URL | liveApiUrl | URL | — | Required. Abacus API URL. |
| Mandant number | liveMandantNumber | Text | — | Required. |
| Client Id | liveClientId | Text | — | Required. |
| Client Secret | liveClientSecret | Password | — | Required. |
| Allow self-signed certificates (not recommended) | liveSelfSignedCertificates | Boolean | off | Only for non-production / testing setups. |
Abacus API test credentials
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| API URL | testApiUrl | URL | — | Required. Abacus API URL. |
| Mandant number | testMandantNumber | Text | — | Required. |
| Client Id | testClientId | Text | — | Required. |
| Client Secret | testClientSecret | Password | — | Required. |
| Allow self-signed certificates (not recommended) | testSelfSignedCertificates | Boolean | off | Only for non-production / testing setups. |
Subscriptions
These toggles enable the Abacus change subscriptions the plugin consumes. Each corresponds to an Abacus subscription topic. Limit of Abacus subscriptions is 10.
With Abacus version 2026+, all subscriptions use the Entity API change tracking. The subscribe task fails if Abacus does not confirm a subscription (e.g. missing API scope).
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| ShopProduct subscription | productSubscription | Boolean | off | Product change subscription. |
| ShopperAccount subscription | shopperSubscription | Boolean | off | Shopper change subscription. |
| Subject subscription | subjectSubscription | Boolean | off | Subject change subscription. |
| ShopSalesOrder subscription | orderSubscription | Boolean | off | Order linking subscription. |
| OrderProcessingStatusDocument subscription | orderStatusSubscription | Boolean | off | Order status / document subscription. |
Products
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Sync product data | productDataSyncMode | Single-select (no_product_sync, pim_mode, full_product_sync) | no_product_sync | Off by default — nothing syncs until PIM or Full is selected. |
| Keywords: Abacus Field ID | keywordsId | Text | — | Abacus field ID used as the source for product keywords. |
Pricing API
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Show correct Abacus price for logged-in customers (and use in cart) | isPricingApiEnabled | Boolean | off | Enables the Pricing API for logged-in users. |
| Show correct Abacus price for not-logged-in customers (and use in cart) | isPricingApiForNotLoggedInEnabled | Boolean | off | Enables the Pricing API for guests. |
| Show strike-through price for logged-in customers | isPricingStrikeEnabled | Boolean | off | Displays the guest/list price as a strike-through. |
| Display graduated pricing | isGraduatedPricingApiEnabled | Boolean | off | Enables graduated/bulk price display. |
Categories
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Choose the parent category to import | importToCategory | Entity select (category) | — | Parent category under which the Abacus category tree is imported. |
Manufacturers
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Name: Abacus Field ID | ManufacturersId | Text | — | Abacus field ID holding the manufacturer name; manufacturers are auto-created from it. |
Customers
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Sync customers from Abacus | customerImport | Boolean | off | Enables shopper → customer synchronization. |
| Shopper UUID | shopperUuid | Single-select (account, email) | account | Identifier used to match shoppers. account is recommended because only the account is unique in Abacus. With email, multiple shoppers sharing one email address are not handled. |
| Send sign-up emails | customerSendSingUpEmail | Boolean | off | When on, sends an email to every synced customer — use with care. |
Exporting orders
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Include free shipping in the order export | freeShippingIncluded | Boolean | off | When on, free shipping is attached to the order body export. |
| Send shipping costs as line-item | shippingCostsAsLineItem | Boolean | off | When on, the shipping Abacus product/variant IDs must be set on the shipping method custom fields. Use for exact shipping-total matching. |
| Position number step (LineItemId) | lineItemIdStep | Integer | 10 | Step of the position numbers sent to Abacus (10 = 10, 20, 30). 0 = Abacus numbers the positions itself. See Sending orders to Abacus. |
| Choose line item discount type | lineItemDiscountType | Single-select (Conditional, Graduation, Special, OnSale) | Special | Maps Shopware line-item promotions to the Abacus discount type. |
| Choose shipping discount type | shippingDiscountType | Single-select (Conditional, Graduation, Special, OnSale) | Special | Maps Shopware shipping promotions to the Abacus discount type. |
Note: only percentage promotions are exported; fixed-value promotions are ignored.
Shopware order status mapping
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Is order status sync enabled | isOrderStatusSyncEnabled | Boolean | off | Master toggle for order/shipping/payment status sync. |
| Order status mapping | orderStatusMapping | Mapping table | empty | Maps Abacus ProcessSteps → Shopware order/shipping/payment states. An empty mapping disables status sync. |
Shopware document type mapping
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Is document sync enabled | isDocumentSyncEnabled | Boolean | off | Master toggle for order document sync. |
| Order document type mapping | orderDocumentTypeMapping | Mapping table | empty | Maps Abacus source types (OrderConfirmation, DeliveryNote) → Shopware document types. |
API rate limiting & scheduling
| Setting | Key | Type | Default | Notes |
|---|---|---|---|---|
| Background sync budget share (%) | backgroundBudgetPercent | Integer | 65 | Share of the rate limit for background syncs; the rest stays free for storefront and checkout. |
| Off-peak window start (hour) | offPeakStartHour | Integer (0-23) | 23 | Start of the bulk-sync window (Europe/Zurich). |
| Off-peak window end (hour) | offPeakEndHour | Integer (0-23) | 5 | End of the bulk-sync window (Europe/Zurich). |
| Sync stagger offset (minutes) | syncStaggerOffsetMinutes | Integer | 0 | Shifts the window earlier when several mandants share one Abacus. |
Manual syncs ignore the off-peak window. See API rate limiting.
Multi-tenant note
The plugin configuration can be set globally ("All Sales Channels") or per sales channel. When configured per sales channel, Abacus sync must be activated for each channel via the abacus_sales_channel_is_used_for_abacus_sync custom field — see the Custom fields reference.