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

Παρακολουθήστε το δέμα, όχι τη συνδρομή
Μια συνδρομή σάς ενημερώνει για το τι έχει προγραμματιστεί να παραλάβει ένας πελάτης με την πάροδο του χρόνου. Μια παραγγελία εκτέλεσης σάς ενημερώνει για το τι πρέπει να αποσταλεί σε έναν κύκλο. Ένας αριθμός παρακολούθησης σάς ενημερώνει για ένα συγκεκριμένο δέμα. Η διατήρηση αυτών των εγγραφών ξεχωριστά αποτρέπει την εμφάνιση μιας καθυστερημένης αποστολής από έναν κύκλο στη σελίδα παρακολούθησης του επόμενου.
Για παράδειγμα, υποθέστε ότι ένα κουτί συνδρομής του Μαΐου χωρίζεται σε δύο δέματα και ότι το κουτί του Ιουνίου αποστέλλεται ενώ ένα δέμα του Μαΐου βρίσκεται ακόμη καθ’ οδόν. Ο πελάτης θα πρέπει να βλέπει δύο δέματα κάτω από την παραγγελία του Μαΐου και ένα ξεχωριστό δέμα κάτω από την παραγγελία του Ιουνίου. Η καθυστερημένη ενημέρωση του Μαΐου θα πρέπει να αλλάζει μόνο το δέμα του Μαΐου. Αν στείλετε αντικατάσταση, δημιουργήστε μια νέα εγγραφή αποστολής και συνδέστε την με την αρχική, ώστε η υποστήριξη να μπορεί να δει γιατί υπάρχουν και οι δύο.
- Συνδρομή: Αποθηκεύστε το ID συνδρομής, ώστε η υποστήριξη να μπορεί να βρει το ιστορικό αποστολών του πελάτη.
- Κύκλος και παραγγελία: Καταγράψτε το αναγνωριστικό κύκλου ή την προγραμματισμένη ημερομηνία εκτέλεσης, το ID παραγγελίας και τυχόν ID εκτέλεσης που απαιτούνται για την αντιστοίχιση των δεμάτων με τη σωστή παραγγελία. Μην συμπεραίνετε τον κύκλο από την ημερομηνία άφιξης ενός συμβάντος παρακολούθησης.
- Αποστολή: Δώστε σε κάθε δέμα ένα εσωτερικό ID αποστολής. Αποθηκεύστε τον μεταφορέα και τον αριθμό παρακολούθησης, τη σχετική αναφορά εκτέλεσης και τυχόν ID καταχώρισης παρακολούθησης που επιστρέφει ο πάροχος. Κρατήστε τις ακυρωμένες ετικέτες και τους αριθμούς παρακολούθησης που έχουν αντικατασταθεί εκτός της ενεργής προβολής του πελάτη, αλλά διατηρήστε το ιστορικό για την υποστήριξη.
Σε μια σελίδα παραγγελίας, εμφανίστε την πρόοδο σε επίπεδο δέματος μαζί με οποιαδήποτε σύνοψη παραγγελίας. Αν ένα δέμα έχει παραδοθεί και ένα άλλο βρίσκεται καθ’ οδόν, αναφέρετέ το. Εμφανίστε ολόκληρη την παραγγελία ως παραδοθείσα μόνο όταν έχουν φτάσει όλα τα δέματα που απαιτούνται για την ολοκλήρωσή της, λαμβάνοντας υπόψη τις ακυρωμένες αποστολές και τις αντικαταστάσεις.
Συνδέστε την εκτέλεση με το tracking API
- Καταχωρίστε από ένα συμβάν εκτέλεσης. Ενεργοποιήστε την καταχώριση όταν ένα σύστημα εκτέλεσης, μια αποθήκη ή ένας συνεργάτης logistics τρίτου μέρους στείλει τον μεταφορέα και τον αριθμό παρακολούθησης. Η πληρωμή ανανέωσης είναι πολύ νωρίς: η παραγγελία μπορεί να περιμένει ακόμη την αποστολή και μπορεί να μην υπάρχει αριθμός παρακολούθησης.
- Αποθηκεύστε την αποστολή πριν καλέσετε το API. Διατηρήστε την εσωτερική εγγραφή αποστολής και θέστε το αίτημα καταχώρισης σε ουρά. Αν το ίδιο μήνυμα εκτέλεσης φτάσει δύο φορές, χρησιμοποιήστε ξανά εκείνη την εγγραφή αντί να δημιουργήσετε άλλο δέμα. Αν η κλήση API λήξει λόγω χρονικού ορίου, ελέγξτε αν το αρχικό αίτημα πέτυχε πριν επιχειρήσετε ξανά, όταν ο πάροχος σάς προσφέρει τρόπο να το κάνετε.
- Αντιστοιχίστε τις ενημερώσεις στο καταχωρισμένο δέμα. Χρησιμοποιήστε το αναγνωριστικό καταχώρισης του παρόχου, αν επιστρέφεται στις ενημερώσεις. Διαφορετικά, αντιστοιχίστε με βάση τα αναγνωριστικά που καθορίζει η τεκμηρίωσή του και επικυρώστε το αποτέλεσμα με βάση τις εγγραφές αποστολών σας. Αν μια ενημέρωση θα μπορούσε να ανήκει σε περισσότερες από μία εγγραφές, στείλτε την για έλεγχο αντί να την εφαρμόσετε στην πιο πρόσφατη παραγγελία.
- Διαχωρίστε τη δημιουργία ετικέτας από τη μετακίνηση του μεταφορέα. Ένας αριθμός παρακολούθησης μπορεί να υπάρχει πριν ο μεταφορέας καταγράψει την παραλαβή. Χρησιμοποιήστε ένα μήνυμα όπως «Προετοιμασία για παραλαβή από τον μεταφορέα» όταν το μόνο που έχετε είναι μια ετικέτα. Κρατήστε την ένδειξη «Καθ’ οδόν» για πληροφορίες του μεταφορέα που την υποστηρίζουν.
Το 17TRACK Tracking API είναι μία επιλογή για αυτήν τη ρύθμιση. Η τεκμηρίωση για προγραμματιστές αποτελεί την αναφορά για την καταχώριση αριθμών παρακολούθησης και τη λήψη ενημερώσεων παρακολούθησης. Χρησιμοποιήστε αυτές τις ενημερώσεις για να διατηρείτε την εγγραφή του δέματος στο σύστημά σας· διατηρήστε την αντιστοίχιση κύκλου, την ολοκλήρωση παραγγελίας και τους κανόνες ειδοποίησης πελατών στην εφαρμογή ηλεκτρονικού εμπορίου σας. Πριν από την κυκλοφορία, δοκιμάστε με δέματα από τις πραγματικές διαδρομές των μεταφορέων και τους συνεργάτες εκτέλεσης, αντί να βασίζεστε μόνο σε μια λίστα μεταφορέων.
Κάντε τις ενημερώσεις ασφαλείς για επαναλαμβανόμενη επεξεργασία
Όταν ο πάροχός σας προσφέρει webhooks, χρησιμοποιήστε τα για να λαμβάνετε ενημερώσεις χωρίς να ελέγχετε συνεχώς κάθε δέμα. Ένα webhook είναι ένα αίτημα HTTP που στέλνει ο πάροχος στην εφαρμογή σας. Ακολουθήστε τις απαιτήσεις επαλήθευσης του παρόχου, αποθηκεύστε μόνιμα τα αποδεκτά payload και επιβεβαιώστε τα αιτήματα σύμφωνα με τους τεκμηριωμένους κανόνες απόκρισης. Εκτελέστε τις πιο αργές εργασίες, όπως την ενημέρωση των προβολών παραγγελιών ή την αποστολή email, εκτός του χειριστή αιτήματος.
Σχεδιάστε τη ροή επεξεργασίας έτσι ώστε μια επαναλαμβανόμενη ενημέρωση να μην έχει καμία επιπλέον επίδραση. Αν ο πάροχος παρέχει σταθερά ID συμβάντων, χρησιμοποιήστε τα για να αναγνωρίζετε τις επαναλήψεις. Αν στέλνει στιγμιότυπα παρακολούθησης αντί για μεμονωμένα συμβάντα, συγκρίνετε την εισερχόμενη κατάσταση και το ιστορικό σαρώσεων με όσα έχετε ήδη πριν ενεργήσετε. Αποδιπλοποιήστε ξεχωριστά τα μηνύματα πελατών: μια ειδοποίηση παράδοσης που έχει ήδη σταλεί δεν θα πρέπει να σταλεί ξανά μόνο και μόνο επειδή τα ίδια δεδομένα αποστολής υποβλήθηκαν σε επεξεργασία δύο φορές.
Διατηρήστε ξεχωριστό τον χρόνο κατά τον οποίο πραγματοποιήθηκε μια σάρωση από τον χρόνο κατά τον οποίο την έλαβε η εφαρμογή σας. Μια σάρωση καθ’ οδόν που έφτασε αργά μπορεί να ανήκει στο ιστορικό του δέματος χωρίς να αντικαθιστά μια νεότερη κατάσταση παράδοσης. Ωστόσο, μην υποθέτετε ότι κάθε νόμιμη αλλαγή μετακινεί ένα δέμα προς τα εμπρός. Μια διόρθωση του μεταφορέα ή μια ενημέρωση επιστροφής στον αποστολέα μπορεί να χρειάζεται να αλλάξει αυτό που εμφανίζετε. Αν τα νέα δεδομένα έρχονται σε σύγκρουση με την αποθηκευμένη κατάσταση και δεν μπορείτε να προσδιορίσετε ποια είναι σωστή, τοποθετήστε την αποστολή σε ουρά ελέγχου.
Εκτελείτε περιοδικό έλεγχο για ανοιχτές αποστολές που μπορεί να χρειάζονται προσοχή: καταχωρίσεις που εξακολουθούν να εκκρεμούν, δέματα χωρίς πρώτη σάρωση μετά από μια αναμενόμενη παράδοση και αποστολές των οποίων η παρακολούθηση έχει σταματήσει. Όταν το API υποστηρίζει αναζήτηση ή ανανέωση, χρησιμοποιήστε τα επιλεκτικά εντός των ορίων του παρόχου. Ελέγξτε το μοτίβο μεταξύ μεταφορέων και αποθηκών πριν κλιμακώσετε το ζήτημα. Αν οι ενημερώσεις σταματήσουν ταυτόχρονα για πολλές άσχετες αποστολές, διερευνήστε την ενσωμάτωση πριν ανοίξετε μεμονωμένες υποθέσεις παράδοσης.
Μετατρέψτε τα δεδομένα παρακολούθησης σε χρήσιμα μηνύματα για τους πελάτες
Οι πελάτες σπάνια χρειάζονται email για κάθε σάρωση. Ξεκινήστε με μηνύματα που συνδέονται με κάτι που πρέπει να γνωρίζουν ή να κάνουν: το δέμα έχει εισέλθει στο δίκτυο του μεταφορέα, μια απόπειρα παράδοσης απαιτεί ενέργεια ή ο μεταφορέας αναφέρει παράδοση. Εμφανίστε την αναφορά παραγγελίας και το σχετικό κουτί ή κύκλο, ώστε οι συνδρομητές να μπορούν να καταλάβουν για ποια αποστολή αφορά το μήνυμα. Για μια χωρισμένη παραγγελία, προσδιορίστε το δέμα και καταστήστε σαφές αν το υπόλοιπο της παραγγελίας βρίσκεται ακόμη καθ’ οδόν.
- Η ετικέτα δημιουργήθηκε, χωρίς σάρωση: Ελέγξτε την αναμενόμενη παράδοση με βάση τα αρχεία της αποθήκης. Αν το χρονικό περιθώριο παράδοσης έχει παρέλθει, ζητήστε από την εκτέλεση να επιβεβαιώσει αν το δέμα έφυγε από την εγκατάσταση πριν ενημερώσετε τον πελάτη ότι καθυστερεί καθ’ οδόν.
- Η παρακολούθηση έχει σταματήσει: Χρησιμοποιήστε όρια που αντικατοπτρίζουν τη διαδρομή και την υπηρεσία, αντί για έναν χρονομετρητή για κάθε δέμα. Για διασυνοριακές αποστολές, ελέγξτε το τελευταίο συμβάν του μεταφορέα πριν αποφασίσετε αν θα επικοινωνήσετε με τον πελάτη ή θα κλιμακώσετε το ζήτημα.
- Αποτυχημένη απόπειρα ή απαιτείται παραλαβή: Ενημερώστε τον πελάτη για την απαιτούμενη ενέργεια, αν ο μεταφορέας παρέχει σαφείς οδηγίες. Αν το συμβάν είναι ασαφές, παραπέμψτε την υπόθεση στην υποστήριξη αντί να μαντέψετε ημερομηνία νέας παράδοσης ή τοποθεσία παραλαβής.
- Σημειώθηκε ως παραδοθέν αλλά δεν παραλήφθηκε: Διατηρήστε την αναφερόμενη από τον μεταφορέα κατάσταση και ανοίξτε ξεχωριστή υπόθεση υποστήριξης. Η ροή εργασίας υποστήριξης θα πρέπει να διακρίνει την αναφορά πελάτη από τη διόρθωση του μεταφορέα.
Δώστε στο προσωπικό υποστήριξης μια ενιαία προβολή του κύκλου, της παραγγελίας, του ιστορικού δεμάτων και των μηνυμάτων που έχουν ήδη σταλεί. Για κάθε εξαίρεση, αναθέστε έναν υπεύθυνο και ένα επόμενο βήμα. Η εκτέλεση μπορεί να διερευνήσει μια αποτυχημένη παράδοση, τα logistics μπορούν να παρακολουθήσουν μια εξαίρεση μεταφορέα και η υποστήριξη μπορεί να χειριστεί την επικοινωνία με τον πελάτη. Μια κατάσταση παρακολούθησης περιγράφει το δέμα· δεν αποφασίζει αν οφείλεται αντικατάσταση ή επιστροφή χρημάτων.
Δοκιμάστε την επικάλυψη πριν από την κυκλοφορία
Ξεκινήστε με έναν συνεργάτη εκτέλεσης και ένα σύνολο αποστολών που αντικατοπτρίζει τον τρόπο με τον οποίο πράγματι αποστέλλει τις παραγγελίες. Συμπεριλάβετε έναν κύκλο με πολλά δέματα, μια ακυρωμένη ετικέτα, μια αντικατάσταση και μια παλαιότερη αποστολή που παραμένει ανοιχτή όταν αποστέλλεται ο επόμενος κύκλος. Στη συνέχεια, επαναλάβετε σκόπιμα ένα διπλό webhook και παραδώστε ένα παλαιότερο συμβάν μετά από ένα νεότερο. Ελέγξτε την εγγραφή του δέματος, τη σελίδα παραγγελίας του πελάτη, την προβολή υποστήριξης και το αρχείο καταγραφής ειδοποιήσεων. Μια δοκιμή που επαληθεύει μόνο μια επιτυχημένη απόκριση API μπορεί να παραβλέψει το πιο δαπανηρό λάθος: την ενημέρωση της λάθος παραγγελίας ή την αποστολή μηνύματος στον λάθος πελάτη.
Παρακολουθήστε τις αποτυχίες καταχώρισης, το ποσοστό των επιλέξιμων δεμάτων που καταχωρίζονται επιτυχώς, τις πρώτες σαρώσεις που πραγματοποιούνται αργότερα από το αναμενόμενο και τις μη αντιστοιχισμένες ενημερώσεις. Αν παρακολουθείτε την καθυστέρηση ενημερώσεων, διακρίνετε τον χρόνο μεταξύ ενός συμβάντος μεταφορέα και της λήψης του από τον χρόνο που χρειάζεται το δικό σας σύστημα για να το επεξεργαστεί. Αυτό σας βοηθά να αποφασίσετε αν πρέπει να διερευνήσετε μια ροή δεδομένων μεταφορέα, το endpoint του webhook ή μια ουρά μέσα στην εφαρμογή σας.
Επεκταθείτε σε περισσότερες διαδρομές μόλις μπορείτε να απαντήσετε σε τρεις ερωτήσεις για οποιοδήποτε δέμα: Σε ποιον κύκλο ανήκει; Τι ανέφερε τελευταίο ο μεταφορέας; Ποιος ενεργεί αν η ενημέρωση λείπει ή είναι λανθασμένη; Αν κάποια απάντηση δεν είναι σαφής, διορθώστε την αντιστοίχιση εγγραφών ή τη ροή εργασίας εξαιρέσεων πριν προσθέσετε περισσότερους κανόνες ειδοποιήσεων.
Συχνές ερωτήσεις
Μπορεί ένα tracking API να ενημερώσει τους πελάτες πότε θα αποσταλεί το επόμενο κουτί συνδρομής τους;
Χρησιμοποιήστε το πρόγραμμα συνδρομής και το σύστημα εκτέλεσης για την επόμενη προγραμματισμένη ημερομηνία αποστολής. Ένα tracking API αφορά ένα συγκεκριμένο δέμα μόλις υπάρχουν διαθέσιμες πληροφορίες παρακολούθησης. Η προγραμματισμένη ημερομηνία αποστολής, η εκτιμώμενη παράδοση από τον μεταφορέα και η επιβεβαιωμένη παράδοση είναι διαφορετικά γεγονότα και θα πρέπει να επισημαίνονται ξεχωριστά.
Τι γίνεται αν η αποθήκη αντικαταστήσει έναν αριθμό παρακολούθησης αφού έχει σταλεί email;
Σημειώστε την παλιά ετικέτα ως αντικατασταθείσα και συνδέστε τον νέο αριθμό παρακολούθησης με την ίδια παραγγελία. Αν το email σας παραπέμπει σε σελίδα παρακολούθησης σε επίπεδο παραγγελίας, ενημερώστε τη σελίδα ώστε ο πελάτης να μπορεί να βρει το ενεργό δέμα χωρίς να χρειάζεται τον αρχικό σύνδεσμο του μεταφορέα. Στείλτε διόρθωση όταν η αλλαγή επηρεάζει πληροφορίες βάσει των οποίων ο πελάτης πρέπει να ενεργήσει.
Τι γίνεται αν ένας συνεργάτης εκτέλεσης στείλει αριθμούς παρακολούθησης χωρίς κωδικούς μεταφορέων;
Ζητήστε από τον συνεργάτη ένα συνεπές πεδίο μεταφορέα ή μια αντιστοίχιση από τους κωδικούς των υπηρεσιών αποστολής του. Αν το API σας προσφέρει ανίχνευση μεταφορέα, επαληθεύστε την απόδοσή του με τις ετικέτες του συνεργάτη πριν βασιστείτε σε αυτό. Κατευθύνετε τις αμφίβολες αντιστοιχίσεις για έλεγχο αντί να επιλέξετε μεταφορέα μόνο με βάση τον αριθμό παρακολούθησης.
Χρειάζονται οι παγωμένες ή παραλειφθείσες συνδρομές εγγραφές παρακολούθησης;
Δεν χρειάζεται εγγραφή δέματος για έναν κύκλο που δεν αποστέλλεται ποτέ. Αν μια προηγούμενη αποστολή παραμένει ανοιχτή, συνεχίστε να την παρακολουθείτε ακόμη και όταν η συνδρομή είναι σε παύση, έχει παραλειφθεί ή έχει ακυρωθεί. Η κατάσταση της συνδρομής ελέγχει τη μελλοντική εκτέλεση· δεν σας ενημερώνει για το τι συνέβη σε ένα δέμα που έχει ήδη φύγει από την αποθήκη.
Πηγές
- 17TRACK Tracking API — επισκόπηση προϊόντος για την ενσωμάτωση παρακολούθησης δεμάτων σε επιχειρηματικά συστήματα.
- Τεκμηρίωση 17TRACK Tracking API — αναφορά υλοποίησης για την καταχώριση αριθμών παρακολούθησης και τη λήψη δεδομένων παρακολούθησης.
- Τεκμηρίωση webhook του Stripe — αναφορά για γενικές πρακτικές webhook, όπως η διαχείριση διπλών συμβάντων και η αποφυγή υποθέσεων σχετικά με τη σειρά παράδοσης. Ακολουθήστε τους δικούς σας κανόνες του παρόχου παρακολούθησης για την επαλήθευση και τις επιβεβαιώσεις.


