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

Το Greek Invoicing στέλνει ό,τι συμβαίνει σε κάθε παραγγελία (πληρωμή, αποστολή, επιστροφή, ακύρωση) στον server της Fixit, που εκδίδει την απόδειξη ή το τιμολόγιο myDATA μέσω του παρόχου σας. Το κατάστημα δεν μιλά ποτέ απευθείας με τον πάροχο και τα στοιχεία πρόσβασης του παρόχου δεν αποθηκεύονται ποτέ στο κατάστημα.

Απαιτήσεις

• Magento 2.4.x με το module και το fixit/base.
• Ενεργή συνδρομή Greek Invoicing για το domain του καταστήματος.
• Πάροχο συνδεδεμένο στη σελίδα ρυθμίσεων του Greek Invoicing (εκεί ρυθμίζεται, όχι στο κατάστημα).
• Το cron του καταστήματος να τρέχει κάθε λεπτό.

Η συνδρομή

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

Ρυθμίσεις

Stores › Configuration › Fixit › Greek Invoicing (μία ενότητα ανά website):

Το κλειδί δεν μπαίνει εδώ: μπαίνει μία φορά στο Fixit › Base › Licences, με ενεργό το domain. Στην έκδοση του Adobe Commerce Marketplace το πεδίο Subscription key εμφανίζεται σε αυτή την ενότητα.

Πρώτη ρύθμιση

1. Ελέγξτε στο Fixit › Base › Licences ότι η άδεια είναι ενεργή για το domain.
2. Ανοίξτε Stores › Configuration › Fixit › Greek Invoicing και διαλέξτε website.
3. Πατήστε Test connection: αναμένεται «Connected».
4. Τσεκάρετε Send order events και αποθηκεύστε.
5. Στο Fixit › Greek Invoicing ορίστε πάροχο, σειρές, έναυσμα (πληρωμή ή αποστολή) και στοιχεία εκδότη.

Παραστατικά πάνω στην παραγγελία

Το πλαίσιο Greek Invoicing κάτω από την παραγγελία δείχνει για κάθε παραστατικό τύπο (πώληση ή πιστωτικό, με τον τύπο myDATA), κατάσταση (σε αναμονή, εκδόθηκε, απέτυχε, παραλείφθηκε, αβέβαιο, ακυρώθηκε), σειρά και αριθμό, ΜΑΡΚ, PDF και, αν απέτυχε, τον λόγο. Πάνω από τον πίνακα φαίνεται πόσα γεγονότα της παραγγελίας περιμένουν τον server.

• Issue now: εκδίδει το παραστατικό αμέσως, όποιο κι αν είναι το έναυσμα, αφού η παραγγελία έχει φτάσει στον server.
• Try again: ξαναστέλνει παραστατικό που απέτυχε, παραλείφθηκε ή είναι αβέβαιο. Για αβέβαιο, ελέγξτε πρώτα στη λίστα του παρόχου, αλλιώς μπορεί να βγει διπλό.

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

Από την έκδοση 1.3.6 το Sales → Orders έχει στήλη myDATA με την κατάσταση του παραστατικού: «στάλθηκε» (κίτρινο, αναμένεται ΜΑΡΚ), «εκδόθηκε» (πράσινο), «απέτυχε» (κόκκινο), «πιστώθηκε» (μπλε), «ακυρώθηκε» (γκρι) και «δοκιμή» (πορτοκαλί) για παραστατικό δοκιμής, με το ΜΑΡΚ από κάτω, και φίλτρο ανά κατάσταση. Το cron τη διαβάζει από το api.fixit.gr κάθε 10 λεπτά, ανά website, και κάθε αλλαγή γράφεται ως σχόλιο στο ιστορικό της παραγγελίας, χωρίς ειδοποίηση του πελάτη. Μετά την αναβάθμιση τρέξτε bin/magento setup:upgrade για τις νέες στήλες.

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

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

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

Με ενεργό το «Show VAT Number on Storefront» του Magento, δίπλα στο πεδίο ΑΦΜ της διεύθυνσης (checkout Luma και «Ο λογαριασμός μου → Διευθύνσεις») εμφανίζεται Εύρεση εταιρείας: η επωνυμία, και όπου είναι κενά η οδός, η πόλη και ο ΤΚ, συμπληρώνονται από την ΑΑΔΕ (με τους κωδικούς ειδικής πρόσβασης ΑΑΔΕ του πάνελ ρυθμίσεων) ή το VIES. Σε θέμα Hyvä με το Luma checkout (πακέτο hyva-themes/magento2-luma-checkout) το checkout είναι το ίδιο και η Εύρεση εταιρείας εμφανίζεται· το εμπορικό Hyvä Checkout και η φόρμα διευθύνσεων του λογαριασμού στο θέμα Hyvä δεν καλύπτονται ακόμα.

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

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

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

Απεγκατάσταση

Κλείστε πρώτα το Send order events. Όσα παραστατικά εκδόθηκαν μένουν στον πάροχο και στο myDATA, όπως ορίζει ο νόμος· απενεργοποιήστε το domain της άδειας στο Fixit › Base › Licences όταν το κατάστημα σταματήσει να χρησιμοποιεί τον connector.