Skip to main content

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 istrichtet fürsich nichtan erfahrenefortgeschrittene BenutzerBenutzer. nicht geeignet! FallsWenn Sie Fragen haben, meldenwenden Sie sich bitte beian IhremIhren Abacus Abacus-Partner oder direkt beian derdie Ping AG.

Import

Dieses Feature wurde entwickelt, daum vielezusätzliche Informationen bereitzustellen, die von vielen Themes und Plugins zusätzlichebenötigt Informationenwerden, benötigen, welcheaber über die StandardschnittelleStandardschnittstelle nicht abgerufenabrufbar oder garin Abacus nicht erst im Abacus definiert werden können.sind.

Beispiele:

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

WirIn verwendendiesem für diese Anleitung das Beispiel: "Der KundeBeispielchtechten neben dem pingWoowir ein weiteres Plugin neben pingWoo installieren, welchesdas neben der Produktbeschreibung einen weiterenzusätzlichen Reiter 'Zutaten'für anzeigt"."Zutaten" anzeigt.

Wie gehen Sie vor?

ImIn Abacus können Sie in diversenverschiedenen Tabellen Userfields definieren. Wir unterstützen zurzeitDiese Userfields beiwerden denaktuell Produkten,für Produkte, Produktvarianten und Benutzern.Benutzer Dieseunterstützt Userfieldsund können verschiedeneunterschiedliche Werte beinhalten:enthalten, z.B.:

  • Ja/Nein
  • NummerischerNumerischer Wert
  • Zeichenabfolge
  • etc.Zeichenfolgen

Alle Datentypen werdensind unterstützt!tzt Dieseund können Sie imin Abacus sonach einstellen,Wunsch wieeingestellt Siewerden. Nach der Definition und Befüllung dieser Daten ist es gerne möchten. Sobalderforderlich, die Datenkorrekte definiertZuordnung undfür befüllt wurden, müssen diese jetzt noch korrekt beimden Import zugeordnet werden:festzulegen.

Gehen wir davon aus, dassFalls keine speziellen Einstellungen im Plugin vorgenommen wurden.wurden, Wennwird Siedas imBeispiel-Userfield Userfield(z.B. UserField Nr. 1 definiertfür haben, dass dies die Zutaten sind, wird"Zutaten") beim Import in die Produkt Produkt-Metadaten folgendesso gespeichert:

Meta

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

WichtigWichtig:: Die Schnittstelle übermittelt lediglich die generischen Bezeichnungen vonder denUserfields, Userfields nicht, sondern lediglichz.B. UserField{NUMMER}., und nicht deren benutzerdefinierte Namen.

Jetzt

müsste

Damit das Zutaten Zutaten-Plugin irgendwiediese wissen,Daten dassabfragen diekann, Informationen als "UserField1" gespeichert wurden. Dies ist jedoch leider nicht möglich. Deswegen könnenmüssen Sie die Userfields in pingWoo umbenennen:

umbenennen.

Durch

Diedie bewirktUmbenennung jetztvon folgendes:UserField1 Beimin "zutaten", wie im Bild zu sehen, wird beim Import werdender dieMeta-Schlüssel Zutatenfolgendermassen nicht mehr als "UserField1" abgespeichert sondern:
angepasst:

Meta

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

SomitJetzt kann das zusätzliche Plugin erfolgreich die Daten korrekt abfragen und anzeigen. WieDie diegenaue MetaBezeichnung der Meta-Schlüssel heissen,kann müssenje Sie beim jeweiligennach Plugin oder Theme selbstvariieren herausfinden. Dasbitte istprüfen sehrSie individuell.dies in der jeweiligen Dokumentation.

Export

Die UserFieldsUserfields werden bidirektional unterstützt. Falls z.B.Wenn ein neu-neu erstellter Kunde beispielsweise Standardwerte benötigt, kann man diesedies wie folgt definieren:definiert werden:

image.png

Beispielkonfiguration: Mit dem Schlüsselwort "_default" definierenlegen Sie fest, welches UserField einen Standardwert haben soll.
BeiWird derein Erstellungneuer vonKunde einem neuen Kunden imin WooCommerce angelegt, erhält dieserer sofort dieses UserField mit dem definierendefinierten Wert:

Meta

  • Meta-Schlüssel:ssel: "b2b"
    Metab2c"
  • Wert:
  • Meta-Wert: "1"

SobaldBei dieserder Synchronisierung mit Abacus synchronisiert wird, werden die UserFieldsUserfields ebenfalls übermittelt. 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.