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

Το API διασύνδεσης του Lemonsoft είναι το LemonRest, με τεκμηρίωση Swagger 2.0, έκδοση v1. Το build “LemonRest 2026.10 release-2026.10.2” περιλαμβάνει 422 διαδρομές. (Swagger)

• Η βασική διεύθυνση URL διαφέρει ανά περιβάλλον. Θα τη βρείτε στη διαχείριση χρηστών, στην ενότητα διαχείρισης περιβαλλόντων και διευθύνσεων υπηρεσιών, στο πεδίο Rest API. Στην πλατφόρμα Azure του Lemonsoft, η βασική διεύθυνση είναι https://rest.lemon.fi.
• Διαθεσιμότητα. Για τους πελάτες της υπηρεσίας πλατφόρμας του Lemonsoft (Alustapalvelu), τα REST API είναι προεγκατεστημένα και απαιτούν μόνο δικαιώματα χρήστη. (πηγή)
• Περιβάλλον δοκιμών. Ο τελικός πελάτης το παραγγέλνει από το Lemonsoft Service Desk.

Το ξεχωριστό API καταγραφής χρόνου Kellokortti δεν χρειάζεται για τον χρονοπρογραμματισμό.

Το LemonRest δεν διαθέτει endpoints για webhooks ή συνδρομές. Οι αλλαγές ανακτώνται με ερώτημα μεταβολών:

• Η κλήση GET /api/production/main_ws/changed?updated_after=... επιστρέφει τις εργασίες που άλλαξαν από την τελευταία εκτέλεση.
• Προσθέστε το optimization=true. Προστέθηκε στην έκδοση 2026.6.3 για να καταργήσει την εξάρτηση από το αρχείο καταγραφής και να επιταχύνει το ερώτημα. (σημειώσεις έκδοσης)
• Η κλήση GET /api/log/deletion_events εντοπίζει τις διαγραμμένες εργασίες, ώστε όσες έχουν ακυρωθεί να αφαιρούνται από το χρονοπρόγραμμα.

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

1. Αρχική φόρτωση βασικών δεδομένων. Ανακτήστε τις μηχανές και τις ομάδες μηχανών, τις δομές προϊόντων με τις φάσεις εργασιών τους και τις τυποποιημένες φάσεις εργασίας. Αντιστοιχίστε κάθε επιμέρους μηχανή σε ένα κέντρο εργασίας του SkyPlanner. Χρησιμοποιήστε τις γονικές μηχανές (Isäkone) μόνο για ομαδοποίηση, επειδή αθροίζουν τη δυναμικότητα των θυγατρικών τους.

2. Συγχρονισμός αριθμών εργασιών. Ανακτήστε τους ανοιχτούς αριθμούς εργασιών μαζί με τις φάσεις τους από το /api/production/workstage ή το main_ws/sub_ws, με φιλτράρισμα βάσει κατάστασης και σελιδοποίηση. Στη συνέχεια, διατηρείτε τα δεδομένα ενημερωμένα με το main_ws/changed. Αντιστοιχίστε το work_amount_left και όχι το work_amount, επειδή το Lemonsoft χρονοπρογραμματίζει με βάση την υπολειπόμενη ποσότητα. Οι εντολές αγοράς τροφοδοτούν τον χρονοπρογραμματισμό του SkyPlanner που βασίζεται στα υλικά, οπότε η φάση αναμένει την ημερομηνία παράδοσης της εντολής αγοράς.

3. Εγγραφή του χρονοπρογράμματος πίσω στο Lemonsoft. Για κάθε φάση που τοποθετεί ή μετακινεί η μηχανή χρονοπρογραμματισμού, το SkyPlanner στέλνει PUT /api/production/workstage με την εργασία και τα sub_workstages της. Κάθε φάση περιλαμβάνει τα start_time και end_time, καθώς και το machine_id όταν έχει μεταφερθεί σε εναλλακτική μηχανή.

4. Επιβεβαιώσεις από την παραγωγή. Οι χειριστές επιβεβαιώνουν τις εργασίες με το SkyPlanner Mobile Confirmations ή το Production Timer. Κάθε επιβεβαίωση αποστέλλεται στο completion_entry με τα sub_workstage_id, person_number, done_amount, hours, failed_amount και job_done. Όταν η φάση καταναλώνει υλικό, στείλτε μαζί και το material_consumptions. Το Lemonsoft καταχωρίζει τότε μια κανονική εγγραφή ολοκλήρωσης παραγωγής (valmistuskirjaus).

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

Η κύρια αιτία συγκρούσεων είναι ο αυτόματος χρονοπρογραμματισμός του Lemonsoft και η ενέργεια ανανέωσης: και τα δύο επανατοποθετούν τις μη κλειδωμένες φάσεις. Διατηρείτε το AUTOTIMING στο 0 όσο το SkyPlanner είναι υπεύθυνο για το χρονοπρόγραμμα. Αν το αφήσετε ενεργό, εφαρμόστε το κλείδωμα χρονοπρογράμματος σε κάθε αριθμό εργασίας στον οποίο γίνεται εγγραφή· έτσι σταθεροποιούνται όλες οι φάσεις του συγκεκριμένου αριθμού. Το Koneiden kapasiteetin lukitus από μόνο του δεν αρκεί, επειδή ο αυτόματος χρονοπρογραμματισμός μετακινεί τις μη κλειδωμένες εργασίες εκτός μιας κλειδωμένης ημέρας. (πηγή)

• Ένα μηχάνημα ανά στάδιο. Κάθε στάδιο στο Lemonsoft αντιστοιχεί σε ένα μηχάνημα. Κατά την αρχική παραμετροποίηση, τα κατάλληλα μηχανήματα για κάθε προϊόν ορίζονται από μια λίστα ή από τις ιδιότητες του προϊόντος. Στη συνέχεια, το SkyPlanner επιλέγει μεταξύ των εναλλακτικών.
• Ημερήσια δυναμικότητα. Η σταθερή δυναμικότητα εκφράζεται ως ημερήσια ποσότητα και οι αποκλίσεις δεν έχουν συγκεκριμένη ώρα. Αποτυπώστε τις πραγματικές βάρδιες στο SkyPlanner ή αντλήστε τις προγραμματισμένες βάρδιες.
• Υπολειπόμενη ποσότητα. Αντιστοιχίστε το work_amount_left. Οι ρυθμίσεις STARTJOB_AUTOTIMENOW και JOBDONE_AUTOTIMENOW μετακινούν επίσης το φορτίο στο ίδιο το Lemonsoft.
• Οι συνεδρίες λήγουν. Ανανεώστε τη συνεδρία πριν από συγχρονισμούς μεγάλης διάρκειας και προβλέψτε χειρισμό για την υποχρεωτική επανασύνδεση.
• Κανόνες επιβεβαίωσης. Ελέγξτε κάθε επιβεβαίωση με βάση την κατάσταση του σταδίου πριν από την καταχώριση και ρυθμίστε τον ρυθμό αποστολής των μαζικών κλήσεων.
• Δύο εφαρμογές πελάτη. Το LemonOnline και η έκδοση για Windows χρησιμοποιούν την ίδια βάση δεδομένων, οπότε η διασύνδεση εξυπηρετεί και τις δύο.
• Μεγάλες δομές προϊόντων. Για μεγάλες εισαγωγές δεδομένων, χρησιμοποιήστε το /api/async/product/structure μαζί με το /api/async/status/{jobId}.