WooCommerce orgaMAX API Schnittstelle

Die Schnittstelle zwischen WooCommerce und orgaMAX hat die Aufgabe, Bestellungen per Klick aus dem Shop ins Warenwirtschaftssystem von OrgaMax zu importieren. Sparen Sie Zeit und Aufwand und lassen Sie unser Script die Arbeit verrichten. 

Folgende Aufgaben erledigt die Schnittstelle:

• Abgleichen der vorhandenen Bestellungen (je nach Status separat einstellbar) und
• Übernahme neuer Bestellungen von WooCommerce zu orgaMAX
• Export von Artikeln von orgaMAX zu WooCommerce
• Import von Artikeln von WooCommerce zu orgaMAX
• Aktualisieren der Preise von orgaMAX zu WooCommerce
• Aktualisieren der Lagerbestände von orgaMAX zu WooCommerce

Eine ausführliche Anleitung finden Sie auch auf der Seite von orgaMAX.

Was umfasst der optionale Einrichtungsservice?

Wir sorgen dafür, dass die Synchronisation zwischen orgaMAX und WooCommerce ordnungsgemäß abläuft. Dabei gehen wir in folgenden Schritten vor:

1. Installation der Schnittstelle im WooCommerce Shop über einen temporären Admin-Account
2. Einrichtung der Schnittstellen-Optionen individuell für den Kunden
3. Einrichtung der Verbindung in OrgaMax mit dem WooCommerce Shop  (z.B. mit TeamViewer o. Ä.)
4. Konfiguration der Schnittstelle in orgaMAX
5. Durchführen einer Testbestellung und Abgleichen des Imports

Damit ein Abgleich der Bestellungen zwischen orgaMAX und WooCommerce stattfinden kann, muss das Plugin unter WordPress eingerichtet und die Verbindung zwischen orgaMAX und WP in den Ecommerce-Einstellungen hergestellt werden.

1. Installieren Sie auf gewohnter Weise das orgaMAX Plugin in Ihrer WordPress Installation und geben Sie den Lizenz-Schlüssel ein, um Zugriff auf die Schnittstellen-Informationen zu erhalten, mit denen Sie orgaMAX anschließend einrichten können:
   
2. Nach der Aktivierung der Lizenz erhalten Sie Zugriff auf die Einstellungen:

   
   
   

3. Wählen Sie, welche Bestellungen importiert werden sollen (Beispiel):

   

4. Rufen Sie nun die E-Commerce-Einstellungen in orgaMAX auf:
   
   
5. Geben Sie bitte den Pfad ein, den Sie in WordPress angezeigt bekommen haben. 
    
6. Speichern Sie die Einstellungen ab.

Für einen korrekten Ablauf ist zu beachten:

• Die Artikelnummern in WooCommerce müssen mit den orgaMAX-Artikelnummern bzw. der Webshop-ID übereinstimmen. Nur so kann eine reibungslose Übernahme der Bestellungen erfolgen!

• NEU: Abgleich von Artikel-Bezeichnung über individuelle Felder
• NEU: Vorbereitung für Kompatibilität zu WPML über ein Add-on
• FIX: Wording im Bereich Artikel-Import

• FIX: Variationspreis inklusive / ohne Steuern

• FIX: Korrektur der Anzeige für Lagerbestand in der Artikelübersicht
• FIX: Anzeige des Datumswählers für Bestellimporte unter Safari korrigiert
• Fix: Korrekturen in der Übertragung von Preisen und Mengen von Varianten (Variable Produkte in WooCommerce)

