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

Η ACS σύνδεση είναι καθημερινό operational εργαλείο. Ο οδηγός καλύπτει τη ρύθμιση credentials, voucher, αντικαταβολής, PDF, tracking και μαζικών ενεργειών μέσα στο WooCommerce.

Πριν την εγκατάσταση

• Πλήρες backup και staging clone με HTTPS
• Ενεργή σύμβαση ACS και web-service credentials εκτός tickets/chat
• Billing code, station, sender και τυχόν ξεχωριστός Cyprus account
• Shipping zones, βάρος/ογκομετρικό βάρος και τρόποι πληρωμής για αντικαταβολή
• Εγκεκριμένο controlled test order· καμία ACS κλήση δεν γίνεται χωρίς ρητή άδεια

Βήμα 1: ρυθμίσεις ACS στο WooCommerce

Στις ρυθμίσεις περνάμε τα ACS credentials, στοιχεία αποστολέα και επιλογές που επηρεάζουν voucher, αντικαταβολή και tracking. Το πρώτο check είναι να μη λείπει κανένα υποχρεωτικό πεδίο πριν γίνει live δοκιμή.

Βήμα 2: voucher, tracking και daily workflow

Μετά τη δημιουργία voucher ελέγχουμε ότι το tracking αποθηκεύεται στην παραγγελία, ότι το PDF ανοίγει σωστά και ότι οι μαζικές ενέργειες ή το daily archive δεν αφήνουν τον χρήστη με raw API απάντηση.

Τι πρέπει να επιβεβαιωθεί

• Voucher δημιουργείται μία φορά από εξουσιοδοτημένη order action
• COD amount, βάρος, station/billing account και sender είναι σωστά
• Tracking number και order note αποθηκεύονται στο WooCommerce
• A4/thermal PDF ανοίγει ιδιωτικά χωρίς public URL ή customer PII leak
• Bulk create/print δίνει per-order αποτέλεσμα
• Σε timeout γίνεται reconciliation πριν από retry ώστε να μην προκύψει διπλό voucher
• Legacy orders και HPOS sync-off workflow περνούν το ίδιο acceptance set

Troubleshooting χωρίς blind retry

• API/credential error: επιβεβαιώστε environment, billing/station pairing και outbound HTTPS χωρίς να μοιραστείτε secrets
• Voucher ίσως δημιουργήθηκε μετά από timeout: refresh order και έλεγχος ACS πριν από οποιοδήποτε retry
• PDF error: καταγράψτε paper setting και voucher reference, όχι πραγματικό customer PDF
• Tracking κενό: επιβεβαιώστε voucher number και carrier-event delay
• Bulk partial failure: reconcile ανά order και retry μόνο τις επιβεβαιωμένες αποτυχίες

Update, rollback και support bundle

Πριν από update κρατήστε το προηγούμενο ZIP, settings export και backup. Rollback κώδικα δεν ακυρώνει voucher, pickup list, email ή άλλη ACS-side ενέργεια. Στο support στέλνουμε plugin/WP/Woo/PHP versions, timestamp, anonymized order reference, expected/actual αποτέλεσμα και redacted log excerpt — ποτέ credentials, πλήρη payloads, διεύθυνση πελάτη ή voucher PDF.

Δες το WooCommerce ACS Courier Voucher Plugin.