Βάση γνώσεων Deliveo

Το Deliveo Website Plugin (DWP) είναι ένα module της Deliveo που μπορεί να ενσωματωθεί σε έναν ιστότοπο και επιτρέπει στους επισκέπτες ή τους πελάτες του ιστότοπου να παραδίδουν απευθείας τις αποστολές τους, να ελέγχουν τις υπάρχουσες αποστολές τους, καθώς και να εκτελούν περαιτέρω ενέργειες, ανάλογα με τις εγκεκριμένες λειτουργίες.

Το DWP συνδέεται με το σύστημα μέσω του API της Deliveo, επομένως για τη χρήση του απαιτείται ενεργή συνδρομή στη Deliveo και πρόσβαση στο API.

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

Κύριες λειτουργίες

Το DWP παρέχει, μεταξύ άλλων, τις ακόλουθες λειτουργίες:

δημιουργία νέου αποστολής·
επιλογή τρόπου παράδοσης·
επιλογή σημείου παραλαβής·
Διαχείριση πληρωμής κατά την παράδοση;
Χρήση αριθμού αναφοράς και κωδικού παρακολούθησης·
Διαχείριση των ειδικών πεδίων OP1–OP3;
υπολογισμός κόστους αποστολής;
υπολογισμός του όγκου-βάρους;
Ηλεκτρονική πληρωμή μέσω Barion;
Αναζήτηση αποστολής;
εμφάνιση πληροφοριών παρακολούθησης;
λήψη ετικέτας;
λήψη δελτίου υπογραφής;
τροποποίηση ή διαγραφή αποστολής, όπου επιτρέπεται·
έναρξη διαδικασίας επιστροφής παραδοθέντος αποστολής.

Ορισμένες από τις διαθέσιμες λειτουργίες μπορούν να ενεργοποιηθούν ή να απενεργοποιηθούν από τις ρυθμίσεις.

Αποστολή αποστολής

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

Στοιχεία αποστολέα

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

όνομα;
επωνυμία εταιρείας;
χώρα;
ταχυδρομικός κώδικας;
πόλη·
διεύθυνση;
αριθμός τηλεφώνου;
διεύθυνση ηλεκτρονικού ταχυδρομείου.

Τα πεδία που εμφανίζονται στην πραγματικότητα ενδέχεται να διαφέρουν ανάλογα με την έκδοση και τη διαμόρφωση του DWP.

Στοιχεία παραλήπτη

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

Χρήση σημείου παραλαβής

Το DWP μπορεί να εμφανίζει ενεργές τοποθεσίες τύπου «Σημείο Παραλαβής» που έχουν δημιουργηθεί στο Deliveo. Το «Σημείο Παραλαβής» μπορεί να επιλεγεί ξεχωριστά:

στη σελίδα παραλαβής·
στην πλευρά παράδοσης.

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

Διαχείριση πληρωτών λογαριασμών

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

Χρήση σταθερού Πελάτη

Στη διαμόρφωση μπορεί να καθοριστεί ένα σταθερό αναγνωριστικό Πελάτη. Σε αυτή την περίπτωση:

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

Αυτό μπορεί να χρησιμοποιηθεί σε ιστότοπους όπου το DWP παρέχεται σε έναν μόνο συμβεβλημένο Πελάτη.

Δημιουργία Πελάτη με βάση τα καθορισμένα στοιχεία

Εάν δεν έχει οριστεί σταθερός Πελάτης, ο επισκέπτης μπορεί να εισάγει τα στοιχεία του πληρωτή του λογαριασμού. Με βάση αυτά, το DWP ελέγχει εάν ο αντίστοιχος Πελάτης υπάρχει ήδη στο σύστημα της Deliveo.

Εάν βρεθεί, χρησιμοποιεί τον υπάρχοντα Πελάτη. Εάν δεν βρεθεί κατάλληλος Πελάτης, το DWP δημιουργεί έναν με βάση τα δεδομένα που έχουν εισαχθεί και, στη συνέχεια, συνδέει τη νέα αποστολή με αυτόν τον Πελάτη.

Περιεχόμενο αποστολής και ColliΜονάδα συσκευασίας. Δείχνει πόσα τεμάχια περιλαμβάνονται σε μια δεδομένη αποστολή.

Μια αποστολή μπορεί να αποτελείται από ένα ή περισσότερα φυσικά πακέτα, δηλαδή ColliΜονάδα συσκευασίας. Δείχνει πόσα τεμάχια περιλαμβάνονται σε μια δεδομένη αποστολή.. Στο DWP μπορούν να προστεθούν περισσότερα ColliΜονάδα συσκευασίας. Δείχνει πόσα τεμάχια περιλαμβάνονται σε μια δεδομένη αποστολή. στην ίδια αποστολή. Για κάθε ColliΜονάδα συσκευασίας. Δείχνει πόσα τεμάχια περιλαμβάνονται σε μια δεδομένη αποστολή. μπορούν να καταχωρηθούν, μεταξύ άλλων:

βάρος·
μήκος;
πλάτος;
ύψος;
μοναδικός κωδικός αναγνώρισης.

Το DWP καθορίζει τα συνολικά στοιχεία της αποστολής με βάση τα στοιχεία κάθε ColliΜονάδα συσκευασίας. Δείχνει πόσα τεμάχια περιλαμβάνονται σε μια δεδομένη αποστολή.k.

