Πλήρης οδηγός εγκατάστασης & ρύθμισης του Γενική Ταχυδρομική Voucher για WooCommerce

Τι θα ρυθμίσουμε

Το Γενική Ταχυδρομική Voucher για WooCommerce συνδέει το κατάστημά σας με τα Web Services της courier, ώστε να μπορείτε να εκδίδετε, να εκτυπώνετε, να ακυρώνετε και να παρακολουθείτε vouchers απευθείας μέσα από τις παραγγελίες WooCommerce.

Web Services Σύνδεση με username, password και Application Key / AppKey.

Test / Live Πρώτα γίνεται δοκιμή με test στοιχεία και μετά ενεργοποίηση παραγωγής.

Καθημερινή χρήση Έκδοση voucher, PDF, tracking, email ενημέρωση και κλείσιμο ημέρας.

Το βασικό είναι να περαστούν σωστά τα στοιχεία σύνδεσης και να γίνει επιτυχώς το test σενάριο πριν ενεργοποιήσετε το Production Mode.

1) Πριν ξεκινήσετε

Για να λειτουργήσει το plugin απαιτούνται τα Web Services της Γενικής Ταχυδρομικής. Συνήθως η courier στέλνει πρώτα test στοιχεία για δοκιμαστικό περιβάλλον και, αφού ολοκληρωθεί επιτυχώς το test σενάριο, αποστέλλει τα live στοιχεία για παραγωγή.

Θα χρειαστείτε:

Username από τη Γενική Ταχυδρομική.
Password για τα Web Services.
Application Key, δηλαδή API Key / AppKey.

2) Εγκατάσταση & ενεργοποίηση

Η εγκατάσταση γίνεται όπως σε κάθε WooCommerce πρόσθετο.

Συνδεθείτε στο WordPress Μπείτε στο WordPress με δικαιώματα διαχειριστή.

Πηγαίνετε στα πρόσθετα Ανοίξτε Πρόσθετα → Προσθήκη νέου.

Ανεβάστε το plugin Πατήστε Μεταφόρτωση πρόσθετου και επιλέξτε το αρχείο .zip που κατεβάσατε από την αγορά.

Εγκατάσταση και ενεργοποίηση Πατήστε Εγκατάσταση και στη συνέχεια Ενεργοποίηση.

3) Ρυθμίσεις σύνδεσης API

Ανοίξτε τη σελίδα ρυθμίσεων του plugin, συνήθως από το μενού VGDev Solutions → Γενική Ταχυδρομική.

Στοιχεία σύνδεσης API

Συμπληρώστε τα στοιχεία που σας έχει στείλει η Γενική Ταχυδρομική:

Username
Password
Application Key / API Key / AppKey

Αποθήκευση & έλεγχος σύνδεσης

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

Production Mode

Test στοιχεία: αφήστε το Production Mode απενεργοποιημένο.
Live στοιχεία: ενεργοποιήστε το Production Mode.

Μην ενεργοποιήσετε Production Mode όσο χρησιμοποιείτε test στοιχεία, γιατί η σύνδεση δεν θα αντιστοιχεί στο παραγωγικό περιβάλλον.

Ρυθμίσεις σύνδεσης API Γενική Ταχυδρομική Voucher — Παράδειγμα ρυθμίσεων σύνδεσης API για τα Web Services της Γενικής Ταχυδρομικής.

4) Γενικές ρυθμίσεις

Στην ενότητα Γενικές Ρυθμίσεις θα βρείτε επιλογές που επηρεάζουν την καθημερινή λειτουργία του plugin.

Προεπιλεγμένο βάρος

Το πεδίο Προεπιλεγμένο βάρος (kg) λειτουργεί ως fallback όταν δεν μπορεί να υπολογιστεί βάρος.

Αν το αφήσετε κενό, το plugin τραβάει τα βάρη από τα προϊόντα του WooCommerce και υπολογίζει το συνολικό βάρος της παραγγελίας.
Αν υπάρχουν προϊόντα χωρίς βάρος, ορίστε μια ασφαλή τιμή, όπως 0.5 ή 1, ώστε να μη μπλοκάρει η έκδοση voucher.

Η έκδοση voucher δεν μπορεί να ολοκληρωθεί για παραγγελία με μηδενικό βάρος. Ιδανικά, συμπληρώστε βάρος σε όλα τα προϊόντα.

Μέγεθος ετικέτας

Από το πεδίο Μέγεθος Ετικέτας επιλέγετε την προεπιλογή εκτύπωσης του voucher.

Sticker 10×15 cm
Sticker Big 10×19 cm
A4
A5

Μετατροπή σε κεφαλαία

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

