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

Το MRPeasy είναι ένα ενιαίο προϊόν cloud, χωρίς εκδόσεις για τοπική εγκατάσταση. Έτσι, όλοι οι πελάτες χρησιμοποιούν το ίδιο API. Υπάρχουν δύο εκδόσεις:

1. Το REST API v1 (OpenAPI 1.0, διακομιστής https://api.mrpeasy.com/rest/v1) είναι το API που χρησιμοποιείται στην παραγωγική λειτουργία. Καλύπτει τα /items, /boms, /routings, /manufacturing-orders, /work-centers, /work-center-types, /customer-orders, /purchase-orders, /stock/inventory, /lots, /units και αναφορές παραγωγής όπως το /report/production/operations.
2. Το REST API v2 (OpenAPI 2.0.0, διακομιστής https://api.mrpeasy.com/rest/v2) βρίσκεται σε πρώιμο στάδιο ανάπτυξης. Προσθέτει το /workstation-groups με τα work_hours και holidays, το /workstations με τα productivity και idle, τα /inventory και /stock-movement, καθώς και τη μέθοδο PATCH. Οι εντολές παραγωγής παραμένουν στο v1.

Προσέξτε τις ονομασίες. Το Workstation group στο περιβάλλον χρήστη του MRPeasy αντιστοιχεί στο work-center-types του v1 (type_id). Το Workstation αντιστοιχεί στο work-centers (center_id). Οι φάσεις του φασεολογίου παραπέμπουν σε ομάδα μέσω του type_id, όχι σε μηχανή.

Το API περιλαμβάνεται στο πακέτο Unlimited του MRPeasy για λογαριασμούς επί πληρωμή. Το MRPeasy δηλώνει επίσης: “Our Support Department cannot help you using the API.” (Το τμήμα υποστήριξής μας δεν μπορεί να σας βοηθήσει στη χρήση του API.) Επομένως, κάποιος πρέπει να έχει την ευθύνη της διασύνδεσης: το SkyPlanner, ο σύμβουλός σας για το MRPeasy ή ο προγραμματιστής σας. Η ομάδα του SkyPlanner αναλαμβάνει ακριβώς αυτή την εργασία κατά την αρχική ένταξη.

Η σελίδα τιμολόγησης του MRPeasy αναφέρει “API, webhooks (for paid accounts)” (API, webhooks για λογαριασμούς επί πληρωμή), αλλά οι προδιαγραφές των v1 και v2 δεν τεκμηριώνουν συμβάντα webhook για εντολές παραγωγής. Γι’ αυτό, η διασύνδεση ανακτά τις αλλαγές από το MRPeasy με περιοδικά αιτήματα:

• Εντολές παραγωγής με φίλτρο στις καταστάσεις Not scheduled (15), Scheduled (20), In progress (30) και Paused (35).
• Εντολές αγοράς και αποθέματα σε τακτά διαστήματα ή πριν από κάθε εκτέλεση χρονοπρογραμματισμού.
• Βασικά δεδομένα όταν αλλάζουν ή κάθε βράδυ.

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

1. Αρχική φόρτωση βασικών δεδομένων. Ανακτήστε είδη, μονάδες, BOM και φασεολόγια από το v1, καθώς και ομάδες κέντρων εργασίας και κέντρα εργασίας από το v1 ή το v2. Αντλήστε τα ημερολόγια από το /workstation-groups του v2 (work_hours, holidays) ή ορίστε τις βάρδιες απευθείας στο SkyPlanner. Αντιστοιχίστε κάθε ομάδα Active processing σε μια ομάδα κέντρων εργασίας του SkyPlanner, με μέλη τα κέντρα εργασίας της.

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

3. Ενημέρωση του χρονοπρογράμματος στο MRPeasy. Το PUT /manufacturing-orders/{id} υποστηρίζει τα code, quantity, due_date και assigned_id, καθώς και προσαρμοσμένα πεδία με τη μορφή custom_<id>. Όπου έχει συμφωνηθεί, το SkyPlanner καταχωρίζει την προγραμματισμένη ολοκλήρωση στο due_date, ενώ καταχωρίζει την προγραμματισμένη έναρξη, την προγραμματισμένη ολοκλήρωση και την πρόοδο σε προσαρμοσμένα πεδία του MRPeasy. Έτσι, τα τμήματα πωλήσεων και αγορών βλέπουν στο MRPeasy το πραγματικό χρονοπρόγραμμα. Η αναλυτική ακολουθία των φάσεων και το κέντρο εργασίας κάθε φάσης τηρούνται στο SkyPlanner, όπου ο χώρος παραγωγής βλέπει τις αναθέσεις εργασιών.

4. Εντολές που δημιουργούνται εκτός MRPeasy. Αν δημιουργηθούν εντολές μέσω του API, το POST /manufacturing-orders δέχεται τα no_scheduling και no_bookings. Χρησιμοποιήστε τα ώστε το MRPeasy να μη δεσμεύει κέντρα εργασίας που χρονοπρογραμματίζει ήδη το SkyPlanner.

5. Επιβεβαιώσεις από τον χώρο παραγωγής. Οι χειριστές καταγράφουν την εργασία τους με τα SkyPlanner Mobile Confirmations, Production Timer ή Quick Log Mode και οι καταγραφές χρόνου διατηρούν το χρονοπρόγραμμα ενημερωμένο. Επιλέξτε ένα κανάλι καταγραφής. Η παράλληλη χρήση του Internet-kiosk του MRPeasy και του SkyPlanner για τις ίδιες φάσεις δημιουργεί δύο διαφορετικές εκδοχές της πραγματικότητας.

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

Ροή παραγωγής με σχεδιασμό κατά παραγγελία. Σε ένα έργο MRPeasy που έχει παραδοθεί, κάθε έργο πελάτη μετατρέπεται σε ένα κύριο προϊόν και ένα έως τρία ημιέτοιμα προϊόντα. Καθένα έχει το δικό του BOM και φασεολόγιο στο MRPeasy, ενώ η εντολή παραγωγής υπάρχει και στα δύο συστήματα. Διατηρείτε ένα σταθερό κοινό αναγνωριστικό σε κάθε εντολή, ώστε οι ενημερώσεις να μη δημιουργούν ποτέ διπλοεγγραφές.

• Τα πεδία χρόνου διαφέρουν ανά διεπαφή. Τα πεδία Setup time, Cycle time και Capacity του περιβάλλοντος χρήστη αντιστοιχούν στα fixed_time, variable_time και variable_quantity του API. Τιμή Capacity πάνω από 1 σημαίνει επεξεργασία σε παρτίδες, όπως σε έναν φούρνο. Αντιστοιχίστε την ως εργασία παρτίδας, όχι ως μεγαλύτερο χρόνο κύκλου.
• Passive processing groups. Οι ομάδες ξήρανσης και ψύξης λειτουργούν 24/7 χωρίς περιορισμούς δυναμικότητας. Αντιστοιχίστε τες ως χρόνους αναμονής, όχι ως κέντρα εργασίας με πεπερασμένη δυναμικότητα.
• Τα ημερολόγια απουσιάζουν από τη v1. Το work-centers επιστρέφει μόνο τα center_id, type_id, code και title. Χρησιμοποιήστε τη v2 ή διαχειριστείτε τις βάρδιες στο SkyPlanner.
• Χρόνος αδράνειας. Ο χρόνος αδράνειας του κέντρου εργασίας περιλαμβάνει τη συντήρηση και τις διακοπές λειτουργίας. Συγχρονίστε τον, διαφορετικά το SkyPlanner θα προγραμματίζει εργασίες σε μηχάνημα που βρίσκεται εκτός λειτουργίας.
• Τα φασεολόγια παραπέμπουν σε ομάδες. Το MRPeasy επιλέγει το μηχάνημα με την καλύτερη διαθεσιμότητα. Στο SkyPlanner, τα κέντρα εργασίας της ομάδας γίνονται πραγματικές εναλλακτικές επιλογές, ανάμεσα στις οποίες επιλέγει η μηχανή χρονοπρογραμματισμού.