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

Το Sylob τεκμηριώνει δύο δημόσια REST APIs: “L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (Το Sylob ERP διαθέτει δύο τύπους δημόσιων REST APIs, γνωστών και ως «webservices», που επιτρέπουν την ανάγνωση και την εγγραφή δεδομένων.) (Βάση γνώσεων Forterro)

1. API REST Système d’information (ανάγνωση). Εκτελεί ένα αποθηκευμένο ερώτημα (requête) που έχει δημιουργηθεί στη λειτουργία “Interroger le système d’information”. Το URL κλήσης του ερωτήματος παρέχεται από την επιλογή “Autres actions” > “Afficher le web service” και έχει τη μορφή /rest/query/{identifiantQuery}/resultat. Οι παράμετροι ορίζουν το όριο αποτελεσμάτων, τη μορφοποίηση αριθμών, τις μεταβλητές του ερωτήματος και τη δομή των αποτελεσμάτων. Τα αποτελέσματα επιστρέφονται από προεπιλογή σε XML ή σε JSON με την κεφαλίδα Accept: application/json. Αυτό το API περιλαμβάνεται στο ERP.
2. API REST Action (ανάγνωση και εγγραφή). Εκτελεί μια ενέργεια που έχει οριστεί στη λειτουργία “Gérer les actions web service”, τον κατάλογο ενεργειών του Sylob. Παρέχει δύο λειτουργίες: η GET /rest/v2/action/{code}/describe επιστρέφει το σχήμα δεδομένων μιας ενέργειας και η POST /rest/v2/action/{code}/execute την εκτελεί με σώμα αιτήματος JSON. Οι τύποι ενεργειών περιλαμβάνουν:

– Modification de données: αλλάζει ένα ή περισσότερα πεδία μιας εγγραφής μέσω του μηχανισμού γρήγορης επεξεργασίας του Sylob. Η Describe παραθέτει τα επεξεργάσιμα πεδία. – Message EDI: δημιουργεί, τροποποιεί ή διαγράφει εγγραφές μέσω μηνύματος EDI. – Scénario de saisie: εκτελεί ένα σενάριο καταχώρισης, ερώτηση προς ερώτηση. Το παράδειγμα του Sylob είναι το “Déclarer un début ou une fin”, για τη δήλωση έναρξης ή λήξης μιας φάσης (Sylob_Action_006). – Δημοσίευση, μεταφόρτωση και λήψη εγγράφων.

1. Μηνύματα EDI. Ο μηχανισμός EDI του Sylob διαχειρίζεται τις εξαγωγές και τις εισαγωγές. Το τυποποιημένο μήνυμα Sylob_Recup_Decl_Pro ανακτά δηλώσεις παραγωγής. (Forterro)
2. Αρχεία και ETL. Το Sylob ERP Cloud προσφέρει “Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (Διασύνδεση μέσω αρχείων με SFTP για εύκολη μεταφορά των υφιστάμενων διασυνδέσεων.) (Sylob) Τα αποτελέσματα των ερωτημάτων μπορούν επίσης να εξαχθούν σε Excel, που είναι ο γρήγορος τρόπος για να δοκιμάσετε το SkyPlanner.

Η δημόσια βάση γνώσεων του Sylob δεν τεκμηριώνει δυνατότητα εγγραφής σε εξερχόμενα webhooks. Οι αλλαγές φτάνουν στο SkyPlanner με περιοδική εκτέλεση αποθηκευμένων ερωτημάτων που φιλτράρουν τις ανοιχτές OF και τις πρόσφατες αλλαγές, με τη συχνότητα που ορίζετε εσείς.

Το Sylob προστατεύει το ERP από τον υπερβολικό φόρτο ερωτημάτων. Από την έκδοση 2025.Q2, η εταιρική παράμετρος “Protection des API” ενεργοποιεί τον περιορισμό ρυθμού κλήσεων ανά χρήστη και τη σελιδοποίηση μεγάλων συνόλων αποτελεσμάτων. Το Sylob ανακοινώνει ότι η εφαρμογή τους θα είναι συστηματική από την έκδοση 2026.Q2. Οι αποκρίσεις περιλαμβάνουν κεφαλίδες RateLimit, ενώ μια κλήση που υπερβαίνει το όριο επιστρέφει HTTP 429 Too Many Requests με τιμή Retry-After. (Forterro) Σχεδιάστε ανάλογα τον συγχρονισμό: ερωτήματα μόνο για τις αλλαγές, σελιδοποίηση και αναμονή πριν από νέα προσπάθεια σε απόκριση 429.

Στην άλλη κατεύθυνση, το SkyPlanner στέλνει webhooks όταν αλλάζει η κατάσταση ή το χρονοπρόγραμμα, οπότε η επανεγγραφή στο Sylob ενεργοποιείται από συμβάντα.

1. Αρχική φόρτωση βασικών δεδομένων. Δημιουργήστε ένα αποθηκευμένο ερώτημα ανά αντικείμενο (articles, nomenclatures, gammes, κέντρα εργασίας, εργαζόμενοι) και διαβάστε τα δεδομένα μέσω του Système d’information API ή φορτώστε τα μία φορά από εξαγωγή Excel. Αντιστοιχίστε προσεκτικά τα κέντρα εργασίας. Ένα centre de charge του Sylob είναι ομάδα πόρων. Επομένως, ένα κέντρο με τρεις μηχανές συνήθως αντιστοιχεί στο SkyPlanner σε μια ομάδα με τρία κέντρα εργασίας.

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

Χρονοπρογραμματίστε οριστικοποιημένες OF, όχι προτάσεις CBN. Οι προτάσεις αλλάζουν με την επόμενη εκτέλεση υπολογισμού καθαρών αναγκών.

