Sylob ERP: Leitfaden zur Integration für die Feinplanung mit SkyPlanner APS

Sylob dokumentiert zwei öffentliche REST APIs: „L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \“webservices\“) qui autorise la lecture et l’écriture de données.“ (Sylob ERP stellt zwei Arten öffentlicher REST APIs, auch „Webservices“ genannt, zum Lesen und Schreiben von Daten bereit.) (Forterro-Wissensdatenbank)

1. API REST Système d’information (Lesen). Sie führt eine gespeicherte Abfrage (requête) aus, die in der Aktivität „Interroger le système d’information“ erstellt wurde. Die Aufruf-URL der jeweiligen Abfrage finden Sie unter „Autres actions“ > „Afficher le web service“. Sie hat das Format /rest/query/{identifiantQuery}/resultat. Parameter legen die maximale Anzahl der Ergebnisse, das Zahlenformat, die Abfragevariablen und die Ergebnisstruktur fest. Standardmäßig werden die Ergebnisse als XML zurückgegeben, mit dem Header Accept: application/json als JSON. Diese API ist im ERP enthalten.
2. API REST Action (Lesen und Schreiben). Sie führt eine Aktion aus, die in der Aktivität „Gérer les actions web service“, dem Aktionskatalog von Sylob, definiert ist. Dafür stehen zwei Operationen bereit: GET /rest/v2/action/{code}/describe liefert das Datenschema einer Aktion, und POST /rest/v2/action/{code}/execute führt sie mit einem JSON-Body aus. Zu den Aktionstypen gehören:

– Modification de données: Ändert ein oder mehrere Felder eines Datensatzes über die Schnellbearbeitung von Sylob. Describe listet die bearbeitbaren Felder auf. – Message EDI: Erstellt, ändert oder löscht Datensätze über eine EDI-Nachricht. – Scénario de saisie: Führt ein Eingabeszenario Frage für Frage aus. Sylob nennt als eigenes Beispiel „Déclarer un début ou une fin“, mit dem der Beginn oder das Ende eines Arbeitsgangs gemeldet wird (Sylob_Action_006). – Veröffentlichen, Hochladen und Herunterladen von Dokumenten.

1. EDI-Nachrichten. Die EDI-Engine von Sylob übernimmt Exporte und Importe. Die Standardnachricht Sylob_Recup_Decl_Pro ruft Produktionsmeldungen ab. (Forterro)
2. Dateien und ETL. Sylob ERP Cloud bietet „Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.“ (Dateiintegration über SFTP zur einfachen Migration bestehender Integrationen.) (Sylob) Abfrageergebnisse lassen sich auch nach Excel exportieren – ein schneller Weg, um SkyPlanner zu testen.

Die öffentliche Wissensdatenbank von Sylob dokumentiert keine Möglichkeit, ausgehende Webhooks zu abonnieren. Änderungen gelangen durch regelmäßiges Ausführen gespeicherter Abfragen zu SkyPlanner. Diese filtern nach offenen OFs und aktuellen Änderungen; den Zeitplan dafür legen Sie fest.

Sylob schützt das ERP vor einer zu hohen Abfragelast. Seit Release 2025.Q2 aktiviert der Unternehmensparameter „Protection des API“ eine Drosselung je Benutzer sowie die seitenweise Ausgabe großer Ergebnismengen. Ab Release 2026.Q2 kündigt Sylob dies als Standard an. Die Antworten enthalten RateLimit-Header. Überschreitet ein Aufruf das Kontingent, wird HTTP 429 Too Many Requests mit einem Retry-After-Wert zurückgegeben. (Forterro) Berücksichtigen Sie dies bei der Synchronisierung: mit inkrementellen Abfragen, seitenweisem Abruf und Wartezeiten bei 429.

In der Gegenrichtung sendet SkyPlanner bei Status- oder Planänderungen Webhooks. Das Zurückschreiben nach Sylob erfolgt somit ereignisgesteuert.

1. Erstimport der Stammdaten. Erstellen Sie je Objekt (Artikel, Stücklisten, Arbeitspläne, Arbeitsstationen, Mitarbeiter) eine gespeicherte Abfrage und lesen Sie die Daten über die Système d’information API ein. Alternativ importieren Sie sie einmalig aus einem Excel-Export. Achten Sie auf die passende Zuordnung der Arbeitsstationen. Ein centre de charge in Sylob ist eine Ressourcengruppe. Ein solcher Bereich mit drei Maschinen wird daher in SkyPlanner üblicherweise als Arbeitsstationsgruppe mit drei Arbeitsstationen abgebildet.

