Σκοπός: Η μελέτη αυτή παρουσιάζει τις απαραίτητες ρυθμίσεις για την επικοινωνία της εφαρμογής Pegasus Oil ERP με Κονσόλα, μετά την αλλαγή της νομοθεσίας για τη λειτουργία συστημάτων εισροών - εκροών. 

Εργαλεία:

1. Η εφαρμογή Pegasus Oil ERP. Για να λειτουργήσουν οι μέθοδοι θα πρέπει να διαθέτετε την αναβάθμιση R0001.0016 του Module Pegasus Oil ή μεταγενέστερη.
2. Η κονσόλα της εταιρείας.
3. Το αρχείο της εταιρείας της κονσόλας με την αντιστοίχιση των πεδίων (το δημιουργεί η αντίστοιχη εταιρεία).

Λειτουργία:

H εφαρμογή Pegasus Oil επικοινωνεί με την κoνσόλα κάθε εταρείας διαβάζοντας τα αρχεία αποδείξεων που αυτή δημιουργεί για κάθε κίνηση που γίνεται. Δείγμα αρχείων για κάθε εταιρεία θα βρείτε στον υποφάκελο import στη διαδρομή  ..\oil\console_lib\std.

Η εφαρμογή για κάθε αρχείο απόδειξης που βρίσκει κάνει την ανάλογη καταχώρηση στον πίνακα των Κινήσεων Αντλιών. Αν η απόδειξη αφορά στην τρέχουσα ημερομηνία, έχει πληροφορία πελάτη (το ΑΦΜ ή τον αριθμό κυκλοφορίας που είναι συνδεδεμένος με το ΑΦΜ του) και ο πελάτης είναι καταχωρημένος τότε εκδίδει άμεσα απόδειξη.

Ρυθμίσεις:

1. Από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίηση Oil -> Βασικές Παράμετροι Oil] και στο tab [Κονσόλα] ορίζετε τις κατάλληλες μεθόδους για την επικοινωνία της εφαρμογής με την κονσόλα.

Φάκελος Μεθόδων Επικοινωνίας Κονσόλας: Επιλέγετε τον φάκελο της μεθόδου που ταιριάζει στην κονσόλα σας. 

Πελάτης και Παραστατικό Πώλησης: Είναι ο πελάτης και το είδος του παραστατικού που θα επιλέξει η εφαρμογή για την έκδοση του παραστατικού πώλησης από μία κίνηση αντλίας. Αν έχετε ορίσει παραστατικό, τότε η διαδικασία ανάγνωσης κινήσεων από την αντλία, αν υπάρχει ο πελάτης που περιέχει η κίνηση, εκδίδει αυτόματα το παραστατικό.

Πελάτης και Παραστατικό Επιστροφής: Είναι ο πελάτης και το είδος του παραστατικού που θα επιλέξει η εφαρμογή για την έκδοση του παραστατικού επιστροφής από μία κίνηση αντλίας. Αν έχετε ορίσει παραστατικό και πελάτη, τότε η διαδικασία ανάγνωσης κινήσεων από την αντλία αν καταχωρήσει παραστατικό πώλησης θα καταχωρήσει και το παραστατικό επιστροφής, αυτόματα.

Για τον σωστό τρόπο είσπραξης στο παραστατικό επιστροφής θα πρέπει να ορίσετε στους τρόπους είσπραξης της κονσόλας, τον αντίστοιχο για την επιστροφή (π.χ. στο Μετρητά, στην επιστροφή θα πρέπει να ορίσετε το Επιστροφή Μετρητών). Δείτε τις οδηγίες παρακάτω.

Τα στοιχεία αυτά χρησιμοποιούνται και στην περίπτωση που έχετε ορίσει [Τύπους Ειδών Καυσίμων για Αυτόματη Επιστροφή] από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίηση Oil -> Βασικές Παράμετροι Oil] και στο tab [Reception], αν δεν έχετε σύνδεση με την κονσόλα.

Σημείωση: Στην Μέθοδο [360005: Καταχώρηση Απόδειξης] της Reception, μπορείτε να ορίσετε αν το παραστατικό [Επιστροφής] θα εμφανίζει οθόνη καταχώρησης ή αν θα καταχωρείται/τυπώνεται χωρίς οθόνη.

Παραστατικά για τα οποία καταχωρείται αυτόματα επιστροφή : Μπορείτε να ορίσετε για ποιά παραστατικά η εφαρμογή θα καταχωρεί αυτόματα το παραστατικό επιστροφής (τόσο από την τιμολόγηση κίνησης αντλίας όσο και από την reception βάση Τύπου είδους). Αν το αφήσετε κενό τότε τυπώνει για όλα την επιστροφή.

Μαζικό Παραστατικό: Το παραστατικό που θα χρησιμοποιεί η εφαρμογή για την καταχώρηση της μαζικής απόδειξης από τις κινήσεις των αντλιών.

