Οδηγός εγκατάστασης Speedex Voucher για WooCommerce

Οδηγός εγκατάστασης Speedex voucher για WooCommerce

Ο οδηγός καλύπτει όλη τη ρύθμιση του WooCommerce Speedex Courier Voucher Plugin. Αν προτιμάτε, η OBS κάνει δωρεάν την εγκατάσταση και τη δοκιμή για εσάς.

Προαπαιτούμενα

• Ενεργή σύμβαση με τη Speedex και πρόσβαση στα web services.
• Στοιχεία σύνδεσης από τη Speedex: User, Password, Customer ID, Agreement ID. Αν έχετε δεύτερο λογαριασμό, και τα αντίστοιχα στοιχεία του.
• Αν χρησιμοποιείτε Customer Flag 100: όνομα, διεύθυνση, τηλέφωνο και ΤΚ αποστολέα.
• Server με PHP 7.4 ή νεότερη, επέκταση PHP SOAP και εξερχόμενη σύνδεση HTTPS προς τη Speedex.
• Βάρος στα προϊόντα του WooCommerce (σε kg), ώστε να προσυμπληρώνεται σωστά το voucher.
• Backup του site πριν από κάθε εγκατάσταση ή αναβάθμιση.

Βήμα 1: Εγκατάσταση και License key

1. Κατεβάστε το ZIP από τον λογαριασμό σας στην OBS.
2. Στο WordPress πηγαίνετε Πρόσθετα → Προσθήκη νέου → Μεταφόρτωση πρόσθετου, επιλέξτε το ZIP, πατήστε Εγκατάσταση και μετά Ενεργοποίηση.
3. Ανοίξτε WooCommerce → OBS Speedex Courier.
4. Στο πλαίσιο «Activate Speedex Courier for Update», επικολλήστε το License key στο πεδίο «Enter Validation Key» και πατήστε Activate. Το key καταχωρεί το domain σας και ενεργοποιεί τις αυτόματες ενημερώσεις.

Βήμα 2: Χάρτης ρυθμίσεων

Όλες οι ρυθμίσεις βρίσκονται σε μία σελίδα και αποθηκεύονται με το κουμπί Save. Τα πεδία κωδικών εμφανίζονται κρυφά· αν τα αφήσετε κενά κατά την αποθήκευση, κρατιέται η αποθηκευμένη τιμή.

Σύνδεση με τη Speedex

• User / Password: όνομα χρήστη και κωδικός web services της Speedex.
• Customer ID: ο κωδικός πελάτη σας στη Speedex.
• Agreement ID: ο κωδικός συμφωνίας (σύμβασης).
• Test Mode (Yes/No): με Yes οι κλήσεις πάνε στο δοκιμαστικό περιβάλλον της Speedex. Είναι προεπιλεγμένο σε Yes· για πραγματικές αποστολές ορίστε No.
• Debug Logging: καταγράφει τα αιτήματα/απαντήσεις SOAP σε περίπτωση σφάλματος στα WooCommerce Logs. Κρατήστε το ανενεργό, εκτός αν διερευνάτε πρόβλημα.

Εκτύπωση

• Paper Size: A4, A5, 10x21cm ή A6. Επιλέξτε ανάλογα με τον εκτυπωτή (laser ή θερμικό).

Δεύτερος λογαριασμός

• Secondary Account: ενεργοποιεί δεύτερο λογαριασμό Speedex.
• Secondary User, Secondary Password, Secondary Customer ID, Secondary Agreement ID: τα στοιχεία του δεύτερου λογαριασμού.

Αποστολέας

• Customer Flag (0 ή 100): με 0 εκδίδεται απλό voucher. Με 100 το voucher εκδίδεται μαζί με εντολή παραλαβής και στέλνονται τα στοιχεία αποστολέα. Ποια τιμή ισχύει για τη σύμβασή σας το επιβεβαιώνει η Speedex.
• Sender Name, Sender Address, Sender Telephone, Sender Postcode: χρησιμοποιούνται μόνο με Customer Flag 100.

Τρόποι αποστολής και ειδοποιήσεις

