Outbound Order Book

Χρησιμοποιούμε ένα REST API με τα ολοκληρωμένα μηνύματα logistics οχημάτων ως σώμα XML. Θα παρέχουμε μια προδιαγραφή OpenAPI των τελικών σημείων. Για τις προδιαγραφές των δεδομένων ωφέλιμου φορτίου, δείτε το XSD που παρέχεται χωριστά.

Τα διαθέσιμα API είναι του τύπου ροής/ροής, που επιτρέπει σε όλες τις εργασίες να καταναλώνονται με τη χρονολογική σειρά με την οποία δημιουργήθηκαν. Ο μεταφορέας μπορεί να επιλέξει τη συχνότητα (π.χ. μεταξύ 1 και 5 λεπτών) και τον αριθμό των παραγγελιών που θέλει να καταναλώσει ταυτόχρονα και να καταναλώσει όλες τις παραγγελίες στην ουρά μέχρι να μην υπάρχουν νέες παραγγελίες. Όλες οι παραγγελίες είναι διαθέσιμες για ορισμένο χρονικό διάστημα, ανεξάρτητα από το αν έχουν καταναλωθεί ή όχι. Αυτό παρέχει μεγαλύτερη ευελιξία ως προς το πότε και τον τρόπο κατανάλωσης και δράσης τους, και επιτρέπει επίσης την επανακατανάλωση όταν είναι απαραίτητο, όπως όταν παραστεί ανάγκη. Π.χ. εάν το σύστημα αποστολής δεν είναι διαθέσιμο ή είχε προβλήματα με την επεξεργασία ενός συγκεκριμένου μηνύματος. Όλα τα API παρέχονται από RIO παρέχονται και τις απαιτήσεις ασφαλείας του RIO θα είναι στο RIO -Η σελίδα εκπληρώθηκε.

Χρησιμοποιούμε το OAuth2 με επιχορήγηση διαπιστευτηρίων πελάτη. Για λεπτομέρειες δείτε εδώ .

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

Εκδόσεις
Όλα τα μηνύματα FVL πρέπει να αποστέλλονται με τη σωστή σειρά και να περιέχουν μια χρονική σήμανση που υποδεικνύει πότε δημιουργήθηκε κάθε μήνυμα ("issueDate"). Μηνύματα με το ίδιο αναγνωριστικό και παλαιότερες χρονικές σημάνσεις θα απορρίπτονται. Είναι επίσης σημαντικό να βεβαιωθείτε ότι αποστέλλεται πρώτα το αρχικό μήνυμα και μετά μια ενημέρωση.

Δοκιμή
Για να ενεργοποιήσουμε τον πειραματισμό και τη δοκιμή ενσωμάτωσης, παρέχουμε μια δοκιμαστική έκδοση του API σε μια διεύθυνση URL με όνομα test. ξεκινά, δείτε την προδιαγραφή OpenAPI για περισσότερες λεπτομέρειες. Η πρόσβαση είναι δυνατή με τον ίδιο πελάτη όπως και για το σύστημα παραγωγής.
Το δοκιμαστικό API έχει αυτήν τη στιγμή την ίδια συμπεριφορά με το σύστημα παραγωγής. Ωστόσο, για καλύτερη διαφοροποίηση, θα πρέπει να οριστεί το TestingIndicator. Σε μεταγενέστερη ημερομηνία, θα μπορούσε να χρησιμοποιηθεί για τη δοκιμή νέων χαρακτηριστικών προτού ενεργοποιηθούν στην παραγωγή.
Τα δεδομένα δοκιμής που παρέχονται από το Test API περιλαμβάνουν πολλές διαφορετικές περιπτώσεις, οι οποίες μπορούν να διακριθούν από ένα πρόθεμα στο αναγνωριστικό εγγράφου με τη μορφή CaseX-. Λάβετε υπόψη ότι ένα τέτοιο πρόθεμα δεν θα εμφανίζεται στην παραγωγή. Οι περιπτώσεις που προβλέπονται είναι:

Για παραγγελίες μεταφοράς :

• Δύο τυπικά μηνύματα με το ίδιο αναγνωριστικό λίστας φόρτωσης
• Ένα τυπικό μήνυμα και ένα δεύτερο μήνυμα που ακυρώνει το αίτημα μεταφοράς του πρώτου μηνύματος
• Ένα τυπικό μήνυμα και μια ενημέρωση για αυτό το μήνυμα
• Ένα τυπικό μήνυμα για μια σχέση ένα προς πολλά (σχετικό μόνο για ορισμένους παρόχους υπηρεσιών)

