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

Το Fulcrum είναι ένα ενιαίο προϊόν cloud με αρχιτεκτονική πολλαπλών μισθωτών, οπότε όλοι οι πελάτες χρησιμοποιούν το ίδιο API. Η πύλη προγραμματιστών το περιγράφει ως δημόσιο API για “REST API calls directly into your Fulcrum site.” (κλήσεις REST API απευθείας στη δική σας εγκατάσταση Fulcrum).

• Προδιαγραφή. OpenAPI “Fulcrum PublicAPI” v1, διαθέσιμη για λήψη στη διεύθυνση https://api.fulcrumpro.com/swagger/v1/swagger.json. Το Fulcrum προτείνει τη δημιουργία κώδικα πελάτη με καθορισμένους τύπους δεδομένων βάσει αυτής της προδιαγραφής. Η σελίδα History καταγράφει κάθε αλλαγή με την ημερομηνία της.
• Διακομιστές. https://api.fulcrumpro.com για τις συνήθεις εγκαταστάσεις. Οι εγκαταστάσεις ITAR χρησιμοποιούν το api.fulcrumpro.us, ενώ τα token ITAR λαμβάνουν απόκριση 401 από τον διακομιστή .com.
• Τρόπος κλήσεων. Οι λίστες ανακτώνται με POST .../list, με φίλτρα στο σώμα του αιτήματος, σελιδοποίηση μέσω Skip και Take και ταξινόμηση μέσω Sort.Field / Sort.Dir. Πολλά αντικείμενα δέχονται PUT, ενώ οι εργασίες δέχονται και JSON Patch.

Τα τελικά σημεία API που χρησιμοποιεί μια διασύνδεση χρονοπρογραμματισμού:

Η ίδια η σελίδα διασυνδέσεων του Fulcrum περιγράφει ξεκάθαρα τη δουλειά που απαιτείται: “Every system is a little bit different and requires some configuration.” (Κάθε σύστημα διαφέρει λίγο και χρειάζεται κάποια παραμετροποίηση.) Η ομάδα του SkyPlanner αναλαμβάνει ακριβώς αυτή την παραμετροποίηση κατά την αρχική ένταξη.

Το Fulcrum υποστηρίζει webhooks, τα οποία ρυθμίζει ένας διαχειριστής. Από τον Σεπτέμβριο του 2026, τα webhooks που αποτυγχάνουν τίθενται σε παύση και επανελέγχονται καθημερινά, αντί να επαναλαμβάνονται οι προσπάθειες επ’ αόριστον. Η σελίδα API History αναφέρει συμβάντα όπως τα PurchaseOrderUpdated και ItemUpdated.

Η διασύνδεση διαβάζει δεδομένα από το Fulcrum ως εξής:

• Οι ανοιχτές εργασίες ανακτώνται κάθε λίγα λεπτά, με φίλτρο για τις καταστάσεις scheduled και inProgress και με hasIncompleteOperations: true. Αυτό είναι το φίλτρο που δίνει το ίδιο το Fulcrum για αποτελέσματα που αντιστοιχούν στη σελίδα χρονοπρογραμματισμού του.
• Οι παραγγελίες αγοράς και τα αποθέματα ανακτώνται πριν από κάθε εκτέλεση χρονοπρογραμματισμού ή όταν λαμβάνεται webhook PurchaseOrderUpdated, όπου αυτό έχει ρυθμιστεί.
• Τα είδη, τα φασεολόγια, ο εξοπλισμός και οι βάρδιες ανακτώνται όταν αλλάζουν ή κάθε βράδυ.

Στην αντίθετη κατεύθυνση, τα webhooks του SkyPlanner αποστέλλουν τις αλλαγές του προγράμματος μόλις συμβούν. Έτσι, η εγγραφή δεδομένων πίσω στο Fulcrum ενεργοποιείται από συμβάντα.

1. Αρχική εισαγωγή βασικών δεδομένων. Ανακτήστε τα είδη, τα υλικά, τα φασεολόγια, τα κέντρα εργασίας και τον εξοπλισμό και έπειτα τις βάρδιες τμημάτων και τους χρόνους διακοπής λειτουργίας. Κάθε κέντρο εργασίας του Fulcrum μετατρέπεται σε ομάδα κέντρων εργασίας του SkyPlanner, με μέλη τον εξοπλισμό του. Ο επιλεγμένος εξοπλισμός κάθε φάσης του φασεολογίου καθορίζει τα επιτρεπόμενα κέντρα εργασίας της. Ο εξοπλισμός με ρύθμιση Unlimited Capacity, όπως φούρνοι και θάλαμοι βαφής, αντιστοιχίζεται σε εργασίες παρτίδας.

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