• Select in which shipping methods voucher creation will be available: επιλέξτε τους τρόπους αποστολής (και τις ζώνες) για τους οποίους θα εμφανίζεται το κουμπί Create Voucher. Στις υπόλοιπες παραγγελίες εμφανίζεται «Not available».
• Shipping Notifications («Notify customer on shipment created»): στέλνει email στον πελάτη όταν εκδίδεται ή ακυρώνεται το voucher.
• Include Tracking Info: προσθέτει το κείμενο tracking στα emails παραγγελίας του WooCommerce, αφού έχει εκδοθεί voucher.
• Email Text: το κείμενο tracking. Χρησιμοποιήστε {{voucher_no}} για τον αριθμό αποστολής και {{tracking_url}} για τον σύνδεσμο παρακολούθησης.

Βήμα 3: Δοκιμή

1. Με Test Mode = Yes, δημιουργήστε μια δοκιμαστική παραγγελία με πλήρη στοιχεία (ονοματεπώνυμο, διεύθυνση, ΤΚ, πόλη, τηλέφωνο) και τρόπο αποστολής που έχετε επιλέξει.
2. Στη λίστα παραγγελιών πατήστε Create Voucher, ελέγξτε βάρος, τεμάχια και αντικαταβολή και επιβεβαιώστε.
3. Πατήστε Download Voucher ή Print και ελέγξτε ότι το PDF ανοίγει στο σωστό μέγεθος.
4. Ελέγξτε ότι ο αριθμός αποστολής γράφτηκε στις σημειώσεις της παραγγελίας και ότι το email του πελάτη έχει το tracking link.
5. Δοκιμάστε Delete για να επιβεβαιώσετε την ακύρωση.

Go-live checklist

• Test Mode = No και στοιχεία παραγωγής από τη Speedex.
• Σωστοί τρόποι αποστολής στο πεδίο επιλογής.
• Paper Size σύμφωνα με τον εκτυπωτή της αποθήκης.
• Βάρη σε όλα τα προϊόντα.
• Ένα πραγματικό voucher (με έγκρισή σας) για επιβεβαίωση PDF και tracking.
• Debug Logging ανενεργό μετά τις δοκιμές.
• License key ενεργό, για να λαμβάνετε τις ενημερώσεις.

Αντιμετώπιση προβλημάτων

• Σύμπτωμα: Εμφανίζεται «SOAP-ERROR: Parsing WSDL: Couldn't load from …» και δεν εκδίδεται voucher.
  Αιτία: Ο server δεν μπορεί να φορτώσει το WSDL της Speedex: παλιά cache WSDL ή πρόβλημα επαλήθευσης πιστοποιητικού TLS στο hosting.
  Λύση: Αναβαθμίστε στην τελευταία έκδοση (περιλαμβάνει απενεργοποίηση cache WSDL και εναλλακτική σύνδεση TLS). Ελέγξτε ότι επιτρέπεται εξερχόμενη σύνδεση HTTPS προς τη Speedex και ότι η PHP έχει SOAP και OpenSSL.
• Σύμπτωμα: Το voucher έβγαινε κανονικά και ξαφνικά σταμάτησε.
  Αιτία: Η Speedex άλλαξε το παραγωγικό endpoint των web services ή υπάρχει προσωρινή διακοπή από την πλευρά της.
  Λύση: Βεβαιωθείτε ότι έχετε έκδοση 2.0.4 ή νεότερη (endpoint spdxws02.speedex.gr). Αν το πρόβλημα συνεχίζεται, ενεργοποιήστε Debug Logging και στείλτε μας το μήνυμα σφάλματος.
• Σύμπτωμα: Το voucher δημιουργήθηκε, αλλά η Speedex δεν το βλέπει ή δεν παραλαμβάνει το δέμα.
  Αιτία: Το Test Mode είναι ακόμη Yes (προεπιλογή), οπότε το voucher εκδόθηκε στο δοκιμαστικό περιβάλλον.
  Λύση: Ορίστε Test Mode = No, βεβαιωθείτε ότι τα στοιχεία είναι παραγωγής και εκδώστε ξανά το voucher.
