Πλήρης οδηγός εγκατάστασης & ρύθμισης του Speedex Voucher για WooCommerce
Σε αυτόν τον οδηγό θα δείτε βήμα-βήμα πώς να εγκαταστήσετε και να ρυθμίσετε το Speedex Voucher for WooCommerce, να περάσετε σωστά τα test/live Web Services της Speedex, να ολοκληρώσετε το απαραίτητο δοκιμαστικό σενάριο (έκδοση/εκτύπωση/ακύρωση voucher) και να χρησιμοποιείτε καθημερινά το plugin μέσα από τις παραγγελίες του WooCommerce, με tracking & email ενημέρωσης.
Περιεχόμενα
1) Πριν ξεκινήσετε (Web Services από Speedex)
Για να λειτουργήσει το plugin απαιτούνται τα Web Services της Speedex. Συνήθως η Speedex παρέχει αρχικά test στοιχεία (δοκιμαστικό περιβάλλον) και, αφού ολοκληρωθεί επιτυχώς η δοκιμή, σας δίνει τα live στοιχεία (παραγωγή).
Θα χρειαστείτε:
Όνομα χρήστη (Username)
Κωδικός (Password)
Αναγνωριστικό πελάτη (Customer ID)
Κωδικός Συμφωνίας (Agreement ID)
Σημείωση: Ενδέχεται να έχετε πάνω από μία συμφωνία. Σε αυτή την περίπτωση χρησιμοποιείτε το αντίστοιχο Customer ID / Agreement ID που σας έχει δώσει η Speedex.
2) Εγκατάσταση & ενεργοποίηση
Η εγκατάσταση γίνεται όπως σε κάθε WooCommerce πρόσθετο:
Συνδεθείτε στο WordPress με δικαιώματα διαχειριστή.
Πηγαίνετε Πρόσθετα → Προσθήκη νέου.
Πατήστε Μεταφόρτωση πρόσθετου.
Επιλέξτε το αρχείο .zip που κατεβάσατε από την αγορά.
Πατήστε Εγκατάσταση και στη συνέχεια Ενεργοποίηση.
3) Ρυθμίσεις σύνδεσης API (Web Services)
Ανοίξτε τη σελίδα ρυθμίσεων του plugin (π.χ. από το μενού VGDev Solutions → Speedex Courier).
Στην ενότητα Στοιχεία σύνδεσης API συμπληρώστε:
Username (Όνομα χρήστη)
Password (Κωδικός)
Agreement ID (Κωδικός Συμφωνίας)
Customer ID (Αναγνωριστικό πελάτη)
Αποθήκευση & Έλεγχος σύνδεσης (σωστή σειρά)
Αφού συμπληρώσετε τα στοιχεία:
Πατήστε πρώτα Αποθήκευση ρυθμίσεων ώστε να καταχωρηθούν τα νέα δεδομένα.
Έπειτα, πατήστε Δοκιμή Σύνδεσης (Έλεγχος Σύνδεσης) για επιβεβαίωση ότι η επικοινωνία με τη Speedex λειτουργεί σωστά.
Test Mode
Αν τα στοιχεία που λάβατε είναι για δοκιμή, ενεργοποιήστε την επιλογή:
Test Mode / Χρήση δοκιμαστικού περιβάλλοντος (Development API)
Αν τα στοιχεία είναι live (παραγωγή), αφήστε το Test Mode απενεργοποιημένο.
4) Γενικές ρυθμίσεις (βάρος, εκτύπωση, αυτοματισμοί, status κ.λπ.)
Στην ενότητα Γενικές Ρυθμίσεις θα βρείτε επιλογές που επηρεάζουν την καθημερινή λειτουργία.
Προεπιλεγμένο βάρος (kg)
Το πεδίο Προεπιλεγμένο βάρος (kg) λειτουργεί ως “fallback” όταν δεν μπορεί να υπολογιστεί βάρος.
Αν αφήσετε το πεδίο κενό, το plugin θα τραβάει αυτόματα τα βάρη από τα προϊόντα (όπως τα έχετε ορίσει στο WooCommerce) και θα υπολογίζει το συνολικό βάρος της παραγγελίας βάσει αυτών.
Αν υπάρχουν προϊόντα χωρίς βάρος, τότε είναι χρήσιμο να ορίσετε μια ασφαλή τιμή (π.χ. 0.5kg) ώστε να αποφευχθούν προβλήματα κατά την έκδοση voucher.
Σημαντικό: Η έκδοση voucher δεν μπορεί να ολοκληρωθεί για παραγγελία μηδενικού βάρους.
Tip: Ιδανικά, συμπληρώστε βάρος σε όλα τα προϊόντα για ακριβή υπολογισμό.
Μέγεθος εκτύπωσης
Από το πεδίο Μέγεθος Εκτύπωσης επιλέγετε την προεπιλογή εκτύπωσης του voucher. Ανάλογα με τις επιλογές που υποστηρίζει το plugin/Speedex, μπορεί να δείτε επιλογές όπως:
A4
A5
A6
10×21 cm
Μετατροπή σε κεφαλαία
Αν θέλετε τα στοιχεία παραλήπτη (διεύθυνση κ.λπ.) να περνάνε σε κεφαλαία (χωρίς τόνους), ενεργοποιήστε την επιλογή.
Αλλαγή κατάστασης παραγγελίας
Αν το επιθυμείτε, μπορείτε να ορίσετε αυτόματη αλλαγή status όταν δημιουργείται voucher (ή να το αφήσετε χωρίς αλλαγή).
5) Δοκιμαστική λειτουργία (test σενάριο Speedex)
Η Speedex συνήθως ζητά επιβεβαίωση ότι λειτουργούν σωστά:
έκδοση voucher
εκτύπωση voucher
ακύρωση voucher
Οδηγίες συμπλήρωσης των test Web Services
Παράδειγμα μορφής δοκιμαστικών στοιχείων:
Credentials:
Username: demoapi
Password: GOOD-GO-HOME-GUYS
Συμφωνίες (CustomerId–AgreementId):
DEMO–001
DEMO–002
DEMO–003
DEMO–004
Συμπληρώνετε τα Username / Password στα πεδία Όνομα χρήστη / Κωδικός.
Έπειτα επιλέγετε ένα Customer ID (π.χ. DEMO) και ένα Agreement ID (π.χ. 001) και τα συμπληρώνετε στα αντίστοιχα πεδία Αναγνωριστικό πελάτη / Κωδικός Συμφωνίας.
Τέλος, ενεργοποιείτε το Test Mode.
Βήμα-βήμα δοκιμή
Περνάτε στα Settings τα δοκιμαστικά Web Services και πατάτε Αποθήκευση ρυθμίσεων.
Ενεργοποιείτε το Test Mode και πατάτε ξανά Αποθήκευση ρυθμίσεων (αν χρειάζεται).
Δημιουργείτε μία δοκιμαστική παραγγελία ή ανοίγετε μία υπάρχουσα παραγγελία Σε επεξεργασία.
Στη δεξιά στήλη της παραγγελίας, στο πλαίσιο Speedex Courier Voucher, πατάτε Δημιουργία voucher.
Μόλις ολοκληρωθεί επιτυχώς, εμφανίζεται ο αριθμός voucher και ενεργοποιούνται τα κουμπιά:
Εκτύπωση
Tracking
Ακύρωση
Πατάτε Εκτύπωση και αποθηκεύετε το PDF του voucher.
Για να ολοκληρωθεί το δοκιμαστικό σενάριο, πατάτε Ακύρωση.
Ενημερώνετε τη Speedex ότι ολοκληρώθηκε το test και επισυνάπτετε το PDF του δοκιμαστικού voucher.
Περιμένετε να σας στείλουν τα live Web Services και τα αντικαθιστάτε στις ρυθμίσεις.
Απενεργοποιείτε το Test Mode και πατάτε Αποθήκευση ρυθμίσεων.
Προσοχή: Μην ξεχάσετε να απενεργοποιήσετε το test περιβάλλον όταν περάσετε live στοιχεία.
6) Έκδοση voucher μέσα από την παραγγελία (καθημερινή χρήση)
Μετά τη ρύθμιση, η διαχείριση γίνεται μέσα από την ίδια την παραγγελία:
Πηγαίνετε WooCommerce → Παραγγελίες
Ανοίγετε την παραγγελία
Στο box Speedex Courier Voucher πατάτε Δημιουργία voucher
Μετά την έκδοση, μπορείτε να χρησιμοποιήσετε:
Εκτύπωση: κατεβάζετε PDF voucher
Tracking: βλέπετε τον εντοπισμό αποστολής
Ακύρωση: ακυρώνετε voucher όταν χρειάζεται
Χρήσιμες πληροφορίες (πεδία voucher)
Στην καρτέλα voucher ενδέχεται να δείτε πεδία όπως:
Δέματα: αριθμός δεμάτων (προεπιλογή 1)
Βάρος: αν δεν μπορεί να υπολογιστεί αυτόματα, το ορίζετε χειροκίνητα
Ημερομηνία παραλαβής: ημερομηνία παράδοσης στον courier
Αντικαταβολή: εμφανίζεται όταν η πληρωμή είναι αντικαταβολή (και μπορεί να τροποποιηθεί)
Παράδοση Σάββατο: για να αναγράφεται πάνω στο voucher
Σχόλια: συνοδευτικά σχόλια αποστολής
Σημαντικό για ακύρωση
Στο τέλος της στήλης υπάρχει επιλογή Ακύρωσης του voucher. Ωστόσο, πριν προβείτε σε ακύρωση, συνιστάται/απαιτείται να υπάρχει επικοινωνία με τη Speedex (όπως προβλέπει η διαδικασία τους).
7) Email Tracking & Προεπισκόπηση
Στην ενότητα Ρυθμίσεις Email & Tracking μπορείτε να ενεργοποιήσετε:
Αποστολή Tracking Email στον πελάτη κατά την ολοκλήρωση της παραγγελίας
Επιλογή χρώματος για το email tracking
Προεπισκόπηση ώστε να δείτε πώς θα φαίνεται το email πριν το ενεργοποιήσετε
8) Debug Mode (logs)
Υπάρχει επιλογή Debug Mode ώστε να καταγράφονται requests/responses σε log αρχείο για troubleshooting.
Χρησιμοποιήστε το όταν:
αποτυγχάνει η δημιουργία voucher
υπάρχει πρόβλημα εκτύπωσης/λήψης PDF
χρειάζεται να σταλεί τεχνική πληροφορία στην υποστήριξη
Προσοχή: Μην αφήνετε το Debug Mode ενεργό χωρίς λόγο.
9) Συχνές ερωτήσεις (FAQ)
Δεν εκδίδεται voucher – τι να ελέγξω πρώτα;
Βεβαιωθείτε ότι έχετε πατήσει Αποθήκευση ρυθμίσεων πριν το Δοκιμή Σύνδεσης.
Ελέγξτε ότι το βάρος της παραγγελίας δεν είναι 0.
Επιβεβαιώστε ότι τα Customer ID / Agreement ID είναι σωστά.
Πότε ενεργοποιώ το Test Mode;
Μόνο όταν χρησιμοποιείτε test στοιχεία. Με live στοιχεία, το Test Mode πρέπει να είναι απενεργοποιημένο.
Δεν έχω βάρος στα προϊόντα μου – τι κάνω;
Συμπληρώστε βάρη στα προϊόντα ή ορίστε ένα Προεπιλεγμένο βάρος (π.χ. 0.5kg) ώστε να μη μπλοκάρει η έκδοση voucher.
10) Διαστάσεις εκτύπωσης
Το plugin υποστηρίζει τα διαθέσιμα μεγέθη εκτύπωσης voucher που προσφέρει η Speedex μέσω των Web Services. Από τη ρύθμιση «Μέγεθος Ετικέτας» μπορείτε να επιλέξετε:
A4: εκτύπωση σε μέγεθος A4
A5: εκτύπωση σε μέγεθος A5
10×21 cm: εκτύπωση σε διαστάσεις 10×21 cm
A6: εκτύπωση σε μέγεθος A6
Σημείωση: Τα voucher έρχονται σε έτοιμες διαστάσεις όπως επιστρέφονται από τα Web Services της Speedex. Επιλέξτε το μέγεθος που ταιριάζει στον τρόπο που εκτυπώνετε (εκτυπωτής A4 ή label/thermal, κ.λπ.).
11) Υποστήριξη
Για οποιοδήποτε πρόβλημα ή απορία σχετικά με τη ρύθμιση/λειτουργία του plugin, μπορείτε να επικοινωνήσετε με την τεχνική υποστήριξη στο info@vgdevsolutions.gr