Integrationen / ERP / Acumatica Cloud ERP
Acumatica Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS
Dieser Leitfaden zeigt Partnern und IT-Teams, wie sie Acumatica Cloud ERP (Manufacturing Edition) mit SkyPlanner APS verbinden. Die Integration zwischen SkyPlanner und Acumatica arbeitet in beide Richtungen:
- Produktionsaufträge mit ihren Arbeitsgängen, Arbeitsstationen, Maschinen, Werkzeugen, Schichten, Lagerartikeln und Bestellungen werden eingelesen.
- Geplante Start- und Endtermine werden in die Arbeitsgänge des Produktionsauftrags zurückgeschrieben. Anschließend wird der Auftrag fixiert.
- Die erfassten Arbeitszeiten der Bediener werden als Arbeitszeit- und Mengenbuchungen zurückgemeldet.
- SkyPlanner-Webhooks übertragen Planänderungen, sobald sie auftreten.
Das SkyPlanner-Team stimmt die Integration beim Onboarding auf Ihre Acumatica-Konfiguration ab 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).
Schnittstellen von Acumatica
Die Integration nutzt Schnittstellen, die Acumatica bereits mitliefert. In der Instanz wird nichts installiert.
- Vertragsbasierte REST API. Die Endpunkte sind versioniert und richten sich nach dem jeweiligen Release. Der Endpunkt Manufacturing (zum Beispiel 26.200.001 für 2026 R2) stellt
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryundMaterialEntrybereit. Der Endpunkt Default umfasstStockItem,PurchaseOrderundSalesOrder. URLs folgen dem Muster{instance}/entity/{Endpoint}/{version}/{Entity}. - Aktionen am selben Endpunkt.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryundReleaseMaterialEntryführen dieselbe Logik aus wie die Schaltflächen in den Masken. - OData. Jede Generic Inquiry (SM208000) lässt sich über OData bereitstellen. Eine Generic Inquiry mit offenen Produktionsarbeitsgängen und deren Terminen ist der schnellste Weg, große Datenmengen auszulesen.
- Push-Benachrichtigungen (SM302000). Sie basieren auf einer Generic Inquiry oder einer integrierten Abfrage und senden eingefügte und gelöschte Zeilen an eine von Ihnen konfigurierte URL.
- Import- und Exportszenarien mit CSV- und Excel-Providern für die Übertragung großer Datenmengen.
Entitäten und Aktionen sind unter Web Service Endpoints (SM207000) und im Repository des REST-Clients von Acumatica aufgeführt.
Authentifizierung und Limits
Acumatica nutzt OAuth 2.0 und OpenID Connect über Client-Anwendungen, die unter Connected Applications (SM303010) registriert sind. Dokumentiert sind die Flows Authorization Code, Implicit, Resource Owner Password Credentials und Hybrid. Registrieren Sie für eine Serverintegration einen eigenen Integrationsbenutzer mit Rollen, die nur die erforderlichen Berechtigungen haben. Verwenden Sie Authorization Code mit einem Refresh-Token oder Resource Owner Password Credentials.
Ihre Lizenz legt die Obergrenzen fest: Die License Monitoring Console (SM604000) zeigt die zulässige Anzahl an API-Anfragen pro Minute und API-Benutzern.
Bei SkyPlanner 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.
Datenzuordnung
| Acumatica-Objekt (Endpunkt / Maske) | SkyPlanner-Objekt | Richtung | Häufigkeit |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkte und Materialien | Acumatica → SkyPlanner | Erstübernahme, danach nur Änderungen |
BillOfMaterial (AM208000): Materialien, Arbeitsgänge | Produktstruktur, Unterprodukte, Materialien je Produkt | Acumatica → SkyPlanner | Erstübernahme, danach bei Änderungen |
| BOM-Arbeitsgänge: Setup, Run, Machine, Queue, Finish, Move Time | Prozessschritte mit Bearbeitungs-, Rüst- und Abrüstzeiten | Acumatica → SkyPlanner | Erstübernahme, danach bei Änderungen |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Arbeitsstationen, Arbeitsstationsgruppen, Wirkungsgrade, alternative Arbeitsstationen | Acumatica → SkyPlanner | Erstübernahme, danach selten |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Schichten und Personalkapazität | Acumatica → SkyPlanner | Täglich; alternativ werden Schichten in SkyPlanner gepflegt |
Tool (AM205500) | Werkzeuge als Ressourcen mit begrenzter Kapazität | Acumatica → SkyPlanner | Erstübernahme |
ProductionOrder mit OrderOperationDetail (Planned, Released, In Process) | Aufträge und Arbeitsgänge mit Fälligkeitsterminen, Einlastungspriorität und Materialbedarf | Acumatica → SkyPlanner | Push-Benachrichtigung oder Polling alle paar Minuten |
Positionen von PurchaseOrder (Default) | Bestellungen mit erwartetem Liefertermin | Acumatica → SkyPlanner | Polling, stündlich oder beim Planungslauf |
| Artikelmengen je Lager | Lagerbestände | Acumatica → SkyPlanner | Polling, stündlich oder beim Planungslauf |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Geplanter Start, geplantes Ende und Arbeitsstation je Arbeitsgang | SkyPlanner → Acumatica | Bei Planänderungen über einen SkyPlanner-Webhook |
Aktion FirmProductionOrder | Schützt die zurückgeschriebenen Termine vor Änderungen durch Acumatica APS | SkyPlanner → Acumatica | Nach jedem Rückschreiben |
LaborEntry, MoveEntry mit Freigabeaktionen | Erfasste Arbeitszeiten, fertiggestellte Mengen, Bedienerrückmeldungen | SkyPlanner → Acumatica | Je Rückmeldung oder Schicht |
| Nicht in Acumatica | Rüstzeitmatrix, namentlich erfasste Bediener, Arbeitsgänge mit mehreren Bedienern | In SkyPlanner gepflegt | Einrichtung beim Onboarding |
Integrationsabläufe
1. Erstübernahme der Stammdaten. Lesen Sie zuerst Arbeitsstationen, Maschinen, Werkzeuge, Schichten und Kalender ein. Danach folgen Lagerartikel und Stücklisten. Legen Sie fest, wie eine Arbeitsstation mit mehreren Maschinen abgebildet wird: als eine Arbeitsstationsgruppe, deren Maschinen einzelne Arbeitsstationen sind, oder als eine einzige Arbeitsstation. Das Feld Basis for Capacity in Acumatica zeigt, mit welchem Modell der Betrieb arbeitet.
2. Auftragssynchronisierung. Lesen Sie Produktionsaufträge und ihre Arbeitsgänge aus dem Auftrag ein, nicht aus der BOM. Die Arbeitsgänge werden in den Auftrag kopiert und dort von den Planern geändert. Richten Sie für eine Generic Inquiry mit offenen Aufträgen und Arbeitsgängen Push-Benachrichtigungen ein oder fragen Sie sie per Polling ab. Lesen Sie auch offene Bestellpositionen ein. SkyPlanner behandelt bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand, sobald die Bestellung als Delivered markiert ist.
3. Planung zurückschreiben. Für jeden Arbeitsgang, den die Planungsengine eingeplant oder verschoben hat, schreibt SkyPlanner StartDate und EndDate in OrderOperationDetail. Bei einer Verlagerung auf eine alternative Arbeitsstation wird auch diese zurückgeschrieben. Anschließend ruft SkyPlanner FirmProductionOrder auf. Acumatica: „When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.“ (Bei der Feinplanung von Produktionsaufträgen plant das System fixierte Produktionsaufträge nicht neu ein.) (Quelle)
4. Rückmeldungen vom Shopfloor. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations oder dem Production Timer. Aus den erfassten Arbeitszeiten entstehen LaborEntry-Belege (Zeit und fertiggestellte Menge je Arbeitsgang) oder MoveEntry-Belege (nur Menge), die mit der passenden Aktion freigegeben werden. Wenn Ihre Fertigung bereits in Acumatica rückmeldet, über Labor (AM301000) oder den Shop Floor Kiosk, werden die Fortschrittsmeldungen in die andere Richtung übertragen. Entscheiden Sie sich für einen Rückmeldeweg, niemals für beide.
5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:
| Daten | Führendes System |
|---|---|
| Lagerartikel, Stücklisten, Mengen, Auftragsstatus, Kalkulation | Acumatica |
| Reihenfolge der Arbeitsgänge, Start- und Endzeiten, Zuordnung der Arbeitsstationen | SkyPlanner |
| Rüstzeitmatrix, Werkzeuge, Anforderungen an Bediener, Alternativen | SkyPlanner |
| Schichten und Abwesenheiten | Ein System, bei der Anforderungsaufnahme festgelegt |
| Arbeitszeit- und Mengenbuchungen | Acumatica, gebucht aus SkyPlanner-Zeiterfassungen oder direkt auf dem Shopfloor erfasst |
Die Hauptursache für Konflikte ist Acumaticas eigenes APS. Rough Cut Planning oder der APS Maintenance Process können Termine für Aufträge neu berechnen, die SkyPlanner bereits eingeplant hat. Das verhindern Sie, indem Sie jeden zurückgeschriebenen Auftrag fixieren. Schließen Sie eingeplante Aufträge außerdem von APS-Planungsläufen aus.
Typischer Projektablauf
Die Implementierung ist normalerweise innerhalb weniger Wochen nach Beginn des Onboardings abgeschlossen. Zuvor testen Sie SkyPlanner 30 Tage kostenlos mit Ihren eigenen Daten. Exportieren Sie Arbeitsstationen und offene Produktionsaufträge samt Arbeitsgängen über eine Generic Inquiry nach Excel, importieren Sie die Daten und prüfen Sie den Plan.
- Mapping. Legen Sie die Zuordnungstabelle, die Regeln zur Datenhoheit, die Synchronisierungsintervalle und den Übertragungsweg für Arbeitszeitbuchungen fest.
- Zugriff. Registrieren Sie die angebundene Anwendung, legen Sie den Integrationsbenutzer und die Rollen an und prüfen Sie die Endpunktversion unter Web Service Endpoints. Beginnen Sie in einer Sandbox.
- Erstimport. Arbeitsstationen, Maschinen, Werkzeuge, Schichten, Lagerartikel und Stücklisten.
- Aufträge synchronisieren. Produktionsaufträge, Arbeitsgänge und Bestellungen per Push-Benachrichtigung oder Polling übertragen.
- Restriktionen in SkyPlanner einrichten. Rüstzeitmatrix, namentlich zugeordnete Bediener, Arbeitsgänge mit mehreren Bedienern und Alternativen.
- Rückschreiben. Arbeitsgangtermine, Fixierungen sowie Arbeitszeit- oder Mengenrückmeldungen.
- Parallelbetrieb. Vergleichen Sie die Termine aus SkyPlanner mit dem aktuellen Plan und korrigieren Sie die Stammdaten.
- Produktivstart. Aktivieren Sie das Rückschreiben, sobald die Daten übereinstimmen.
Was Sie bei einer Acumatica-Integration einplanen sollten
- Aktive APS-Engine prüfen. Classic und Optimized speichern ihre Einstellungen getrennt, und nur eine der beiden Engines kann aktiviert sein. Prüfen Sie vor dem ersten Rückschreiben die Einstellungen unter Enable/Disable Features (CS100000).
- Endpunktversion festlegen. Die Version ist Teil der URL. Bei einem Release-Upgrade kommt eine neue Version hinzu. Testen Sie daher nach jedem Upgrade erneut.
- Arbeitsgänge aktualisieren. Einige Arbeitsgangfelder lassen sich über REST nur lesen. Auch der Auftragsstatus spielt eine Rolle. Testen Sie die Abfolge beim Rückschreiben für Aufträge mit dem Status Released und In Process in einer Sandbox.
- Einheiten und Zeitfelder. Die Laufzeit bezieht sich auf Run Units, die Maschinenzeit auf Machine Units. Für Warte- und Transportzeiten gilt: „affect the calculated schedule but do not occupy work center capacity.“ (Sie beeinflussen den berechneten Plan, belegen aber keine Kapazität der Arbeitsstation.) Rechnen Sie die Werte beim Import sorgfältig um.
- Materialverfügbarkeit bewerten. Classic APS setzt voraus, dass sämtliches Material vollständig verfügbar ist. SkyPlanner plant anhand der Lagerbestände und der terminierten Zugänge aus Bestellungen. Vereinbaren Sie, nach welchem Ergebnis sich die Planer richten.
- API-Limits. Die zulässige Anzahl von Anfragen pro Minute hängt von der Lizenz ab. Lesen Sie nur Änderungen aus und nutzen Sie Push-Benachrichtigungen statt vollständiger Neuimporte.
Wer die Acumatica-Integration einrichtet und betreut
- Das SkyPlanner-Team richtet die Integration während des Onboardings ein und betreut sie nach dem Produktivstart. Jedes Werk nutzt Acumatica anders. Dieses Wissen fließt in die Einrichtung ein.
- Ihr Acumatica-Partner kann mitwirken. Er kennt Ihre Anpassungen, Generic Inquiries und Rollen. SkyPlanner stellt die REST API, die Swagger/OpenAPI-Dokumentation und Webhooks bereit.
- Auch Ihre eigenen Entwickler können darauf aufbauen und dieselbe REST API mit einem API-Token nutzen. Für den Einstieg genügt ein API-Token; bei Bedarf unterstützt das SkyPlanner-Team. Laboratory & Allied hat diesen Weg mit SAP Business One gewählt: Das interne IT-Team entwickelte die Integration weitgehend selbstständig, mit Unterstützung von SkyPlanner.
SkyPlanner ist ab 199 € pro Monat erhältlich, einschließlich 5 Arbeitsstationen und bei monatlicher Abrechnung. Sie erhalten vorab ein Angebot, das neben Ihrem Tarif auch die auf Ihre Abläufe und Anforderungen abgestimmte Integration umfasst. So kennen Sie vor dem Start die Gesamtkosten. Einen Vergleich mit Acumaticas eigenem APS finden Sie unter Feinplanung mit Acumatica, einen Überblick auf der Acumatica-Seite und weitere Systeme in der Übersicht der ERP-Integrationen.
Erfahrungen von Fertigungsunternehmen mit SkyPlanner
2 hjede Woche eingespart
„Mit SkyPlanner haben wir unsere Produktionsplanung von Excel-Tabellen auf die Optimierung der Produktion in Echtzeit umgestellt.“
Kalle Kalliomäki, Spezialist für Lieferketten
UTU · Elektrische Schalttafeln und Schaltanlagen
Die Produktionsplanung spart jede Woche 2 Stunden Arbeitszeit, und eine neue Auftragsreihenfolge erreicht die Fertigungslinie innerhalb von Sekunden.
+90%Produktionseffizienz
„Die Effizienz in der Produktion ist um 90% gestiegen.“
Abdul Rucyinga, IT-Leiter
Laboratory & Allied · Pharmazeutische Fertigung
Die Produktionseffizienz ist um 90% gestiegen. Ein optimierter Plan für drei Monate über alle Arbeitsstationen hinweg ist in weniger als 30 Minuten erstellt.
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.
99,2%Liefertreue
„Mit SkyPlanner können wir Engpässe erkennen und haben mehr Übersicht in der Produktionssteuerung.“
Toni Tuori, Produktionsleiter
Piristeel · Dachsicherheits- und Regenwassersysteme
Die Liefertreue erreichte in diesem Jahr 99,2%, und die Feinplanung spart bis zu vier Stunden Arbeitszeit pro Tag.
Häufige Fragen
Sind Produktionsaufträge über die Acumatica-API verfügbar?
Ja. Der Manufacturing-Endpunkt der vertragsbasierten REST API stellt ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool sowie Arbeitszeit- und Mengenrückmeldungen bereit. Hinzu kommen Aktionen wie FirmProductionOrder.
Wer entwickelt die Acumatica-Integration?
Das SkyPlanner-Team richtet die bidirektionale Integration während des Onboardings passend zu Ihrer Acumatica-Umgebung ein und betreut sie nach dem Produktivstart. Auch Ihr Acumatica-Partner oder Ihre eigenen Entwickler können auf der dokumentierten REST API von SkyPlanner aufbauen. Für den Einstieg genügt ein API-Token.
Benötigen wir Acumatica APS für diese Integration?
Nein. Acumaticas eigener Planungslauf mit begrenzten Kapazitäten erfolgt über die Maske Rough Cut Planning. Classic APS plant Aufträge, deren Endtermin mehr als 120 Tage in der Zukunft liegt, mit unbegrenzter Kapazität (Quelle). SkyPlanner erstellt die detaillierte Feinplanung mit begrenzten Kapazitäten selbst aus Produktionsaufträgen, Arbeitsgängen, Arbeitsstationen, Maschinen und Werkzeugen. Die Integration funktioniert daher unabhängig davon, ob APS aktiviert ist, für das laut Acumatica gilt: „is subject to licensing“ (ist lizenzpflichtig). Autopilot hält den Plan aktuell, und Bediener erfassen ihre Arbeit mit Mobile Confirmations.
Wie verhindern wir, dass Acumatica APS die Termine von SkyPlanner überschreibt?
SkyPlanner fixiert jeden Produktionsauftrag, nachdem die Arbeitsgangtermine zurückgeschrieben wurden. Die Feinplanung von Acumatica plant fixierte Aufträge nicht neu ein.
Kann Acumatica Änderungen in Echtzeit übertragen?
Ja. Push-Benachrichtigungen (SM302000) auf Basis einer Generic Inquiry senden geänderte Zeilen sofort an eine URL. Die Webhooks von SkyPlanner übertragen Planänderungen in die andere Richtung.
Welche Authentifizierung sollte die Integration verwenden?
OAuth 2.0 über einen unter Connected Applications (SM303010) registrierten Client, mit einem eigenen Integrationsbenutzer und Rollen mit minimal erforderlichen Berechtigungen. Das Verfahren für Ihre Instanz wird während der Anforderungsaufnahme bestätigt.
Können wir SkyPlanner testen, bevor die Integration entwickelt wird?
Ja. In der kostenlosen 30-tägigen Testphase können Sie bis zu 20 Arbeitsstationen nutzen und Daten aus einer Acumatica Generic Inquiry per Excel oder CSV importieren. Eine Kreditkarte ist nicht erforderlich. Starten Sie den Test oder sprechen Sie mit dem Vertrieb, um die Anforderungen an die Integration aufzunehmen.
