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

Η διασύνδεση βασίζεται σε δύο διεπαφές που διαθέτει ήδη το Business Central:

1. API v2.0 για εμπορικά δεδομένα και δεδομένα αποθεμάτων. Παρέχει πρόσβαση στα items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers και employees. Δεν περιλαμβάνει οντότητες παραγωγής, οπότε τα δεδομένα παραγωγής αντλούνται μέσω της δεύτερης διεπαφής.
2. Υπηρεσίες web OData v4 για την παραγωγή. Οποιαδήποτε σελίδα του Business Central μπορεί να δημοσιευτεί ως υπηρεσία web OData v4 από τη σελίδα Web Services. Επιλέξτε τύπο αντικειμένου Page, το αναγνωριστικό της σελίδας και ένα όνομα υπηρεσίας και, στη συνέχεια, ενεργοποιήστε την επιλογή Published. Το endpoint είναι πλέον ενεργό, χωρίς κώδικα AL και χωρίς να χρειάζεται εγκατάσταση επέκτασης. Για τη διασύνδεση δημοσιεύονται οι τυπικές σελίδες για τις αποδεσμευμένες εντολές παραγωγής, τις Prod. Order Routing Lines, τα κέντρα εργασίας, τα κέντρα μηχανών και τα φασεολόγια, οι οποίες είναι διαθέσιμες στη διαδρομή /ODataV4/Company('{name}')/{ServiceName}.

Οι δημοσιευμένες σελίδες επιτρέπουν ανάγνωση και εγγραφή. Η Microsoft αναφέρει: “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,” (αν μια επεξεργάσιμη σελίδα εκτεθεί ως υπηρεσία ιστού, τα δεδομένα του υποκείμενου πίνακα μπορούν να διαβαστούν και να τροποποιηθούν με κλήση OData), με PATCH για τις ενημερώσεις. Έτσι επιστρέφουν οι προγραμματισμένες ημερομηνίες στο Business Central, μέσω της ίδιας σελίδας και με τους ίδιους ελέγχους εγκυρότητας που χρησιμοποιεί ο υπεύθυνος προγραμματισμού.

Αποφύγετε το SOAP. Η Microsoft έχει χαρακτηρίσει τις υπηρεσίες ιστού SOAP ως παρωχημένες και η δυνατότητα δημοσίευσης σελίδων του περιβάλλοντος χρήστη της Microsoft ως SOAP καταργείται στο 2026 release wave 2 (v29).

Το Business Central υποστηρίζει συνδρομές webhook μέσω του POST /api/v2.0/subscriptions για οντότητες του API v2.0, όπως τα items και salesOrders. Ισχύουν οι εξής κανόνες:

• Η δημιουργία συνδρομής απαιτεί handshake: το endpoint σας πρέπει να επιστρέψει το validationToken με 200 OK.
• Οι συνδρομές λήγουν μετά από τρεις ημέρες. Ανανεώστε τις με PATCH και η διαδικασία χειραψίας εκτελείται ξανά.
• Οι ειδοποιήσεις περιλαμβάνουν τη διαδρομή του πόρου, το changeType και το δικό σας clientState, όχι ολόκληρη την εγγραφή. Την εγγραφή την ανακτάτε στη συνέχεια.
• Οι ειδοποιήσεις αποστέλλονται με καθυστέρηση: το Business Central online περιμένει 30 δευτερόλεπτα μετά την πρώτη αλλαγή. Αν μέσα σε αυτό το διάστημα αλλάξουν περισσότερες από 1.000 εγγραφές, αποστέλλεται μία ειδοποίηση collection.
• Επιτρέπονται έως 200 συνδρομές webhook ανά περιβάλλον online.

Οι εντολές παραγωγής, οι γραμμές φασεολογίου και οι παραγγελίες αγοράς ανακτώνται με περιοδικά ερωτήματα ανά λίγα λεπτά στις δημοσιευμένες σελίδες και στο purchaseOrders. Με φιλτράρισμα μόνο για ανοιχτές εντολές και παραγγελίες και με σελιδοποίηση, ο αριθμός των αιτημάτων παραμένει πολύ κάτω από τα όρια του Business Central.

Το SkyPlanner στέλνει webhooks όταν αλλάζει η κατάσταση ή το χρονοπρόγραμμα, οπότε η εγγραφή δεδομένων πίσω στο Business Central ενεργοποιείται από συμβάντα.

