Πώς να συνδέσετε δεδομένα παρακολούθησης αποστολών σε ένα Oms: Αντιστοίχιση παραγγελιών και κανόνες συγχρονισμού
Για να συνδέσετε τα δεδομένα παρακολούθησης αποστολών με ένα σύστημα διαχείρισης παραγγελιών (OMS), αντιστοιχίστε κάθε παρακολουθούμενο δέμα σε μια εσωτερική εγγραφή αποστολής και, στη συνέχεια, συνδέστε αυτή την αποστολή με την παραγγελία και τις γραμμές εκτέλεσής της. Λαμβάνετε ενημερώσεις παρακολούθησης μέσω της υποστηριζόμενης διεπαφής του παρόχου, διατηρείτε τα αρχικά συμβάντα και εφαρμόζετε σαφείς κανόνες για τα διπλότυπα, τις καθυστερημένες ενημερώσεις, την κατάσταση αποστολής και την ολοκλήρωση της παραγγελίας. Μην χρησιμοποιείτε μόνο έναν αριθμό παρακολούθησης ως αναγνωριστικό παραγγελίας και μην επιτρέπετε σε ένα μόνο συμβάν παράδοσης να κλείνει αυτόματα μια παραγγελία με πολλά δέματα.

Αυτός ο οδηγός απευθύνεται σε μηχανικούς ολοκλήρωσης και σε ομάδες λειτουργίας ηλεκτρονικού εμπορίου που υλοποιούν αυτή τη σύνδεση. Ο προτεινόμενος σχεδιασμός διαχωρίζει τις παρατηρήσεις του μεταφορέα από τις επιχειρηματικές αποφάσεις: τα δεδομένα παρακολούθησης περιγράφουν τη διαδρομή ενός δέματος, ενώ το OMS αποφασίζει τι σημαίνει αυτή η διαδρομή για την εκτέλεση, την επικοινωνία με τον πελάτη και το κλείσιμο της παραγγελίας.
Καθορίστε ποιο σύστημα είναι υπεύθυνο για κάθε εγγραφή
Πριν δημιουργήσετε μια σύνδεση API, συμφωνήστε σχετικά με την ιδιοκτησία των δεδομένων με τον διαχειριστή του OMS, την ομάδα εκτέλεσης και την ομάδα εξυπηρέτησης πελατών. Διαφορετικά, μια τεχνικά επιτυχής ολοκλήρωση μπορεί και πάλι να αντικαταστήσει έγκυρα επιχειρηματικά δεδομένα.
- OMS: Είναι υπεύθυνο για τις παραγγελίες, τις γραμμές παραγγελιών, τις απαιτούμενες ποσότητες, τις ακυρώσεις και τους κανόνες ολοκλήρωσης παραγγελιών.
- Σύστημα εκτέλεσης: Είναι υπεύθυνο για τις εγγραφές αποστολών ή δεμάτων που δημιουργεί, συμπεριλαμβανομένων των κατανομών συσκευασίας και των αντιστοιχίσεων ετικετών. Αυτό μπορεί να είναι το ίδιο το OMS ή ένα ξεχωριστό σύστημα αποθήκης.
- Πάροχος παρακολούθησης: Παρέχει παρατηρήσεις παρακολούθησης και τυχόν ταξινομήσεις κατάστασης που ορίζει ο πάροχος.
- Επίπεδο ολοκλήρωσης: Είναι υπεύθυνο για τις αντιστοιχίσεις αναγνωριστικών, την επεξεργασία συμβάντων, την κανονικοποίηση, τη διαχείριση επαναλήψεων και τις εγγραφές ελέγχου συγχρονισμού.
Αντιμετωπίστε αυτά ως προτεινόμενα όρια και όχι ως παραδοχές σχετικά με το λογισμικό σας. Καταγράψτε τις εξαιρέσεις. Για παράδειγμα, αν η αποθήκη μπορεί να αντικαταστήσει μια ετικέτα αποστολής, η ολοκλήρωση χρειάζεται ρητή ενημέρωση από αυτό το σύστημα αντί να υποθέτει ότι ένας νέος αριθμός αντικαθιστά έναν παλιό.
Δημιουργήστε την αντιστοίχιση παραγγελίας-δέματος πριν συγχρονίσετε τις καταστάσεις
Μια πρακτική σχέση είναι παραγγελία → εκτέλεση → δέμα → αντιστοίχιση παρακολούθησης. Το OMS σας μπορεί να χρησιμοποιεί διαφορετικές ονομασίες ή να συνδυάζει ορισμένες από αυτές τις εγγραφές. Διατηρήστε τις σχέσεις ακόμη και αν η δομή της βάσης δεδομένων διαφέρει.
Μια παραγγελία μπορεί να έχει πολλές εκτελέσεις και μια εκτέλεση μπορεί να περιέχει πολλά δέματα. Ένα δέμα μπορεί επίσης να αποκτήσει νέα αντιστοίχιση παρακολούθησης ή συνδεδεμένο αναγνωριστικό τελευταίου χιλιομέτρου. Αυτά τα αναγνωριστικά δεν πρέπει να δημιουργούν πρόσθετες παραγγελθείσες ποσότητες.
| Εγγραφή | Προτεινόμενα πεδία | Σκοπός |
|---|---|---|
| Παραγγελία | Αναγνωριστικό μισθωτή ή καταστήματος, αμετάβλητο αναγνωριστικό παραγγελίας OMS | Διαχωρίζει τους εμπόρους και αποφεύγει την εξάρτηση από εμφανιζόμενους αριθμούς παραγγελιών. |
| Εκτέλεση | Αναγνωριστικό εκτέλεσης, αναγνωριστικό παραγγελίας, αναγνωριστικά και ποσότητες κατανεμημένων γραμμών | Προσδιορίζει ποια αγορασμένα είδη εκτελούνται. |
| Δέμα | Εσωτερικό αναγνωριστικό δέματος, αναγνωριστικό εκτέλεσης, κατανομές δέματος όπου είναι διαθέσιμες | Παρέχει σταθερή ταυτότητα ανεξάρτητα από τις ετικέτες παρακολούθησης. |
| Αντιστοίχιση παρακολούθησης | Αναγνωριστικό αντιστοίχισης, αναγνωριστικό δέματος, λογαριασμός παρόχου, αναγνωριστικό μεταφορέα, αριθμός παρακολούθησης, ενεργή περίοδος | Συνδέει τις εισερχόμενες παρατηρήσεις παρακολούθησης με το σωστό δέμα και τον κύκλο ζωής της αντιστοίχισης. |
Αντιστοιχίστε τις ενημερώσεις μέσω αποθηκευμένης διασταύρωσης
Όταν δημιουργείται μια αποστολή, αποθηκεύστε τα εσωτερικά αναγνωριστικά της πριν την καταχωρίσετε για παρακολούθηση. Αποθηκεύστε οποιοδήποτε αναγνωριστικό εγγραφής παρακολούθησης που εκδίδει ο πάροχος και επιστρέφεται από την τεκμηριωμένη διαδικασία καταχώρισης. Αν ο πάροχος υποστηρίζει αναφορά εμπόρου, χρησιμοποιήστε μια αδιαφανή εσωτερική αναφορά και διατηρήστε την αντιστοίχιση τοπικά.
Για τις εισερχόμενες ενημερώσεις, επιλύστε πρώτα το αποθηκευμένο αναγνωριστικό εγγραφής παρόχου στον σωστό λογαριασμό παρόχου και μισθωτή. Αν αυτό το αναγνωριστικό δεν είναι διαθέσιμο, χρησιμοποιήστε τον τεκμηριωμένο συνδυασμό αριθμού παρακολούθησης, ταυτότητας μεταφορέα, πλαισίου λογαριασμού και ιστορικού αντιστοίχισης. Αντιμετωπίστε το ως στρατηγική αναζήτησης και όχι ως εγγύηση ότι ο συνδυασμός είναι παγκοσμίως μοναδικός.
Μην αντιστοιχίζετε με βάση το όνομα ή τη διεύθυνση email του πελάτη ή έναν μη οριοθετημένο εμφανιζόμενο αριθμό παραγγελίας. Διατηρείτε τους αριθμούς παρακολούθησης ως συμβολοσειρές ώστε να διατηρούνται τα αρχικά μηδενικά. Αποφεύγετε την αφαίρεση χαρακτήρων ή την αλλαγή πεζών-κεφαλαίων, εκτός αν το επιτρέπει η σχετική σύμβαση μεταφορέα ή παρόχου.
Αν μια αναζήτηση δεν επιστρέψει αντιστοίχιση ή επιστρέψει πολλές πιθανές αντιστοιχίσεις, θέστε την ενημέρωση σε καραντίνα για διερεύνηση. Ένα ανεπίλυτο συμβάν είναι ασφαλέστερο από μια βέβαιη ενημέρωση στην παραγγελία λάθος πελάτη.
Διαχειριστείτε τις χωριστές παραγγελίες χωρίς να επινοείτε κατανομές δεμάτων
Εξετάστε μια ενδεικτική παραγγελία που περιέχει τρεις μονάδες. Το Δέμα A μεταφέρει δύο μονάδες και το Δέμα B μία. Η παράδοση του Δέματος A σημαίνει ότι υπάρχουν αποδεικτικά παράδοσης για δύο μονάδες· δεν σημαίνει ότι παραδόθηκε ολόκληρη η παραγγελία.
Αν το σύστημα εκτέλεσης καταγράφει μόνο ότι και τα δύο δέματα ανήκουν στην ίδια εκτέλεση, μην επινοείτε κατανομές σε επίπεδο μονάδας. Μπορείτε ακόμη να υπολογίσετε αν παραδόθηκαν όλα τα απαιτούμενα δέματα, όμως η αναφορά παράδοσης σε επίπεδο είδους πρέπει να παραμένει μη διαθέσιμη ή ρητά αβέβαιη μέχρι να υπάρχουν δεδομένα κατανομής.
Συνδέστε το API παρακολούθησης μέσω ενός ανθεκτικού επιπέδου εισαγωγής
Χρησιμοποιήστε μια διοχέτευση που διατηρεί χωριστή την επικοινωνία με τον πάροχο από τις εγγραφές στο OMS:
Δημιουργία αποστολής → καταχώριση παρακολούθησης → εισερχόμενη ενημέρωση ή προγραμματισμένη ανάκτηση → ανθεκτική αποθήκευση συμβάντος → αντιστοίχιση και κανονικοποίηση → ενημέρωση OMS → συμφωνία
Για μια υλοποίηση 17TRACK, η σελίδα προϊόντος Tracking API και η επίσημη τεκμηρίωση API αποτελούν τα σχετικά σημεία εκκίνησης. Επιβεβαιώστε τη σχετική διεπαφή καταχώρισης, τα αναγνωριστικά μεταφορέων, τις επιλογές παράδοσης ενημερώσεων, τις απαιτήσεις ελέγχου ταυτότητας, τους ορισμούς καταστάσεων και τα όρια λογαριασμού πριν υλοποιήσετε τον προσαρμογέα. Το μοντέλο δεδομένων αυτού του οδηγού αποτελεί σύσταση ολοκλήρωσης και δεν ισχυρίζεται ότι η 17TRACK χρησιμοποιεί αυτά τα ονόματα πεδίων ή παρέχει εγγενή σύνδεση για το OMS σας.
Αν ο επιλεγμένος πάροχος υποστηρίζει webhooks, ελέγξτε την ταυτότητα των εισερχόμενων αιτημάτων χρησιμοποιώντας τον τεκμηριωμένο μηχανισμό του και αποθηκεύστε με ανθεκτικό τρόπο τα αποδεκτά μηνύματα πριν τα επιβεβαιώσετε. Διατηρήστε τις αργές εργασίες OMS εκτός της διαδρομής αιτήματος. Ακολουθήστε την πραγματική σύμβαση επιβεβαίωσης και επανάληψης του παρόχου αντί να υποθέτετε συγκεκριμένο σώμα απόκρισης ή χρονικό όριο.
Αν απαιτείται polling, αποθηκεύστε την πρόοδο ανάκτησης όπου το υποστηρίζει το API, ελέγξτε τον ταυτόχρονο αριθμό αιτημάτων και ακολουθήστε τα τεκμηριωμένα όρια ρυθμού. Ούτε η λήψη webhook ούτε ένα επιτυχές αίτημα polling αποδεικνύουν ότι ενημερώθηκε το OMS· καταγράψτε αυτά τα αποτελέσματα ξεχωριστά.
Καθορίστε κανόνες συγχρονισμού που αντέχουν σε επαναλήψεις και καθυστερημένα συμβάντα
1. Κάντε την επεξεργασία ιδεμποτέντη
Η επεξεργασία της ίδιας παρατήρησης δύο φορές δεν πρέπει να δημιουργεί διπλότυπη αποστολή, να αυξάνει δύο φορές τις ποσότητες ή να στέλνει ξανά την ίδια ειδοποίηση πελάτη. Το HTTP δεν καθιστά μια αυθαίρετη λειτουργία POST ιδεμποτέντη· η ολοκλήρωση πρέπει να εφαρμόζει προστασία από διπλότυπα. Το RFC 9110 εξηγεί την ιδεμποτένεια των μεθόδων HTTP.
Χρησιμοποιήστε ένα σταθερό αναγνωριστικό συμβάντος παρόχου όταν τεκμηριώνεται και είναι διαθέσιμο. Διαφορετικά, ορίστε ένα αποτύπωμα από το αναγνωριστικό αντιστοίχισης και τα σχετικά πεδία συμβάντος, όπως τη χρονική σήμανση, την κατάσταση πηγής και την τοποθεσία. Καταγράψτε την πιθανότητα συγκρούσεων ή αλλαγών στις περιγραφές συμβάντων. Διατηρείτε την ακατέργαστη παρατήρηση ακόμη και όταν δεν προκαλεί άλλη ενέργεια στο OMS.
Προστατεύστε κάθε παρενέργεια ξεχωριστά. Για παράδειγμα, μια εγγραφή κατάστασης στο OMS και μια ειδοποίηση email χρειάζονται τους δικούς τους ελέγχους αποδιπλοποίησης. Χρησιμοποιήστε transactional outbox ή αντίστοιχη ανθεκτική εγγραφή εργασίας, ώστε μια κατάρρευση διεργασίας να μην αφήσει αποδεκτό συμβάν χωρίς προγραμματισμένη ενημέρωση.
2. Αποθηκεύστε χωριστά τον χρόνο συμβάντος και τον χρόνο λήψης
Ο χρόνος κατά τον οποίο συνέβη ένα συμβάν και ο χρόνος κατά τον οποίο το έλαβε η ολοκλήρωσή σας απαντούν σε διαφορετικά ερωτήματα. Αποθηκεύστε και τους δύο, μαζί με την αρχική αναπαράσταση της χρονικής σήμανσης και τυχόν παρεχόμενη μετατόπιση ζώνης ώρας. Μην εκχωρείτε σιωπηρά τη ζώνη ώρας της αποθήκης σε συμβάν του οποίου η ζώνη ώρας είναι άγνωστη.
Μια καθυστερημένη σάρωση κατά τη μεταφορά συνήθως πρέπει να εμπλουτίζει το ιστορικό χωρίς να αντικαθιστά μια νεότερη κατάσταση παράδοσης. Ωστόσο, οι χρονικές σημάνσεις από μόνες τους δεν επαρκούν: ένας πάροχος μπορεί να εκδώσει διόρθωση και τα συμβάντα μπορεί να έχουν ελλιπείς πληροφορίες χρόνου. Χρησιμοποιήστε τεκμηριωμένα πεδία ακολουθίας ή αναθεώρησης όταν είναι διαθέσιμα, μαζί με σαφή πολιτική διορθώσεων.
3. Κανονικοποιήστε τις καταστάσεις χωρίς να διαγράφετε τις λεπτομέρειες της πηγής
Δημιουργήστε ένα μικρό εσωτερικό λεξιλόγιο που κατανοεί το OMS, όπως αναμονή αποδοχής από μεταφορέα, σε μεταφορά, προς παράδοση, παραδόθηκε, εξαίρεση και επιστρέφεται. Αντιστοιχίστε σε αυτό τις τεκμηριωμένες καταστάσεις του παρόχου. Αυτές είναι προτεινόμενες εσωτερικές κατηγορίες και όχι καθολικοί ορισμοί μεταφορέων.
Αποθηκεύστε τον αρχικό κωδικό κατάστασης, την περιγραφή, την τοποθεσία συμβάντος, την αναφορά εγγραφής παρόχου και την έκδοση του κανόνα αντιστοίχισης. Μια μη αντιστοιχισμένη τιμή πρέπει να δημιουργεί μια συνθήκη προς εξέταση αντί να ορίζεται από προεπιλογή ως παραδοθείσα ή αποτυχημένη. Η δημιουργία ετικέτας δεν πρέπει να θεωρείται απόδειξη φυσικής αποδοχής από τον μεταφορέα, εκτός αν το συμβάν της πηγής υποστηρίζει ρητά αυτή την ερμηνεία.
4. Χρησιμοποιήστε κανόνες μετάβασης και όχι απλή αριθμητική κατάταξη
Οι καταστάσεις αποστολής δεν ακολουθούν πάντα ευθεία διαδρομή. Μια εξαίρεση μπορεί να ακολουθηθεί από κανονική μεταφορά και μια προσπάθεια παράδοσης δεν είναι παράδοση. Η επιστροφή μπορεί να ξεκινήσει μετά από προηγούμενο συμβάν παράδοσης.
- Επιτρέψτε την άρση μιας εξαίρεσης όταν μεταγενέστερα στοιχεία υποστηρίζουν την επανέναρξη της μετακίνησης.
- Αποτρέψτε μια συνηθισμένη ιστορική σάρωση από το να αντικαθιστά σιωπηρά μια κατάσταση παραδόθηκε.
- Επιτρέψτε μια τεκμηριωμένη διόρθωση μέσω ελεγχόμενης διαδρομής αναθεώρησης.
- Παρακολουθείτε την κίνηση επιστροφής χωριστά από την ολοκλήρωση εξερχόμενης αποστολής όπου το υποστηρίζει το OMS.
- Δρομολογείτε αμφίβολα ή αντιφατικά στοιχεία σε επιχειρησιακή ουρά.
Εκδώστε αυτές τις规则 σε εκδόσεις. Όταν αλλάζει μια αντιστοίχιση, αποφασίστε αν ισχύει μόνο για νέα συμβάντα ή αν οι ιστορικές εγγραφές χρειάζονται ελεγχόμενο επανυπολογισμό.
Υπολογίστε την κατάσταση παραγγελίας από τις απαιτούμενες υποχρεώσεις εκτέλεσης
Η κατάσταση δέματος και η κατάσταση παραγγελίας πρέπει να είναι ξεχωριστά πεδία. Ένα δέμα που σημειώνεται ως παραδοθέν παρέχει στοιχεία για αυτό το δέμα· η ολοκλήρωση της παραγγελίας εξαρτάται από τις υπόλοιπες απαιτούμενες ποσότητες και την επιχειρηματική σας πολιτική.
Μια χρήσιμη προεπιλογή είναι να σημειώνετε μια παραγγελία ως πλήρως παραδοθείσα μόνο όταν όλες οι ποσότητες που απαιτούν παράδοση έχουν έγκυρα στοιχεία παράδοσης σε επίπεδο δέματος και δεν παραμένουν άλυτες απαιτούμενες κατανομές. Εξαιρέστε τις ακυρωμένες ποσότητες σύμφωνα με τους κανόνες ακύρωσης του OMS. Διαχειριστείτε τα ψηφιακά είδη, τις παραγγελίες παραλαβής και άλλες μη αποστολικές υποχρεώσεις μέσω των δικών τους συνθηκών ολοκλήρωσης.
Οι αποστολές αντικατάστασης χρειάζονται ρητές σχέσεις. Αν ένα χαμένο δέμα αντικατασταθεί, αποφασίστε αν η αντικατάσταση υπερισχύει της αρχικής υποχρέωσης παράδοσης. Διαφορετικά, το αρχικό δέμα μπορεί να εμποδίζει επ' αόριστον την ολοκλήρωση ή και τα δύο δέματα μπορεί να υπολογίζονται στην εκτέλεση. Καταγράψτε την απόφαση αντί να την εξάγετε μόνο από την κατάσταση παρακολούθησης.
Διατηρήστε την ολοκλήρωση παράδοσης χωριστά από το οικονομικό κλείσιμο, την επιλεξιμότητα επιστροφής χρημάτων και την επίλυση διαφορών. Ένα συμβάν παράδοσης μεταφορέα δεν πρέπει να εγκρίνει αυτόματα επιστροφή χρημάτων ή να διευθετεί αξίωση πελάτη.
Ανακάμψτε από αστοχίες χωρίς να χάσετε το ίχνος ελέγχου
Επαναλάβετε τις προσωρινές αποτυχίες χρησιμοποιώντας περιορισμένη εκθετική καθυστέρηση και τυχόν τεκμηριωμένες οδηγίες επανάληψης. Διαχωρίστε τις προσωρινές αποτυχίες σύνδεσης από τα μη έγκυρα αναγνωριστικά, τα διαπιστευτήρια που έχουν λήξει, τα σφάλματα δικαιωμάτων και τις ασυμβατότητες σχήματος. Τα τελευταία απαιτούν διορθωτικές ενέργειες και όχι ατελείωτες επαναλήψεις.
Διατηρήστε ουρά αποτυχημένων εργασιών που περιέχει τον επηρεαζόμενο μισθωτή, το δέμα, την αναφορά συμβάντος, την απόπειρα λειτουργίας, την ταξινόμηση σφάλματος και την επόμενη ενέργεια. Καταγράψτε αρκετό πλαίσιο για διερεύνηση χωρίς να αντιγράφετε περιττά δεδομένα πελατών ή διαπιστευτήρια στα αρχεία καταγραφής.
Εκτελείτε συμφωνία επιπλέον της κανονικής διαδρομής ενημέρωσης. Εξετάζετε ενεργές αποστολές με παρωχημένες πληροφορίες παρακολούθησης, αποδεκτά συμβάντα των οποίων οι εγγραφές OMS απέτυχαν, μη αντιστοιχισμένες παρατηρήσεις και διαφορές μεταξύ της υπολογισμένης κατάστασης της ολοκλήρωσης και του OMS. Επιλέξτε τη συχνότητα ελέγχου με βάση τις δεσμεύσεις παράδοσης, τα όρια API και τον επιχειρησιακό κίνδυνο αντί να εφαρμόζετε ένα αυθαίρετο καθολικό πρόγραμμα.
Κατανείμετε την ευθύνη: η μηχανική διαχειρίζεται τις αποτυχίες εισαγωγής και εγγραφής, οι λειτουργίες εκτέλεσης επιλύουν τις ελλείπουσες σχέσεις δεμάτων και η εξυπηρέτηση πελατών εξετάζει τις εξαιρέσεις που απαιτούν επικοινωνία με τον πελάτη. Μια ουρά χωρίς υπεύθυνο είναι απλώς ένας χώρος αποθήκευσης.
Δοκιμάστε την αντιστοίχιση και τους επιχειρηματικούς κανόνες πριν από την έναρξη
Χρησιμοποιήστε ελεγχόμενα δεδομένα δοκιμής και περιορισμένη κυκλοφορία στην παραγωγή. Δοκιμάστε τις ακόλουθες περιπτώσεις τόσο σε σχέση με το ιστορικό συμβάντων όσο και με την τελική εγγραφή OMS:
- Μια παραγγελία ενός δέματος προχωρά κανονικά έως την παράδοση.
- Μια χωριστή παραγγελία έχει ένα παραδοθέν δέμα και ένα που εξακολουθεί να κινείται.
- Το ίδιο συμβάν λαμβάνεται επανειλημμένα χωρίς διπλές παρενέργειες.
- Μια παλαιότερη σάρωση μεταφοράς φτάνει μετά την παράδοση.
- Ένας άγνωστος μεταφορέας ή κατάσταση εισέρχεται στην ουρά ελέγχου.
- Μια ετικέτα αντικαθίσταται χωρίς να δημιουργηθεί νέα υποχρέωση εκτέλεσης.
- Μια αποστολή αντικατάστασης υπερισχύει ενός αρχικού δέματος βάσει εγκεκριμένου κανόνα.
- Το OMS δεν είναι διαθέσιμο αφού γίνει αποδεκτό ένα συμβάν.
- Μια διεργασία επανεκκινείται μεταξύ της εγγραφής στο OMS και της επιβεβαίωσής της.
- Ο ίδιος εμφανιζόμενος αριθμός παραγγελίας υπάρχει σε δύο καταστήματα χωρίς αντιστοίχιση μεταξύ μισθωτών.
Ξεκινήστε όταν κάθε αποδεκτό συμβάν έχει ανιχνεύσιμο αποτέλεσμα επεξεργασίας, οι αμφίβολες αντιστοιχίσεις δεν μπορούν να ενημερώνουν αυτόματα παραγγελίες και οι χειριστές μπορούν να επαναλαμβάνουν με ασφάλεια τις αποτυχημένες εργασίες. Αυτά αποτελούν πιο χρήσιμα κριτήρια αποδοχής από την απλή επίδειξη ότι ένα αίτημα API ολοκληρώνεται επιτυχώς.
Συχνές ερωτήσεις
Μπορώ να συνδέσω απευθείας τους αριθμούς παρακολούθησης με τις παραγγελίες;
Για μια αυστηρά μονοδεματική ροή, μια άμεση σχέση μπορεί αρχικά να επαρκεί. Ωστόσο, χρησιμοποιήστε μια εσωτερική ταυτότητα αποστολής μεταξύ της παραγγελίας και της αντιστοίχισης παρακολούθησης. Παρέχει διαδρομή μετάβασης για χωριστές αποστολές, αλλαγή ετικέτας και αντικαταστάσεις χωρίς να αλλάζει η σημασία της εγγραφής παραγγελίας.
Πρέπει η ολοκλήρωση να χρησιμοποιεί webhooks ή polling;
Χρησιμοποιήστε τον μηχανισμό παράδοσης που υποστηρίζει ο πάροχος και είναι συμβατός με την υποδομή σας. Τα webhooks μπορούν να μειώσουν τις επαναλαμβανόμενες ανακτήσεις, ενώ το polling μπορεί να υποστηρίξει ροές εργασίας και συμφωνίες που βασίζονται στην ανάκτηση, όπου είναι διαθέσιμο. Καμία προσέγγιση δεν καταργεί την ανάγκη για ανθεκτική αποθήκευση, διαχείριση διπλοτύπων και ανάκτηση.
Τι πρέπει να συμβεί όταν ένα συμβάν παρακολούθησης δεν έχει αντίστοιχη παραγγελία;
Αποθηκεύστε το σε ουρά μη αντιστοιχισμένων συμβάντων και διερευνήστε την εγγραφή καταχώρισης, το πλαίσιο μισθωτή, την ταυτότητα μεταφορέα και τον χρόνο δημιουργίας αποστολής. Μην δημιουργείτε αυτόματα παραγγελία και μην συνδέετε το συμβάν με έναν πιθανό πελάτη. Επαναλάβετε την επεξεργασία του αφού διορθωθεί η αντιστοίχιση.
Πρέπει οι ειδοποιήσεις παράδοσης να προέρχονται από το OMS ή το σύστημα παρακολούθησης;
Επιλέξτε έναν υπεύθυνο για κάθε τύπο και έναυσμα ειδοποίησης. Αν δύο συστήματα μπορούν να στείλουν το ίδιο μήνυμα, απενεργοποιήστε τη μία διαδρομή ή μοιραστείτε ένα ανθεκτικό καθολικό ειδοποιήσεων. Αποφασίστε επίσης αν ένα μήνυμα αφορά ένα δέμα ή ολόκληρη την παραγγελία, ειδικά για χωριστή εκτέλεση.
Σημαίνει μια κατάσταση εξαίρεσης ότι η παραγγελία απέτυχε;
Όχι. Η εξαίρεση είναι μια παρατήρηση που απαιτεί ερμηνεία και όχι απαραίτητα μόνιμο αποτέλεσμα. Διατηρήστε την αιτία, παρακολουθήστε τα επόμενα συμβάντα και χρησιμοποιήστε την πολιτική κλιμάκωσής σας για να αποφασίσετε πότε πρέπει να παρέμβουν οι λειτουργίες.
Πηγές
- 17TRACK Tracking API — επίσημη αναφορά προϊόντος για το σημείο εκκίνησης της ολοκλήρωσης API.
- 17TRACK API documentation — αναφορά υλοποίησης για τη σύμβαση του παρόχου· επαληθεύστε τις ισχύουσες διεπαφές και απαιτήσεις λογαριασμού πριν από την ανάπτυξη.
- RFC 9110, Section 9.2.2: Idempotent Methods — σημασιολογία HTTP που υποστηρίζει τη διάκριση μεταξύ ιδεμποτένειας μεθόδων και προστασίας από διπλότυπα σε επίπεδο εφαρμογής.


