Integrationen / ERP / Sage 100
Sage 100 Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS
Dieser Leitfaden zur Sage 100 Schnittstelle zeigt Sage-Partnern und IT-Teams, wie sie Sage 100 mit SkyPlanner APS verbinden. Er behandelt beide Produkte dieses Namens: Sage 100 in den USA und Kanada mit Production Management sowie Sage 100 in Deutschland und Österreich mit Sage 100 Produktion. Die Schnittstelle zwischen SkyPlanner und Sage 100 arbeitet in beide Richtungen:
- Work tickets bzw. Fertigungsaufträge werden mit ihren Schritten bzw. Arbeitsgängen übernommen, dazu Arbeitsstationen, Artikel, Lagerbestände und Bestellungen.
- Die geplanten Termine werden je Schritt bzw. Arbeitsgang zurückgeschrieben.
- Die von den Mitarbeitern erfassten Zeiten werden als Arbeitszeitbuchungen (US) bzw. Rückmeldungen (DE) zurückgeschrieben.
Das SkyPlanner-Team richtet die Schnittstelle beim Onboarding passend zu Ihrer Sage 100-Installation ein und betreut sie auch nach dem Produktivstart. Dieser Leitfaden richtet sich an Partner und Entwickler, die daran mitwirken oder selbst auf Basis der dokumentierten REST API von SkyPlanner entwickeln möchten (API-Referenz).
Sage 100 (US): Schnittstellen für die Integration
Die US-Version von Sage 100 wird lokal in den Varianten Standard, Advanced oder Premium betrieben. Die Schnittstellen für die Integration befinden sich auf dem Sage 100-Server.
Business Object Interface (BOI).
„The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).“ (Das Business Objects Interface ermöglicht entsprechend qualifizierten Drittentwicklern den Zugriff auf die Programme und Anwendungen über das Component Object Model (COM).) (Sage 100-Hilfe) Im Entwicklerportal beschreibt Sage es als „Sage 100’s internal API layer, giving you access to the same logic used by the application itself.“ (Die interne API-Schicht des Systems, die Zugriff auf dieselbe Logik bietet, die auch die Anwendung selbst verwendet.) (developer.sage.com) Schreibzugriffe erfolgen über BOI: Beim Anlegen oder Ändern von Daten greifen dieselben Prüfungen wie bei der Eingabe durch einen Benutzer in Sage 100.
ODBC.
Der ProvideX ODBC-Treiber liest Tabellen aus Sage 100 für Berichte und Massendatenabfragen. Für Advanced steht ein Client/Server-ODBC-Treiber zur Verfügung. Die Schnittstelle liest Work tickets, Artikel und Bestellungen gesammelt über ODBC und schreibt über BOI.
Visual Integrator (VI).
Import- und Exportaufträge in VI übertragen Daten zwischen Sage 100 und Dateien oder ODBC-Quellen. Sage beschreibt dies so: „One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.“ (Eine der leistungsfähigsten Funktionen des Moduls Visual Integrator ist der direkte Import aus und Export in eine ODBC-Datenquelle.) (Quelle) VI gehört zum Essentials-Paket und eignet sich für den dateibasierten Datenaustausch.
eBusiness Web Services basiert auf SOAP und deckt „the Sage 100 sales order, customer, and customer contact entities.“ (die Entitäten für Kundenaufträge, Kunden und Kundenkontakte) ab. (Quelle) Darüber lassen sich Kundenaufträge übertragen; Produktionsdaten werden über BOI und ODBC ausgetauscht.
Die Integration läuft neben Sage 100 unter einem Sage 100-Benutzer. Dieser benötigt Berechtigungen für die verwendeten Aufgaben in Production Management, Inventory und Purchase Order. Ausgehende Verbindungen zur REST API von SkyPlanner erfolgen über HTTPS.
Sage 100 (DE): Schnittstellen für die Integration
Die deutsche Version von Sage 100 läuft auf Microsoft SQL Server, lokal installiert oder als Cloud-Variante. Laut Sage können Sie „Partnerlösungen via API-Schnittstelle ergänzen“ (Sage 100). Die von Sage gelisteten Erweiterungen für die Produktion bauen auf dem Sage AppDesigner und den Geschäftsobjekten von Sage 100 auf.
Die Integration nutzt denselben Weg wie die Partnerlösungen von Sage: Fertigungsaufträge, Arbeitsgänge, Arbeitsplätze, Ressourcenlisten, Artikel und Bestellungen werden aus der SQL Server-Datenbank von Sage 100 gelesen. Arbeitsgang-Termine und Rückmeldungen werden über den Schreibzugriff zurückübertragen, den Ihr Sage-Partner und das SkyPlanner-Team bei der Anforderungsaufnahme festlegen. So folgen die Buchungen der eigenen Logik von Sage 100. Ihr Sage-Partner bestätigt die Version (zum Beispiel 9.0) und die Einrichtung der Zugriffe.
Authentifizierung und Zugriff
| System | Authentifizierung |
|---|---|
| Sage 100 (US), BOI | Sitzung eines Sage 100-Benutzers auf dem Sage 100-Server mit rollenbasierten Berechtigungen für jede verwendete Aufgabe |
| Sage 100 (US), ODBC | DSN auf der Sage 100-Installation, Lesezugriff |
| Sage 100 (DE) | Sage 100-Benutzer für das Zurückschreiben und Lesezugriff auf SQL Server, abgestimmt mit Ihrem Sage-Partner |
| SkyPlanner | API-Token im Header Authorization-Token, erstellt in SkyPlanner unter Einstellungen > API |
Die REST API von SkyPlanner ist in Swagger/OpenAPI dokumentiert. Das Integrationstutorial führt Sie durch die ersten Aufrufe.
Änderungen erkennen
Änderungen in Sage 100 werden durch regelmäßige Leseabfragen erfasst. Lesen Sie offene Work tickets bzw. Fertigungsaufträge in kurzen Abständen aus, Lagerbestände und Bestellungen stündlich. Filtern Sie nach Status und Änderungsdatum, damit jede Abfrage nur geänderte Daten überträgt.
SkyPlanner sendet bei Planänderungen Webhooks. Das Zurückschreiben nach Sage 100 erfolgt somit ereignisgesteuert.
Datenzuordnung
| Sage 100 (US) | Sage 100 (DE) | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|---|
| Item | Artikel | Produkte und Materialien | Sage 100 → SkyPlanner | Erstimport, danach täglich |
| Bill of Materials, Materialien der Vorlage | Stückliste in der Ressourcenliste | Produktstruktur, Unterprodukte, Materialien je Produkt | Sage 100 → SkyPlanner | Bei Änderungen |
| Work center: Mitarbeiter oder Maschinen, Stunden je Wochentag, Schließzeiten | Arbeitsplatz, Ressource (Mitarbeiter, Maschine) | Arbeitsstationen, Arbeitsstationsgruppen, Personal, Schichten | Sage 100 → SkyPlanner | Erstimport |
| Schritte der Work ticket-Vorlage, Tätigkeitscodes | Arbeitsplan, Arbeitsgänge mit Rüst- und Stückzeiten | Prozessschritte mit Rüst- und Bearbeitungszeiten | Sage 100 → SkyPlanner | Bei Änderungen |
| Work ticket mit Schritten und Fälligkeitstermin | Fertigungsauftrag mit Arbeitsgängen und Liefertermin | Aufträge und Arbeitsgänge mit Fälligkeitsterminen | Sage 100 → SkyPlanner | Abfrage in kurzen Abständen |
| Bestandsmengen je Lager | Lagerbestand | Lagerbestände | Sage 100 → SkyPlanner | Stündlich |
| Bestellpositionen, Bedarfstermine | Bestellungen, Liefertermine | Bestellungen mit voraussichtlichem Liefertermin | Sage 100 → SkyPlanner | Stündlich |
| Kundenauftragspositionen, zugesagte Termine | Kundenaufträge | Kundentermine, Kundenpriorität | Sage 100 → SkyPlanner | Abfrage in kurzen Abständen |
| Termine der Work ticket-Schritte (BOI) | Arbeitsgang-Termine | Geplanter Start, geplantes Ende und Arbeitsstation je Schritt | SkyPlanner → Sage 100 | Bei Änderungen, per Webhook |
| Labor Entry, Abschluss des Work tickets (BOI) | Rückmeldung: Zeiten, Mengen | Zeiterfassungen und Mitarbeiterrückmeldungen | SkyPlanner → Sage 100 | Je Rückmeldung oder je Schicht |
| Nicht in Sage 100 geführt | Nicht in Sage 100 geführt | Rüstzeitmatrix, Werkzeuge als begrenzt verfügbare Ressourcen, Mitarbeiter je Arbeitsgang, alternative Arbeitsstationen | In SkyPlanner gepflegt | Einrichtung beim Onboarding |
Integrationsabläufe
1. Stammdaten erstmals laden. Laden Sie zuerst Artikel und Arbeitsstationen, danach Vorlagen bzw. Arbeitspläne mit ihren Schritten. Ein Work center der US-Version mit drei Maschinen und zwei Mitarbeitern wird in SkyPlanner als drei Arbeitsstationen, eine Arbeitsstationsgruppe und zwei Personen abgebildet. Alle Maschinen und Personen erhalten jeweils eine eigene Zeitleiste.
2. Aufträge synchronisieren. Lesen Sie offene Work tickets bzw. Fertigungsaufträge mit ihren Schritten sowie Lagerbestände und offene Bestellungen aus. SkyPlanner prüft sowohl die Bestände als auch die eingehenden Lieferungen, bevor ein Arbeitsgang eingeplant wird. Sage 100 schlägt weiterhin Fertigungsaufträge vor; SkyPlanner plant die von Ihnen freigegebenen Aufträge ein.
3. Planung zurückschreiben. Für jeden Schritt, den die Planungsengine eingeplant oder verschoben hat, sendet SkyPlanner den geplanten Start, das geplante Ende und die Arbeitsstation. In der US-Version von Sage 100 aktualisiert die Schnittstelle die Termine der Work ticket-Schritte über BOI. In der deutschen Version von Sage 100 aktualisiert sie die Arbeitsgang-Termine über den bei der Anforderungsaufnahme festgelegten Weg. Mengen, Zuordnungen und Kalkulation bleiben in Sage 100.
4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Diese Zeitbuchungen halten den Plan aktuell. In der US-Version von Sage 100 werden die erfassten Zeiten als Labor Entry auf den jeweiligen Schritt des Work Tickets gebucht; die letzte Rückmeldung schließt das Ticket ab. In der deutschen Version von Sage 100 entsteht daraus eine Rückmeldung mit Zeiten und Mengen. Wenn Ihr Betrieb Zeiten bereits über die Betriebsdatenerfassung oder eine Barcode-App bucht, legen Sie einen einzigen Buchungsweg fest.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Artikel, Stücklisten, Vorlagen, Auftragsmengen, Kosten | Sage 100 |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Zuordnung zu Arbeitsstationen | SkyPlanner |
| Rüstzeitmatrix, Werkzeuge, Bediener je Arbeitsgang, alternative Ressourcen | SkyPlanner |
| Arbeitszeiten und Rückmeldungen | Sage 100, versorgt mit Zeitbuchungen aus SkyPlanner |
Die häufigste Konfliktquelle ist ein zweites Planungssystem. Wenn Planer weiterhin Enhanced Scheduling in der US-Version von Sage 100 ausführen oder Vorgänge auf der Plantafel der deutschen Version von Sage 100 verschieben, bestimmen zwei Systeme die Termine. Überlassen Sie die Termine der Arbeitsgänge SkyPlanner. Mit Autopilot plant SkyPlanner automatisch neu, wenn sich in der Produktion etwas ändert.
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Prüfen Sie den Plan vorab in der kostenlosen 30-Tage-Testphase anhand eines CSV- oder Excel-Exports Ihrer offenen Work Tickets oder Fertigungsaufträge. Das Projekt läuft anschließend so ab:
- Anforderungsaufnahme. Klären Sie das Produkt (US- oder deutsche Version von Sage 100), die Version und Installation, die Wege für Lese- und Schreibzugriffe, die Synchronisierungsintervalle und den Weg für die Zeitbuchung.
- Zugriff. Ihr Sage-Partner richtet den Sage 100-Benutzer, dessen Rechte und den Datenbankzugriff ein.
- Erstimport. Artikel, Arbeitsstationen, Vorlagen oder Arbeitspläne, Stücklisten und Schichten werden geladen.
- Auftragssynchronisierung. Work Tickets oder Fertigungsaufträge, Bestellungen und Bestände werden in festgelegten Intervallen synchronisiert.
- Planungsbedingungen in SkyPlanner einrichten. Dazu gehören die Rüstzeitmatrix, Werkzeuge, die Anzahl der Bediener je Arbeitsgang sowie alternative Maschinen oder Mitarbeiter.
- Plan zurückschreiben. Zunächst werden die geplanten Termine der Arbeitsgänge an Sage 100 übertragen, anschließend Arbeitszeiten und Rückmeldungen.
- Parallel testen und produktiv starten. Vergleichen Sie die Termine mit dem aktuellen Plan, korrigieren Sie die Stammdaten und aktivieren Sie anschließend das Zurückschreiben.
Worauf Sie bei einer Sage 100-Integration achten sollten
- Klären Sie, welches Sage 100 Sie einsetzen. Die US- und die deutsche Version von Sage 100 haben unterschiedliche Datenmodelle und Schnittstellen. Nennen Sie Produkt und Version im ersten Gespräch zur Anforderungsaufnahme.
- Arbeitsstationen mit mehreren Maschinen. In der US-Version bildet ein Work Center eine Kapazitätseinheit aus „one or more persons or machines“ (einer oder mehreren Personen oder Maschinen). Entscheiden Sie für jedes Work Center, ob es als eine Arbeitsstation, mehrere Arbeitsstationen oder eine Gruppe abgebildet wird.
- Rüst- und Laufzeiten. Vorlagen und Arbeitspläne enthalten die Zeiten, mit denen SkyPlanner plant. Gleichen Sie diese vor dem Produktivstart mit den tatsächlichen Laufzeiten ab.
- Kalender. In den Work Centers der US-Version sind Arbeitsstunden je Wochentag und Schließzeiten hinterlegt. Übernehmen Sie diese als Schichten in SkyPlanner und ergänzen Sie dort anschließend die Schichten und Abwesenheiten jedes Bedieners.
- Maßeinheiten. Arbeitsgänge können je Stück, je Charge oder je Stunde abgebildet sein. Ordnen Sie jedem Arbeitsgang die passende Einheit zu.
- BOI-Rechte. BOI berücksichtigt die rollenbasierten Berechtigungen von Sage 100. Fehlt ein Aufgabenrecht, wird der Schreibzugriff blockiert. Testen Sie jeden Schreibzugriff mit dem Integrationsbenutzer.
- Ein führendes System für Termine. Unterbinden Sie parallele Planungsläufe und Verschiebungen auf der Plantafel, sobald SkyPlanner die Termine vorgibt.
Die Sage 100-Integration: Wer übernimmt Einrichtung und Support?
- Das SkyPlanner-Team richtet die Integration während des Onboardings ein und betreut sie nach dem Produktivstart.
- Ihr Sage-Partner kann mitwirken. Er kennt Ihre Sage 100-Version, richtet Benutzer und Rechte ein und bestätigt den Datenbankzugriff.
- Ihre eigenen Entwickler können darauf aufbauen und die dokumentierte REST API von SkyPlanner nutzen. Für den Einstieg genügt ein API-Token. Bei Bedarf unterstützt Sie das SkyPlanner-Team.
Sobald die Verbindung steht, plant die Arcturus-Engine anhand der aktuellen Aufträge aus Sage 100. Die geplanten Termine werden für jeden Arbeitsgang hinterlegt. SkyPlanner ist ab 199 € pro Monat erhältlich, inklusive 5 Arbeitsstationen und mit monatlicher Abrechnung. Sie erhalten vorab ein auf Ihre Abläufe und Anforderungen abgestimmtes Angebot für die Integration zusammen mit dem Angebot für Ihren Tarif. So kennen Sie die Gesamtkosten, bevor Sie starten. Informieren Sie sich über Preise und Funktionen. Wie die eigene Planung von Sage 100 im Vergleich abschneidet, lesen Sie unter Feinplanung mit Sage 100. Den Überblick finden Sie auf der Sage 100-Seite. Eigene Leitfäden für Sage 200 und Sage X3 sind über die Seiten zu Sage 200 und Sage X3 erreichbar. Weitere ERP-Systeme finden Sie in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
6 Monateim Voraus sieht der Vertrieb freie Kapazitäten
„SkyPlanner schafft eine verlässliche Grundlage für die gesamte Produktionsplanung.“
Anu Järvinen, Produktionsleiterin
Fredman Operations · Lebensmittelsichere Verpackungspapiere
Der Vertrieb sieht freie Kapazitäten sechs Monate im Voraus. Anfragen zu Planänderungen, deren Beantwortung früher eine Stunde oder länger dauerte, werden jetzt in Sekunden beantwortet.
100%Liefertreue seit 2021
„SkyPlanner macht unsere Kapazitäten sichtbar und die Planung vorhersehbar.“
Dan Berglund, COO/CFO
Opes Corporation · Chemie- und Lebensmittelproduktion
Seit der Einführung von SkyPlanner im Jahr 2021 liegt die Liefertreue durchgehend bei 100%.
Häufige Fragen
Bietet Sage 100 eine REST API für Work Tickets?
Die US-Version von Sage 100 stellt ihre Geschäftslogik über das Business Object Interface bereit. Für Lesezugriffe steht ODBC zur Verfügung, für dateibasierte Aufgaben Visual Integrator. SkyPlanner liest Work Tickets über ODBC und BOI und schreibt die Termine der Arbeitsgänge sowie Arbeitszeiten über BOI zurück. Die Daten der deutschen Version von Sage 100 werden aus deren SQL Server-Datenbank gelesen. Der Weg für das Zurückschreiben wird bei der Anforderungsaufnahme gemeinsam mit Ihrem Sage-Partner festgelegt.
Wer richtet die Sage 100-Integration ein?
Das SkyPlanner-Team richtet die bidirektionale Integration während des Onboardings passend zu Ihrer Sage 100-Installation ein und betreut sie nach dem Produktivstart. Ihr Sage-Partner richtet Benutzer, Rechte und Datenbankzugriff ein und kann am Projekt mitwirken. Auch Ihre eigenen Entwickler können auf der dokumentierten REST API von SkyPlanner aufbauen. Für den Einstieg genügt ein API-Token.
Wie werden geplante Termine an Sage 100 zurückgeschrieben?
In der US-Version von Sage 100 aktualisiert die Integration über BOI die geplanten Termine jedes Work-Ticket-Schritts und bucht Labor Entry anhand der Zeitbuchungen der Bediener. In der deutschen Version von Sage 100 aktualisiert sie die Termine der Arbeitsgänge jedes Fertigungsauftrags und bucht Rückmeldungen. Dafür nutzt sie den Schreibweg, den Ihr Sage-Partner und das SkyPlanner-Team bei der Anforderungsaufnahme festlegen.
Kann Sage 100 Änderungen in Echtzeit übertragen?
SkyPlanner übernimmt Änderungen aus Sage 100 durch regelmäßige Lesezugriffe: offene Aufträge in kurzen Intervallen, Bestände und Bestellungen stündlich. In der Gegenrichtung übertragen die Webhooks von SkyPlanner Planänderungen, sobald sie entstehen.
Können wir SkyPlanner testen, bevor die Integration eingerichtet wird?
Ja. In der kostenlosen 30-Tage-Testphase können Sie bis zu 20 Arbeitsstationen nutzen und Ihre Work Tickets oder 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 Integration aufzunehmen.
