PrestaShop installieren

Voraussetzungen

Stellen Sie vor Beginn der Installation sicher, dass:

Sie PrestaShop 1.6 oder höher verwenden – jede Version von 1.6 bis zu den neuesten Releases 8.x und 9.x wird unterstützt (es wird empfohlen, Ihren Shop aktuell zu halten)
Sie Zugriff auf das Administrator-Backoffice haben
Ihre Website über HTTPS erreichbar ist

Einen API-Zugangsschlüssel in PrestaShop erzeugen

Um die Webservice-API von PrestaShop mit Order Invoicer zu nutzen, müssen Sie zunächst die Funktion aktivieren und anschließend einen sicheren Zugangsschlüssel erzeugen.

1. Den Webservice aktivieren

Melden Sie sich mit Ihren Administrator-Zugangsdaten im PrestaShop-Backoffice an
Navigieren Sie zu Erweiterte Parameter > Webservice (in PrestaShop 1.6 als Web service bezeichnet)
Aktivieren Sie die Option Webservice von PrestaShop aktivieren, indem Sie „Ja" auswählen
Klicken Sie auf Speichern, um die Änderungen anzuwenden

Aktivieren des Webservice

Wichtig: Die Aktivierung des Webservice ist erforderlich, damit Order Invoicer Ihre Bestellungen und Kundendaten abrufen kann.

2. Einen sicheren Zugangsschlüssel erstellen

Klicken Sie unter Erweiterte Parameter > Webservice auf Neuen Webservice-Schlüssel hinzufügen
Konfigurieren Sie den Schlüssel mit den folgenden Einstellungen:

Grundkonfiguration