Για παραγγελίες σέρβις :

• Ένα τυπικό μήνυμα.
• Ένα τυπικό μήνυμα και ένα δεύτερο μήνυμα που ακυρώνει την παραγγελία υπηρεσίας του πρώτου μηνύματος.
• Ένα τυπικό μήνυμα και μια ενημέρωση για αυτό το μήνυμα.

Θα ενημερωθείτε ποιες περιπτώσεις αφορούν εσάς. Νέα δεδομένα δοκιμής δημιουργούνται σε σταθερά διαστήματα.
Λάβετε υπόψη ότι το Test API δεν πρέπει να χρησιμοποιείται σε αυτοματοποιημένες δοκιμές!

Σχετικά με αυτό Outbound Order Book Για να μπορείτε να χρησιμοποιήσετε την επικοινωνία διεπαφής, παρέχουμε ένα REST API με το οποίο μπορείτε να επικοινωνείτε σε βάση service2service. Για να χρησιμοποιήσετε τη διεπαφή, χρειάζεστε ένα αναγνωριστικό πελάτη και τα σχετικά διαπιστευτήρια, τα οποία μπορείτε να παρέχετε μετά την κράτηση της υπηρεσίας RIO λαμβάνω. Η μορφή μηνύματος που χρησιμοποιείται για την ανταλλαγή δεδομένων μέσω της διεπαφής είναι το πρότυπο VDA/Odette/ECG "Finished Vehicle Logistics" με τα μηνύματα FV14a, FV14b, FV17, FV18 σε μορφή XML. Θα λάβετε την ακριβή προδιαγραφή μηνύματος από τον αντίστοιχο πελάτη σας.

Επικοινωνήστε με την υποστήριξη RIO .

Η μορφή μηνύματος που χρησιμοποιείται για την ανταλλαγή δεδομένων μέσω διασύνδεσης είναι το πρότυπο VDA/Odette/ECG «Finished Vehicle Logistics» με τα μηνύματα FV14a, FV14b, FV17, FV18 σε μορφή XML. Επειδή η χρήση των καθορισμένων χαρακτηριστικών μπορεί να διαφέρει από πελάτη σε πελάτη, επικοινωνήστε με τον πελάτη σας σχετικά με τις συγκεκριμένες προδιαγραφές των μηνυμάτων FVL.

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

Αυτές είναι οι διαφορετικές κατηγορίες στις οποίες εμπίπτουν οι παραγγελίες μεταφοράς. Τα εισερχόμενα περιέχουν παραγγελίες μεταφοράς με την κατάσταση "un/confirmed" και "canceded". Στο En Route θα βρείτε παραγγελίες μεταφοράς που έχουν την κατάσταση “loaded”. Ολοκληρώθηκε περιέχει μόνο παραγγελίες μεταφοράς με την κατάσταση "εκφόρτωση".

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

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

Ανοίγοντας την παραγγελία μεταφοράς μπορείτε να δείτε το VIN. Για να το κάνετε αυτό, κάντε κλικ στην επιθυμητή παραγγελία μεταφοράς στην επισκόπηση των παραγγελιών μεταφοράς. Αυτό ανοίγει την πλαϊνή γραμμή με περισσότερες λεπτομέρειες. Στη συνέχεια, μπορείτε να δείτε τις λεπτομέρειες της αποστολής ή του οχήματος κάνοντας κλικ στο ShipmentDetails.

Ανοίγοντας την παραγγελία μεταφοράς μπορείτε να δείτε το VIN. Για να το κάνετε αυτό, κάντε κλικ στην επιθυμητή παραγγελία μεταφοράς στην επισκόπηση των παραγγελιών μεταφοράς. Αυτό ανοίγει την πλαϊνή γραμμή με περισσότερες λεπτομέρειες. Στη συνέχεια, μπορείτε είτε να προβάλετε τις λεπτομέρειες αποστολής (για πληροφορίες σχετικά με το φορτίο) είτε τις λεπτομέρειες μεταφοράς (για πληροφορίες σχετικά με τη μεταφορά).

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

Ένα πορτοκαλί σημάδι σε μια παραγγελία υποδηλώνει μια αλλαγή από τον πελάτη.

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

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

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