• FIX: Wenn eine Bestellung keine Positionen erhält, bricht das Script nicht mehr ab (\"Es sind keine neuen Bestellungen vorhanden\"), sondern springt zur nächsten Bestellung und importiert diese.

• Fix: Korrekturen im Speicherungsprozess. Änderungen an den Einstellungen werden nun für alle Tabs übernommen

• Fix: Korrekturen im Speicherungsprozess. Änderungen an den Einstellungen werden nun für alle Tabs übernommen

• Komplette Überarbeitung der Oberfläche. Elemente sind nun in Tabs strukturiert
• Einführung des Abgleichs der individuellen Felder
• Abgleich von 5 individuelle Artikel-Felder über WooCommerce Attribute

• NEU: Steuersätze können nun für das Ursprungsland in den Einstellungen gesetzt werden, um beim Artikelimport korrekte Preise zu erhalten. Dabei werden die Steuersätze verwendet, die in WooCommerce gepflegt sind.
• NEU: Unterstützung von individuellen Felder beginnend mit Hooks eingeführt, Informationen können über Filter angepasst werden

• FIX: Korrektur bei Abfrage von Artikeln aus dem Shop

• FIX: Korrektur der Berechnung von Gutscheinen
• FIX: Begrenzung der Rundung in WooCommerce auf 2 Nachkommastellen

• Unterstützung für 2. Adress-Feld in WooCommerce
• Korrekturen in der Übertragung von Zahlungsweisen

• Anzeige der Einstellungen auch für Rolle des Shop-Managers hinzugefügt
• Bei automatischer Änderung am Status nach Bestell-Import wird dies nun in der Bestellhistorie angezeigt
• Entfernung der Checkbox am Passwort-Feld
• kleine Design-Änderungen
• Übernahme des WooCommerce Steuersatzes

• Veränderung an der Funktion, die offene Bestellungen prüft

• Korrekturen im Import-Prozess: In seltenen Fällen wurden Bestellungen mit einem uneindeutigen Status versehen und verblieben als Datenleichen im Shop. Aktualisierungen von Lagerbeständen war somit nicht möglich, da man immer zuerst offene Bestellungen importieren muss
• Versandkosten-Bezeichnung: Standardmäßig wird nun die Bezeichnung der Versandkosten gewählt, die im WooCommerce eingestellt ist. Wenn in orgaMAX ein Artikel für Versandkosten eingestellt ist, kann diese Bezeichnung stattdessen verwendet werden (dazu muss in der Schnittstelle der Ursprung der Bezeichnung entsprechend eingestellt sein)
• Korrekturen von Fehlern, bei dem ein Import mit vorab gewähltem Status nicht korrekt erfolgte

• Beseitigung eines Bugs, bei dem die Datumsauswahl keine Bestellungen über die Schnittstelle ausgab

• Neu: Unterstützung für PinPoint Buchungssystem (Buchungsdaten werden in der Bestellung angezeigt)
• Korrekturen bei der Übertragung des Lagerbestandes
• Der Standard-Ordner für Neu-Installationen der Schnittstelle ist nun wp-content

• Neu: Über eine neue Einstellung kann nun frei entschieden werden, ob man priorisiert Brutto- oder Nettopreise importieren will (Dies war bei manchen Kunden wichtig für die Rechnungsstellung geworden)
• Neu: Nach abgeschlossenem Import kann der Bestellung ein neuer Status zugewiesen werden (z.B. Fertiggestellt)
• Tweak: Kunden von Raidboxes u.a. konnten die Schnittstelle nicht ausführen, da Scripte im Upload-Ordner generell untersagt sind. Über die erweiterten Einstellungen kann das gesamte Import-Script nun in den wp-content-Ordner umgestellt werden.

• Tweak: Die SQL-Abfrage für den Export der Bestellungen wurde komplett überarbeitet. Bestellungen werden so schneller von orgaMAX abgeholt, bzw. im gleichen Zug können so mehrere Bestellungen pro Abruf importiert werden

• Fix: Preissynchronisierung wurde überarbeitet und wird nun in WooCommerce sowohl im Artikel selbst als auch in der Artikelübersicht korrekt angezeigt

• FIX: Behebung von Problemen beim Abruf
• NEU: Hinzufügen eines einzelnen Abrufs einer Bestellung

• Umfangreiche Erweiterung für die Schnittstelle
• NEU: Export von Artikeln von orgaMAX zu WooCommerce
• NEU: Import von Artikeln von WooCommerce zu orgaMAX
• NEU: Aktualisieren der Preise von orgaMAX zu WooCommerce
• NEU: Aktualisieren der Lagerbestände von orgaMAX zu WooCommerce

• FIX: Korrekturen am Wording
• FIX: Erweiterung der Datenbankkompatibilität mit MySQL

• NEU: Abfrage der Artikelbeschreibung entweder aus orgaMAX oder WooCommerce möglich

• NEU: Hinzufügen eines neuen Feldes für Name der Firma (für Rechnungsadresse)

• NEU: Hinzufügen von mehreren neuen Feldern, die nun von orgaMAX abgefragt werden können
• FIX: Korrekturen in der Übertragung der Zahlungsoptionen
• NEU: Abruf von möglichen separaten Zahlungskosten (z.B. bei Nachnahmegebühren)

• NEU: orgaMAX-Ordner muss nun nicht mehr manuell ins Root-Verzeichnis verschoben werden. Dies wird bei der Aktivierung des Plugins automatisch gemacht
• NEU: Auch beim Update wird die nötige Schnittstellendatei für orgaMAX automatisch im Root-Verzeichnis auf Versionsnummer geprüft und ausgetauscht
• NEU: Ab sofort ist es möglich, Bestellungen je nach Status zu importieren. Somit können z.B. nur \"fertiggestellte\" Bestellungen importiert werden.
• NEU: Es können nun auch Produktvarianten mit eigenen Artikelnummern abgefragt werden.

1. Kann der Status der Bestellungen nach Import verändert werden?

Ja, seit Version 2.2.1 kann der Bestellstatus nach Abholung auf einen anderen Status umgestellt werden:

2. Werden die erstellten Rechnungen wieder an WooCommerce zurückgegeben (z.B. als PDF) und der Bestellung angehängt?

Nein, die Rechnung wird von unserer Schnittstelle nicht wieder zurück zum Shop transferiert. Unsere Kunden senden diese meist ausgedruckt im Paket mit. Eine Zusammenfassung der Bestellung, die auch als Rechnung dienen kann, wird durch WooCommerce bereits per E-Mail versendet. Manche unsere Kunden verwenden das Plugin German Market, um die PDF direkt im Bestellprozess zu erstellen und in der Bestellbestätigungsemail an den Kunden zu senden.

3. Ist der Lagerbestand ist immer aktuell? Wenn der Kunde einen Artikel bestellt, ab wann verringert sich dann der Bestand?

Der Lagerbestand wird aktualisiert, wenn Sie Bestellungen einlesen. Dies wird jedoch über orgaMAX kalkuliert, d.h. es wird nicht der aktuelle Lagerbestand übermittelt und dann aktualisiert, sondern orgaMAX subtrahiert die Artikel vom bestehenden Lagerbestand in der eigenen Warenhaltung. Sie können andersherum aber eine Aktualisierung des Shops erwirken, indem Sie in orgaMAX die korrekte Zahl eintragen und dann über das Webshop-Update-Menü diese Zahl an den Shop senden.

4. Wenn ich etwa 300 Artikel habe, kann ich diese Artikel einfach per Klick in den Shop einspielen und es werden Texte, Preise und Fotos übertragen?

orgaMAX unterstützt momentan nur den Export von Titel, Text und Preis. Beim Export der Produkte werden diese im Shop auf Entwurf gestellt. Bilder werden derzeit von orgaMAX nicht unterstützt, was aber auch in WooCommerce keinen Sinn macht, denn: Das Template Ihres Online-Shops arbeitet mit individuellen Bildgrößen. Diese werden erst durch einen regulären Upload in WordPress berechnet und in den verschiedenen Varianten abgespeichert. Das heißt, es ist manuelle Nacharbeit nötig, um die beste Qualität der Produktdarstellung zu bekommen.

5. Es lassen sich keine Artikel von orgaMAX zu WooCommerce exportieren. Die Fehlermeldung lautet, dass keine Artikel abgerufen werden können.

Für die erstmalige Synchronisation bzw. den Export von Artikeln muss mindestens einen Artikel mit Artikelnummer in WooCommerce angelegt sein, weil orgaMAX erst einen Vergleich beider Datenstämme macht. Wenn keine Artikel vorliegen, wird ein Fehler ausgegeben.

Individuelle Felder

Folgende Funktion kann genutzt werden, um auf die Daten individuelle Felder zuzugreifen bzw. diese zu verändern:

function change_me_function_name( $individualFields, $productSku, $productId ) {
// (maybe) modify $individualFields array.
return $individualFields;
}
add_filter( 'orgamax_product_individual_fields', 'change_me_function_name', 10, 3 );

• WPML - Add-on: Wenn Sie einen mehrsprachigen Online-Shop einsetzen und Artikel in bestimmten Sprachen abgleichen möchten, nutzen Sie dieses Add-On.