Konfiguration

Plugin

Allgemein

Aktualisierungskanal: Definiert, welche Updates von PingWoo installiert werden sollen.
Next: beinhaltet die neusten Funktionen, kann Fehler enthalten
Stable: wurde bei mehreren Installationen getestet, dürfte keine Fehler enthalten
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.
Sensible Informationen: Speichert die Authentifizierung, Plugin Updates etc. in den Logs.
Performance-Analyse: Speichert die Laufzeit einzelner Funktionen in den Logs. Dient zur Idenfizierung von Performance-Problemen.
Automatische Aktualisierungen: Auf Kundenanfrage haben wir die Möglichkeit hinzugefügt, dass PingWoo sich nicht mehr automatisch aktualisiert. Dies empfehlen wir nicht, da eine Migration von PingWoo nicht vorgesehen ist.

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).
Standard Geschäftsbereich-ID:

Verhalten

Gelöschte WooCommerce Shopper in Abacus löschen: Üblicherweise werden Abacus Shopper nicht gelöscht, wenn WooCommerce Shopper gelöscht werden. Mir dieser Option werden diese automatisch gelöscht.
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.
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).

Import

Allgemein

Anzahl Objekte: Definiert, wie viele Objekte pro Durchlauf verarbeitet werden sollen. Dies ist z.B. nützlich, wenn Produkte sehr viele Bilder haben. Wenn ein Import stecken bleibt, lohnt es sich, die Zahl runterzustellen.
Zeichenkodierung: Wenn Umlaute oder Sonderzeichen nicht korrekt importiert werden, könnte diese Einstellung helfen.

Produkte

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.
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).
Produktbeschreibung ohne Formatierung: Importiert die Produktbeschreibung ohne Farben, Schriftgrössen etc. Die HTML Struktur bliebt jedoch vorhanden.
Produktbeschreibung ohne Veränderungen: Importiert die Produktbeschreibung ohne jegliche Verarbeitung. So wie sie im Abacus definiert ist, wird sie importiert.
Produkte müssen klassiert sein: Wenn ein Produkt nicht klassiert und diese Option aktiviert ist, wird dieses nicht importiert.
Kurzform von Einheiten: Standardmässig importieren wir die Beschreibung der Einheit in voller Grösse, z.B. "Meter". Mit dieser Option importieren wir die Kurzform, z.B. "m".

Shopper

Shopper Benutzername: Definiert, ob Sonderzeichen aus Benutzernamen entfernt werden sollen. Standardmässig werden diese von unserem Plugin entfernt. Wir probieren die Benutzernamen WordPress-freundlich zu importieren. Mit dieser Option wird der Benutzername nicht verändert.
Kontaktadresse übernimmt die Benutzerfelder: Kontaktpersonen können eigene UserFields haben. Mit dieser Option übernimmt die Kontaktperson jedoch die UserFields von der Hauptadresse (z.B. von der Firma).

Produktsortiment

Produktsortiment aktiv: Definiert, ob die Abacus Funktionalität "Produktsortimente" benutzt werden soll oder nicht. Diese Funktion ermöglicht es Kunden unterschiedliche Produkte anzuzeigen.
Standard Produktsortiment allen Kunden anzeigen: Definiert, ob das Standardsortiment den Kunden angezeigt werden soll, welche eigene Sortimente haben (Standardsortiment + eigene Sortimente).
Standard Produktsortiment-ID: Definiert das Sortiment, welches Gästen, Kunden ohne Sortimente etc. angezeigt werden soll.

Bestellungen

Funktionen

Funktion Offertanfrage: Diese Funktion aktiviert die Möglichkeit während einer Bestellung das Häkchen "Als Offerte" anzuwählen. Dadurch landet die Bestellung im J15 nicht unter "Bestellungen", sondern unter "Offerten".
Dateien hochladen im Warenkorb: Durch diese Option wird ein ähnlicher Mechanismus zum alten Abashop aktiviert und die Kunden können Dokumente etc. zu einer Bestellung hochladen.
Warenkorb herunterladen/hochladen:
Erfassungsmaske anzeigen:
Anrede im Bestellvorgang: Manche Kunden benötigen eine Anrede in einer Bestellung. Durch diese Option wird die Anrede bei der Adresseingabe aktiviert

Verhalten

Benutzerbemerkung an Abacus senden: Ein Häkchen hier bedeutet, dass die Benutzerbemerkung in einer Bestellung an Abacus gesendet werden soll.
Produktinformationen: Wenn diese Einstellung aktiviert ist, werden die Produktinformationen im J15 und im O111 aus dem Shop entnommen. Wenn sie deaktiviert wird, werden Produktinformationen aus Abacus verwendet.
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.

Zuschläge

Grundsätzlich ist bei allen Zuschlägen ein wichtiger Gedanke zu beachten: Abacus bietet zwei Möglichkeiten Zuschläge bei einer Bestellung zurück zu übermitteln.

Als Position: Wenn ein Zuschlag als "Minusposition" übermittelt wird, können im Abacus verschiedene Werkzeuge verwendet werden, um Analysen durchzuführen. Zudem können Aufträge im Nachhinein verändert werden, ohne das Abweichungen entstehen. Hierfür muss jedoch ein Zuschlagsartikel im Abacus existieren.
Wenn ein Produkt hinterlegt ist, erfolgt für den Zuschlag eine Preisfindung.
Als Zuschlag: Zuschlag wird in WooCommerce verwaltet. Es werden lediglich die Informationen übermittelt, z.B. 9 CHF von 200 CHF Rabatt. Abacus erwartet immer einen Betrag als Zuschlag. Wenn z.B. ein 10% Rabatt angewendet, und später die Bestellung verändert wird, können Abweichungen entstehen. Hierfür ist jedoch kein Zuschlagsartikel notwendig.

Versand

Bei allen Versandarten, die sich am WooCommerce Standard halten, erscheint ein neues Feld "Produkt ID":

Wenn man keine WooCommerce Produkt ID definiert, werden die Versandkosten als Zuschlag übermittelt und es wird der Preis sowie der Name von WooCommerce verwendet.

Wir unterstützen beide WooCommerce Standards.

Gutschein

Bei Gutscheinen erscheint ebenfalls ein neues Feld "Produkt ID":
Dieses funktioniert identisch, wie bei den Versandarten, ausser das der Gutschein "Name" (Code) nicht von Abacus übernommen wird.

Kleinmenge

Diese Funktionalität wurde vollständig von uns entwickelt und existiert sonst in WooCommerce nicht. In den WooCommerce Einstellungen erscheint ein neuer Reiter "pingwoo-Zuschlag":Wir haben die Oberfläche so simpel und selbsterklärend wie möglich gestaltet. Man kann einen Zuschlag definieren und die Benutzergruppen auswählen, bei welchen er anwendet. Anschliessend definiert man die Mindestbestellmenge in CHF und wie viel Zuschlag angewendet werden soll, wenn die Mindestbestellmenge nicht erreicht wurde.

Das Feld "Produkt ID" funktioniet auch hier ebenfalls identisch wie bei den Versandarten und Gutscheinen. Der Name sowie der Preis wird von Abacus ermittelt.

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.

Unterstützte Userfields:

ADO (UserFields und FreeFields)
AFO
OVI
DST
ASI (UserFields und FreeFields)
DKO

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.