REST API επικίνδυνων εμπορευμάτων

Τι κάνει το API

Αποστολές. Το JSON REST API του DGAssistant δημιουργεί την αποστολή επικίνδυνων εμπορευμάτων από το δικό σας σύστημα διαχείρισης ή εφοδιαστικής και επιστρέφει τη δήλωση του αποστολέα, τον κατάλογο ελέγχου και τη σήμανση των κόλων, ήδη επαληθευμένα σύμφωνα με τον εφαρμοστέο κανονισμό. Το σύστημά σας διατηρεί τα εμπορικά δεδομένα· το DGAssistant παρέχει την κανονιστική γνώση και τα έγγραφα.

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

Άνοιγμα της προδιαγραφής του API επικίνδυνων εμπορευμάτων

Δύο τρόποι εργασίας: μαζικός και διαδραστικός

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

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

Προκαθορισμένα δεδομένα ή δεδομένα που ορίζονται άμεσα

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

Δεδομένα που ορίζονται άμεσα. Τα προϊόντα και οι συμμετέχοντες ορίζονται στην ίδια κλήση που δημιουργεί την αποστολή. Ενδείκνυται για συστήματα που δεν τηρούν δικό τους κατάλογο ή που αποστέλλουν περιστασιακά εμπορεύματα.

Τα έγγραφα που επιστρέφει

Το API επιστρέφει τα ίδια έγγραφα που παράγει η εφαρμογή. Τα έγγραφα της αποστολής και της ομαδοποίησης λαμβάνονται σε PDF, XLSX ή DOCX, ενώ τα έγγραφα της αποστολής μπορούν επίσης να αποστέλλονται με ηλεκτρονικό ταχυδρομείο από την ίδια την υπηρεσία· τα έγγραφα της φορτωτικής λαμβάνονται σε PDF.

• Για κάθε αποστολή: το έγγραφο μεταφοράς του εφαρμοστέου κανονισμού —το έγγραφο μεταφοράς ADR, η δήλωση επικίνδυνων εμπορευμάτων IMO ή το έντυπο πολυτροπικής μεταφοράς IMDG και η Δήλωση Αποστολέα IATA—, ο κατάλογος ελέγχου, η σήμανση των κόλων σε πλήρες ή σε μικρό προσαρμοσμένο μέγεθος και, στην αεροπορική μεταφορά, το φύλλο δεδομένων για την αεροπορική φορτωτική.
• Για την κύρια αποστολή: το δηλωτικό ομαδοποίησης, ο κατάλογος εμπορευματοκιβωτίων, ο κατάλογος συσκευασίας κάθε μονάδας, το φύλλο φόρτωσης ανά αποστολέα και το φύλλο δεδομένων κύριου εγγράφου.
• Για τη μονάδα μεταφοράς: το πιστοποιητικό συσκευασίας εμπορευματοκιβωτίου ή οχήματος, το έντυπο πολυτροπικής μεταφοράς επικίνδυνων εμπορευμάτων, η έκθεση διαχωρισμού της μονάδας, ο κατάλογος ελέγχου πριν από την υπογραφή του πιστοποιητικού και η ετικέτα ομαδοποίησης.
• Για το δρομολόγιο: το δηλωτικό επικίνδυνων εμπορευμάτων, η έκθεση διαχωρισμού μεταξύ των μονάδων επί του πλοίου, η έκθεση ορίου εξαίρεσης ADR 1.1.3.6, το δελτίο περιορισμών διαδρομής, το φύλλο φόρτωσης, η γνωστοποίηση προς τον κυβερνήτη (NOTOC) και το ενοποιημένο έγγραφο μεταφοράς του οχήματος.
• Για τη φορτωτική: το σχέδιο, το υπογεγραμμένο αντίγραφο, το συνημμένο έγγραφο μεταφοράς ADR και η έκθεση αποδεικτικών στοιχείων.

Τι επαληθεύει το API

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

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

Κανονισμοί και είδη μεταφοράς που καλύπτονται

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

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

Διαθεσιμότητα

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

Πώς να ξεκινήσετε

Ζητήστε δωρεάν δοκιμή δύο εβδομάδων και, μαζί με αυτήν, τα διαπιστευτήρια της υπηρεσίας. Ο έλεγχος ταυτότητας γίνεται με OAuth 2.0 και τη ροή client credentials: το σύστημά σας λαμβάνει ένα διακριτικό πρόσβασης (access token) και το αποστέλλει σε κάθε αίτημα.

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