Meinen PrestaShop per Access-Token in orgaMAX ERP einrichten
In diesem Artikel zeigen wir Dir, wie Du Deinen PrestaShop über einen Webservice-Schlüssel (Access-Token) mit orgaMAX verbindest.
Kurzantwort
Öffne in orgaMAX Stammdaten > Einstellungen > E-Commerce, lege einen neuen Webshop an und wähle PrestaShop aus. Erstelle anschließend im PrestaShop-Backend einen Webservice-Schlüssel, hinterlege die erforderlichen Berechtigungen und trage die Webshop-URL sowie den Webservice-Schlüssel in orgaMAX ein. Nach erfolgreicher Verbindung kannst Du die weiteren Einstellungen für Deinen Shop konfigurieren.
Die Einrichtung über den Access-Token ersetzt die bisherige Anbindung über die klassische Shopschnittstelle. Nach der erfolgreichen Verbindung stehen Dir die gleichen Einstellungen für den Bestell- und Artikelimport wie bei anderen unterstützten Webshops zur Verfügung.
Schritt-für-Schritt-Anleitung
Schritt 1: Neuen PrestaShop in orgaMAX anlegen
Öffne Stammdaten > Einstellungen > E-Commerce und wechsle zum Bereich Webshops.
Klicke auf Neu. Falls die Auswahl angezeigt wird, wähle Neuen Webshop verknüpfen aus.

Wähle anschließend PrestaShop als Shopsystem aus und klicke auf Nächster Schritt.

Schritt 2: Webservice in PrestaShop aktivieren
Melde Dich im Administrationsbereich Deines PrestaShops an.
Öffne Shop-Einstellungen > Erweiterte Einstellungen > Webservice und aktiviere die Option Webservice aktivieren.

Klicke anschließend auf Webservice-Schlüssel hinzufügen, um einen neuen Schlüssel zu erstellen.

Schritt 3: Webservice-Schlüssel erstellen
Klicke auf Erzeugen, damit PrestaShop einen neuen Webservice-Schlüssel erstellt.
Vergib anschließend eine aussagekräftige Bezeichnung, beispielsweise orgaMAX.
Diesen Webservice-Schlüssel benötigst Du später für die Einrichtung in orgaMAX.
Schritt 4: Berechtigungen vergeben
Vergib für den Webservice-Schlüssel die benötigten Berechtigungen.

Für die folgenden Ressourcen müssen die jeweiligen Berechtigungen Sehen (GET), Ändern (PUT), Hinzufügen (POST), PATCH und Löschen (DELETE) aktiviert werden:
| Ressourcen | GET | POST | PATCH | DELETE | Verwendung |
| orders | ✅ | Bestellungen abrufen | |||
| order_states | ✅ | Bestellstatus-Texte/IDs auflösen | |||
| order_histories | ✅ | ✅ | Bestellstatus lesen & setzen | ||
| order_cart_rules | ✅ | Rabatte/Gutscheine einer Bestellung laden | |||
| messages | ✅ | Kundenkommentar zur Bestellung laden | |||
| products | ✅ | ✅ | ✅ | Artikel abrufen, anlegen, Preise aktualisieren | |
| combinations | ✅ | ✅ | ✅ | Varianten Abruf, Anlage, Preise aktualisieren | |
| product_options | ✅ | ✅ | Variantenopt. (z. B. "Farbe") lesen/anlegen | ||
| product_option_values | ✅ | ✅ | Variantenopt.werte (z. B. "Rot") lesen/anlegen | ||
| stock_availables | ✅ | ✅ | Lagerbestand lesen & aktualisieren | ||
| tax_rules | ✅ | Steuersatz eines Artikels ermitteln | |||
| taxes | ✅ | Steuersatz-Prozentwerte auflösen | |||
| currencies | ✅ | Währung einer Bestellung auflösen | |||
| carriers | ✅ | Versanddienstleister einer Bestellung auflösen | |||
| customers | ✅ | Kundendaten einer Bestellung laden | |||
| addresses | ✅ | Liefer-/Rechnungsadresse laden | |||
| countries | ✅ | Land einer Adresse auflösen | |||
| languages | ✅ | Sprachcodes des Shops ermitteln | |||
| configurations | ✅ | Shop-Standardland ermitteln |
Speichere anschließend den Webservice-Schlüssel.
Schritt 5: Zugangsdaten in orgaMAX eintragen
Wechsle zurück nach orgaMAX.

Trage folgende Angaben ein:
- Internetadresse (URL): Die URL Deines PrestaShop-Webshops.
- Webservice-Schlüssel: Den zuvor erstellten Webservice-Schlüssel.
Klicke anschließend auf Nächster Schritt. Nach erfolgreicher Prüfung bestätigt orgaMAX die Verbindung.
Schritt 6: Einrichtung abschließen
Schließe den Einrichtungsassistenten ab.
Anschließend öffnet sich die Konfiguration Deines PrestaShops in orgaMAX-ERP. Dort kannst Du die Einstellungen für den Bestell- und Artikelimport an Deine Anforderungen anpassen. Diese Einstellungen entsprechen den allgemeinen Webshop-Einstellungen in orgaMAX.
Die ersten Bestellungen können ca. 15 Minuten nach Einrichtung abgerufen werden.
Häufige Fragen
Welche URL muss ich in orgaMAX eintragen?
Trage die Internetadresse Deines PrestaShop-Webshops ein. Diese wird verwendet, um die Verbindung zum Webservice herzustellen.
Welche Berechtigungen benötigt der Webservice-Schlüssel?
Der Webservice-Schlüssel benötigt Lese-, Schreib-, Änderungs-, PATCH- und Löschrechte für die im Artikel aufgeführten Ressourcen. Nur so kann orgaMAX Bestellungen, Kunden, Artikel und weitere Daten korrekt verarbeiten.
Kann ich einen vorhandenen Webservice-Schlüssel verwenden?
Ja, sofern dieser bereits über alle erforderlichen Berechtigungen verfügt. Andernfalls solltest Du einen neuen Webservice-Schlüssel speziell für orgaMAX erstellen.
Was passiert nach der erfolgreichen Einrichtung?
Nach der erfolgreichen Verbindung kannst Du die weiteren Einstellungen für Deinen Webshop konfigurieren und anschließend den Bestell- und Artikelimport nutzen. Diese Einstellungen unterscheiden sich nicht von denen anderer unterstützter Webshops.