Σκοπός:

Σε αυτή τη μελέτη θα περιγράψουμε τα απαραίτητα βήματα παραμετροποίησης για τη διασύνδεση του Pegasus Web App με τις EFT/POS συσκευές που υποστηρίζονται από το πρωτόκολλο Viva Cloud και τον NSP Viva σύμφωνα με τη νομοθεσία Α.1155 /09-10-2023.

Πριν προχωρήσετε στην ανάγνωση αυτής της μελέτης δείτε τις συσκευές που υποστηρίζονται καθώς και πως χειριζόμαστε τις πληρωμές στα Pegasus ERP εδώ: 
Pegasus ERP και Διασύνδεση EFT POS

Τα τερματικά της Viva που υποστηρίζονται με το πρωτόκολλο Viva Cloud είναι:

• Ciontek CS30PRO, Ciontek CS50C
• Android SoftPOS
• A50, A77, A80, A910, A920, A920Pro, Α35

Περισσότερα για τις συσκευές που υποστηρίζονται από τη Viva, στο link https://developer.viva.com/aade/.

Για να προχωρήσετε στην παραμετροποίηση, βεβαιωθείτε ότι:

• Διαθέτετε το module EFT/POS (PM.01.01.38)
• το POS είναι εναρμονισμένο με τις νομοθετικές διατάξεις Α.1155 /09-10-2023
• το Pegasus ERP συνδέεται με την υπηρεσία e-invoicing.pegcloud.io

Οι ενέργειες που υποστηρίζονται στην συγκεκριμένη διασύνδεση όπως φαίνεται και εδώ, είναι οι: Πώληση (sale), Επιστροφή (refund), Επιστροφή πριν το κλείσιμο πακέτου(void).

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

Σημείωση#1: Οι παρακάτω οδηγίες προϋποθέτουν πως το POS είναι πλήρως συμβατό με τη νομοθεσία Α.1155. Αν το POS δεν είναι πληρεί τις προϋποθέσεις, θα πρέπει να γίνει αναβάθμιση. Για τα SoftPos αρκεί να γίνει αναβάθμιση της εφαρμογή της Viva από το Play Store. Για τα φυσικά POS θα πρέπει να γίνει επικοινωνία με τη Viva ώστε να δωθούν οδηγίες.

Σημείωση#2: Τα μοντέλα Prolin Q30, D200, S800, S900 χρησιμοποιούν TCP/IP πρωτόκολλο για το οποίο δεν έχουμε ακόμα έτοιμη υλοποίηση

Ρύθμιση Συσκευής :

Viva Wallet

1)Αρχικά θα πρέπει να κάνετε login στον Viva Wallet λογαριασμό σας και στη συνέχεια, κλικ στο μενού κάτω αριστερά [SETTINGS->API ACCESS].

2) Στο tab [General] και στην ενότητα [API Security features] θα πρέπει να ενεργοποιήσετε όλες τις επιλογές που είναι διαθέσιμες για το λογαρισμό σας.

3)Στην ενότητα [POS APIs Credentials], κάνετε κλικ στο button [Generate a pair of credentials] και καταγράφετε τα [Client ID] και [Client Secret] που θα παραχθούν.

ΠΡΟΣΟΧΗ 1: Το client secret δεν μπορεί να επανεμφανιστεί. Αν το ξεχάσετε, θα πρέπει να δημιουργήσετε ένα νέο με κλικ στο σχετικό button.

ΠΡΟΣΟΧΗ 2: Σε περίπτωση που χρειαστεί να στηθεί παραπάνω του ενός POS της Viva ΔΕΝ θα πρέπει να εκδώσετε νεα [Client ID] και [Client Secret] μπορείτε να τα αντιγράψετε αυτα που εκδώσατε στην αρχή απο το πρωτο pos που συνδέσατε. 

Soft POS

Από την συσκευή POS που έχετε προμηθεύτει θα πρέπει να κατεβάσετε και να εγκαταστήσετε την android εφαρμογή της Viva Wallet. Στη συνέχεια μέσα από την εφαρμογή θα πρέπει να κάνετε login με τα στοιχεία σύνδεσης στο λογαρισμός σας.

Με το επιτυχημένο login καταγράφετε και το id της συσκευή στον λογαριασμό της Viva. Μπορείτε να βρείτε το id της συσκευής μέσα από το android app και από τις επιλογές: [More->About->terminal id]

Ρυθμίσεις εφαρμογής

Θα πρέπει να ορίσουμε την EFT/POS συσκευή από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίησης ΦΗΜ -> on-line POS Πληρωμών]. Δημιουργούμε μια νέα εγγραφή όπου στο πεδίο [Μέθοδος] επιλέγουμε [Viva Wallet | Συμβατή με Α1155]. Στη συνέχεια, κάνουμε κλικ στο button [Ρυθμίσεις]. Τα βήματα που πρέπει να ακολουθήσουμε είναι τα εξής:

• στο πεδίο [Κωδικός Χρήστη] ορίζουμε το client id που καταγράψαμε από το λογαρισμό Viva wallet
• στο πεδίο [Συνθηματικό] δίνουμε το client secret
• στο πεδίο [Terminal ID] θα ορίσουμε τον αναγνωριστικό της συσκευής POS που θέλουμε να συνδεθεί.

Στη συνέχεια από [Δράσεις->Έλεγχος Παραμέτρων] επιβεβαιώνουμε ότι τα στοιχεία που ορίσαμε είναι σωστά και πως υπάρχει επικοινωνία με το POS.

Σημείωση: Στο μενού [Υποστήριξη -> Pegasus C&A -> Λοιπές Φορολογικές Συσκευές Τερματικού ->Υποενότητα Οn-Line POS (Πληρωμών)], κάνετε κλικ στο button [Επιλογή]. Στο παράθυρο που εμφανίζεται και στον [Τύπο POS], επιλέγετε [POS εγκατάστασης]. Με αυτή τη ρύθμιση και όταν θα εκτελέσετε κάποια συναλλαγή με κάρτα, η εφαρμογή αυτόματα φέρνει προς επιλογή όλα τα EFT/POS που έχετε ορίσει στο μενού [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Παραμετροποίησης ΦΗΜ -> on-line POS Πληρωμών] όταν θα εκτελέσετε κάποια συναλλαγή με κάρτα.

• αν έχετε ορίσει μόνο ένα EFT/POS, θα το επιλέξει αυτόματα
• αν έχετε παραπάνω από ένα, θα εμφανίσει οθόνη προς επιλογή

Ρύθμιση Συσκευής για Είσπραξη/Επιστροφή από Παραστατικό Πελάτη

Έπειτα, θα πρέπει να ορίσουμε τον τρόπο είσπραξης για την πληρωμή μέσω της EFT/POS συσκευής. Από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Συναλλαγών και Συναλλασσομένων -> Τρόποι Εισπραξης] θα πρέπει να φτιάξουμε νέο τρόπο είσπραξης ο οποίος:

1. Θα έχει Κ.Κ Λογιστηρίου που δηλώνει είσπραξης. Μπορείτε να χρησιμοποιήσετε έναν Κ.Κ με συντελεστές:
   1. [Πίστωσης]=1
   2. [Ταμείου - Μετρητών (όλο το ποσό)]=0
      ή να δημιουργήσουμε ένα νέο.
2. Θα έχει ορισμένο myDATA: Τρόπο πληρωμής "7 | POS / e-POS" (από [Λοιπές Δράσεις->Αντιστοιχίες Κεντρικών Πινάκων])
3. Θα έχει τσεκαρισμένο το πεδίο [Αφορά σε Είσπραξη με EFT/POS]

Επιπλεόν θα δημιουργήσουμε και ένα τρόπο είσπραξης για επιστροφή ο οποίος:

1. Θα έχει Κ.Κ Λογιστηρίου που δηλώνει επιστροφή. Μπορούμε να χρησιμοποιήσουμε έναν Κ.Κ με συντελεστές:
   1. [Πίστωσης]=-1
   2. [Ταμείου - Μετρητών (όλο το ποσό)]=0
      ή να δημιουργήσουμε ένα νέο.
2. Θα έχει ορισμένο myDATA: Τρόπο πληρωμής "7 | POS / e-POS" (από [Λοιπές Δράσεις->Αντιστοιχίες Κεντρικών Πινάκων])
3. Θα έχει τσεκαρισμένο το πεδίο [Αφορά σε Είσπραξη με EFT/POS]

Ρυθμίσεις Συσκευής για Είσπραξη για Παραστατικό που θα εκδοθεί μελλοντικά

Εαν το παραστατικό έπεται της είσπραξης, τότε είναι απαραίτητο να εκδοθεί μία Απόδειξη Είσπραξης ή Απόδειξη Επιστροφής που αντιστοιχίζονται στα παραστατικά 8.4 και 8.5 του myDATA αντίστοιχα. Οι αποδείξεις αυτές αποτελούν παραστατικά που αποστέλλονται στο myDATA και εκδίδονται ΜΟΝΟ από την οθόνη [Καταχώρηση Απόδειξης EFTPOS].

