Verbindungseinrichtung für den Austausch / die Synchronisierung


Die Integration des Online-Shops, der auf der PrestaShop-Plattform basiert, mit MetaKocka ermöglicht:

- Automatische Übertragung von Bestellungen mit allen Kundendaten (Empfänger, Zahler, Zahlungsmethode, Rabatte und bestellte Produkte).

- Synchronisierung der Produkte (Produkte können aus dem Online-Shop in MetaKocka übertragen werden, einschließlich aller Daten, die bereits im Online-Shop eingegeben wurden).

- Automatische Synchronisierung der Bestände.


Rechnungen, die automatisch basierend auf den übertragenen Bestellungen generiert werden, werden für gesetzlich vorgeschriebene Zahlungsmethoden auch bei FURS bestätigt. Der Lagerbestand für die ausgegebenen Produkte wird entsprechend reduziert und auch im Online-Shop aktualisiert (sofern dies so eingestellt ist).


Erhalt der API-Schlüssel


Um eine Verbindung mit dem PrestaShop Online-Shop herzustellen, müssen die folgenden Daten aus dem PrestaShop-Shop abgerufen werden:

  • Webshop-URL
  • API-Schlüssel für den Zugriff auf den Webservice (PrestaShop WebService Key)

Der API-Schlüssel bleibt bis auf Widerruf gültig.


Schritt-für-Schritt-Anleitung:

1. Melden Sie sich im Admin-Panel des PrestaShop-Shops an und wählen Sie im linken Menü unter der Kategorie Configure die Option Advanced Parameters

2. Wenn sich das Menü erweitert, wählen Sie Webservice



3.  Auf dieser Seite wählen Sie oben rechts die Option Add new webservice key



4. Es öffnet sich eine Seite zum Hinzufügen eines neuen Webservice-Schlüssels

5. Der Key ist ein Pflichtfeld, den Sie entweder selbst eingeben können oder durch Klicken auf die Schaltfläche "Generate" automatisch generieren lassen (empfohlene Option)

6. Key description ist eine eigene Beschreibung, in die Sie angeben können, wofür der Schlüssel verwendet wird (in diesem Fall könnte die Beschreibung „Verbindung mit MetaKocka-Dienst“ lauten)

7. Als Nächstes müssen Sie den Status des neuen Schlüssels auswählen. Er kann entweder aktiviert (Yes) oder deaktiviert (No) sein. Bei der Verbindung mit MetaKocka muss der Schlüssel aktiviert werden, andernfalls funktioniert die Verbindung nicht

8. Der letzte Schritt beim Hinzufügen des neuen Webservice-Schlüssels für den PrestaShop-Shop ist die Auswahl der Berechtigungen (Permissions), die MetaKocka haben wird. In unserem Fall reicht es aus, alle View (GET) und Modify (PUT) Optionen auszuwählen

9. Nachdem die Auswahl abgeschlossen ist, klicken Sie auf die Schaltfläche Save, um die Einstellungen zu speichern und den Schlüssel zu aktivieren



10. Die URL des Online-Shops und der gerade erstellte Schlüssel (Key) müssen nun in der MetaKocka-Weboberfläche eingegeben werden.


Gehen Sie zu Einstellungen / Verbindungen (1), fügen Sie eine Verbindung für PrestaShop hinzu (2), geben Sie die URL Ihres Online-Shops (3) ein, fügen Sie den in Ihrem Shop erhaltenen Schlüssel (4) hinzu und speichern Sie (5). Nach dem Speichern klicken Sie auf Verbindung testen, um zu überprüfen, ob die Verbindung funktioniert.



Produktcode nach Referenznummer

Für die Produktcode wird das Feld Referenzen verwendet.




Produktsynchronisation (Online-Shop <> MetaKocka)

Es werden nur aktive Produkte übertragen.


Weitere Informationen zur Funktionsweise finden Sie hier.

Verbindungsprobleme

401 Unauthorized error

Wenn der Fehler "401 Unauthorized error" auftritt, muss eine entsprechende Änderung in der Apache-Konfiguration vorgenommen werden. Eine Beschreibung des Problems und die Lösung finden Sie auf den folgenden Links:



Schnelle Antwort:
Änderungen müssen in der .htaccess-Datei im Root-Verzeichnis der Website vorgenommen werden.
Vorher:


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule ^api$ api/ [L]


Danach (die fettgedruckte Zeile wurde hinzugefügt):


RewriteRule . - [E=REWRITEBASE:/]

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

RewriteRule ^api$ api/ [L]


Falscher Schlüssel oder Probleme beim Zugriff auf die API

Wenn Apache auf dem Shop nicht korrekt konfiguriert ist, erhalten Sie den Fehler: 401 Unauthorized.


Wenn jedoch der Schlüssel falsch ist, wird ebenfalls der Fehler 401 zurückgegeben, jedoch mit folgendem Inhalt: {"errors":[{"code":20,"message":"Authentification key is not active"},{"code":21,"message":"No permission for this authentication key"}]}


Simulation des Aufrufs über den REST-Client

Die Funktionsweise über den REST-Client kann wie folgt überprüft werden:

  1. Angenommen, Ihre Online-Shop-URL lautet http://18.196.116.84, und der Schlüsselwert ist "1234".
  2. Stellen Sie die URL für den Verbindungstest zusammen: http://18.196.116.84/api/configurations/?display=full&output_format=JSON
  3. Konvertieren Sie den Schlüssel in Base64 (https://www.base64encode.org/) und geben Sie ihn im "Authorization"-Header mit dem Wert "Basic NEY2VjgzVDFLRURSQkpLWEkxWlVaRQ=".
  4. Führen Sie den Aufruf aus, und Sie sollten eine Antwort mit den Daten erhalten.

    Beispiel für die Funktionsweise siehe unten:


Sie sind noch kein Benutzer? Registrieren Sie sich und testen Sie die Funktionalität 30 Tage lang kostenlos!