Appearance
Architektur & Datenfluss
ReadySync ist die Integrationsschicht zwischen einem Quellsystem (typisch ERP) und einem Shop-System. Quelle und Shop kommunizieren nicht direkt miteinander. Beide sprechen über jeweils einen Adapter mit ReadySync. Dazwischen liegt ein kanonisches Datenmodell, das unabhängig vom konkreten Quell- oder Shop-System ist.
┌─────────────┐ ┌──────────────────────────┐ ┌─────────────┐
│ Quellsystem │ ──────► │ ReadySync │ ──────► │ Shop-System │
│ (ERP) │ ◄────── │ Adapter · Mapping · Jobs│ ◄────── │ │
└─────────────┘ └──────────────────────────┘ └─────────────┘Bausteine einer Verbindung
Eine Verbindung (Connection) bündelt die Konfiguration für eine konkrete Anbindung eines Mandanten:
| Baustein | Rolle |
|---|---|
| Tenant | Mandant – Daten sind strikt getrennt (Multi-Tenant) |
| Quell-Adapter-Config | Zugang zur Quelle (Datei über FTP/SFTP oder API) |
| Shop-Adapter-Config | Zugang zum Shop (API) |
| Mapping | Zuordnung Quellfelder → kanonische Felder |
| Jobs & Zeitplan | Wann Produkte, Bilder, Bestellungen oder Status laufen |
| Logs | Nachvollziehbarkeit pro Lauf |
ReadySync speichert keine eigene Warenwirtschaft. Produkte und Bestellungen bleiben in Quellsystem und Shop. ReadySync orchestriert den Abgleich.
Datenfluss
1. Produkte & Bilder: Quelle → Shop
Ablauf:
- Einlesen – Der Quell-Adapter holt Artikeldaten (Datei oder API).
- Mapping – Quellfelder werden auf kanonische Felder gemappt (z. B. Artikelnummer →
sku). - Kanonisches Modell – Aus dem Mapping entsteht ein einheitliches Produktobjekt (Preise, Bestand, Kategorien, Varianten, Bilder, …).
- Schreiben – Der Shop-Adapter übersetzt das Objekt in die Shop-API und legt Produkte an bzw. aktualisiert sie.
- Bilder – Bilddateien kommen per FTP/HTTP (oder analog aus der Quelle) und werden über die Media-API des Shops verknüpft.
Importarten: Delta (nur Änderungen) oder Vollimport (kompletter Abgleich), zeitgesteuert oder manuell.
2. Bestellungen: Shop → Quelle
- ReadySync liest neue/offene Bestellungen aus dem Shop.
- Die Bestellung wird in eine normalisierte Form gebracht (Adressen, Positionen, Beträge).
- Der Quell-Adapter schreibt sie in das Format der Quelle (Exportdatei oder API-Call).
3. Bestellstatus: Quelle → Shop
Bei Statuswechseln in der Quelle (bezahlt, versendet, …) holt ReadySync die Information und aktualisiert den Shop.
Kanonisches Modell
Zwischen Quelle und Shop übersetzt ReadySync nicht 1:1 „Quellfeld X → Shop-Feld Y“, sondern:
Quelle → kanonisches Feld → Shop
Beispiele kanonischer Produktfelder:
| Kanonisches Feld | Bedeutung |
|---|---|
sku | Artikelnummer |
name | Produktname |
price.gross | Verkaufspreis brutto |
stock | Bestand |
active | Sichtbar / kaufbar |
description | Beschreibung |
categories | Kategoriepfad |
images / image_1 … | Produktbilder |
variant_group / variant_option.* | Varianten |
Konsequenzen für Adapter:
- Ein Quell-Adapter mappt nur bis zum kanonischen Modell.
- Ein Shop-Adapter schreibt nur vom kanonischen Modell in die Shop-API.
- Mapping und Transformationen (Einheiten, Preise, Texte) bleiben in der Verbindung konfigurierbar – ohne Änderung am Adapter-Code.
Adapter
ReadySync trennt Quell- und Shop-Seite:
Quell-Adapter (ERP / PIM / Middleware)
↓
kanonisches Modell + Mapping + Jobs
↓
Shop-Adapter| Seite | Aufgabe | Typische Schnittstellen |
|---|---|---|
| Quell-Adapter | Daten lesen/schreiben im Format der Quelle | Datei (FTP/SFTP), REST, SOAP, proprietäre API |
| Shop-Adapter | Produkte/Bestellungen/Status über die Shop-API | REST-/Admin-API des jeweiligen Shop-Systems |
Adapter sind entkoppelt: Das Quellsystem kennt das Shop-System nicht und umgekehrt. Pro Mandant wird eine Verbindung konfiguriert (Credentials, Mapping, Zeitplan); die Adapter-Implementierung ist plattformweit.
| Schicht | Einmalig implementiert | Pro Verbindung konfiguriert |
|---|---|---|
| Quell-Adapter | Ja | Zugangsdaten / Endpunkte |
| Shop-Adapter | Ja | Shop-URL, API-Zugang |
| Mapping | Vorlagen möglich | Feldzuordnung je Datenqualität |
| Jobs / Zeitplan | Job-Typen fest | Intervalle, Delta vs. Voll |
Quellen und Adapter-Stand
| Richtung | Vorhanden | Erweiterbar |
|---|---|---|
| Quelle → ReadySync | Dateibasierte Quellen (FTP/SFTP, CSV/TXT) | API-basierte Quell-Adapter |
| ReadySync → Shop | Shopware 6, WooCommerce, Shopify, OXID | Weitere Shop-Adapter nach demselben Muster |
| Bestellungen / Status | Datei-Export und/oder Shop-API | Dieselben Flüsse über API am Quell-Adapter |
Das Schema bleibt gleich, unabhängig davon, ob die Quelle Dateien bereitstellt oder eine API. Es ändert sich nur die Implementierung des jeweiligen Adapters.
FAQ
Kurzantworten zum Architekturmodell. Praktische Betriebfragen (Imports, Mapping, Bilder, Abrechnung): FAQ.
Muss das Quellsystem das Shop-System kennen?
Nein. Die Quelle liefert Daten an ReadySync; ReadySync spricht mit dem Shop.
Wo liegt die Feldzuordnung?
Im Mapping der Verbindung – nicht fest verdrahtet in Quelle oder Shop.
Was braucht ein neuer Quell-Adapter?
Eine dokumentierte Schnittstelle der Quelle (Auth, Endpunkte bzw. Dateiformat für Artikel/Bestand/Preise, ggf. Bestellungen/Status).
Was braucht ein neuer Shop-Adapter?
Eine dokumentierte Shop-API (Produkte anlegen/aktualisieren, Bestellungen lesen, Status setzen, Medien).
Können mehrere Shops dieselbe Quelle nutzen?
Ja – pro Shop typischerweise eine eigene Verbindung (eigenes Mapping, eigener Zeitplan), gleiche Quell-Adapter-Logik.
Verwandte Themen
- FAQ – häufige Betriebsfragen
- Verbindungen – Konfiguration Quellsystem + Shop
- Mapping – Feldzuordnung und Transformationen
- Import-Typen – Delta, Vollimport, Zeitsteuerung
- Bilder – Bildimport und Zuordnung