Greek Invoicing για WooCommerce: εγκατάσταση και χρήση

Τι κάνει

Το Fixit Greek Invoicing για WooCommerce στέλνει κάθε παραγγελία στο api.fixit.gr όταν πληρώνεται, αποστέλλεται, επιστρέφεται ή ακυρώνεται. Το api.fixit.gr εκδίδει το φορολογικό στοιχείο (απόδειξη ή τιμολόγιο) μέσω του παρόχου σας και επιστρέφει το αποτέλεσμα: τον αριθμό, το ΜΑΡΚ από το myDATA, τον κωδικό QR και τον σύνδεσμο του PDF. Το plugin δείχνει το αποτέλεσμα πάνω στην παραγγελία.

Το plugin δεν μιλά απευθείας με τον πάροχο και δεν αποφασίζει τη φορολογική μεταχείριση: και τα δύο τα κάνει το api.fixit.gr, με τους κανόνες της ΑΑΔΕ για κάθε παραγγελία.

Απαιτήσεις

• WordPress 6.4 ή νεότερο, WooCommerce με HPOS ή με τις κλασικές παραγγελίες.
• PHP 8.1 ή νεότερη, με την επέκταση libsodium (υπάρχει σχεδόν σε κάθε εγκατάσταση PHP).
• Για ΑΦΜ στο checkout δεν χρειάζεται άλλο plugin από την έκδοση 1.3.4: το Greek Invoicing προσθέτει «Θέλω τιμολόγιο» με ΑΦΜ και «Εύρεση εταιρείας» (στοιχεία από ΑΑΔΕ ή VIES). Αν έχετε ήδη το fixit/aade, χρησιμοποιείται εκείνο και τα δικά μας πεδία δεν εμφανίζονται.
• Ενεργή συνδρομή Greek Invoicing και το κλειδί της.
• Λογαριασμό σε πάροχο, συνδεδεμένο στις ρυθμίσεις του api.fixit.gr.

Η συνδρομή

Το πακέτο και το όριό του (Starter 40, Growth 500, Pro 3.000 παραστατικά τον μήνα) φυλάσσονται στην άδεια στο api.fixit.gr. Το plugin δεν μετρά παραστατικά και δεν μπλοκάρει καμία παραγγελία λόγω ορίου· την έκδοση τη σταματά ο server όταν εξαντληθεί το πακέτο ή λήξει η συνδρομή.

Όταν η συνδρομή λήξει, το plugin σταματά να στέλνει παραγγελίες: η σελίδα ρυθμίσεων δείχνει την άδεια ως ληγμένη και κάθε παραγγελία παίρνει σημείωση. Μόλις ανανεωθεί, το plugin συνεχίζει μέσα σε μία μέρα, ή αμέσως αν αποθηκεύσετε ξανά το κλειδί.

Το πακέτο του WooCommerce.com είναι το ίδιο plugin: η επέκταση είναι δωρεάν εκεί, τα παραστατικά τα εκδίδει η συνδρομή Greek Invoicing και το κλειδί της μπαίνει στις ρυθμίσεις όπως παρακάτω. Οι ενημερώσεις έρχονται τότε από το WooCommerce.com.

Εγκατάσταση και ρύθμιση

1. Εγκαταστήστε και ενεργοποιήστε το plugin. Το WooCommerce πρέπει να είναι ενεργό.
2. Ανοίξτε Fixit → Greek Invoicing.
3. Στην ενότητα της άδειας βάλτε το κλειδί και πατήστε Αποθήκευση και ενεργοποίηση. Η γραμμή κατάστασης γράφει Ενεργή όταν το κλειδί γίνει δεκτό για το site.
4. Ρυθμίστε τον πάροχο και τα υπόλοιπα στο πάνελ κάτω από την κεφαλίδα: είναι η σελίδα ρυθμίσεων του api.fixit.gr, με τον πάροχο, τα κλειδιά του, τις σειρές, τους κανόνες των γραμμών και τους κωδικούς πληρωμής. Μόνο εκεί ρυθμίζεται ο πάροχος.
5. Πατήστε Δοκιμή σύνδεσης: το μήνυμα γράφει Συνδέθηκε όταν το api.fixit.gr δέχεται το site.

