Konfiguration

Allgemein

Plugin

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

Produkttyp sichtbar: Mit dieser Einstellung lässt sich definieren, welcher Abacus Produkt Typ im Shop sichtbar sein soll
WooCommerce führend: Ein Häkchen hier bedeutet, dass Produkt-Subscriptions ignoriert werden. Die Produkte werden in WooCommerce erfasst und gepflegt, man hinterlegt die Abacus Produkt ID beim Produkt im WooCommerce.
Leere Klassierungen aus der Shop-Navigation ausblenden: Ein Häkchen hier bedeutet, dass Klassierungen ohne Produkte in der Navigation nicht angezeigt werden.
Einweg-E-Mail-Adressen blockieren: Definiert, ob ungültige und temporäre E-Mail-Adressen blockiert werden sollen. Dies betrifft Bestellungen und Registrierungen.
Name der Versandart: Ein Häkchen hier bedeutet, dass die Namen der Versandarten mit den konfigurierten Abacus Zuschlagsartikel synchronisiert werden.
Produktlager immer abfragen: Wenn eine Bestellung kürzlich getätigt wurde, ist der Lagerbestand im Abacus falsch bis die Bestellung im J15 verarbeitet wird. Damit im Shop trotzdem der korrekte Lagerbestand angezeigt wird, blockieren wir die Lager Abfrage, bis wir eine Subscription erhalten "Bestellung wird nun verarbeitet".

Kundenverwaltung

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.
Standardklassierung: Bei der Erstellung von einem neuen Kunden wird die hinterlegte Standardklassierung gesetzt
Klassierungsnummer: Die Nummer der Standardklassierung für neue Kunden, wenn 0 wird die erste gefundene Klassierung verwendet.
Zeitachseneinträge: Ein Häkchen hier bedeutet, dass bei einer Adresserstellung ein gültig ab Datum mit gesendet wird.
Anrede: Definiert, ob ein Feld für die Anrede überall angezeigt werden soll.
Kurzname: Definiert, ob bei Adressänderungen der Kurzname ebenfalls angepasst werden soll.
Addressvergleich: Definiert, ob Adressänderungen und Kontoerstellungen in WooCommerce direkt an Abacus übermittelt werden sollen. Ansonsten werden Änderungen nur bei einer Bestellung übermittelt.
Speicherort Rechnung: Definiert, wo neue Rechnungsadressen gespeichert werden sollen. Sie kann immer auf der Kundenadresse gespeichert werden, auch wenn eine Kontaktperson hinterlegt ist, oder auf der Kontaktperson, falls vorhanden, sonst Kundenadresse (fallback).
Speicherort Lieferung: Definiert, wo neue Lieferadressen gespeichert werden sollen. Sie kann immer auf der Kundenadresse gespeichert werden, auch wenn eine Kontaktperson hinterlegt ist, oder auf der Kontaktperson, falls vorhanden, sonst Kundenadresse (fallback).

Preisfindung

Veraltete Preisfindung verwenden: Diese Option erfordert Absprache mit der Ping AG. Wird künftig entfernt.
Kundenpreise auch offline: Ein Häkchen hier bedeutet, dass wenn die Live-Preisfindung nicht erreichbar ist, diese von PingWoo simuliert wird. Dafür wird einmal täglich die gesamte Preisfindung von Abacus heruntergeladen.
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.
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).
Erste Variante ist die Hauptvariante: Ein Häkchen hier bedeutet, dass wenn die Einstellung "Zeige den Preis der ersten Variante an" aktiviert ist, der Preis der Variante 0 angezeigt wird. Ansonsten wird der Preis der ersten verfügbaren Variante angezeigt. Wird künftig entfernt.
Variantenpreise auch abfragen: Ein Häkchen hier bedeutet, dass wenn bei der Variante 0 der Fehler von Abacus "No data found" zurückgegeben wird, dennoch alle weiteren Varianten abgefragt werden. Ansonsten hört die Preisfindung nach dem Fehler auf. Wird künftig entfernt.
Live-Preisfindung für Versandkosten: Ein Häkchen hier bedeutet, dass die Versandkosten über die Preisfindung abgefragt werden, wenn ein Zuschlagsartikel definiert wurde.
Preis ohne Rabatt: Wenn aktiv, werden für Kundenspezifische Preise (der Preis ohne Rabatt), die Werte aus dem Import verwendet (z.B. Kunde hat einen Aktionspreis 20 CHF und der Artikel ist eigentlich 30 CHF. Damit die 30 CHF angezeigt werden, ist diese Einstellung notwendig, oder ein Fixpreis).
Fixpreis Gäste: Hier kann man den Fixpreis für Gäste definieren. Dieser wird für die Preisdarstellung "durchgestrichener Preis" verwendet und auch an Abacus zurückgesendet.
Genauigkeit Nachkommastellen: Definiert, auf wie viele Nachkommastellen PingWoo überall runden soll.

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.