Αλλαγή κατάστασης παραγγελίας

Μπορείτε να ορίσετε αυτόματη αλλαγή status όταν δημιουργείται voucher ή να αφήσετε τη ρύθμιση χωρίς αλλαγή.

Γενικές ρυθμίσεις Γενική Ταχυδρομική Voucher — Γενικές ρυθμίσεις για βάρος, μέγεθος ετικέτας, κεφαλαία και status παραγγελίας.

5) Δοκιμαστική λειτουργία

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

Έκδοση voucher.
Εκτύπωση voucher.
Ακύρωση voucher.
Κλείσιμο εκκρεμών εργασιών στο τέλος ημέρας.

Οδηγίες συμπλήρωσης test Web Services

Τα test στοιχεία που θα λάβετε συνήθως έχουν μορφή όπως:

username: testapi
password: 123456@
appkey: 1C2CC345-E67B-891C-B234-B56E78BDC912

Τα συμπληρώνετε στα πεδία Username, Password και Application Key.

Βήμα-βήμα δοκιμή

Περάστε τα test στοιχεία στις ρυθμίσεις και πατήστε Αποθήκευση Ρυθμίσεων.
Βεβαιωθείτε ότι το Production Mode είναι απενεργοποιημένο.
Δημιουργήστε μία δοκιμαστική παραγγελία ή ανοίξτε μία υπάρχουσα παραγγελία σε επεξεργασία.
Στη δεξιά στήλη της παραγγελίας, στο πλαίσιο του voucher, πατήστε Δημιουργία voucher.
Πατήστε Εκτύπωση και αποθηκεύστε το PDF του δοκιμαστικού voucher.
Κάντε το Κλείσιμο Εκκρεμών Εργασιών – Σήμερα.
Επιστρέψτε στην παραγγελία και πατήστε Ακύρωση για το voucher.
Στείλτε email στη Γενική Ταχυδρομική ότι ολοκληρώθηκε το test, επισυνάπτοντας το PDF και ό,τι άλλο σας ζητήσουν.
Όταν λάβετε τα live στοιχεία, αντικαταστήστε τα στις ρυθμίσεις, ενεργοποιήστε το Production Mode και πατήστε Αποθήκευση Ρυθμίσεων.

Μην μείνετε κατά λάθος σε test στοιχεία, γιατί θα συνεχίζετε να εκδίδετε δοκιμαστικά vouchers.

Έκδοση voucher μέσα από παραγγελία WooCommerce — Έκδοση voucher μέσα από την παραγγελία WooCommerce.

Κωδικός voucher Γενική Ταχυδρομική — Παράδειγμα κωδικού voucher μετά την έκδοση.

6) Κλείσιμο Εκκρεμών Εργασιών

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

Πώς γίνεται μέσα από το plugin

Πηγαίνετε στις ρυθμίσεις του plugin: VGDev Solutions → Γενική Ταχυδρομική.
Στο επάνω μέρος της σελίδας πατήστε Προβολή Vouchers.
Θα ανοίξει η λίστα Geniki Taxydromiki Vouchers με ενεργά και ακυρωμένα vouchers.
Πατήστε Κλείσιμο Εκκρεμών Εργασιών – Σήμερα.

Πότε το κάνετε

Στο τέλος της ημέρας, αφού ολοκληρώσετε την έκδοση όλων των vouchers που θα φύγουν.
Αν εκδώσετε νέο voucher μετά το κλείσιμο, θα χρειαστεί να κάνετε ξανά κλείσιμο ώστε να συμπεριληφθεί και αυτό.

Κλείσιμο Εκκρεμών Εργασιών Γενική Ταχυδρομική — Κλείσιμο Εκκρεμών Εργασιών μέσα από τη λίστα vouchers.

7) Έκδοση voucher μέσα από την παραγγελία

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

Πηγαίνετε WooCommerce → Παραγγελίες.
Ανοίξτε την παραγγελία.
Στο box του voucher πατήστε Δημιουργία voucher.

Μετά την έκδοση, συνήθως έχετε διαθέσιμες επιλογές όπως:

Εκτύπωση για PDF voucher.
Ακύρωση voucher.
Tracking / κατάσταση αποστολής.

Χρήσιμες πληροφορίες

Στην καρτέλα voucher μπορεί να δείτε πεδία όπως:

Δέματα, συνήθως με προεπιλογή 1.
Βάρος, αν δεν υπολογίζεται αυτόματα.
Αντικαταβολή, αν η πληρωμή είναι αντικαταβολή.
Υπηρεσίες, όπως παράδοση Σάββατο όπου υποστηρίζεται.
Σχόλια.