Στο ίδιο πάνελ διαλέγετε αν το παραστατικό εκδίδεται όταν πληρώνεται η παραγγελία ή όταν αποστέλλεται.

Η δοκιμή σύνδεσης: τι σημαίνουν οι απαντήσεις

Μήνυμα	Τι σημαίνει	Τι κάνετε
Συνδέθηκε	Το κλειδί και το site γίνονται δεκτά	Τίποτα
Το κλειδί δεν αντιστοιχεί σε αυτό το site	Το κλειδί δεν είναι ενεργό για αυτό το domain	Ελέγξτε το κλειδί και τη διεύθυνση του site
Η συνδρομή έχει λήξει	Η άδεια έληξε	Ανανεώστε τη συνδρομή
Η ώρα του server διαφέρει	Η ώρα του web server απέχει πάνω από 5 λεπτά	Διορθώστε την ώρα (NTP)
Το api.fixit.gr δεν απάντησε	Δεν υπάρχει σύνδεση με το api.fixit.gr	Δοκιμάστε αργότερα· ελέγξτε ότι ο server φτάνει στο api.fixit.gr

Η οθόνη της παραγγελίας

Κάθε παραγγελία έχει πλαίσιο Greek Invoicing στη δεξιά στήλη:

• Τα παραστατικά της παραγγελίας με την κατάστασή τους: εκδόθηκε, σε αναμονή, αβέβαιο, απέτυχε, παραλείφθηκε, ακυρώθηκε. Όσα εκδόθηκαν δείχνουν αριθμό, ΜΑΡΚ και σύνδεσμο PDF.
• Επανάληψη σε παραστατικό που απέτυχε, παραλείφθηκε ή είναι αβέβαιο. Για αβέβαιο, ελέγξτε πρώτα στον πάροχο ότι δεν υπάρχει, τσεκάρετε το κουτί και μετά πατήστε Επανάληψη.
• Έκδοση τώρα: εκδίδει παραστατικό αμέσως, όποιο κι αν είναι το έναυσμα.

Οι σημειώσεις της παραγγελίας γράφουν κάθε γεγονός: πότε στάλθηκε, και πότε όχι και γιατί.

Η στήλη myDATA στη λίστα παραγγελιών

Από την έκδοση 1.3.5 η λίστα παραγγελιών (HPOS και κλασική) έχει στήλη myDATA με την κατάσταση του παραστατικού: «στάλθηκε» (κίτρινο, αναμένεται ΜΑΡΚ), «εκδόθηκε» (πράσινο), «απέτυχε» (κόκκινο), «πιστώθηκε» (μπλε), «ακυρώθηκε» (γκρι) και «δοκιμή» (πορτοκαλί) για παραστατικό δοκιμής, με το ΜΑΡΚ από κάτω, και φίλτρο ανά κατάσταση (π.χ. μόνο όσες απέτυχαν). Το plugin τη διαβάζει από το api.fixit.gr κάθε 10 λεπτά με μία κλήση, και κάθε αλλαγή γράφεται ως ιδιωτική σημείωση στην παραγγελία. Είναι το ίδιο με τις ετικέτες myDATA της εφαρμογής Shopify.

Επιστροφές και ακυρώσεις

• Επιστροφή συγκεκριμένων ειδών στο WooCommerce → πιστωτικό για αυτά τα είδη.
• Ακύρωση παραγγελίας → ακύρωση στο api.fixit.gr· αν είχε ήδη τιμολογηθεί, το παραστατικό χειρίζεται ο server κατά τους κανόνες της ΑΑΔΕ.
• Επιστροφή ως σκέτο ποσό, ή είδη μαζί με επιπλέον ποσό, στέλνεται κι αυτή: το ποσό που δεν αντιστοιχεί σε είδος ή μεταφορικά πάει ως προσαρμογή και καλύπτεται από το πιστωτικό.

Όταν το api.fixit.gr δεν απαντά