Προσοχή, όλα τα παραστατικά που θα εκδοθούν μελλοντικά θα πρέπει να συνδεθούν με τις Αποδείξεις Είσπραξης που περιγράφουμε εδώ. Με βάση την Α.1155 /09-10-2023 "Σε κάθε περίπτωση, οι αποδείξεις είσπραξης ή τα αντίστοιχα λογιστικά αρχεία που δημιουργούνται αντιστοιχίζονται με παραστατικά (τιμολόγια, αποδείξεις λιανικής πώλησης) που εκδίδονται μεταγενέστερα της πληρωμής για την ολοκλήρωση των συναλλαγών αυτών. Στην περίπτωση που οι αποδείξεις είσπραξης που εκδόθηκαν ή τα κατάλληλα λογιστικά αρχεία που δημιουργήθηκαν δεν συσχετιστούν με τιμολόγια ή αποδείξεις λιανικής πώλησης έως την υποβολή της δήλωσης φορολογίας εισοδήματος της χρήσης που αφορούν, τα σχετικά ποσά που αντιστοιχούν σε αυτές, προστίθενται στον ετήσιο κύκλο εργασιών της οντότητας. Εφόσον οι εν λόγω αποδείξεις είσπραξης τιμολογηθούν την επόμενη χρήση, για την τρέχουσα νοούνται ως έσοδα επόμενων χρήσεων."

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

Σημαντική σημείωση: Με τον αυτοματισμό [m-44: Λογιστήριο: Ρυθμίσεις Αποδείξεων EFTPOS], οι ρυθμίσεις για τα παραστατικά αυτά γίνονται αυτόματα (πηγαίνουμε απευθείας στο βήμα Γ).

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

Α. Ορισμός νέου παραστατικού: Απόδειξη Είσπραξης POS (8.4)

1. Ορίζουμε Κ.Κ. Λογιστηρίου με Συντελεστή [Πίστωσης] = 1 και [Εισπράξεων Πληρωμών] = 1.
2. Δημιουργούμε έναν νέο μετρητή για τον συγκεκριμένο τύπο απόδειξης
3. Στο πεδίο [Φόρμα Εκτύπωσης] δίνουμε apopa.frp
4. Ορίζουμε [Ισχύει Για] Πελάτες
5. Θα έχει ορισμένο "Προς Αποστολή" το παραστατικό "8.4 | Απόδειξη Είσπραξης POS" (από [Λοιπές Δράσεις->Αντιστοιχίες Κεντρικών Πινάκων])
6. Ορίζουμε [Κωδικό TaxisNet] = [173 - ΑΠΟΔΕΙΞΗ ΛΙΑΝΙΚΗΣ ΠΩΛΗΣΗΣ]

Β. Ορισμός νέου παραστατικού: Απόδειξη Επιστροφής POS (8.5)

1. Ορίζουμε [Κ.Κ. Λογιστηρίου] με Συντελεστή Πίστωσης -1 και [Εισπράξεων Πληρωμών] =1 .
2. Δημιουργούμε έναν νέο [Μετρητή] για τον συγκεκριμένο τύπο απόδειξης
3. Στο πεδίο [Φόρμα Εκτύπωσης] δίνουμε apopa.frp
4. Ορίζουμε [Ισχύει Για] Πελάτες
5. Θα έχει ορισμένο "Προς Αποστολή" το παραστατικό "8.5 | Απόδειξη Επιστροφής POS" (από [Λοιπές Δράσεις->Αντιστοιχίες Κεντρικών Πινάκων])
6. Ορίζουμε [Κωδικό TaxisNet]=ΑΠΟΔΕΙΞΗ ΕΠΙΣΤΡΟΦΗΣ

Γ. Ορισμός των αποδείξεων για συμμετοχή στην Ηλεκτρονική Τιμολόγηση

Οι ρυθμίσεις είναι ίδιες με αυτές που κάνουμε για τις ΕΑΦΔΣΣ (ορισμός εκτυπωτή κ.ο.κ.). 
Περισσότερα για τις Ρυθμίσεις αυτές μπορείτε να δείτε στη μελέτη Επικοινωνία των εφαρμογών Pegasus ERP με Ηλεκτρονικό Πάροχο Pegasus e-Invoicing και συγκεκριμένα στην παράγραφο [Βήμα 4].

Δ. Ρύθμιση Συσκευής για τις Αποδείξεις Είσπραξης POS (8.4) / Επιστροφής POS (8.5)

Από την επιλογή [ToolBox-> Εργαλεία Παραμετροποίησης -> Παραμετροποίηση Εφαρμογής -> Κεντρικοί Πίνακες Παραμετροποίησης -> Λογιστηρίου -> Ορισμός Αποδείξεων EFTPOS], ορίζουμε τις αντιστοιχίσεις των συσκευών EFT/POS με τους τύπους αποδείξεων που αφορούν στα παραστατικά 8.4 και 8.5 του myDATA.

Στο πεδίο [Αιτιολογία Απόδειξης] μπορείτε να δημιουργήσετε μια νέα εγγραφή με τους εξής ορισμούς:

• Ο χρήστης δίνει->Ποσό
• Συμμετέχει στο ταμείο->ΝΑΙ
• Αποδείξεις στις οποίες ισχύει->επιλέγετε την απόδειξη που φτιάξατε αντίστοιχα στο Α ή στο Β