2. Auftragssynchronisierung. Lesen Sie fixierte OFs mit ihren Arbeitsgängen sowie Bestände und offene Bestellungen ein. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert wird. Die Planung berücksichtigt somit sowohl Lagerbestände als auch erwartete Wareneingänge.

Planen Sie fixierte OFs ein, keine CBN-Vorschläge. Die Vorschläge ändern sich beim nächsten Nettobedarfslauf.

3. Planungsdaten zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, ruft die Schnittstelle eine Aktion vom Typ Modification de données für den OF-Arbeitsgang (Opération d’ordre de fabrication) auf. Dabei übergibt sie den geplanten Beginn, das geplante Ende und die Arbeitsstation. Die Aktion nutzt die Schnellbearbeitungslogik von Sylob – genau wie bei der manuellen Bearbeitung durch einen Planer. Describe liefert die bearbeitbaren Felder, sodass die Schnittstelle ihre Nutzdaten vor dem ersten Aufruf validiert. Wird ein Datensatz gerade von einem Benutzer bearbeitet, schlägt der Aufruf erwartungsgemäß fehl. Wiederholen Sie ihn bei der nächsten Änderung.

4. Rückmeldungen aus der Fertigung. Werker erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Beginn und Ende werden über das Szenario „Déclarer un début ou une fin“ zurückgemeldet. Zeiterfassungen und Mengen werden als Produktionsmeldungen für denselben OF-Arbeitsgang übermittelt: Rüstzeit, Bearbeitungszeit, produzierte Menge, Ausschuss und Abschluss des Arbeitsgangs. Wenn Ihr Werk bereits über Sylob Apps oder Fertigungsterminals zurückmeldet, nutzen Sie nur einen Meldekanal, um Doppelerfassungen zu vermeiden.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:

SkyPlanner benötigt weder CADPLAN noch die Feinplanungsfunktionen von Sylob. Überlassen Sie SkyPlanner die Hoheit über die Arbeitsgangtermine. Wenn zwei Planungssysteme dieselben Termine schreiben, überschreiben sie sich gegenseitig. Sobald SkyPlanner die Termine führt, plant Autopilot bei jeder relevanten Änderung automatisch neu und überträgt die neuen Termine zurück an Sylob.

• Lizenz für die Action API. Das Lesen über gespeicherte Abfragen ist enthalten. Für das Schreiben über den Aktionskatalog benötigen Sie das Sylob-Modul „Webservice“ oder eine API-Lizenz auf MyForterro. Klären Sie dies mit Ihrem Sylob-Ansprechpartner, bevor Sie das Zurückschreiben umsetzen.
• Abfragen definieren den Schnittstellenvertrag. Der Lesezugriff beruht auf gespeicherten Abfragen. Benennen Sie diese eindeutig, übergeben Sie Filter zur Laufzeit als variable Attribute und versionieren Sie die Abfragen zusammen mit der Integration.
• Gruppen von Arbeitsstationen. Eine Arbeitsstation in Sylob kann mehrere Maschinen umfassen. Legen Sie für jede fest, ob sie in SkyPlanner als Gruppe von Arbeitsstationen oder als einzelne Maschinen abgebildet wird.
• Rückwärtsterminierung und Belastungsrechnung. Sylob plant rückwärts vom Bedarfstermin aus. Eine zeitgesteuerte Belastungsrechnung kann verspätete OFs neu einplanen. Vereinbaren Sie, ob und welche Funktion weiterhin Arbeitsgangtermine schreiben darf, sobald SkyPlanner die Hoheit darüber hat.
• Einheiten für Rüst- und Laufzeiten. Prüfen Sie vor dem Import die Einheiten und ob die Rüstzeit je OF oder je Stück gilt. Falsche Einheiten verfälschen jede Dauer.
• Kalender. Wochenmuster und Ausnahmen der Arbeitsstationen müssen den gesamten Planungshorizont abdecken. Andernfalls fehlen Kapazitäten im Plan.
• Aufrufbegrenzung. Sylob begrenzt die Aufrufe pro Benutzer und teilt große Ergebnismengen in Seiten auf. Inkrementelles Polling bleibt deutlich unter dem Limit.
• CORS und Browser. Bei Server-zu-Server-Aufrufen greift CORS nicht. Für Browser-Clients müssen auf der Sylob-Seite die zulässigen Origins konfiguriert werden.