Από την έκδοση 1.3.6 το plugin ξαναδοκιμάζει μετά από 5 λεπτά και μετά διπλασιάζει την αναμονή έως 6 ώρες, για έως 30 προσπάθειες (περίπου έξι ημέρες), όπως και τα modules Magento και PrestaShop· η πρώτη αποτυχία γράφεται ως σημείωση στην παραγγελία, οι επόμενες στο αρχείο καταγραφής, και το checkout δεν καθυστερεί ποτέ. Αν αποτύχουν όλες, η παραγγελία ξαναστέλνεται με «Αποστολή παλαιότερων παραγγελιών» (παραπάνω).

Παλαιότερες ή χαμένες παραγγελίες

Στη σελίδα ρυθμίσεων του πρόσθετου, Αποστολή παλαιότερων παραγγελιών στέλνει τις πληρωμένες παραγγελίες έως 60 ημέρες πίσω, χωρίς να εκδοθεί τίποτα ακόμα: παραγγελίες από πριν την εγκατάσταση, ή όσες δεν στάλθηκαν όσο η συνδρομή είχε λήξει ή το api.fixit.gr δεν απαντούσε. Μετά, στο πάνελ ρυθμίσεων, Έκδοση όσων λείπουν (πακέτο Pro) εκδίδει όσες δεν έχουν παραστατικό· όσες έχουν ήδη, δεν πειράζονται. Στα Starter και Growth εκδίδονται μία μία από την καρτέλα «Χωρίς παραστατικό».

Στοιχεία τιμολογίου στο checkout

Στο checkout (κλασικό και blocks) ο πελάτης τσεκάρει Θέλω τιμολόγιο, διαλέγει τη χώρα του ΑΦΜ, γράφει τον ΑΦΜ και πατά Εύρεση εταιρείας: η επωνυμία, η ΔΟΥ, το επάγγελμα και η διεύθυνση συμπληρώνονται από την ΑΑΔΕ (με τους κωδικούς ειδικής πρόσβασης ΑΑΔΕ που βάζετε στο πάνελ ρυθμίσεων) ή από το VIES, και διορθώνονται με το χέρι. Η παραγγελία τότε γίνεται τιμολόγιο. Τα πεδία κλείνουν από τη σελίδα ρυθμίσεων, και δεν εμφανίζονται όταν είναι ενεργό το fixit/aade. Εξαιρέστε τη σελίδα του checkout από το cache της σελίδας, αλλιώς η αναζήτηση δεν δουλεύει.

Ο πελάτης βλέπει τα παραστατικά του

Στο «Ο λογαριασμός μου» → παραγγελία, ο πελάτης βλέπει τα εκδομένα παραστατικά της (απόδειξη, τιμολόγιο ή πιστωτικό, αριθμό, ΜΑΡΚ, PDF και QR). Τα ίδια μπαίνουν στα emails της παραγγελίας προς τον πελάτη, όταν το παραστατικό έχει ήδη εκδοθεί τη στιγμή που φεύγει το email.

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

• Δεν εμφανίζονται παραστατικά: δείτε τη γραμμή κατάστασης στη σελίδα ρυθμίσεων, τις σημειώσεις της παραγγελίας και αν το έναυσμα (πληρωμή ή αποστολή) είναι αυτό που περιμένετε.
• Τιμολόγια απορρίπτονται χωρίς ΑΦΜ: τα πεδία τιμολογίου δεν γράφτηκαν στο checkout. Ελέγξτε ότι τα πεδία τιμολογίου είναι ανοιχτά στη σελίδα ρυθμίσεων (ή ότι το fixit/aade είναι ενεργό) και ότι ο πελάτης τσέκαρε «Θέλω τιμολόγιο» με ΑΦΜ.
• Αβέβαιο παραστατικό: ο πάροχος ίσως το παρέλαβε χωρίς να φτάσει η απάντηση. Ελέγξτε πρώτα στον πάροχο, μετά Επανάληψη με τσεκαρισμένο το κουτί.
• Αρχείο καταγραφής: WooCommerce → Κατάσταση → Αρχεία καταγραφής, πηγή greek-invoicing-woocommerce. Το κλειδί δεν εμφανίζεται ποτέ εκεί.

Τι δεν κάνει ακόμα αυτή η έκδοση

• Πελάτες B2B με οντότητα αγορών (B2B company) δεν στέλνονται.