Σκοπός

Στη μελέτη αυτή παρουσιάζεται ο τρόπος σύνδεσης και χρήσης του θερμικού εκτυπωτή EPSON TM-T20 III για την εκτύπωση Παραστατικού σε χαρτί 80mm.
Ο βασικός στόχος ανάπτυξης αυτής της σύνδεσης είναι η προσθήκη δυνατότητας εκτύπωσης Παραστατικού σε θερμικό εκτυπωτή κατά τη χρήση της εφαρμογής Pegasus Web App από μια mobile συσκευή (Smartphone, Tablet).

Προϋποθέσεις

• PE.00.175 - Web App Module Εκτύπωση Παραστατικού σε Epson(Retail)
• PE.00.146 - Εντατική Λιανική(Retail)

Σύνδεση κι Εγκατασταση του EPSON TM-T20 III

• Αρχικά σετάρουμε τον εκτυπωτή με βάση τις οδηγίες του κατασκευαστή (τροφοδοσία ρεύματος, τοποθέτηση χαρτιού κτλ)
• Συνδέουμε με ένα καλώδιο Ethernet τον εκτυπωτή EPSON στο τοπικό δικτυο στο οποίο θίλουμε να τον συνδεσουμε.
• Κατεβάζουμε κι εγκαθηστούμε το "EPSON TM Utility" του Εκτυπωτή αναλογα με το λειτουργικό σύστημα απο εδώ.
• Σε περίπτωση που εκτελούμε το Pegasus Web App μέσα απο Smartphone ή Tablet θα πρέπει να εγκαταστήσουμε το app "EPSON TM Utility" μέσα από το Google Play Store ή Apple Store (Εικόνα 1).

Επιλογή ρυθμίσεων εκτυπωτή EPSON

• Ανοιγουμε την εφαρμογή "EPSON TM Utility" και πλοηγούμαστε στις ρυθμίσεις "Network του εκτυπωτή [Change Printer Settings->Varius Settings->Network] κι επιλέγουμε "Set" (Εικόνα 2-3-4-5-6).
• Επιλέγουμε "IP Address", ορίζουμε "Manual" εύρεση IP Address κι ορίζουμε μια αποδεκτή IP, πχ: 192.168.1.17 (Εικόνα 7). Αυτο το κανουμε έτσι ώστε κάθε φορα που συνδέουμε τον εκτυπωτή στο δίκτυο να παίρνει συγκεκριμένη IP.
• Απο το επίπεδο ρυθμίσεων "Set" (Εικόνα 6) επιλέγουμε "ePOS-Print". Τσεκάρουμε το πεδίο "ePOS-Print" (Εικόνα 8). Επίσης στο πεδίο "Device ID" φαίνεται το ID της συσκευής το οποίο θα μας χρειαστεί για τον ορισμό του εκτυπωτή στο Pegasus Web App. Η default τιμή του είναι "local_printer", δε χρειάζεται να γίνει κάποια αλλαγή.

Προσθήκη εκτυπωτή EPSON στο Pegasus Web App

• Για καταχώρηση νέου εκτυπωτή EPSON στο Pegasus Web App πηγαίνουμε [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές] κι επιλέγουμε "Νέα Καταχώρηση" (Εικόνα 9).
• Συμπληρώνουμε τα πεδία:
  • "Περιγραφή": Ένα όνομα για τον εκτυπωτή μας
  • "Τερματικό": Το Τερματικό απο το οποιο θα συνδέεται ο εκάστοτε χρήστης
  • "IP": Τη διεύθυνση IP που έχει πάρει ο εκτυπωτής στο τοπικό δίκτυο (πχ: 192.168.1.17) (Εικόνα 7)
  • "Port": 8043/8008 ανάλογα με το τροπο επικοινωνίας του Pegasus Web App με τον εκτυπωτή EPSON (Self-Signed Certificate via https ή set insecure origin via http)
  • "ID": Το Device ID του εκτυπωτή (συνήθως "local_printer")(Εικόνα 8)
  • "Ενεργός": Τσεκάρουμε το πεδίο
  • Με το κουμπί "Έλεγχος Συνδεσιμότητας" μπορούμε να ελέγξουμε αν η εφαρμογή ειναι έτοιμη να συνδεθεί με τον εκτυπωτή. Πριν εκτελέσουμε τον έλεγχο θα χρειαστεί να κάνουμε κάποιες ρυθμίσεις στον Chrome Browser.

