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

Dieses Kapitel ist für nicht erfahrene Benutzer nicht geeignet! Falls Sie Fragen haben, melden Sie sich bitte bei Ihrem Abacus Partner oder direkt bei der Ping AG.

Import

Dieses Feature wurde entwickelt, da viele Themes und Plugins zusätzliche Informationen benötigen, welche über die Standardschnittelle nicht abgerufen oder gar nicht erst im Abacus definiert werden können.

Beispiele:

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

Wir verwenden für diese Anleitung das Beispiel: "Der Kunde möchte neben dem pingWoo ein weiteres Plugin installieren, welches neben der Produktbeschreibung einen weiteren Reiter 'Zutaten' anzeigt".

Wie gehen Sie vor?

Im Abacus können Sie in diversen Tabellen Userfields definieren. Wir unterstützen zurzeit Userfields bei den Produkten, Produktvarianten und Benutzern. Diese Userfields können verschiedene Werte beinhalten:

Ja/Nein
Nummerischer Wert
Zeichenabfolge
etc.

Alle Datentypen werden unterstützt! Diese können Sie im Abacus so einstellen, wie Sie es gerne möchten. Sobald die Daten definiert und befüllt wurden, müssen diese jetzt noch korrekt beim Import zugeordnet werden:

Gehen wir davon aus, dass keine Einstellungen im Plugin vorgenommen wurden. Wenn Sie im Userfield Nr. 1 definiert haben, dass dies die Zutaten sind, wird beim Import in die Produkt Metadaten folgendes gespeichert:

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

Wichtig: Die Schnittstelle übermittelt die Bezeichnungen von den Userfields nicht, sondern lediglich UserField{NUMMER}.

Jetzt müsste das Zutaten Plugin irgendwie wissen, dass die Informationen als "UserField1" gespeichert wurden. Dies ist jedoch leider nicht möglich. Deswegen können Sie die Userfields in pingWoo umbenennen:

Die bewirkt jetzt folgendes: Beim Import werden die Zutaten nicht mehr als "UserField1" abgespeichert sondern:

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

Somit kann das zusätzliche Plugin erfolgreich die Daten abfragen und anzeigen. Wie die Meta Schlüssel heissen, müssen Sie beim jeweiligen Plugin oder Theme selbst herausfinden. Das ist sehr individuell.

Export

Die UserFields werden bidirektional unterstützt. Falls z.B. ein neu-erstellter Kunde Standardwerte benötigt, kann man diese wie folgt definieren:

Mit dem Schlüsselwort "_default" definieren Sie welches UserField einen Standardwert haben soll.
Bei der Erstellung von einem neuen Kunden im WooCommerce erhält dieser sofort dieses UserField mit dem definieren Wert:

Meta Schlüssel: "b2b"
Meta Wert: "1"

Sobald dieser mit Abacus synchronisiert wird, werden die UserFields ebenfalls übermittelt.