Διασύνδεση με την Γενική Ταχυδρομική και έκδοση Voucher για Παραγγελίες

Ημερομηνία 09/08/2021

Σκοπός: Η μελέτη περιγράφει τα βήματα εγκατάστασης αλλά και τη λειτουργία του module [Επικοινωνία με Γενική Ταχυδρομική]. Με το συγκεκριμένο module δίνεται η δυνατότητα άμεσης επικοινωνίας με την Γενική Ταχυδρομική, ούτως ώστε να εκδίδονται αυτόματα voucher αποστολής των παραγγελιών που καταχωρούνται στην εφαρμογή Πήγασος. Επιπρόσθετα, μετά την έκδοσή τους, η Γενική Ταχυδρομική ενημερώνεται ώστε να παραλάβει τις παραγγελίες προς αποστολή.

Προαπαιτούμενα:

- Module PE.00.120 - Επικοινωνία με Γενική Ταχυδρομική

- Θα πρέπει να βεβαιωθείτε ότι λειτουργεί η βιβλιοθήκη SOAP Client της PHP στο χώρο σας (Μπορείτε να δείτε αν είναι ενεργή από το CPanel->Βιβλιοθήκες PHP).

- ΣΗΜΑΝΤΙΚΗ ΣΗΜΕΙΩΣΗ: η Γενική Ταχυδρομική απαιτεί να εκτελεστούν κάποια σενάρια ελέγχου(Authenticate, Create, GetVouchersPdf, CancelJob, ClosePendingJobs) με δοκιμαστικούς κωδικούς πριν την live σύνδεση με το API της. Για την υλοποίηση αυτών των δοκιμαστικών σεναρίων θα πρέπει να έχετε παραλάβει τους «test» κωδικούς από την Γενική Ταχυδρομική.

