API και διασύνδεση με ERP
Πώς εντάσσεται το DGAssistant στο ERP, στο WMS ή στην πλατφόρμα αποστολών σας.
Χρειάζομαι ειδική ενότητα για να χρησιμοποιήσω το API;
Ναι, το API είναι ενότητα με δική της άδεια χρήσης, επιπλέον των βασικών αδειών σας. Το προσθέτετε στη συνδρομή σας όταν αποφασίσετε να προχωρήσετε στη διασύνδεση.
Πώς μετράται και τιμολογείται η χρήση του API;
Η χρήση του API μετράται ανά άδεια χρήσης: κάθε άδεια καλύπτει 1.500 αποστολές και 10.000 κλήσεις της υπηρεσίας ανά έτος και επιτρέπει στη βάση δεδομένων να περιέχει έως 5.000 αντικείμενα εκτός από αποστολές, όπως προϊόντα και συμμετέχοντες (παραλήπτες, προμηθευτές, οδηγούς και τους υπόλοιπους). Αν αναμένετε μεγαλύτερο όγκο, απλώς προσθέτετε επιπλέον άδειες. Η ακριβής τιμή μονάδας της ενότητας API εμφανίζεται μαζί με τον υπόλοιπο κατάλογο στο κατάστημά μας και μπορεί να συμπεριληφθεί σε οποιαδήποτε εξατομικευμένη προσφορά.
Ποιοι είναι οι δύο τρόποι χρήσης του API: μαζικός ή διαδραστικός;
Ο μαζικός τρόπος λαμβάνει την πλήρη περιγραφή της αποστολής σε μία μόνο κλήση της υπηρεσίας — ιδανικός όταν το ERP γνωρίζει ήδη τα εμπορεύματα, τους συμμετέχοντες και τις ποσότητες. Ο διαδραστικός τρόπος σας επιτρέπει να συνθέτετε την αποστολή βήμα προς βήμα, επικυρώνοντας κάθε εμπόρευμα καθώς το προσθέτετε· προσεγγίζει περισσότερο τον τρόπο λειτουργίας της διαδικτυακής εφαρμογής και είναι χρήσιμος όταν χρειάζεστε ροές εργασίας καθοδηγούμενες από τον χρήστη πάνω στο API.
Πρέπει να δημιουργήσω εκ των προτέρων τα προϊόντα και τους συμμετέχοντες ή να τους ορίζω άμεσα σε κάθε κλήση;
Υποστηρίζονται και οι δύο τρόποι. Η συνιστώμενη προσέγγιση είναι τα «προκαθορισμένα δεδομένα»: δημιουργείτε τα εμπορεύματα και τους συμμετέχοντες μία φορά στη διαδικτυακή εφαρμογή (ή τους εισάγετε) και τους προσδιορίζετε με τον κωδικό τους στις κλήσεις του API. Η προσέγγιση των «δεδομένων που ορίζονται άμεσα» σας επιτρέπει να αποστέλλετε όλα τα στοιχεία σε κάθε κλήση, κάτι που είναι βολικό όταν το ERP σας είναι η κύρια πηγή αυτών των δεδομένων και δεν επιθυμείτε να τα φορτώσετε εκ των προτέρων.
Πώς λαμβάνω μέσω του API τα PDF που παράγονται;
Υπάρχουν δύο επιλογές. Μπορείτε να λαμβάνετε τα έγγραφα στην απόκριση του API ως αρχεία PDF κωδικοποιημένα σε base64 (έγγραφο μεταφοράς, δήλωση αποστολέα, κατάλογος ελέγχου, σήμανση κόλων κ.λπ.) ή να ζητήσετε από την πλατφόρμα να τα αποστέλλει αυτόματα με ηλεκτρονικό ταχυδρομείο σε μια διεύθυνση που έχετε ορίσει.
Μπορώ να εκτυπώνω αυτόματα τα έγγραφα που παράγονται μέσω του API;
Ναι. Δύο προσεγγίσεις λειτουργούν καλά: (a) το ERP σας κατεβάζει το PDF από το API και το στέλνει στη δική του ουρά εκτύπωσης· (b) το DGAssistant αποστέλλει τα έγγραφα με ηλεκτρονικό ταχυδρομείο σε μια ειδική θυρίδα και ένα μικρό βοηθητικό πρόγραμμα αυτόματης εκτύπωσης στην πλευρά σας τα εκτυπώνει στον κατάλληλο εκτυπωτή. Πολλοί πελάτες χρησιμοποιούν τη λύση του ηλεκτρονικού ταχυδρομείου, επειδή δεν απαιτεί πρόσθετο κώδικα στην πλευρά του ERP.
Πού βρίσκεται η προδιαγραφή του API;
Η πλήρης προδιαγραφή OpenAPI δημοσιεύεται στην τεκμηρίωση του API επικίνδυνων εμπορευμάτων. Παρέχουμε επίσης ένα έργο SoapUI με προφορτωμένες ρεαλιστικές δοκιμαστικές κλήσεις, ώστε οι προγραμματιστές σας να εξερευνήσουν το API μέσα σε λίγα λεπτά.
Τι είναι το requestGuid και γιατί απαιτείται;
Κάθε κλήση του API πρέπει να περιλαμβάνει ένα μοναδικό requestGuid, το οποίο προσδιορίζει το αίτημα στα αρχεία καταγραφής μας και επιτρέπει στην ομάδα υποστήριξης να εντοπίσει την ακριβή συναλλαγή όταν αναφέρετε ένα πρόβλημα. Γίνεται δεκτή οποιαδήποτε μοναδική αλφαριθμητική τιμή· συνιστούμε τη δημιουργία ενός τυπικού UUID/GUID στην πλευρά του πελάτη.
Ποια είναι η συνηθέστερη αιτία αποτυχίας μιας κλήσης του API στην πρώτη προσπάθεια;
Διαπιστευτήρια που η υπηρεσία δεν δέχεται: είτε κεφαλίδα HTTP Basic Authorization που λείπει ή είναι εσφαλμένη είτε, όταν η κλήση πιστοποιείται με OAuth2, διακριτικό πρόσβασης (access token) που δεν ζητήθηκε ποτέ, που ανήκει σε άλλο περιβάλλον ή που έχει ήδη λήξει. Υπάρχει μια ειδική διεύθυνση URL υποστήριξης την οποία μπορείτε να καλέσετε για να επιβεβαιώσετε ότι το API λειτουργεί και ότι τα διαπιστευτήριά σας είναι έγκυρα. Αν δεν μπορείτε να προχωρήσετε, στείλτε μας το πλήρες αίτημα και την πλήρη απόκριση HTTP (συμπεριλαμβανομένου του requestGuid) και μια περιγραφή της αναμενόμενης συμπεριφοράς — αυτός είναι ο ταχύτερος τρόπος να επιλυθεί το πρόβλημα.