Σκοπός:

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

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

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

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

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

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

• Διαθέτετε το module Διαχείριση POS πληρωμών Web App (PE.00.150)
• το POS είναι εναρμονισμένο με τις νομοθετικές διατάξεις Α.1155 /09-10-2023
• το Pegasus Web App συνδέεται με την υπηρεσία 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].

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

4)Στην ενότητα [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]

Pegasus Web App

Αφού ολοκληρωθούν οι παραπάνω ρυθμίσεις από τη Viva, θα πρέπει στην εφαρμογή Pegasus Web APP να ορίσουμε την EFT/POS συσκευή. Aπό την επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->POS Πληρωμών->Συσκευές POS]. Τα βήματα που πρέπει να ακολουθήσουμε είναι τα εξής:

• στο πεδίο [Τύπος] θα επιλέξετε Viva Wallet | Συμβατή με Α1155
• θα ορίσετε το check [Απαιτεί υπογραφή Παρόχου/ΦΗΜΑΣ/ΑΔΗΜΕ] ως ενεργό
• ορίζετε στα πεδία [Client ID], [Client Secret] τα στοιχεία που δημιουργήσατε στα προηγούμενα βήματα.

Κάνετε Καταχώρηση και [Εύρεση Συσκευών POS]. Με αυτήν την ενέργεια, παραλαμβάνετε όλες τις συσκευές που είναι εγγεγραμμένες κάτω από τον λογαριασμό σας. Στην συσκευή, επιλέγετε την συσκευή που θέλετε, ενημερώνεται αυτόματα το πεδίο [Ταυτότητα Μέσου Πληρωμών].

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

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

1. ΔΕΝ θα έχει ορισμένο Κ.Κ. λογιστηρίου
2. Θα έχει ορισμένο myDATA: Τρόπο πληρωμής "7 | POS / e-POS"
3. Στο tab [Ρυθμίσεις POS Παραστατικών Πελάτη]:
   • Συσκευή POS: Επιλέγουμε την EFT/POS συσκευή που φτιάξαμε νωρίτερα
   • Τερματικό: Επιλέγουμε αυτό για το οποίο θέλουμε να ισχύει (μπορεί πχ να έχουμε διαφορετικές συσκευές POS σε κάθε τερματικό)
   • K.K. λογιστηρίου: θα πρέπει να έχει:
     • Συντελεστή Πίστωσης 1 αν ο τρόπος Είσπραξης αφορά Είσπραξη ποσού.
       Μπορούμε να χρησιμοποιήσουμε απευθείας την προεπιλεγμένη εγγραφή [1001 - Είσπραξη Από Πελάτη (Πιστωτική)]
     • Συντελεστή Πίστωσης -1, σε περίπτωση που αφορά Επιστροφή.
       Μπορούμε να αντιγράψουμε την προεπιλεγμένη εγγραφή [1099 - Επιστροφή Μετρητών Σε Πελάτη] και να δημιουργήσουμε μια νέα με την κατάλληλη περιγραφή πχ [Επιστροφή Σε Πελάτη(πιστωτική)]

Μπορούμε να επιλέξουμε αν κατά τη διαδικασια της πληρωμής θα εμφανίζεται η δυνατότητα για επιλογή δόσεων. 

Σημείωση: Θα πρέπει να έχει ενεργοποιηθεί και η δυνατότητα των δόσεων από το Viva Wallet (από την επιλογή more θα ενεργοποιήσετε το Instalments)

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

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

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

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

Σημαντική σημείωση#1: Απαιτείται το module [PE.00.033 - Web App Module Αποδείξεις]

Σημαντική σημείωση#2: Με τις αναβαθμίσεις [Eισπράξεις/Επιστροφές από EFTPOS v1.00 v079/v080], οι ρυθμίσεις για τα παραστατικά αυτά γίνονται αυτόματα (πηγαίνουμε απευθείας στο βήμα Γ).

Εναλλακτικά, μπορούμε να τα δημιουργήσουμε:

• εκτελώντας τον αυτοματισμό [Δημιουργία Ορισμών Αποδείξεων Είσπραξης/Επιστροφής POS 8.4/8.5], ο οποίος είναι διαθέσιμος με την αναβάθμιση [Eισπράξεις/Επιστροφές από EFTPOS (account00) v1.00 r122]
• είτε χειροκίνητα από την επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Λογιστηρίου->Ορισμός Αποδείξεων], όπου θα κάνουμε δύο νέες καταχωρήσεις. 

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

1. Ορίζουμε Κ.Κ. Λογιστηρίου με Συντελεστή Πίστωσης 1 και Συντελεστή Εισπράξεων/Πληρωμών 1.
2. Δημιουργούμε έναν νέο μετρητή για τον συγκεκριμένο τύπο απόδειξης
3. Στην παραμετροποίηση του myDATA, ορίζουμε "Προς Αποστολή" το παραστατικό "8.4 | Απόδειξη Είσπραξης POS".

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

1. Ορίζουμε Κ.Κ. Λογιστηρίου με Συντελεστή Πίστωσης -1 και Συντελεστή Εισπράξεων/Πληρωμών 1.
2. Δημιουργούμε έναν νέο μετρητή για τον συγκεκριμένο τύπο απόδειξης
3. Στην παραμετροποίηση του myDATA, ορίζουμε "Προς Αποστολή" το παραστατικό "8.5 | Απόδειξη Επιστροφής POS".

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

Στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Ηλεκτρονική Τιμολόγηση->Ρυθμίσεις Ηλεκτρονικής Τιμολόγησης->tab Αποδείξεις] καταχωρούμε μια νέα εγγραφή. Ορίζουμε τα εξής:

• Τύπος Παραστατικού: τις αποδείξεις που δημιουργήσαμε στο Α και Β
• Σειρά, Κατάστημα(αν υπάρχει το module): τους πιθανούς συνδυασμούς για τους οποίους θα ισχύει αυτή η ρύθμιση
• Στοιχεία Ηλεκτρονικής Τιμολόγησης: τα στοιχεία Ηλεκτρονικής Τιμολόγησης που θέλετε να είναι ενεργά για αυτή τη ρύθμιση

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

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

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

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