Η επιλογή για εκτύπωση με χρήση του EPSON εκτυπωτή θα γινεται είτε στην αντίστοιχη οθόνη Παραστατικού είτε στην αντίστοιχη οθόνη retail κατά την ολοκλήρωση Καταχώρησης, Είσπραξης & Εκτυπωσης Παραστατικού. Θα υπάρχει αντιστοιχο κουμπί επιλογής "Είσπραξη, Έκδοση & Εκτύπωση (EPSON)" και θα πρόκειται για εκτύπωση φορμας Roll μεγέθους 80mm.

Σε περίπτωση που το συγκεκριμένο Τερματικό είναι συνδεδεμένο με περισσότερους απο έναν EPSON εκτυπωτές θα εμφανίζεται οθόνη προς επιλογή εκτυπωτή.

Προσθήκη Logo στον εκτυπωτή EPSON TM-T20 III

Για τη εμφάνιση Logo στην εκτύπωση του Παραστατικού θα πρέπει να χρησιμοποιηθεί η δυνατότητα αποθήκευσης Logo που προσφέρουν οι EPSON εκτυπωτές. Διαφορετικά δε θα υπάρχει η δυνατότητα εκτύπωσης Logo μέσα από το Pegasus Web App σε mobile συσκευες.

• Μέσα απο το EPSON TM Utility μπαίνουμε στα αποθηκευμένα Logos (Change Printer Settings->Storing Logos) (Εικόνα 10).
• Επιλέγουμε "ADD", επιλέγουμε το Logo που θέλουμε να αποθηκεύσουμε κι επιλέγουμε "OK" (Εικόνα 11).
• Ορίζουμε Key-code 1 και Key-code 2 κι επιλέγουμε "OK" (Εικόνα 12)
• Ορίζουμε στον αντίστοιχο εκτυπωτή στο Pegasus Web App τα Key-code 1/Key-code 2 για το Logo Εκτυπωτή (Εικόνα 09)
  [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές]

Ρυθμίσεις σε Chrome Browser για επιτυχή σύνδεση Pegasus Web App και EPSON TM-T20 III

Μπορείτε να διαλέξετε έναν από τους δυο τρόπους https σύνδεσης: 

• EPSON Self-Signed Certificate
• Insecure origins ως Secure

Παρακάτω περιγράφονται τα βήματα που πρέπει να ακολουθήσετε για κάθε σύνδεση:

