Η ενσωμάτωση μπορεί να ενεργοποιηθεί ανά πελάτη, επομένως διαβιβάζονται μόνο τα στοιχεία αποστολών που αφορούν τους καθορισμένους πελάτες της Deliveo.
Προϋποθέσεις
- συνδρομή στη σύνδεση API της Deliveo·
- Συνδρομή στη χρήση webhook της Deliveo;
- ενεργός λογαριασμός Project44·
- δικαιώματα για την εγκατάσταση του πρόσθετου·
- δικαιώματα για τη ρύθμιση και τη χρήση του πρόσθετου.
Εγκατάσταση και πρόσβαση
Το πρόσθετο μπορεί να εγκατασταθεί στο Πορτάλ Διαχειριστή, στην ενότητα «Πρόσθετα».
Μετά την εγκατάσταση, είναι προσβάσιμο από την επιλογή «Πρόσθετα / Project44 Connect». Η εγκατάσταση και η χρήση μπορούν να πραγματοποιηθούν μόνο από χρήστες που διαθέτουν τα κατάλληλα δικαιώματα.
Τα δικά του μενού του πρόσθετου:
- Πίνακας ελέγχου
- Πελάτες
- Ρυθμίσεις
Σύνδεση με τον λογαριασμό Project44
Κατά τη σύνδεση του πρόσθετου, το σύστημα δημιουργεί έναν τεχνικό χρήστη στον λογαριασμό Project44.
Για να ολοκληρώσετε τη σύνδεση:
- Ανοίξτε τη διαχείριση χρηστών του Project44.
- Εντοπίστε τον χρήστη με το όνομα που εμφανίζεται στη σελίδα «Ρυθμίσεις» του Project44 Connect.
- Ανοίξτε τους ρόλους του χρήστη.
- Στην ενότητα «Roles», κάντε κλικ στο κουμπί «Manage Roles».
- Προσθέστε το δικαίωμα «Shipment management».
- Αποθηκεύστε την αλλαγή.
Στη σελίδα «Ρυθμίσεις» του Project44 Connect, μια πράσινη ένδειξη κατάστασης υποδεικνύει ότι η σύνδεση έχει δημιουργηθεί με επιτυχία.
Ρύθμιση του αναγνωριστικού αποστολής που θα διαβιβάζεται
Στη σελίδα «Ρυθμίσεις» μπορείτε να επιλέξετε ποιο αναγνωριστικό αποστολής θα προωθεί το Deliveo στο Project44. Τα διαθέσιμα αναγνωριστικά είναι:
- DeliveoIDΤο μοναδικό πρωτογενές αναγνωριστικό των αποστολών σας στο σύστημα Deliveo.
- Αριθμός αναφοράς
- Κωδικός παρακολούθησης
Για να αποθηκεύσετε την επιλεγμένη τιμή, κάντε κλικ στο κουμπί «Αποθήκευση ρύθμισης αναγνωριστικού». Η ρύθμιση αλλάζει μόνο το αναγνωριστικό που διαβιβάζεται στο Project44. Η εσωτερική αντιστοίχιση των συμβάντων του Deliveo και του Project44 εξακολουθεί να γίνεται με βάση το DeliveoIDΤο μοναδικό πρωτογενές αναγνωριστικό των αποστολών σας στο σύστημα Deliveo..
Ρύθμιση webhooks
Το Project44 Connect λαμβάνει ειδοποιήσεις για τα συμβάντα αποστολών μέσω της λειτουργίας webhooks του Deliveo. Για τη ρύθμιση:
- Ανοίξτε την επιλογή «Ρυθμίσεις / Webhooks» στην Πύλη Διαχείρισης.
- Επιλέξτε το συγκεκριμένο συμβάν.
- Ανοίξτε τις αναλυτικές ρυθμίσεις του συμβάντος.
- Αντιγράψτε τη διεύθυνση URL του webhook που εμφανίζεται για το συγκεκριμένο συμβάν στη σελίδα «Ρυθμίσεις» του Project44 Connect.
- Αποθηκεύστε τη ρύθμιση του webhook.
- Επαναλάβετε τη διαδικασία για κάθε απαιτούμενο συμβάν.
Υπάρχει ξεχωριστή διεύθυνση URL webhook για τα παρακάτω συμβάντα:
- Δημιουργία αποστολής
- Παραλαβή αποστολής
- Μεταφορά
- Επιτυχής παράδοση
- Αποτυχημένη παράδοση
Οι διευθύνσεις URL των webhook είναι μοναδικές, γι' αυτό πρέπει πάντα να χρησιμοποιείτε τις διευθύνσεις που εμφανίζονται στη σελίδα «Ρυθμίσεις» της εκάστοτε εγκατάστασης του Project44 Connect.
Επιλογή πελατών
Στη σελίδα «Πελάτες» μπορείτε να ρυθμίσετε ποια δεδομένα πελατών της Deliveo θα διαβιβάζονται στο Project44.
Για να ενεργοποιήσετε έναν πελάτη:
- Ανοίξτε την επιλογή μενού «Πελάτες».
- Εντοπίστε τον πελάτη στη λίστα.
- Ενεργοποιήστε το διακόπτη «Ενεργό» που βρίσκεται στη γραμμή του πελάτη.
Όταν είναι ενεργοποιημένο, τα συμβάντα αποστολής που σχετίζονται με τον συγκεκριμένο πελάτη θα διαβιβάζονται. Όταν είναι απενεργοποιημένο, τα δεδομένα του πελάτη δεν θα διαβιβάζονται στο Project44.
Η λίστα πελατών:
- μπορεί να φιλτραριστεί βάσει ονόματος·
- το φίλτρο μπορεί να διαγραφεί·
- σε περίπτωση πολλών σελίδων, μπορείτε να περιηγηθείτε μεταξύ τους.
Πριν ενεργοποιήσετε την ενσωμάτωση, βεβαιωθείτε ότι είναι ενεργοί μόνο οι πελάτες των οποίων τα δεδομένα θέλετε να διαβιβάσετε.
Διαβιβασμένα συμβάντα
Το Project44 Connect μετατρέπει τα συμβάντα του Deliveo σε συμβάντα του Project44.
Παραδείγματα αντιστοίχισης συμβάντων:
- Δημιουργία αποστολής →
SHIPMENT_CREATED - Παραλαβή αποστολής →
PICKED_UP - Μεταφορά αποστολής →
ARRIVED_AT_STOP - Επιτυχής παράδοση →
DELIVERED - Αποτυχημένη παράδοση → για παράδειγμα
DELIVERY_MISSEDήRETURN_TO_SENDER
Το συμβάν Project44 που σχετίζεται με την αποτυχημένη παράδοση μπορεί να εξαρτάται από το συμβάν αποτυχημένης παράδοσης που έχει καταγραφεί στο Deliveo.
Πίνακας ελέγχου
Ο Πίνακας ελέγχου εμφανίζει τα αιτήματα webhook των τελευταίων 30 ημερών.
Η σελίδα συγκεντρώνει ανά τύπο συμβάντος:
- τις δημιουργίες αποστολών·
- τις παραλαβές αποστολών·
- τις μεταφορές αποστολών·
- τις επιτυχημένες παραδόσεις·
- τις απόπειρες παράδοσης·
- τις αποτυχημένες παραδόσεις.
Ο αναλυτικός κατάλογος συμβάντων περιλαμβάνει τα ακόλουθα στοιχεία:
- Αριθμός Deliveo
- Συμβάν Deliveo
- Συμβάν P44
- Αποδεχθεί
- Ημερομηνία
Η στήλη «Αποδεχθεί» υποδεικνύει αν η Project44 έχει αποδεχθεί το αποσταλθέν συμβάν.
Η λίστα:
- Μπορεί να φιλτραριστεί βάσει του Deliveo ID·
- μπορεί να περιηγηθεί κανείς στις σελίδες·
- μπορεί να χρησιμοποιηθεί για έλεγχο χρονολογικής σειράς και εντοπισμό σφαλμάτων.
Έλεγχος της σύνδεσης δεδομένων
Μετά τη ρύθμιση, συνιστάται να ελέγξετε τη λειτουργία με μια δοκιμαστική αποστολή.
- Βεβαιωθείτε ότι ο πελάτης που αντιστοιχεί στην αποστολή είναι ενεργός στη σελίδα «Πελάτες».
- Δημιουργήστε ή τροποποιήστε μια αποστολή έτσι ώστε να συμβεί ένα από τα ρυθμισμένα συμβάντα webhook.
- Ανοίξτε τον Πίνακα Ελέγχου του Project44 Connect.
- Αναζητήστε την αποστολή με βάση το Deliveo ID.
- Ελέγξτε το συμβάν Deliveo και το αντίστοιχο συμβάν P44.
- Ελέγξτε αν η στήλη «Αποδεχθεί» υποδεικνύει επιτυχή παραλαβή.
Τερματισμός της σύνδεσης
Η ενεργή σύνδεση με το Project44 μπορεί να διακοπεί χρησιμοποιώντας το κουμπί «Διαγραφή σύνδεσης» στη σελίδα «Ρυθμίσεις».
Πριν διαγράψετε τη σύνδεση, βεβαιωθείτε ότι δεν υπάρχει πλέον ανάγκη για διαβίβαση συμβάντων προς το Project44.
Μετά τη διακοπή της σύνδεσης, συνιστάται να ελέγξετε επίσης τις ρυθμίσεις webhook που σχετίζονται με το Project44 Connect στο μενού «Ρυθμίσεις Deliveo» → «Webhooks» και, εάν χρειάζεται, να τις καταργήσετε.
Συχνά σφάλματα
Δεν εμφανίζονται συμβάντα στον πίνακα ελέγχου
Ελέγξτε:
- αν η σύνδεση είναι ενεργή·
- αν ο συγκεκριμένος πελάτης είναι ενεργός στη σελίδα «Πελάτες»·
- αν έχουν ρυθμιστεί τα απαραίτητα webhooks;
- αν έχει αντιστοιχιστεί η σωστή διεύθυνση URL webhook στο αντίστοιχο συμβάν·
- αν το συμβάν συνέβη τις τελευταίες 30 ημέρες.
Το Project44 δεν δέχεται το συμβάν
Ελέγξτε:
- αν ο τεχνικός χρήστης του Project44 διαθέτει δικαιώματα διαχείρισης αποστολών·
- αν η σύνδεση του λογαριασμού Project44 είναι ενεργή·
- αν ο κωδικός αποστολής που διαβιβάστηκε είναι διαθέσιμος στην αποστολή·
- ποια συμβάντα Deliveo και P44 εμφανίζονται στον πίνακα ελέγχου.
Οι αποστολές ενός πελάτη δεν προωθούνται
Ανοίξτε τη σελίδα «Πελάτες» και ελέγξτε αν ο διακόπτης «Ενεργός» για τον συγκεκριμένο πελάτη είναι ενεργοποιημένος.
Εμφανίζεται λανθασμένος κωδικός αποστολής στο Project44
Ελέγξτε τον κωδικό αποστολής που έχετε επιλέξει στη σελίδα «Ρυθμίσεις».
Οι διαθέσιμες επιλογές είναι:
- DeliveoIDΤο μοναδικό πρωτογενές αναγνωριστικό των αποστολών σας στο σύστημα Deliveo.
- Αριθμός αναφοράς
- Κωδικός παρακολούθησης
Μετά την τροποποίηση, κάντε κλικ στο κουμπί «Αποθήκευση ρυθμίσεων αναγνωριστικού».
Δεν λειτουργεί η διαβίβαση κάποιου τύπου συμβάντος
Ελέγξτε αν το webhook που αντιστοιχεί στο συγκεκριμένο συμβάν έχει ρυθμιστεί ξεχωριστά. Για κάθε τύπο συμβάντος πρέπει να χρησιμοποιείται η δική του διεύθυνση URL, η οποία εμφανίζεται στη σελίδα Project44 Connect.