Quincefin ↔ OpenCart & Horoshop

Quincefin ↔ Shops Sync ist eine Integrations-Middleware zwischen QUINCEFIN (Buchhaltung / Bestandsverwaltung) und den Online-Shops:

• OpenCart 2.3
• Horoshop

QUINCEFIN ist das führende System für Bestände und Preise. Die Middleware befindet sich zwischen den Systemen: Sie empfängt Ereignisse, ruft vollständige Produkt- und Bestelldaten ab und überträgt Änderungen an die Online-Shops (und übernimmt Bestellungen auch zurück in QUINCEFIN).

Das System wird benötigt, weil:

• Die Webhooks von QUINCEFIN senden nur eine ID und einen Zeitstempel — daher muss der Empfang bestätigt, die tatsächlichen Daten erneut abgerufen und anschließend an die Shops verteilt werden.

API-Schlüssel sind auf bestimmte IP-Adressen beschränkt; die Shops haben Anfrage-Limits.

• OpenCart 2.3 verfügt über keine integrierte API für Bestände oder Preise.
• Ein zentraler Dienst mit fester IP-Adresse, einer Warteschlange sowie einer Zuordnung von Produkten und Bestellungen sorgt dafür, dass alle Daten konsistent bleiben.

Was das System macht

QUINCEFIN → Shops

Bestände und Verkaufspreise werden mit OpenCart (und optional mit dem Horoshop-Katalog) synchronisiert. Produkt-Webhooks werden zusammengefasst, sodass mehrere schnell aufeinanderfolgende Änderungen zu einer einzigen Aktualisierung werden. Ein nächtlicher Abgleich erkennt Daten, die möglicherweise durch Webhooks verpasst wurden.

### Shops → QUINCEFIN

Neue und aktualisierte Bestellungen werden alle 5 Minuten in QUINCEFIN als Verkaufsdokumente importiert (`OC-…` für OpenCart, `HS-…` für Horoshop). Die Kundendaten werden im Kommentar hinterlegt, Rabatte auf die einzelnen Positionen angewendet und ein fester Name für den Einzelhandelspartner verwendet.

Die Statusseiten für den Betreiber (`/status`, Bestellprotokolle, Live-Probes) zeigen den Zustand der Kanäle, die letzten Ausführungen und die zugeordneten Bestellungen, ohne dass die Shop-Administration verwendet werden muss.

OpenCart-Plugin: Dimoks Sync

Dimoks Sync ist eine kleine Erweiterung für OpenCart 2.3 (Typ: Feed), die im OpenCart-Shop installiert wird.

Es handelt sich um ein echtes, im Administrationsbereich sichtbares Modul (Extensions → Feeds → Dimoks Sync) und nicht nur um lose Dateien. Es stellt eine durch einen Token geschützte JSON-API bereit, die von der Middleware verwendet wird.

Administratoreinstellungen

• Integration aktivieren / deaktivieren
• Sync Token (muss mit `OPENCART_TOKEN` auf dem Middleware-Dienst übereinstimmen)
• Produkt-Schlüsselfeld: `model` oder `sku` (Artikelnummer / article, die zur Zuordnung mit QUINCEFIN verwendet wird)
• Endpoint-Hinweis für die Ping-URL

Was die Modul-API bereitstellt

• Ping — Prüfung von Erreichbarkeit und Version
• Products — Lesen und Aktualisieren von Menge, Preis und Status anhand der Artikelnummer
• Orders — Abrufen der seit einem bestimmten Zeitstempel geänderten Bestellungen (für den Import in QUINCEFIN)
• Optional order status push back to OpenCart — optionales Zurückübertragen des Bestellstatus an OpenCart

Ohne dieses Modul kann OpenCart 2.3 nicht von QUINCEFIN aus gesteuert werden, um Bestände und Preise zu aktualisieren.

In einem Satz

Die Middleware hält Bestände und Preise von QUINCEFIN mit OpenCart (über das Plugin Dimoks Sync) und Horoshop synchron und importiert außerdem Bestellungen aus den Online-Shops als `OC-…`- / `HS-…`-Dokumente in QUINCEFIN.