Εδώ θα δούμε πώς μπορείτε να δημιουργήσετε προϊόντα και υλικά και πώς μπορείτε να τα επισυνάψετε στις παραγγελίες σας με το Skyplanner-API. Θα σας δείξουμε επίσης πώς να δημιουργείτε προεπιλεγμένα βήματα διαδικασίας για τα προϊόντα σας και πώς να δημιουργείτε στοιχεία παραγγελίας χρησιμοποιώντας αυτές τις προεπιλογές.
Δημιουργία προϊόντος/υλικού #
Η δημιουργία και η ενημέρωση τόσο των προϊόντων όσο και των υλικών γίνεται μέσω του ίδιου σημείου API: /products. Ο τύπος του προϊόντος καθορίζεται από το χαρακτηριστικό type-attribute: ‘Product’ ή ‘Material’.
Όταν δημιουργείτε προϊόντα και υλικά, βεβαιωθείτε ότι έχετε ορίσει την τιμή is_active ως true αν θέλετε το προϊόν/υλικό να εμφανίζεται ως ενεργό στην καταχώριση του προϊόντος. Σημειώστε επίσης ότι μπορείτε να ορίσετε τη διαθέσιμη ποσότητα αποθέματος με το χαρακτηριστικό free_amount.
Δημιουργία προεπιλεγμένων βημάτων διαδικασίας για ένα προϊόν #
Πριν από την προσθήκη προεπιλεγμένων βημάτων διαδικασίας για ένα προϊόν, πρέπει να έχετε τα κατάλληλα στάδια εργασίας. Τα στάδια εργασίας μπορούν να δημιουργηθούν είτε μέσω του Skyplanner UI είτε μέσω του /workstages-endpoint.
Η προσθήκη προεπιλεγμένων βημάτων διεργασίας γίνεται από το /products/jobs/{productId}-endpoint.
Έτσι, για παράδειγμα, αν θέλετε να προσθέσετε ένα προεπιλεγμένο βήμα στο προϊόν με το id 22220, θα κάνετε μια POST-επίκληση ως εξής:
Μερικά αξιοσημείωτα πεδία:
- order_number
- Πρόκειται για έναν αριθμό δείκτη που υποδεικνύει στο Skyplanner με ποια σειρά πρέπει να ολοκληρωθούν τα βήματα της διαδικασίας.
- Για παράδειγμα: το πρώτο βήμα παίρνει την τιμή 1, το δεύτερο βήμα παίρνει την τιμή 3, το τρίτο βήμα παίρνει την τιμή 3 και ούτω καθεξής…
- σταθμοί εργασίας
- Αυτός είναι ένας κατάλογος των σταθμών εργασίας στους οποίους μπορεί να προγραμματιστεί αυτό το βήμα διαδικασίας
- Δώστε εδώ τα αναγνωριστικά των σταθμών εργασίας ως λίστα με διαχωρισμό κόμματος, όπως εδώ: “61,62,63”
- time_variation
- Πιθανές τιμές: time_per_pcs, pcs_per_time, fixed_time
- duration, settingtime, settletime
- Δώστε αυτές τις τιμές σε δευτερόλεπτα
Ενημέρωση ενός προεπιλεγμένου βήματος διαδικασίας #
Όταν ενημερώνετε ένα προεπιλεγμένο βήμα διαδικασίας, πρέπει να χρησιμοποιείτε το χαρακτηριστικό order_number για να καθορίσετε ποιο βήμα θα ενημερωθεί.
Για παράδειγμα, το πρώτο βήμα της διαδικασίας(order_number 1) σε αυτό το προϊόν γίνεται με ένα PUT-request ως εξής:
Διαγραφή προεπιλεγμένων βημάτων διαδικασίας #
Η διαγραφή προεπιλεγμένων βημάτων διαδικασίας γίνεται επίσης με τη χρήση των τιμών order_number.
Οι αριθμοί παραγγελιών δίνονται σε έναν πίνακα ως εξής:
Προσθήκη υλικού/υποπροϊόντος σε προϊόν #
Για να επισυνάψουμε ένα υλικό ή ένα υποπροϊόν πρέπει να χρησιμοποιήσουμε το τελικό σημείο /sub-products.
Η διαδικασία είναι αρκετά απλή: βάζουμε το id του υλικού ή του υποπροϊόντος στο χαρακτηριστικό production_planning_product_id και το id του προϊόντος στο οποίο θέλουμε να συνδεθεί το υλικό/υποπροϊόν στο χαρακτηριστικό production_planning_product_parent_id.
Προσθήκη υλικού σε στοιχείο παραγγελίας #
Μπορείτε επίσης να επισυνάψετε υλικά απευθείας σε ένα στοιχείο παραγγελίας χρησιμοποιώντας το τελικό σημείο /row-materials. Με αυτόν τον τρόπο μπορείτε να επισυνάψετε επιπλέον υλικά ή να χρησιμοποιήσετε μια εντελώς διαφορετική λίστα υλικών σε ένα στοιχείο παραγγελίας από τα προεπιλεγμένα υλικά που έχουν οριστεί στα προϊόντα. Σημειώστε ότι μπορείτε να έχετε μόνο μία οντότητα row-Material για ένα στοιχείο παραγγελίας για κάθε υλικό. Έτσι, στην πραγματικότητα δεν μπορείτε να δημιουργήσετε δύο οντότητες με το ίδιο production_planning_product_id στο ίδιο phaser_order_row_id.
Ενημέρωση του επιπέδου αποθεμάτων #
Μπορείτε να ενημερώσετε το επίπεδο αποθέματος προϊόντος ή υλικού στέλνοντας ένα αίτημα PUT με το χαρακτηριστικό free_amount.