myDiesel (oil02): Ενεργοποίηση και χρήση
Σκοπός:
Το κείμενο παρουσιάζει τη δυνατότητα εξαργύρωσης κουπονιών αγροτικού πετρελαίου της ΑΑΔΕ από το Retail του Pegasus Web App.
Το module oil02 συνδέει το Pegasus Web App με το myDiesel της ΑΑΔΕ. Από το Retail ο χειριστής ελέγχει και δεσμεύει το κουπόνι του παραγωγού και το συνδέει με το τιμολόγιο της πώλησης. Όταν το τιμολόγιο πάρει ΜΑΡΚ από το myDATA, το κουπόνι εξαργυρώνεται αυτόματα στο myDiesel.
Περιεχόμενα
1. Βήματα ενεργοποίησης
Βήμα 1: Εγκατάσταση του module
- Εγκαταστήστε ή ενημερώστε το module oil02 (myDiesel) και βεβαιωθείτε ότι είναι ενεργό.
- Με την εγκατάσταση προστίθεται αυτόματα στο Retail το κουμπί ενέργειας [myDiesel: Δέσμευση ή Έλεγχος Κουπονιού]. Ελέγξτε το στο μενού [Παραμετροποίηση Retail - Εντατική Λιανική → Buttons Ενεργειών] και, αν χρειάζεται, ρυθμίστε τη θέση και το χρώμα του.
Βήμα 2: ΑΦΜ της επιχείρησης
Όλες οι κλήσεις στο myDiesel γίνονται με το ΑΦΜ της επιχείρησης:
- Χρησιμοποιείται το ΑΦΜ που έχετε ορίσει στο αντίστοιχο πεδίο στα "Στοιχεία Επιχείρησης" των Βασικών Παραμέτρων εφαρμογής.
- Αν η εγκατάσταση έχει το module Καταστήματα και η Oμάδα Kαταστημάτων του καταστήματος του παραστατικού έχει συμπληρωμένο [ΑΦΜ] (μενού [Παραμετροποίηση Καταστημάτων → Ομάδες Καταστημάτων]), χρησιμοποιείται αυτό.
Στην παραγωγή το myDiesel χρησιμοποιεί τα ίδια διαπιστευτήρια με το myDATA REST API:
- Στις Βασικές Παραμέτρους myDATA, θα πρέπει να έχετε συμπληρώσει τα πεδία "User ID στο myDATA" και "Subcription ID στο myDATA".
- Με το module Καταστήματα, αν τα καταστήματα έχουν διαφορετικό ΑΦΜ, συμπληρώστε τα ανά ομάδα καταστημάτων στην οθόνη [myDATA: Στοιχεία ανά Ομάδα Καταστημάτων] ([Όνομα Χρήστη στο myDATA], [Κωδικός API στο myDATA]).
Τα στοιχεία αυτά εκδίδονται με την εγγραφή στο myDATA REST API της ΑΑΔΕ, για το ΑΦΜ της επιχείρησης που είναι εγγεγραμμένη στο myDiesel.
Βήμα 4: Παραλαβή τύπων καυσίμων και πρατηρίων
- Εκτελέστε τον αυτοματισμό [myDiesel: Παραλαβή τύπων καυσίμων & πρατηρίων].
- Κατεβάζει τους τύπους καυσίμων που δέχεται το myDiesel στην οθόνη myDiesel: Τύποι καυσίμων, και τα στοιχεία της επιχείρησης και των πρατηρίων στην οθόνη myDiesel: Πρατήρια. Το κάνει για τον κύριο λογαριασμό και, αν υπάρχει το module Καταστήματα, για κάθε ενεργό κατάστημα.
- Στο τέλος εμφανίζει σύνοψη: πόσα προστέθηκαν ή ενημερώθηκαν, και τα σφάλματα με το μήνυμα του myDiesel.
- Ξανατρέξτε τον όταν αλλάξουν πρατήρια ή τύποι καυσίμων στο myDiesel. Οι υπάρχουσες εγγραφές ενημερώνονται και καμία δεν διαγράφεται.
Βήμα 5: Έλεγχος κωδικού καυσίμου των ειδών
Ο κωδικός καυσίμου των ειδών πρέπει να υπάρχει στην οθόνη myDiesel: Τύποι καυσίμων, π.χ. 20 ή 21. Αλλιώς το τιμολόγιο με κουπόνι δεν αποθηκεύεται.
2. Χρήση: πώληση με κουπόνι
- Στο Retail, επιλέγετε πελάτη με ΑΦΜ ίδιο με τον παραγωγό που έχει το κουπόνι. Αν δεν το κάνετε, κατά την εξαργύρωση του κουπονιού θα συμπληρωθεί αυτόματα ο πελάτης, αν ήδη υπάρχει, ή θα σας εμφανιστεί μήνυμα για να τον δημιουργήσετε.
- Σαρώστε το QR του κουπονιού στο Retail. Ανοίγει η οθόνη myDiesel: Δέσμευση ή Έλεγχος Κουπονιού με τον κωδικό συμπληρωμένο. Εναλλακτικά, πατήστε το κουμπί [myDiesel: Δέσμευση ή Έλεγχος Κουπονιού] και γράψτε τον κωδικό (μορφή
AXXX-MMDD-NNNN-NNNN-NNNN). Πεζά, κενά και ελληνικοί χαρακτήρες διορθώνονται αυτόματα. - Ελέγξτε το [Πρατήριο (ΑΜ ΔΙΚΑ)] και, με το module Καταστήματα, το [Κατάστημα], και πατήστε "Δέσμευση ή έλεγχος".
- Στα [Αποτελέσματα] εμφανίζονται η κατάσταση του κουπονιού, τα λίτρα, η λήξη, ο τύπος καυσίμου και, αν υπάρχει, προειδοποίηση χαμηλού υπολοίπου.
- Αν το κουπόνι μπορεί να εξαργυρωθεί, πατήστε "Εξαργύρωση κουπονιού". Το κουπόνι συνδέεται με το τρέχον παραστατικό. Αν υπάρχει ήδη πελάτης με το ανάλογο ΑΦΜ, επιλέγεται αυτόματα αν δεν έχει επιλεγεί ήδη. Αν δεν υπάρχει, εμφανίζεται ανάλογη ειδοποίηση, καθώς δεν θα είναι δυνατή η αποστολή του παραστατικού αν τα ΑΦΜ πελάτη-κουπονιού δεν είναι ίδια.
- Καταχωρήστε το καύσιμο, έως τα λίτρα του κουπονιού, και αποθηκεύστε. Γίνονται οι έλεγχοι της ενότητας 3.
- Στείλτε το τιμολόγιο στο myDATA, απευθείας ή μέσω παρόχου. Μόλις πάρει ΜΑΡΚ, το κουπόνι εξαργυρώνεται αυτόματα και το αποτέλεσμα εμφανίζεται κάτω από το μήνυμα της αποστολής.
Κουμπιά της οθόνης myDiesel: Δέσμευση ή Έλεγχος Κουπονιού
- Δέσμευση ή έλεγχος: Ελέγχει το κουπόνι στο myDiesel και το δεσμεύει, αν είναι ενεργό.
- Εξαργύρωση κουπονιού: Εφόσον έχετε δεσμεύσει το κουπόνι, το συνδέει με το τρέχον παραστατικό, και μόλις το παραστατικό πάρει ΜΑΡΚ, θα εξαργυρωθεί αυτόματα στο myDiesel.
- Εξαργύρωση σε υπάρχον παραστατικό: Ανοίγει την οθόνη myDiesel: Επιλογή τιμολογίου με τα τιμολόγια 1.1 που έχουν ΜΑΡΚ και είδη καυσίμου. Με την επιλογή, το κουπόνι εξαργυρώνεται αμέσως.
- Αποδέσμευση κουπονιού: Αποδεσμεύει το κουπόνι στο myDiesel.
- Κλείσιμο: Κλείνει την οθόνη. Αν έχετε δεσμεύσει ένα κουπόνι, παραμένει δεσμευμένο.
Κουπόνι ήδη συνδεδεμένο
Αν το παραστατικό έχει ήδη κουπόνι σε αναμονή, η οθόνη το δείχνει στο άνοιγμα, με τα λίτρα του. Ο σύνδεσμος «εδώ» του μηνύματος ακυρώνει μόνο τη σύνδεση στο Pegasus Web App. Το κουπόνι στο myDiesel μένει όπως είναι. Κάθε παραστατικό έχει ένα κουπόνι και κάθε κουπόνι ένα παραστατικό.
Ακύρωση εξαργύρωσης δεν υπάρχει στο myDiesel. Μετά την εξαργύρωση το κουπόνι δεν επιστρέφει.
3. Έλεγχοι στην αποθήκευση του τιμολογίου
Όταν το παραστατικό έχει κουπόνι σε αναμονή εξαργύρωσης, στην αποθήκευση γίνονται οι παρακάτω έλεγχοι. Τα μηνύματα αναφέρουν ότι οφείλονται στη σύνδεση με το κουπόνι.
Δεν επιτρέπεται η αποθήκευση όταν:
- το myDATA παραστατικό προς αποστολή δεν είναι Τιμολόγιο Πώλησης (1.1),
- κάποιο είδος δεν έχει κωδικό καυσίμου,
- κάποιο είδος έχει κωδικό καυσίμου που δεν υπάρχει στο myDiesel: Τύποι καυσίμων,
- το ΑΦΜ του παραγωγού του κουπονιού είναι διαφορετικό από το ΑΦΜ του πελάτη.
Ζητείται επιβεβαίωση όταν:
- η ποσότητα καυσίμου ξεπερνά τα λίτρα του κουπονιού,
- κάποιο είδος έχει ΕΦΚ,
- το κατάστημα του παραστατικού είναι διαφορετικό από το κατάστημα του κουπονιού (με το module Καταστήματα),
- η αξία της αντλίας είναι ίδια με τη συνολική αξία του είδους (με το module oil01). Πιθανώς χρησιμοποιήθηκε [Προσθήκη Είδους] αντί για [Προσθήκη Είδους χωρίς Ε.Φ.Κ.].
4. Οθόνες παρακολούθησης
- myDiesel: Κινήσεις κουπονιών: Κάθε κλήση προς το myDiesel (έλεγχος, εξαργύρωση, αποδέσμευση), επιτυχημένη ή όχι, με χρήστη, ώρα, απάντηση και παραστατικό. Είναι το πρώτο σημείο που κοιτάτε όταν κάτι δεν πήγε καλά. Τα κουπόνια που περιμένουν εξαργύρωση έχουν τσεκαρισμένο το "Εκκρεμεί εξαργύρωση".
- myDiesel: Τύποι καυσίμων: Οι τύποι καυσίμων και οι κωδικοί ΑΑΔΕ που δέχεται το myDiesel. Μόνο για ανάγνωση.
- myDiesel: Πρατήρια: Η επιχείρηση και τα πρατήριά της, με το ΑΜ ΔΙΚΑ. Μόνο για ανάγνωση.
5. Καταστάσεις κουπονιού
- ACTIVE: Ενεργό, δεν έχει δεσμευτεί.
- RESERVED: Δεσμευμένο στο πρατήριό σας.
- REDEEMED: Εξαργυρωμένο.
- VERIFIED: Επαληθευμένο από την ΑΑΔΕ.
- EXPIRED: Ληγμένο (πέρασαν 5 ώρες από την έκδοση χωρίς εξαργύρωση)
- CANCELLED: Ακυρωμένο.