Skip to main content
ΑρχικήΙστολόγιοΟδηγοί6 έλεγχοι για την επαλήθευση των πιο πρόσφατων συμβάντων παρακολούθησης μεταφορέα που συγχρονίστηκαν μέσω του API σας

6 έλεγχοι για την επαλήθευση των πιο πρόσφατων συμβάντων παρακολούθησης μεταφορέα που συγχρονίστηκαν μέσω του API σας

17TRACK

Για να επαληθεύσετε ότι το API σας έχει συγχρονίσει τα πιο πρόσφατα συμβάντα παρακολούθησης του μεταφορέα, ελέγξτε την ταυτότητα της αποστολής, τις χρονικές σημάνσεις των συμβάντων, τις λεπτομέρειες των συμβάντων, τη διαδρομή παράδοσης, τη σειρά των συμβάντων και την επικαιρότητα, συγκρίνοντάς τα με μια ανεξάρτητη προβολή παρακολούθησης. Μια επιτυχής απόκριση API ή επιβεβαίωση webhook επιβεβαιώνει μόνο ένα μέρος αυτής της αλυσίδας· από μόνη της δεν αποδεικνύει ότι η εφαρμογή σας διαθέτει το νεότερο συμβάν του μεταφορέα.

6 Checks to Verify the Latest Carrier Tracking Events Synced

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

Πριν ξεκινήσετε: ορίστε τι σημαίνει «πιο πρόσφατο»

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

Επιλέξτε ένα σημείο σύγκρισης πριν από τη διερεύνηση. Ιδανικά, χρησιμοποιήστε τη σελίδα παρακολούθησης του μεταφορέα ή άλλη εξουσιοδοτημένη εγγραφή που παρέχεται από τον μεταφορέα για την ίδια αποστολή. Αν αυτό δεν είναι διαθέσιμο, συγκρίνετε την εφαρμογή σας με την τρέχουσα απόκριση API του παρόχου παρακολούθησης. Αυτή η πιο περιορισμένη σύγκριση μπορεί να επιβεβαιώσει αν η εφαρμογή σας συμφωνεί με τον πάροχο· δεν μπορεί να επιβεβαιώσει ότι ο πάροχος διαθέτει ήδη κάθε σάρωση του μεταφορέα. Καταγράψτε πότε πραγματοποιήσατε τη σύγκριση, ώστε μια μεταγενέστερη ενημέρωση να μην κάνει ένα προηγούμενο αποτέλεσμα να φαίνεται ασυνεπές.

1. Επιβεβαιώστε ότι και τα δύο συστήματα αναφέρονται στην ίδια αποστολή

Ξεκινήστε με τον αριθμό παρακολούθησης, τον μεταφορέα και οποιοδήποτε αναγνωριστικό λογαριασμού ή αποστολής χρησιμοποιείται από την ενσωμάτωσή σας. Οι αριθμοί παρακολούθησης από μόνοι τους μπορεί να μην επαρκούν για την αντιμετώπιση προβλημάτων: ένας αριθμός μπορεί να καταχωριστεί με τυπογραφικό λάθος, να συσχετιστεί με λάθος μεταφορέα ή να επαναχρησιμοποιηθεί σε μια εσωτερική εγγραφή μετά την επεξεργασία μιας παραγγελίας. Ο αριθμός παραγγελίας και ο αριθμός παρακολούθησης εξυπηρετούν επίσης διαφορετικούς σκοπούς. Μία παραγγελία μπορεί να έχει πολλά δέματα, επομένως ο έλεγχος της πιο πρόσφατης κατάστασης της παραγγελίας μπορεί να αποκρύψει ένα παρωχημένο δέμα.

  • Βρείτε τον ακριβή αριθμό παρακολούθησης και τον μεταφορέα που υποβλήθηκαν στο tracking API.
  • Επιβεβαιώστε ποια εσωτερική εγγραφή αποστολής ή δέματος έλαβε την απόκριση.
  • Ελέγξτε αν η αποστολή αντικαταστάθηκε, διαχωρίστηκε, ακυρώθηκε ή συσχετίστηκε εκ νέου μετά την εγγραφή.
  • Συγκρίνετε τον μεταφορέα και τον αριθμό που εμφανίζονται στην αρχική εγγραφή με αυτά που εμφανίζονται στην εφαρμογή σας.

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

2. Συγκρίνετε τους χρόνους των συμβάντων χωρίς να χάσετε το νόημά τους