1. Αρχική φόρτωση βασικών δεδομένων. Αντλήστε φασεολόγια και BOM παραγωγής με κατάσταση Certified, καθώς και κέντρα εργασίας και κέντρα μηχανών, από τις δημοσιευμένες σελίδες. Αντλήστε είδη και μονάδες μέτρησης από το API v2.0. Αντιστοιχίστε κάθε κέντρο εργασίας ή κέντρο μηχανής σε κέντρο εργασίας του SkyPlanner με σαφή κριτήρια: αποφασίστε αν ένα κέντρο εργασίας με τρία κέντρα μηχανών θα γίνει μία ομάδα κέντρων εργασίας ή τρία κέντρα εργασίας.

2. Συγχρονισμός εντολών. Διαβάστε από τις δημοσιευμένες σελίδες τις εντολές παραγωγής με κατάσταση Released (και Firm Planned, αν τις εντάσσετε στο χρονοπρόγραμμα), μαζί με τις γραμμές φασεολογίου και τα συστατικά τους. Από το API v2.0 διαβάστε επίσης τις ανοιχτές γραμμές παραγγελιών αγορών. Το SkyPlanner θεωρεί τα παραγγελθέντα υλικά διαθέσιμα κατά την ημερομηνία παράδοσης της παραγγελίας αγοράς και ενημερώνει το απόθεμα όταν η παραγγελία επισημανθεί ως Delivered. Έτσι, ο χρονοπρογραμματισμός ελέγχει τόσο το απόθεμα όσο και τις αναμενόμενες αγορές.

Μην εντάσσετε ποτέ στο χρονοπρόγραμμα εντολές παραγωγής με κατάσταση Planned: η Microsoft αναφέρει ότι το Business Central “deletes them the next time you run planning.” (τις διαγράφει την επόμενη φορά που εκτελείτε τον προγραμματισμό). Το Planning Worksheet συνεχίζει να προτείνει κάλυψη των αναγκών και το SkyPlanner χρονοπρογραμματίζει τις οριστικοποιημένες εντολές με βάση την πραγματική δυναμικότητα.

3. Εγγραφή του προγράμματος στο Business Central. Η τυπική σελίδα Prod. Order Routing δημοσιεύεται ως υπηρεσία web OData v4. Για κάθε φάση που τοποθέτησε ή μετακίνησε η μηχανή χρονοπρογραμματισμού, το SkyPlanner στέλνει ένα PATCH στην αντίστοιχη γραμμή φασεολογίου με το ETag If-Match. Ορίζει τα Starting Date-Time και Ending Date-Time, καθώς και τα Type και No. όταν η φάση έχει μεταφερθεί σε εναλλακτική μηχανή.

Το PATCH εκτελεί τα triggers της σελίδας και του πίνακα, επομένως το Business Central ελέγχει την εγκυρότητα των πεδίων με τη δική του λογική, ακριβώς όπως όταν ο υπεύθυνος προγραμματισμού επεξεργάζεται τη σελίδα Prod. Order Routing. Τα Starting και Ending Date-Time της γραμμής εντολής παραγωγής ενημερώνονται αντίστοιχα. Οι ποσότητες, η κατάσταση και το κόστος παραμένουν υπό τον έλεγχο του Business Central.

4. Δηλώσεις από το εργοστάσιο. Οι χειριστές καταγράφουν την εργασία τους με το SkyPlanner Mobile Confirmations ή το Production Timer και οι καταγραφές χρόνου διατηρούν το χρονοπρόγραμμα ενημερωμένο. Η παραγόμενη ποσότητα μπορεί να δηλώνεται στο Business Central όπως και πριν, από το Production Journal ή το Output Journal.

Αν θέλετε πλήρως αυτόματη καταχώριση της παραγόμενης ποσότητας και της κατανάλωσης, προστίθεται μια τυπική σελίδα API του Business Central για καταχώριση μέσω του Output Journal. Το SkyPlanner καταχωρίζει τότε τον χρόνο προετοιμασίας, τον χρόνο εκτέλεσης και την παραγόμενη ποσότητα ανά φάση. Η καταχώριση ενημερώνει τις Capacity Ledger Entries και η δήλωση παραγωγής στην τελευταία φάση του φασεολογίου προσθέτει το είδος στο απόθεμα.

Επιλέξτε ένα μόνο κανάλι για την καταχώριση της παραγόμενης ποσότητας. Η καταχώριση τόσο από το SkyPlanner όσο και από το Production Journal του Business Central δημιουργεί διπλές εγγραφές.

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