1. Δημιουργία EPSON Self-Signed Certificate - https συνδεση (προτείνεται)
   1. Θα χρειαστεί να μπούμε ξανά στις ρυθμίσεις του εκτυπωτή EPSON αλλά αυτή τη φορά δε θα χρησιμοποιήσουμε το EPSON Utility αλλά θα συνδεθούμε απευθείας από έναν browser (από desktop/laptop, όχι από mobile συσκευή) με την IP του (πχ: "https://192.168.1.17"). Θα πρέπει εμφανιστεί μύνυμα "Your Connection is not Private" (NET::ERR_CERT_AUTHORITY_INVALID), εκεί επιλέγουμε "Advanced" και στη συνέχεια "Proceed to 192.168.1.17 (unsafe)" (Εικόνα 14-15).
   2. Εμφανίζεται παράθυρο για το "Sing In" στον εκτύπωτη όπου βάζουμε σαν Username: epson και Password: Serial Number του εκτυπωτη (πχ: X7AW150384). Εκτελούμε "Sing In" κι εμφανίζονται οι πληροφορίες κι οι ρυθμίσεις του εκτυπωτή (Εικόνα 16-17).
   3. Πηγαίνουμε στο μονοπάτι ρυθμίσεων [Configuration->Network->Authentication->Certificate List] από όπου μπορούμε να εκδώσουμε ένα "Self-Signed Certificate" το οποίο είναι απαραίτητο για ασφαλή σύνδεση του Pegasus Web App με τον EPSON εκτυπωτή μέσω https (Εικόνα 18).
   4. Στην επιλογή "Self-Signed Certificate" πατάμε "Create". Στην οθόνη που μας ανοίγει ορίζουμε σα "Common Name" την IP του εκτυπωτή (πχ: 192.168.1.17) και σα "Validity Period" τα 10 χρόνια. Πατάμε "Create". Στην τελευταία οθόνη "Configurations sent" πατάμε "Reset" για να ενεργοποιηθούν οι αλλαγές στον εκτυπωτή (Εικόνα 19-20).
   5. Μετά το "Reset" θα επανέλθετε στην αρχική σελίδα των ρυθμίσεων. Θα χρειαστεί κάποιος χρόνος μέχρι να ολοκληρωθεί το "Reset". Σε περίπτωση που δε φορτωθεί η αρχική σελίδα κάνετε χειροκίνητα ένα refresh κι επαναλάβετε το αρχικό βήμα "Sing In".
   6. Αριστερά της διευθυνσης στο browser θα πρέπει να φαίνεται ακόμα ως "Not Secure", σε αυτό το σημείο πατάμε [δεξι κλικ->Certificate is not valid] και μας εμφανίζεται το παράθυρο με το Self-Signed Certificate. Επιλέγουμε tab "Details" και μετά κάνουμε "Export". Μπορούμε να το αποθηκεύσουμε στην Επιφάνεια Εργασίας (Εικόνα 21-22).
   7. Στην Επιφάνεια Εργασίας εχει δημιουργηθεί ένα αρχείο "192.168.1.17.crt", πατάμε [δεξί κλικ->Install Certificate]. Θα ανοιξει το "Certificate Import Wizard" με τη βοήθεια του οποίου θα προσθεθεί το Certificate στον Chrome Browser. (Εικόνα 23-24-25)
      • Στο πεδίο "Store Location" επιλέγουμε "Current User", πατάμε "Next"
      • Στη συνέχεια επιλέγουμε "Place all certificates in the following store" πατάμε "Browse" κι επιλέγουμε "Trusted Root Certification Authorities", πατάμε "Next"
      • Το import ολοκληρώθηκε, πατάμε "Finish"
      • Στο μήνυμα επιβεβαιώσης πατάμε "Yes"
   8. Κάνουμε restart τον Chrome Browser γράφοντας στη διεύθυνση chrome://restart
   9. Ξαναμπαίνουμε στη σελίδα του εκτυπωτή (πχ: "https://192.168.1.17") που θα πρέπει να ξανακάνουμε "Sing In", όμως πλέον η σύνδεση μας είναι secure (Εικόνα 26).
   10. Πηγαίνουμε ξανά στον εκτυπωτή που έχουμε καταχωρήσει, "Εκτυπωτής EPSON 1", δίνουμε στο πεδίο "Port" τιμή "8043" (γεγονός που θα αναγκάσει το Pegasus Web App να επικοινωνεί με τον εκτυπωτή μέσω "https") και εκτελούμε τη λειτουργία "Έλεγχος Συνδεσιμότητας". Ελέγχουμε οτι πήραμε μηνυμα επιτυχήμένης σύνδεσης. [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές] (Εικόνα 9).

   Με βάση τα παραπάνω βήματα έχουμε εξασφαλίσει secure συνδεση του Pegasus Web App με τον EPSON εκτυπωτή με Self-Signed Certificate αλλά μόνο από το dsktop/laptop με το οποιό κάναμε τις ρυθμίσεις. Θα προχωρήσουμε και στον ορισμό για Mobile Συσκευές (Android, Apple)

   Android Mobile Συσκευές (δοκιμάστηκε σε android smartphone)

   1. Αποστέλουμε το αρχείο "192.168.1.17.crt" στην Android Συσκευή (email/drive)
   2. Πηγαίνουμε στις ρυθμίσεις της Android Συσκευής και κανουμε αναζήτηση με "CA" κι επιλέγουμε τη ρύθμιση "Πιστοποιητικό CA" (Εικόνα 27).
   3. Στην επόμενη οθόνη επιλέγουμε "Εγκατάσταση ούτως ή άλλως" και βρίσκουμε το αρχείο "192.168.1.17.crt" που έχουμε κατεβάσει στην Android Συσκευή, το επιλέγουμε και ολοκληρώνεται η διαδικασόα (Εικόνα 28-29).
   4. Από την Android Συσκευή μπαίνουμε στο Pegasus Web App και βρίσκουμε τον εκτυπωτή που έχουμε καταχωρήσει, "Εκτυπωτής EPSON 1" και εκτελούμε τη λειτουργία "Έλεγχος Συνδεσιμότητας". Ελέγχουμε οτι πήραμε μήνυμα επιτυχήμένης σύνδεσης. [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές].

   Apple Mobile Συσκευές (δοκιμάστηκε σε ipad)

   1. Αποστέλουμε το αρχείο "192.168.1.17.crt" στην Apple Συσκευή (email/drive)
   2. Πηγαίνουμε στο path που έχουμε αποθηκεύσει το αρχείο κι το επιλέγουμε. Εμφανίζεται μήνυμα ότι "Έγινε λήψη του προφίλ" (Εικόνα 30).
   3. Πηγαίνουμε στις "Ρυθμίσεις" κι επιλέγουμε "Λήψη Προφίλ". Στο παράθυρο που ανοίγει επιλέγουμε "Εγκατάσταση". Θα εμφανιστεί ειδοποίηση ότι η εγκατάσταση ολοκληρώθηκε (Εικόνα 31-33).
   4. Στις "Ρυθμίσεις" κάνουμε αναζήτηση για την επιλογή "Αξιόπιστα Πιστοποιητικά". Τσεκάρουμε την "Ενεργοποίηση πλήρους Αξιοπιστίας" για την IP "192.168.1.17" του EPSON εκτυπωτή και πατάμε "Συνέχεια" (Εικόνα 34).
   5. Από την Apple Συσκευή μπαινουμε στο Pegasus Web App και βρίσουμε τον εκτυπωτή που έχουμε καταχωρήσει, "Εκτυπωτής EPSON 1" και εκτελούμε τη λειτουργία "Έλεγχος Συνδεσιμότητας". Ελέγχουμε οτι πήραμε μήνυμα επιτυχήμένης σύνδεσης. [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές].
