Οδηγός εγκατάστασης ΕΛΤΑ Courier για WooCommerce

Οδηγός εγκατάστασης ΕΛΤΑ Courier voucher για WooCommerce

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

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

• Σύμβαση με την ΕΛΤΑ Courier και στοιχεία web services: Χρήστης, Κωδικός, Πελάτης, Υπο Κωδικός. Για δεύτερο λογαριασμό, τα αντίστοιχα στοιχεία του.
• Για ακύρωση στα ΕΛΤΑ από το WooCommerce: ξεχωριστά στοιχεία API v3 (customerCode, customerUser, customerPassword, userCode, userPassword, pelCode).
• Server με PHP 7.4+ και επέκταση PHP SOAP· εξερχόμενη σύνδεση προς την ΕΛΤΑ Courier στη θύρα 9003.
• Βάρος και διαστάσεις (cm) στα προϊόντα, για σωστό χρεώσιμο βάρος.
• Backup του site πριν από εγκατάσταση ή αναβάθμιση.

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

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

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

Όλες οι ρυθμίσεις βρίσκονται σε μία σελίδα και αποθηκεύονται με το κουμπί Save.

Κύριος λογαριασμός

• Χρήστης: ο κωδικός χρήστη web services.
• Κωδικός: ο κωδικός πρόσβασης.
• Πελάτης: ο κωδικός πελάτη (αποστολέα) στην ΕΛΤΑ Courier.
• Υπο Κωδικός: ο υποκωδικός· στέλνεται με API Version 2.

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

• Ενεργοποίηση δεύτερου λογαριασμού: εμφανίζει τα πεδία Χρήστης, Κωδικός, Πελάτης, Υπο Κωδικός του δεύτερου λογαριασμού και προσθέτει επιλογή λογαριασμού στο παράθυρο δημιουργίας.

Σύνδεση και εκτύπωση

• Test Mode: χρησιμοποιεί το δοκιμαστικό περιβάλλον της ΕΛΤΑ Courier. Απενεργοποιήστε το για πραγματικές αποστολές.
• API Version (1 ή 2, προεπιλογή 2): η έκδοση της υπηρεσίας δημιουργίας voucher. Η 2 στέλνει και τον υποκωδικό.
• PDF Voucher Template: A4 (προεπιλογή) ή A6.

Ακύρωση στα ΕΛΤΑ (API v3)

• API v3 remote cancellation: Off (προεπιλογή), Stage ή Production.
• API v3 customerCode, API v3 customerUser, API v3 customerPassword, API v3 userCode, API v3 userPassword, API v3 pelCode: τα στοιχεία API v3 από την ΕΛΤΑ Courier. Οι κωδικοί δεν εμφανίζονται ξανά μετά την αποθήκευση· αφήστε τους κενούς για να κρατηθούν.

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

• 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 της παραγγελίας.
• Tracking Page: «Courier Service Provider» (σελίδα της ΕΛΤΑ Courier) ή δική σας σελίδα με το shortcode [obs_elta_courier_tracking].
• Email Text: το κείμενο tracking, με τα πεδία {{voucher_no}} και {{tracking_url}}.

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

1. Με Test Mode ενεργό, φτιάξτε δοκιμαστική παραγγελία με πλήρη στοιχεία και τρόπο αποστολής που έχετε επιλέξει.
2. Πατήστε Create Voucher, ελέγξτε τον πίνακα βάρους, τα τεμάχια και την αντικαταβολή.
3. Πατήστε Print και ελέγξτε το PDF στο πρότυπο που επιλέξατε.
4. Ελέγξτε τη σημείωση της παραγγελίας και το email του πελάτη με το tracking link.
5. Αν χρησιμοποιείτε API v3, δοκιμάστε σε Stage το «Cancel voucher at ELTA».

Go-live checklist

• Test Mode ανενεργό και στοιχεία παραγωγής.
• Θύρα 9003 ανοιχτή για εξερχόμενη σύνδεση από τον server.
• Σωστοί τρόποι αποστολής στη ρύθμιση.
• Βάρη και διαστάσεις σε όλα τα προϊόντα.
• API v3 σε Production μόνο αφού δοκιμαστεί σε Stage.
• License key ενεργό για τις ενημερώσεις.

Σημαντικό: το κουμπί Delete αφαιρεί το voucher μόνο από το WooCommerce και δεν ενημερώνει τα ΕΛΤΑ. Για ακύρωση στα ΕΛΤΑ χρησιμοποιήστε το πλαίσιο «ELTA remote cancellation (API v3)» ή το portal της ΕΛΤΑ Courier.

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

• Σύμπτωμα: Σφάλμα σύνδεσης κατά τη δημιουργία voucher (π.χ. δεν φορτώνει η υπηρεσία ή λήγει ο χρόνος).
  Αιτία: Ο server του καταστήματος δεν μπορεί να συνδεθεί στην ΕΛΤΑ Courier στη θύρα 9003 (firewall hosting).
  Λύση: Ζητήστε από τον πάροχο φιλοξενίας να ανοίξει την εξερχόμενη θύρα 9003 και δοκιμάστε ξανά.
