Konfiguration

Abacus

Plattform-URL: Die URL Ihrer Abacus-Plattforminstanz. Diese Information sollte von Ihrem Abacus-Systemadministrator oder aus der Dokumentation Ihrer Abacus-Installation zur Verfügung gestellt werden.
Mandanten-ID: Die eindeutige Identifikationsnummer Ihres Mandanten in Abacus. Diese ID wird Ihnen von Abacus zur Verfügung gestellt, wenn Ihr Account eingerichtet wird.
Client-ID: Die ID, die Ihrer Anwendung zugeordnet ist, um sich bei Abacus zu authentifizieren. Diese ID erhalten Sie von Abacus, wenn Sie Ihr Plugin oder Ihre Anwendung registrieren.
Client-Geheimnis: Ein geheimer Schlüssel, der für die Authentifizierung mit der Abacus API verwendet wird. Dies ist ein sensibles Datum, das von Abacus bei der Registrierung Ihrer Anwendung bereitgestellt und geheim gehalten werden muss.
Sammel-Debitor-ID: Die eindeutige Identifikationsnummer eines Debitoren Kontos, welches für Gastbestellungen verwendet werden soll. Ist optional, es gibt verschiedene Wege Gastbestellungen zu verarbeiten.
Sammel-Produkt-ID: Die eindeutige Identifikationsnummer (nicht die Produktnummer) eines Produktes in WooCommerce, welches für Gutscheinen mit festem Betrag (z.B. 10 CHF) verwendet werden soll. Dieses Produkt muss keinen Preis beinhalten. Dies wird benötigt, damit eine Minusposition mitgeschickt werden kann (Rabatt).

Plugin

Klassierungsebene: Definiert, welche Klassierungsebene den Produkten zugeordnet werden soll. Ist optional, wird ignoriert, wenn alle Klassierungsebenen auf die Produkte übernommen werden sollen.
Übernehme alle Klassierungsebenen: Ein Häkchen hier bedeutet, dass alle Klassierungsebenen auf die Produkte übernommen werden sollen. Ist optional, man kann auch nur eine spezifische Klassierungsebene zuordnen.
Oberste Klassierungsebene überspringen: Ein Häkchen hier bedeutet, dass die obersten Klassierungsebenen, z.B. "Standardklassierung" übersprungen werden.
Klassierung als Shop-Navigation: Ein Häkchen hier bedeutet, dass die Abacus-Klassifizierung auch zur Navigation in WooCommerce verwendet wird. Dies ist nützlich, wenn Sie eine strukturierte Kategorienavigation basierend auf der Abacus-Klassifizierung haben möchten.
Leere Klassierungen aus der Shop-Navigation ausblenden: Ein Häkchen hier bedeutet, dass Klassierungen ohne Produkte in der Navigation nicht angezeigt werden.
B2C/B2B-Modus: Diese Option erfordert Absprache mit der Ping AG.
Zeichenkodierung beheben: Diese Option korrigiert diverse Sonderzeichen. Erst verwenden, wenn Zeichen auf der Seite falsch angezeigt werden.
Produkte ohne Preise auch importieren: Ein Häkchen hier bedeutet, dass auch Produkte, welche keine Listenpreise enthalten, trotzdem importiert werden (mit dem Preis 0 CHF).
Synchronisierungsintervall: Das Intervall, in dem die Synchronisation zwischen Abacus und WooCommerce stattfinden soll. Dies kann je nach Bedarf und Ressourcenverfügbarkeit eingestellt werden.
Log-Level: Bestimmt, welche Art von Ereignissen im Plugin-Log aufgezeichnet werden sollen. Diese Einstellung kann geändert werden, um mehr oder weniger Details im Log zu erfassen, abhängig von Ihrem Debugging- und Überwachungsbedarf.

Bestellungen

Benutzerbemerkung an Abacus senden: Ein Häkchen hier bedeutet, dass die Benutzerbemerkung in einer Bestellung an Abacus gesendet werden soll.
Gratis Lieferung an Abacus senden: Ein Häkchen hier bedeutet, dass Informationen über eine Gratis Lieferung an Abacus gesendet werden sollen. Nützlich bei downloadbaren Produkten (z.B. PDFs) oder Dienstleistungen.
Erstelle Debitorenkonten für Gäste: Ein Häkchen hier bedeutet, dass ein Abacus Debitorenkonto für einen Gast erstellt wird. Passiert wenn dieser etwas bestellt.
Erstelle Debitorenkonten für WooCommerce-Benutzer: Ein Häkchen hier bedeutet, dass ein Abacus Debitorenkonto für einen WooCommerce-Benutzer erstellt wird. Passiert wenn dieser etwas bestellt und noch kein Abacus Debitorenkonto besitzt.
Adressen erfordern ValidFrom: Ein Häkchen hier bedeutet, dass bei einer Adresserstellung ein gültig ab Datum mit gesendet wird.
Adressvergleich: Definiert wo die Adressprüfung geschehen soll. Wenn WooCommerce definiert ist, werden alle vorherigen Einstellungen berücksichtigt. Ansonsten werden alle vorherigen Einstellungen ignoriert.

