Glossar zu Zusatzfeldern

Alle benutzerdefinierten Felder, die das Plugin liest oder schreibt, gruppiert nach Shopware-Entitäten. Es gibt drei Gruppen:

1. Registrierte benutzerdefinierte Feldsätze – werden bei der Aktivierung des Plugins erstellt und sind im Shopware-Adminbereich sichtbar und bearbeitbar.
2. Vom Plugin verwaltete technische Felder – werden direkt in die JSON-Datei customFields der Entität geschrieben; werden nicht als beschriftete Admin-Felder angezeigt.
3. Pricing-API-Laufzeitfelder – werden der Shop-Oberfläche pro Produkt/Position zum Zeitpunkt der Anfrage bereitgestellt; werden nicht gespeichert.

„Richtung“ gibt an, wie der Wert dorthin gelangt: Abacus → SW (durch Synchronisierung geschrieben), manuell (vom Integrator ausgefüllt) oder SW → Abacus (beim Bestellexport gelesen).

Registrierte benutzerdefinierte Feldsätze

Produkt (abacus_custom_product)

Feld	Typ	Richtung	Zweck
abacus_product_id	Zahl	Abacus → SW	Abacus-Produkt-ID. Wird während der Produktsynchronisation geschrieben; dient zur Identifizierung des Produkts beim Auftragsexport und bei Preissuchen.
abacus_product_variant_id	Zahl	Abacus → SW	Abacus-Varianten-ID. Wird zusammen mit der Produkt-ID für die richtige Variante verwendet.

Steuer (abacus_custom_tax)

Feld	Typ	Richtung	Zweck
abacus_tax_tax_id	Text	Manuell	Abacus-Steuerkennzeichen-ID. Wird vom Integrator ausgefüllt, um Shopware-Steuersätze Abacus zuzuordnen; wird beim Auftragsexport gelesen.

Kunde (abacus_custom_customer)

Feld	Typ	Richtung	Zweck
abacus_customer_subject_id	Text	Abacus → SW	Abacus-Kunden-Subjekt-ID. Wird durch die Shopper-Synchronisation geschrieben.
abacus_shopper_id	Text	Abacus → SW	Abacus-Shopper-ID. Primärschlüssel zum Abgleich eines Shopware-Kunden mit einem Abacus-Shopper.
abacus_debtor_number	Text	Abacus → SW	Abacus-Debitorennummer. Wird für die Preisgestaltung bei angemeldeten Kunden (kundenspezifische Preise) und beim Bestellexport verwendet.

Anrede (abacus_custom_salutation)

Feld	Typ	Richtung	Zweck
abacus_salutation_id	Text	Manuell	Abacus-Anrede-ID. Wird vom Integrator ausgefüllt (sprachsensitiv in Shopware); wird beim Kundenimport und beim Bestellexport verwendet.

Verkaufseinheit (abacus_custom_unit)

Feld	Typ	Richtung	Zweck
abacus_unit_id	Text	Manuell / Zuordnung	Ordnet eine Shopware-Einheit einem Abacus-Verkaufseinheitscode zu; wird bei der Produktsynchronisation abgeglichen.

Bestellung (abacus_custom_order)

Feld	Typ	Richtung	Zweck
abacus_order_id	Text	Abacus → SW	Abacus-Auftrags-ID. Wird geschrieben, wenn das Abacus-Dokument zu einem Auftrag verarbeitet wird.
abacus_sales_order_id	Zahl	Abacus → SW	Abacus-Verkaufsauftrags-ID. Wird verwendet, um eingehende Änderungen des Bestellstatus mit der Shopware-Bestellung zu verknüpfen.
abacus_order_sent	Kontrollkästchen	SW → Abacus	Wird auf true gesetzt, nachdem die Bestellung erfolgreich nach Abacus exportiert wurde.

Versandart (abacus_custom_shipping_method)

Wird nur verwendet, wenn „Versandkosten als Einzelposten senden“ aktiviert ist.

Feld	Typ	Richtung	Zweck
abacus_shipping_method_id	Zahl	Manuell	Abacus-Produkt-ID, die die Versandart repräsentiert.
abacus_shipping_method_variant_id	Zahl	Manuell	Abacus-Varianten-ID für das Versandprodukt.
abacus_shipping_method_tax_id	Text	Manuell	Abacus-Steuerkennzeichen-ID für den Versand.
abacus_shipping_method_designation	Text	Manuell	Bezeichnung/Name der Versandposition in Abacus.

Vertriebskanal (abacus_sales_channel, über Migration hinzugefügt)

Feld	Typ	Richtung	Zweck
abacus_sales_channel_is_used_for_abacus_sync	Boolescher Wert	Manuell	Aktiviert die Abacus-Synchronisation für einen bestimmten Vertriebskanal (Multi-Tenant-/kanalbezogene Konfiguration).

Vom Plugin verwaltete technische Felder

Diese werden direkt in die Entität customFields JSON geschrieben und sind nicht als beschriftete Admin-Felder registriert. Integratoren sollten sie nicht manuell setzen.

Feld	Entität	Richtung	Zweck
abacus_address_id	customer_address	Abacus → SW	Abacus-Adress-ID (Subjekt-ID), die für jede Rechnungs- und Lieferadresse gespeichert wird. Unerlässlich für die Adresszuordnung beim Bestellausgang; wird durch die Shopper-Synchronisation geschrieben.
abacus_product_fallback_price_<salesChannelId>	product	Abacus → SW	Brutto-Fallback-Preis, der während der Produktsynchronisation (pro Vertriebskanal) geschrieben wird. Wird vom Preis-Cache-Warmup verwendet, um Produkte auszuwählen, die einen Abacus-Preis (> 0) haben.
abacus_product_fallback_net_price_<salesChannelId>	Produkt	Abacus → SW	Netto-Fallback-Preis, der während der Produktsynchronisierung geschrieben wird. Wird derzeit von keiner Plugin-Logik verwendet.

Laufzeitfelder der Pricing-API

Werden von der Pricing-API zum Zeitpunkt der Anfrage für jedes Produkt/jede Position an die Storefront bereitgestellt. Diese sind Teil der API-Antwort-Nutzdaten und keine persistenten benutzerdefinierten Felder.

Feld	Richtung	Zweck
abacus_price_type	Abacus → Storefront	Von welchem Abacus-Preistyp der Preis stammt: Liste (Standard), Staffel, Sonderangebot oder Aktion.
abacus_discount_details	Abacus → Storefront	Rabattdetails für die Position: type (Prozentsatz/Betrag), value und discountType (Preistyp, aus dem der Rabatt stammt).
abacus_default_guest_price	Abacus → Storefront	Der Gastpreis (für nicht angemeldete Kunden), der angezeigt wird, wenn für einen angemeldeten Kunden ein Sonderpreis festgelegt ist.