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

• Visma Net ERP API. REST με προδιαγραφή OpenAPI που εξακολουθεί να έχει τον τίτλο “Visma.net ERP API v1” και διαδρομές v1 και v2. Το βασικό URL είναι https://api.finance.visma.net. Από την 1 Φεβρουαρίου 2026 περιορίζεται ο ρυθμός κλήσεων στο παλιό domain integration.visma.net, το οποίο αποσύρεται (ανακοίνωση).
• SalesOrder service v3 στο https://salesorder.visma.net. Τα endpoints v1 και v2 για παραγγελίες πώλησης έχουν φτάσει στο τέλος του κύκλου ζωής τους.
• Webhooks μέσω του Visma Developer Portal.
• Background API. Με την κεφαλίδα erp-api-background, οι χρονοβόρες κλήσεις μπαίνουν σε ουρά, επιστρέφεται κωδικός 202 με αναγνωριστικό εργασίας και λαμβάνετε ειδοποίηση όταν το αποτέλεσμα είναι έτοιμο.
• Σενάρια εισαγωγής και εξαγωγής στο Visma Net, με παρόχους δεδομένων CSV, Excel ή SQL, για εφάπαξ φόρτωση βασικών δεδομένων.

Το API δεν διαθέτει endpoints για εντολές παραγωγής, φασεολόγια ή κέντρα εργασίας, επειδή το Visma Net δεν διαθέτει τέτοια αντικείμενα. Τα δεδομένα για τον χρονοπρογραμματισμό προέρχονται από τα είδη, τα κιτ, τις παραγγελίες και τα αποθέματα:

• GET /v1/inventory: είδη αποθήκης και είδη εκτός αποθήκης, μαζί με την ένδειξη κιτ και την κατηγορία είδους
• GET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: γραμμές συστατικών ανά αναθεώρηση
• GET /v1/kitassembly: υφιστάμενες συναρμολογήσεις, με δυνατότητα φιλτραρίσματος κατά τύπο και κατάσταση
• SalesOrder service v3: ζήτηση με τις ζητούμενες ημερομηνίες και τις γραμμές παραγγελίας
• GET /v1/inventorysummary/{inventoryNumber}: φυσικό και διαθέσιμο απόθεμα ανά αποθήκη
• GET /v1/purchaseorder και GET /v2/PurchaseReceipt: αναμενόμενα υλικά και παραλαβές

Όλα τα endpoints λιστών δέχονται lastModifiedDateTime με lastModifiedDateTimeCondition, καθώς και pageNumber και pageSize, ώστε κάθε συγχρονισμός να μπορεί να μεταφέρει μόνο τις αλλαγές.

Τα webhooks του Visma Developer Portal καλύπτουν τα συμβάντα που έχουν σημασία για τον χρονοπρογραμματισμό:

• Inventory Item Created, Updated and Changed
• Purchase Order Changed and Status Changed
• Sales Order Changed and Status Changed, που μεταφέρονται στον publisher SalesOrderService

Δεν υπάρχουν συμβάντα για τα Kit assembly ή Kit specifications. Το SkyPlanner τα ανακτά περιοδικά με φίλτρα lastModifiedDateTime. Τα υπόλοιπα αποθεμάτων ανακτώνται σε κάθε εκτέλεση του χρονοπρογραμματισμού. Στην αντίστροφη κατεύθυνση, το SkyPlanner στέλνει webhooks όταν αλλάζει η κατάσταση ή το χρονοπρόγραμμα.

1. Αρχική φόρτωση βασικών δεδομένων. Ανακτήστε τα είδη αποθήκης, τις κατηγορίες ειδών και την τελευταία αναθεώρηση του Kit specification για κάθε κιτ. Αντιστοιχίστε κάθε γραμμή συστατικού σε ένα υλικό του SkyPlanner. Στη συνέχεια δημιουργήστε όσα δεν τηρούνται στο Visma Net: κέντρα εργασίας, βάρδιες, φάσεις παραγωγής με χρόνους προετοιμασίας και εκτέλεσης, τον πίνακα χρόνων προετοιμασίας και τις απαιτήσεις εργαλείων. Εισαγάγετέ τα μέσω CSV ή Excel. Αυτό είναι το μεγαλύτερο μέρος του έργου.

2. Συγχρονισμός παραγγελιών. Επιλέξτε ένα μοντέλο ζήτησης:

• Με βάση τις παραγγελίες πώλησης. Οι ανοιχτές γραμμές παραγγελιών πώλησης για είδη κιτ μετατρέπονται σε παραγγελίες στο SkyPlanner, με τη ζητούμενη ημερομηνία ως προθεσμία παράδοσης.
• Με βάση τις συναρμολογήσεις. Τα Kit assemblies που δημιουργούνται στο Visma Net σε κατάσταση On hold μετατρέπονται σε εργασίες στο SkyPlanner.

