API παρακολούθησης φορτίων: Δεδομένα LTL και φορτίων, βήματα ενσωμάτωσης και όρια κάλυψης

Ένα API παρακολούθησης εμπορευμάτων συνδέει τις ενημερώσεις αποστολών από μεταφορείς, διαμεταφορείς ή παρόχους ορατότητας με το λογισμικό logistics σας. Για αποστολές μερικού φορτίου φορτηγού (LTL) και άλλες μετακινήσεις εμπορευμάτων, η επιτυχής ενσωμάτωση εξαρτάται από περισσότερα από το όνομα ενός μεταφορέα: πρέπει να επαληθεύσετε τα αποδεκτά αναγνωριστικά αποστολής, τις υποστηριζόμενες υπηρεσίες, τα διαθέσιμα ορόσημα, τα δικαιώματα λογαριασμού και τις μεθόδους παράδοσης ενημερώσεων. Ξεκινήστε με τις εμπορευματικές διαδρομές και τις επιχειρησιακές αποφάσεις που πρέπει να υποστηρίξετε και, στη συνέχεια, ελέγξτε αν το API παρέχει αξιοποιήσιμα δεδομένα για αυτές τις αποστολές.

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

Τι αντιπροσωπεύουν στην πραγματικότητα τα δεδομένα παρακολούθησης εμπορευμάτων

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

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

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

Οι αριθμοί PRO, οι φορτωτικές και οι αριθμοί εμπορευματοκιβωτίων δεν είναι εναλλάξιμοι

Για την παρακολούθηση LTL, ο αριθμός PRO που εκχωρείται από τον μεταφορέα είναι μια συνηθισμένη αναφορά αποστολής. Η φορτωτική (BOL) τεκμηριώνει την αποστολή, όμως ο αριθμός της δεν γίνεται απαραίτητα αποδεκτός από το ίδιο endpoint παρακολούθησης. Οι αριθμοί εντολών αγοράς και οι αναφορές αποστολέα ενδέχεται να απαιτούν πρόσβαση αναζήτησης ειδικά για τον λογαριασμό ή ξεχωριστή λειτουργία αναζήτησης.

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

Καθορίστε την κάλυψη σε επίπεδο αποστολής

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

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

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

Πού εντάσσεται το 17TRACK στην αξιολόγηση

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

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

Βήματα ενσωμάτωσης: από τις αναφορές αποστολής στις επιχειρησιακές ειδοποιήσεις

1. Καθορίστε το μοντέλο αποστολής και το επιχειρησιακό αποτέλεσμα

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

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

2. Επικυρώστε την πρόσβαση και τον χειρισμό αναγνωριστικών

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

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

3. Καταχωρίστε ή αναζητήστε αποστολές χρησιμοποιώντας την τεκμηριωμένη ροή εργασίας

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

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

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

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

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

5. Υλοποιήστε αξιόπιστη εισαγωγή ενημερώσεων

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

Για polling, ακολουθήστε τα τεκμηριωμένα όρια αιτημάτων και προσαρμόστε το πρόγραμμα στην κατάσταση της αποστολής και την επιχειρησιακή επείγουσα ανάγκη. Χρησιμοποιήστε ελεγχόμενες επαναλήψεις με backoff για προσωρινές αποτυχίες. Τηρείτε τις οδηγίες επανάληψης του διακομιστή όταν παρέχονται. Η ασφάλεια επανάληψης HTTP εξαρτάται από τη σημασιολογία του αιτήματος, επομένως μην υποθέτετε ότι κάθε αποτυχημένη εγγραφή μπορεί να επαναληφθεί χωρίς να δημιουργήσει διπλή εργασία.

6. Συνδέστε τις καταστάσεις με ενέργειες και όχι μόνο με πίνακες ελέγχου

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

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

Όρια κάλυψης που αλλάζουν τις επιχειρησιακές αποφάσεις

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

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

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

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

Η πρόσβαση και τα πρότυπα δεδομένων είναι διαφορετικά προβλήματα. Πρότυπα όπως τα πρότυπα DCSA Track & Trace παρέχουν αναφορά για την ορολογία και τις διεπαφές γεγονότων στη μεταφορά εμπορευματοκιβωτίων. Δεν αποδεικνύουν από μόνα τους ότι ένα συγκεκριμένο API προσφέρει πρόσβαση στην αποστολή σας ή υποστηρίζει την απαιτούμενη σύνδεση μεταφορέα.

Ελέγξτε την κάλυψη και παρακολουθήστε την ποιότητα δεδομένων πριν από την κλιμάκωση

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

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

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

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

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

Μπορώ να παρακολουθήσω εμπορεύματα LTL χρησιμοποιώντας μόνο έναν αριθμό BOL;

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

Αντικαθιστά ένα API παρακολούθησης εμπορευμάτων ένα TMS;

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

Γιατί ο ιστότοπος του μεταφορέα εμφανίζει μια ενημέρωση πριν από το σύστημά μου;

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

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

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

Τι πρέπει να συμβαίνει όταν τα δεδομένα παρακολούθησης καθίστανται παρωχημένα;

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

Πηγές

• 17TRACK Tracking API — επίσημο σημείο εισόδου για την αξιολόγηση της προσφοράς API παρακολούθησης.
• Τεκμηρίωση API της 17TRACK — αναφορά για τον έλεγχο του συμβολαίου υλοποίησης και των απαιτήσεων ενσωμάτωσης.
• Πρότυπα DCSA Track & Trace — πρότυπα παρακολούθησης θαλάσσιων εμπορευματοκιβωτίων και πλαίσιο μοντέλου γεγονότων.
• RFC 9110: HTTP Semantics — σημασιολογία μεθόδων HTTP, ιδιότητα idempotency και πρωτοκολλικές considerations σχετικά με τις επαναλήψεις.