Leitfaden zur Fulcrum Schnittstelle für die Feinplanung mit SkyPlanner APS

Fulcrum ist ein mandantenfähiges Cloud-Produkt. Daher nutzen alle Kunden dieselbe API. Der Entwicklerbereich beschreibt sie als öffentliche API für „REST API calls directly into your Fulcrum site.“ (REST-API-Aufrufe direkt an Ihre Fulcrum-Instanz).

• Spezifikation. OpenAPI „Fulcrum PublicAPI“ v1, abrufbar unter https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum empfiehlt, daraus einen typisierten Client zu generieren. Die Seite History führt alle Änderungen mit Datum auf.
• Hosts. https://api.fulcrumpro.com für Standardinstanzen. ITAR-Instanzen verwenden api.fulcrumpro.us. Mit ITAR-Tokens antwortet der .com-Host mit 401.
• Aufbau. Listen werden über POST .../list mit einem Filter im Request-Body abgerufen. Die Paginierung erfolgt über Skip und Take, die Sortierung über Sort.Field / Sort.Dir. Viele Objekte unterstützen PUT, Aufträge zusätzlich JSON Patch.

Diese Endpunkte nutzt eine Integration für die Feinplanung:

Auf seiner Integrationsseite benennt Fulcrum den Aufwand klar: „Every system is a little bit different and requires some configuration.“ (Jedes System ist etwas anders und erfordert eine gewisse Konfiguration.) Genau diese Konfiguration übernimmt das SkyPlanner-Team während des Onboardings.

Fulcrum unterstützt Webhooks, die ein Administrator konfiguriert. Seit September 2026 werden fehlschlagende Webhooks pausiert und täglich erneut getestet, statt die Zustellung endlos zu wiederholen. Die API History nennt Ereignisse wie PurchaseOrderUpdated und ItemUpdated.

So liest die Integration Daten aus Fulcrum:

• Offene Aufträge werden alle paar Minuten abgefragt, gefiltert auf scheduled und inProgress sowie hasIncompleteOperations: true. Diesen Filter gibt Fulcrum selbst an, um dieselben Aufträge wie auf seiner Planungsseite abzurufen.
• Bestellungen und Lagerbestände werden vor jedem Planungslauf abgerufen oder bei Eingang eines PurchaseOrderUpdated-Webhooks, sofern dieser konfiguriert ist.
• Artikel, Arbeitspläne, Anlagen und Schichten werden bei Änderungen oder jede Nacht abgerufen.

In der Gegenrichtung übermitteln die SkyPlanner-eigenen Webhooks Planänderungen, sobald sie auftreten. Das Zurückschreiben erfolgt somit ereignisgesteuert.

1. Erstimport der Stammdaten. Zunächst werden Artikel, Materialien, Arbeitspläne, Arbeitsstationen und Anlagen abgerufen, danach Abteilungsschichten und Stillstandszeiten. Jedes Work Center in Fulcrum wird in SkyPlanner zu einer Arbeitsstationsgruppe mit den zugehörigen Anlagen. Die für einen Arbeitsgang im Arbeitsplan ausgewählten Anlagen werden zu dessen zulässigen Arbeitsstationen. Anlagen mit Unlimited Capacity, etwa Öfen und Lackierkabinen, werden als Chargenarbeitsgänge abgebildet.

2. Auftragsabgleich. Abgerufen werden offene Aufträge mit den zu fertigenden Artikeln und Arbeitsgängen sowie offene Bestellungen und Lagerbestände. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Lagerbestand, sobald die Bestellung als Delivered markiert wird. Bei jeder Neuplanung werden Lagerbestände und erwartete Wareneingänge geprüft.

3. Planungsdaten zurückschreiben. Fulcrum berechnet scheduledStartUtc, scheduledEndUtc und scheduledEquipmentId selbst und gibt sie schreibgeschützt zurück. Beim Aktualisieren eines Arbeitsgangs werden customFields akzeptiert. SkyPlanner schreibt den geplanten Beginn, das geplante Ende und die Arbeitsstation in benutzerdefinierte Felder jedes Auftragsarbeitsgangs sowie das geplante Ende in ein benutzerdefiniertes Feld des Auftrags. Vertrieb und Einkauf sehen die Termine aus SkyPlanner direkt am Auftrag in Fulcrum.

4. Rückmeldungen vom Shopfloor. Bediener erfassen ihre Arbeit in SkyPlanner mit Mobile Confirmations, Production Timer oder Quick Log Mode. SkyPlanner überträgt die Zeiten über /api/job-tracking-timers/start und /stop an Fulcrum oder als abgeschlossenen Zeitblock über /api/timers. Mengen werden über add-quantity-completed übertragen, die abschließende Menge einschließlich Ausschuss über complete. Die Auftragskalkulation in Fulcrum bleibt aktuell.

5. Datenhoheit und Konfliktregeln. Die Planungsfunktion von Fulcrum „dictates the order of operations in Job Tracking.“ (gibt die Reihenfolge der Arbeitsgänge in Job Tracking vor). Wählen Sie deshalb für jeden Arbeitsgang genau einen Weg zur Arbeitsfreigabe: die Arbeitsliste für Bediener in SkyPlanner oder Fulcrum Job Tracking. Halten Sie die Regeln vor dem Produktivstart schriftlich fest:

• Die Personalbesetzung bestimmt die Schichtkapazität. Die Einstellung Max Equipment pro Schicht in Fulcrum „is usually determined by how many people you have working in a certain area at that time.“ (richtet sich in der Regel danach, wie viele Personen zu diesem Zeitpunkt in einem bestimmten Bereich arbeiten). Einzelne Bediener und ihre Schichten werden in SkyPlanner eingerichtet. Die Benutzer unter /api/users liefern die Namen.
• Geplant wird auf Maschinen. Arbeitsstationen in Fulcrum fassen austauschbare Maschinen zusammen. Achten Sie darauf, dass die im Arbeitsplan ausgewählten Maschinen korrekt gepflegt sind: Sie bilden die Alternativen, zwischen denen die Planungsengine wählt.
• Fertigungsaufträge bündeln Aufträge. Ein Fertigungsauftrag fasst Arbeitsgänge mehrerer Aufträge zusammen, beispielsweise für ein Schachtelbild. Wird die Zeiterfassung für einen gruppierten Arbeitsgang gestartet, läuft stattdessen die Zeiterfassung des Fertigungsauftrags. Sie deckt alle Auftragsarbeitsgänge der Gruppe ab.
• Grenzen der Zeiterfassung. Nachträglich über /api/timers erfasste Zeitblöcke „may not be in the future, older than 30 days, or longer than 7 days.“ (dürfen weder in der Zukunft liegen noch die genannten Grenzen für Alter und Dauer überschreiten). Übertragen Sie Zeiten, sobald die Bediener sie erfassen.
• Unterschiedliche Zeitformate. Schichten verwenden lokale HHmm-Werte, Stillstandszeiten und geplante Termine werden in UTC angegeben. Zeitvorgaben für Arbeitsgänge werden in Sekunden geliefert.
• Maschinenupdates ersetzen den gesamten Datensatz. Ein PUT für equipment leert jedes Feld, das in der Anfrage fehlt. SkyPlanner liest Maschinendaten nur und schreibt sie niemals.
• ITAR-Standorte. Verwenden Sie den .us-Host und ein ITAR-Token.