API Παρακολούθησης Θαλάσσιων Μεταφορών: Συμβάντα Εμπορευματοκιβωτίων, Δεδομένα ETA και Κριτήρια Επιλογής

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

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

Ξεκινήστε με το μοντέλο της αποστολής, όχι με την οθόνη παρακολούθησης

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

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

Πριν αξιολογήσετε ένα API, προσδιορίστε τις αναφορές που λαμβάνει πραγματικά η επιχείρησή σας:

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

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

Ποια γεγονότα εμπορευματοκιβωτίων πρέπει να παρέχει ένα API;

Τα πρότυπα Track & Trace της Digital Container Shipping Association παρέχουν μια χρήσιμη αναφορά για τη συζήτηση δεδομένων θαλάσσιων αποστολών. Η DCSA διακρίνει τα γεγονότα αποστολής, μεταφοράς και εξοπλισμού. Αυτές οι κατηγορίες βοηθούν στον διαχωρισμό της διοικητικής προόδου, της κίνησης της μεταφοράς και του χειρισμού του φυσικού εμπορευματοκιβωτίου.

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

Γεγονότα εξοπλισμού: τι συνέβη στο εμπορευματοκιβώτιο

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

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

Γεγονότα μεταφοράς: σε ποιο σημείο βρίσκεται το πλοίο ή το σκέλος μεταφοράς

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

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

Γεγονότα αποστολής: η διοικητική πρόοδος δεν είναι φυσική μετακίνηση

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

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

Τα δεδομένα ETA χρειάζονται προορισμό, σημασία και ιστορικό

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

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

Διαχωρίστε την πηγή της εκτίμησης από την κατάστασή της

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

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

Διατηρήστε τις αναθεωρήσεις ETA αντί να τις αντικαθιστάτε

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

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

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

Αξιολογήστε την κάλυψη σε επίπεδο γεγονότων

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

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

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

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

Η συμπεριφορά του API έχει εξίσου σημασία με τη λίστα γεγονότων

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

Polling, webhooks και ανάκαμψη

Το polling επιτρέπει στην εφαρμογή σας να ζητά ενημερώσεις με το δικό της πρόγραμμα. Τα webhooks επιτρέπουν σε έναν πάροχο να στέλνει ενημερώσεις σε ένα endpoint που λειτουργείτε. Κανένας από τους δύο μηχανισμούς δεν διασφαλίζει από μόνος του την επικαιρότητα: ένα webhook που παραδίδεται αμέσως μπορεί και πάλι να περιέχει ένα γεγονός της πηγής που ελήφθη καθυστερημένα.

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

Κανονικοποίηση χωρίς απώλεια στοιχείων

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

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

Εμπορικοί και διαχειριστικοί έλεγχοι

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

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

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

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

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

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

Εκτελέστε μια απόδειξη ορθής λειτουργίας με επίκεντρο τις επιχειρησιακές αποφάσεις

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

1. Καθορίστε τα κριτήρια αποδοχής. Προσδιορίστε τις απαιτούμενες αναφορές, τα γεγονότα, τις τοποθεσίες, τη σημασία των χρονικών σημάνσεων και τον αποδεκτό χειρισμό μη διαθέσιμων δεδομένων πριν από τη δοκιμή.
2. Επικυρώστε την ταυτότητα. Επιβεβαιώστε ότι κάθε αποτέλεσμα ανήκει στην προβλεπόμενη αποστολή και διαδρομή εμπορευματοκιβωτίου. Συμπεριλάβετε επαναχρησιμοποιημένο εξοπλισμό και κρατήσεις πολλών εμπορευματοκιβωτίων, όπου είναι σχετικό.
3. Συγκρίνετε με τις εγγραφές της πηγής. Ελέγξτε τα επιστρεφόμενα ορόσημα σε σχέση με προσβάσιμες εγγραφές μεταφορέων ή τερματικών σταθμών, λαμβάνοντας υπόψη τις διαφορές στον χρόνο ενημέρωσης.
4. Δοκιμάστε αναθεωρήσεις και αποτυχίες. Ελέγξτε διπλές ειδοποιήσεις, γεγονότα εκτός σειράς, διορθωμένες χρονικές σημάνσεις, μη διαθέσιμες πηγές και διακοπές endpoint.
5. Αναπαραγάγετε μια επιχειρηματική ροή εργασίας. Επαληθεύστε αν τα δεδομένα υποστηρίζουν την προβλεπόμενη ενέργεια, όπως την εξέταση μιας καθυστερημένης σύνδεσης ή την ενημέρωση μιας εκτίμησης εισερχόμενου αποθέματος.
6. Εξετάστε τα ανεπίλυτα κενά. Καταγράψτε αν κάθε κενό προέρχεται από την υποκείμενη πηγή, την επεξεργασία του παρόχου ή την ολοκλήρωσή σας. Συμφωνήστε σε διορθωτικές ενέργειες πριν επεκτείνετε τη χρήση.

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

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

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

Μπορώ να παρακολουθήσω μια θαλάσσια αποστολή χρησιμοποιώντας μόνο τον αριθμό εμπορευματοκιβωτίου;

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

Σημαίνει η πραγματική άφιξη του πλοίου ότι το εμπορευματοκιβώτιό μου είναι έτοιμο για παραλαβή;

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

Αντικαθιστά η παρακολούθηση πλοίων AIS την παρακολούθηση εμπορευματοκιβωτίων;

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

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

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

Μπορούν τα γεγονότα παρακολούθησης να υπολογίσουν χρεώσεις demurrage ή detention;

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

Πηγές

• DCSA: Πρότυπα Track & Trace — Πλαίσιο αναφοράς για γεγονότα αποστολής, μεταφοράς και εξοπλισμού στη μεταφορά εμπορευματοκιβωτίων.
• DCSA: Αποθετήριο προδιαγραφών OpenAPI — Τεχνική αναφορά για τους ορισμούς API και τις δομές γεγονότων της DCSA. Ελέγξτε την ισχύουσα έκδοση προδιαγραφών κατά τον σχεδιασμό μιας ολοκλήρωσης.
• International Maritime Organization: Automatic Identification Systems — Υπόβαθρο για το AIS και τις πληροφορίες πλοίων που παρέχει.
• 17TRACK: Tracking API και επίσημη τεκμηρίωση API — Σημεία εκκίνησης για την επικύρωση της καταλληλότητας του προϊόντος· δεν αποτελούν εδώ απόδειξη υποστήριξης γεγονότων θαλάσσιων εμπορευματοκιβωτίων ή προβλεπτικού ETA.