Για κάθε υποψήφιο πιο πρόσφατο συμβάν, καταγράψτε τον χρόνο εμφάνισης που αναφέρει ο μεταφορέας, τη δηλωμένη ζώνη ώρας ή μετατόπιση, εφόσον παρέχεται, καθώς και τους χρόνους λήψης και αποθήκευσης από την εφαρμογή σας. Μετατρέψτε τις χρονικές σημάνσεις σε κοινή βάση χρόνου για τη σύγκριση, αλλά διατηρήστε την αρχική τιμή. Το RFC 3339 ορίζει μια μορφή χρονικής σήμανσης διαδικτύου με ρητές πληροφορίες μετατόπισης· αποτελεί χρήσιμη αναφορά κατά τον σχεδιασμό των δικών σας πεδίων χρονικής σήμανσης. Δεν εγγυάται ότι ένας μεταφορέας ή πάροχος παρέχει ζώνη ώρας για κάθε συμβάν.

Μια προβολή που εμφανίζει μόνο την ώρα, μια υποτιθέμενη τοπική ζώνη ή ένας αναλυτής που απορρίπτει σιωπηρά μια μετατόπιση μπορεί να μετακινήσει ένα συμβάν σε άλλη ημερολογιακή ημέρα ή να το τοποθετήσει σε λάθος σειρά. Όταν η πηγή παρέχει αμφίσημη τοπική ώρα, σημειώστε τη σύγκριση ως αβέβαιη αντί να επινοήσετε μια ακριβή χρονική στιγμή UTC. Διακρίνετε επίσης τον χρόνο εμφάνισης ενός συμβάντος από τον χρόνο απόκρισης του API: μια απόκριση που ανακτήθηκε τώρα μπορεί νόμιμα να περιέχει ένα συμβάν που συνέβη νωρίτερα.

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

3. Ελέγξτε το φορτίο του συμβάντος, όχι μόνο την κύρια κατάσταση

Συγκρίνετε την περιγραφή, την τοποθεσία, την κατάσταση ή τον κωδικό του μεταφορέα και τυχόν σχετικά πεδία παράδοσης του πιο πρόσφατου συμβάντος με την εγγραφή ανάντη. Μια κανονικοποιημένη κατάσταση όπως «σε μεταφορά» μπορεί να συνοψίζει αρκετές διαφορετικές σαρώσεις. Αν η εφαρμογή σας αποθηκεύει μόνο τη σύνοψη, μπορεί να φαίνεται αμετάβλητη ακόμη και όταν έχει φτάσει ένα νέο συμβάν.

Επιθεωρήστε την ακατέργαστη απόκριση API ή το διατηρημένο σώμα webhook, όπου το επιτρέπουν οι κανόνες χειρισμού δεδομένων σας. Στη συνέχεια ακολουθήστε το συμβάν στη διαδικασία ανάλυσης, αντιστοίχισης πεδίων, αποθήκευσης και παρουσίασης. Αναζητήστε πεδία null που αντικαθίστανται από προεπιλογές, απροσδόκητους κωδικούς κατάστασης που καταλήγουν σε μια γενική κατηγορία, περικοπή κειμένου ή μια διεπαφή χρήστη που εμφανίζει μόνο επιλεγμένους τύπους συμβάντων. Μια ασυμφωνία στην ετικέτα κατάστασης διαφέρει από ένα συμβάν που λείπει: υποδεικνύει λογική μετασχηματισμού ή εμφάνισης και όχι παράδοσης.

Μην συμπεραίνετε ότι έγινε παράδοση μόνο επειδή μια τοποθεσία ή κατάσταση ακούγεται οριστική. Επιβεβαιώστε το συγκεκριμένο συμβάν και τα πεδία στα οποία βασίζεται η ροή εργασίας σας. Αντίστροφα, μια αμετάβλητη υψηλού επιπέδου κατάσταση δεν αποδεικνύει ότι ο συγχρονισμός σταμάτησε· μια νέα σάρωση μπορεί να αντιστοιχιστεί στην ίδια κατηγορία. Η διαγνωστική σας εγγραφή θα πρέπει να διατηρεί τόσο το συμβάν ανάντη όσο και την τιμή που εμφανίζεται στους χρήστες.

4. Εντοπίστε πώς έφτασε το συμβάν στην εφαρμογή σας