3. Εγγραφή του προγράμματος στο Fulcrum. Το Fulcrum υπολογίζει μόνο του τα scheduledStartUtc, scheduledEndUtc και scheduledEquipmentId και τα επιστρέφει μόνο για ανάγνωση. Η ενημέρωση φάσης δέχεται customFields. Το SkyPlanner καταχωρίζει την προγραμματισμένη έναρξη, την προγραμματισμένη λήξη και το κέντρο εργασίας σε προσαρμοσμένα πεδία κάθε φάσης της εργασίας, καθώς και την προγραμματισμένη λήξη σε προσαρμοσμένο πεδίο της ίδιας της εργασίας. Τα τμήματα πωλήσεων και αγορών βλέπουν τις ημερομηνίες του SkyPlanner στην εργασία μέσα στο Fulcrum.

4. Δηλώσεις από τον χώρο παραγωγής. Οι χειριστές καταγράφουν την εργασία τους στο SkyPlanner με τα Mobile Confirmations, Production Timer ή Quick Log Mode. Το SkyPlanner στέλνει τον χρόνο στο Fulcrum μέσω των /api/job-tracking-timers/start και /stop ή ως ολοκληρωμένο χρονικό διάστημα μέσω του /api/timers. Οι ποσότητες αποστέλλονται μέσω του add-quantity-completed και η τελική καταμέτρηση μαζί με τα απορριφθέντα τεμάχια μέσω του complete. Η κοστολόγηση εργασιών στο Fulcrum παραμένει ενημερωμένη.

5. Κανόνες ευθύνης και επίλυσης συγκρούσεων. Το εργαλείο χρονοπρογραμματισμού του Fulcrum “dictates the order of operations in Job Tracking.” (καθορίζει τη σειρά των φάσεων στο Job Tracking). Επιλέξτε λοιπόν ένα κανάλι ανάθεσης ανά φάση: την ουρά εργασιών χειριστή του SkyPlanner ή το Fulcrum Job Tracking. Καταγράψτε τους κανόνες πριν από την έναρξη της παραγωγικής λειτουργίας:

• Το προσωπικό συνυπολογίζεται μέσω του πλήθους του ανά βάρδια. Το Max Equipment ανά βάρδια στο Fulcrum “is usually determined by how many people you have working in a certain area at that time.” (συνήθως καθορίζεται από το πόσα άτομα εργάζονται σε έναν συγκεκριμένο χώρο εκείνη την ώρα). Στο SkyPlanner καταχωρίζονται οι χειριστές με το όνομά τους και ορίζονται οι βάρδιές τους. Τα ονόματα προέρχονται από τους χρήστες στο /api/users.
• Ο χρονοπρογραμματισμός γίνεται ανά εξοπλισμό. Τα κέντρα εργασίας του Fulcrum είναι ομάδες εξοπλισμού που μπορεί να χρησιμοποιηθεί εναλλακτικά. Διατηρείτε σωστές τις επιλογές εξοπλισμού στο φασεολόγιο, γιατί αυτές αποτελούν τις εναλλακτικές μεταξύ των οποίων επιλέγει ο μηχανισμός χρονοπρογραμματισμού.
• Οι εντολές παραγωγής ομαδοποιούν εργασίες. Μια εντολή παραγωγής ομαδοποιεί φάσεις από πολλές εργασίες, για παράδειγμα σε μια διάταξη κοπής. Όταν ξεκινά η χρονομέτρηση μιας ομαδοποιημένης φάσης, ξεκινά αντί γι’ αυτήν το χρονόμετρο της εντολής παραγωγής, το οποίο καλύπτει όλες τις φάσεις εργασιών της ομάδας.
• Όρια χρονομέτρησης. Τα χρονικά διαστήματα που καταχωρίζονται εκ των υστέρων μέσω του /api/timers “may not be in the future, older than 30 days, or longer than 7 days.” (δεν επιτρέπεται να αφορούν το μέλλον ή να υπερβαίνουν τα αναφερόμενα όρια παλαιότητας ή διάρκειας). Αποστέλλετε τις καταγραφές χρόνου μόλις τις καταχωρίζουν οι χειριστές.
• Οι μορφές χρόνου διαφέρουν. Οι βάρδιες χρησιμοποιούν τοπικές τιμές HHmm, οι χρόνοι διακοπής λειτουργίας και οι προγραμματισμένες ημερομηνίες είναι σε UTC, ενώ οι εκτιμώμενοι χρόνοι των φάσεων δίνονται σε δευτερόλεπτα.
• Οι ενημερώσεις εξοπλισμού αντικαθιστούν ολόκληρη την εγγραφή. Ένα αίτημα PUT για εξοπλισμό διαγράφει το περιεχόμενο κάθε πεδίου που παραλείπεται. Το SkyPlanner διαβάζει τα δεδομένα εξοπλισμού και δεν γράφει ποτέ σε αυτά.
• Εγκαταστάσεις ITAR. Χρησιμοποιήστε τον διακομιστή .us και ένα token ITAR.