Αυτόματα Παραστατικά Εκδίδονται για Κινήσεις μετά την : Επειδή μπορεί το σύστημά σας να έχει παλαιότερες κινήσεις αντλιών από την κονσόλα, από την ημέρα που θέλετε να αρχίσουν να εκδίδονται αυτόματα οι αποδείξεις σε Ταμειακή, ορίζετε εδώ την ημέρα την οποία θέλετε να ξεκινήσει η εκτύπωση. Αν αφήσετε κενή την ημερομηνία, τότε εκδίδονται αποδείξεις μόνο για την τρέχουσα ημέρα.

2. Από την επιλογή [Βάσεις Δεδομένων -> Πρατήριο Καυσίμων -> Επικοινωνία με Κονσόλα] θα πρέπει πλέον να ενεργοποιείται η ανάλογη οθόνη, με βάση την κονσόλα που διαθέτετε.

 

Από εδώ και από την επιλογή [Βασικές Παράμετροι Κονσόλας] θα ορίσετε είτε το odbc connection string για την σύνδεση στην Βάση MySQL που αποθηκεύονται οι κινήσεις της αντλίας, είτε τον φάκελο στον οποίο θα ψάχνει η εφαρμογή τα αρχεία που παράγει η κονσόλα για κάθε απόδειξη που εκδίδει, ανάλογα με την κονσόλα που χρησιμοποιείτε.

Η κάθε κονσόλα έχει τις δικές τις ρυθμίσεις. Ανατρέξτε στην αντίστοιχη μελέτη με βάση την κονσόλα σας: https://www.tesae.gr/articles/protipes-meletes-i-efarmoges/pegasus-ke-pratiria-igron-kafsimon.html

ΠΡΟΣΟΧΗ: Στην δεύτερη περίπτωση (ορισμός φακέλου), επειδή η εφαρμογή διαβάζοντας μία απόδειξη διαγράφει το αρχέιο και το αποθηκεύει σε υποφάκελο (διαφορετικό ανά ημέρα), θα πρέπει ο φάκελος στον οποίο αποθηκεύονται τα αρχεία της κονσόλας να είναι διαμοιρασμένος και με πλήρη δικαιώματα από το pc που τρέχει την εφαρμογή Pegasus.

Από την επιλογή [Βασικές Παράμετροι Pegasus] ορίζετε τις βασικές παραμέτρους ενημέρωσης του Pegasus ERP. 

Έλεγχος Ύπαρξης Απόδειξης: Αν ορίσετε ΝΑΙ, πριν την καταχώρηση μίας νέας απόδειξης, το πρόγραμμα ελέγχει αν υπάρχει καταχώρηση με τον ίδιο MK Κονσόλας και ίδια ημερομηνία. Αν υπάρχει δεν κάνει την καταχώρηση.

Αυτόματη Εκδοση Παραστατικού: Αν ορίσετε την αυτόματη έκδοση, τότε αν:
α. η κίνηση της αντλίας έχει στοιχεία πελάτη,
β. έχετε ορίσει στην επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίηση Oil -> Βασικές Παράμετροι Oil] και στο tab [Κονσόλα] ή στον πελάτη, το παραστατικό που θα εκδίδει η εφαρμογή,
κατά την καταχώρηση της κίνησης στην εφαρμογή εκδίδεται και αυτόματα το ανάλογο παραστατικό.

Εκδοση Παραστατικού σε νέο Παράθυρο: Η έκδοση του παραστατικού μπορεί να γίνεται σε νέο παράθυρο για να μην καθυστερεί το service για την επόμενη εύρεση.

Ενημέρωση Log File: Αν ορίσετε ΝΑΙ, τότε αποθηκεύει μηνύματα για την εκτέλεση της επικοινωνίας στο αρχείο output\log_files\oil_service.log (στο φάκελο της εφαρμογής).

Μέθοδος εκτέλεσης Μετά την Καταχώρηση: Είναι μία μέθοδος η οποία εκτελείται μετά την καταχώρηση μίας κίνησης στις Κινήσεις Αντλιών.
Καλείται με την callfpeg(, {oila23.nr01}), οποτε θα πρέπει να έχει υλοποιηθεί ανάλογα.

Μέθοδος εκτέλεσης Μετά την Εκτύπωση Παραστατικού: Είναι μία μέθοδος η οποία εκτελείται μετά την εκτύπωση παραστατικού για μία κίνηση.
Καλείται με την callfpeg(, {oila23.nr01}), οποτε θα πρέπει να έχει υλοποιηθεί ανάλογα.

Πριν την έναρξη της επικοινωνίας θα πρέπει να ορίσετε τους κωδικούς καυσίμων που χρησιμοποιεί η κονσόλα σας και να τους αντιστοιχίσετε με τους ανάλογους κωδικούς ειδών.