Η κύρια πηγή συγκρούσεων είναι οι ενέργειες Refresh και Replan στις εντολές παραγωγής. Η Microsoft αναφέρει: “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.” (Αν χρησιμοποιήσετε την ενέργεια Refresh για να επανυπολογίσετε τις γραμμές εντολής παραγωγής, το Business Central διαγράφει τις υπάρχουσες γραμμές και υπολογίζει νέες.) Το Replan μπορεί επίσης να αλλάξει την απαιτούμενη δυναμικότητα, ενώ ο επανυπολογισμός των συστατικών “deletes previous changes in the components.” (διαγράφει τις προηγούμενες αλλαγές στα συστατικά).

Αντιμετωπίστε μια εντολή στην οποία εκτελέστηκε Refresh ως νέα έκδοση, συγχρονίστε την ξανά και αφήστε το SkyPlanner να την επαναχρονοπρογραμματίσει. Με το Autopilot, το SkyPlanner επαναχρονοπρογραμματίζει αυτόματα όταν αλλάζει η παραγωγή.

• Μονάδες στα φασεολόγια. Το Setup Time υπολογίζεται ανά εντολή παραγωγής και το Run Time ανά παραγόμενη μονάδα. Το καθένα έχει δικό του Unit of Measure Code. Τα Wait Time και Move Time δεν δεσμεύουν δυναμικότητα του κέντρου εργασίας. Αν η μονάδα του κέντρου εργασίας είναι Days, μία ημέρα αντιστοιχεί σε 24 ώρες, όχι σε οκτάωρη βάρδια. Κάντε μετατροπή κατά την εισαγωγή, διαφορετικά όλες οι διάρκειες θα είναι λανθασμένες.
• Μη ενημερωμένα ημερολόγια. Η δυναμικότητα υπάρχει μόνο αφού εκτελεστεί το Calculate Work Center Calendar για τον χρονικό ορίζοντα προγραμματισμού. Ελέγξτε το πεδίο Calendar Entries Available Until πριν από την αρχική φόρτωση.
• Κρυμμένη δυναμικότητα κέντρων μηχανών. Όταν το Consolidated Calendar είναι απενεργοποιημένο, προγραμματίζεται μόνο η δυναμικότητα του ίδιου του κέντρου εργασίας: “The machine center capacity is excluded.” (Η δυναμικότητα του κέντρου μηχανής εξαιρείται.) Διαβάστε τη δυναμικότητα των κέντρων μηχανών απευθείας, αντί να βασίζεστε στα σύνολα του κέντρου εργασίας.
• Capacity και Efficiency. Το Business Central υπολογίζει τη διάρκεια ως Run Time / Efficiency / Capacity και οι υπολογισμένες εγγραφές ημερολογίου περιλαμβάνουν ήδη και τους δύο παράγοντες. Αντιστοιχίστε το Efficiency στην αποδοτικότητα του κέντρου εργασίας του SkyPlanner μία φορά, όχι δύο.
• Το Alternate Work Center είναι μόνο πληροφοριακό. Η Microsoft αναφέρει ότι “isn’t automatically included in planning processes.” (δεν περιλαμβάνεται αυτόματα στις διαδικασίες προγραμματισμού). Μοντελοποιήστε ρητά τις εναλλακτικές επιλογές ως εναλλακτικά κέντρα εργασίας στο SkyPlanner.
• Περιορισμός ρυθμού αιτημάτων. Στο online περιβάλλον, τα όρια ισχύουν ανά χρήστη και κάθε service principal υπολογίζεται ως ένας χρήστης: 6.000 αιτήματα OData σε κυλιόμενο παράθυρο 5 λεπτών και 5 ταυτόχρονα αιτήματα. Το μέγεθος σελίδας περιορίζεται στις 20.000 εγγραφές, κάθε $batch στις 100 πράξεις και το χρονικό όριο εκτέλεσης μιας πράξης είναι 8 λεπτά. Η υπέρβαση του ρυθμού επιστρέφει 429. Χρησιμοποιήστε ομαδοποίηση αιτημάτων, σελιδοποίηση και περιοδική ανάκτηση μόνο των αλλαγών αντί για πλήρη επαναφόρτωση.
• Άδειες χρήσης. Οι λειτουργίες παραγωγής διατίθενται μόνο στην εμπειρία χρήσης Premium. Οι χρήστες με Essentials δεν μπορούν να συνδεθούν σε εταιρεία που έχει ρυθμιστεί σε Premium.