Skip to main content
In this chapter
< Contents
Print

Connect OXID eShop

Open the menu with the gear icon in the top right and select Integrations. 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 Prepare OXID Connector.

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.