Klassierungen

Parent-ID im Slug: Wenn mehrere Klassierungen den exakt gleichen Namen haben, aber sich in unterschiedlichen Klassierungsbäumen befinden, wird beim Import die ID von der Klassierung eine Ebene drüber am Slug angehängt (z.B. 10rot und 110rot). Der Grund ist, dass WooCommerce Slugs als Eindeutig betrachtet.
Oberste Klassierung überspringen: Mit dieser Einstellung kann man die oberste Klassierung, auch "Definition" genannt, überspringen (z.B. Alle Klassierungen -> Farben -> Rot, dann wird "Alle Klassierungen" nicht importiert).

Produkte

Produkte täglich aktualisieren: Manchmal können durch Abacus-Neustarts o.Ä. Änderungen (Subscriptions) verloren gehen. Um dies zu bekämpfen wird mit dieser Einstellung jeden Tag ein "Full-Sync" ausgelöst.
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.
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".
Gewichtstyp: Definiert, welches Feld für das Gewicht im Shop verwendet werden soll.
Variantenbenutzerfelder: Standardmässig werden Variantenbenutzerfelder nur bei Varianten importiert. Die Variante 0 (Hauptprodukt) besitzt jedoch grundsätzlich ebenfalls Variantenfelder. Diese können mit dieser Einstellung importiert werden.
Produktbenutzerfelder: Standardmässig werden Produktbenutzerfelder nur bei Hauptprodukten importiert. Die Varianten besitzen jedoch grundsätzlich ebenfalls Produktfelder. Diese können mit dieser Einstellung importiert werden.

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.
Auflösungsmodus:

Bestellungen

Funktionen

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: Durch diese Option wird im Warenkorb ein Knopf angezeigt, mit welchem man den Warenkorb herunterladen kann.
Erfassungsmaske anzeigen:
Projektauswahl: Diese Option ermöglicht im Bestellvorgang ein Projekt auszuwählen. Die Bestellung wird dann dem Projekt zugeordnet.
Einmal-Adresse: Diese Option erfordert Absprache mit der Ping AG.

Verhalten

Bemerkung 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.
Lieferkosten bei der Übermittlung: Definiert, ob Lieferkosten zum Bestelltotal im Abacus hinzugefügt werden sollen.
Zuschläge bei der Übermittlung: Definiert, ob alle anderen Zuschläge zum Bestelltotal im Abacus hinzugefügt werden sollen.
Lieferung an Kundenadresse: Wenn ein Kunde eine abweichende Rechnungsadresse besitzt, aber keine Lieferadresse eingibt, setzt WooCommerce diese standardmässig als Lieferadresse. Dieses Verhalten kann mit dieser Einstellung überschrieben werden.
Emails an Kundenadresse: Wenn ein Kunde eine abweichende Rechnungsadresse besitzt, werden Shop Emails standardmässig an die hinterlegte Email gesendet. Dieses Verhalten kann mit dieser Einstellung überschrieben werden.
Einheitsbeziehungen: Definiert, ob der Preis Faktor oder Lager Faktor in einer Bestellposition übermittelt werden soll.
Bestellung testen: Wenn aktiv, werden Bestellungen nicht an Abacus gesendet. Das Ergebnis ist dadurch nur im Log ersichtlich.
Dateiformat: Definiert, in welchem Format der Warenkorb heruntergeladen werden soll. Nur relevant, wenn die Funktion aktiv ist.

Emails

Einweg-Email-Einstellungen