Αν χρησιμοποιείτε webhooks, ελέγξτε το αρχείο καταγραφής λήψης για τη σχετική αποστολή και το συμβάν. Επαληθεύστε ότι το endpoint σας αποδέχτηκε το αίτημα, ότι το μήνυμα πέρασε την επικύρωση και ότι η επεξεργασία κατάντη ολοκληρώθηκε. Μια επιτυχής απόκριση HTTP από το endpoint σας δεν αποδεικνύει ότι ένας μεταγενέστερος worker ουράς αποθήκευσε το συμβάν. Αν η επεξεργασία είναι ασύγχρονη, εξετάστε τόσο το εισερχόμενο αίτημα όσο και το αποτέλεσμα της εργασίας.

Αν πραγματοποιείτε polling σε ένα API, ελέγξτε το τελευταίο ολοκληρωμένο αίτημα, το αναγνωριστικό αποστολής σε αυτό το αίτημα, την απόκρισή του και οποιαδήποτε λογική σελιδοποίησης ή ανάκτησης χρησιμοποιεί η ενσωμάτωσή σας. Ένα επιτυχές αίτημα μπορεί και πάλι να ακολουθηθεί από αποτυχημένη εγγραφή στη βάση δεδομένων ή ανάγνωση παρωχημένης cache. Χρησιμοποιήστε την ισχύουσα τεκμηρίωση του παρόχου για να επαληθεύσετε τα πραγματικά πεδία απόκρισης, τις απαιτήσεις ελέγχου ταυτότητας και τη συμπεριφορά παράδοσης για την ενσωμάτωσή σας, αντί να υποθέτετε ότι κάθε tracking API ακολουθεί το ίδιο συμβόλαιο. Για μια ενσωμάτωση 17TRACK, τα σχετικά σημεία εκκίνησης είναι η σελίδα Tracking API και η τεκμηρίωση API· επιβεβαιώστε την τεκμηριωμένη συμπεριφορά για το endpoint και τη μέθοδο που χρησιμοποιείτε.

Κάντε την επεξεργασία των συμβάντων ασφαλή για επανάληψη. Μια επανάληψη δεν θα πρέπει να δημιουργεί διπλές σαρώσεις, να στέλνει επανειλημμένα την ίδια ειδοποίηση πελάτη ή να αντικαθιστά μια νεότερη αποθηκευμένη κατάσταση με ένα παλαιότερο φορτίο. Το κατάλληλο κλειδί διπλοτύπου εξαρτάται από τα πεδία που παρέχει πράγματι ο πάροχός σας. Ελέγξτε το επιλεγμένο κλειδί σας έναντι διαφορετικών συμβάντων που τυχαίνει να έχουν κοινή κατάσταση ή χρονική σήμανση· αυτά τα συμβάντα δεν θα πρέπει να συγχωνεύονται απλώς επειδή μοιάζουν.

5. Επαληθεύστε τους κανόνες σειράς και μετάβασης κατάστασης

Ταξινομήστε τα καταγεγραμμένα συμβάντα βάσει ενός σαφώς καθορισμένου κανόνα και στη συνέχεια επιθεωρήστε το αποτέλεσμα. Πολλές εφαρμογές χρειάζεται να διακρίνουν το «πιο πρόσφατο συμβάν που συνέβη» από το «πιο πρόσφατο συμβάν που λάβαμε». Μια καθυστερημένη παλαιότερη σάρωση μπορεί να φτάσει μετά από μια νεότερη σάρωση. Αν η βάση δεδομένων σας κάνει απλώς την πιο πρόσφατα επεξεργασμένη հաղորդία την τρέχουσα κατάσταση αποστολής, αυτή η καθυστερημένη σάρωση μπορεί να επαναφέρει την εμφανιζόμενη κατάσταση.

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

Για μια πρακτική δοκιμή, πάρτε μια αποστολή με περισσότερα από ένα συμβάντα και επαναλάβετε τα μηνύματά της με διαφορετική σειρά άφιξης σε περιβάλλον μη παραγωγής. Επιβεβαιώστε ότι το ιστορικό συμβάντων παραμένει ακέραιο και ότι η κατάσταση που εμφανίζεται στον πελάτη ακολουθεί τον τεκμηριωμένο κανόνα σας. Αυτό αποκαλύπτει ελαττώματα σειράς που μια κανονική δοκιμή με τη σωστή σειρά δεν μπορεί να αποκαλύψει.

6. Μετρήστε την επικαιρότητα και συμφιλιώστε τις εξαιρέσεις

