Οδηγός WooCommerce Τιμολόγιο στο Checkout 2.1.0
Ρύθμιση Απόδειξη/Τιμολόγιο, ΑΦΜ, 39α, Classic Checkout, Checkout Blocks και HPOS order fields.
Εγκατάσταση και ρύθμιση του Τιμολόγιο WooCommerce στο Checkout
Ο οδηγός αφορά την έκδοση 2.1.0. Η OBS κάνει δωρεάν την εγκατάσταση και τη ρύθμιση, μαζί με τη σύνδεση των κωδικών ΑΑΔΕ. Αναλυτικοί οδηγοί ανά εργασία υπάρχουν στο κέντρο βοήθειας του plugin.
Προαπαιτούμενα
- WordPress 6.5+, WooCommerce 8.9+ και PHP 8.1+.
- Προαιρετικά: ειδικοί κωδικοί πρόσβασης ΑΑΔΕ για την υπηρεσία «Αναζήτηση Βασικών Στοιχείων Μητρώου Επιχειρήσεων».
- Για το άρθρο 39α: στοιχεία πρόσβασης της υπηρεσίας 39α, το ΑΦΜ της επιχείρησής σας και τη λίστα κατηγοριών που έχει εγκρίνει ο λογιστής σας.
- Να ξέρετε αν η σελίδα «Ολοκλήρωση αγοράς» χρησιμοποιεί κλασικό checkout ή Checkout Blocks.
Εγκατάσταση
- Κατεβάστε το ZIP από τα «Downloads» του λογαριασμού σας στην OBS.
- WordPress → «Πρόσθετα» → «Προσθήκη νέου» → «Μεταφόρτωση πρόσθετου» → «Εγκατάσταση τώρα» → «Ενεργοποίηση πρόσθετου».
- Ανοίξτε «Ρυθμίσεις» → «Timologia For Woocommerce OBS Technologies».
- Αν αναβαθμίζετε από 2.0.x, κρατήστε πρώτα αντίγραφο ασφαλείας. Οι ρυθμίσεις και τα στοιχεία των παλιών παραγγελιών μένουν.
Χάρτης ρυθμίσεων
| Ενότητα / πεδίο | Τι κάνει |
|---|---|
| Ρυθμίσεις API → «Όνομα χρήστη API», «Κωδικός πρόσβασης API» | Οι ειδικοί κωδικοί ΑΑΔΕ για τον έλεγχο ΑΦΜ και την αυτόματη συμπλήρωση. |
| Ρυθμίσεις API 39α → «Όνομα χρήστη API για 39α», «Κωδικός πρόσβασης API για 39α» | Τα στοιχεία πρόσβασης για τον έλεγχο του άρθρου 39α. |
| «Το ΑΦΜ σας» | Το ΑΦΜ της επιχείρησής σας, που χρειάζεται ο έλεγχος 39α. |
| «Κατηγορίες για 39α» | Οι κατηγορίες προϊόντων που συμμετέχουν στον έλεγχο 39α. Κενό = καμία. |
| Επιλογές Εμφάνισης Ταμείου → «Εμφάνιση όλων των πεδίων τιμολογίου ταυτόχρονα» | Ενεργό: όλα τα πεδία φαίνονται μόλις επιλεγεί «Τιμολόγιο». Ανενεργό: φαίνονται μετά τον επιτυχή έλεγχο ΑΦΜ. |
| «Δοκιμή Αριθμού ΑΦΜ» | Ελέγχει ένα ΑΦΜ με τους κωδικούς σας και δείχνει τα στοιχεία που επιστρέφει η ΑΑΔΕ. |
Πατήστε «Αποθήκευση Ρυθμίσεων». Αν αφήσετε κενό ένα πεδίο κωδικού, κρατιέται ο κωδικός που είχατε αποθηκεύσει.
Δοκιμή
- Στη «Δοκιμή Αριθμού ΑΦΜ» γράψτε ένα ΑΦΜ επιχείρησης και πατήστε «Δοκιμή ΑΦΜ». Πρέπει να δείτε «Το ΑΦΜ είναι έγκυρο» και τα στοιχεία της.
- Στο checkout επιλέξτε «Απόδειξη»: τα πεδία τιμολογίου δεν πρέπει να είναι υποχρεωτικά.
- Επιλέξτε «Τιμολόγιο», γράψτε ΑΦΜ και ελέγξτε ότι συμπληρώθηκαν τα πεδία. Δοκιμάστε και να ολοκληρώσετε με κενό πεδίο: η παραγγελία πρέπει να σταματήσει με μήνυμα.
- Ολοκληρώστε μια δοκιμαστική παραγγελία και ελέγξτε τα «Στοιχεία Τιμολογίου» στην παραγγελία και στο email.
- Αν χρησιμοποιείτε 39α, δοκιμάστε καλάθι μόνο με προϊόντα των επιλεγμένων κατηγοριών και καλάθι με μικτά προϊόντα.
Go-live checklist
- Η «Δοκιμή ΑΦΜ» δείχνει «Το ΑΦΜ είναι έγκυρο» με τους κωδικούς του live site.
- Αν δεν έχετε κωδικούς ΑΑΔΕ, είναι ενεργό το «Εμφάνιση όλων των πεδίων τιμολογίου ταυτόχρονα».
- Οι σελίδες καλαθιού και checkout εξαιρούνται από cache.
- Οι κατηγορίες 39α έχουν εγκριθεί από τον λογιστή σας.
- Το λογιστήριο ή το ERP διαβάζει σωστά τα στοιχεία τιμολογίου της παραγγελίας.
Αντιμετώπιση προβλημάτων
| Σύμπτωμα | Πιθανή αιτία | Λύση |
|---|---|---|
| Ο πελάτης γράφει ΑΦΜ, αλλά δεν συμπληρώνονται τα στοιχεία της επιχείρησης. | Οι κωδικοί στα πεδία API δεν είναι οι ειδικοί κωδικοί της υπηρεσίας της ΑΑΔΕ (π.χ. μπήκαν οι προσωπικοί κωδικοί TAXISnet), δεν έχει γίνει εγγραφή στην υπηρεσία ή η υπηρεσία της ΑΑΔΕ δεν απαντά. | Δημιουργήστε ειδικούς κωδικούς από τη «Διαχείριση Ειδικών Κωδικών», περάστε τους και ελέγξτε με τη «Δοκιμή ΑΦΜ» στις ρυθμίσεις. |
| Εμφανίζεται «Μη έγκυρος αριθμός ΑΦΜ» και ο πελάτης δεν μπορεί να ολοκληρώσει την παραγγελία με τιμολόγιο. | Ο έλεγχος ΑΦΜ απέτυχε (λάθος ή ελλιπείς κωδικοί, ΑΦΜ που δεν βρέθηκε) και, επειδή είναι ανενεργή η εμφάνιση όλων των πεδίων, τα υπόλοιπα πεδία μένουν κρυφά. | Ενεργοποιήστε το «Εμφάνιση όλων των πεδίων τιμολογίου ταυτόχρονα», ώστε ο πελάτης να μπορεί να τα συμπληρώσει χειροκίνητα, και διορθώστε τους κωδικούς ΑΑΔΕ. |
| Μετά την ενεργοποίηση το site βγάζει critical error ή το checkout χαλάει. | Παλιά έκδοση PHP ή άλλο plugin που αλλάζει τα ίδια πεδία χρέωσης (π.χ. editor πεδίων checkout). | Ελέγξτε ότι έχετε PHP 8.1+, απενεργοποιήστε προσωρινά τον editor πεδίων και ανοίξτε αίτημα υποστήριξης με το μήνυμα σφάλματος. |
| Ο επόμενος πελάτης βλέπει στο checkout τα στοιχεία τιμολογίου του προηγούμενου. | Η σελίδα checkout σερβίρεται από cache (plugin cache, CDN). | Εξαιρέστε το καλάθι και το checkout από κάθε cache και αναβαθμίστε στην 2.1.0, που δεν προσυμπληρώνει στοιχεία από προηγούμενες παραγγελίες. |
| Δεν εμφανίζεται το εικονίδιο τιμολογίου στη λίστα παραγγελιών. | Παλαιότερη έκδοση που δεν υποστηρίζει τη λίστα παραγγελιών του HPOS. | Αναβαθμίστε στην 2.1.0, που προσθέτει τη στήλη και στις δύο λίστες παραγγελιών. |
| Η απαλλαγή ΦΠΑ 39α δεν εφαρμόζεται. | Δεν ανήκουν όλα τα προϊόντα του καλαθιού στις «Κατηγορίες για 39α», δεν έχει επιλεγεί «Τιμολόγιο», λείπουν τα στοιχεία 39α ή «Το ΑΦΜ σας», ή η ΑΑΔΕ απάντησε ότι ο αγοραστής δεν δικαιούται. | Ελέγξτε κατηγορίες, κωδικούς 39α και «Το ΑΦΜ σας». Ο έλεγχος 39α γίνεται στο κλασικό checkout. |
| Δεν βρίσκω τη ΔΟΥ του πελάτη στη λίστα (π.χ. ΚΕΦΟΔΕ). | Παλαιότερη έκδοση με παλιά λίστα ΔΟΥ. | Αναβαθμίστε στην 2.1.0. Η λίστα έχει 119 ΔΟΥ, μαζί με την ΚΕΦΟΔΕ Αττικής. |
| Το πεδίο «Παραστατικό» δεν εμφανίζεται στα Checkout Blocks. | Παλαιότερη έκδοση, cache ή η σελίδα δεν χρησιμοποιεί το block «Ολοκλήρωση αγοράς». | Ελέγξτε ότι τρέχει η 2.1.0, καθαρίστε cache και βεβαιωθείτε ότι η σελίδα έχει το Checkout block. |
Βήματα εγκατάστασης
-
Βήμα 1
Εγκατάσταση 2.1.0
Εγκαθιστούμε το plugin ZIP και ανοίγουμε τη σελίδα Timologia For WooCommerce OBS Technologies.
-
Βήμα 2
Backup και checkout inventory
Κρατάμε woo_cf options/order meta και επιβεβαιώνουμε Classic ή Blocks, HPOS και tax requirements.
-
Βήμα 3
API και 39α settings
Περνάμε τα εγκεκριμένα στοιχεία και επιλέγουμε τις κατηγορίες/ρυθμίσεις που απαιτεί η επιχείρηση.
-
Βήμα 4
Display Mode και fields
Ορίζουμε άμεση ή post-validation εμφάνιση και ελέγχουμε τα απαιτούμενα invoice fields.
-
Βήμα 5
Classic Checkout test
Ελέγχουμε Απόδειξη και Τιμολόγιο, required fields και server-side validation χωρίς live provider mutation.
-
Βήμα 6
Checkout Blocks test
Επιβεβαιώνουμε ότι το Παραστατικό εμφανίζεται και ότι τα invoice fields περνούν από Store API validation.
-
Βήμα 7
39a scenario test
Δοκιμάζουμε eligible/non-eligible/mixed cart, valid/invalid VAT, timeout και rate-limit συμπεριφορά.
-
Βήμα 8
HPOS verification
Ελέγχουμε ότι τα invoice metadata αποθηκεύονται σωστά με HPOS off/on πριν το production rollout.
-
Βήμα 9
Handoff και rollback
Παραδίδουμε redacted configuration record, acceptance evidence και σαφές rollback χωρίς διαγραφή order data.
Συχνές ερωτήσεις
Λειτουργεί με Checkout Blocks;
Ναι. Το 2.1.0 εμφανίζει το πεδίο Παραστατικό και χρησιμοποιεί server-side Store API validation.
Χρειάζεται να αποκαλύψω API password στο support;
Όχι. Τα production credentials πρέπει να περνιούνται μόνο στο εξουσιοδοτημένο περιβάλλον και δεν εμφανίζονται στα screenshots.
Τα fields γράφονται σε HPOS orders;
Ναι, μέσω WooCommerce APIs. Μετά την εγκατάσταση ελέγχουμε την αποθήκευση των invoice fields σε HPOS order.
Ποια πεδία ζητούνται για Τιμολόγιο;
ΑΦΜ, ΔΟΥ, δραστηριότητα, επωνυμία και στοιχεία έδρας, ανάλογα με τη ρύθμιση και το λογιστικό requirement.
Τι κάνει το Display All Invoice Fields;
Enabled εμφανίζει όλα τα fields αμέσως· disabled τα εμφανίζει μετά το VAT validation/autofill flow.
Τι γίνεται αν ο provider δεν απαντά;
Η 39a exemption αποτυγχάνει κλειστά. Το unable to validate δεν παρουσιάζεται ως οριστικά άκυρο ΑΦΜ χωρίς διάκριση provider failure.
Μπορώ να επιλέξω όλες τις κατηγορίες για 39a;
Μόνο αν έχει εγκριθεί λογιστικά. Η τεχνική category επιλογή δεν αντικαθιστά φορολογική γνωμοδότηση.
Τι κρατάω για rollback;
Το προηγούμενο ZIP, woo_cf options και sample order metadata. Δεν διαγράφουμε ιστορικά invoice fields.