Sage X3: 4. Gateway einrichten
Voraussetzungen
Die Verbindung zwischen checkITeasy und Sage X3 stellt ein eigener Dienst her, das Sage X3 Gateway. Er läuft auf einem Server Ihrer Umgebung und gleicht die Daten in beide Richtungen ab. Eingerichtet wird er über eine kleine Web-Oberfläche direkt auf diesem Server. Welche Datenbereiche wandern und wie die Felder zueinander passen, pflegen Sie dagegen wie gewohnt in der checkITeasy-Administration.
Die Oberfläche im Überblick
Die Status-Karte
| Feld | Bedeutung |
|---|---|
| checkITeasy API | Grün, wenn der API-Key gültig ist. Daneben steht der Name Ihres Mandanten. |
| Sage X3 API | Grün, wenn Sage X3 erreichbar ist und die Anmeldung klappt. Daneben steht der X3-Ordner. Schlägt die Prüfung fehl, erscheint die Ursache im Klartext unter der Zeile. |
| Synchronisation | Zeigt, ob der Abgleich eingeschaltet ist und in welchem Abstand er läuft. |
| Letzter Lauf | Zeitpunkt und Ergebnis des letzten Abgleichs. |
Zugänge hinterlegen
Tragen Sie in der Karte „checkITeasy" die API-URL Ihrer checkITeasy-Umgebung und den API-Key ein.
Tragen Sie in der Karte „Sage X3" die Adresse Ihres Syracuse-Servers ein, dazu den technischen X3-Benutzer mit Passwort und den X3-Ordner im Feld „Endpoint (Folder)".
Die Sage-X3-Karte. Der „Zugriffsweg" steht hier auf „SOAP (klassisch)", darunter der „SOAP-Pool-Alias" aus Sage X3. Wählen Sie den „Zugriffsweg". Nutzen Sie „GraphQL (Sage X3 Services)", wenn Ihre X3-Installation die Komponente Sage X3 Services hat. Sonst wählen Sie „SOAP (klassisch)" und tragen den Pool-Namen im Feld „SOAP-Pool-Alias" ein.
Klicken Sie in der Karte „Dienst" auf „Speichern".
Klicken Sie oben auf „Verbindungen prüfen". Beide API-Punkte werden grün.
So sieht die geprüfte Verbindung aus. Beide APIs sind grün, die Synchronisation ist hier noch ausgeschaltet.
Den Abgleich einschalten
Setzen Sie in der Karte „Dienst" den Haken „Synchronisation aktiv".
Die Dienst-Karte. Das „Intervall (Sekunden)" bestimmt die Pause zwischen zwei Abgleichen. Portänderungen wirken erst nach einem Neustart des Dienstes. Klicken Sie auf „Speichern". Der Abgleich startet mit dem nächsten Durchlauf.
Mit „Jetzt synchronisieren" stoßen Sie einen Durchlauf sofort an, ohne auf das Intervall zu warten.
Was der Sync überträgt
Der Abgleich holt den Bestand in wenigen großen Aufrufen aus Sage X3. Übertragen werden Kunden, Lieferanten, Adressen, Ansprechpartner, Artikel, Verkaufsaufträge und Rechnungen. Dazu kommen die Verzeichnisse für Belegarten, Kostenstellen, Kostenträger, Vertreter, Mengeneinheiten und Artikelgruppen.