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

Katana ist ein mandantenfähiges Cloud-Produkt. Daher nutzen alle Kunden dieselbe API. Die REST API in der Version v1 ist unter https://api.katanamrp.com/v1 erreichbar, die OpenAPI-Spezifikation in Version 3.0 unter https://api.katanamrp.com/v1/openapi.json. Die Dokumentation finden Sie im Katana Developer Hub.

Für die Feinplanung werden folgende Endpunkte benötigt:

• Stammdaten: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Aufträge: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Reihenfolge: /manufacturing_order_rerank.
• Versorgung und Bedarf: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Es gibt keinen Endpunkt /resources. Ressourcen sind als resource_id und resource_name in den Arbeitsgangzeilen der Produkte und Fertigungsaufträge hinterlegt.

Registrieren Sie einen Webhook per POST /webhooks mit einer HTTPS-URL und den benötigten Ereignissen. (Quelle) Für die Feinplanung sind folgende Ereignisse relevant:

• manufacturing_order.created, .updated, .deleted, .in_progress, .blocked, .done
• manufacturing_order_operation_row.created, .updated, .in_progress, .paused, .completed
• current_inventory.material_updated, .material_out_of_stock
• purchase_order.* und purchase_order_row.*, einschließlich der Wareneingangsereignisse
• product.*, product_recipe_row.* und sales_order.*

Die Nutzdaten sind knapp gehalten: Ressourcentyp, Aktion und ein href. Der Empfänger ruft das vollständige Objekt über den href ab. Jede Zustellung enthält zur Verifizierung einen x-sha2-signature-Header (HMAC SHA-256). Ihr Endpunkt muss innerhalb von 10 Sekunden mit 20X antworten. Katana wiederholt die Zustellung drei Mal: nach 30 Sekunden, 2 Minuten und 15 Minuten.

1. Erstimport der Stammdaten. Rufen Sie Produkte, Materialien, Varianten, Rezepturzeilen und Produktarbeitsgangzeilen seitenweise ab. Drosseln Sie dabei die Anfragen, um unter dem Ratenlimit zu bleiben. Legen Sie für jede unterschiedliche Ressource in den Arbeitsgangzeilen eine SkyPlanner-Arbeitsstation an und behalten Sie eine 1:1-Schlüsselzuordnung bei. Hinterlegen Sie Schichten, Urlaub und Überstunden je Arbeitsstation in SkyPlanner, da Katana keinen Ressourcenkalender hat.

2. Auftragssynchronisierung. Abonnieren Sie Ereignisse für Fertigungsaufträge, Arbeitsgangzeilen, Bestände und Bestellungen. Rufen Sie bei jedem Ereignis das Objekt über seinen href ab und aktualisieren Sie den Arbeitsgang. SkyPlanner betrachtet bestelltes Material zum Liefertermin der Bestellung als verfügbar und aktualisiert den Bestand beim Wareneingang. Ein nächtlicher Abgleich mit Filtern nach Änderungsdatum erfasst alle verpassten Ereignisse.

3. Plan zurückschreiben. Zwei Aufrufe übertragen den Plan nach Katana:

• POST /manufacturing_order_rerank „moves one or more manufacturing orders to an exact place in the production schedule“ (verschiebt einen oder mehrere Fertigungsaufträge an eine genaue Position im Produktionsplan). Pro Anfrage lassen sich bis zu 250 offene Fertigungsaufträge am Anfang, am Ende oder vor oder nach einem bestimmten Fertigungsauftrag einordnen. (Quelle)
• PATCH /manufacturing_orders/{id} setzt production_deadline_date. Katana akzeptiert den Wert nur, wenn die automatische Terminberechnung für den betreffenden Fertigungsstandort deaktiviert ist. (Quelle)

Die neue Reihenfolge wirkt sich nicht nur auf die Liste aus. In Katana gilt: „higher-priority MOs reserve required materials and subassemblies first“ (Fertigungsaufträge mit höherer Priorität reservieren benötigte Materialien und Unterbaugruppen zuerst). Damit entscheidet die SkyPlanner-Reihenfolge auch darüber, welcher Fertigungsauftrag in Katana Bestand zugeteilt bekommt.

4. Rückmeldungen vom Shopfloor. Bediener erfassen ihre Arbeit mit SkyPlanner Mobile Confirmations, Production Timer oder Quick Log Mode. SkyPlanner schreibt Status und Ist-Zeit in die Arbeitsgangzeile des Fertigungsauftrags. Nutzt ein Werk stattdessen weiterhin die Katana Shop Floor App, liest SkyPlanner die Ereignisse der Arbeitsgangzeilen ein. Legen Sie je Werk einen Rückmeldekanal fest.

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

• Der Terminmodus überschreibt Termine. „Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.“ (Sobald der automatische Modus aktiviert ist, werden alle manuellen Termine überschrieben und können nicht wiederhergestellt werden.) Legen Sie den Modus einmalig beim Projektstart fest.
• Kein Ressourcenkalender. Leiten Sie Schichten nicht aus dem einzelnen Wert Weekly throughput ab. Richten Sie sie in SkyPlanner für jede Arbeitsstation ein.
• Ressourcen nur in Arbeitsgangzeilen. Behalten Sie die Ressourcennamen in Katana bei, da sie als Schlüssel für die Arbeitsstationen in SkyPlanner dienen.
• Zeiteinheiten. planned_time_parameter wird in Sekunden angegeben: bei stückbezogenen Arbeitsgängen pro Einheit, bei den Typen process, setup und fixed als Gesamtzeit. Ordnen Sie den Typ korrekt zu, sonst weichen die Dauern um den Faktor der Menge ab.
• Gruppen in der Auftragsfertigung. Beim Ändern der Reihenfolge bleiben MOs, die mit demselben Kundenauftrag verknüpft sind, zusammen. Planen Sie sie deshalb als Gruppe ein.
• Geändertes Verhalten der Rerank-Endpunkte. Seit dem 7. Oktober 2026 platzieren die Rerank-Endpunkte Aufträge genau an der angeforderten Position. Integrationen, die für das frühere Verhalten entwickelt wurden, müssen erneut getestet werden. (Quelle)