• Σύμπτωμα: Αντί για κουμπί Create Voucher εμφανίζεται «Not available».
  Αιτία: Ο τρόπος αποστολής της παραγγελίας δεν έχει επιλεγεί στο «Select in which shipping methods voucher creation will be available».
  Λύση: Προσθέστε τον τρόπο αποστολής (ή τη συγκεκριμένη ζώνη) στη ρύθμιση και αποθηκεύστε.
• Σύμπτωμα: Σφάλμα σύνδεσης ή αυθεντικοποίησης κατά τη δημιουργία.
  Αιτία: Λάθος User, Password, Customer ID ή Agreement ID, ή στοιχεία δοκιμών με Test Mode = No (και αντίστροφα).
  Λύση: Ελέγξτε τα στοιχεία με τη Speedex και ότι το Test Mode ταιριάζει με το περιβάλλον των στοιχείων.
• Σύμπτωμα: Fatal error σχετικά με WSDL_CACHE_NONE σε PHP 8.2.
  Αιτία: Παλαιότερη έκδοση που δεν υποστήριζε περιβάλλοντα PHP 8.2 χωρίς τη σταθερά.
  Λύση: Αναβαθμίστε σε έκδοση 2.0.3 ή νεότερη.
• Σύμπτωμα: Δεν περνά αντικαταβολή στο voucher.
  Αιτία: Η παραγγελία δεν έχει τον τρόπο πληρωμής αντικαταβολής του WooCommerce (cod), π.χ. χρησιμοποιείται άλλο plugin αντικαταβολής.
  Λύση: Χρησιμοποιήστε τη μέθοδο «Αντικαταβολή» του WooCommerce ή επικοινωνήστε μαζί μας για προσαρμογή.
• Σύμπτωμα: Μήνυμα «πρόβλημα με το δίκτυο» ή αποτυχία έκδοσης αμέσως μετά από αναβάθμιση PHP.
  Αιτία: Η νέα έκδοση PHP δεν έχει ενεργή την επέκταση SOAP/OpenSSL ή η έκδοση του plugin είναι παλιά για τη νέα PHP.
  Λύση: Ενεργοποιήστε SOAP για τη νέα έκδοση PHP (μέσω του hosting) και αναβαθμίστε το plugin στην τελευταία έκδοση.
• Σύμπτωμα: Τα στοιχεία αποστολέα στο voucher είναι παλιά ή δεν αλλάζουν.
  Αιτία: Με Customer Flag 0 η Speedex τυπώνει τα στοιχεία της σύμβασης· τα πεδία Sender χρησιμοποιούνται μόνο με Customer Flag 100.
  Λύση: Ζητήστε από τη Speedex να ενημερώσει τα στοιχεία σύμβασης ή, αφού το επιβεβαιώσετε μαζί της, ορίστε Customer Flag 100 και συμπληρώστε Sender Name, Address, Telephone, Postcode.
• Σύμπτωμα: Η δημιουργία voucher αργεί πολλά δευτερόλεπτα.
  Αιτία: Παλαιότερες εκδόσεις χρησιμοποιούσαν το παλιό κοινό endpoint της Speedex.
  Λύση: Αναβαθμίστε σε 2.0.5 ή νεότερη, όπου όλες οι κλήσεις πάνε στο spdxws02.speedex.gr. Αν συνεχίζεται, ενεργοποιήστε Debug Logging και στείλτε μας το αρχείο.
• Σύμπτωμα: Σφάλμα για χώρα, τηλέφωνο ή ταχυδρομικό κώδικα παραλήπτη.
  Αιτία: Λείπουν ή έχουν λάθος μορφή υποχρεωτικά πεδία της παραγγελίας.
  Λύση: Συμπληρώστε χώρα, τηλέφωνο και 5ψήφιο ΤΚ στην παραγγελία και εκδώστε ξανά. Τα κενά στον ΤΚ αφαιρούνται αυτόματα από την 2.0.2.
• Σύμπτωμα: Σε παραγγελία με πολλά vouchers, μετά το Delete ένα voucher παραμένει ενεργό στη Speedex.
  Αιτία: Σε εκδόσεις 2.0.x η ακύρωση αφορά τον πρώτο αριθμό voucher της παραγγελίας.
  Λύση: Ελέγξτε και ακυρώστε τα υπόλοιπα από το Speedex panel ή επικοινωνήστε με την OBS.