Μετάβαση στο περιεχόμενο

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

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

Τι κάνει το API

Σύνδεση του DGAssistant με σύστημα διαχείρισης

Αποστολές. Το 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, με τα δεδομένα που απαιτεί το καθένα. Τα κείμενα των εγγράφων εκδίδονται σε δεκαεννέα γλώσσες.

Διαθεσιμότητα του API

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

Πώς να αρχίσετε να χρησιμοποιείτε το API

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

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

Ενότητες της προδιαγραφής του API

Ενότητα
ΕπισκόπησηΠαρουσίαση του API και των ορίων χρήσης του, με τα αρχεία OpenAPI 3.0 και 2.0 της προδιαγραφής και το ευρετήριο όλων των ενοτήτων.Άνοιγμα
Έλεγχος ταυτότηταςΔιακριτικά πρόσβασης OAuth2 που εκδίδονται με τη ροή client credentials, ως εναλλακτική λύση στον έλεγχο ταυτότητας HTTP Basic για κάθε λειτουργία που απαιτεί έλεγχο ταυτότητας.Άνοιγμα
Έλεγχοι σύνδεσηςΈλεγχος της διαθεσιμότητας του API, των διαπιστευτηρίων του χρήστη του API και αιτημάτων με και χωρίς έλεγχο ταυτότητας.Άνοιγμα
Βασικά δεδομέναΕπικίνδυνα εμπορεύματα και ραδιονουκλεΐδια, συσκευασίες και οδηγίες συσκευασίας, κωδικοί, χώρες και τοποθεσίες στα οποία παραπέμπουν οι αποστολές, τα προϊόντα και η ομαδοποίηση.Άνοιγμα
ΠροϊόνταΑπλά προϊόντα και προϊόντα μικτής συσκευασίας του καταλόγου, συμπεριλαμβανομένης της διαδραστικής δημιουργίας προϊόντος μικτής συσκευασίας για μια αποστολή.Άνοιγμα
ΣυμμετέχοντεςΠροκαθορισμένοι συμμετέχοντες: αποστολείς, παραλήπτες, φορτωτές, μεταφορείς, προμηθευτές και οδηγοί.Άνοιγμα
Οχήματα, ρυμουλκούμενα και πλοίαΟχήματα, ρυμουλκούμενα και πλοία των λογαριασμών, με την πινακίδα κυκλοφορίας, την κατηγορία οχήματος ADR και το έγγραφο συμμόρφωσης.Άνοιγμα
Τοποθεσίες και περιορισμοίΛιμένες, αερολιμένες και τερματικοί σταθμοί των λογαριασμών και οι περιορισμοί που ισχύουν όταν σε αυτούς προγραμματίζεται ή φορτώνεται εξοπλισμός μεταφοράς.Άνοιγμα
ΑποστολέςΔημιουργία αποστολής με όλο το περιεχόμενό της (μαζικός τρόπος) ή με το πρώτο περιεχόμενό της (διαδραστικός τρόπος), καθώς και ανάκτηση και διαγραφή αποστολών.Άνοιγμα
Περιεχόμενο της αποστολήςΠροϊόντα, μικτές συσκευασίες και υπερσυσκευασίες που προστίθενται σε αποστολή η οποία επεξεργάζεται διαδραστικά ή αφαιρούνται από αυτήν.Άνοιγμα
Έγγραφα της αποστολήςΈγγραφα μιας αποστολής (έγγραφο μεταφοράς, κατάλογος ελέγχου, σήμανση κόλων και άλλα), η αποστολή τους με ηλεκτρονικό ταχυδρομείο και τα παγωμένα έγγραφα.Άνοιγμα
ΦορτωτικέςΦορτωτικές CMR, ηλεκτρονικές (e-CMR) και εθνικές, από τον έλεγχο της κάλυψης της διαδρομής από το Πρωτόκολλο e-CMR έως την έκδοση, την παράδοση και την ακύρωση.Άνοιγμα
Αιτήματα ομαδοποίησηςΑιτήματα ομαδοποίησης των λογαριασμών πελατών ή του συμβούλου ασφαλούς μεταφοράς τους για λογαριασμό τους, και αποφάσεις του φορέα ομαδοποίησης.Άνοιγμα
Κύριες αποστολέςΚύριες αποστολές με τις αποστολές τους και τη ροή έγκρισής τους.Άνοιγμα
Εξοπλισμός μεταφοράςΕξοπλισμός μεταφοράς, το περιεχόμενό του, οι έλεγχοι διαχωρισμού του και το ιστορικό κινήσεών του.Άνοιγμα
Δρομολόγια και προσεγγίσειςΠλόες, πτήσεις και οδικά ταξίδια με τις προσεγγίσεις και τον εξοπλισμό μεταφοράς τους, έλεγχοι διαχωρισμού, υπολογισμός του ορίου φορτίου (ADR 1.1.3.6) και περιορισμοί.Άνοιγμα
Έγγραφα ομαδοποίησηςΈγγραφα των κύριων αποστολών, του εξοπλισμού μεταφοράς και των δρομολογίων.Άνοιγμα
WebhooksΣυνδρομές webhook του λογαριασμού, η δοκιμή τους και οι πρόσφατες παραδόσεις τους.Άνοιγμα

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