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.
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.

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.
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.

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.