Διασυνδέσεις / ERP / Visma L7
Οδηγός διασύνδεσης Visma L7 με APS για τον χρονοπρογραμματισμό παραγωγής
Αυτός ο οδηγός δείχνει σε συνεργάτες και ομάδες IT πώς να συνδέσουν το Visma L7 με το SkyPlanner APS. Η διασύνδεση του SkyPlanner με το Visma L7 είναι αμφίδρομη και χρησιμοποιεί το Visma L7 REST API:
- Στο SkyPlanner εισάγονται αριθμοί εργασίας (työnumero), στάδια εργασίας (työnvaihe), πόροι, δομές προϊόντων, εξαρτήματα, υλικά, υπόλοιπα αποθεμάτων, γραμμές πωλήσεων και γραμμές αγορών.
- Για κάθε κάρτα εργασίας επιστρέφονται ο πόρος, η ημερομηνία έναρξης, η προτεραιότητα, ο εργαζόμενος και οι ώρες ανά ημέρα μέσω του
PUT /manufphases/. - Η δυναμικότητα στο ημερολόγιο πόρων διατηρείται συγχρονισμένη μέσω του
POST /resourceupdates/. - Τα συμβάντα παραγωγής που καταχωρίζονται στις ουρές εργασιών του L7 διαβάζονται μέσω του
GET /manufevents/. - Τα webhooks του SkyPlanner στέλνουν τις αλλαγές στο χρονοδιάγραμμα τη στιγμή που γίνονται.
Η ομάδα του SkyPlanner προσαρμόζει τη διασύνδεση στη δική σας εγκατάσταση L7 κατά την αρχική ένταξη και την υποστηρίζει μετά την έναρξη της παραγωγικής λειτουργίας. Οι συνεργάτες και οι προγραμματιστές μπορούν επίσης να αναπτύξουν λύσεις με το τεκμηριωμένο REST API του SkyPlanner (αναφορά API).
Το REST API του Visma L7
Το API ονομάζεται Visma L7 – REST API και τεκμηριώνεται με OpenAPI 3.0.3 και ιστορικό αλλαγών (τεκμηρίωση). Εκτελείται στο Visma LTR.
- Η βασική διαδρομή είναι
/ltrws/REST/L7στον δικό σας διακομιστή LTR, είτε στις εγκαταστάσεις σας είτε στην υπηρεσία φιλοξενίας εφαρμογών της Visma. - Άδειες χρήσης. Κάθε endpoint απαιτεί ξεχωριστή άδεια. Για την εγγραφή του χρονοπρογράμματος μέσω του
PUT /manufphases/απαιτείται η άδεια L7RMFPP, ενώ για τις ενημερώσεις δυναμικότητας απαιτείται η L7RMCAP. Τα endpoint ανάγνωσης έχουν τις δικές τους άδειες. - Σελιδοποίηση. Οι λίστες σελιδοποιούνται με τα
pageSizeκαιrecAfterκαι φιλτράρονται με ταqueryKey1,queryKey2καιqueryString.
Έλεγχος ταυτότητας
Κάθε κλήση προς το L7 συνοδεύεται από δύο token:
- Το hash επιλέγει τη βάση δεδομένων και την εταιρεία.
- Το token ταυτοποιεί τον χρήστη του API.
Ο διαχειριστής LTR δημιουργεί τον χρήστη του API στο Visma LTR, τον συνδέει με την εταιρεία στο L7, του εκχωρεί προφίλ και δημιουργεί το token χρήστη (οδηγίες εκκίνησης). Χρησιμοποιήστε αποκλειστικό χρήστη για τη διασύνδεση, μόνο με τα δικαιώματα που χρειάζεται.
Στην πλευρά του SkyPlanner, η ταυτοποίηση στο REST API γίνεται με token API που αποστέλλεται στην κεφαλίδα Authorization-Token. Το δημιουργείτε από το Settings > API. Ο οδηγός διασύνδεσης σας καθοδηγεί στις πρώτες κλήσεις.
Εντοπισμός αλλαγών: modifiedAfter
Το L7 REST API δεν διαθέτει webhooks. Οι αλλαγές διαβάζονται με περιοδικά αιτήματα:
- Ενεργοποιήστε την καταγραφή αλλαγών (DBLOG) στη συντήρηση αρχείων του L7 (Tiedostohuolto) για τους πίνακες που διαβάζει η διασύνδεση, όπως οι κάρτες εργασίας και τα εξαρτήματα.
- Καλέστε τα endpoint ανάγνωσης ορίζοντας στο
modifiedAfterτον χρόνο της τελευταίας εκτέλεσης. Οι διαγραμμένες εγγραφές επιστρέφονται με σήμανση διαγραφής, ώστε οι ακυρωμένες εργασίες να αφαιρούνται από το χρονοπρόγραμμα. - Στέλνετε αιτήματα ανά λίγα λεπτά. Το SkyPlanner στέλνει webhooks όταν αλλάζει η κατάσταση ή το χρονοπρόγραμμα, οπότε η εγγραφή δεδομένων πίσω στο L7 ενεργοποιείται από συμβάντα.
Αντιστοίχιση δεδομένων
| Αντικείμενο Visma L7 (endpoint) | Αντικείμενο SkyPlanner | Κατεύθυνση | Συχνότητα |
|---|---|---|---|
Tuote (GET /products/) | Προϊόντα και υλικά | L7 → SkyPlanner | Αρχική φόρτωση και στη συνέχεια σε κάθε αλλαγή |
Εξαρτήματα ανά αριθμό εργασίας (GET /manufcomponents/) | Υποπροϊόντα | L7 → SkyPlanner | Περιοδικά αιτήματα με modifiedAfter |
Ανάγκες υλικών (GET /manufmaterials/) | Απαιτήσεις υλικών ανά εργασία | L7 → SkyPlanner | Περιοδικά αιτήματα με modifiedAfter |
Δέντρο πόρων (KRYH) με πλήθος μηχανών (GET /manufresources/) | Κέντρα εργασίας και ομάδες κέντρων εργασίας | L7 → SkyPlanner | Αρχική φόρτωση και σπάνια στη συνέχεια |
Κάρτα εργασίας (TSUUNR) ανά στάδιο (GET /manufphases/) | Εργασίες (στάδια διεργασίας) ανά κέντρο εργασίας | L7 → SkyPlanner | Αιτήματα ανά λίγα λεπτά |
Υπόλοιπα αποθεμάτων (GET /stockbalances/) | Απόθεμα | L7 → SkyPlanner | Περιοδικά αιτήματα |
Γραμμές αγορών (GET /purchaserows/) | Εντολές αγοράς με ημερομηνίες παράδοσης | L7 → SkyPlanner | Περιοδικά αιτήματα |
Παραγγελίες πωλήσεων και γραμμές τους (GET /salesorders/, GET /salesrows/) | Προθεσμίες παράδοσης, προτεραιότητα πελάτη | L7 → SkyPlanner | Περιοδικά αιτήματα |
Συμβάντα παραγωγής (GET /manufevents/) | Πρόοδος ανά εργασία | L7 → SkyPlanner | Περιοδικά αιτήματα |
Πεδία κάρτας εργασίας resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Προγραμματισμένο κέντρο εργασίας, έναρξη, σειρά και ώρες ανά ημέρα | SkyPlanner → L7 | Σε κάθε αλλαγή του προγράμματος, μέσω webhook του SkyPlanner |
Δυναμικότητα ημερολογίου πόρων (POST /resourceupdates/) | Δυναμικότητα βάρδιας | SkyPlanner → L7 | Όταν αλλάζουν οι βάρδιες |
| Κανόνες χρονοπρογραμματισμού που ορίζονται στο SkyPlanner | Επιτρεπόμενα κέντρα εργασίας, πίνακας χρόνων προετοιμασίας, εργαλεία, προσωπικό | Τήρηση στο SkyPlanner | Ρύθμιση κατά την αρχική ένταξη |
Μοντέλα διασύνδεσης
1. Αρχική φόρτωση βασικών δεδομένων. Διαβάστε το δέντρο πόρων και αντιστοιχίστε κάθε μηχανή σε ξεχωριστό κέντρο εργασίας του SkyPlanner. Αν ένας πόρος του L7 περιλαμβάνει πολλές μηχανές, δημιουργήστε ένα κέντρο εργασίας ανά μηχανή και μια ομάδα κέντρων εργασίας για τον πόρο. Διαβάστε τα προϊόντα και τις δομές προϊόντων μαζί με τα στάδια εργασίας τους.
2. Συγχρονισμός αριθμών εργασίας. Διαβάστε τις ανοιχτές κάρτες εργασίας με το GET /manufphases/ και διατηρήστε τις ενημερωμένες με το modifiedAfter. Διαβάστε τα εξαρτήματα και τις ανάγκες υλικών για κάθε αριθμό εργασίας, καθώς και τα υπόλοιπα αποθεμάτων και τις γραμμές αγορών, ώστε κάθε στάδιο να περιμένει την ημερομηνία παράδοσης της αντίστοιχης γραμμής αγοράς.
3. Εγγραφή του χρονοπρογράμματος στο L7. Για κάθε στάδιο που τοποθέτησε ή μετακίνησε η μηχανή χρονοπρογραμματισμού, το SkyPlanner καλεί το PUT /manufphases/. Το σώμα του αιτήματος περιλαμβάνει μία εγγραφή workSheet ανά κάρτα εργασίας με:
numberγια την κάρτα εργασίας καιresourceγια τον επιλεγμένο πόροstartDateκαιpriority, ώστε οι ουρές εργασιών του L7 να εμφανίζουν τη σειρά που όρισε το SkyPlannerperson, όταν έχει προγραμματιστεί συγκεκριμένος χειριστήςschedulingDays, τις προγραμματισμένες ώρες ανά ημερομηνία
Το L7 διατηρεί αμετάβλητη την προτεραιότητα που έχει οριστεί από εξωτερικό σύστημα (πηγή), οπότε η σειρά διατηρείται στις ουρές εργασιών.
4. Συγχρονισμός δυναμικότητας. Όταν αλλάζουν οι βάρδιες, οι αργίες ή οι υπερωρίες στο SkyPlanner, το POST /resourceupdates/ γράφει τη νέα δυναμικότητα στο ημερολόγιο πόρων του L7. Έτσι, οι προβολές φόρτου του L7 συμφωνούν με το πρόγραμμα.
5. Πρόοδος στην παραγωγή. Οι χειριστές συνεχίζουν να κάνουν καταχωρίσεις στις ουρές εργασιών του L7 και στο Visma LTR, ενώ το SkyPlanner διαβάζει τα συμβάντα με το GET /manufevents/. Μπορούν επίσης να επιβεβαιώνουν εργασίες στο SkyPlanner Mobile Confirmations. Το Autopilot αναπρογραμματίζει με βάση τα δεδομένα από οποιαδήποτε από τις δύο πηγές και η επόμενη εγγραφή στο L7 μεταφέρει τους νέους χρόνους.
6. Ευθύνη δεδομένων και κανόνες επίλυσης συγκρούσεων. Καταγράψτε τους πριν από την έναρξη της παραγωγικής λειτουργίας:
| Δεδομένα | Υπεύθυνο σύστημα |
|---|---|
| Προϊόντα, δομές, στάδια εργασίας, ποσότητες, κατάσταση αριθμού εργασίας | Visma L7 |
| Ακολουθία σταδίων, ημερομηνίες έναρξης, ώρες ανά ημέρα, επιλογή πόρου | SkyPlanner |
| Επιτρεπόμενα κέντρα εργασίας, πίνακας χρόνων προετοιμασίας, εργαλεία, προσωπικό | SkyPlanner |
| Βάρδιες και απουσίες | SkyPlanner, με εγγραφή στο ημερολόγιο πόρων του L7 |
| Συμβάντα παραγωγής και καταχωρίσεις αποθεμάτων | Ουρές εργασιών του Visma L7 και LTR |
Η κύρια πηγή συγκρούσεων είναι ο προγραμματισμός του ίδιου του L7. Ο υπολογισμός απαιτήσεων και ο λεπτομερής προγραμματισμός μπορούν να τοποθετήσουν ξανά τα μη κλειδωμένα στάδια. Εκτελείτε αυτές τις λειτουργίες μόνο για υλικά και δεσμεύσεις και μην αναπρογραμματίζετε τα στάδια για τα οποία είναι υπεύθυνο το SkyPlanner.
Συνήθη βήματα του έργου
Η υλοποίηση συνήθως ολοκληρώνεται μέσα σε λίγες εβδομάδες από την έναρξη της αρχικής ένταξης. Πριν από αυτό, η δωρεάν δοκιμή 30 ημερών λειτουργεί με δικά σας δεδομένα, από εξαγωγή αριθμών εργασίας, σταδίων και πόρων σε Excel.
- Καθορισμός εύρους. Οριστικοποιήστε τον πίνακα αντιστοίχισης, τους κανόνες ευθύνης δεδομένων και το διάστημα μεταξύ των περιοδικών αιτημάτων.
- Πρόσβαση και άδειες χρήσης. Εξασφαλίστε άδειες για τα REST endpoint που περιλαμβάνονται στο έργο. Ο διαχειριστής LTR δημιουργεί τον χρήστη API, το hash και το token, ιδανικά πρώτα σε δοκιμαστική εταιρεία.
- Καταγραφή αλλαγών. Ενεργοποιήστε το DBLOG για τους πίνακες που διαβάζετε.
- Αρχική φόρτωση. Πόροι, προϊόντα, δομές και στάδια εργασίας.
- Συγχρονισμός αριθμών εργασίας. Περιοδικά αιτήματα με modifiedAfter, διαγραφές και σελιδοποίηση.
- Ρύθμιση περιορισμών στο SkyPlanner. Επιτρεπόμενα κέντρα εργασίας, πίνακας χρόνων προετοιμασίας, εργαλεία και προσωπικό.
- Εγγραφή δεδομένων στο L7. Δοκιμή των
PUT /manufphases/καιPOST /resourceupdates/στη δοκιμαστική εταιρεία. - Παράλληλη λειτουργία και έναρξη παραγωγικής λειτουργίας. Συγκρίνετε με το τρέχον πρόγραμμα, διορθώστε τα βασικά δεδομένα και έπειτα ενεργοποιήστε την εγγραφή δεδομένων στο παραγωγικό περιβάλλον.
Τι να προβλέψετε για τη διασύνδεση με το Visma L7
- Άδειες ανά endpoint. Καταγράψτε εγκαίρως όλα τα endpoints και εξασφαλίστε τις άδειές τους πριν από τις δοκιμές.
- Αριθμός μηχανών. Στο L7, ένας πόρος με πολλές μηχανές κατανέμει την εργασία μεταξύ τους (πηγή). Χωρίστε τον σε κέντρα εργασίας στο SkyPlanner και στείλτε πίσω τον πόρο που αναμένει το L7.
- Ώρες ανά ημέρα. Το L7 αποθηκεύει το πρόγραμμα ως ώρες ανά ημερομηνία. Το SkyPlanner στέλνει τιμές
schedulingDaysμε άθροισμα ίσο με τη διάρκεια του σταδίου. - Ημερολόγιο εργοστασίου. Διατηρείτε το πλήρες, καθώς τα κενά μετατοπίζουν τα στάδια σε παρελθοντικές ημερομηνίες (πηγή).
- Εντολές παραγωγής για απόθεμα. Τα
mainNumber,subNumber,rowNumberκαιnewQuantityχρησιμοποιούνται μόνο για την αλλαγή της ποσότητας μιας εντολής παραγωγής για απόθεμα. Μην τα συμπεριλαμβάνετε σε εργασίες για πελάτες. - Το επόμενο ERP. Η Visma έχει σταματήσει την ανάπτυξη νέων λειτουργιών για το L7 και η χρήση του προϊόντος τερματίζεται στο τέλος του 2028 (ανακοίνωση της Visma). Διατηρείτε τους κανόνες χρονοπρογραμματισμού στο SkyPlanner, όχι σε πεδία του L7, ώστε να μεταφερθούν όταν αλλάξετε ERP.
Διασύνδεση με το Visma L7: ποιος αναλαμβάνει τη ρύθμιση και την υποστήριξη
Οι εργασίες περιλαμβάνουν την αντιστοίχιση δεδομένων με βάση τους πόρους, τα στάδια εργασίας και την παραμετροποίηση της δικής σας εγκατάστασης L7. Καλύπτουν επίσης τους κανόνες χρονοπρογραμματισμού που διατηρείτε στο SkyPlanner: τα επιτρεπόμενα κέντρα εργασίας, τον πίνακα χρόνων προετοιμασίας, τα εργαλεία και το προσωπικό.
- Η ομάδα του SkyPlanner ρυθμίζει τη διασύνδεση κατά την αρχική ένταξη και την υποστηρίζει μετά την έναρξη της παραγωγικής λειτουργίας. Κάθε εργοστάσιο χρησιμοποιεί το L7 διαφορετικά και αυτή η τεχνογνωσία αξιοποιείται εδώ.
- Ο συνεργάτης σας για το Visma μπορεί να συμμετάσχει. Γνωρίζει την παραμετροποίηση των L7 και LTR σας και μπορεί να αναλάβει τον χρήστη API, τις άδειες και τη δοκιμαστική εταιρεία. Το SkyPlanner παρέχει το REST API, την τεκμηρίωση Swagger/OpenAPI και τα webhooks.
- Οι δικοί σας προγραμματιστές μπορούν να αναπτύξουν πρόσθετες λειτουργίες χρησιμοποιώντας το ίδιο τεκμηριωμένο REST API με ένα API token. Ένα API token αρκεί για να ξεκινήσουν και η ομάδα του SkyPlanner βοηθά όποτε χρειάζεται.
Όταν αντικαταστήσετε το L7, η ίδια παραμετροποίηση του SkyPlanner συνδέεται με το νέο ERP. Δείτε τις σελίδες για τα Business Central, Visma Net, Lemonsoft, Monitor ERP και Odoo.
Το SkyPlanner ξεκινά από 199 € τον μήνα, με 5 κέντρα εργασίας και μηνιαία χρέωση. Μαζί με το συνδρομητικό σας πακέτο, λαμβάνετε εκ των προτέρων προσφορά για τη διασύνδεση, με βάση τις διαδικασίες και τις ανάγκες σας, ώστε να γνωρίζετε το συνολικό κόστος πριν ξεκινήσετε.
Δείτε πώς συγκρίνονται οι δυνατότητες προγραμματισμού του ίδιου του L7 στο άρθρο Υποστηρίζει το Visma L7 χρονοπρογραμματισμό πεπερασμένης δυναμικότητας; Θα βρείτε την επισκόπηση στη σελίδα του Visma L7 και τα υπόλοιπα συστήματα στην κεντρική σελίδα διασυνδέσεων ERP.
Αξιολογήσεις του SkyPlanner από βιομηχανικές επιχειρήσεις
1.000άδεςεντολές εργασίας χρονοπρογραμματίζονται αυτόματα
«Έχουμε πλέον διαφορετικό έλεγχο της παραγωγής και η κατανόηση της δυναμικότητάς μας βρίσκεται σε εντελώς άλλο επίπεδο.»
Hannu Ryynänen, Διευθύνων Σύμβουλος
Mamec · Βιομηχανικοί αναμικτήρες, αντλίες και υπεργολαβική κατασκευή υψηλής τεχνολογίας
Χιλιάδες εντολές εργασίας χρονοπρογραμματίζονται αυτόματα, ενώ όλη η επιχείρηση έχει εικόνα της παραγωγής σε πραγματικό χρόνο.
98%έγκαιρες παραδόσεις, από περίπου 50%
«Το SkyPlanner παίζει καθοριστικό ρόλο στη διατήρηση του ποσοστού έγκαιρων παραδόσεών μας.»
Hannu Lahtinen, Διευθύνων Σύμβουλος
KJH-Comp · Μηχανολογικές κατασκευές από λαμαρίνα και υπεργολαβική κατασκευή
Το ποσοστό έγκαιρων παραδόσεων αυξήθηκε από περίπου 50% έως και 98%, ενώ ο χρονοπρογραμματισμός απαιτεί πλέον έναν επόπτη αντί για δύο.
2 ώρεςεξοικονομούνται κάθε εβδομάδα
«Με το SkyPlanner περάσαμε από τον προγραμματισμό παραγωγής σε υπολογιστικά φύλλα Excel στη βελτιστοποίηση της παραγωγής σε πραγματικό χρόνο.»
Kalle Kalliomäki, Ειδικός Εφοδιαστικής Αλυσίδας
UTU · Ηλεκτρικοί πίνακες και διακοπτικός εξοπλισμός
Στον προγραμματισμό παραγωγής εξοικονομούνται 2 ώρες εργασίας κάθε εβδομάδα και η νέα ουρά εργασιών φτάνει στη γραμμή παραγωγής μέσα σε δευτερόλεπτα.
+90%αποδοτικότητα παραγωγής
«Η αποδοτικότητα στην παραγωγή αυξήθηκε κατά 90%.»
Abdul Rucyinga, Επικεφαλής Πληροφορικής
Laboratory & Allied · Παραγωγή φαρμάκων
Η αποδοτικότητα της παραγωγής αυξήθηκε κατά 90% και η δημιουργία ενός βελτιστοποιημένου προγράμματος τριών μηνών για όλα τα κέντρα εργασίας απαιτεί λιγότερο από 30 λεπτά.
Συχνές ερωτήσεις
Διαθέτει το Visma L7 API για δεδομένα παραγωγής;
Ναι. Το Visma L7 REST API στο Visma LTR παρέχει πρόσβαση σε στάδια εργασίας, πόρους, εξαρτήματα, υλικά, συμβάντα παραγωγής, προϊόντα, υπόλοιπα αποθεμάτων, γραμμές πωλήσεων και γραμμές αγορών. Κάθε endpoint απαιτεί ξεχωριστή άδεια και ο διαχειριστής του LTR δημιουργεί τον χρήστη API και τα tokens.
Πώς μεταφέρεται το πρόγραμμα από το SkyPlanner στο Visma L7;
Με το PUT /manufphases/, το οποίο ενημερώνει τον πόρο, την ημερομηνία έναρξης, την προτεραιότητα, το άτομο και τις προγραμματισμένες ώρες ανά ημερομηνία κάθε κάρτας εργασίας. Το POST /resourceupdates/ εγγράφει τη δυναμικότητα στο ημερολόγιο των πόρων. Το L7 διατηρεί την εξωτερική προτεραιότητα, ώστε οι ουρές εργασιών να ακολουθούν τη σειρά του SkyPlanner.
Υποστηρίζει το Visma L7 webhooks;
Δεν υπάρχουν τεκμηριωμένα webhooks. Ενεργοποιήστε την καταγραφή αλλαγών για τους πίνακες που περιλαμβάνονται στη διασύνδεση και ελέγχετε περιοδικά για αλλαγές με το modifiedAfter. Τα webhooks του ίδιου του SkyPlanner στέλνουν τις αλλαγές του προγράμματος τη στιγμή που συμβαίνουν.
Ποιο λογισμικό χρονοπρογραμματισμού συνδέεται με το Visma L7;
Το SkyPlanner APS συνδέεται αμφίδρομα με το Visma L7 μέσω του L7 REST API και η Visma αναφέρει τη Skycode με το SkyPlanner στη σελίδα διασυνδέσεων του L7. Η ομάδα του SkyPlanner ρυθμίζει τη διασύνδεση κατά την αρχική εγκατάσταση.
Ποιος υλοποιεί τη διασύνδεση με το Visma L7;
Η ομάδα του SkyPlanner ρυθμίζει την αμφίδρομη διασύνδεση σύμφωνα με την παραμετροποίηση του L7 σας κατά την αρχική εγκατάσταση και την υποστηρίζει μετά την έναρξη της παραγωγικής λειτουργίας. Ο συνεργάτης σας για το Visma ή οι δικοί σας προγραμματιστές μπορούν επίσης να αναπτύξουν λειτουργίες με το τεκμηριωμένο REST API του SkyPlanner. Ένα API token αρκεί για να ξεκινήσουν.
Μπορούμε να δοκιμάσουμε το SkyPlanner πριν υλοποιήσουμε τη διασύνδεση;
Ναι. Η δωρεάν δοκιμή 30 ημερών υποστηρίζει έως 20 κέντρα εργασίας με εισαγωγή δεδομένων από το L7 μέσω Excel ή CSV, χωρίς να απαιτείται πιστωτική κάρτα. Ξεκινήστε τη δοκιμή ή μιλήστε με το τμήμα πωλήσεων για να καθορίσετε το εύρος της διασύνδεσης.
