Integrationen / ERP / Sage 200
Sage 200 Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS
Dieser Leitfaden zur Sage 200 Schnittstelle zeigt Vertriebspartnern und IT-Teams, wie sie Sage 200 Professional und das zugehörige Fertigungs-Add-on mit SkyPlanner APS verbinden. Die Schnittstelle zwischen SkyPlanner und Sage 200 überträgt Daten in beide Richtungen:
- Produkte, Lagerbestände, Bestellungen und Kundenaufträge werden über die Sage 200 REST API eingelesen.
- Fertigungsaufträge, Arbeitsgänge sowie Personal- und Maschinenressourcen werden aus Ihrem Fertigungs-Add-on eingelesen.
- Geplante Arbeitsgangtermine werden in die Fertigungsaufträge zurückgeschrieben.
- Die erfassten Zeiten der Bediener werden zur Zeitbuchung auf den jeweiligen Arbeitsgang zurückgemeldet.
Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding passend zu Ihrer Sage 200-Installation ein und betreut sie nach dem Produktivstart weiter. Dieser Leitfaden richtet sich an Partner und Entwickler, die dabei mitwirken oder selbst auf Basis der dokumentierten REST API von SkyPlanner entwickeln möchten (API-Referenz).
Zwei Datenquellen in einem Sage 200-System
Eine Sage 200-Installation in einem Fertigungsbetrieb besteht aus zwei Ebenen. Die Schnittstelle liest Daten aus beiden.
1. Die Sage 200 REST API für kaufmännische Daten und Bestandsdaten. Laut Sage gilt für die API: „lets your application read and modify data in a Sage 200 site“ (ermöglicht Ihrer Anwendung, Daten in einer solchen Installation zu lesen und zu ändern). Dazu gehören Kunden, Lieferanten, Produkte, Kundenaufträge, Bestellungen und Sachkonten. Die Referenz zu Sage 200 Professional (2025.02) gliedert die Ressourcen in Cash Book, Commercials, Financials, General, Nominal, POP, Price Book, Purchases, Sales, SOP und Stock. Für die Feinplanung sind folgende Ressourcen relevant:
| Ressource | Enthaltene Daten |
|---|---|
products | Code, Name, Lagereinheit, BOM-Positionstyp, Standardkosten |
warehouse_holdings | quantity_in_stock, quantity_on_order, quantity_allocated_bom, free_stock_available, is_default_manufacturing_warehouse |
pop_orders, pop_order_lines | Offene Bestellungen, line_quantity, requested_delivery_dates |
sop_orders, sop_order_lines | Kundenbedarf, requested_delivery_date, promised_delivery_date |
warehouses, units | Standorte und Maßeinheiten |
2. Das Fertigungs-Add-on für Fertigungsaufträge. Die Sage 200 API bietet keine Endpunkte für Fertigungsaufträge, Arbeitsgänge oder Ressourcen. Fertigungsaufträge werden in Sicon Works Order Processing, Cim200 oder im älteren Modul Sage 200 Manufacturing geführt. Die Schnittstelle liest Fertigungsaufträge, Arbeitsgänge und Ressourcen über einen vom Add-on unterstützten Zugriffsweg. Diesen stimmen wir bei der Anforderungsaufnahme mit Ihnen und Ihrem Sage 200-Partner ab.
Authentifizierung und Zugriff
Für die Sage 200 API gilt: „uses OAuth 2.0 with OpenID Connect“ (verwendet diese OAuth-Version mit OpenID Connect). Dabei kommt der Authorization Code Grant Flow zum Einsatz. Die Anmeldung erfolgt über Sage ID.
- Nehmen Sie am Sage 200 API Developer Programme teil und fordern Sie Zugangsdaten an.
- Ordnen Sie eine Sage ID einem Sage 200-Benutzer zu, der für die genutzten Endpunkte die nötigen Mandanten- und Funktionsberechtigungen besitzt.
- Fordern Sie den Scope
offline_accessan. Andernfalls wird kein Refresh-Token ausgestellt. - Senden Sie bei jeder Datenbankanfrage
Authorization: Bearer <access_token>,X-SiteundX-Companymit. Beide IDs erhalten Sie über/sites.
Basis-URL für Sage 200 Professional: https://api.columbus.sage.com/uk/sage200extra/accounts/v1. Für Anfragen stehen GET, POST, PUT und DELETE sowie die OData-Abfrageoptionen $filter, $select, $top, $skip, $orderby und $expand zur Verfügung.
Bei Sage 200 Professional aktiviert der Supportdienstleister des Kunden die API. In der Checkliste von Sage bestätigt er „the API is enabled“ (die API ist aktiviert) und „each required user has a Sage ID assigned.“ (jedem benötigten Benutzer ist eine Sage ID zugeordnet). Bei Sage 200 Standard ist die API standardmäßig aktiviert.
Die Gültigkeitsdauer der Tokens bestimmt die technische Auslegung mit. Access-Tokens sind 8 Stunden gültig, Refresh-Tokens zwischen 1 und 90 Tagen. Dabei gilt: „The refresh window is measured from the user’s initial sign-in, not from the most recent refresh.“ (Das Zeitfenster für die Erneuerung wird ab der ersten Anmeldung des Benutzers gemessen, nicht ab der letzten Erneuerung.) Laut Sage gilt für die erneute Authentifizierung: „is unavoidable“ (ist unvermeidbar). Planen Sie vor Ablauf des Zeitfensters eine Benachrichtigung ein, die zur erneuten Zustimmung auffordert.
Auf SkyPlanner-Seite erfolgt die Authentifizierung an der REST API mit einem API-Token (SkyPlanner Settings > API). Die API ist in Swagger/OpenAPI dokumentiert. Das Integrationstutorial führt Sie durch die ersten Aufrufe.
Änderungen erkennen
Die Referenz der Sage 200 API enthält keine Ressource für Webhooks oder Subscriptions. Änderungen werden per Polling erfasst. Datensätze enthalten date_time_created und date_time_updated. Deshalb filtert jede Abfrage mit $filter nach date_time_updated und ruft die Ergebnisse mit $top und $skip seitenweise ab.
Fragen Sie Fertigungsaufträge alle paar Minuten ab, Bestände und Bestellpositionen stündlich. SkyPlanner sendet Webhooks, wenn sich der Plan ändert. Das Zurückschreiben erfolgt daher ereignisgesteuert.
Datenzuordnung
| Sage 200-Objekt (Quelle) | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
products, units (API) | Produkte und Materialien | Sage 200 → SkyPlanner | Erstimport, danach Polling |
| Stücklistenkomponenten (Add-on oder BOM-Modul) | Produktstruktur, Unterprodukte, Materialien je Produkt | Sage 200 → SkyPlanner | Bei Änderungen |
| Personal- und Maschinenressourcen, Ressourcengruppen (Add-on) | Arbeitsstationen, Arbeitsstationsgruppen, Personal | Sage 200 → SkyPlanner | Erstimport |
| Ressourcenverfügbarkeit: Stillstand, Wartung, Urlaub (Add-on) | Schichten, Abwesenheiten | Sage 200 → SkyPlanner | Täglich |
| Fertigungsaufträge mit Arbeitsgängen und Zeiten je Arbeitsgang (Add-on) | Aufträge und Arbeitsgänge mit Schritten, Dauern und Fälligkeitsterminen | Sage 200 → SkyPlanner | Alle paar Minuten |
sop_order_lines: requested_delivery_date, promised_delivery_date (API) | Kundenliefertermine | Sage 200 → SkyPlanner | Polling |
warehouse_holdings: quantity_in_stock, free_stock_available (API) | Lagerbestände | Sage 200 → SkyPlanner | Stündlich |
pop_order_lines: line_quantity, requested_delivery_dates (API) | Bestellungen mit erwartetem Liefertermin | Sage 200 → SkyPlanner | Stündlich |
| Geplanter Beginn, geplantes Ende und Ressource des Arbeitsgangs im Fertigungsauftrag | Geplanter Beginn, geplantes Ende und Arbeitsstation je Arbeitsgang | SkyPlanner → Sage 200 | Bei Änderungen, per Webhook |
| Zeitbuchung auf den Arbeitsgang (Add-on) | Zeiterfassungen und Bedienerrückmeldungen | SkyPlanner → Sage 200 | Je Rückmeldung oder Schicht |
| Daten zu Planungsrestriktionen in SkyPlanner | Rüstzeitmatrix, Werkzeuge als begrenzt verfügbare Ressourcen, alternative Maschinen und Personal | Pflege in SkyPlanner | Beim Onboarding |
Integrationsabläufe
1. Stammdaten erstmals importieren. Lesen Sie Produkte und Einheiten aus der API ein, danach Ressourcen, Ressourcengruppen und Stücklistenarbeitsgänge aus dem Add-on. Eine Ressourcengruppe aus drei identischen Maschinen lässt sich als eine Arbeitsstationsgruppe oder als drei Arbeitsstationen abbilden.
2. Aufträge synchronisieren. Lesen Sie offene Fertigungsaufträge samt Arbeitsgängen aus dem Add-on ein, dazu offene pop_order_lines und warehouse_holdings aus der API. Die Feinplanung prüft sowohl den Bestand als auch erwartete Zugänge aus Bestellungen. MRP schlägt weiterhin Fertigungsaufträge in Sage 200 vor. SkyPlanner plant die Aufträge ein, die Sie anlegen.
3. Planungsergebnisse zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, schreibt SkyPlanner den geplanten Beginn, das geplante Ende und die Ressource in den Fertigungsauftrag zurück. Mengen, Reservierungen und Kalkulation bleiben im Add-on.
4. Rückmeldungen vom Shopfloor. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Die Zeiterfassungen halten den Plan aktuell. Die erfasste Zeit wird auf den Arbeitsgang des Fertigungsauftrags zurückgebucht. Damit stehen der Kalkulation in Sage 200 die Iststunden zur Verfügung.
Wenn Ihr Werk bereits Zeiten in Sicon Shop Floor Data Capture oder Cim200 Shop Floor Data Capture bucht, legen Sie sich auf einen Buchungskanal fest.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Produkte, Stücklisten, Fertigungsauftragsmengen, Reservierungen, Kosten | Sage 200 und das Add-on |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Zuordnung zu Arbeitsstationen | SkyPlanner |
| Rüstzeitmatrix, Werkzeug- und Personalbedarf, alternative Ressourcen | SkyPlanner |
| Zeitbuchung | Sage 200, gespeist aus den Zeitaufzeichnungen von SkyPlanner |
Die häufigste Konfliktquelle ist die Kapazitätsübersicht. Wenn Planer weiterhin Fertigungsaufträge oder Arbeitsgänge in Sicon Rough Cut Capacity Planning oder im Cim200 Graphical Scheduler verschieben, bestimmen zwei Systeme die Termine. Legen Sie SkyPlanner als führendes System für die Arbeitsgangtermine fest. Mit Autopilot plant SkyPlanner automatisch neu, wenn sich in der Produktion etwas ändert.
Typischer Projektablauf
Die Implementierung ist in der Regel innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie den Produktionsplan vorab in der kostenlosen 30-tägigen Testphase anhand eines CSV- oder Excel-Exports Ihrer offenen Fertigungsaufträge. Anschließend läuft das Projekt wie folgt ab:
- Anforderungsaufnahme. Klären Sie das eingesetzte Add-on samt Version, die Wege zum Auslesen der Fertigungsaufträge und zum Zurückschreiben der Daten, die Synchronisierungsintervalle sowie den Kanal für die Zeitbuchung.
- API-Zugriff. Der Supportanbieter aktiviert die Sage 200 API, ordnet eine Sage ID einem Sage 200-Benutzer zu und richtet die Mandanten- und Funktionsberechtigungen ein.
- Erstimport. Produkte, Einheiten, Ressourcen, Ressourcengruppen, Stücklistenarbeitsgänge und Verfügbarkeiten werden übernommen.
- Auftragssynchronisierung. Fertigungsaufträge, Bestellpositionen und Bestände werden per Polling abgefragt. Dazu gehört die Warnmeldung, wenn eine erneute Zustimmung erforderlich ist.
- Planungsbedingungen in SkyPlanner einrichten. Dazu zählen Rüstzeitmatrix, Werkzeuge, die Anzahl benötigter Mitarbeiter je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter.
- Plandaten zurückschreiben. Die geplanten Arbeitsgangtermine werden in die Fertigungsaufträge zurückgeschrieben. In diesem Schritt wird auch die Zeitbuchung angebunden.
- Paralleltest und Go-live. Vergleichen Sie die Termine mit dem aktuellen Plan, korrigieren Sie die Stammdaten und aktivieren Sie anschließend das Zurückschreiben.
Was Sie bei einer Sage 200-Integration berücksichtigen sollten
- Abgekündigtes Modul in einer neuen Version. Das bisherige Modul Sage 200 Manufacturing kann ab Sage 200 Professional 2025 R2 nicht mehr verwendet werden. Klären Sie vor jeder Datenzuordnung, welche Fertigungslösung zum Go-live im Einsatz sein wird.
- Arbeitsgangzeiten aus Kostendaten. Sicon MRP schätzt Personal- und Maschinenzeiten anhand der Kostenpositionen in den Stücklisten von Sage 200. Gleichen Sie diese zuerst mit den tatsächlichen Bearbeitungszeiten ab.
- Abweichende Kostenkategorien. Sage weist darauf hin, dass Nominal, Overhead Nominal und Overhead Recovery % in Stücklistenarbeitsgängen und Kostenkategorien übereinstimmen müssen. Andernfalls gilt: „there will be cost discrepancies.“ (Es kommt zu Kostenabweichungen.)
- Frist für die Erneuerung. Die Höchstdauer von 90 Tagen beginnt mit der ersten Anmeldung. Wird die Zustimmung für die Integration nie erneuert, stoppt sie jedes Quartal am selben Tag.
- Mehrere Unternehmen auf einer Site. Eine Site kann mehrere Unternehmen enthalten. Senden Sie deshalb bei jeder Anfrage den richtigen Wert für
X-Company.
Wer die Sage 200 Schnittstelle einrichtet und betreut
- Das SkyPlanner-Team richtet die Schnittstelle während des Onboardings ein und betreut sie nach dem Go-live.
- Ihr Sage 200-Partner kann mitwirken. Er kennt Ihr Add-on und aktiviert die API in Sage 200 Professional.
- Auch Ihre eigenen Entwickler können darauf aufbauen. Dafür nutzen sie dieselbe dokumentierte REST API mit einem API-Token. Ein API-Token genügt für den Einstieg. Bei Bedarf unterstützt das SkyPlanner-Team.
Nach der Anbindung plant die Arcturus-Engine anhand der aktuellen Fertigungsaufträge aus Sage 200. Die geplanten Termine werden in die Arbeitsgänge der Fertigungsaufträge übertragen. SkyPlanner ist ab 199 € pro Monat erhältlich, einschließlich 5 Arbeitsstationen und bei monatlicher Abrechnung. Sie erhalten vorab ein auf Ihre Abläufe und Anforderungen abgestimmtes Angebot für die Integration zusammen mit Ihrem Tarif. So kennen Sie die Gesamtkosten, bevor Sie starten. Informieren Sie sich über Preise und Funktionen. Wie die eigene Planung von Sage 200 im Vergleich abschneidet, erfahren Sie unter Feinplanung mit Sage 200. Den Überblick finden Sie auf der Sage 200-Seite, weitere ERP-Systeme in der Übersicht der ERP-Schnittstellen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
2 hjede Woche eingespart
„Mit SkyPlanner haben wir den Schritt von Excel-Tabellen in der Produktionsplanung zur Produktionsoptimierung in Echtzeit geschafft.“
Kalle Kalliomäki, Spezialist für Lieferketten
UTU · Elektrische Schalttafeln und Schaltanlagen
Die Produktionsplanung spart jede Woche 2 Stunden Arbeitszeit ein. Eine neue Auftragsreihenfolge erreicht die Fertigungslinie innerhalb von Sekunden.
Mehrere 1.000Fertigungsaufträge automatisch eingeplant
„Wir haben die Produktion ganz anders im Griff, und unser Verständnis der Kapazitäten ist auf einem völlig anderen Niveau.“
Hannu Ryynänen, Geschäftsführer
Mamec · Industriemischer, Pumpen und Hightech-Auftragsfertigung
Tausende Fertigungsaufträge werden automatisch eingeplant. Das gesamte Unternehmen hat dabei in Echtzeit Einblick in die Produktion.
Häufige Fragen
Umfasst die Sage 200 API auch Fertigungsaufträge?
Nein. Die Sage 200 Professional API deckt unter anderem Produkte, Bestände, Verkaufsaufträge, Bestellungen und Finanzen ab, bietet aber keine API-Ressourcen für Fertigungsaufträge oder Arbeitsgänge. Die Fertigungsaufträge stammen aus Ihrem Fertigungs-Add-on, etwa Sicon Works Order Processing oder Cim200. Sie werden über den bei der Anforderungsaufnahme vereinbarten Weg ausgelesen.
Wer richtet die Sage 200 Schnittstelle ein?
Das SkyPlanner-Team richtet die bidirektionale Schnittstelle während des Onboardings passend zu Ihrer Sage 200-Umgebung ein und betreut sie nach dem Go-live. Ihr Sage 200-Partner aktiviert die API und kann am Projekt mitwirken. Auch Ihre eigenen Entwickler können auf der dokumentierten REST API von SkyPlanner aufbauen. Ein API-Token genügt für den Einstieg.
Kann Sage 200 Änderungen in Echtzeit übertragen?
Die Sage 200 API bietet keine Webhooks. Bestände und Bestellungen werden anhand von date_time_updated per Polling abgefragt. Fertigungsaufträge werden alle paar Minuten aus Ihrem Add-on ausgelesen. In der Gegenrichtung übertragen die eigenen Webhooks von SkyPlanner Planänderungen, sobald sie auftreten.
Können wir SkyPlanner testen, bevor die Schnittstelle eingerichtet wird?
Ja. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen nutzen und Ihre Fertigungsaufträge per CSV oder Excel importieren. Eine Kreditkarte ist nicht erforderlich. Starten Sie die Testphase oder sprechen Sie mit dem Vertrieb, um die Anforderungen an die Schnittstelle zu klären.
