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

Το monday.com διαθέτει ένα GraphQL API στο POST https://api.monday.com/v2. Νέες εκδόσεις κυκλοφορούν κάθε τρίμηνο και ορίζετε σταθερή έκδοση μέσω της κεφαλίδας API-Version. Η απόσυρση λειτουργιών ανακοινώνεται τουλάχιστον έξι μήνες νωρίτερα. (Εκδόσεις API)

Μια διασύνδεση για χρονοπρογραμματισμό χρησιμοποιεί τα εξής αντικείμενα:

• Boards και groups, που συχνά χρησιμοποιούνται για στάδια ή εβδομάδες.
• Items και subitems. Ένα item αντιστοιχεί συνήθως σε παραγγελία ή εργασία, ενώ τα subitems περιέχουν τις φάσεις.
• Τιμές στηλών: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards και Mirror.
• Webhooks για συμβάντα αλλαγών.

Για την ανάγνωση χρησιμοποιείται το items_page μέσα σε ένα board ή group. Κάθε σελίδα περιέχει από προεπιλογή 25 στοιχεία και “the maximum is 500.” (αυτό είναι το ανώτατο όριο). Συνεχίζετε με το next_items_page, ενώ “each cursor will expire 60 minutes after the first request.” (κάθε cursor λήγει μετά το αναφερόμενο διάστημα από το πρώτο αίτημα). Χρησιμοποιήστε το query_params ως φίλτρο για να διαβάζετε μόνο τις ανοικτές παραγγελίες. (items_page)

Για την εγγραφή χρησιμοποιούνται τα create_item, create_subitem, change_column_value και change_multiple_column_values. Το τελευταίο ενημερώνει πολλές στήλες ενός στοιχείου με μία κλήση, όπως χρειάζεται για την εγγραφή του χρονοπρογράμματος στο monday.com.

Για μεγάλους όγκους δεδομένων, από την έκδοση API 2026-07 και μετά προστίθενται τα ingest_items και backfill_items. Ανεβάζετε ένα CSV σε ένα προϋπογεγραμμένο URL και ελέγχετε περιοδικά την κατάσταση της εργασίας εισαγωγής. (Μαζική εισαγωγή)

Δημιουργήστε μια συνδρομή με το create_webhook(board_id, url, event, config). Μια διασύνδεση για χρονοπρογραμματισμό χρειάζεται τα εξής συμβάντα:

• create_item και create_subitem για νέες παραγγελίες και φάσεις.
• change_column_value ή change_specific_column_value για αλλαγές στην προθεσμία παράδοσης, την ποσότητα ή την προτεραιότητα.
• change_status_column_value για αλλαγές κατάστασης που πραγματοποιούν οι χρήστες.
• item_archived, item_deleted και item_moved_to_specific_group για ακυρωμένες ή ολοκληρωμένες παραγγελίες.

Κατά τη δημιουργία του webhook, το URL παραλαβής πρέπει να απαντήσει σε ένα challenge token. Για τις αποτυχημένες παραδόσεις ισχύει το “retry once a minute for 30 minutes,” (επανάληψη ανά λεπτό για το αναφερόμενο διάστημα) και στη συνέχεια οι επαναπροσπάθειες σταματούν. Γι’ αυτό η διασύνδεση εκτελεί και περιοδική ανάγνωση για έλεγχο συμφωνίας των δεδομένων, με το items_page και φίλτρο για τα στοιχεία που ενημερώθηκαν πρόσφατα. (Webhooks)

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

1. Αρχική φόρτωση βασικών δεδομένων. Διαβάστε προϊόντα, υλικά και ανοικτές παραγγελίες με το items_page. Δημιουργήστε κέντρα εργασίας, βάρδιες και περιορισμούς στο SkyPlanner ή εισαγάγετέ τα από το Excel. Αποφασίστε από νωρίς αν οι φάσεις θα τηρούνται ως subitems ή σε συνδεδεμένο πίνακα.

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

3. Εγγραφή χρονοπρογράμματος στο monday.com. Για κάθε παραγγελία που η μηχανή χρονοπρογραμματισμού τοποθέτησε ή μετακίνησε, η διασύνδεση καλεί το change_multiple_column_values. Καταχωρίζει την προγραμματισμένη έναρξη και λήξη στη στήλη Timeline και συμπληρώνει τη στήλη του κέντρου εργασίας. Με μία κλήση ανά στοιχείο, ο αριθμός των αιτημάτων παραμένει χαμηλός.

4. Πρόοδος στον χώρο παραγωγής. Οι χειριστές καταγράφουν την εργασία τους με το Mobile Confirmations, το Production Timer ή το Quick Log Mode. Οι καταγραφές χρόνου διατηρούν το χρονοπρόγραμμα ενημερωμένο και η αντίστοιχη ετικέτα Status μεταφέρεται στον πίνακα. Έτσι, το τμήμα πωλήσεων βλέπει την πρόοδο χωρίς να χρειάζεται να ρωτήσει.

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

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

• Κάθε λογαριασμός οργανώνει τις παραγγελίες διαφορετικά. Ένας πίνακας ανά πελάτη, φάσεις ως items ή subitems, μηχανές ως στήλες People ή Status. Αντιστοιχίστε τα ID των στηλών ανά λογαριασμό, ποτέ με βάση τον τίτλο της στήλης.
• Όρια πακέτων. Τα Free, Basic και Standard επιτρέπουν 1.000 κλήσεις API την ημέρα, το Pro 10.000 και το Enterprise 25.000. Χρησιμοποιήστε webhooks για τις αλλαγές και καταχωρίστε μαζικά τα αποτελέσματα στο monday.com με το change_multiple_column_values. (όρια ρυθμού κλήσεων)
• Υπάρχει όριο στους συνδεδεμένους πίνακες. Το Basic επιτρέπει μία σύνδεση πίνακα και το Standard πέντε, περιορίζοντας έτσι τους συνδεδεμένους πίνακες φάσεων ή προϊόντων. (όρια του Connect Boards)
• Ορίστε σταθερή έκδοση API. Οι εκδόσεις αλλάζουν ανά τρίμηνο. Πριν από την έκδοση 2026-04, το προεπιλεγμένο ερώτημα boards δεν περιλάμβανε πίνακες πολλαπλών επιπέδων.
• Λήξη του cursor. Ο cursor του items_page ισχύει για 60 λεπτά. Οι έλεγχοι συμφωνίας δεδομένων μεγάλης διάρκειας πρέπει να μπορούν να ξεκινούν ξανά από την αρχή χωρίς προβλήματα.
• Όρια των webhook. Το URL μπορεί να έχει έως 255 χαρακτήρες και οι επαναπροσπάθειες σταματούν μετά από 30 λεπτά. Ο παραλήπτης πρέπει να είναι ιδιοδύναμος.
• Μονάδες και διάρκειες. Οι στήλες Numbers δεν περιλαμβάνουν μονάδα μέτρησης. Συμφωνήστε αν η διάρκεια θα εκφράζεται σε λεπτά ή ώρες πριν από την πρώτη εισαγωγή.