Οδηγός εγκατάστασης Γενικής Ταχυδρομικής Voucher για WooCommerce

Οδηγός εγκατάστασης Γενικής Ταχυδρομικής voucher για WooCommerce

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

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

• Σύμβαση με τη Γενική Ταχυδρομική και στοιχεία Web Services: Username, Password, App Key (πρώτα δοκιμαστικά, μετά παραγωγής).
• Server με PHP και ενεργή επέκταση SOAP, HTTPS και λειτουργικό WP-Cron (για το αυτόματο κλείσιμο ημέρας).
• Βάρος στα προϊόντα του WooCommerce (σε kg).
• Backup του site πριν από εγκατάσταση ή αναβάθμιση.

Το App Key το δίνει η Γενική Ταχυδρομική και είναι διαφορετικό από το License key της OBS.

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

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

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

Στην κορυφή της σελίδας βρίσκονται το πεδίο Close Date και το κουμπί Close Pending Jobs. Οι ρυθμίσεις αποθηκεύονται με Save.

Σύνδεση

• Username, Password, App Key: τα στοιχεία Web Services της Γενικής Ταχυδρομικής.
• Enable Test Mode («Enable Test/Sandbox Mode»): χρησιμοποιεί το δοκιμαστικό περιβάλλον της Γενικής. Είναι ενεργό από προεπιλογή· απενεργοποιήστε το με τα στοιχεία παραγωγής.

Εκτύπωση

• PDF Voucher Template: Flyer ή Sticker (προεπιλογή Sticker).

Κλείσιμο ημέρας

• Auto Close Pending Jobs: κλείνει αυτόματα τις εκκρεμείς αποστολές της ημέρας στις ώρες που ορίζετε.
• Auto Close Times: ώρες σε μορφή 24ώρου χωρισμένες με κόμμα (π.χ. 10:00,14:00,18:00), με βάση τη ζώνη ώρας του WordPress. Αν η τιμή δεν είναι έγκυρη, χρησιμοποιείται 18:00.
• Close Pending Jobs After Voucher Created: κλείνει την ημέρα αμέσως μετά από κάθε επιτυχημένο voucher (στη μαζική έκδοση μία φορά ανά εκτέλεση).

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

• 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 της παραγγελίας.
• Email Text: το κείμενο tracking, με τα πεδία {{voucher_no}} και {{tracking_url}}.

Βήμα 3: Δοκιμή και πιστοποίηση Γενικής

1. Με Enable Test Mode ενεργό και τα δοκιμαστικά στοιχεία, φτιάξτε δοκιμαστική παραγγελία με εικονικά αλλά πλήρη στοιχεία παραλήπτη.
2. Πατήστε Create Voucher (σύνδεση και δημιουργία voucher).
3. Πατήστε Print (λήψη PDF).
4. Σε μία δεύτερη δοκιμαστική παραγγελία πατήστε Delete πριν το κλείσιμο ημέρας (ακύρωση).
5. Πατήστε Close Pending Jobs (κλείσιμο ημέρας).
6. Ενημερώστε τη Γενική ότι ολοκληρώθηκαν οι δοκιμές και ζητήστε τα στοιχεία παραγωγής.

Go-live checklist

• Στοιχεία παραγωγής στα Username, Password, App Key και Test Mode ανενεργό.
• Σωστοί τρόποι αποστολής στη ρύθμιση.
• Πρότυπο PDF σύμφωνα με τον εκτυπωτή.
• Τρόπος κλεισίματος ημέρας σύμφωνα με τα δρομολόγια παραλαβής της Γενικής (χειροκίνητα ή σε ώρες).
• Βάρη σε όλα τα προϊόντα.
• License key ενεργό.

Σημαντικό: η μαζική ενέργεια εκδίδει vouchers με 1 τεμάχιο, βάρος 1 kg και χωρίς πρόσθετες υπηρεσίες (η αντικαταβολή προστίθεται αυτόματα). Για παραγγελίες που χρειάζονται άλλο βάρος ή υπηρεσίες, χρησιμοποιήστε το παράθυρο Create Voucher.

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

• Σύμπτωμα: «Authentication failed» κατά τη δημιουργία voucher.
  Αιτία: Λάθος ή ληγμένα Username, Password ή App Key, ή στοιχεία δοκιμών με Test Mode ανενεργό (και αντίστροφα).
  Λύση: Ελέγξτε τα στοιχεία με τη Γενική Ταχυδρομική (ζητήστε νέο App Key αν χρειάζεται) και ρυθμίστε το Test Mode ανάλογα με το αν είναι δοκιμαστικά ή παραγωγής.