Αρχικοποίηση
Στο [Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Βασικές Παράμετροι Επικοινωνίας με Γενική Ταχυδρομική] συμπληρώνουμε τα «test» στοιχεία που μας έχουν δώσει (App key, Username, Password και το test url) όπως αναφέρεται εδώ.
Υπηρεσίες
Από το [Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Υπηρεσίες Γενικής Ταχυδρομικής Ανά Τρόπο Αποστολής] δημιουργούμε μια ή παραπάνω υπηρεσίες αποστολής για να την χρησιμοποιήσουμε κατά τους έλεγχους, όπως περιγράφεται εδώ.
Προσοχή: Είναι σημαντικό να δημιουργήσουμε κάποια υπηρεσία για ένα από τους τρόπους αποστολής που χρησιμοποιούμε στις παραγγελίες μας αλλιώς δεν θα μπορούμε να δημιουργήσουμε test voucher.
Σενάρια Δοκίμων
1) Από την επιλογή [Πελάτες->Παραγγελίες Πελατων] ανοίγουμε κάποια παραγγελία που ο τρόπος αποστολής της είναι αυτός που καταχωρίσαμε στις υπηρεσίες νωρίτερα.
2) Επιλέγουμε [Ενέργειες-> Γενική Ταχυδρομική]. Στο παράθυρο που μας ανοίγει, κάνουμε κλικ στο button [εύρεση Στοιχείων Voucher] ή συμπληρώνουμε τα απαραίτητα πεδία και πατάμε [Δημιουργία Voucher], όπως περιγράφεται εδώ.
Αν συμπληρωθεί αυτόματα το πεδίο [Αριθμός Voucher], τότε έχουμε ολοκληρώσει τον έλεγχο για το σενάριο Authenticate και Create.
3) Στην ίδια καρτέλα, πατάμε το button [εκτύπωση voucher]. Αν ανοίξει η εκτύπωση για το voucher(όπως εδώ), έχει ολοκληρωθεί ο έλεγχος για το σενάριο GetVoucherspdf.
4) Στην ίδια καρτέλα, πατάμε το button [Aκύρωση voucher]. Eφόσον σας εμφανίσει μήνυμα [Το voucher ακυρώθηκε], έχει ολοκληρωθεί ο έλεγχος για το σενάριο CancelJob.
5) Από το [Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική-> Παραγγελίες // Γενικής Ταχυδρομική Voucher], επιλέγουμε [Λειτουργίες -> Κλείσιμο Ημέρας] όπως περιγράφεται εδώ και αναμένουμε να δούμε το μήνυμα [Η διεργασία Εκτελέστηκε με επιτυχία], το οποίο σημαίνει ότι έχει ολοκληρωθεί ο ελεγχος και για το σενάριο ClosePendingJobs.

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

Βήματα:

1. Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Βασικές Παράμετροι Επικοινωνίας με Γενική Ταχυδρομική

Παράμετροι Διασύνδεσης: Τα δεδομένα των παραμέτρων διασύνδεσης δίνονται από την Γενική Ταχυδρομική και σχετίζονται με τον λογαριασμό στον οποίο θα χρεώνονται τα voucher που θα εκδίδει η εφαρμογή.
SOAP Service (URL): Προσοχή! είναι απαραίτητο το URL να τελειώνει σε ?WSDL
Φόρμα Εκτύπωσης Voucher σε PDF: Ορίζει τον τρόπο με τον οποίο θα δημιουργείται το pdf από την Γενική Ταχυδρομική με τα Voucher που θέλουμε να τυπώσουμε αν θα είναι σε Flyer ή Sticker

2. Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Υπηρεσίες Γενικής Ταχυδρομικής Ανά Τρόπο Αποστολής

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

Τρόπος Αποστολής: Τρόπος Αποστολής Καταστήματος

Ο τρόπος αποστολής που ορίζετε για τις παραγγελίες (μπορείτε να διαχειριστείτε τους τρόπους αποστολής παραγγελιών από Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Αποθήκης->Τρόποι Μεταφοράς Εμπορευμάτων).

Καταχωρώντας έναν τρόπο αποστολής εδώ ουσιαστικά τον ορίζετε και ως τρόπο αποστολής που συμμετέχει στις αποστολές της Γενικής Ταχυδρομικής.
Έχει Αντικαταβολή: Αν κατά την καταχώρηση των στοιχείων της παραγγελίας (για αυτόν τον τρόπο αποστολής) θα πρέπει να καταχωρηθεί το σύνολο της παραγγελίας ως ποσό αντικαταβολής στην αποστολή.
Κωδικοί Υπηρεσιών: Οι κωδικοί υπηρεσιών της Γενικής Ταχυδρομικής που θα ισχύουν για αυτόν τον τρόπο αποστολής.

Παράδειγμα: Για τον τρόπο αποστολής του καταστήματος αντικαταβολή με παράδοση Σάββατο θα πρέπει να είναι επιλεγμένες οι υπηρεσίες αντικαταβολή μετρητά και παράδοση Σάββατο της Γενικής Ταχυδρομικής και επιλεγμένο το checkbox «Έχει Αντικαταβολή».

ΠΡΟΣΟΧΗ!
Αν για κάποιο τρόπο αποστολής δεν επιλέξετε καμιά υπηρεσία τότε θεωρείται (Από την Γενική Ταχυδρομική) ως αποστολή χρέωση αποστολέα.

Παράδειγμα: Για να υλοποιήσουμε τον τρόπο αποστολής «Δωρεάν αποστολή σε Παραγγελία που έχει εξοφληθεί με τραπεζική κατάθεση» θα πρέπει να μην έχουμε επιλεγμένο το «έχει αντικαταβολή και να μην επιλέξουμε καμία υπηρεσία στο κωδικοί υπηρεσιών. Αυτό θα έχει ως αποτέλεσμα να αποστείλουμε ένα «ελεύθερο» δέμα στον παραλήπτη και το κόστος αποστολής θα χρεωθεί στον αποστολέα.

Σημείωση: Μπορείτε να δείτε τους κωδικούς υπηρεσιών της Γενικής Ταχυδρομικής στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Υπηρεσίες Αποστολής Γενικής Ταχυδρομικής]

