Εγχειρίδιο
Greek Invoicing για PrestaShop: εγκατάσταση και χρήση
Πώς εγκαθίσταται, πώς συνδέεται ο πάροχος, τι δείχνει η παραγγελία και τι κάνετε όταν κάτι δεν πάει καλά.
Το module στέλνει τις παραγγελίες σας στη Fixit, που εκδίδει τα παραστατικά myDATA μέσω του παρόχου που συνδέετε.
1. Ενεργοποίηση άδειας
- Στο back office ανοίξτε Fixit › Greek Invoicing.
- Επικολλήστε το κλειδί της συνδρομής και πατήστε Ενεργοποίηση.
- Η κατάσταση γράφει ενεργή με την ώρα του ελέγχου. Το κλειδί αποθηκεύεται και δεν ξαναφαίνεται· το πεδίο δείχνει τα τέσσερα τελευταία ψηφία.
Η άδεια δένεται με το domain του καταστήματος. Αν λήξει η συνδρομή, η αποστολή σταματά χωρίς να χαθεί τίποτα· όσα περίμεναν στέλνονται μετά την ανανέωση.
2. Σύνδεση παρόχου
Κάτω από την κεφαλίδα της άδειας ανοίγει η σελίδα ρυθμίσεων: εκεί διαλέγετε πάροχο, βάζετε τα στοιχεία του, τις σειρές και την αρίθμηση, και τον κανόνα για το πότε εκδίδεται παραστατικό (πληρωμή ή αποστολή). Είναι η ίδια σελίδα με τις εκδόσεις Shopify και WooCommerce. Μέχρι να συνδεθεί πάροχος, οι παραγγελίες στέλνονται αλλά δεν εκδίδεται τίποτα. Η Δοκιμή σύνδεσης ελέγχει κλειδί, domain και συνδρομή.
3. Τι γίνεται με μια παραγγελία
- Πληρωμή, αποστολή ή παράδοση και ακύρωση ενημερώνουν τη Fixit, που εφαρμόζει το έναυσμα που διαλέξατε.
- Ένα credit slip (μερική ή ολική επιστροφή) στέλνεται ως επιστροφή· το πιστωτικό εκδίδεται όπως ορίζουν οι ρυθμίσεις. Και credit slip μόνο με ποσό ή μόνο με μεταφορικά στέλνεται, ως προσαρμογή του πιστωτικού.
- Τα γεγονότα τα στέλνει το cron· μια νέα παραγγελία φτάνει κανονικά μέσα σε πέντε λεπτά.
4. Το πλαίσιο της παραγγελίας
- Η κατάσταση κάθε παραστατικού: σε αναμονή, εκδόθηκε, απέτυχε, παραλείφθηκε, αβέβαιο, ακυρώθηκε.
- Σειρά και αριθμός, ΜΑΡΚ όταν το δώσει το myDATA, σύνολο και σύνδεσμος PDF.
- Έκδοση τώρα όταν η παραγγελία δεν έχει ακόμα παραστατικό πώλησης.
- Ξανά σε παραστατικό που απέτυχε, παραλείφθηκε ή είναι αβέβαιο· για αβέβαιο, ελέγξτε πρώτα στον πάροχο.
4δ. Η στήλη myDATA στη λίστα παραγγελιών
Από την έκδοση 1.3.6 η λίστα Παραγγελίες έχει στήλη myDATA με την κατάσταση του παραστατικού: «στάλθηκε» (κίτρινο, αναμένεται ΜΑΡΚ), «εκδόθηκε» (πράσινο), «απέτυχε» (κόκκινο), «πιστώθηκε» (μπλε), «ακυρώθηκε» (γκρι) και «δοκιμή» (πορτοκαλί) για παραστατικό δοκιμής, με το ΜΑΡΚ από κάτω, και φίλτρο ανά κατάσταση. Τη διαβάζει το cron του module (ενότητα 6) από το api.fixit.gr το πολύ κάθε 10 λεπτά, και κάθε αλλαγή γράφεται ως ιδιωτικό μήνυμα στην παραγγελία, που δεν φτάνει στον πελάτη.
4α. Παλαιότερες ή χαμένες παραγγελίες
Στη σελίδα ρυθμίσεων του πρόσθετου, Αποστολή παλαιότερων παραγγελιών στέλνει τις πληρωμένες παραγγελίες έως 60 ημέρες πίσω, χωρίς να εκδοθεί τίποτα ακόμα: παραγγελίες από πριν την εγκατάσταση, ή όσες δεν στάλθηκαν όσο η συνδρομή είχε λήξει ή το api.fixit.gr δεν απαντούσε. Μετά, στο πάνελ ρυθμίσεων, Έκδοση όσων λείπουν (πακέτο Pro) εκδίδει όσες δεν έχουν παραστατικό· όσες έχουν ήδη, δεν πειράζονται. Στα Starter και Growth εκδίδονται μία μία από την καρτέλα «Χωρίς παραστατικό».
4γ. Στοιχεία τιμολογίου στο checkout
Αν η μορφή διεύθυνσης της χώρας έχει το πεδίο ΑΦΜ (vat_number), δίπλα του εμφανίζεται Εύρεση εταιρείας στο checkout και στο «Ο λογαριασμός μου → Διευθύνσεις»: η επωνυμία, και όπου είναι κενά η διεύθυνση, η πόλη και ο ΤΚ, συμπληρώνονται από την ΑΑΔΕ (με τους κωδικούς ειδικής πρόσβασης ΑΑΔΕ του πάνελ ρυθμίσεων) ή το VIES.
4β. Ο πελάτης βλέπει τα παραστατικά του
Στο ιστορικό παραγγελιών του πελάτη → λεπτομέρειες, ο πελάτης βλέπει τα εκδομένα παραστατικά (απόδειξη, τιμολόγιο ή πιστωτικό, αριθμό, ΜΑΡΚ, PDF και QR). Για τα emails, προσθέστε {fgi_documents} (ή {fgi_documents_txt} στο κείμενο) στα πρότυπα των καταστάσεων παραγγελίας που θέλετε· γεμίζει όταν το παραστατικό έχει ήδη εκδοθεί.
5. Αντιμετώπιση προβλημάτων
| Τι βλέπετε | Τι σημαίνει | Τι κάνετε |
|---|---|---|
| Άδεια μη χρησιμοποιήσιμη | Δεν γίνεται δεκτό το κλειδί ή το domain | Ελέγξτε το κλειδί και τη συνδρομή |
| «Η συνδρομή έχει λήξει» | Η άδεια έληξε | Ανανέωση· όσα περίμεναν στέλνονται μετά |
| «Δεν έχει συνδεθεί πάροχος» | Λείπουν ρυθμίσεις | Συνδέστε πάροχο στη σελίδα ρυθμίσεων |
| «Ο server της Fixit δεν απάντησε» | Δίκτυο ή διακοπή | Τίποτα δεν χάνεται· το cron ξαναδοκιμάζει |
| «Το κλειδί δεν αντιστοιχεί σε αυτό το κατάστημα» | Κλειδί άλλου domain | Βάλτε το κλειδί του domain του καταστήματος |
6. Cron
Το cron πρέπει να τρέχει κάθε λίγα λεπτά. Η διεύθυνσή του περιέχει ένα token που δημιούργησε το module στην εγκατάσταση και φαίνεται στη σελίδα διαχείρισης· κρατήστε τη ιδιωτική.