Οι ανοιχτές παραγγελίες αγοράς εισάγονται μαζί με τις ημερομηνίες τους. Το SkyPlanner θεωρεί το παραγγελθέν υλικό διαθέσιμο την ημερομηνία παράδοσης της παραγγελίας αγοράς και ενημερώνει το απόθεμα όταν η παραγγελία επισημανθεί ως Delivered. Χρησιμοποιώντας και τη σύνοψη αποθεμάτων, ο χρονοπρογραμματισμός ελέγχει τόσο το απόθεμα όσο και τις αναμενόμενες αγορές.

3. Εγγραφή του χρονοπρογράμματος στο Visma Net. Όταν η διαμόρφωση βασίζεται στις παραγγελίες πώλησης, το SkyPlanner δημιουργεί ένα Kit assembly τύπου Production για κάθε προγραμματισμένη εργασία. Ορίζει το είδος κιτ, την αναθεώρηση, την αποθήκη, την ποσότητα και τα συστατικά και συνδέει τη συναρμολόγηση με τη γραμμή της παραγγελίας πώλησης. Η ημερομηνία της συναρμολόγησης είναι η προγραμματισμένη ημερομηνία ολοκλήρωσης. Όταν το Autopilot μετακινεί την εργασία, μια κλήση PUT ενημερώνει την ημερομηνία πριν από την οριστικοποίηση.

Το Kit assembly έχει ένα πεδίο Date, οπότε οι χρόνοι ανά φάση παραμένουν στο SkyPlanner και το Visma Net λαμβάνει την ημερομηνία που έχει σημασία για τις πωλήσεις και τα αποθέματα.

4. Επιβεβαιώσεις από την παραγωγή. Οι χειριστές καταγράφουν την εργασία τους με το Mobile Confirmations ή το Production Timer και οι καταγραφές χρόνου διατηρούν το χρονοπρόγραμμα ενημερωμένο. Όταν ολοκληρωθεί η τελευταία φάση, το SkyPlanner καλεί την ενέργεια οριστικοποίησης στο Kit assembly. Η οριστικοποίηση καταχωρίζει την παραχθείσα ποσότητα και την ανάλωση συστατικών και ακολουθεί η παρτίδα εγγραφών γενικής λογιστικής. Οι ώρες συγκεντρώνονται σε εβδομαδιαία Employee time cards ή σε συναλλαγές έργου, όταν η εργασία βασίζεται σε έργα.

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

Κάθε αλλαγή σε ένα Kit specification δημιουργεί νέα αναθεώρηση. Διαβάστε ξανά την τελευταία αναθεώρηση και επαναλάβετε την αντιστοίχιση, καθώς μόνο αυτή μπορεί να χρησιμοποιηθεί για παραγωγή. Οι χειροκίνητες αλλαγές στα συστατικά ενός Kit assembly παραμένουν έγκυρες στο Visma Net, γι’ αυτό το SkyPlanner διαβάζει ξανά το Kit assembly πριν από την οριστικοποίηση.

• Δεν υπάρχουν φασεολόγια προς εισαγωγή. Όλα τα στάδια παραγωγής και οι χρόνοι προετοιμασίας και εκτέλεσης ορίζονται εξαρχής στο SkyPlanner. Υπολογίστε την απαιτούμενη εργασία και ορίστε υπεύθυνο.
• Advanced logistics. Το Kit assembly απαιτεί την ομάδα Advanced logistics. Με το Standard logistics, καταχωρίστε την παραγόμενη ποσότητα μέσω των Inventory receipt και Inventory issue.
• Κλειδωμένες αναθεωρήσεις. Μια αναθεώρηση Kit specification που έχει χρησιμοποιηθεί δεν μπορεί να τροποποιηθεί και μόνο η τελευταία αναθεώρηση μπορεί να χρησιμοποιηθεί για παραγωγή.
• Μονάδες μέτρησης. Το Kit assembly έχει τη δική του μονάδα μέτρησης. Κατά την εισαγωγή, φροντίστε να συμφωνεί με τις ποσότητες στο SkyPlanner.
• Περιοδικά ερωτήματα χωρίς συμβάντα. Τα kit δεν διαθέτουν webhooks. Ανακτάτε μόνο τις αλλαγές βάσει του lastModifiedDateTime, αντί να επαναφορτώνετε όλα τα δεδομένα, ώστε να παραμένετε εντός του ωριαίου ορίου αιτημάτων.
• Τρέχοντα endpoints. Βασίστε την υλοποίηση αποκλειστικά στο api.finance.visma.net και στο SalesOrder service v3.
• Έγκριση του tenant. Ο έλεγχος ταυτότητας με client credentials αποτυγχάνει μέχρι ο διαχειριστής του tenant να εγκρίνει την εφαρμογή. Προγραμματίστε αυτό το βήμα εγκαίρως.
• Εβδομαδιαία δελτία χρόνου. Τα δελτία χρόνου απαιτούν το Advanced financials και τηρούνται ανά εβδομάδα. Συγκεντρώστε τις ώρες των χειριστών ανά εβδομάδα ή καταχωρίστε τις στις συναλλαγές έργου.