Σκοπός:

Η μελέτη αναφέρει τα βήματα παραμετροποίησης για τη σύνδεση των Pegasus Web App εφαρμογών με τις ταμειακές που είναι συμβατές με τον CapDriver (RBS κ.α.).

Λειτουργία:

Η ταμειακή επικοινωνεί με το Pegasus Web App μέσω του driver CapDriver, ο οποίος διαβάζει αρχεία με συγκεκριμένη γραμμογράφηση, ώστε να δώσει εντολές στο hardware της ταμειακής προκειμένου να εκτυπώσει.

Ως εκ τούτου, το Pegasus Web App δημιουργεί το σωστό αρχείο ώστε να τροφοδοτήσει τον CapDriver ανάλογα με το παραστατικό(και τα είδη) που πρέπει να εκτυπωθούν σε απόδειξη. Η δημιουργία αρχείου πυροδοτείται με την καταχώρηση του παραστατικού.

Βήματα:

Αρχικά, θα πρέπει να προμηθευτείτε τον CapDriver από τον επίσημο κατασκευαστή και να τον εγκαταστήσετε.

Σημαντική σημείωση: Προτείνουμε να έχει προηγηθεί επικοινωνία με τον αρμόδιο τεχνικό ώστε να εξασφαλιστεί η σωστή εγκατάσταση του driver πριν εκτελέσετε τα επόμενα βήματα.

Εγκατάσταση Pegasus .NET Devices

Αρχικά θα πρέπει να γίνει εγκατάσταση του Websocket Server για την επικοινωνία του Pegasus Web App με την ταμειακή. Για οδηγίες εγκατάστασης του Websocket Server μπορείτε να δείτε τη μελέτη εδώ.

Pegasus Web App: Βασικές Ρυθμίσεις

1. Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση CnA->WebSocket Servers] δημιουργείτε μια νέα καταχώρηση.

• IP: καταχωρείτε την IP του η/υ στον οποίο εκτελείται ο WebSocket Server. Υπενθυμίζουμε ότι ο WebSocket Server αρκεί να τρέχει μόνο σε έναν η/υ στο δίκτυο.

Σημείωση: Η IP αυτή πρέπει να είναι static. Για να βρείτε την IP, αρκεί να εκτελέσετε την εντολή ipconfig στον η/υ όπου εκτελείται ο WebSocket server. Aν εκτελείται στον ίδιο η/υ όπου λειτουργεί και το Pegasus Web App, μπορείτε να καταχωρήσετε την τιμή localhost .

• Port: καταχωρείτε την θύρα με την οποία εκκινήθηκε ο WebSocket Server πχ 50063

Από το button “Έλεγχος συνδεσιμότητας” στην οθόνη του Web App βλέπετε αν είναι δυνατή η επικοινωνία. Προσοχή! Για να μπορέσει να γίνει σύνδεση, θα πρέπει να έχετε εκτελέσει το Pegasus .NET Devices καθώς και να έχετε εκκινήσει τον WebSocket Server.

Αν η επικοινωνία δεν ήταν εφικτή κινείστε με βάση το μήνυμα που εμφανίζεται στην οθόνη. Για να εμφανιστεί το μήνυμα λάθους, μπορεί να χρειαστεί να περιμένετε μερικά δευτερόλεπτα.

Συνήθη προβλήματα

• Μήνυμα Λάθους: “Ανεπιτυχής Προσπάθεια Σύνδεσης στον WebSocket Server.”
  1. Ελέγχετε ότι έχει εκκινηθεί ο server από το Pegasus .NET CnA App
  2. Ελέγχετε ότι μπορείτε να “επικοινωνήσετε” με την IP που δώσατε π.χ. εκτελώντας ένα ping
  3. Ελέγχετε οτι η πόρτα που ορίσατε δεν χρησιμοποιείται από κάποια άλλη διεργασία. Μπορείτε να το ελέγξετε, εκτελώντας στο cmd την εντολή netstat -ano | find "50063"
• Μήνυμα Λάθους: “SecurityError: Failed to construct 'WebSocket” - Google Chrome
  1. Ορίζετε το url ws://ip:port στο flag chrome://flags/#unsafely-treat-insecure-origin-as-secure του browser. Αντικαθιστάτε την ip και port με τα πραγματικά στοιχεία
     
     ΠΡΟΣΟΧΗ: θα πρέπει να γίνει επανεκκίνηση του browser σας ώστε να ενεργοποιηθεί η ρύθμιση αυτή.
• Μήνυμα Λάθους: “The operation is insecure: Code XX” - Mozilla Firefox
  1. Πηγαίνετε στο about:config του firefox βρίσκετε το network.websocket.allowInsecureFromHTTPS και το κάνετε true.

2. Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση CnA->Ρυθμίσεις συσκευών ΦΤΜ/ΦΗΜΑΣ/ΑΔΗΜΕ] δημιουργείτε μια νέα εγγραφή. Αρχικά, επιλέγετε [τύπος σύνδεσης/συσκευής->Ταμειακή μηχανή (Capdriver)].

Στη συνέχεια και στα πεδία που εμφανίζει, συμπληρώνετε:

• WebSocket Server: Αυτόν που δημιουργήσατε στο βήμα#1 προηγουμένως
  
  
• Σειρά, Παραστατικό, Κατάστημα(αν υπάρχει το ομώνυμο module): ορίζετε τους συνδυασμούς για τα παραστατικά πελατών τα οποία θέλετε να επικοινωνήσουν με τον driver της ταμειακής.
  Σημείωση: μπορείτε να επιλέξετε παραπάνω από μια τιμή, ώστε να καλύψετε όλους τους πιθανούς συνδυασμούς.
  
  
• Path Αρχείου:  To αρχείο που θα δημιουργεί η εφαρμογή. Αν στο όνομα προσθέσετε το λεκτικό ##nr01## τότε θα δημιουργεί διαφορετικό αρχείο.
  
  Παράδειγμα: C:/capdriver/pegasus_##nr01##.txt
  
  
• Την Κατηγορία ΦΠΑ την Ενημερώνει Από: Ορίζετε πως θα βρίσκει την κατηγορία ΦΠΑ. Υπάρχουν οι εξής δυνατότητες:
  1. Τον κωδικό της κατηγορίας ΦΠΑ 
  2. Από την παράμετρο [Φ] την κατηγορίας ΦΠΑ (Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Λογιστηρίου->Κατηγορίες ΦΠΑ)
  3. Από την παράμετρο [Ε] του τύπου του είδους (Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Αποθήκης->Τύποι Ειδών Αποθήκης)
     
     Στις περιπτώσεις (ii) και (iii) θα πρέπει να ορίσετε [από ποιά θέση] και πόσα [ψηφία] θα διαβάζει η εφαρμογή από την ανάλογη παράμετρο και φυσικά να ορίσετε την ανάλογη επιλογή τις παραμέτρους.  
     
     Για παράδειγμα, αν έχετε επιλέξει τύπο είδους και στον τύπο είδους έχετε ορίσει στο πεδίο Ε τιμή 70-20-01, αν θέλετε να διαβάσει το 01, θα πρέπει να ορίσετε [από θέση->7] και για [ψηφία->2]
     
     
• Την περιγραφή την παίρνει από: επιλέγετε ποια τιμή θα αποσταλεί ως [περιγραφή είδους] στην απόδειξη που θα εκτυπωθεί:
1. Περιγραφή κίνησης->η περιγραφή του είδους στον i01
2. Ομάδα είδους->το λεκτικό της ομάδας είδους του i01
3. Κατηγορία είδος->το λεκτικό της κατηγορίας είδους του i01
   
   
• Στέλνει και Κλείσιμο Απόδειξης:  Αν το τσεκάρετε, στο τέλος της απόδειξης στέλνει και την εντολή κλεισίματος (ER/). Σε κάποιες εκδόσεις του driver δεν πρέπει να στέλνει το κλείσιμο στο τέλος.
  
  
• Prefix Σχολίων: Η εντολή που πρέπει να στείλει για την εκτύπωση των σχολίων. Θα πρέπει να ενημερωθείτε από τον κατασκευαστή της Ταμειακής γιατί διαφέρει ανάλογα με την ταμειακή. Πιθανές τιμές είναι CL και HL
  
  
• Σχόλια 1 -6 : Ορίζετε τις εντολές που θέλετε να εκτελεστούν για τα σχόλια:
  • π.χ.Τραπέζι: ##p403##
  • π.χ. Σερβιτόρος: ##p404##

Όπου p403 ή p404, μπορείτε να ορίσετε οποιαδήποτε τιμή μεταξύ p401-p409 ώστε να φέρει τα [λεκτικά 1-9] του παραστατικού.

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

Ιδιαίτερα χρήσιμο αν η ταμειακή σας είναι συνδεμένη με EFT/POS.

Σημείωση: σε περίπτωση που το παραπάνω πεδίο είναι κενό, η εντολή που στέλνεται στον driver είναι για τον κωδικό 1 (που στις περισσότερες περιπτώσεις, αφορά τα ΜΕΤΡΗΤΑ).

Παρατηρήσεις

• Το αρχείο που παράγει το Pegasus Web App έχει κωδικοποίηση UTF-8 (είναι και η προεπιλεγμένη κωδικοποίηση στον CapDriver). Σε περίπτωση που εμφανίζει σφάλμα, ελέγξτε αν στον CapDriver έχει ρυθμιστεί η σωστή κωδικοποίηση.
• Σε περίπτωση που η περιγραφή είδους είναι κενή (πχ έχετε κάποιο είδος Pegasus Web App με κενή [Περιγραφή]), στην απόδειξη θα εκτυπωθεί μια τελεία.
• Αν έχετε ορίσει έκπτωση στο παραστατικό, τότε θα εμφανιστεί ως ξεχωριστή γραμμή στην απόδειξη και με την ανάλογη ένδειξη ΈΚΠΤΩΣΗΣ. Εναλλακτικά, αν έχετε ορίσει έκπτωση σε είδος, η γραμμή είδους θα εμφανιστεί με το τελικό ποσό μετά έκπτωσης.
  
  Το ίδιο θα συμβεί εαν στη γραμμή είδους υπάρχει ΕΦΚ/εισφορά ανακύκλωσης ή κάτι παρόμοιο που διαμορφώνει την τελική τιμή γραμμής. Η τιμή που θα εκτυπωθεί θα είναι πάντα η τελική.