Πλήρης οδηγός εγκατάστασης & ρύθμισης του ACS Voucher για WooCommerce
Σε αυτόν τον οδηγό θα δείτε βήμα-βήμα πώς να εγκαταστήσετε και να ρυθμίσετε το ACS Voucher for WooCommerce, να περάσετε σωστά τα test/live Web Services της ACS, να ολοκληρώσετε το απαραίτητο δοκιμαστικό σενάριο (έκδοση/εκτύπωση/ακύρωση voucher και λίστα συλλογής) και να χρησιμοποιείτε καθημερινά το plugin μέσα από τις παραγγελίες του WooCommerce, με tracking & email ενημέρωσης.
Περιεχόμενα
1) Πριν ξεκινήσετε (Web Services από ACS)
Για να λειτουργήσει το plugin απαιτούνται τα Web Services της ACS. Συνήθως η ACS στέλνει αρχικά test credentials και, αφού ολοκληρωθεί επιτυχώς η δοκιμαστική διαδικασία, αποστέλλει τα live credentials.
Θα χρειαστείτε:
Company ID
Company Password
User ID
User Password
Billing Code
API Key
2) Εγκατάσταση & ενεργοποίηση
Η εγκατάσταση γίνεται όπως σε κάθε WooCommerce πρόσθετο:
Συνδεθείτε στο WordPress με δικαιώματα διαχειριστή.
Πηγαίνετε Πρόσθετα → Προσθήκη νέου.
Πατήστε Μεταφόρτωση πρόσθετου.
Επιλέξτε το αρχείο .zip που κατεβάσατε από την αγορά.
Πατήστε Εγκατάσταση και στη συνέχεια Ενεργοποίηση.
3) Ρυθμίσεις σύνδεσης API (Web Services)
Ανοίξτε τη σελίδα ρυθμίσεων του plugin (π.χ. από το μενού VGDev Solutions → ACS Courier Voucher).
Στην ενότητα Στοιχεία σύνδεσης API συμπληρώστε:
Αποστολέας: το όνομα που θέλετε να εμφανίζεται πάνω στο voucher
Company ID / Company Password
User ID / User Password
Billing Code
API Key
Αποθήκευση & Έλεγχος σύνδεσης (σωστή σειρά)
Αφού συμπληρώσετε τα στοιχεία:
Πατήστε πρώτα Αποθήκευση ρυθμίσεων ώστε να καταχωρηθούν τα νέα δεδομένα.
Έπειτα, πατήστε Έλεγχος Σύνδεσης για να επιβεβαιώσετε ότι η επικοινωνία με την ACS λειτουργεί σωστά.
4) Γενικές ρυθμίσεις (βάρος, εκτύπωση, status κ.λπ.)
Στην ενότητα Γενικές Ρυθμίσεις θα βρείτε επιλογές που επηρεάζουν την καθημερινή λειτουργία.
Προεπιλεγμένο βάρος (kg)
Το πεδίο Προεπιλεγμένο βάρος (kg) λειτουργεί ως “fallback” όταν προϊόντα δεν έχουν ορισμένο βάρος.
Αν αφήσετε το πεδίο κενό, το plugin θα τραβάει αυτόματα τα βάρη από τα προϊόντα (όπως τα έχετε ορίσει στο WooCommerce) και θα υπολογίζει το συνολικό βάρος της παραγγελίας βάσει αυτών.
Αν υπάρχουν προϊόντα χωρίς βάρος, τότε είναι χρήσιμο να ορίσετε μια ασφαλή τιμή (π.χ. 0.5kg) ώστε να αποφευχθούν προβλήματα κατά την έκδοση voucher.
Tip: Ιδανικά, συμπληρώστε βάρος σε όλα τα προϊόντα για ακριβή υπολογισμό.
Μέγεθος εκτύπωσης
Από το πεδίο «Μέγεθος Εκτύπωσης» επιλέγετε την προεπιλογή εκτύπωσης του voucher, ανάλογα με τον τρόπο που τυπώνετε τις αποστολές σας:
Flyer (A5): εκτύπωση σε μορφή φυλλαδίου (A5)
Sticker (10×10): εκτύπωση σε μορφή αυτοκόλλητου 10×10 cm
Μετατροπή σε κεφαλαία
Αν θέλετε τα στοιχεία παραλήπτη (διεύθυνση κ.λπ.) να περνάνε σε κεφαλαία (χωρίς τόνους), ενεργοποιήστε την επιλογή.
Αλλαγή κατάστασης παραγγελίας
Αν το επιθυμείτε, μπορείτε να ορίσετε αυτόματη αλλαγή κατάστασης όταν δημιουργείται voucher (ή να το αφήσετε χωρίς αλλαγή).
5) Δοκιμαστική λειτουργία (test σενάριο ACS)
Η ACS συνήθως ζητά επιβεβαίωση ότι λειτουργούν σωστά:
έκδοση voucher
εκτύπωση voucher
ακύρωση voucher
έκδοση λίστας συλλογής
Βήμα-βήμα δοκιμή
Περνάτε στις ρυθμίσεις του plugin τα test Web Services που σας έστειλε η ACS και πατάτε Αποθήκευση.
Δημιουργείτε μία δοκιμαστική παραγγελία ή ανοίγετε μία υπάρχουσα παραγγελία.
Στη δεξιά στήλη της παραγγελίας, στο πλαίσιο ACS Courier Voucher, πατάτε Δημιουργία voucher.
Μόλις ολοκληρωθεί επιτυχώς, εμφανίζεται ο αριθμός voucher και ενεργοποιούνται τα κουμπιά:
Εκτύπωση
Tracking
Ακύρωση
Πατάτε Εκτύπωση και αποθηκεύετε το PDF του voucher.
Από τις ρυθμίσεις του plugin εκδίδετε Λίστα Συλλογής και αποθηκεύετε και αυτό το PDF.
Επιστρέφετε στην παραγγελία και πατάτε Ακύρωση voucher.
Στέλνετε email στην ACS ότι ολοκληρώθηκε το test και επισυνάπτετε τα 2 PDF (voucher + λίστα συλλογής).
Περιμένετε να σας αποστείλουν τα live Web Services και τα αντικαθιστάτε στις ρυθμίσεις.
Προσοχή: Μην ξεχάσετε να αντικαταστήσετε τα test credentials με live, αλλιώς θα εκδίδετε δοκιμαστικά vouchers.
6) Έκδοση voucher μέσα από την παραγγελία (καθημερινή χρήση)
Μετά τη ρύθμιση, η διαχείριση γίνεται μέσα από την ίδια την παραγγελία:
Πηγαίνετε WooCommerce → Παραγγελίες
Ανοίγετε την παραγγελία
Στο box ACS Courier Voucher πατάτε Δημιουργία voucher
Μετά την έκδοση, μπορείτε να χρησιμοποιήσετε:
Εκτύπωση: κατεβάζετε PDF voucher
Tracking: βλέπετε τον εντοπισμό αποστολής
Ακύρωση: ακυρώνετε voucher όταν χρειάζεται
7) Λίστα Συλλογής – κανόνες & εκτύπωση
Η Λίστα Συλλογής είναι το έγγραφο που δίνετε στον courier και περιλαμβάνει τα vouchers που θα παραδοθούν.
Πώς εκδίδεται
Από τις ρυθμίσεις του plugin, στην ενότητα Εκτύπωση Λίστας Συλλογής:
Πατάτε Έκδοση λίστας συλλογής για τη σημερινή ημέρα.
Παλαιότερες λίστες συλλογής
Μπορείτε να εκτυπώσετε λίστες προηγούμενων ημερών:
Επιλέγετε ημερομηνία
Πατάτε Αναζήτηση
Επιλέγετε τη λίστα που χρειάζεστε από τα αποτελέσματα
Σημείωση: Οι παλαιότερες λίστες συλλογής πρέπει να έχουν ήδη δημιουργηθεί τις προηγούμενες ημέρες για να μπορούν να εκτυπωθούν.
Κανόνες που πρέπει να γνωρίζετε
Η λίστα συλλογής αφορά τα vouchers της ημέρας.
Αν εκδώσετε λίστα και μετά εκτυπώσετε νέα vouchers, μπορείτε να εκδώσετε δεύτερη λίστα την ίδια ημέρα.
Δεν προτείνεται να “μεταφέρετε” vouchers σε επόμενη ημέρα για να μπουν σε άλλη λίστα.
8) Email Tracking & Προεπισκόπηση
Στην ενότητα Ρυθμίσεις Email & Tracking μπορείτε να ενεργοποιήσετε:
Αποστολή Tracking Email στον πελάτη κατά την ολοκλήρωση της παραγγελίας
Επιλογή χρώματος για το email tracking
Προεπισκόπηση ώστε να δείτε πώς θα φαίνεται το email πριν το ενεργοποιήσετε
9) Debug Mode (logs)
Υπάρχει επιλογή Debug Mode ώστε να καταγράφονται requests/responses σε log αρχείο για troubleshooting.
Χρησιμοποιήστε το όταν:
αποτυγχάνει η δημιουργία voucher
υπάρχει πρόβλημα εκτύπωσης/λήψης PDF
χρειάζεται να σταλεί τεχνική πληροφορία στην υποστήριξη
Προσοχή: Μην αφήνετε το Debug Mode ενεργό χωρίς λόγο.
10) Συχνές ερωτήσεις (FAQ)
Πώς λειτουργεί η λίστα συλλογής;
Τη λίστα συλλογής τη δίνετε στον courier και περιλαμβάνει τα voucher των αποστολών που παραδίδετε.
Πότε μπορώ να δημιουργώ λίστα συλλογής;
Η λίστα συλλογής πρέπει να εκδίδεται μέσα στην ίδια ημέρα και αφορά τα vouchers της ημέρας.
Πόσες λίστες συλλογής μπορώ να εκτυπώσω;
Μπορείτε να εκδώσετε και δεύτερη λίστα την ίδια ημέρα, αν προκύψουν νέα vouchers.
Πώς μπορώ να εκτυπώσω παρελθοντικές λίστες συλλογής;
Από τις ρυθμίσεις του plugin επιλέγετε ημερομηνία, πατάτε Αναζήτηση και επιλέγετε τη λίστα που θέλετε, εφόσον είχε δημιουργηθεί τότε.
11) Διαστάσεις εκτύπωσης
Το plugin υποστηρίζει τα μεγέθη εκτύπωσης που προσφέρει η ACS Courier μέσω των Web Services. Από τη ρύθμιση «Μέγεθος Εκτύπωσης» μπορείτε να επιλέξετε:
Flyer (A5): εκτύπωση σε μορφή “φυλλαδίου” μεγέθους A5
Sticker (10×10): εκτύπωση σε μορφή αυτοκόλλητου 10×10 cm
Σημείωση: Για αλλαγή των επίσημων στοιχείων αποστολέα στο voucher απαιτείται επικοινωνία με την ACS. Από το plugin μπορείτε να αλλάξετε μόνο το εμφανιζόμενο όνομα αποστολέα.
12) Υποστήριξη
Για οποιοδήποτε πρόβλημα ή απορία σχετικά με τη ρύθμιση/λειτουργία του plugin, μπορείτε να επικοινωνήσετε με την τεχνική υποστήριξη στο info@vgdevsolutions.gr