Τέλος, συγκρίνετε τι γνώριζε κάθε επίπεδο στο ίδιο σημείο παρατήρησης: προβολή μεταφορέα, απόκριση παρόχου παρακολούθησης, εισερχόμενο webhook ή αποτέλεσμα polling, εγγραφή βάσης δεδομένων και έξοδο που απευθύνεται στον πελάτη. Σημειώστε το πρώτο επίπεδο στο οποίο εξαφανίζεται το αναμενόμενο συμβάν. Αυτό το όριο είναι πιο χρήσιμο από μια γενική αναφορά ότι «η παρακολούθηση καθυστερεί».

Μετρήστε τόσο την ηλικία του πιο πρόσφατου συμβάντος που αναφέρει ο μεταφορέας όσο και τον χρόνο από τον τελευταίο επιτυχή έλεγχο ή την τελευταία επιτυχή λήψη δεδομένων από την ενσωμάτωσή σας. Απαντούν σε διαφορετικά ερωτήματα. Ένα δέμα μπορεί να μην έχει νέα σάρωση από τον μεταφορέα, παρότι η ενσωμάτωσή σας λειτουργεί σωστά· εναλλακτικά, ο μεταφορέας μπορεί να εμφανίζει νέα σάρωση ενώ το τελευταίο επιτυχές αίτημά σας είναι παλιό. Χρησιμοποιήστε κατώφλια ειδοποιήσεων που αντικατοπτρίζουν τις δικές σας λειτουργικές απαιτήσεις και τη συμπεριφορά που έχετε παρατηρήσει. Μην υπόσχεστε στους πελάτες σταθερό διάστημα ενημέρωσης, εκτός αν οι συμφωνίες σας με τον μεταφορέα και τον πάροχο το υποστηρίζουν.

Δημιουργήστε μια μικρή ουρά συμφιλίωσης για αποστολές των οποίων οι εγγραφές διαφέρουν από την επιλεγμένη πηγή σύγκρισης. Συμπεριλάβετε αναγνωριστικά, το συμβάν που λείπει ή δεν ταιριάζει, τις σχετικές χρονικές σημάνσεις, το πρώτο επίπεδο αποτυχίας και την επόμενη ενέργεια. Για παράδειγμα, ένα συμβάν που υπάρχει στην απόκριση του παρόχου αλλά απουσιάζει από τη βάση δεδομένων σας απαιτεί διερεύνηση της ενσωμάτωσης. Ένα συμβάν που υπάρχει στη βάση δεδομένων σας αλλά λείπει από τη σελίδα παρακολούθησης απαιτεί έλεγχο εμφάνισης ή cache. Αν ο ίδιος ο μεταφορέας δεν εμφανίζει νέα σάρωση, ένα ακόμη αίτημα API δεν μπορεί να τη δημιουργήσει.

Η λειτουργική δοκιμή είναι απλή: μπορείτε να αναγνωρίσετε την ίδια αποστολή, να εντοπίσετε το πιο πρόσφατο γνωστό συμβάν ανάντη και να ακολουθήσετε αυτό το συμβάν μέχρι την προβολή που βλέπει ο χρήστης, χωρίς να αλλάξετε το νόημά του; Αν όχι, οι έξι έλεγχοι περιορίζουν το πρόβλημα σε ένα συγκεκριμένο όριο και δίνουν στην ομάδα σας ένα τεκμηριωμένο επόμενο βήμα.

Συχνές ερωτήσεις

Σημαίνει μια επιτυχής απόκριση webhook ότι συγχρονίστηκε το πιο πρόσφατο συμβάν;

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

Γιατί η σελίδα του μεταφορέα εμφανίζει νεότερη σάρωση από την απόκριση του API μου;

Πρώτα επιβεβαιώστε ότι βλέπετε το ίδιο δέμα και ότι και οι δύο παρατηρήσεις έγιναν σε συγκρίσιμες χρονικές στιγμές. Η δημοσίευση από τον μεταφορέα και η λήψη ή εμφάνιση ενός συμβάντος από τον πάροχο παρακολούθησης μπορεί να γίνουν σε διαφορετικούς χρόνους. Αν η διαφορά παραμένει, χρησιμοποιήστε την τεκμηρίωση και τη διαδικασία υποστήριξης του παρόχου για να διερευνήσετε τη συγκεκριμένη αποστολή, αντί να υποθέσετε εγγύηση ενημέρωσης.

Πρέπει να χρησιμοποιώ τη χρονική σήμανση του συμβάντος ή την ώρα που το έλαβε το σύστημά μου για να επιλέξω την πιο πρόσφατη κατάσταση;

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

Τι γίνεται αν η κατάσταση του API δεν αλλάξει, αλλά η λίστα συμβάντων έχει νέα καταχώριση;

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

Πηγές