Πλήρης οδηγός εγκατάστασης & ρύθμισης του Γενική Ταχυδρομική Voucher για WooCommerce
Σε αυτόν τον οδηγό θα δείτε βήμα-βήμα πώς να εγκαταστήσετε και να ρυθμίσετε το Γενική Ταχυδρομική Voucher for WooCommerce, να περάσετε σωστά τα test/live Web Services της Γενικής Ταχυδρομικής, να ολοκληρώσετε το απαραίτητο δοκιμαστικό σενάριο (έκδοση / εκτύπωση / ακύρωση voucher + κλείσιμο εκκρεμών εργασιών) και να χρησιμοποιείτε καθημερινά το plugin μέσα από τις παραγγελίες του WooCommerce, με tracking & email ενημέρωσης.
Περιεχόμενα
1) Πριν ξεκινήσετε (Web Services από Γενική Ταχυδρομική)
Για να λειτουργήσει το plugin απαιτούνται τα Web Services της Γενικής Ταχυδρομικής. Συνήθως η courier στέλνει αρχικά test στοιχεία (δοκιμαστικό περιβάλλον) και, αφού ολοκληρωθεί επιτυχώς το test σενάριο, αποστέλλει τα live στοιχεία (παραγωγή).
Θα χρειαστείτε:
Username
Password
Application Key (API Key / AppKey)
2) Εγκατάσταση & ενεργοποίηση
Η εγκατάσταση γίνεται όπως σε κάθε WooCommerce πρόσθετο:
Συνδεθείτε στο WordPress με δικαιώματα διαχειριστή.
Πηγαίνετε Πρόσθετα → Προσθήκη νέου.
Πατήστε Μεταφόρτωση πρόσθετου.
Επιλέξτε το αρχείο .zip που κατεβάσατε από την αγορά.
Πατήστε Εγκατάσταση και στη συνέχεια Ενεργοποίηση.
3) Ρυθμίσεις σύνδεσης API (Web Services)
Ανοίξτε τη σελίδα ρυθμίσεων του plugin (π.χ. από το μενού VGDev Solutions → Γενική Ταχυδρομική).
Στοιχεία σύνδεσης API
Συμπληρώστε:
Username
Password
Application Key (API Key / AppKey)
Αποθήκευση & Έλεγχος σύνδεσης (σωστή σειρά)
Αφού συμπληρώσετε τα στοιχεία:
Πατήστε πρώτα Αποθήκευση Ρυθμίσεων για να καταχωρηθούν τα νέα δεδομένα.
Έπειτα, πατήστε Δοκιμή Σύνδεσης για να επιβεβαιώσετε ότι η επικοινωνία με τη Γενική Ταχυδρομική λειτουργεί σωστά.
Production Mode (Test / Live)
Στο plugin υπάρχει επιλογή Production Mode:
Test στοιχεία: αφήστε το Production Mode απενεργοποιημένο.
Live στοιχεία (παραγωγή): ενεργοποιήστε το Production Mode.
4) Γενικές ρυθμίσεις (βάρος, μέγεθος ετικέτας, status κ.λπ.)
Στην ενότητα Γενικές Ρυθμίσεις θα βρείτε επιλογές που επηρεάζουν την καθημερινή λειτουργία.
Προεπιλεγμένο βάρος (kg)
Το πεδίο Προεπιλεγμένο βάρος (kg) λειτουργεί ως “fallback” όταν δεν μπορεί να υπολογιστεί βάρος.
Αν αφήσετε το πεδίο κενό, το plugin τραβάει τα βάρη από τα προϊόντα του WooCommerce και υπολογίζει το συνολικό βάρος της παραγγελίας.
Αν υπάρχουν προϊόντα χωρίς βάρος, ορίστε μια ασφαλή τιμή (π.χ. 0.5kg ή 1kg) ώστε να μην μπλοκάρει η έκδοση voucher.
Σημαντικό: Η έκδοση voucher δεν μπορεί να ολοκληρωθεί για παραγγελία με μηδενικό βάρος (0).
Tip: Ιδανικά, συμπληρώστε βάρος σε όλα τα προϊόντα.
Μέγεθος ετικέτας
Από το πεδίο Μέγεθος Ετικέτας επιλέγετε την προεπιλογή εκτύπωσης του voucher. Οι διαθέσιμες επιλογές είναι:
Sticker (10×15 cm)
Sticker Big (10×19 cm)
A4
A5
Μετατροπή σε κεφαλαία
Αν θέλετε τα στοιχεία παραλήπτη (διεύθυνση κ.λπ.) να περνάνε σε κεφαλαία (χωρίς τόνους), ενεργοποιήστε την επιλογή.
Αλλαγή κατάστασης παραγγελίας
Αν το επιθυμείτε, μπορείτε να ορίσετε αυτόματη αλλαγή status όταν δημιουργείται voucher (ή να το αφήσετε χωρίς αλλαγή).
5) Δοκιμαστική λειτουργία (test σενάριο Γενική Ταχυδρομική)
Η Γενική Ταχυδρομική συνήθως ζητά επιβεβαίωση ότι λειτουργούν σωστά:
έκδοση voucher
εκτύπωση voucher
ακύρωση voucher
κλείσιμο εκκρεμών εργασιών (τέλος ημέρας)
Οδηγίες συμπλήρωσης των test Web Services
Τα test στοιχεία που θα λάβετε συνήθως έχουν μορφή όπως:
username: testapi
password: 123456@
appkey: 1C2CC345-E67B-891C-B234-B56E78BDC912
Τα συμπληρώνετε στα πεδία Username / Password / Application Key (API Key).
Βήμα-βήμα δοκιμή
Περάστε τα test στοιχεία στις ρυθμίσεις και πατήστε Αποθήκευση Ρυθμίσεων.
Βεβαιωθείτε ότι το Production Mode είναι απενεργοποιημένο (test).
Δημιουργήστε μία δοκιμαστική παραγγελία ή ανοίξτε μία υπάρχουσα Σε επεξεργασία.
Στη δεξιά στήλη της παραγγελίας, στο πλαίσιο του voucher, πατήστε Δημιουργία voucher.
Πατήστε Εκτύπωση και αποθηκεύστε το PDF του δοκιμαστικού voucher.
Κάντε το Κλείσιμο Εκκρεμών Εργασιών – Σήμερα (δείτε την ενότητα 6).
Επιστρέψτε στην παραγγελία και πατήστε Ακύρωση για το voucher.
Στείλτε email στη Γενική Ταχυδρομική ότι ολοκληρώθηκε το test, επισυνάπτοντας το PDF (και ό,τι άλλο σας ζητήσουν).
Όταν σας στείλουν τα live στοιχεία:
αντικαταστήστε τα στις ρυθμίσεις,
ενεργοποιήστε το Production Mode,
πατήστε Αποθήκευση Ρυθμίσεων.
Προσοχή: Μην μείνετε κατά λάθος σε test στοιχεία, γιατί θα συνεχίζετε να εκδίδετε δοκιμαστικά vouchers.
6) Κλείσιμο Εκκρεμών Εργασιών (τέλος ημέρας)
Το Κλείσιμο Εκκρεμών Εργασιών είναι η διαδικασία “κλεισίματος ημέρας” ώστε να ενημερωθεί το σύστημα της Γενικής Ταχυδρομικής για τα vouchers που εκδόθηκαν και είναι προς αποστολή.
Πώς γίνεται (μέσα από το plugin)
Πηγαίνετε στις ρυθμίσεις του plugin (VGDev Solutions → Γενική Ταχυδρομική).
Στο επάνω μέρος (header) της σελίδας πατήστε «Προβολή Vouchers».
Θα ανοίξει η λίστα Geniki Taxydromiki Vouchers (με ενεργά & ακυρωμένα vouchers).
Εκεί πατήστε «Κλείσιμο Εκκρεμών Εργασιών – Σήμερα».
Πότε το κάνετε
Στο τέλος της ημέρας, αφού ολοκληρώσετε την έκδοση όλων των vouchers που θα φύγουν.
Αν εκδώσετε νέο voucher μετά το κλείσιμο, θα χρειαστεί να κάνετε ξανά κλείσιμο ώστε να συμπεριληφθεί και αυτό.
7) Έκδοση voucher μέσα από την παραγγελία (καθημερινή χρήση)
Μετά τη ρύθμιση, η βασική διαχείριση γίνεται μέσα από την ίδια την παραγγελία:
Πηγαίνετε WooCommerce → Παραγγελίες
Ανοίγετε την παραγγελία
Στο box του voucher πατάτε Δημιουργία voucher
Μετά την έκδοση, συνήθως έχετε επιλογές όπως:
Εκτύπωση (PDF voucher)
Ακύρωση voucher
Tracking / κατάσταση αποστολής
Χρήσιμες πληροφορίες (πεδία voucher)
Στην καρτέλα voucher μπορεί να δείτε πεδία όπως:
Δέματα (προεπιλογή 1)
Βάρος (αν δεν υπολογίζεται αυτόματα, μπορείτε να το ορίσετε)
Αντικαταβολή (αν η πληρωμή είναι αντικαταβολή)
Υπηρεσίες (π.χ. παράδοση Σάββατο – όπου υποστηρίζεται)
Σχόλια
Σημαντικό για ακύρωση: Πριν προχωρήσετε σε ακύρωση voucher, ακολουθήστε τη διαδικασία που προβλέπει η Γενική Ταχυδρομική (συχνά απαιτείται επικοινωνία).
8) Προβολή Vouchers (λίστα, PDF, tracking)
Από το κουμπί «Προβολή Vouchers» (στο header των ρυθμίσεων) έχετε πρόσβαση σε συγκεντρωτική λίστα με:
Ενεργά και Ακυρωμένα vouchers
Συσχέτιση με παραγγελία
Ημερομηνία
Κουμπί Εκτύπωση (PDF)
Κουμπί Tracking (όπου υποστηρίζεται)
Η λίστα είναι χρήσιμη για γρήγορη αναζήτηση/επιβεβαίωση και για να κάνετε το Κλείσιμο Εκκρεμών Εργασιών – Σήμερα.
9) Email Tracking & Προεπισκόπηση
Στην ενότητα Ρυθμίσεις Email & Tracking μπορείτε να ενεργοποιήσετε:
Αποστολή tracking email στον πελάτη κατά την ολοκλήρωση της παραγγελίας
Επιλογή χρώματος για το email tracking (κουμπί/border)
Προεπισκόπηση για να δείτε πώς θα φαίνεται το email πριν το ενεργοποιήσετε
10) Debug Mode (logs)
Υπάρχει επιλογή Debug Mode ώστε να καταγράφονται requests/responses σε log αρχείο για troubleshooting.
Χρησιμοποιήστε το όταν:
αποτυγχάνει η δημιουργία voucher
υπάρχει πρόβλημα εκτύπωσης/λήψης PDF
χρειάζεται να σταλεί τεχνική πληροφορία στην υποστήριξη
Προσοχή: Μην αφήνετε το Debug Mode ενεργό χωρίς λόγο.
11) Συχνές ερωτήσεις (FAQ)
Δεν εκδίδεται 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 για sticker).
13) Υποστήριξη
Για οποιοδήποτε πρόβλημα ή απορία σχετικά με τη ρύθμιση/λειτουργία του plugin, μπορείτε να επικοινωνήσετε με την τεχνική υποστήριξη στο info@vgdevsolutions.gr