• Σύμπτωμα: Πατήσατε Delete αλλά το voucher εμφανίζεται ακόμη στα ΕΛΤΑ.
  Αιτία: Το Delete αφαιρεί το voucher μόνο από το WooCommerce· η παλιά υπηρεσία SOAP της ΕΛΤΑ δεν έχει λειτουργία ακύρωσης.
  Λύση: Ενεργοποιήστε την ακύρωση μέσω API v3 με τα στοιχεία που δίνει η ΕΛΤΑ Courier ή ακυρώστε από το portal της ΕΛΤΑ.
• Σύμπτωμα: Το voucher δείχνει μεγαλύτερο βάρος (π.χ. 1 kg αντί για 0,6 kg).
  Αιτία: Παλαιότερες εκδόσεις στρογγυλοποιούσαν προς τα πάνω σε ακέραια κιλά, ή το ογκομετρικό βάρος είναι μεγαλύτερο από το πραγματικό.
  Λύση: Αναβαθμίστε σε 2.1.0 ή νεότερη (δεκαδικό βάρος) και ελέγξτε τις διαστάσεις των προϊόντων στον πίνακα βάρους του παραθύρου.
• Σύμπτωμα: Η εκτύπωση ανοίγει το προηγούμενο voucher.
  Αιτία: Cache του PDF σε παλαιότερες εκδόσεις.
  Λύση: Αναβαθμίστε σε 2.0.3 ή νεότερη· κάθε PDF έχει πλέον μοναδικό όνομα και καθαρίζεται αυτόματα.
• Σύμπτωμα: Στη μαζική εκτύπωση το PDF περιέχει διπλά vouchers.
  Αιτία: Σφάλμα σε παλαιότερες εκδόσεις.
  Λύση: Αναβαθμίστε σε 2.0.4 ή νεότερη.
• Σύμπτωμα: Τα vouchers του δεύτερου λογαριασμού τυπώνονται ή παρακολουθούνται με τον κύριο λογαριασμό.
  Αιτία: Σφάλμα σε εκδόσεις πριν την 2.1.0.
  Λύση: Αναβαθμίστε σε 2.1.0 ή νεότερη.
• Σύμπτωμα: Ειδοποιήσεις PHP «Creation of dynamic property» ή «_load_textdomain_just_in_time» στο διαχειριστικό.
  Αιτία: Νεότερες εκδόσεις PHP (8.2+) και WordPress (6.7+).
  Λύση: Αναβαθμίστε σε 2.1.1.
• Σύμπτωμα: Αντί για Create Voucher εμφανίζεται «Not available».
  Αιτία: Ο τρόπος αποστολής της παραγγελίας δεν έχει επιλεγεί στη ρύθμιση τρόπων αποστολής.
  Λύση: Προσθέστε τον τρόπο ή τη ζώνη στη ρύθμιση και αποθηκεύστε.
• Σύμπτωμα: «Λάθος Κωδικός Χρήστη» ή «δεν επιτρέπεται η πρόσβαση» κατά τη δημιουργία voucher.
  Αιτία: Έχουν μπει οι κωδικοί του portal αντί για τα στοιχεία web services, λείπει ο Υπο Κωδικός ή το Test Mode δεν ταιριάζει με τους κωδικούς.
  Λύση: Ζητήστε από την ΕΛΤΑ Courier τα στοιχεία web services, συμπληρώστε Χρήστης, Κωδικός, Πελάτης, Υπο Κωδικός και ρυθμίστε το Test Mode ανάλογα.
• Σύμπτωμα: Η σελίδα ρυθμίσεων δεν έχει κουμπί Save ή εμφανίζει «critical error».
  Αιτία: Παλαιότερες εκδόσεις φόρτωναν ρυθμίσεις και μεταφράσεις πολύ νωρίς για WordPress 6.7+ / PHP 8.2+.
  Λύση: Αναβαθμίστε στην 2.1.1.
• Σύμπτωμα: Σφάλμα ΣΥ.ΔΕ.ΤΑ. 0900 ή απόρριψη ταχυδρομικού κώδικα.
  Αιτία: Η ΕΛΤΑ Courier απορρίπτει ελλιπή ή λάθος στοιχεία παραλήπτη.
  Λύση: Διορθώστε ΤΚ, διεύθυνση, πόλη και τηλέφωνο στην παραγγελία και εκδώστε ξανά. Αν επιμένει, στείλτε μας το μήνυμα σφάλματος.
• Σύμπτωμα: Η μαζική ενέργεια δημιουργεί voucher ΕΛΤΑ και σε παραγγελίες άλλης courier.
  Αιτία: Η μαζική ενέργεια εκτελείται για όλες τις επιλεγμένες παραγγελίες.
  Λύση: Επιλέγετε μόνο παραγγελίες ΕΛΤΑ (π.χ. με φίλτρο τρόπου αποστολής) και ορίστε σωστά τους τρόπους αποστολής στη ρύθμιση.