Οδηγός WooCommerce Τιμολόγιο στο Checkout 2.1.0

Το Checkout Fields 2.1.0 προσθέτει επιλογή Απόδειξη ή Τιμολόγιο και συλλέγει τα απαιτούμενα εταιρικά στοιχεία με server-side validation. Η ίδια βασική επιλογή υποστηρίζεται σε Classic Checkout και Checkout Blocks.

Ρυθμίσεις ΑΦΜ και 39α

• API username/password μόνο από εξουσιοδοτημένο διαχειριστή
• Στοιχεία 39α και VAT της επιχείρησης όπου χρειάζονται
• Κατηγορίες προϊόντων που συμμετέχουν στη 39α ροή
• Επιλογή άμεσης εμφάνισης ή εμφάνισης μετά τον έλεγχο ΑΦΜ

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

• Backup και πρώτη δοκιμή σε staging
• Επιβεβαίωση αν το production checkout είναι Classic ή Checkout Blocks
• Συμφωνία με λογιστή για required invoice fields και εφαρμογή άρθρου 39α
• Εγκεκριμένα test/sandbox credentials πριν από external VAT/39a call
• Λίστα WooCommerce categories που συμμετέχουν σε 39α
• Privacy/retention review για VAT και εταιρικά order data

Εγκατάσταση ή upgrade από 2.0.6

• Upload/activate του obs-checkout-fields-2.1.0.zip
• Backup των woo_cf_* options και sample invoice order metadata
• Άνοιγμα Settings → Timologia For WooCommerce OBS Technologies
• Settings render και checkout render με HPOS off/on
• Καμία χρήση production credentials στην πρώτη δοκιμή

Αναλυτικό reference ρυθμίσεων

• API Username/Password: credentials της βασικής VAT/company lookup ροής
• API Username/Password for 39a: ξεχωριστά credentials όπου το provider contract το απαιτεί
• Your VAT: ΑΦΜ επιχείρησης/πωλητή για τη 39α ροή
• Categories for 39a: μόνο κατηγορίες που έχουν εγκριθεί λογιστικά· έλεγχος parent/child/mixed cart
• Display Mode enabled: όλα τα invoice fields εμφανίζονται αμέσως μετά το Τιμολόγιο
• Display Mode disabled: τα fields εμφανίζονται μετά το VAT validation/autofill flow
• Κενό password save: διατηρεί το αποθηκευμένο secret· νέα μη κενή τιμή το αντικαθιστά

Test VAT Number

Χρησιμοποιήστε μόνο VAT που επιτρέπεται από το provider contract. Καταγράψτε ώρα, environment και αποτέλεσμα. Το unable to validate μπορεί να σημαίνει timeout/provider failure και όχι άκυρο ΑΦΜ· μην παρακάμπτετε το fail-closed behavior.

Invoice fields που αποθηκεύονται

• billing_receipt_type: Απόδειξη ή Τιμολόγιο
• billing_vat: ΑΦΜ
• billing_tax_office: ΔΟΥ
• billing_job_description: δραστηριότητα/επάγγελμα
• billing_company: επωνυμία
• billing_bs_address, billing_bs_city, billing_bs_zip: στοιχεία έδρας
• billing_39a_afm: ΑΦΜ ελέγχου 39α όπου ενεργοποιείται

Checkout Blocks

Στα Blocks το πεδίο Παραστατικό εμφανίζεται στο contact information. Η επιλογή Τιμολόγιο ενεργοποιεί την αντίστοιχη server-side validation και τα order fields αποθηκεύονται με WooCommerce/HPOS-safe APIs.

Classic Checkout

Στο Classic Checkout εμφανίζεται η επιλογή Απόδειξη/Τιμολόγιο πάνω από τα billing fields. Η επικύρωση γίνεται και στον server ώστε να μη βασίζεται μόνο σε JavaScript.

Classic acceptance test

• Απόδειξη: invoice-only fields δεν πρέπει να γίνουν required
• Τιμολόγιο: εμφάνιση και server-side required validation
• Κενό/λάθος ΑΦΜ, incomplete company fields και valid approved test data
• Σε approved sandbox order: έλεγχος order admin/email/export metadata
• Καμία live payment/provider συναλλαγή χωρίς ξεχωριστή έγκριση

Blocks acceptance test

• Επιβεβαίωση ότι η σελίδα χρησιμοποιεί WooCommerce Checkout block
• Παραστατικό στο contact information και δοκιμή Απόδειξη/Τιμολόγιο
• Store API rejection σε incomplete invoice payload
• Σε approved sandbox order: normalized metadata στο WC_Order με HPOS on
• Έλεγχος μετά από cache/minification αλλαγές και theme update

39a scenario matrix

• Eligible category + valid approved test VAT
• Eligible category + invalid VAT
• Non-eligible category
• Mixed eligible/non-eligible cart
• Provider timeout/HTTP error
• Repeated attempts/rate limit
• Cart change μετά το validation

Σε provider failure η tax exemption πρέπει να αποτυγχάνει κλειστά. Η τεχνική επιλογή category ή ένα client-side response δεν αποτελεί φορολογική γνωμοδότηση.

Security και privacy operations

• Public VAT AJAX calls απαιτούν nonce και privacy-preserving rate limit
• Outbound HTTPS request με XML escaping, timeout 15s και redirects disabled
• Credentials και raw upstream bodies δεν μπαίνουν σε logs/screenshots/tickets
• Admin access περιορίζεται και VAT/company data ακολουθούν WooCommerce order retention policy
• Client-side visibility/autofill είναι convenience layer — η ασφάλεια επιβάλλεται server-side

Troubleshooting

• Παραστατικό δεν εμφανίζεται στα Blocks: version, πραγματικό Checkout block, JS/cache και Store API registration
• Fields δεν εμφανίζονται: Display Mode, VAT response, browser console και minification
• VAT test αποτυγχάνει: credentials, Your VAT, contract, HTTPS/DNS/firewall, timeout/rate limit
• Blank password έσβησε credential: δεν πρέπει στο 2.1.0 — ελέγξτε ότι δεν τρέχει legacy 2.0.6
• Order meta λείπει: server validation, Classic/Store API hook, HPOS sync και approved payload
• 39a εφαρμόζεται λάθος: απενεργοποίηση ροής, evidence cart/categories/result και λογιστική/τεχνική επανεξέταση

Update, rollback και uninstall

Backup woo_cf_* options και sample order metadata. Μετά από update ελέγξτε password preserve, Classic, Blocks, fail-closed provider behavior και HPOS off/on. Σε rollback κρατήστε options/order meta. Η αφαίρεση plugin files δεν διαγράφει φορολογικά/order δεδομένα· retention/erasure ακολουθεί WooCommerce και τις νομικές υποχρεώσεις.

Support bundle χωρίς credentials

Plugin/WP/Woo/PHP versions, Classic ή Blocks, HPOS state, redacted settings, category/cart scenario, exact error/timestamp, logs χωρίς credentials/PII, test order ID και αν το issue αφορά VAT, 39a ή persistence. Ποτέ production password ή πλήρες raw SOAP body.

Δες το WooCommerce Τιμολόγιο στο Checkout & ΑΦΜ.