Preisfindung

Live-Preisfindung deaktivieren: Ein Häkchen hier bedeutet, dass die Preise aus dem Import angezeigt werden. Preise aktualisieren sich erst bei einer Synchronisierung. Ansonsten werden die Preise bei jeder Anfrage im Shop aktualisiert.
Live-Preisfindung für Gäste deaktivieren: Ein Häkchen hier bedeutet das Gleiche wie die vorherige Einstellung, jedoch nur für Gäste. Angemeldete Benutzer sehen den aktuellen Preis.
Alte Preisfindung verwenden: Diese Option erfordert Absprache mit der Ping AG.
Zeige den Preis der ersten Variante an: Ein Häkchen hier bedeutet, dass immer der erste Preis der Variante abgefragt und angezeigt wird (z.B. 10 CHF). Ansonsten wird eine Preisspanne angezeigt (z.B. 10 - 20 CHF).

Userfields

Achtung: Dieses Kapitel richtet sich an fortgeschrittene Benutzer. Wenn Sie Fragen haben, wenden Sie sich bitte an Ihren Abacus-Partner oder direkt an die Ping AG.

Import

Dieses Feature wurde entwickelt, um zusätzliche Informationen bereitzustellen, die von vielen Themes und Plugins benötigt werden, aber über die Standardschnittstelle nicht abrufbar oder in Abacus nicht definiert sind.

Beispiele:

Business to Business und Business to Client (B2B/B2C)
Erweiterte Produktinformationen: Nährwerte, Zutaten, Abfüller, etc.
Lot-Nummern bei Auktionen
Ungefähre Lieferzeit

In diesem Beispiel möchten wir ein weiteres Plugin neben pingWoo installieren, das neben der Produktbeschreibung einen zusätzlichen Reiter für "Zutaten" anzeigt.

Wie gehen Sie vor?

In Abacus können Sie in verschiedenen Tabellen Userfields definieren. Diese Userfields werden aktuell für Produkte, Produktvarianten und Benutzer unterstützt und können unterschiedliche Werte enthalten, z.B.:

Ja/Nein
Numerischer Wert
Zeichenfolgen

Alle Datentypen sind unterstützt und können in Abacus nach Wunsch eingestellt werden. Nach der Definition und Befüllung dieser Daten ist es erforderlich, die korrekte Zuordnung für den Import festzulegen.

Falls keine speziellen Einstellungen im Plugin vorgenommen wurden, wird das Beispiel-Userfield (z.B. UserField Nr. 1 für "Zutaten") beim Import in die Produkt-Metadaten so gespeichert:

Meta-Schlüssel: UserField1
Meta-Wert: "Die Zutaten"

Wichtig: Die Schnittstelle übermittelt lediglich die generischen Bezeichnungen der Userfields, z.B. UserField{NUMMER}, und nicht deren benutzerdefinierte Namen.

Damit das Zutaten-Plugin diese Daten abfragen kann, müssen Sie die Userfields in pingWoo umbenennen. Durch die Umbenennung von UserField1 in "zutaten", wie im Bild zu sehen, wird beim Import der Meta-Schlüssel folgendermassen angepasst:

Meta-Schlüssel: "zutaten"
Meta-Wert: "Die Zutaten"

Jetzt kann das zusätzliche Plugin die Daten korrekt abfragen und anzeigen. Die genaue Bezeichnung der Meta-Schlüssel kann je nach Plugin oder Theme variieren – bitte prüfen Sie dies in der jeweiligen Dokumentation.

Export

Die Userfields werden bidirektional unterstützt. Wenn ein neu erstellter Kunde beispielsweise Standardwerte benötigt, kann dies wie folgt definiert werden:

Beispielkonfiguration: Mit dem Schlüsselwort "_default" legen Sie fest, welches UserField einen Standardwert haben soll. Wird ein neuer Kunde in WooCommerce angelegt, erhält er sofort dieses UserField mit dem definierten Wert:

Meta-Schlüssel: "b2c"
Meta-Wert: "1"

Bei der Synchronisierung mit Abacus werden die Userfields ebenfalls übertragen.

Bestellung

Viele unserer Kunden haben spezielle Anforderungen an die Informationen, die in einer Bestellung enthalten sein müssen. Diese Informationen müssen schliesslich wieder in das Abacus-System übertragen werden.

Unser Plugin sorgt dafür, dass alle relevanten Metadaten einer Bestellung übermittelt werden. Sie haben zwei Möglichkeiten, festzulegen, wo diese Metadaten definiert werden sollen:

Auf der Ebene der Bestellung (Order meta data)
Auf der Ebene der Artikel (Order item meta data)

Das bedeutet, dass Sie nach dem Erstellen einer Bestellung die entsprechenden Metadaten entweder für die gesamte Bestellung oder für einzelne Artikel eintragen und anpassen können. Diese werden dann automatisch übermittelt.