Appearance
OXID eShop konfigurieren
Shop-Adapter
Diese Seite beschreibt nur OXID-spezifische Einstellungen. Generischer Ablauf: Verbindungen · Adapter-Übersicht.
ReadySync verbindet sich mit OXID eShop 7.5 oder neuer (CE, PE oder EE). OXID liefert keine fertige Admin-REST-API für Artikel und Bestellungen. Deshalb braucht der Shop das ReadySync Bridge-Modul.
Pflicht im OXID-Shop
ReadySync OXID Bridge installieren
Ohne dieses Modul kann ReadySync den Shop nicht ansprechen. Installieren Sie es im OXID-Shop (nicht in ReadySync) und aktivieren Sie es.
github.com/netzkombyse/readysync-oxid-bridge · Installation in der README
Was die Verbindung kann
| In ReadySync | Im OXID-Shop |
|---|---|
| Artikel anlegen und aktualisieren | Stammdaten, Preis, Bestand, Aktiv, EAN, Texte, Gewicht |
| Varianten | Elternartikel mit Achsennamen, Varianten mit Werten (z. B. Farbe und Größe) |
| Staffelpreise | Mengenstaffeln am Artikel |
| Kategorien | Fehlende Ebenen unter einer Wurzelkategorie anlegen und zuordnen |
| Bilder | Bis zu 12 Produktbilder |
| Bestellungen exportieren | Lesen inkl. Adresse, Positionen, Versand |
| Bestellstatus | OXID-Order-Folder setzen |
Nicht vorgesehen: Verkaufskanäle (kein Shopware-Konzept), Grundpreis/Einheiten außer Gewicht, mehr als 12 Bilder.
Voraussetzungen
- OXID eShop 7.5+ (CE, PE oder EE)
- ReadySync OXID Bridge 1.1.0 oder neuer, installiert und aktiv
- Shop-URL per HTTPS
- Ein OXID-Admin nur für ReadySync (
oxidadmin/malladmin)
Nach der Installation prüfen:
bash
curl -sS https://shop.example.com/api/readysync/healthErwartet: "ok": true und "version": "1.1.0" (oder höher).
Verbindung in ReadySync
- Verbindung öffnen → Tab Shop → Typ OXID.
- Felder eintragen:
| Feld | Beschreibung |
|---|---|
| Shop-URL | Basis-URL, z. B. https://shop.example.com (ohne Slash am Ende) |
| API-Pfad | /api/readysync (Default, nur ändern wenn der Shop einen anderen Prefix nutzt) |
| Benutzer / Passwort | OXID-Admin, der die Bridge nutzen darf |
| Order-Folder für Export | optionale OXFOLDER-Filter, kommagetrennt; leer = alle |
| Folder nach Export | optionaler Ziel-Folder, damit Bestellungen nicht doppelt exportiert werden |
- Tab Test → Shop-Verbindung prüfen.
JWT ist optional. Die Bridge erwartet HTTP Basic mit dem Admin-Benutzer.
Produktimport
Im Tab Produktimport (alles standardmäßig aus):
| Funktion | Wirkung in OXID |
|---|---|
| Varianten | Zeilen einer Gruppe werden zum Elternartikel plus Varianten. Achsennamen am Elternartikel, Werte an der Variante. |
| Staffelpreise | Mengenstaffeln aus dem Mapping. OXID speichert sie relativ zum Artikelpreis – keine Preisregel nötig. |
| Kategorien | Pfade aus dem Mapping. Fehlende Ebenen entstehen unter der Wurzelkategorie (32-stellige OXID). |
Die Zuordnung der Dateispalten legen Sie im Mapping fest. OXID-Texte und Felder erscheinen nur bei einer OXID-Verbindung.