Schlüssel: Klicken Sie auf Generieren, um einen eindeutigen 32-stelligen Schlüssel zu erhalten (oder geben Sie einen eigenen ein)
Schlüsselbeschreibung: Fügen Sie eine klare Beschreibung hinzu (z. B. „Order Invoicer - Sellsy Integration")
Status: Aktivieren Sie den Schlüssel, indem Sie „Aktiviert" auswählen

Order Invoicer überprüft diese Berechtigungen bei der Verbindung und lehnt die Konfiguration ab, falls eine davon fehlt. Setzen Sie für jede der folgenden Ressourcen mindestens ein Häkchen bei Ansehen (GET):

✅ addresses — Rechnungs- und Lieferadressen
✅ carriers — bei Bestellungen verwendete Versanddienstleister
✅ combinations — Produktkombinationen (Größen, Farben usw.)
✅ countries — Länder der Kundenadressen
✅ currencies — Bestellwährungen
✅ customers — Kunden
✅ order_details — Bestellpositionen
✅ order_payments — Bestellzahlungen
✅ order_slip — Gutschriften / Erstattungen
✅ orders — Bestellungen
✅ products — Produkte
✅ shops — Shops (erforderlich zur Identifizierung Ihrer Installation)
✅ taxes — auf Bestellungen angewandte Steuern

Tipp: Verwenden Sie im PrestaShop-Bildschirm den Link Alle auswählen oben in der Spalte Ansehen (GET), um Zeit zu sparen, und entfernen Sie anschließend nur bei den Ressourcen das Häkchen, für die Sie keinen Zugriff freigeben möchten.

Optionale Berechtigungen

Nur erforderlich, wenn Sie diese Funktionen nutzen:

stock_availables — Ansehen + Bearbeiten (PUT), falls Sie Bestände aus Ihrem Rechnungstool nach PrestaShop synchronisieren
customer_threads, customer_messages, contacts — Ansehen + Hinzufügen (POST), falls Order Invoicer bei Rechnungsereignissen Kundenservice-Tickets erstellen soll
groups — Ansehen (GET), falls Sie PrestaShop-Kundengruppen als Preisraster verwenden und diese mit Ihren Kunden synchronisieren möchten (werden auf Bestellungen angezeigt). Ohne diese Berechtigung funktioniert die Synchronisierung trotzdem — die Gruppen werden lediglich ausgelassen.
tax_rule_groups, tax_rules — Ansehen (GET), um den von Ihrem Shop tatsächlich angewendeten Steuersatz zu erfassen, statt ihn aus den Bestellbeträgen abzuleiten. Ohne diese Berechtigungen funktioniert die Synchronisierung trotzdem — der Satz wird aus den Summen abgeleitet.

Multistore-Konfiguration (falls zutreffend)

Shop-Zuordnung: Wählen Sie im Multistore-Modus die Shops aus, auf die der Schlüssel Zugriff gewährt
Wenn Sie mehrere Shops haben, wählen Sie nur diejenigen aus, die Sie verbinden möchten

Klicken Sie auf Speichern, um den Schlüssel zu erstellen

Erstellen eines Zugangsschlüssels

3. Die Verbindungsdaten abrufen

Notieren Sie nach dem Erstellen des Schlüssels die folgenden Angaben:

Ihre Shop-URL: https://your-store.com
API-Schlüssel: Der erzeugte Schlüssel (32 Zeichen)

Wichtig: Bewahren Sie diese Informationen sicher auf. Sie benötigen sie, um den Connector in Order Invoicer zu konfigurieren.

Die Konfiguration überprüfen

API-Test

Um zu prüfen, ob Ihr Schlüssel funktioniert, fordern Sie damit eine einzelne Ressource an — übergeben Sie den Schlüssel im Query-Parameter ws_key:

https://your-store.com/api/orders?ws_key=YOUR_KEY&limit=1

Sie sollten eine XML-Antwort erhalten, die eine Bestellung enthält. Wenn Sie erhalten:

401 oder 403: Der Schlüssel ist deaktiviert oder besitzt kein Ansehen (GET) für diese Ressource — überprüfen Sie den Status des Schlüssels und seine Berechtigungen.
Einen Fehler bei https://your-store.com/api/ (dem Stamm): Dies allein bedeutet nicht, dass der Schlüssel defekt ist. Bei vielen Installationen liefert der Webservice-Stamm einen 500-Fehler oder eine HTML-Seite zurück, selbst wenn die einzelnen Ressourcen-Endpunkte einwandfrei funktionieren. Testen Sie daher stets eine bestimmte Ressource wie oben gezeigt statt der reinen /api/-URL.

Häufige Fehlerbehebung

Fehler „Webservice nicht aktiviert"

Prüfen Sie, ob der Webservice unter Erweiterte Parameter aktiviert ist
Leeren Sie bei Bedarf den PrestaShop-Cache

Fehler „Ungültiger API-Schlüssel"

Prüfen Sie, ob der Schlüssel genau 32 Zeichen lang ist
Stellen Sie sicher, dass der Schlüssel aktiv ist
Prüfen Sie die erteilten Berechtigungen

Fehler „Zugriff verweigert"

Prüfen Sie, ob Ihre Shop-URL korrekt ist
Stellen Sie sicher, dass Ihre Website über HTTPS erreichbar ist
Prüfen Sie die Berechtigungen des API-Schlüssels

Fehler „Fehlende Berechtigungen: …" Order Invoicer gibt genau an, welche Ressourcen fehlen. Kehren Sie zum Webservice-Schlüssel zurück und setzen Sie für jede der aufgeführten Ressourcen ein Häkchen bei Ansehen (GET), und starten Sie dann die Konfiguration erneut.

Support

Falls Sie auf Schwierigkeiten stoßen:

Prüfen Sie den obigen Abschnitt zur Fehlerbehebung
Ziehen Sie die offizielle PrestaShop-Dokumentation heran
Kontaktieren Sie unseren Support: contact@orderinvoicer.com

Nächste Schritte

Sobald Ihr Schlüssel konfiguriert und der Connector in Order Invoicer erstellt ist:

Installieren Sie das PrestaShop-Modul für eine nahezu sofortige Bestellsynchronisierung (optional).
Deaktivieren Sie PrestaShop-Rechnungen, damit Ihr Rechnungstool die Rechnungsnummerierung übernimmt.