Blockierte Einweg-Emails: PingWoo blockiert bekannte Einweg-Email-Anbieter, jedoch entstehen täglich neue Anbieter. Hiermit kann man zwischenzeitlich eine neue, zusätzliche, Domain hinzufügen, welche blockiert werden soll.
Erlaubte Einweg-Emails: PingWoo besitzt neben der Einweg-Email-Anbieter Prüfung auch weitere Überprüfungen. Diese können möglicherweise mehr blockieren als gewünscht ist. Hiermit kann man zwischenzeitlich eine neue, zusätzliche, Domain hinzufügen, welche erlaubt sein soll (z.B. interne Email-Adressen).

Zuschläge

Wichtig: Die WooCommerce Produkt ID ist NICHT die Produktnummer, sondern die WooCommerce Produkt Datenbank ID. Diese muss eine NUMMER sein! Diese finden Sie auch NICHT im Abacus!

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

NPO (Projekte)
ADO (Produktstamm)
- UserFields
- FreeFields
AFO (Produktbezeichnungen)
OVI (Produktvarianten)
DST (Kundenstamm)
ASI (Adresszusatz)
- UserFields
- FreeFields
AVB (Adress-Verbindungen)
DKO (Auftragkopf)

Diese Funktion wurde entwickelt, um zusätzliche Informationen bereitzustellen, die möglicherweise von Drittanbieter Themes und Plugins benötigt werden, aber über die Standardschnittstelle und Standard WooCommerce Felder nicht abrufbar sind.

Beispiele:

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

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

Vorgehensweise

Im Abacus können Sie in verschiedenen Tabellen UserFields definieren. UserFields können unterschiedliche Werte enthalten, z.B.:

Ja/Nein
Numerischer Wert
Zeichenfolgen

Alle Datentypen werden unterstützt und können in Abacus nach Wunsch eingestellt werden. Nach der Definition und Befüllung dieser Daten, sind die UserFields automatisch im Shop verfügbar.

Die UserFields werden standardisiert importiert und haben vordefinierte Namen. Falls jedoch ein anderer Name benötigt wird, z.B. damit Drittanbieter Plugins die Werte finden kann, kann man seit PingWoo 0.7.0.0 ein Mapping definieren.

Beispiel:

Auf der ADO Tabelle ist das UserField1 definiert. Dieses wird standardisiert als productadditionaluserfield1 importiert und befindet sich auf der postmeta Tabelle. Nun erwartet das Drittanbieter Plugin aber einen anderen Namen für das Feld und kann den Wert nicht auslesen.

Jetzt kann man in den Einstellungen definieren, dass wenn das Metafeld "zutaten" ausgelesen wird, dass der Wert von productadditionaluserfield1 benutzt werden soll.

Dies gilt auch für Schreibaktionen. Wenn man "zutaten" probiert zu beschreiben, landet der Wert automatisch in productadditionaluserfield1.

Es können auch mehrere Verbindungen auf das gleiche Feld existieren.

Wichtig: Verbindungen zu Felder von Benutzern werden unter "Kunden" definiert. Dazu gehören die Tabellen: NPO, ASI, AVB, DST

Verbindungen zu Felder von Produkten oder Bestellungen werden unter "Beiträge" definiert. Dazu gehören die Tabellen: ADO, AFO, OVI, DKO

Sollten Sie nicht wissen, wie ein Feld heisst, wenn es standardisiert importiert wird, können Sie ein Produkt, eine Bestellung oder einen Kunden bearbeiten. Dort sehen Sie an verschiedenen Orten "Metadaten", auch finden Sie die Felder in den jeweiligen Meta Tabellen in der WordPress Datenbank.

Export

UserFields werden bidirektional unterstützt. Wenn ein neuer Kunde, eine neue Adresse oder eine neue Verbindung Standardwerte benötigt, kann dies wie folgt definiert werden:

Diese Konfiguration setzt den Wert "1" auf das UserField1 von der ASI Tabelle, wenn eine neue Adresse erstellt wird.

Wichtig: Hier werden Sie feststellen, dass der Prefix fehlt. Wenn Sie einen Benutzer bearbeiten, werden Sie dieses Feld nicht finden, sondern "customer_subjectuserfield1", "billing_subjectuserfield1" und "shipping_subjectuserfield1".

Damit man für Kunden-, Rechnungs- und Lieferadressen das gleiche Verhalten definieren kann, lässt man den Prefix weg. Dies funktioniert jedoch ausschliesslich für den Export. Beim Mapping muss das richtige Feld, wie es in den Meta Tabellen heisst, verwendet werden.

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.