Συνολικό βάρος και συνολικός όγκος

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

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

Επιλογές αποστολής

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

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

Αντικαταβολή

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

Αριθμός αναφοράς και κωδικός παρακολούθησης

Για την αποστολή μπορούν να καταχωρηθούν:

Αριθμός αναφοράς·
Κωδικός παρακολούθησης.

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

Μοναδικά πεδία OP1–OP3

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

Υπολογισμός τελών

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

η διεύθυνση παραλαβής και η διεύθυνση παράδοσης·
η επιλογή μεταφοράς·
ο αριθμός των δεμάτων·
βάρος·
ο όγκος·
όγκος-βάρος;
πληρωμή κατά την παράδοση;
οι όροι τιμολόγησης που έχουν ρυθμιστεί στο Deliveo.

Το πραγματικό τέλος καθορίζεται πάντα από τον τιμοκατάλογο που έχει ρυθμιστεί στο Deliveo.

Ηλεκτρονική πληρωμή μέσω Barion

Το DWP μπορεί να χρησιμοποιηθεί και με ηλεκτρονική πληρωμή μέσω Barion. Εάν η ενσωμάτωση του Barion είναι ενεργοποιημένη και ο υπολογισμός της χρέωσης στο Deliveo επιστρέφει ένα πληρωτέο ποσό, ο επισκέπτης μπορεί να πληρώσει ηλεκτρονικά το κόστος της υπηρεσίας ως μέρος της αποστολής της αποστολής.

Η διαδικασία σε αυτή την περίπτωση είναι η εξής:

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

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

Αναζήτηση αποστολής

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

το DeliveoIDΤο μοναδικό πρωτογενές αναγνωριστικό των αποστολών σας στο σύστημα Deliveo.·
τον ταχυδρομικό κώδικα του παραλήπτη.

Η συνδυασμένη χρήση των δύο στοιχείων αποτρέπει την πρόσβαση στα στοιχεία της αποστολής από οποιονδήποτε γνωρίζει μόνο το DeliveoIDΤο μοναδικό πρωτογενές αναγνωριστικό των αποστολών σας στο σύστημα Deliveo..

Τα στοιχεία που εμφανίζονται κατά την αναζήτηση

Μετά την επιτυχή ταυτοποίηση, το DWP μπορεί να εμφανίσει τις πληροφορίες που αφορούν την αποστολή.

Αυτές μπορεί να περιλαμβάνουν:

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

Η εμφάνιση των στοιχείων του αποστολέα και του παραλήπτη μπορεί να ρυθμιστεί ξεχωριστά.

Λήψη ετικέτας

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

Φύλλο υπογραφής

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

Τροποποίηση και διαγραφή αποστολής

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

δεν έχει παραληφθεί ακόμη από τον κούριερ·
δεν έχει ακόμη παραδοθεί·
δεν έχει πληρωθεί.

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

Επιστροφή

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

Κατά τη διαδικασία αυτή, τα αρχικά:

τα στοιχεία του αποστολέα μετατρέπονται σε στοιχεία του παραλήπτη της επιστροφής·
τα στοιχεία του παραλήπτη γίνονται αποστολέας της επιστροφής

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

Προσαρμογή εμφάνισης

Η εμφάνιση του DWP είναι εν μέρει παραμετροποιήσιμη. Μεταξύ άλλων, μπορείτε να ρυθμίσετε:

το δικό σας λογότυπο·
χρώμα θέματος·
τις εμφανιζόμενες λειτουργίες·
ονόματα συγκεκριμένων πεδίων·
τα εμφανιζόμενα ονόματα των πεδίων OP1–OP3·
δεδομένα που εμφανίζονται στη σελίδα παρακολούθησης.

Με αυτόν τον τρόπο, η εμφάνιση του DWP μπορεί να προσαρμοστεί στην ιστοσελίδα της εταιρείας ταχυμεταφορών.

Πολυγλωσσική λειτουργία

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

Εγκατάσταση

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

τα στοιχεία σύνδεσης με το API του Deliveo·
τις λειτουργίες που επιθυμείτε να χρησιμοποιήσετε·
το ενδεχόμενο σταθερό αναγνωριστικό πελάτη (Client ID)·
τις ρυθμίσεις εμφάνισης·
τα δεδομένα που απαιτούνται για την ηλεκτρονική πληρωμή·
άλλες παραμέτρους λειτουργίας.

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

Λήψη: https://gitlab.com/mav-it/deliveo-website-plugin

Δemo: https://dwp.deliveo.eu/

Απαιτήσεις διακομιστή

Το DWP είναι μια εφαρμογή βασισμένη σε PHP. Συνιστάται πάντα η χρήση μιας έκδοσης PHP που εξακολουθεί να υποστηρίζεται επίσημα.

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

Ενημέρωση

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

Το πρόσθετο μπορεί να ενημερωθεί αυτόματα από τον ιστότοπο https://gitlab.com/mav-it/deliveo-website-plugin. Για να εκτελέσετε την ενημέρωση, προσθέστε μετά τη διεύθυνση URL εγκατάστασης: /update

Π.χ.: dwp.example.com/update

Σημαντικές πληροφορίες

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

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