Παραγγελία αντικειμένων

Εδώ θα αναφερθούμε λεπτομερώς στην ανάκτηση, δημιουργία, ενημέρωση και διαγραφή στοιχείων παραγγελίας.

Η πρόσβαση στα στοιχεία παραγγελιών γίνεται από το τελικό σημείο /phaser-order-rows.

Λήψη στοιχείων παραγγελίας #

Λαμβάνετε στοιχεία παραγγελίας στέλνοντας ένα αίτημα GET στο τελικό σημείο /phaser-order-rows:

Μπορείτε να αναζητήσετε στοιχεία παραγγελίας με βάση διάφορες παραμέτρους:

• phaser_order_id
  • εσωτερικό αναγνωριστικό παραγγελίας του Skyplanner, μπορεί να βρεθεί από το /phaser-orders-endpoint
• external_id
  • Εξωτερικό αναγνωριστικό του στοιχείου παραγγελίας
  • Για παράδειγμα, το μοναδικό αναγνωριστικό από το εξωτερικό σας σύστημα (ERP κ.λπ.)
• production_planning_product_id
  • Εσωτερικό αναγνωριστικό προϊόντος Skyplanner
  • Μπορεί να βρεθεί από το /products-endpoint
• parent_id
  • Εάν ένα στοιχείο παραγγελίας έχει υποστοιχεία (π.χ. υποπροϊόντα), τα υποστοιχεία έχουν το αναγνωριστικό του γονικού στοιχείου παραγγελίας στο πεδίο parent_id.
• row_index
  • Αριθμός δείκτη του στοιχείου της παραγγελίας

• αριθμός εργασίας
  • Η τιμή του αριθμού εργασίας του στοιχείου παραγγελίας
• κατάσταση
  • Κατάσταση στοιχείου παραγγελίας
  • Επιτρεπόμενες τιμές: new, started ή completed
• θέση
  • Η τιμή θέσης του στοιχείου της παραγγελίας

• delivery_date
  • Η ημερομηνία παράδοσης του αντικειμένου της παραγγελίας
  • Μορφή: 2025-06-05T22:00:00+00:00
• delivery_date_condition
  • Προαιρετική προϋπόθεση αναζήτησης ημερομηνίας παράδοσης
  • Επιλογές: >, =, <=, =, !=
  • Εάν δεν δοθεί καμία τιμή, θα χρησιμοποιηθεί η συνθήκη >=.
• is_prospect
  • Επιστρέψτε μόνο τα στοιχεία παραγγελίας που είναι προοπτικές
• include_archived
  • Συμπεριλάβετε αρχειοθετημένα (απαλή διαγραφή) στοιχεία παραγγελίας στην ανάκτηση
  • Δηλώνεται από την τιμή is_archive
• τροποποιημένο
  • Επιστροφή στοιχείων παραγγελίας που έχουν τροποποιηθεί μετά τη δεδομένη ημερομηνία
  • Μορφή: 2025-06-05T22:00:00+00:00
• modifiedCondition
  • Προαιρετική συνθήκη αναζήτησης τροποποιημένης τιμής
  • Επιλογές: >, =, <=, =, !=
  • Εάν δεν δοθεί καμία τιμή, θα χρησιμοποιηθεί η συνθήκη >=.

Μπορείτε επίσης να συνδυάσετε τις παραμέτρους αναζήτησης ως εξής:

Για να ανακτήσετε ένα συγκεκριμένο στοιχείο παραγγελίας με το εσωτερικό αναγνωριστικό του Skyplanner μπορείτε να κάνετε μια αίτηση ως εξής:

Δημιουργία στοιχείων παραγγελίας #

Σημειώστε ότι πρέπει να δημιουργήσετε μια παραγγελία πριν από τη δημιουργία του στοιχείου παραγγελίας!

Για να δημιουργήσετε ένα στοιχείο παραγγελίας, στείλτε ένα αίτημα POST στο τελικό σημείο /phaser-order-rows:

Ακολουθεί μια επισκόπηση των πεδίων που μπορείτε να χρησιμοποιήσετε κατά τη δημιουργία ενός στοιχείου παραγγελίας:

• phaser_order_id
  • Εσωτερικό αναγνωριστικό του Skyplanner για την παραγγελία στην οποία επισυνάπτεται το στοιχείο παραγγελίας
  • Υποχρεωτικό πεδίο
• production_planning_order_row_id
  • Μετά την εξαγωγή της παραγγελίας στην ενότητα προγραμματισμού παραγωγής του Skyplanner δημιουργείται μια ξεχωριστή οντότητα που ονομάζεται σειρά παραγγελίας προγραμματισμού παραγωγής και το id της ορίζεται σε αυτό το πεδίο
  • Δεν συνιστάται η χρήση του (αφήστε το μηδενικό ή μην στείλετε καθόλου αυτό το πεδίο στο πεδίο αίτησης)
