Εδώ μπορείτε να βρείτε έναν αναλυτικό οδηγό για το πώς να δημιουργήσετε μια παραγγελία στο Skyplanner με όλα τα σχετικά δεδομένα. Κάποια από αυτά έχουν καλυφθεί στο σεμινάριο ενσωμάτωσης, αλλά εδώ θα εξετάσουμε τη δομή των δεδομένων του Skyplanner και τη διαδικασία ενσωμάτωσης με περισσότερες λεπτομέρειες.
Δομή δεδομένων #
Πρώτα θα δούμε πώς είναι δομημένη μια παραγγελία Skyplanner. Τα σημεία API για τις οντότητες δεδομένων που αναφέρονται εδώ επισημαίνονται ως εξής: /phaser-orders
Στο ανώτερο επίπεδο έχουμε την παραγγελία(/phaser-orders)
Κάθε παραγγελία πρέπει να έχει έναν πελάτη(/customers).
Κάθε παραγγελία μπορεί να έχει πολλαπλά στοιχεία παραγγελίας(/phaser-order-rows)
Σε κάθε στοιχείο παραγγελίας μπορεί να επισυνάπτεται ένα προϊόν(/products), αλλά αυτό δεν είναι υποχρεωτικό. Κάθε προϊόν έχει ένα απόθεμα(/saldos). Σημειώστε ότι η οντότητα stock δημιουργείται αυτόματα όταν δημιουργείται ένα προϊόν με το API.
Κάθε στοιχείο παραγγελίας μπορεί να έχει πολλαπλές εργασίες (ή αλλιώς βήματα διαδικασίας)(/phaser-jobs).
Κάθε εργασία πρέπει να έχει ένα στάδιο εργασίας(/workstages).
Ροή εργασίας ενσωμάτωσης #
Ακολουθεί ένα παράδειγμα βήμα προς βήμα για το πώς μπορείτε να δομήσετε την ενσωμάτωσή σας από το σύστημα ERP σας στο Skyplanner.
- Λήψη πωλήσεων/παραγγελιών εργασίας από το ERP
- Δημιουργία πελάτη (λάβετε το αναγνωριστικό πελάτη στην απάντηση)
- Δημιουργία παραγγελίας με αναγνωριστικό πελάτη (λάβετε αναγνωριστικό παραγγελίας στην απάντηση)
- Λήψη δεδομένων στοιχείων παραγγελίας πωλήσεων/παραγγελιών εργασίας από το ERP
- Δημιουργία προϊόντος (λάβετε το αναγνωριστικό προϊόντος στην απάντηση)
- Δημιουργία στοιχείου παραγγελίας με αναγνωριστικό παραγγελίας και άλλα δεδομένα (λήψη αναγνωριστικού στοιχείου παραγγελίας στην απάντηση)
- Λήψη δεδομένων βήματος διαδικασίας από το ERP
- Δημιουργία σκηνής εργασίας (λάβετε το αναγνωριστικό σκηνής εργασίας στην απάντηση)
- Δημιουργία εργασίας με αναγνωριστικό στάδιου εργασίας και άλλα δεδομένα
Επιπλέον συμβουλές #
Κατά τη διαγραφή #
Η διαγραφή phaser-orders, phaser-order-items ή phaser-jobs μέσω του API (και από το UI) γίνεται με τρόπο soft delete. Αυτό σημαίνει ότι τα δεδομένα δεν διαγράφονται πραγματικά από τη βάση δεδομένων, αλλά επισημαίνονται ως αρχειοθετημένα. Στην πραγματικότητα, το χαρακτηριστικό is_archive της οντότητας τίθεται σε true όταν διαγράφεται. Η πρόσβαση στις αρχειοθετημένες/διαγραμμένες οντότητες εξακολουθεί να είναι δυνατή με το API χρησιμοποιώντας την παράμετρο include_archived. Όταν include_archived=true, μια αίτηση GET θα ανακτήσει την οντότητα ακόμη και αν έχει αρχειοθετηθεί.
Σημειώστε ότι η απαλή διαγραφή δεν είναι διαθέσιμη σε κάθε τελικό σημείο API! Επομένως, πρέπει να είστε προσεκτικοί, καθώς η διαγραφή για παράδειγμα πελατών, ανθρώπων κ.λπ. είναι μόνιμη!
Χρήση προεπιλεγμένων βημάτων διαδικασίας για το στοιχείο παραγγελίας σας #
Εάν έχετε δημιουργήσει κάποια προεπιλεγμένα βήματα διαδικασίας για το προϊόν που παράγει το στοιχείο παραγγελίας σας, μπορείτε να πείτε στο σύστημα να μεταφέρει τα προεπιλεγμένα βήματα στο στοιχείο παραγγελίας με το API χρησιμοποιώντας το χαρακτηριστικό get_default_steps.
Προσθήκη υλικών σε στοιχείο παραγγελίας #
Εάν έχετε επισυνάψει υλικά στο παραγόμενο προϊόν, αυτά επισυνάπτονται αυτόματα στη σειρά παραγγελίας.
Ωστόσο, εάν δεν θέλετε να χρησιμοποιήσετε τα υλικά που συνδέονται με το προϊόν (για παράδειγμα, εάν το προϊόν είναι ειδική παραγγελία και θέλετε να χρησιμοποιήσετε διαφορετικά υλικά κ.λπ.), μπορείτε να χρησιμοποιήσετε το χαρακτηριστικό use_custom_materials.
