Zum Hauptinhalt springen
In diesem Kapitel
< Inhalt
Drucken

Mit OXID eShop verbinden

Öffnen Sie oben rechts das Menü mit dem Zahnrad und wählen Sie Anbindungen. Wenn noch keine Anbindung eingerichtet wurde, öffnet mailfino direkt die Auswahl der verfügbaren Systeme. Andernfalls klicken Sie im Anbindungsmanager auf Neue Anbindung.

Wechseln Sie auf Shop-Systeme und wählen Sie OXID eShop. Falls der Connector noch nicht installiert ist, laden Sie ihn im Schritt Zugangsdaten herunter und folgen Sie dem Kapitel OXID Connector vorbereiten.

Tragen Sie danach die Shop-URL, den Connector User und den API Key ein. Die Shop-URL ist die normale Adresse Ihres Shops, zum Beispiel https://shop.example.com.

mailfino prüft die Verbindung, bevor die Anbindung gespeichert wird. Dabei ruft mailfino eine kleine Kundenseite über den Connector ab. Wenn die Prüfung erfolgreich ist, wird die Anbindung angelegt und in der linken Liste angezeigt.

Gespeicherte OXID AnbindungGespeicherte OXID Anbindung

Gespeicherte OXID Anbindung

Für die Integration braucht der Connector Leserechte auf Kunden, Bestellungen, Bestellpositionen, Produkte und Kategorien. Schreibrechte sind für den Import und die Segmentierung nicht erforderlich.

Wenn OXID hinter einer Firewall, einem Reverse Proxy oder einer Basic-Auth-Sperre liegt, muss der mailfino Server den Connector trotzdem erreichen können. Prüfen Sie in diesem Fall, ob die Route /mailfino/api/health von außen erreichbar ist.

Open the gear menu in the top right and choose Connections. If no connection has been set up yet, mailfino opens the system selection directly. Otherwise, click New connection in the connection manager.

Switch to Shop systems and select OXID eShop. If the connector is not installed yet, download it in the Credentials step and follow the chapter Prepare the OXID Connector.

Then enter the shop URL, connector user, and API key. The shop URL is the normal address of your shop, for example https://shop.example.com.

mailfino checks the connection before it is saved. During this check, mailfino retrieves a small customer page through the connector. When the check succeeds, the connection is created and appears in the list on the left.

Saved OXID connection
Saved OXID connection

For the integration, the connector needs read permissions for customers, orders, order items, products, and categories. Write permissions are not required for import and segmentation.

If OXID is behind a firewall, reverse proxy, or Basic Auth restriction, the mailfino server still needs to reach the connector. In that case, check whether the route /mailfino/api/health is externally reachable.