3. Επανεγγραφή του χρονοπρογράμματος. Για κάθε φάση που τοποθέτησε ή μετακίνησε η μηχανή χρονοπρογραμματισμού, η διασύνδεση καλεί μια ενέργεια Modification de données στη φάση της OF (Opération d’ordre de fabrication), με την προγραμματισμένη έναρξη, την προγραμματισμένη λήξη και το κέντρο εργασίας. Η ενέργεια εκτελείται μέσω της λογικής γρήγορης επεξεργασίας του Sylob, όπως όταν ένας υπεύθυνος προγραμματισμού επεξεργάζεται τη φάση. Η Describe επιστρέφει τα επεξεργάσιμα πεδία, ώστε η διασύνδεση να επικυρώνει τα δεδομένα του αιτήματός της πριν από την πρώτη κλήση. Αν ένας χρήστης επεξεργάζεται ήδη την εγγραφή, η κλήση αποτυγχάνει όπως αναμένεται σε αυτή την περίπτωση· επαναλάβετε την προσπάθεια στην επόμενη αλλαγή.

4. Δηλώσεις από τον χώρο παραγωγής. Οι χειριστές καταγράφουν την εργασία τους με το SkyPlanner Mobile Confirmations ή το Production Timer. Η έναρξη και η λήξη επιστρέφουν μέσω του σεναρίου “Déclarer un début ou une fin”. Οι καταγραφές χρόνου και οι ποσότητες μετατρέπονται σε δηλώσεις παραγωγής στην ίδια φάση της OF: χρόνος προετοιμασίας, χρόνος εκτέλεσης, παραχθείσα ποσότητα, απορρίμματα και ολοκλήρωση φάσης. Αν το εργοστάσιό σας υποβάλλει ήδη δηλώσεις μέσω του Sylob Apps ή τερματικών στον χώρο παραγωγής, διατηρήστε ένα μόνο κανάλι δηλώσεων για να αποφύγετε τις διπλές καταχωρίσεις.

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

Το SkyPlanner δεν χρειάζεται το CADPLAN ούτε τις λειτουργίες προγραμματισμού πεπερασμένης δυναμικότητας του Sylob. Αναθέστε στο SkyPlanner τη διαχείριση των ημερομηνιών των φάσεων, γιατί όταν δύο συστήματα προγραμματισμού γράφουν τις ίδιες ημερομηνίες, το ένα αντικαθιστά τις τιμές του άλλου. Μόλις αναλάβει το SkyPlanner, το Autopilot αναπρογραμματίζει αυτόματα σε κάθε ουσιαστική αλλαγή και οι νέες ημερομηνίες επιστρέφουν στο Sylob.

• Άδεια χρήσης του Action API. Η ανάγνωση μέσω αποθηκευμένων ερωτημάτων περιλαμβάνεται. Η εγγραφή μέσω του καταλόγου ενεργειών απαιτεί το υποσύστημα “Webservice” του Sylob ή άδεια API στο MyForterro. Συνεννοηθείτε με τον υπεύθυνο επικοινωνίας σας στη Sylob πριν από τη φάση εγγραφής δεδομένων.
• Τα ερωτήματα αποτελούν το συμβόλαιο της διασύνδεσης. Η ανάγνωση βασίζεται σε αποθηκευμένα ερωτήματα. Δώστε τους σαφή ονόματα, περάστε τα φίλτρα ως μεταβλητά χαρακτηριστικά κατά την εκτέλεση και διαχειριστείτε τις εκδόσεις των ερωτημάτων μαζί με τις εκδόσεις της διασύνδεσης.
• Ομάδες κέντρων εργασίας. Ένα κέντρο εργασίας του Sylob μπορεί να περιλαμβάνει πολλές μηχανές. Αποφασίστε για κάθε κέντρο αν το SkyPlanner θα το βλέπει ως μία ομάδα κέντρων εργασίας ή ως μεμονωμένες μηχανές.
• Αντίστροφος χρονοπρογραμματισμός και υπολογισμοί φόρτου. Το Sylob προγραμματίζει προς τα πίσω από τις ημερομηνίες απαίτησης, ενώ ένας προγραμματισμένος υπολογισμός φόρτου μπορεί να αναπρογραμματίσει καθυστερημένες OF. Συμφωνήστε ποια λειτουργία, αν υπάρχει, θα συνεχίσει να γράφει ημερομηνίες φάσεων αφού αναλάβει τη διαχείρισή τους το SkyPlanner.
• Μονάδες χρόνου προετοιμασίας και εκτέλεσης. Πριν από την εισαγωγή, ελέγξτε τις μονάδες και αν η προετοιμασία υπολογίζεται ανά OF ή ανά τεμάχιο. Οι λανθασμένες μονάδες αλλοιώνουν κάθε διάρκεια.
• Ημερολόγια. Τα εβδομαδιαία ωράρια και οι εξαιρέσεις των κέντρων εργασίας πρέπει να καλύπτουν όλο τον ορίζοντα χρονοπρογραμματισμού, διαφορετικά η δυναμικότητα χάνεται από το πρόγραμμα.
• Περιορισμός κλήσεων. Το Sylob περιορίζει τις κλήσεις ανά χρήστη και επιστρέφει τα μεγάλα σύνολα αποτελεσμάτων σε σελίδες. Ο περιοδικός έλεγχος μόνο για αλλαγές διατηρεί τις κλήσεις πολύ κάτω από το όριο.
• CORS και προγράμματα περιήγησης. Οι κλήσεις μεταξύ διακομιστών αποφεύγουν τους περιορισμούς CORS. Για εφαρμογές που εκτελούνται σε πρόγραμμα περιήγησης, πρέπει να ρυθμιστούν οι επιτρεπόμενες προελεύσεις στην πλευρά του Sylob.