2. Ορισμός Insecure origins ως Secure - http συνδεση
   1. Στον εκτυπωτή που εχουμε καταχωρήσει, "Εκτυπωτής EPSON 1", θα δώσουμε στο πεδίο "Port" τιμή "8008" γεγονός που θα αναγκάσει το Pegasus Web App να επικοινωνεί με τον εκτυπωτή μεσω "http" [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές] (Εικόνα 9).
   2. Ανοίγουμε ένα νέο tab στον Chrome Browser και αναζητούμε το flag "unsafely-treat-insecure-origin-as-secure" ορίζοντας:
      chrome://flags/#unsafely-treat-insecure-origin-as-secure
   3. Ορίζουμε το url "http://{EPSON_IP}" (πχ: "http://192.168.1.17") στο αντίστοιχο πεδίο και πατάμε "Relanch" για να γίνει restart του browser και να αποθηκευτούν οι ρυθμίσεις (Εικόνα 13)
   4. Πηγαίνουμε ξανά στον εκτυπωτή που έχουμε καταχωρήσει, "Εκτυπωτής EPSON 1", και εκτελούμε τη λειτουργία "Έλεγχος Συνδεσιμότητας". Ελέγχουμε οτι πήραμε μήνυμα επιτυχημένης σύνδεσης. [Toolbox->Εργαλεία Παραμετροποίησης->Εκτυπωτές EPSON->Εκτυπωτές]