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