Glossar zur Konfiguration
Alle Einstellungen in der Konfiguration des Abacus-Integrations-Plugins, gruppiert nach der Karte, unter der sie in Einstellungen → Erweiterungen → Abacus-Integration → Konfiguration angezeigt werden.
Bei booleschen Einstellungen bedeutet „aus“, dass die Einstellung nicht gesetzt bzw. deaktiviert ist, sofern sie nicht vom Administrator aktiviert wird.
Allgemein
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Betriebsmodus | operatingMode | Einfachauswahl (live, test) | test | Wählt aus, welchen Anmeldedatensatz (Live oder Test) das Plugin verwendet. |
| Dezimalstellen der Währung | currencyDecimalPlaces | Ganzzahl | leer | Optionale Überschreibung der Dezimalstellen der Währung; leer lassen, um den Shopware-Standard zu verwenden. |
Abacus-API-Live-Anmeldedaten
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| API-URL | liveApiUrl | URL | — | Erforderlich. Abacus-API-URL. |
| Mandantennummer | liveMandantNumber | Text | — | Erforderlich. |
| Client-ID | liveClientId | Text | — | Erforderlich. |
| Client-Secret | liveClientSecret | Passwort | — | Erforderlich. |
| Selbstsignierte Zertifikate zulassen (nicht empfohlen) | liveSelfSignedCertificates | Boolescher Wert | off | Nur für Nicht-Produktions-/Testumgebungen. |
Abacus-API-Testzugangsdaten
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| API-URL | testApiUrl | URL | — | Erforderlich. Abacus-API-URL. |
| Mandantennummer | testMandantNumber | Text | — | Erforderlich. |
| Client-ID | testClientId | Text | — | Erforderlich. |
| Client-Secret | testClientSecret | Passwort | — | Erforderlich. |
| Selbstsignierte Zertifikate zulassen (nicht empfohlen) | testSelfSignedCertificates | Boolescher Wert | off | Nur für Nicht-Produktions-/Testumgebungen. |
Abonnements
Diese Schalter aktivieren die Abacus-Änderungsabonnements, die das Plugin nutzt. Jeder entspricht einem Abacus-Abonnement-Thema. Die Anzahl der Abacus-Abonnements ist auf 10 begrenzt.
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| ShopProduct-Abonnement | productSubscription | Boolescher Wert | aus | Abonnement für Produktänderungen. |
| ShopperAccount-Abonnement | shopperSubscription | Boolescher Wert | aus | Abonnement für Shopper-Änderungen. |
| Subject-Abonnement | subjectSubscription | Boolescher Wert | aus | Abonnement für Subject-Änderungen. |
| ShopSalesOrder-Abonnement | orderSubscription | Boolescher Wert | aus | Abonnement für die Verknüpfung von Bestellungen. |
| Abonnement für Bestellbearbeitungsstatusdokumente | orderStatusSubscription | Boolescher Wert | aus | Abonnement für Bestellstatus/Dokumente. |
Produkte
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Produktdaten synchronisieren | productDataSyncMode | Einfachauswahl (no_product_sync, pim_mode, full_product_sync) | no_product_sync | Standardmäßig deaktiviert – es wird nichts synchronisiert, bis „PIM“ oder „Full“ ausgewählt wird. |
| Schlüsselwörter: Abacus-Feld-ID | keywordsId | Text | — | Abacus-Feld-ID, die als Quelle für Produkt-Schlüsselwörter verwendet wird. |
Preis-API
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Richtigen Abacus-Preis für angemeldete Kunden anzeigen (und im Warenkorb verwenden) | isPricingApiEnabled | Boolescher Wert | aus | Aktiviert die Preis-API für angemeldete Benutzer. |
| Korrekten Abacus-Preis für nicht angemeldete Kunden anzeigen (und im Warenkorb verwenden) | isPricingApiForNotLoggedInEnabled | Boolescher Wert | aus | Aktiviert die Pricing-API für Gäste. |
| Durchgestrichenen Preis für angemeldete Kunden anzeigen | isPricingStrikeEnabled | Boolesch | aus | Zeigt den Gast-/Listenpreis als durchgestrichenen Preis an. |
| Staffelpreise anzeigen | isGraduatedPricingApiEnabled | Boolescher Wert | aus | Aktiviert die Anzeige von Staffel-/Mengenpreisen. |
Kategorien
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Übergeordnete Kategorie zum Importieren auswählen | importToCategory | Entitätsauswahl (Kategorie) | — | Übergeordnete Kategorie, unter der der Abacus-Kategoriebäum importiert wird. |
Hersteller
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Name: Abacus-Feld-ID | ManufacturersId | Text | — | Abacus-Feld-ID, die den Herstellernamen enthält; Hersteller werden daraus automatisch erstellt. |
Kunden
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Kunden aus Abacus synchronisieren | customerImport | Boolesch | aus | Aktiviert die Synchronisation von Käufern → Kunden. |
| Shopper-UUID | shopperUuid | Einfachauswahl (account, email) | account | Kennung zum Abgleichen von Shoppern. account wird empfohlen, da nur das Konto in Abacus eindeutig ist. Bei email werden mehrere Shopper, die sich eine E-Mail-Adresse teilen, nicht berücksichtigt. |
| Anmelde-E-Mails senden | customerSendSingUpEmail | Boolescher Wert | aus | Wenn aktiviert, wird eine E-Mail an jeden synchronisierten Kunden gesendet – bitte mit Bedacht verwenden. |
Bestellungen exportieren
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Kostenlosen Versand in den Bestellexport einbeziehen | freeShippingIncluded | Boolescher Wert | aus | Wenn aktiviert, wird der kostenlose Versand dem Bestellexport beigefügt. |
| Versandkosten als Einzelposten senden | shippingCostsAsLineItem | Boolescher Wert | aus | Wenn aktiviert, müssen die Abacus-Produkt-/Varianten-IDs für den Versand in den benutzerdefinierten Feldern der Versandart festgelegt werden. Verwenden Sie diese Option für eine exakte Übereinstimmung der Versandkosten. |
| Rabattart für Einzelposten auswählen | lineItemDiscountType | Einfachauswahl (Conditional, Graduation, Special, OnSale) | Special | Ordnet Shopware-Einzelpostenaktionen dem Abacus-Rabatttyp zu. |
| Versandrabatt-Typ auswählen | shippingDiscountType | Einfachauswahl (Conditional, Graduation, Special, OnSale) | Special | Ordnet Shopware-Versandaktionen dem Abacus-Rabatt-Typ zu. |
Hinweis: Es werden nur prozentuale Aktionen exportiert; Aktionen mit festem Wert werden ignoriert.
Zuordnung des Shopware-Bestellstatus
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Ist die Synchronisierung des Bestellstatus aktiviert | isOrderStatusSyncEnabled | Boolesch | aus | Hauptschalter für die Synchronisierung von Bestell-/Versand-/Zahlungsstatus. |
| Zuordnung von Bestellstatus | orderStatusMapping | Zuordnungstabelle | leer | Ordnet Abacus-Prozessschritte → Shopware-Bestell-/Versand-/Zahlungsstatus zu. Eine leere Zuordnung deaktiviert die Statussynchronisation. |
Zuordnung der Shopware-Belegtypen
| Einstellung | Schlüssel | Typ | Standard | Anmerkungen |
|---|---|---|---|---|
| Ist die Belegsynchronisation aktiviert? | isDocumentSyncEnabled | Boolescher Wert | aus | Hauptschalter für die Synchronisation von Bestellbelegen. |
| Zuordnung von Bestelldokumenttypen | orderDocumentTypeMapping | Zuordnungstabelle | empty | Ordnet Abacus-Quelltypen (OrderConfirmation, DeliveryNote) → Shopware-Dokumenttypen zu. |
Hinweis zu Multi-Tenancy
Die Plugin-Konfiguration kann global („Alle Vertriebskanäle“) oder pro Vertriebskanal festgelegt werden. Bei einer Konfiguration pro Vertriebskanal muss die Abacus-Synchronisation für jeden Kanal über das benutzerdefinierte Feld abacus_sales_channel_is_used_for_abacus_sync aktiviert werden – siehe Referenz zu benutzerdefinierten Feldern.