Υπηρεσίες Αποστολής Γενικής Ταχυδρομικής: Οι παραπάνω εγγραφές αποδίδονται αυτολεξεί από την Γενική Ταχυδρομική και αποτελούν τους κωδικούς με τους οποίους χρεώνει - ενεργοποιεί επιπρόσθετες υπηρεσίες για κάθε αποστολή (πχ αντικαταβολή, παράδοση Σάββατο κλπ).

Αν για μια αποστολή δεν έχει οριστεί καμιά υπηρεσία τότε η Γενική Ταχυδρομική θεωρεί ότι είναι μια αποστολή με Χρέωση Αποστολέα.

Λειτουργία:

1. Σε κάθε παραγγελία, υπάρχει η επιλογή [Ενέργειες->Γενική Ταχυδρομική].

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

Δεν συμπληρώνεται αυτόματα: Αν κατά την εύρεση στοιχείων αποστολής τα πεδία συμπληρώνονται αυτόματα από τα στοιχεία που είναι καταχωρημένα στην παραγγελία που αναφέρεται η αποστολή.
Παραγγελία: Η παραγγελία για την οποία αναφέρεται αυτή η αποστολή (Μπορείτε να δείτε το σύνολο των καταχωρημένων παραγγελιών από Πελάτες->Παραγγελίες Πελατων
Ημερομηνία Αποστολής: Η ημερομηνία αποστολής της παραγγελίας (Πρέπει να είναι μεγαλύτερη ή ίση του σήμερα κατά την έκδοση του αριθμού Voucher από την Γενική Ταχυδρομική)
Αριθμός Voucher: Εκδίδεται από την Γενική Ταχυδρομική και καταχωρείται αυτόματα όταν πατήσουμε «Δημιουργία Voucher»
Στοιχεία Παραλήπτη: Τα Στοιχεία παραλήπτη που θα αναγράφονται πάνω στο έντυπο του Voucher (sticker ή flyer)
Τ.Κ. Παραλήπτη: Προσοχή είναι σημαντικό η αποστολή να έχει καταχωρημένο και σωστό TK
Στοιχεία Αποστολής: Τα στοιχεία της αποστολής όπως το ποσό αντικαταβολής (Αν υπάρχει), το βάρος του δέματος, το sub code (Αν υπάρχει) και οι υπηρεσίες (της γενικής ταχυδρομικής) που ισχύουν για αυτήν την αποστολή.
Υπηρεσίες: Οι υπηρεσίες της γενικής ταχυδρομικής που θα κάνει χρήση αυτή η αποστολή.

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

ΠΡΟΣΟΧΗ!
Αν δεν επιλέξετε καμιά υπηρεσία τότε θεωρείται (Από την Γενική Ταχυδρομική) ως αποστολή χρέωση αποστολέα.

Παράδειγμα: Για να υλοποιήσουμε τον τρόπο αποστολής «Δωρεάν αποστολή σε Παραγγελία που έχει εξοφληθεί με τραπεζική κατάθεση» θα πρέπει ι να μην επιλέξουμε καμία υπηρεσία στο «Υπηρεσίες». Αυτό θα έχει ως αποτέλεσμα να αποστείλουμε ένα «ελεύθερο» δέμα στον παραλήπτη και το κόστος αποστολής θα χρεωθεί στον αποστολέα.
Ποσό Αντικαταβολής: Το ποσό αντικαταβολής της παραγγελίας (αν υπάρχει). Για να αναγράψουμε ποσό σε αυτό το πεδίο θα πρέπει να έχουμε επιλέξει και υπηρεσία που έχει αντικαταβολή (όπως για παράδειγμα το αντικαταβολή μετρητής) .
Ποσό Ασφάλισης: Το ποσό ασφάλισης της παραγγελίας (αν υπάρχει). Για να αναγράψουμε ποσό σε αυτό το πεδίο θα πρέπει να έχουμε επιλέξει και υπηρεσία που έχει ασφάλιση (όπως για παράδειγμα το «Ασφάλιση»).
Βάρος: Το Ογκομετρική ή Φυσικό βάρος της αποστολής (όποιο είναι μεγαλύτερο)
Κομμάτια: Τα κομμάτια της αποστολής (Συσκευασίες). Για κάθε αποστολή θεωρούμε ένα «δέμα» - μια αποστολή – ένα κομμάτι (Δεν σχετίζεται με το πόσα είδη έχει μέσα το κάθε δέμα).
Sub Code: Υπό κωδικός συσκευασίας της Γενικής Ταχυδρομικής. Χρησιμοποιείται σε εξειδικευμένες περιπτώσεις
Σχόλια για την Αποστολή: Τα σχόλια αποστολής αναγράφονται πάνω στο έντυπο της αποστολής (sticker ή flyer) και είναι βοηθητικές πληροφορίες για την αποστολή (πχ: "Το κουδούνι γράφει Παπαδόπουλος" ή "Παράδοση ώρες καταστημάτων").

2. Κάνοντας κλικ στο button [Εύρεση στοιχείων Voucher], καταχωρούνται αυτόματα τα στοιχεία παραλήπτη. Απαραίτητη προϋπόθεση είναι να έχει επιλεχθεί ο παραλήπτης στο tab [Λοιπά Στοιχεία] της παραγγελίας και στο ομώνυμο πεδίο (διαβάζει τα στοιχεία από την καρτέλα του).

Σημείωση: με την [Εύρεση Στοιχείων Voucher], εφόσον οι υπηρεσίες της Γενικής Ταχυδρομικής έχουν αντιστοιχιστεί με τον τρόπο αποστολής της συγκεκριμένης παραγγελίας (βλ. Βήματα#2), θα καταχωρηθούν αυτόματα στο ανάλογο πεδίο.

3. Εφόσον έχουν καταχωρηθεί τα απαραίτητα στοιχεία, κάνοντας κλικ στο button [Δημιουργία Voucher], γίνεται η επικοινωνία με το service της Γενικής Ταχυδρομικής και δημιουργείται αυτόματα ο σχετικός αριθμός voucher.

4. Στη συνέχεια, μπορείτε να εκτυπώσετε απευθείας το voucher, κάνοντας κλικ στο button [Εκτύπωση Voucher].

Τα στοιχεία παραλήπτη καθώς και ο αριθμός voucher έχουν συμπληρωθεί αυτόματα.

Ακύρωση Voucher: Σήμανση του Voucher ως ακυρωμένου (Για την Γενική Ταχυδρομική). Ένα Voucher μπορεί να ακυρωθεί μόνο αν δεν έχει γίνει κλείσιμο ημέρας μετά από την έκδοση του. Μπορείτε να δείτε όλα τα voucher (και τα ακυρωμένα) από [Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Vouchers].

ΠΡΟΣΟΧΗ: Εφόσον δεν θέλετε να χρησιμοποιήσετε ένα voucher που δημιουργήσατε σε μια παραγγελία, θα πρέπει οπωσδήποτε να το ακυρώσετε, ειδάλλως στο κλείσιμο ημέρας, η Γενική Ταχυδρομική θα ενημερωθεί ότι έχει να παραλάβει και αυτό.

Διαγραφή Voucher: Η διαγραφή ενός Voucher αποσυνδέει το voucher από την παραγγελία. Αν έχετε κάνει ήδη κλείσιμο ημέρας και χρειαστεί να καταχωρήσετε ένα νέο voucher για κάποια από τις κλεισμένες παραγγελίες (πχ κάλεσε ο αποστολέας και ενημέρωσε ότι πρέπει να αλλαχτεί η διεύθυνση), θα πρέπει να διαγράψετε τον αρ.voucher με αυτό το button και στη συνέχεια να καταχωρήσετε νέο (σύμφωνα με τα προηγούμενα βήματα).

Σημείωση: Για τον αρ.voucher που έχει ήδη λάβει η Γενική Ταχυδρομική(μέσω του κλεισίματος ημέρας), θα χρειαστεί να επικοινωνήσετε με το τοπικό υποκ/μα Γενικής Ταχυδρομικής ώστε να διευθετηθεί.

Μαζική έκδοση voucher

Eκτός από τη μεμονωμένη έκδοση και εκτύπωση voucher, η διαδικασία μπορεί να γίνει και μαζικά στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Παραγγελίες // Γενικής Ταχυδρομικής Voucher]. Από αυτή την επιλογή, ο χρήστης μπορεί να αναζητήσει παραγγελίες, να εκδόσει/εκτυπώσει μαζικά voucher, αλλά και να ενημερώσει την Γενική Ταχυδρομική σχετικά με την παραλαβή των δεμάτων για τα οποία εκδόθηκε voucher.

Αναζήτηση Παραγγελιών: Με βάση τα κατάσταση παραγγελίας και ημερομηνία από-έως το σύστημα αναζητά και μας παρουσιάζει όλες τις παραγγελίες οι οποίες ταιριάζουν σε αυτά τα κριτήρια.

Σημείωση: Αν για μια παραγγελία ο τρόπος αποστολής της δεν είναι συνδεδεμένος με κάποια από τις υπηρεσίες της Γενικής Ταχυδρομικής (η σύνδεση γίνεται από Toolbox->Εργαλεία Παραμετροποίησης->Voucher Γενική Ταχυδρομική->Υπηρεσίες Γενικής Ταχυδρομικής Ανά Τρόπο Αποστολής), τότε ο προεπιλεγμένος τρόπος (Η αποστολή χωρίς υπηρεσίες) είναι ο --- Αποστολή Χρέωση Αποστολέα ---
Εύρεση Στοιχείων Voucher: Κάνει τις ίδιες ενέργειες που κάνει το ομώνυμο button στη μεμονωμένη καταχώρηση (φέρνει τα στοιχεία του παραλήπτη και τις υπηρεσίες της Γεν. Ταχυδρομικής εφόσον έχουν συνδεθεί με τον τρόπο αποστολής της συγκεκριμένης παραγγελίας) για τις επιλεγμένες παραγγελίες.

Σημείωση: Με διπλό κλικ στην επιθυμητή παραγγελία, ανοίγει το παράθυρο καταχώρησης ώστε να συμπληρωθούν επιπλέον στοιχεία αν χρειάζεται.
Εκτύπωση Επιλεγμένων Voucher: Επιλέγοντας τις παραγγελίες που θέλουμε (οι οποίες έχουν voucher) μπορούμε πατώντας εδώ να δημιουργήσουμε ένα εκτυπώσιμο PDF με τα χαρτιά ή αυτοκόλλητα για τις συσκευασίες.
Μαζική Αποστολή: Έκδοση Voucher.
Προσοχή! Αυτή η διαδικασία δεν ακυρώνεται.
Καταχωρούμε στο σύστημα της Γενικής ταχυδρομικής την παραγγελία μας και παραλαμβάνουμε τον αριθμό voucher.
Το Παραπάνω συμβαίνει για κάθε επιλεγμένη παραγγελία που έχει καταχωρηθεί και δεν έχει εκδώσει voucher.
Κλείσιμο Ημέρας: Προσοχή! Η διαδικασία είναι μη αναστρέψιμη.
Με το κλείσιμο ημέρας ενημερώνουμε το υποκατάστημα της Γενικής Ταχυδρομικής για την ύπαρξη των Voucher για να ρυθμίσει παραλαβή. Η Γενική Ταχυδρομική θα παραλάβει όλα τα voucher που έχουν δημιουργηθεί έως και την ημερομηνία κλεισίματος πχ αν εκτελέσετε κλείσιμο μετά από 1 εβδομάδα και στο διάστημα αυτό έχετε δημιουργήσει voucher, θα σταλούν όλα για παραλαβή.
Προσοχή! Αν δεν γίνει κλείσιμο ημέρας το υποκατάστημα δεν θα ενημερωθεί και δεν θα γίνει παραλαβή.
Σημαντικό! Μπορείτε να κάνετε κλείσιμο ημέρας πάνω από μια φορές την μέρα.