• Σύμπτωμα: Σφάλμα «Class "SoapClient" not found» ή HTTP 500 στη δημιουργία voucher.
  Αιτία: Η επέκταση PHP SOAP δεν είναι ενεργή, συχνά μετά από αλλαγή έκδοσης PHP.
  Λύση: Ζητήστε από τον πάροχο φιλοξενίας να ενεργοποιήσει το SOAP για την έκδοση PHP του site.
• Σύμπτωμα: «Error code 12» ή άλλος κωδικός σφάλματος από τη Γενική.
  Αιτία: Σφάλμα επεξεργασίας από την πλευρά της Γενικής Ταχυδρομικής κατά τη δημιουργία, όχι πρόβλημα σύνδεσης.
  Λύση: Ελέγξτε τα στοιχεία της παραγγελίας και επικοινωνήστε με τη Γενική Ταχυδρομική με τον κωδικό σφάλματος· στείλτε μας το μήνυμα αν χρειάζεστε βοήθεια.
• Σύμπτωμα: «Invalid Data (Name, Address, City)» (700).
  Αιτία: Λείπουν όνομα, διεύθυνση ή πόλη παραλήπτη.
  Λύση: Συμπληρώστε τα στοιχεία αποστολής της παραγγελίας και εκδώστε ξανά.
• Σύμπτωμα: «COD Amount Missing» (701), «COD Amount Not Needed» (702) ή «COD Amount Limit Exceeded» (703).
  Αιτία: Το ποσό αντικαταβολής λείπει, δεν αντιστοιχεί στον τρόπο πληρωμής ή ξεπερνά το όριο της Γενικής.
  Λύση: Ελέγξτε ότι ο τρόπος πληρωμής είναι η αντικαταβολή του WooCommerce (cod) και ότι το ποσό είναι θετικό, έως 2 δεκαδικά και όχι μεγαλύτερο από το σύνολο της παραγγελίας.
• Σύμπτωμα: Η Γενική ενημερώνει ότι οι αποστολές δεν έχουν οριστικοποιηθεί ή η πιστοποίηση απορρίφθηκε.
  Αιτία: Δεν έγινε κλείσιμο ημέρας (Close Pending Jobs) ή δεν δοκιμάστηκε ακύρωση.
  Λύση: Πατήστε Close Pending Jobs ή ενεργοποιήστε Auto Close Pending Jobs. Για την πιστοποίηση, ακυρώστε μία δοκιμαστική αποστολή με Delete πριν το κλείσιμο ημέρας.
• Σύμπτωμα: «Error closing pending jobs … Something went wrong».
  Αιτία: Παλαιότερη έκδοση ή προσωρινό σφάλμα της υπηρεσίας της Γενικής.
  Λύση: Αναβαθμίστε σε 2.0.10 ή νεότερη και δοκιμάστε ξανά. Δείτε το WooCommerce Log (πηγή obs_geniki_taxidromiki) για το μήνυμα.
• Σύμπτωμα: Το κουμπί voucher εμφανίζεται σε όλες τις ζώνες ή σε παραγγελίες άλλης courier.
  Αιτία: Οι τρόποι αποστολής δεν είχαν οριστεί ανά ζώνη ή παλαιότερη έκδοση δεν ξεχώριζε τις ζώνες.
  Λύση: Αναβαθμίστε σε 2.0.11 ή νεότερη και επιλέξτε μόνο τις ζώνες/τρόπους της Γενικής στη ρύθμιση.
• Σύμπτωμα: Critical error μετά από αναβάθμιση WordPress ή PHP.
  Αιτία: Παλιά έκδοση του plugin που δεν υποστηρίζει τη νέα PHP.
  Λύση: Εγκαταστήστε την τελευταία έκδοση από τον λογαριασμό σας στην OBS ή ζητήστε τη από την υποστήριξη.
• Σύμπτωμα: Στη μαζική έκδοση το voucher έχει 1 kg και καμία υπηρεσία.
  Αιτία: Η μαζική ενέργεια χρησιμοποιεί σταθερές τιμές (1 τεμάχιο, 1 kg, χωρίς υπηρεσίες).
  Λύση: Για παραγγελίες με άλλο βάρος ή υπηρεσίες, εκδώστε το voucher από το παράθυρο Create Voucher.