Οδηγός διασύνδεσης Katana για χρονοπρογραμματισμό παραγωγής με το SkyPlanner APS

Το Katana είναι ένα ενιαίο προϊόν στο cloud με αρχιτεκτονική πολλαπλών μισθωτών, οπότε όλοι οι πελάτες χρησιμοποιούν το ίδιο API. Πρόκειται για REST API, έκδοσης v1, στη διεύθυνση https://api.katanamrp.com/v1, με προδιαγραφή OpenAPI 3.0 στη διεύθυνση https://api.katanamrp.com/v1/openapi.json. Η τεκμηρίωση βρίσκεται στο Katana Developer Hub.

Τα endpoints που χρειάζονται για τον χρονοπρογραμματισμό:

• Βασικά δεδομένα: /products, /materials, /variants, /recipe_rows, /bom_rows, /product_operation_rows.
• Εντολές: /manufacturing_orders, /manufacturing_order_operation_rows, /manufacturing_order_recipe_rows, /manufacturing_order_productions.
• Σειρά εκτέλεσης: /manufacturing_order_rerank.
• Εφοδιασμός και ζήτηση: /inventory, /purchase_orders, /purchase_order_rows, /sales_orders, /sales_order_rows.

Δεν υπάρχει endpoint /resources. Οι πόροι εμφανίζονται ως resource_id και resource_name στις γραμμές φάσεων προϊόντων και στις γραμμές φάσεων εντολών παραγωγής.

Καταχωρίστε ένα webhook με POST στο /webhooks, δηλώνοντας ένα HTTPS URL και τα συμβάντα που χρειάζεστε. (πηγή) Τα συμβάντα που χρησιμεύουν στον χρονοπρογραμματισμό είναι:

• 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.* και purchase_order_row.*, συμπεριλαμβανομένων των συμβάντων παραλαβής
• product.*, product_recipe_row.* και sales_order.*

Τα payloads περιέχουν λίγα στοιχεία: τον τύπο πόρου, την ενέργεια και ένα href. Ο παραλήπτης ανακτά το πλήρες αντικείμενο από το href. Κάθε αποστολή περιλαμβάνει μια κεφαλίδα x-sha2-signature (HMAC SHA-256) για επαλήθευση. Το endpoint σας πρέπει να απαντά με 20X εντός 10 δευτερολέπτων. Το Katana επαναλαμβάνει την προσπάθεια τρεις φορές: στα 30 δευτερόλεπτα, στα 2 λεπτά και στα 15 λεπτά.

1. Αρχική φόρτωση βασικών δεδομένων. Ανακτήστε σελίδα προς σελίδα τα προϊόντα, τα υλικά, τις παραλλαγές, τις γραμμές συνταγών και τις γραμμές φάσεων προϊόντων, διατηρώντας τον ρυθμό αιτημάτων κάτω από το όριο. Δημιουργήστε κέντρα εργασίας στο SkyPlanner από τους διακριτούς πόρους των γραμμών φάσεων και διατηρήστε αντιστοίχιση κλειδιών 1:1. Ορίστε βάρδιες, άδειες και υπερωρίες ανά κέντρο εργασίας στο SkyPlanner, καθώς το Katana δεν διαθέτει ημερολόγιο πόρων.

2. Συγχρονισμός εντολών. Εγγραφείτε στα συμβάντα εντολών παραγωγής, γραμμών φάσεων, αποθεμάτων και παραγγελιών αγοράς. Για κάθε συμβάν, ανακτήστε το αντικείμενο από το href του και ενημερώστε την εργασία. Το SkyPlanner θεωρεί τα παραγγελθέντα υλικά διαθέσιμα κατά την ημερομηνία παράδοσης της παραγγελίας αγοράς και ενημερώνει το απόθεμα κατά την παραλαβή της. Ένας νυχτερινός έλεγχος συμφωνίας με φίλτρα ημερομηνίας ενημέρωσης εντοπίζει τυχόν συμβάντα που χάθηκαν.

3. Εγγραφή του χρονοπρογράμματος στο Katana. Δύο κλήσεις μεταφέρουν το πρόγραμμα στο Katana:

• Το POST /manufacturing_order_rerank “moves one or more manufacturing orders to an exact place in the production schedule” (μετακινεί μία ή περισσότερες εντολές παραγωγής σε συγκεκριμένη θέση στο χρονοπρόγραμμα παραγωγής). Δέχεται έως 250 ανοικτές εντολές παραγωγής ανά αίτημα και τις τοποθετεί στην αρχή, στο τέλος ή πριν ή μετά από μια συγκεκριμένη εντολή παραγωγής. (πηγή)
• Το PATCH /manufacturing_orders/{id} ορίζει το production_deadline_date. Το Katana το δέχεται μόνο όταν ο αυτόματος υπολογισμός προθεσμιών είναι απενεργοποιημένος για τη συγκεκριμένη εργοστασιακή εγκατάσταση. (πηγή)

Η αναδιάταξη επηρεάζει περισσότερα από τη σειρά στη λίστα. Στο Katana, “higher-priority MOs reserve required materials and subassemblies first” (οι εντολές παραγωγής υψηλότερης προτεραιότητας δεσμεύουν πρώτες τα απαιτούμενα υλικά και υποσυγκροτήματα). Επομένως, η σειρά που ορίζει το SkyPlanner καθορίζει και ποια εντολή παραγωγής δεσμεύει απόθεμα στο Katana.

4. Επιβεβαιώσεις από τον χώρο παραγωγής. Οι χειριστές καταγράφουν την εργασία τους με τα SkyPlanner Mobile Confirmations, Production Timer ή Quick Log Mode. Το SkyPlanner εγγράφει την κατάσταση και τον πραγματικό χρόνο στη γραμμή φάσης της εντολής παραγωγής. Αν ένα εργοστάσιο διατηρήσει το Katana Shop Floor App αντί αυτών, το SkyPlanner διαβάζει τα συμβάντα των γραμμών φάσεων. Επιλέξτε ένα κανάλι καταγραφής ανά εργοστάσιο.

5. Ευθύνη δεδομένων και κανόνες επίλυσης συγκρούσεων. Καταγράψτε τους πριν από την έναρξη λειτουργίας:

• Η αυτόματη λειτουργία προθεσμιών αντικαθιστά τις ημερομηνίες. “Once automatic mode is enabled, all manual deadlines will be overwritten and cannot be restored.” (Μόλις ενεργοποιηθεί η αυτόματη λειτουργία, όλες οι χειροκίνητες προθεσμίες θα αντικατασταθούν και δεν θα μπορούν να επαναφερθούν.) Αποφασίστε τον τρόπο ορισμού των προθεσμιών μία φορά, στην έναρξη του έργου.
• Δεν υπάρχει ημερολόγιο πόρων. Μην υπολογίζετε τις βάρδιες από τη μοναδική τιμή Weekly throughput. Ορίστε τις ανά κέντρο εργασίας στο SkyPlanner.
• Πόροι μόνο στις γραμμές φάσεων. Διατηρείτε σταθερά τα ονόματα των πόρων στο Katana, επειδή αποτελούν το κλειδί αντιστοίχισης με τα κέντρα εργασίας του SkyPlanner.
• Μονάδες χρόνου. Το planned_time_parameter εκφράζεται σε δευτερόλεπτα: ανά μονάδα για τις φάσεις per-unit και συνολικά για τους τύπους process, setup και fixed. Αντιστοιχίστε σωστά τον τύπο, διαφορετικά οι διάρκειες θα είναι λανθασμένες κατά έναν συντελεστή ίσο με την ποσότητα.
• Ομάδες παραγωγής κατά παραγγελία. Κατά την ανακατάταξη, οι MO που συνδέονται με την ίδια παραγγελία πώλησης παραμένουν μαζί, γι’ αυτό ορίστε τη σειρά τους ως ομάδα.
• Η συμπεριφορά της ανακατάταξης άλλαξε. Από τις 7 Οκτωβρίου 2026, τα endpoints ανακατάταξης τοποθετούν τις παραγγελίες ακριβώς στη θέση που ζητείται. Οι διασυνδέσεις που αναπτύχθηκαν με βάση την παλαιότερη συμπεριφορά χρειάζονται νέα δοκιμή. (πηγή)