Εισαγωγή
Σκοπός αυτού του κειμένου είναι να περιγράψει απλά και σύντομα την παραμετροποίηση της λειτουργικότητας του Fuel Outflows Management (Token 990) για την διασύνδεση συστημάτων εισροών-εκροών τρίτων κατασκευαστών.
Προϋπόθεση για την απρόσκοπτη εκτέλεση των καθημερινών λειτουργιών αλλά και για την κατανόηση του παρόντος κειμένου είναι:
- Η γνώση του περιβάλλοντος και του τρόπου χρήσης της εφαρμογής.
- Η εκτέλεση όλων των απαραίτητων ενεργειών εκκίνησης.
- Το σωστό στήσιμο του εξοπλισμού.
To Fuel Outflows Management , χρησιμοποιεί 2 τρόπους σύνδεσης. Ο ένας τρόπος αφορά την πρόσβαση στην βάση δεδομένων σε πηγή δεδομένων ή σε views ή σε options που λαμβάνουμε από τον κατασκευαστή του εισροών εκροών. Ο άλλος τρόπος αφορά την πρόσβαση σε κατάλογο με txt αρχεία με περιεχόμενο την κάθε απόδειξη λιανικής.
Παραμετροποίηση
Απαραίτητη προϋπόθεση είναι να έχει ενεργοποιηθεί το module Fuel Outflows Management (Token 990).
Pylon Configurator
Για την λειτουργία του Fuel Outflows Management πρέπει να ενεργοποιήσετε το Extension Fuel Outflows Management στον Poseidon.Configurator
Γίνεται επανεκκίνηση του Application server για να δημιουργηθεί στα Deamons Configuration το αρχείο FuelOutflowsManagerService.config, όπου το ενεργοποιείτε, αλλάζοντας το ‘ <Active>’ από ‘false’ σε ‘true’.
<Active>true</Active>
Επιπλέον θα χρειαστεί να δηλωθούν:
- Server Address
<JsonServerAddress>http://localhost:7002/hercjson</JsonServerAddress>
- Application Name
<ApplicationName>Hercules.MyPylonCommercial</ApplicationName>
- DatabaseAlias της βάσης του Pylon
<DatabaseAlias>Pylon</DatabaseAlias>
- Το Username και Password εισαγωγής στην βάση του Pylon
- Εταιρία και Υποκατάστημα / Αποθήκη
Επίσης θα πρέπει να δημιουργηθεί στα Deamons Configuration το αρχείο Ηercules Json Service όπου στο αρχείο Ηercules Json Service.config θα οριστεί η τιμή από ‘false’ σε ‘true’.
<Active>true</Active>
Παραμετροποίηση Pylon
Προτού προβείτε στην Σύνδεση του Fuel Outflows Management θα χρειαστεί να εξασφαλίσετε ότι η παραμετροποίηση pylon έχει πραγματοποιηθεί σωστά στα παρακάτω σημεία:
Σειρά Παραστατικού:
Θα πρέπει να δημιουργηθεί μια ΝΕΑ σειρά για την Απόδειξη Λιανικής του Fuel Outflows Management και να μην χρησιμοποιηθούν οι υφιστάμενες πρότυπες σειρές.
Στην νέα σειρά της Απόδειξης Λιανικής (Χειρόγραφη) που θα δημιουργήσετε, απαραίτητο είναι να ορίσετε την σειρά ως Χειρόγραφη με την ακόλουθη παραμετροποίηση:
Σημείωση: Στο πεδίο της Συντόμευσης θα πρέπει να ορίσετε την συντόμευση που υπάρχει στην βάση του εισροών – εκροών που θα συνδέσετε το Pylon μέσω του Fuel Outflows Management και η οποία διαφέρει σε κάθε εγκατάσταση.
Στην συγκεκριμένη σειρά Απόδειξης Λιανικής Station Manager που θα δημιουργήσετε ως χειρόγραφη θα πρέπει να συνδέσετε την αντίστοιχη ΝΕΑ Ακυρωτική Σειρά που θα αφορά την Απόδειξη Λιανικής του Fuel Outflows Management καθώς επίσης και την Σειρά Είσπραξης Πελάτη για τα μετρητά.
Πελάτης Λιανικής:
Θα πρέπει να δημιουργήσετε έναν Νέο ΠΕΛΑΤΗ ΛΙΑΝΙΚΗΣ για το Outflows Management.
Είδος:
Από την διαδρομή Οργάνωση → Εμπορικό → Αποθήκη → Παραμετροποίηση είδους Στο πεδίο “Πεδίο Κωδικός Καυσίμου” δηλώνετε το πεδίο το οποίο θα διαβάζει τον κωδικό καυσίμου για την ΑΑΔΕ.
Πχ. το 5ο Αλφαριθμητικό πεδίο που αφορά πεδίο χρήστη στο Tab: Πεδία Χρήστη στην κάρτα του είδους:
Στην οντότητα του Είδους καυσίμου θα πρέπει να έχουν καταχωρηθεί τα παρακάτω:
Στο tab: Βασικά Στοιχεία
Μονάδα Μέτρησης → Λίτρα
Έλεγχος Υπολοίπου → Όχι
Στο tab: Πολιτική Τιμολόγησης
Καταχώρηση Τιμών Λιανικής, Χονδρικής ,όπου απαιτείται.
Υπολογισμός από Αξία → Υπολογισμός Ποσότητας
Στο tab: Πεδία Χρήστη
Να δηλωθεί ο κωδικός καυσίμου στο πεδίο χρήστη το οποίο έχει οριστεί στην Παραμετροποίηση είδους. Εάν για παράδειγμα στην Παραμετροποίηση είδους έχει οριστεί ως “πεδίο Κωδικό Καυσίμου” το 5ο αλφαριθμητικό πεδίο, τότε ο κωδικός καυσίμου Taxisnet θα καταχωρηθεί στο Κείμενο 5 στo tab: Πεδία Χρήστη.
Στο tab: Πρόσθετα/2
Να δηλωθεί ο κωδικός καυσίμου για Mydata και Πάροχο.
Στο tab: Fuel Outflows
Στο πεδίο “Κωδικός Προϊόντος” να δηλωθεί το πεδίο δεσίματος, δηλαδή ο κωδικός με τον οποίο θα γίνει το mapping μεταξύ του είδους καυσίμου του εισροών-εκροών με το είδος καυσίμου του Pylon.
Συμπληρώνετε την ίδια τιμή που δηλώσατε στο Πεδίο χρήστη στο προηγούμενο βήμα.
Μέσα Μεταφοράς:
Μπορούν να καταχωρηθούν από το μενού Οργάνωση → Υποδομή → Μεταφορικά Μέσα.
Παραμετροποίηση Σύνδεσης με Βάση Δεδομένων
Για να παραμετροποιήσετε την σύνδεση με Βάση, ακολουθείτε στο μενού την διαδρομή Οργάνωση → Fuel Outflows → Fuel Import Setup.
Παρακάτω δίνεται ενδεικτικό παράδειγμα σύνδεσης με βάση δεδομένων:
Στο view μπορείτε να έχετε :
- Μοναδικό id
- Ημερομηνία Παραστατικού
- Σειρά
- Πρόθεμα – Συντόμευση Σειράς
- Κωδικό Καυσίμου
- Ποσότητα
- Σύνολο
- Αξία
- Ποσοστό Φ.Π.Α
- Vol 15 βαθμό
- Σημείο - Αντλία
- Id από Πιστόλι
- Δεξαμενή
- Τιμή πώλησης
- ΑΦΜ Πελάτη
- Αριθμό Πινακίδας
- Έτος
Παραμετροποίηση Fuel Outflows Management στο Pylon:
Στο tab: Γενικές Επιλογές :
Στο πεδίο “Τύπος Εισαγωγής” επιλέγετε την τιμή: Βάση Δεδομένων.
Στο πεδίο “Σειρά Παραστατικού” επιλέγετε την Απόδειξη Λιανικής (Χειρόγραφη ) που έχετε δημιουργήσει για την διασύνδεση με το εισροών – εκροών.
Στο πεδίο “Τρόπο πληρωμής” επιλέγετε την τιμή Μετρητά
Στο πεδίο “Πελάτης” επιλέγετε τον νέο πελάτη λιανική που έχετε δημιουργήσει σε προηγούμενο βήμα.
Για σύνδεση με SQL Server, στο πεδίο “Τύπο Βάσης Δεδομένων” επιλέγετε SQL Server και δηλώνετε τα στοιχεία σύνδεσης του SQL Server Connection:
Συμπληρώνετε το query ανάλογα με τις διαθέσιμες πληροφορίες που λαμβάνονται από την βάση δεδομένων του εισροών – εκροών.
Σύμφωνα με τα πεδία που υπάρχουν διαθέσιμα στο view από την Βάση δεδομένων , στο tab: Import Fields / Mappings, παραμετροποιείτε το Fuel Import Setup προκειμένου να γίνει το Mapping με το Pylon
Τα πεδία που εμφανίζονται στην στήλη Όνομα Πεδίου , είναι προκαθορισμένα πεδία τα οποία εμφανίζονται πάντοτε.
Σύμφωνα με το παράδειγμα , αντιστοιχίζετε τα προκαθορισμένα πεδία δηλώνοντας στην στήλη Mapped τα διαθέσιμα πεδία της βάσης δεδομένων.
Το Mapping εκτελείται για τα πεδία του select και κάποια πεδία έρχονται από προτεινόμενες τιμές (Σειρά Παραστατικού, Τρόπος Πληρωμής, Πελάτης Λιανικής, πεδία που έχουν ήδη δηλωθεί στο tab: Γενικές επιλογές)
Στην παραμετροποίηση του Fuel Import οι διαθέσιμες Ενέργειες λειτουργούν ως εξής:
- Ενέργειες → Load Default Values
Η συγκεκριμένη ενέργεια διαγράφει ότι έχει δηλωθεί στο Mapping και επαναφέρει τις αρχικές τιμές:
- Ενέργειες → Import Logs
Στην συγκεκριμένη ενέργεια διατηρούνται τα μηνύματα λαθών καθώς και μηνύματα προειδοποιήσεων.
- Ενέργειες → Last Database Synchronization
Η συγκεκριμένη ενέργεια διατηρεί για κάθε παραστατικό που αποθηκεύεται την ημερομηνία και τον αριθμό του, ώστε να μην υπάρξει διπλή καταχώριση.
- Ενέργειες → Εισαγωγή
Εκτελώντας την συγκεκριμένη ενέργεια, εκτελείται η εισαγωγή των αποδείξεων από το εισροών – εκροών στα παραστατικά πωλήσεων του Pylon.
Σε κάθε παραστατικό , στο Tab: Fuel Outflows , υπάρχουν οι επιπλέον πληροφορίες που αφορούν το Fuel Outflows Management, όπως η Δεξαμενή (Tank id) ,η Αντλία (Fuel Poin Number) ,η Βάρδια (User Shift Number) ,η Ημερομηνία Βάρδιας (Shift Date Number)
Διαπιστώνεται ότι στην Ενέργεια → Last Database Synchronization, εμφανίζεται η ημερομηνία της απόδειξης και ο τελευταίος Αριθμός Παραστατικού που έγινε η εισαγωγή στο Pylon.
Στο Last Database Synchronization κρατείται η τελευταία εισηγμένη απόδειξη οπότε σε περίπτωση που υπάρχει η ανάγκη διαγραφής των αποδείξεων λόγω λάθους και η εκ νέου εισαγωγή των αποδείξεων ,θα πρέπει να δηλωθεί το 0 στον Αριθμό Παραλαβής ώστε να ξαναγίνει η εισαγωγή των αποδείξεων.
Παραμετροποίηση Σύνδεσης με Αρχείο
Για να παραμετροποιήσετε την σύνδεση με Αρχείο, ακολουθείτε την διαδρομή Οργάνωση → Fuel Outflows → Fuel Import Setup.
Στο tab: Γενικές Επιλογές , στο πεδίο “Τύπος Εισαγωγής” επιλέγουμε την τιμή Κείμενο.
Στο πεδίο “Σειρά Παραστατικού” επιλέγετε την Απόδειξη Λιανικής (Χειρόγραφη ) που έχετε δημιουργήσει για την διασύνδεση με το εισροών – εκροών.
Στο πεδίο “Τρόπο πληρωμής” επιλέγετε Μετρητά
Στο πεδίο “Πελάτης” τον νέο πελάτη λιανικής που έχετε δημιουργήσει σε προηγούμενο βήμα.
Στο group Text Options:
Στο πεδίο “Import Path” ορίζετε την διαδρομή αποθήκευσης των αρχείων των αποδείξεων.
Στο πεδίο “DatetimeFormat” ορίζετε το format της ημερομηνίας του αρχείου της απόδειξης.
Στα πεδία “Decimal With Comma” και “Διαχωριστικό” δηλώνεται o τρόπος των Separator fields.
Eνδεικτικό παράδειγμα σύνδεσης με αρχείο:
Από εργαλείο το οποίο αναπτύχθηκε σε σύστημα εισροών-εκροών τρίτου κατασκευαστή που εξάγει τις αποδείξεις σε αρχείο.txt ώστε να εισαχθούν στο pylon με τύπο εισαγωγής κείμενο. Έχει ορισθεί ότι κάθε φορά που δημιουργείται η απόδειξη θα αποθηκεύεται στο επιλεγμένο Path με την επιλεγμένη ονομασία και η απόδειξη θα περιέχει τα παρακάτω επιλεγμένα πεδία.
Παράδειγμα εξαγωγής απόδειξης αρχείου .txt
Σύμφωνα με τα πεδία που υπάρχουν στα προκαθορισμένα πεδία του Pylon, εκτελείται η αντιστοίχιση με τα λιγότερα διαθέσιμα πεδία που ζητάει το Pylon από το αρχείο.txt .
Στο tab: Import Fields / Mappings, παραμετροποιείτε το Fuel Import Setup προκειμένου να γίνει το Mapping με το Pylon:
To Mapping εκτελείται για τα πεδία που έχουν δηλωθεί.
Τα πεδία “Σειρά Παραστατικού”, “Τρόπος Πληρωμής”, “Πελάτης Λιανικής” έρχονται από τις προτεινόμενες τιμές στο tab: Γενικές επιλογές.
Στη παραμετροποίηση του Fuel Import οι διαθέσιμες Ενέργειες λειτουργούν ως εξής:
- Ενέργειες → Load Default Values
Η συγκεκριμένη ενέργεια, διαγράφει ότι έχει δηλωθεί στο Mapping και επαναφέρει τις αρχικές τιμές:
- Ενέργειες → Import Logs
Στην συγκεκριμένη ενέργεια διατηρούνται τα μηνύματα λαθών καθώς και μηνύματα προειδοποιήσεων
- Ενέργειες → Εισαγωγή
Εκτελώντας την συγκεκριμένη ενέργεια, εκτελείται η εισαγωγή των αποδείξεων από το εισροών – εκροών στα παραστατικά πωλήσεων του Pylon.
Κατά την Εισαγωγή των αποδείξεων, τα αρχεία txt εξαφανίζονται από το δηλωμένο Import Path όπου ήταν προηγουμένως αποθηκευμένα.
Σε κάθε παραστατικό , στο Tab Fuel Outflows , υπάρχουν οι επιπλέον πληροφορίες που αφορούν το Fuel Outflows Management, όπως η Δεξαμενή (Tank id) ,η Αντλία (Fuel Poin Number) ,η Βάρδια (User Shift Number) και η Ημερομηνία Βάρδιας (Shift Date Number).