• production_planning_product_id
  • Skyplanner product id για το προϊόν που παράγει το στοιχείο παραγγελίας
  • Απαιτείται εάν θέλετε να φέρετε προεπιλεγμένα βήματα διαδικασίας από ένα προϊόν
• external_id
  • Μοναδικό αναγνωριστικό του στοιχείου παραγγελίας
  • Χρησιμοποιήστε το για να συνδέσετε το στοιχείο παραγγελίας του Skyplanner με το στοιχείο παραγγελίας σας από ένα εξωτερικό σύστημα (ERP κ.λπ.)
  • Πρέπει να είναι μοναδικό
• parent_id
  • Εάν το στοιχείο παραγγελίας είναι υποστοιχείο άλλου στοιχείου παραγγελίας, δώστε εδώ την τιμή id του γονέα.
• row_index
  • Σε ποιο σημείο του καταλόγου των στοιχείων της παραγγελίας βρίσκεται αυτό το στοιχείο.
• αριθμός εργασίας
  • Χρησιμοποιείται μόνο ως πληροφοριακή τιμή αριθμού εργασίας για το στοιχείο παραγγελίας.
  • Δεν είναι ορατό στο Skyplanner UI
• κατάσταση
  • Κατάσταση του στοιχείου της παραγγελίας
  • Επιτρεπόμενες τιμές: new, started, ready, phased
• is_archive
  • Είναι το στοιχείο της παραγγελίας αρχειοθετημένο (απαλή διαγραφή)
• θέση
  • Τιμή αναγνωριστικού στοιχείου παραγγελίας (βλ. Σχήμα 3.)
• ποσό
  • Συνολική κατασκευασθείσα ποσότητα προϊόντος
• ordered_amount
  • Παραγγελθείσα ποσότητα προϊόντος
• τιμή
  • Μοναδιαία τιμή του προϊόντος
• use_custom_materials
  • Εάν δεν θέλετε να χρησιμοποιήσετε την προεπιλεγμένη ρύθμιση υλικού από τα δεδομένα προϊόντος, ορίστε αυτή την τιμή σε true.
  • Προεπιλογή: false
• use_custom_materials_calculated
  • Οι ποσότητες προσαρμοσμένων υλικών υπολογίζονται με βάση την κατασκευασμένη ποσότητα των προϊόντων.
  • Αν οριστεί σε false, οι ποσότητες υλικών είναι σταθερές
  • Προεπιλογή: false
• get_default_steps
  • Δημιουργία βημάτων διεργασίας για την παραγγελία αντικειμένου με βάση τα προεπιλεγμένα βήματα διεργασίας του προϊόντος
  • Προεπιλογή: false
• use_calculated_job_durations
  • Υπολογισμός διάρκειας βημάτων διαδικασίας με βάση δεδομένα χρονολογίου του παρελθόντος
  • Εάν δεν υπάρχουν αρκετά δεδομένα για τον υπολογισμό, χρησιμοποιούνται προεπιλεγμένες διάρκειες.
  • Προεπιλογή: false
• sub_items
  • Δημιουργήστε επίσης τα υπο-αντικείμενα του προϊόντος εάν είναι διαθέσιμα
  • Προεπιλογή: false
• delivery_date
  • Μορφή: 2022-01-01 10:30:11
• start_eligibility_date
  • Μορφή: 2022-01-01 10:30:11
• drawing_identifier
  • Αναγνωριστικό σχεδίου/μπλε σχεδίου/οδηγιών
• περιγραφή
  • Περιγραφή στοιχείου παραγγελίας
• additional_description
  • Πρόσθετη περιγραφή για το στοιχείο παραγγελίας
• is_prospect
  • Είναι το στοιχείο της παραγγελίας μια προοπτική
  • Προεπιλογή: false

Ενημέρωση στοιχείων παραγγελίας #

Για να ενημερώσετε τα δεδομένα των στοιχείων παραγγελίας μπορείτε να στείλετε ένα αίτημα PUT στο τελικό σημείο /phaser-order-rows:

Διαγραφή στοιχείων παραγγελίας #

Η διαγραφή στοιχείων παραγγελίας γίνεται με τη μέθοδο “απαλής διαγραφής”. Στην πραγματικότητα, η διαγραφή ενός στοιχείου παραγγελίας αλλάζει την τιμή is_archive σε true. Αυτό σημαίνει ότι μπορείτε να επαναφέρετε τα διαγραμμένα στοιχεία παραγγελίας ενημερώνοντας την τιμή is_archive σε false.

Κατά τη διαγραφή ενός στοιχείου παραγγελίας, το σύστημα θα διαγράψει επίσης τα σχετικά βήματα διαδικασίας.

Διαγράφετε στοιχεία παραγγελιών στέλνοντας ένα αίτημα DELETE στο τελικό σημείο /phaser-order-rows:

Μπορείτε να διαγράψετε στοιχεία παραγγελίας δίνοντας τα εσωτερικά αναγνωριστικά του Skyplanner στον πίνακα “ids ” ή τα εξωτερικά αναγνωριστικά στον πίνακα “external_ids “.