Από την παραπάνω οθόνη [Επικοινωνία με Κονσόλα] και την επιλογή [Κωδικοί Καυσίμων Κονσόλας] ή από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίηση Oil -> Κωδικοί Καυσίμων Κονσόλας] ορίζετε τους κωδικούς των καυσίμων όπως είναι καταχωρημένοι στην Κονσόλα. Για κάθε έναν κωδικό δίνετε και τον αντίστοιχο κωδικό της αποθήκης, ώστε να συνδέονται οι κινήσεις τους.

Αντίστοιχα, αν η κονσόλα διαθέτει Τρόπους Είσπραξης, τότε θα πρέπει να ορίσετε τους τρόπους είσπραξης που χρησιμοποιεί η κονσόλα σας και να τους αντιστοιχίσετε με τους ανάλογους τρόπους είσπραξης που διαθέτει η εφαρμογή. Από την επιλογή [Κωδικοί Τρόπων Είσπραξης Κονσόλας] ή από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίηση Oil -> Κωδικοί Τρόπων Είσπραξης Κονσόλας] ορίζετε τους κωδικούς των τρόπων είσπραξης όπως είναι καταχωρημένοι στην Κονσόλα. Για κάθε έναν κωδικό δίνετε και τον αντίστοιχο τρόπο είσπραξης για την πώληση και για την επιστροφή, για να μπορεί η εφαρμογή να κάνει αντιστοίχιση στις κινήσεις που δημιουργούνται από την κονσόλα.

3. Καλό είναι επίσης να ορίσετε την αντιστοίχιση των κωδικών ειδών με τους κωδικούς taxis. Από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίηση Oil -> Taxis: Αντιστοίχιση Ειδών Αποθήκης] μπορείτε να αντιστοιχίσετε τους κωδικούς των ειδών της αποθήκης που αφορούν σε καύσιμα, με τον αντίστοιχο κωδικό του taxis.

3. Εφόσον έχετε κάνει τις απαραίτητες ρυθμίσεις που αναφέρθηκαν παραπάνω, τότε από την επιλογή [Βάσεις Δεδομένων -> Πρατήριο Καυσιμών -> Κινήσεις Αντλιών] μπορείτε να βρείτε τις κινήσεις των αντλιών. Οι κινήσεις των αντλιών ενημερώνονται αυτόματα από την κονσόλα που ελέγχει τις αντλίες σας. 

Από την reception του oil και το button [Κονσόλα] μπορείτε να βρείτε, ή και να ορίσετε νέα πλήκτρα, με μεθόδους επιλογής της κίνησης από τις αντλίες για τιμολόγηση.

Για παράδειγμα, μπορείτε χρησιμοποιώντας το button [Απόδειξη από Κίνηση Αντλίας] να βρείτε την κίνηση που θέλετε, κάνωντας αναζήτηση με τον αριθμό απόδειξης, και να καταχωρήσετε ένα παραστατικό πώλησης από την κίνηση της αντλίας.

Αν στις Βασικές Παραμέτρους του oil έχετε ορίσει Πελάτη και Παραστατικό Επιστροφής για τις κινησεις της κονσόλας, θα καταχωρήσει και το παραστατικό επιστροφής. Επίσης μπορεί να χρησιμοποιηθεί για να ενημερώσει μόνο τον πελάτη και το όχημα σε κίνηση.

Επιπλέον, χρησιμοποιώντας το button [Είδος από Κινήσεις Αντλιών] και αναζητώντας όπως και παραπάνω με τον αριθμό της απόδειξης, επιστρέφονται στην οθόνη τα είδη καυσίμων της απόδειξης. 

4. Για να λειτουργεί ο server που λαμβάνει τις κινήσεις, θα πρέπει να κάνετε τις απαραίτητες ρυθμίσεις από την επιλογή [ToolBox->Servers] επιλέγετε τον Oil: Server Αντλιών και ορίζετε τις παραμέτρους:

[Αναμονή Secs]: Ο Χρόνος που θα περιμένει, σε δευτερόλεπτα, μέχρι τον επόμενο έλεγχο/

[Είδος Παραθύρου (0/1/3=Normal/Minm/No Window)]: Το είδος του παραθύρου (0= Κανονικό, 1=Minimized, 3=Χωρίς Παράθυρο).

[Πλήθος Επαναλήψεων ανά Session]: Οταν ολοκληρώσει το πλήθος επαναλήψεων που ορίζετε, το Pegasus Service κλείνει το session και καλεί αυτόματα ένα νέο. Είναι χρήσιμο για να μην γίνεται μεγάλη χήση μνήμης ανά session.

5. Καλό είναι πριν ξεκινήσει η λειτουργία της επικοινωνίας του Pegasus oil με την κονσόλα, να διαγράψετε τα δεδομένα από τον ενδιάμεσο πίνακα, αν αυτό δεν δημιουργεί πρόβλημα στην κονσόλα.

ΠΡΟΣΟΧΗ: Η λογική της υλοποίησης είναι ότι η ΕΑΦΔΣΣ εκδίδει μόνο αποδείξεις καυσίμων!