ProShop ERP Schnittstelle Leitfaden zur Feinplanung mit SkyPlanner APS

ProShop bietet externen Planungssystemen zwei Zugangswege, die in den ProShop API Developer Documents beschrieben sind:

1. ProShop GraphQL API. „ProShop provides a GraphQL API, available via HTTP(S).“ (ProShop stellt eine über HTTP(S) erreichbare GraphQL API bereit.) Es gibt einen Endpunkt: Jeder Aufruf erfolgt als HTTP POST an <proshop root>/api/graphql mit query, variables und operationName im JSON-Body. Jedes Modul bietet eine Abfrage im Singular für einzelne Datensätze und eine Abfrage im Plural für Listen. Die Seiteneinteilung der Listen erfolgt über pageSize (Standardwert 20) und pageStart. Die Listen liefern records und totalRecords zurück und akzeptieren die Argumente filter und query, die der Funktion Advanced Search des jeweiligen Moduls entsprechen. Das Schema lässt sich per Introspektion abfragen. (Einführung in die ProShop API)
2. Recently Updated Records API. „A simple REST interface allows external integrations to request information between arbitrary points in time.“ (Über eine einfache REST-Schnittstelle können externe Integrationen Informationen für beliebige Zeiträume abfragen.) Rufen Sie <proshop root>/recentlyupdatedrecords mit start (ISO 8601) sowie optional mit end und filterby auf, zum Beispiel workorders,workcells,purchaseorders,timetracking,deletions. Das ProShop-Team muss den Index zuvor aktivieren. (Recently Updated Records API)

Schreibzugriffe erfolgen über GraphQL-Mutations. Time Tracking Login ist das dokumentierte Beispiel. Die Schreibberechtigung wird über Scopes je Modul vergeben.

Die Entwicklerdokumentation von ProShop beschreibt weder ausgehende Webhooks noch GraphQL-Subscriptions. Die ProShop-Seite wird per Polling abgefragt. Mit der Recently Updated Records API bleibt der Aufwand gering: Fragen Sie alle seit dem letzten Durchlauf erstellten, geänderten oder gelöschten Datensätze ab, gefiltert nach den für die Planung benötigten Datensatztypen. Rufen Sie anschließend die geänderten Fertigungsaufträge anhand ihrer Nummer über GraphQL ab. Laut ProShop ist das schneller als eine Abfrage über lastModifiedTime.

Üblich ist ein Intervall von fünf Minuten für Fertigungsaufträge und Zeiterfassung sowie eine stündliche Abfrage für Teile und Bestellungen. SkyPlanner sendet Webhooks, sobald sich ein Status oder der Plan ändert. Das Zurückschreiben erfolgt damit ereignisgesteuert.

1. Initialer Import der Stammdaten. Lesen Sie Parts, Work Cells, Users, Tools und Fixtures seitenweise über GraphQL-Abfragen im Plural ein. Setzen Sie pageSize für den ersten Import hoch und steuern Sie die Schleife anhand von totalRecords. Legen Sie die Zuordnung der Arbeitszellen fest: Maschinenbezogene Arbeitszellen werden zu Arbeitsstationen, personenbezogene zu Personal. So kann derselbe Arbeitsgang eine Maschine und ihren Bediener gleichzeitig belegen.

2. Fertigungsaufträge synchronisieren. Lesen Sie aktive Fertigungsaufträge mit ihren Arbeitsgängen, Sollzeiten und BOM-Datensätzen sowie offene Bestellungen ein. SkyPlanner betrachtet bestelltes Material ab dem Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert ist. Änderungen werden über Recently Updated Records mit filterby=workorders,purchaseorders,deletions erkannt.

3. Plantermine zurückschreiben. Sobald die Planungsengine einen Arbeitsgang einplant oder verschiebt, löst ein SkyPlanner-Webhook eine GraphQL-Mutation aus. Diese setzt die Plantermine des Fertigungsauftrags über eine Authorization mit workorders:w. Die Prognose zur Termintreue und die Bedarfstermine im Einkauf in ProShop basieren dann auf den Terminen aus SkyPlanner.

4. Rückmeldungen aus der Fertigung. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Die Zeitbuchungen halten den Plan aktuell. Sie entscheiden, ob die Istzeiten an ProShop Time Tracking für den jeweiligen Arbeitsgang des Fertigungsauftrags zurückgemeldet werden. Falls nicht, erfassen die Bediener ihre Zeiten wie bisher in ProShop, und SkyPlanner liest sie über timetracking ein.

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

Legen Sie ein einziges System fest, das die Termine der Fertigungsaufträge schreibt. Sobald SkyPlanner eine Arbeitszelle plant, ändern Planer die Reihenfolge ihrer Auftragsliste in ProShop nicht mehr. So konkurrieren die beiden Pläne nie miteinander.

• Vorgabezeiten sind entscheidend. ProShop berechnet die Dauer aus geschätzten Rüst- und Zykluszeiten. Übernehmen Sie die aktuellen Vorgabezeiten, nicht die ursprüngliche Schätzung. Trennen Sie Rüst- und Bearbeitungszeit, damit die Rüstzeitmatrix den einzelnen Rüstzeitwert ersetzen kann.
• Personen als Arbeitszellen. Eine Arbeitszelle kann auch eine Person sein. Ordnen Sie diese in SkyPlanner dem Personal zu, nicht den Maschinen. Andernfalls wird jeder Bediener als parallel verfügbare Maschine behandelt.
• Time Tracking benötigt einen Benutzer. Seit April 2026 gilt für die Mutation Time Tracking Login: „requires user context“ (erfordert einen Benutzerkontext). Mit Client Credentials ist sie nicht zulässig. Übertragen Sie die Arbeitszeiten der Bediener über den OAuth 2.0 Authorization Flow, oder erfassen Sie die Zeiten weiterhin in ProShop und lesen Sie sie dort aus.
• Änderungsindex aktivieren lassen. Recently Updated Records funktioniert erst, nachdem das ProShop-Team die Funktion freigeschaltet hat. Fordern Sie die Freischaltung in der ersten Woche an.
• ITAR-Datensätze. ProShop filtert ITAR-beschränkte Datensätze je Verbindung. Eine Option in Developer System Config legt fest, ob sie als null-Werte zurückgegeben oder ausgelassen werden. Stimmen Sie ab, auf welche Fertigungsaufträge die Integration zugreifen darf, und berücksichtigen Sie null-Werte bei jedem Lesezugriff.
• Fremdbearbeitung. Arbeitsgänge bei Lieferanten beanspruchen Zeit, aber keine eigene Kapazität. Bilden Sie sie als Schritte ab, die nur Zeit berücksichtigen.