Οδηγοί
Οδηγός εγκατάστασης Courier Center Voucher για WooCommerce
Ρύθμιση Courier Center voucher, order action, αντικαταβολή και tracking μέσα από WooCommerce.
Οδηγός εγκατάστασης και ρύθμισης Courier Center Voucher για WooCommerce
Ο οδηγός αφορά το plugin OBS Courier Center. Η OBS Technologies κάνει δωρεάν την εγκατάσταση και την πρώτη δοκιμή.
1. Προαπαιτούμενα (από την Courier Center)
- API Username, API Password και API Unique Key για το web service. Ζητήστε ρητά στοιχεία API, όχι τα στοιχεία του web portal.
- Account Number: ο κωδικός λογαριασμού αποστολέα (requestor). Αν έχετε δεύτερη αποθήκη ή υπο-λογαριασμό, και τον δεύτερο κωδικό.
- Σειρά αριθμών voucher που έχει αποδοθεί στον λογαριασμό σας.
- WordPress και WooCommerce σε ενημερωμένη έκδοση, με PHP cURL. Βάρη (kg) στα προϊόντα.
2. Εγκατάσταση και License key
- Κατεβάστε το ZIP από τον λογαριασμό σας στην OBS Technologies.
- WordPress → Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου → Εγκατάσταση → Ενεργοποίηση.
- Ανοίξτε WooCommerce → OBS Courier Center.
- Στο πλαίσιο «Activate Courier Center for Update» επικολλήστε το License key στο «Enter Validation Key» και πατήστε «Activate». Το key αφορά τις ενημερώσεις ενός καταστήματος. Δείτε την ενεργοποίηση άδειας.
3. Χάρτης ρυθμίσεων (OBS Courier Center Settings)
| Πεδίο | Τι κάνει |
|---|---|
| API Username | Όνομα χρήστη API της Courier Center. |
| API Password | Κωδικός API. |
| API Unique Key | Μοναδικό κλειδί API. |
| Account Number | Κωδικός λογαριασμού αποστολέα. Υποχρεωτικός όταν το Test Mode είναι κλειστό. |
| Secondary Account Number | Προαιρετικός. Αν συμπληρωθεί, στο παράθυρο έκδοσης εμφανίζεται «Choose Account» (Primary/Secondary). |
| Enable Test Mode — Enable Test/Sandbox Mode | Ενεργό εξ ορισμού. Κλείστε το για κανονική λειτουργία. Στο test mode χρησιμοποιείται δοκιμαστικός κωδικός λογαριασμού. |
| Production API Endpoint | Διεύθυνση υπηρεσίας παραγωγής (προεπιλογή: η πλατφόρμα της Courier Center). Αλλάζει μόνο αν σας το ζητήσει η Courier Center. |
| Sandbox API Endpoint | Διεύθυνση δοκιμαστικής υπηρεσίας. |
| PDF Voucher Template | Single Color / Single Black & White (1 voucher ανά σελίδα), Multiple Color / Multiple Black & White (έως 3 ανά σελίδα). |
| Select in which shipping methods voucher creation will be available | Τρόποι αποστολής στους οποίους εμφανίζεται το κουμπί. Στους υπόλοιπους εμφανίζεται «Not available». |
| Shipping Notifications — Notify customer on shipment created | Η σημείωση έκδοσης και ακύρωσης στέλνεται στον πελάτη. |
| Include Tracking Info | Προσθέτει το «Email Text» στα emails της παραγγελίας. |
| Email Text | Κείμενο με {{voucher_no}} και {{tracking_url}}. |
4. Καθημερινή χρήση
- Ένα voucher: «Create Voucher» στη στήλη ή στο πλαίσιο της παραγγελίας → έλεγχος Comments, Weight, Cash on Delivery amount, Number of Items (και Choose Account) → δημιουργία → «Download Voucher».
- Μαζικά: επιλογή παραγγελιών → «Δημιούργησε/Εκτύπωσε Courier Center voucher».
- Ακύρωση: «Delete» → επιβεβαίωση → «Voucher cancelled successfully.»
- Λίστα ημέρας: γραμμή διαχείρισης → «Courier Center Daily Manifest».
5. Δοκιμή
- Με ενεργό το Enable Test Mode, εκδώστε voucher σε δοκιμαστική παραγγελία με πλήρη στοιχεία.
- Ελέγξτε το PDF στο πρότυπο που επιλέξατε.
- Απενεργοποιήστε το Test Mode, βάλτε το Account Number και εκδώστε ένα πραγματικό voucher. Ακυρώστε το με «Delete» αν δεν αφορά πραγματική αποστολή.
- Ελέγξτε το email του πελάτη και ότι το link tracking ανοίγει.
6. Go-live checklist
- Test Mode κλειστό, σωστό Account Number.
- Τα στοιχεία API είναι του λογαριασμού παραγωγής.
- Έχει επιλεγεί πρότυπο PDF που ταιριάζει στον εκτυπωτή σας.
- Έχουν επιλεγεί οι σωστοί τρόποι αποστολής.
- Η λίστα ημέρας εκδίδεται κανονικά.
7. Αντιμετώπιση προβλημάτων
| Σύμπτωμα | Αιτία | Λύση |
|---|---|---|
| «User credentials does not match with requestor» ή «Invalid Shipper billing account» | Τα στοιχεία API δεν αντιστοιχούν στον κωδικό λογαριασμού, ή χρησιμοποιούνται στοιχεία του web portal ή δοκιμαστικά στοιχεία | Ζητήστε από την Courier Center τα στοιχεία API (Username, Password, Unique Key) και το Account Number του ίδιου λογαριασμού. Κλείστε το Test Mode στην παραγωγή. |
| «No AWBs available» | Δεν έχει αποδοθεί ή εξαντλήθηκε η σειρά αριθμών voucher του λογαριασμού | Ζητήστε από την Courier Center νέα σειρά αριθμών. |
| Το voucher δεν τυπώνεται: λευκή σελίδα, μήνυμα σφάλματος ή κείμενο αντί για PDF | Παλαιά έκδοση του plugin ή αλλαγή στη μορφή PDF της Courier Center | Ενημερώστε στην τελευταία έκδοση. Αν συνεχίζεται, στείλτε μας το μήνυμα σφάλματος. |
| Σφάλμα στην εκτύπωση «έως 3 ανά σελίδα» | Αποτυχία συνένωσης PDF | Επιλέξτε πρότυπο «Single» (1 ανά σελίδα) και επικοινωνήστε μαζί μας. |
| Σταμάτησαν όλα τα vouchers μετά από ανακοίνωση της Courier Center για νέα διεύθυνση API | Άλλαξε το endpoint της υπηρεσίας | Ενημερώστε το «Production API Endpoint» με τη νέα διεύθυνση ή επικοινωνήστε μαζί μας. |
| Δοκιμαστικές αποστολές εμφανίζονται στη λίστα ή δεν βγαίνουν πραγματικά vouchers | Το Test Mode είναι ακόμα ενεργό | Απενεργοποιήστε το «Enable Test Mode» και συμπληρώστε το Account Number. |
| Το link tracking στο email δεν ανοίγει | Η Courier Center άλλαξε τη διεύθυνση της σελίδας tracking | Ενημερώστε στην τελευταία έκδοση. |
| Το κουμπί «Create Voucher» δεν εμφανίζεται (μόνο «Not available») | Ο τρόπος αποστολής της παραγγελίας δεν είναι επιλεγμένος στις ρυθμίσεις | Προσθέστε τον στο «Select in which shipping methods…». |
| Η λίστα ημέρας ανοίγει κενή | Δεν υπάρχουν vouchers για τη σημερινή ημέρα ή το API δεν επέστρεψε manifest | Ελέγξτε ότι εκδόθηκαν vouchers σήμερα. Αλλιώς επικοινωνήστε μαζί μας. |
Βήματα εγκατάστασης
-
Βήμα 1
Plugin setup
Εγκατάσταση plugin και license activation.
-
Βήμα 2
Courier settings
Ρύθμιση credentials, αποστολέα και αντικαταβολής.
-
Βήμα 3
Voucher validation
Δοκιμή voucher, label και tracking σε πραγματικό test order.
Συχνές ερωτήσεις
Γιατί χρειάζεται test voucher;
Για να επιβεβαιωθεί ότι η courier δέχεται το payload και ότι η ομάδα βλέπει σωστά label/tracking.
Μπορεί να δουλέψει με bulk orders;
Ελέγχουμε τη μαζική ροή όπου τη χρειάζεται το eshop.