Πριν προχωρήσετε σε ακύρωση voucher, ακολουθήστε τη διαδικασία που προβλέπει η Γενική Ταχυδρομική. Συχνά απαιτείται επικοινωνία.

8) Προβολή Vouchers

Από το κουμπί Προβολή Vouchers, στο header των ρυθμίσεων, έχετε πρόσβαση σε συγκεντρωτική λίστα.

Ενεργά και ακυρωμένα vouchers.
Συσχέτιση με παραγγελία.
Ημερομηνία.
Κουμπί Εκτύπωση για PDF.
Κουμπί Tracking, όπου υποστηρίζεται.

Η λίστα είναι χρήσιμη για γρήγορη αναζήτηση, επιβεβαίωση και για να κάνετε το Κλείσιμο Εκκρεμών Εργασιών – Σήμερα.

Προβολή Vouchers Γενική Ταχυδρομική — Συγκεντρωτική λίστα vouchers με PDF, tracking και κλείσιμο εργασιών.

9) Email Tracking & Προεπισκόπηση

Στην ενότητα Ρυθμίσεις Email & Tracking μπορείτε να ενεργοποιήσετε ενημέρωση πελάτη για το tracking της αποστολής.

Αποστολή tracking email στον πελάτη κατά την ολοκλήρωση της παραγγελίας.
Επιλογή χρώματος για το email tracking, όπως κουμπί ή border.
Προεπισκόπηση για να δείτε πώς θα φαίνεται το email πριν το ενεργοποιήσετε.

Ρυθμίσεις email tracking Γενική Ταχυδρομική — Ρυθμίσεις email και tracking για ενημέρωση πελάτη.

10) Debug Mode

Υπάρχει επιλογή Debug Mode, ώστε να καταγράφονται requests και responses σε log αρχείο για troubleshooting.

Χρησιμοποιήστε το όταν:

Αποτυγχάνει η δημιουργία voucher.
Υπάρχει πρόβλημα εκτύπωσης ή λήψης PDF.
Χρειάζεται να σταλεί τεχνική πληροφορία στην υποστήριξη.

Μην αφήνετε το Debug Mode ενεργό χωρίς λόγο, γιατί μπορεί να γεμίσει το log αρχείο με περιττά δεδομένα.

Debug Mode Γενική Ταχυδρομική Voucher — Debug Mode για καταγραφή τεχνικών πληροφοριών κατά τη διασύνδεση.

11) Συχνές ερωτήσεις

Δεν εκδίδεται voucher — τι να ελέγξω πρώτα;

Βεβαιωθείτε ότι πατήσατε Αποθήκευση Ρυθμίσεων πριν από το Δοκιμή Σύνδεσης.
Ελέγξτε ότι το βάρος της παραγγελίας δεν είναι 0.
Επιβεβαιώστε ότι τα API στοιχεία, δηλαδή Username / Password / AppKey, είναι σωστά.
Επιβεβαιώστε ότι τα στοιχεία παραλήπτη είναι σωστά, όπως διεύθυνση, ΤΚ και τηλέφωνο.

Πότε ενεργοποιώ το Production Mode;

Μόνο όταν περάσετε live στοιχεία.
Με test στοιχεία, το Production Mode πρέπει να είναι απενεργοποιημένο.

Πρέπει να κάνω Κλείσιμο Εκκρεμών Εργασιών κάθε μέρα;

Ναι, είναι ουσιαστικά το κλείσιμο ημέρας.
Αν εκδώσετε νέα vouchers μετά το κλείσιμο, κάντε ξανά Κλείσιμο Εκκρεμών Εργασιών – Σήμερα.

12) Διαστάσεις εκτύπωσης

Το plugin υποστηρίζει τα διαθέσιμα μεγέθη εκτύπωσης voucher που προσφέρει η Γενική Ταχυδρομική μέσω των Web Services.

Sticker 10×15 cm: ετικέτα 10×15 cm.
Sticker Big 10×19 cm: ετικέτα 10×19 cm.
A4: εκτύπωση σε A4.
A5: εκτύπωση σε A5.

Τα vouchers επιστρέφονται έτοιμα από τα Web Services της Γενικής Ταχυδρομικής. Επιλέξτε το μέγεθος που ταιριάζει στον τρόπο που εκτυπώνετε, όπως A4/A5 εκτυπωτής ή label/thermal printer.

13) Υποστήριξη

Για οποιοδήποτε πρόβλημα ή απορία σχετικά με τη ρύθμιση ή τη λειτουργία του plugin, μπορείτε να επικοινωνήσετε με την τεχνική υποστήριξη.

info@vgdevsolutions.gr