Zurück zum Blog
Integration8 Min. Lesezeit

Wie man Sage X3 mit einer Cloud-Analytics-Plattform verbindet

Schritt-für-Schritt-Anleitung, um Sage-X3-Daten mit einem leichtgewichtigen, rein ausgehenden Agenten in die Cloud zu synchronisieren. Kein VPN, keine eingehenden Ports, kein IT-Kopfzerbrechen.

Sage X3 ist ein leistungsstarkes ERP für Hersteller und Distributoren im Mid-Market. Es verwaltet Fertigungsaufträge, Bestände, Einkauf und Finanzen über mehrere Einheiten hinweg mit Präzision. Das Problem? Es wurde in einer Zeit konzipiert, in der On-Premise der Standard war, und deine Daten leben noch vollständig in einer SQL-Server-Instanz im Netzwerk deines Unternehmens — was Cloud-Analytics zur Qual macht.

Das Problem: Daten on-premise gefangen

Finanzteams wollen Dashboards in Power BI oder auf einer dedizierten Analyseplattform. Vertriebsleiter wollen Auftrags-Pipelines in Echtzeit auf ihrem Smartphone. CFOs wollen konsolidierte Berichte über mehrere Einheiten, die nicht jeden Monatsabschluss einen Excel-Marathon erfordern.

Nichts davon ist einfach, wenn die Quelle der Wahrheit eine On-Premise-Datenbank ist, die nur SQL Server spricht. Die üblichen Behelfslösungen haben alle gravierende Nachteile.

Traditionelle Ansätze — und warum sie zu kurz greifen

VPN-Tunnel sind das Erste, was die IT vorschlägt. Du schlägst ein Loch in die Firewall, verbindest die Cloud mit dem internen Netzwerk und fragst die Datenbank direkt ab. Das funktioniert — bis ein Security-Audit es entdeckt oder der VPN-Client nach einem Windows-Update kaputtgeht. Der Wartungsaufwand ist erheblich, und die Angriffsfläche ist real.

Individuelle Middleware-APIs bedeuten, eine REST-Schicht vor die Daten von Sage X3 zu bauen. Wenn deine Organisation ein Entwicklerteam hat, ist das machbar. Die versteckten Kosten sind die langfristige Wartung, Sage-Versions-Upgrades, die deine Abfragen brechen, und die Monate an Entwicklungszeit, bevor du ein einziges Diagramm bekommst.

SFTP-Dateiexporte sind der Weg des geringsten Widerstands: nächtlich CSV oder XML exportieren, in den Cloud-Speicher schieben und von dort einlesen. Das liefert dir eine Analytik, die immer 24 Stunden veraltet ist, mit all der Schema-Fragilität, die Flat-File-Pipelines mit sich bringen.

Der agentenbasierte Ansatz

Ein leichtgewichtiges Binary, das innerhalb deines Netzwerks läuft, verändert die Gleichung vollständig. Der Agent verbindet sich direkt mit der SQL-Server-Datenbank von Sage X3, liest die von dir konfigurierten Entitäten (Kunden, Rechnungen, Artikel, Lieferungen) und sendet die Daten ausgehend über HTTPS an die Cloud-Plattform deiner Wahl.

Der entscheidende architektonische Unterschied: der gesamte Verkehr ist ausgehend. Keine eingehenden Ports, keine Firewall-Ausnahmen, kein VPN. Dein Perimeter bleibt intakt. Der Agent initiiert die Verbindung nach seinem Zeitplan und sendet strukturiertes JSON an einen sicheren API-Endpunkt.

Schritt für Schritt: von null zur Live-Synchronisierung

Schritt 1 — Herunterladen und installieren

Lade das Agent-Binary für dein Betriebssystem herunter (Windows Server ist der häufigste Sage-X3-Host). Das Binary ist eine eigenständige ausführbare Datei — keine Runtime-Abhängigkeiten, kein Node.js, keine JVM. Führe es als Windows-Dienst aus, damit es Neustarts übersteht.

Schritt 2 — Verbindung konfigurieren

Erstelle eine config.json mit deinem SQL-Server-Verbindungsstring, der URL deines API-Endpunkts und deinem API-Schlüssel. Der API-Schlüssel wird serverseitig als SHA-256-Hash gespeichert — der Klartext verlässt nach der Erstkonfiguration nie deine Maschine.

Schritt 3 — Discovery ausführen

Führe den Agenten mit dem Flag --discover aus. Er inspiziert das Sage-X3-Schema, listet die verfügbaren Entitäten und ihre Zeilenanzahl auf und meldet zurück. Dieser Schritt bestätigt die Konnektivität und lässt dich genau entscheiden, welche Daten du synchronisieren willst.

Schritt 4 — Erstsynchronisierung und laufende Delta-Synchronisierung

Die erste Synchronisierung lädt historische Daten bis zum konfigurierten Zeitraum (typischerweise 24–36 Monate). Folgende Synchronisierungen sind reine Delta-Läufe: Der Agent verfolgt last_synced_at je Entität und holt nur die seit dem letzten Lauf geänderten Zeilen. So bleibt die Bandbreite minimal und dein Sage-X3-SQL-Server erfährt keine nennenswerte Last.

Sicherheitsarchitektur

Über das Nur-ausgehend-Design hinaus erzwingt der Agent schreibgeschützte Datenbank-Anmeldedaten. Erstelle einen dedizierten SQL-Server-Login mit SELECT-Berechtigung auf dem Sage-X3-Schema und sonst nichts. Selbst wenn der API-Schlüssel kompromittiert wäre, könnte ein Angreifer nicht in dein ERP schreiben.

Alle Daten während der Übertragung nutzen TLS 1.2 oder höher (TLS 1.3, wo unterstützt). Die serverseitige API validiert den API-Schlüssel-Hash bei jeder Anfrage. Anfragen ohne gültigen Schlüssel geben einen 401 zurück, ohne Informationsleck.

Was du tun kannst, sobald die Daten in der Cloud sind

Wenn die Sage-X3-Daten zu einer Cloud-Plattform fließen, eröffnen sich die Anwendungsfälle sofort:

  • Echtzeit-Dashboards für Vertriebsleiter — Auftragseingang, Lieferstatus, Top-Kunden nach Umsatz
  • Anomalieerkennung bei Rechnungen und Zahlungen — Doppelzahlungen, ungewöhnliche Lieferantenbeträge, zeitliche Ausreißer
  • Konsolidierte GuV über mehrere Einheiten ohne Tabellenkalkulationen, mit automatischer Währungsumrechnung
  • Intelligenz zwischen Tochtergesellschaften — Produkte, die in einer Einheit verkauft werden, in einer anderen aber noch nicht, sowie der Abgleich von Kunden über Niederlassungen hinweg
  • Umsatzzuordnung, die die Besuchsaktivität der Außendienstmitarbeiter mit Aufträgen in Sage X3 verknüpft

Die Integration ist kein Selbstzweck. Der Wert liegt in dem, was möglich wird, wenn deine ERP-Daten nicht mehr in deinem Rechenzentrum eingeschlossen sind.

Bereit loszulegen?

Kolva in Aktion sehen

Verbinde dein ERP, synchronisiere dein Team und erhalte im ERP verankerte Entscheidungssignale. Keine Kreditkarte für die 21-tägige Testphase erforderlich.