Πώς να παρακολουθείτε αποστολές από την Κίνα προς την Ευρώπη και τις ΗΠΑ με ένα API

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

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

Ξεκινήστε από τη διαδρομή αποστολής και όχι μόνο από τη χώρα προορισμού

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

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

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

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

Τι πρέπει να κάνει ένα API παρακολούθησης και τι δεν μπορεί να κάνει

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

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

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

Δημιουργήστε την ενσωμάτωση γύρω από μια εγγραφή σε επίπεδο δέματος

1. Διαχωρίστε παραγγελίες, αποστολές και αναγνωριστικά παρακολούθησης

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

Ένα πρακτικό εσωτερικό μοντέλο θα πρέπει να περιλαμβάνει:

• Εσωτερικό ID παραγγελίας και ID δέματος.
• Αρχικό αριθμό παρακολούθησης και το αναγνωριστικό μεταφορέα που χρησιμοποιεί το API.
• Κάθε επιβεβαιωμένο αριθμό παρακολούθησης του μεταφορέα προορισμού.
• Υπηρεσία αποστολής και χώρα προορισμού.
• Τρέχουσα κανονικοποιημένη κατάσταση και αρχική περιγραφή του μεταφορέα.
• Ώρα συμβάντος, τοποθεσία συμβάντος όταν παρέχεται και ώρα κατά την οποία το σύστημά σας έλαβε την ενημέρωση.
• Κατάσταση καταχώρισης, τελευταία επιτυχής συγχρονισμένη ενημέρωση και ανεπίλυτα σφάλματα ενσωμάτωσης.

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

2. Καταχωρίστε τα δέματα από ένα αξιόπιστο επιχειρησιακό συμβάν

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

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

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

3. Σχεδιάστε την παράδοση ενημερώσεων πριν συνδέσετε τις ειδοποιήσεις πελατών

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

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

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

4. Κανονικοποιήστε τις καταστάσεις χωρίς να απορρίπτετε το νόημα

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

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

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

Διαχειριστείτε ρητά τις διεθνείς μεταβιβάσεις

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

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

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

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

Πού εντάσσεται το 17TRACK σε αυτή τη ροή εργασίας

Η προσφορά Tracking API του 17TRACK είναι σχετική όταν η εφαρμογή σας χρειάζεται ενσωμάτωση παρακολούθησης πολλών μεταφορέων. Η επίσημη τεκμηρίωση API θα πρέπει να καθοδηγεί την υλοποίηση του ελέγχου ταυτότητας, της καταχώρισης, της διαχείρισης αποκρίσεων και των υποστηριζόμενων ροών ενημέρωσης. Χρησιμοποιήστε το τεκμηριωμένο συμβόλαιο API αντί να αντιμετωπίζετε μια σελίδα παρακολούθησης καταναλωτών ως διεπαφή ενσωμάτωσης.

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

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

Εκτελέστε πιλοτική δοκιμή βάσει διαδρομών πριν από την ανάπτυξη

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

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

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

Παρακολουθείτε ξεχωριστά τη φρεσκάδα των δεδομένων και τη διαθεσιμότητα του API

Η παρακολούθηση API πρέπει να απαντά σε δύο διαφορετικές ερωτήσεις: λειτουργεί η ενσωμάτωση και είναι χρήσιμες οι πληροφορίες αποστολής; Τα επιτυχημένα αιτήματα απαντούν μόνο στην πρώτη ερώτηση. Πρέπει επίσης να γνωρίζετε εάν οι καταχωρίσεις συσσωρεύουν σφάλματα, τα callbacks αποτυγχάνουν ή μια διαδρομή έχει σταματήσει να παράγει τα αναμενόμενα ορόσημα.

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

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

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

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

Μπορεί ένα API να παρακολουθεί τόσο τον κινεζικό μεταφορέα προέλευσης όσο και τον μεταφορέα παράδοσης προορισμού;

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

Γιατί η παρακολούθηση σταματά να ενημερώνεται αφού ένα δέμα φύγει από την Κίνα;

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

Πρέπει η εφαρμογή να χρησιμοποιεί webhooks ή polling;

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

Μπορεί ένα API παρακολούθησης να εγγυηθεί ημερομηνία παράδοσης ή εκτελωνισμό;

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

Τι πρέπει να επαληθευτεί πριν από την επιλογή ενός προγράμματος API;

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

Πηγές

• 17TRACK Tracking API — επίσημη αναφορά προϊόντος για την προσφορά tracking API.
• 17TRACK API documentation — επίσημη τεχνική αναφορά για την υλοποίηση της ενσωμάτωσης. Επιβεβαιώστε εδώ τις ακριβείς μορφές αιτημάτων, τις υποστηριζόμενες ροές εργασίας και τα όρια πριν από την ανάπτυξη.