Το Πρωτόκολλο διασύνδεσης συστημάτων έκδοσης στοιχείων λιανικής πώλησης και τερματικών αποδοχής καρτών πληρωμών (EFTPOS) περιγράφεται στο παράρτημα.

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

Σε περίπτωση προσωρινής βλάβης του ΦΗΜ, ή σε περίπτωση προσωρινής βλάβης της διασύνδεσης EFTPOS-ΦΗΜ «βλάβη υποδομής», ο κάτοχος του ΦΗΜ δηλώνει την προσωρινή βλάβη στο Πληροφοριακό Σύστημα ΦΗΜ «esend». Το EFTPOS επικοινωνεί ηλεκτρονικά με το ΠΣ ΦΗΜ «esend», το οποίο του δίνει την εντολή να ενεργοποιήσει την δυνατότητά πληκτρολόγησης του ποσού πληρωμής στην περίπτωση χρεωστικών συναλλαγών. Η ενεργοποίηση της δυνατότητας πληκτρολόγησης του EFTPOS λόγω βλάβης υποδομής για την εισαγωγή ποσού πληρωμής στην περίπτωση χρεωστικών συναλλαγών, έχει μέγιστη διάρκεια δώδεκα (12) ώρες και επιτρέπεται το πολύ για μία φορά κάθε τρεις μήνες.

Η απελευθέρωση του πληκτρολογίου του EFTPOS λόγω βλάβης ΦΗΜ για την εισαγωγή ποσού πληρωμής στην περίπτωση χρεωστικών συναλλαγών, για όλες τις υπόχρεες επιχειρήσεις, έχει μέγιστη διάρκεια είκοσι τέσσερις (24) ώρες. Για τις επιχειρήσεις που ασκούν τη δραστηριότητά τους σε χωριά με πληθυσμό έως πεντακόσιους (500) κατοίκους και σε νησιά κάτω από τρεις χιλιάδες εκατό (3.100) κατοίκους, η απελευθέρωση του πληκτρολογίου του EFTPOS έχει μέγιστη διάρκεια πέντε (5) ημέρες, εκτός εάν πρόκειται για τουριστικούς τόπους.

Σε κάθε περίπτωση δεν αναιρείται η υποχρέωση διαβίβασης των δεδομένων αυτών στην ψηφιακή πλατφόρμα myDATA, σύμφωνα με τα οριζόμενα στην υπό στοιχεία Α.1138/2020 (Β’2470) κοινή απόφαση του Υπουργού Οικονομικών και του Διοικητή της ΑΑΔΕ.

Δεν εφαρμόζεται το παρόν πρωτόκολλο σε EFTPOS, αν η επιχείρηση δεν έχει υποχρέωση χρήσης ΦΗΜ και δεν χρησιμοποιεί ΦΗΜ. Επιτρέπεται επίσης η διεκπεραίωση συναλλαγών στο EFTPOS χωρίς σύνδεση ΦΗΜ, σε πρατήρια καυσίμων ή ταξί, όπου ο ΦΗΜ καθοδηγείται από αντλία καυσίμου ή ταξίμετρο αντίστοιχα. Στις περιπτώσεις αυτές, δεν εφαρμόζεται το παρόν πρωτόκολλο.

Η απόφαση αυτή ισχύει από 01-01-2023.

Η απόφαση αυτή, με το παράρτημα, το οποίο αποτελεί αναπόσπαστο μέρος της, να δημοσιευθεί στην Εφημερίδα της Κυβερνήσεως.

Ο ΔΙΟΙΚΗΤΗΣ ΤΗΣ Α.Α.Δ.ΕΓΕΩΡΓΙΟΣ ΠΙΤΣΙΛΗΣ

ΠΙΝΑΚΑΣ ΑΠΟΔΕΚΤΩΝ

• ΑΠΟΔΕΚΤΕΣ ΓΙΑ ΕΝΕΡΓΕΙΑ

Εθνικό Τυπογραφείο (ηλεκτρονική διεύθυνση “webmaster.et@et.gr”), για τη δημοσίευση της απόφασης

Σύνδεσμος Εισαγωγέων και Κατασκευαστών Ταμειακών Μηχανών (ΣΕΚΤ) –Λ. Αθηνών 165 ΤΚ 12461 Χαϊδάρι, για την ενημέρωση των μελών του.

Σύνδεσμος Επιχειρήσεων Πληροφορικής Επικοινωνιών Ελλάδας (ΣΕΠΕ) Αμβροσίου Φραντζή 19 Τ.Κ. 11743 Αθήνα, για την ενημέρωση των μελών του.

ΔΙ.Σ.ΤΕ.ΠΛ. (με παράκληση ανάρτησης στην ιστοσελίδα της Α.Α.Δ.Ε.)

• ΑΠΟΔΕΚΤΕΣ ΓΙΑ ΚΟΙΝΟΠΟΙΗΣΗ

Υπουργείο Οικονομικών

β)Γραφείο κ. Υφυπουργού

Ανεξάρτητη Αρχή Δημοσίων Εσόδων:

Ε.Μ.Π.-Σχολή Ηλεκτρολόγων Μηχανικών &Μηχανικών Υπολογιστών –Τομέας Ηλεκτρικής Ισχύος –Εργαστήριο Υψηλών Τάσεων, Ηρώων Πολυτεχνείου 9, Πολυτεχνειούπολη Ζωγράφου, 15780 Ζωγράφου, Αθήνα

Ε.Μ.Π. –Σχολή Ηλεκτρολόγων Μηχανικών & Μηχανικών Υπολογιστών–Τομέας Συστημάτων Μετάδοσης Πληροφορίας & Τεχνολογίας Υλικών – Εργαστήριο Ασυρμάτων Ζεύξεων και Ηλεκτρομαγνητικής Συμβατότητας, Ηρώων Πολυτεχνείου 9, Πολυτεχνειούπολη Ζωγράφου, 15773 Ζωγράφου, Αθήνα

• ΕΣΩΤΕΡΙΚΗ ΔΙΑΝΟΜΗ

Γραφείο κ. Διοικητή της Α.Α.Δ.Ε.

Διεύθυνση Νομικής Υποστήριξης

Αυτοτελές Τμήμα Συντονισμού, Μεταρρυθμιστικών Δράσεων και Επικοινωνίας (Α.Τ.Σ.ΜΕ.Δ.Ε.)

Προϊσταμένους των Γενικών Διευθύνσεων της Α.Α.Δ.Ε.

Διευθύνσεις της Γενικής Διεύθυνσης Φορολογικής Διοίκησης

Διεύθυνση Διαχείρισης Υποδομών

Διεύθυνση Υπηρεσιών Δεδομένων

Αυτοτελές Tμήμα Ασφάλειας Γ.Δ.ΗΛΕ.Δ

ΠΑΡΑΡΤΗΜΑ

ΔΙΑΣΥΝΔΕΣΗ ΣΥΣΤΗΜΑΤΩΝ ΕΚΔΟΣΗΣ ΣΤΟΙΧΕΙΩΝ ΛΙΑΝΙΚΗΣ ΠΩΛΗΣΗΣ ΚΑΙ

ΤΕΡΜΑΤΙΚΩΝ ΑΠΟΔΟΧΗΣ ΚΑΡΤΩΝ ΠΛΗΡΩΜΩΝ (EFTPOS)

Βασικό πρωτόκολλο επικοινωνίας

Έκδοση : 1.07F

Ημερομηνία: : 22 Δεκεμβρίου 2022

Περιεχόμεν

Εισαγωγή 3

Το γενικό σχήμα 3

Η φυσική σύνδεση 5

Σύνδεση μέσω TCP/IP 5

Σύνδεση μέσω USB, Bluetooth και RS232 5

Ροή και μηνύματα συνοπτικά 6

Συνήθης ροή αγοράς (ή λοιπών συναλλαγών) 7

Ροή προσωρινής καταχώρησης εκδοθείσας απόδειξης ή τιμολογίου από

την ECR στο EFTPOS 9

Ροή σε περίπτωση αδυναμίας επεξεργασίας συναλλαγής 9

Στοιχειώδης ροή ηχούς 9

Ροή εκτέλεσης εντολής ρυθμίσεων 9

Ροή επανάληψης [RESULT] τελευταίας συναλλαγής 10

Ροή επανάληψης [RESULT] για όλες τις εκκρεμείς συναλλαγές 11

Ροή και μηνύματα αναλυτικά 14

Σύνταξη των μηνυμάτων 14

Μήνυμα [ECHO] 15

Μήνυμα [AMOUNT] 16

Μήνυμα [CONFIRMED] 18

Μήνυμα [RESULT] 18

Μήνυμα [ACK-RESULT] 26

Μήνυμα [REGRECEIPT] 27

Μήνυμα [RESEND-ONE] 28

Μήνυμα [RESEND-ALL] 29

Μήνυμα [ERROR] 30

Μήνυμα [SUCCESS] 32

Μήνυμα [CONTROL] 33

Μηνύματα λοιπών συναλλαγών 34

Χειρισμός σφαλμάτων 36

Περιγραφή του μηχανισμού MAC 39

Σύνοψη χειρισμών αντιστοίχισης συνόλων 41

Πιθανά σενάρια βλαβών και διαδικασίες αντιμετώπισής τους 44

Έκδοση και διάθεση αρχικού κλειδιού (master key-ΜΚ) 46

Λήψη του AESΚΕΥ από το ΠΣΦΗΜ για τους ΦΗΜ 49

Εισαγωγή

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

εκτελεστεί στα EFTPOS. Ο όρος ECR (“Electronic Cash Register”) ή ο όρος “ταμειακή μηχανή” ή ο όρος “ΦΗΜ” που χρησιμοποιούνται στην τεχνική περιγραφή, θεωρούνται στα πλαίσια του κειμένου ταυτόσημοι με οποιοδήποτε νόμιμο φορολογικό σύστημα έκδοσης αποδείξεων λιανικής σύμφωνα με την ισχύουσα νομοθεσία (φορολογικές ταμειακές μηχανές, ΑΔΗΜΕ, ΕΑΦΔΣΣ).

Το γενικό σχήμα

Η διασύνδεση αφορά τρία συστήματα: ECR, EFTPOS και ΠΑΡΟΧΟΥΣ ΥΠΗΡΕΣΙΩΝ ΠΛΗΡΩΜΩΝ (ΒΑΝΚ):

Εικόνα 1

Η συνήθης ροή επικοινωνίας ακολουθεί 5 βήματα:

H συναλλαγή ξεκινά από την ECR. Ο χειριστής επιλέγει πληρωμή με κάρτα και η ECR στέλνει σχετικό αίτημα στο EFTPOS.

Το EFTPOS επιβεβαιώνει αμέσως στην ECR τη λήψη του αιτήματος θέτοντάς της σε αναμονή του τελικού αποτελέσματος.

Το EFTPOS συνδέεται στον πάροχο υπηρεσιών πληρωμών για online έγκριση ή εγκρίνει offline ή απορρίπτει offline ή διακόπτει τη συναλλαγή.

Το EFTPOS αποκρίνεται στην ECR με το τελικό αποτέλεσμα: απόρριψη ή έγκριση. Στην έγκριση αποστέλλει στοιχεία της συναλλαγής (όπως αριθμό συναλλαγής, κωδικό έγκρισης κλπ). Το τελικό αποτέλεσμα στέλνεται άμεσα στην ECR, πριν την έναρξη εκτύπωσης από το EFTPOS. Εφόσον η ECR το υποστηρίζει, στα στοιχεία της συναλλαγής περιλαμβάνονται και δεδομένα για εκτύπωση της απόδειξης του EFTPOS από την ECR

Η ECR επιβεβαιώνει τη λήψη του τελικού αποτελέσματος. Αν αυτή η επιβεβαίωση δε φτάσει στο EFTPOS για οποιοδήποτε λόγο, το EFTPOS θέτει σήμανση στη συναλλαγή αυτή ότι δεν έχει πλήρως διεκπεραιωθεί ως προς την ECR.

Βασικές παραδοχές και περιορισμοί :

Μόνο από την ECR μπορεί να ξεκινήσει νέα χρεωστική συναλλαγή (αγορά, αγορά με δόσεις, καταχώρηση προέγκρισης, mailorder). Το EFTPOS έχει κλειδωμένο πληκτρολόγιο και μενού για πραγματοποίηση χρεωστικών συναλλαγών.

Αν εξαιτίας βλάβης του ECR ή βλάβης της επικοινωνίας ECR-EFTPOS, το EFTPOS έχει πραγματοποιήσει χρεωστικές συναλλαγές οι οποίες δεν έχουν καταχωρηθεί στην ECR, τότε προβλέπεται υποχρεωτική διαδικασία αποστολής των συναλλαγών αυτών από το EFTPOS στην ECR (βλ. 4.6 , 4.7) μετά την αποκατάσταση της βλάβης της ECR. Το EFTPOS διατηρεί επί μακρόν τα πιο βασικά στοιχεία των συναλλαγών αυτών σε ξεχωριστό αρχείο για σκοπούς εκ των υστέρων ελέγχου και επαλήθευσης.

Δεν προβλέπεται διακοπή της επεξεργασίας στο EFTPOS με εντολή της ECR. Αν κατά το βήμα 3 η ECR θελήσει διακοπή της επεξεργασίας, τότε αυτό γίνεται χειροκίνητα στο EFTPOS.

To EFTPOS εξυπηρετεί μόνο ένα ECR αίτημα κάθε φορά, δεν τηρεί ουρά αναμονής αιτημάτων και ούτε μπορεί καν να αποκριθεί σε νέο αίτημα όσο διαρκεί η επεξεργασία του τρέχοντος.

Η επικοινωνία δεν περιέχει σε καμία περίπτωση ευαίσθητα δεδομένα συναλλαγής, όπως ακάλυπτο αριθμό κάρτας, cvv2, track2 ή όνομα κατόχου της κάρτας.

Τα EFTPOS θα πρέπει να τηρούν αρχεία καταγραφής συμβάντων (log files) με την ακόλουθη προτεραιότητα και ανάλογα με τις δυνατότητές τους σε χώρο αποθήκευσης και υπολογιστική ισχύ:

Η μορφή καταγραφής των συμβάντων είναι ζήτημα υλοποίησης από τον κάθε κατασκευαστή, αρκεί αυτή να εκπληρώνει το σκοπό της εξακρίβωσης πραγματικών περιστατικών και της επίλυσης τυχόν τεχνικών προβλημάτων.

Στην περίπτωση που αποδίδεται στον εργαζόμενο φιλοδώρημα μέσω κάρτας, υπάρχει η δυνατότητα συγκεκριμένης επιλογής καταχώρισης φιλοδωρήματος στο EFTPOS και αυτόνομης εκτέλεσης με την πληκτρολόγηση του ποσού του φιλοδωρήματος (amount tip) για τη συγκεκριμένη προφορτωμένη ΑΛΠ. Προβλέπεται υποχρεωτική διαδικασία αποστολής των συναλλαγών αυτών από το EFTPOS στην ECR. Τα ποσά των φιλοδωρημάτων τηρούνται ως εκκρεμείς συναλλαγές και αποστέλλονται στην ECR ως πακέτα (tip amount).H ECR επιστρέφει μήνυμα ACK-RESULT στο EFTPOS για κάθε εκκρεμή εγγραφή, ώστε το EFTPOS να μπορεί να κλείσει πακέτο.

Η φυσική σύνδεση

Στη σύνδεση μεταξύ των μερών το EFTPOS ενεργεί ως “server” σε σχέση με την ECR και ως “client” σε σχέση με τον πάροχο υπηρεσιών πληρωμών.

Σύνδεση μέσω TCP/IP

Η σύνδεση μεταξύ EFTPOS και ECR μέσω TCP/IP γίνεται:

• Με απευθείας σύνδεση ECR-EFTPOS. Παραδείγματα: σύνδεση σε δίκτυο LAN με καλώδια Ethernet, σύνδεση WIFI κλπ.

• Μέσω συστήματος middleware για EFTPOS που δεν μπορούν να συνδεθούν με άλλο τρόπο.

Εικόνα 2

To LAN switch μπορεί να είναι εξωτερική συσκευή ή ενσωματωμένο.

Στην περίπτωση σύνδεσης μέσω middleware, επειδή η local IP του EFTPOS κατά κανόνα είναι άγνωστη ή μη προσβάσιμη από την ECR, απαιτείται κάποια επιπλέον υλοποίηση, όπου τη σύνδεση στο middleware θα την ανοίγει το EFTPOS με ένα “logon” και θα την κρατά ανοικτή όσο χρειάζεται, μπαίνοντας το ίδιο σε βρόχο αναμονής αιτημάτων ECR. Tο middleware λειτουργεί ως απλός διαβιβαστής των μηνυμάτων.

Σύνδεση μέσω USB, Bluetooth και RS232

Υποστηρίζεται η σύνδεση μέσω USB, Bluetooth χωρίς να αλλάζει καθόλου το πρωτόκολλο επικοινωνίας.

Υποστηρίζεται επίσης η σύνδεση μέσω RS232, με μοναδική αλλαγή στο πρωτόκολλο την προσθήκη μιας μικρής συμβολοσειράς ως προθέματος σε κάθε ανταλλασσόμενο μήνυμα.

Εικόνα 3

Ροή και μηνύματα συνοπτικά

Χρησιμοποιώντας συμβολικά ονόματα, τα μηνύματα που ανταλλάσσονται μεταξύ ECR και EFTPOS είναι:

[AMOUNT]: Αίτημα έναρξης αγοράς (ECR->EFTPOS)

[CONTROL]:

Εντολή για διάφορες ρυθμίσεις (ECR->EFTPOS)

[SUCCESS]:

Γενικό μήνυμα επιτυχίας (EFTPOS->ECR)

[REGRECEIPT]:

Αίτημα φόρτωσης απόδειξης ή τιμολογίου γιαμεταγενέστερη χρεωστική συναλλαγή (ECR->EFTPOS)

Προαιρετικές επεκτάσεις για άλλες συναλλαγές:

[AMOUNT-INSTALM]:

Αίτημα έναρξης αγοράς με χρήση δόσεων

(ECR->EFTPOS)

[AMOUND-REFUND]:

Αίτημα έναρξης επιστροφής (ECR->EFTPOS)

[AMOUNT-VOID]:

Αίτημα έναρξης ακύρωσης (ECR->EFTPOS)

[AMOUNT-COMPLETION]: Αίτημα έναρξης καταχώρησης προέγκρισης

(ECR->EFTPOS)

[AMOUNT-ΜAIL]:

Αίτημα έναρξης συναλλαγής MAIL ORDER

(ECR->EFTPOS)

Οι ακόλουθες 6 ροές μηνυμάτων είναι επιτρεπτές, οι οποίες εκτελούνται πάντα στην ίδια σύνδεση (στο ίδιο session).

Συνήθης ροή αγοράς (ή λοιπών συναλλαγών)

Τα ανωτέρω τέσσερα μηνύματα ([AMOUNT], [CONFIRMED], [RESULT], [ACKRESULT]) φέρουν έναν κοινό 6-ψήφιο κωδικό (session number), διαφορετικό για κάθε νέα συναλλαγή, τον οποίο δημιουργεί η ECR και χρησιμεύει ως στοιχείο ελέγχου της συνάφειας των μηνυμάτων και αποφυγής κρίσιμων λαθών.

Σχηματική απεικόνιση της συνήθους ροής παρατίθεται στην Εικόνα 4.

POS

t₀

🡨[AMOUNT]

ECR

t1

[CONFIRM]🡪 (amt-1,session-1)

t₂

POS saves thetransaction as approved[RESULT]🡪

t₃

🡨[ACK-RESULT]

POS marks the transaction as “ECR completed”

POS TRANSACTION FILE

Εικόνα 4

Ροή προσωρινής καταχώρησης εκδοθείσας απόδειξης ή τιμολογίου από την ECR στο EFTPOS

Ροή σε περίπτωση αδυναμίας επεξεργασίας συναλλαγής

Στοιχειώδης ροή ηχούς

Ροή εκτέλεσης εντολής ρυθμίσεων

Ροή επανάληψης [RESULT] τελευταίας συναλλαγής

Σχηματική απεικόνιση της ροής επανάληψης [RESULT] παρατίθεται στην Εικόνα 5.

[connection restored]

[RESULT]🡪

🡨[ACK-RESULT] (amt-2,session-2)

POS marks the transaction as “ECR completed”

POS TRANSACTION FILE

Εικόνα 5

Ροή επανάληψης [RESULT] για όλες τις εκκρεμείς συναλλαγές

Παράδειγμα επανάληψης ροής για εκκρεμείς συναλλαγές απεικονίζεται στην Εικόνα 6. Το EFTPOS επαναλαμβάνει την αποστολή [RESULT] μόνο για 2 συναλλαγές:

• Για την ΙD-3 , η οποία αφορά πιστωτική συναλλαγή

• Για την ΙD-4 , η οποία ξεκίνησε από το EFTPOS καθώς αντιστοιχούσε σε απόδειξη που είχε ήδη εκδοθεί από την ECR και η οποία φορτώθηκε στο EFTPOS για την πληρωμή της με κάρτα.

EFTPOS TRANSACTION FILE

Εικόνα 6

Ροή και μηνύματα αναλυτικά

Σύνταξη των μηνυμάτων

Κάθε μήνυμα αποτελείται από μια κεφαλίδα κι ένα κυρίως μέρος ως ακολούθως:

ΕΙΔΙΚΕΣ ΠΕΡΙΠΤΩΣΕΙΣ

Στη σύνδεση μέσω RS232 θα χρησιμοποιείται ως πρόθεμα ολόκληρου του μηνύματος (δηλαδή πριν και από το πρόθεμα μήκους) η συμβολοσειρά “ECR” ή “POS” αντιστοίχως και ως κατάληξη (δηλαδή ως τελευταίο byte του κυρίως μέρους) ένα ψηφίο LRC για συμπληρωματικό έλεγχο ακεραιότητας του μηνύματος (βλ. 5.14) .

Στη σύνδεση μέσω middleware θα χρησιμοποιείται ως πρόθεμα ολόκληρου του μηνύματος η συμβολοσειρά “ACQ< 3-digits-acqId >TID <8-digits-POS-tid> ”, όπου ACQ θα είναι κάποιος καθορισμένος τριψήφιος κωδικός του φορέα εκκαθάρισης.

Το κυρίως μέρος του μηνύματος αποτελείται από ένα πρόθεμα κεφαλαίου λατινικού γράμματος που χαρακτηρίζει τον τύπο του, ακολουθούμενο από πεδία (fields) που κι αυτά κατά κανόνα έχουν ως πρόθεμα ένα κεφαλαίο γράμμα. Κάθε πεδίο μπορεί να υποδιαιρείται σε επιμέρους πεδία (subfields), που η σημασία τους καθορίζεται από τη θέση τους και μόνο.

Ως field separator χρησιμοποιείται το ‘/’ και ως subfield separator το ‘:’. Ως escape χαρακτήρας ορίζεται ο ‘\’, ωστόσο στην πράξη δεν προκύπτει ανάγκη για χρήση escape χαρακτήρα. Έτσι το κυρίως μέρος κάθε μηνύματος ακολουθεί την εξής σύνταξη:

MSG BODY := < msg type >/< field >{/< field >{/ <field> }…} msg type := < letter >

field := {< letter >}< subfield >{:< subfield >{:< subfield >}…}

letter := A | B | C | … | Ζ

subfield := όπως προδιαγράφεται σε κάθε περίπτωση

(τύπος δεδομένων, πλήθος bytes, σημασία)

Για τους ορισμούς τύπων δεδομένων χρησιμοποιούνται οι ακόλουθες συντομογραφίες:

num – numeric, δεξιά στοίχιση και πλήρωση με 0

an – alphanumeric, δεν επιτρέποντα διαστήματα ούτε ειδικοί χαρακτήρες anp – alphanumeric, επιτρέπονται διαστήματα

ans – alphanumeric, επιτρέπονται διαστήματα και ειδικοί χαρακτήρες

Μήνυμα [ECHO]

Στέλνεται από την ECR με επιλογή του χειριστή (συνήθως κατά την εγκατάσταση) για έλεγχο της σύνδεσης με το EFTPOS. Στην ηχώ προστίθενται το terminal ID και το EFTPOS application version.

Σύνταξη :

ECR REQUEST:

X/ <text>

EFTPOS RESPONSE:

X/ <text>/T<tid> : <app-version>

Παράδειγμα :

ECR->EFTPOS: BYTES 23

00 17 |..

45 43 52 30 32 31 30 58 2F 48 65 6C 6C 6F 20 66 |ECR0210X/Hello f

72 6F 6D 20 45 43 52 |rom ECR

EFTPOS->ECR: BYTES 42

00 2A 50 4F 53 30 32 31 30 58 2F 48 65 6C 6C 6F |.*POS0210X/Hello

20 66 72 6F 6D 20 45 43 52 2F 54 36 34 39 39 39 | from ECR/T64999

39 39 39 3A 31 2E 35 2E 32 33 2E 30 |999:8.5.23.0

Μήνυμα [AMOUNT]

Στέλνεται από την ECR κατά την έναρξη μιας νέας αγοράς

Σύνταξη :

ECR REQUEST:

A/S <session number> /F <amount>:< cur-code>:<cur-exp>

/D <datetime>/R<ecr-id> / H<operator-number> / T<receipt number> /M <custom-data>{ / Q<mac> }

Παράδειγμα :

ECR->EFTPOS: BYTES 81

00 51 |.Q

45 43 52 30 32 31 30 41 2F 53 30 30 31 30 30 38 |ECR0210A/S001008 2F 46 32 35 30 30 3A 39 37 38 3A 32 2F 44 32 30 |/F2500:978:2/D20

32 32 30 35 32 34 31 30 32 35 31 37 2F 52 41 42 |220524102517/RAB

43 30 30 31 31 31 32 32 32 2F 48 31 32 31 2F 54 |C00111222/H121/T

31 30 32 30 2F 4D 30 2F 51 35 39 44 31 39 45 37 |1020/M0/Q59D19E7

44 |D

Μήνυμα [CONFIRMED]

Στέλνεται άμεσα από το EFTPOS ως απάντηση στο αρχικό αίτημα αγοράς της ECR, επιβεβαιώνοντας ότι η επεξεργασία του βρίσκεται σε εξέλιξη.

Σύνταξη :

EFTPOS RESPONSE:

A/S <session number> /F <amount> / R<ecr-id> / T<receipt-number>

Παράδειγμα :

EFTPOS->ECR: BYTES 41

00 29 50 4F 53 30 32 31 30 41 2F 53 30 30 31 30 |.)POS0210A/S0010

30 38 2F 46 32 35 30 30 2F 52 41 42 43 30 30 31 |08/F2500/RABC001

31 31 32 32 32 2F 54 31 30 32 30 |11222/T1020

Μήνυμα [RESULT]

Στέλνεται από το EFTPOS ως τελική απάντηση στο αρχικό αίτημα αγοράς (ή άλλης συναλλαγής) της ECR σχετικά με την έκβαση της συναλλαγής.

Η απάντηση μπορεί να έρθει άμεσα (αν αφορά offline απόρριψη ή έγκριση), σε λίγα δευτερόλεπτα (τυπική περίπτωση online έγκρισης) ή ακόμη και περισσότερο από λεπτό αν καθυστερεί η online επικοινωνία ή η εισαγωγή PIN. Συνίσταται ρύθμιση timeout >150 sec στην ECR.

Σύνταξη :

R/S <session number> / R<ecr-id> / T<receipt-number> { :<receipt-number> }

/ Μ<custom-data> /C<rsp- code> {/D <trans-data> {/P <prn-data> }}

▪ Τo πεδίο <trans-data> επιστρέφεται μόνο εφόσον η συναλλαγή εγκρίθηκε, δηλ το < rsp-code> είναι 00.

Τo πεδίο <trans-data> συντίθεται από τα ακόλουθα στοιχεία:

<trans-data> = <card-type>:<txn-type>:<cardpan-masked>: <amount>:<amount-final>:<amount-tip> : <amount-loy >: <amount-cb >: <bankId ( Acqid ) >:<terminalId>: <batch-num>:<rrn>:<stan>:<authcode>: <trans-datetime>:<txn-ecr-status>

▪ Τo πεδίο <prn-data> επιστρέφεται εφόσον α) η συναλλαγή εγκρίθηκε β) το protocol variant στην κεφαλίδα του μηνύματος [AMOUNT] ήταν 02 γ) το protocol variant στην κεφαλίδα του μηνύματος [RESULT] είναι επίσης 02 ¹ . Έχει συνήθως μέγεθος 1-4 Kb και συντίθεται από τις σειρές προς εκτύπωση μαζί με καθορισμένους χαρακτήρες μορφοποίησης, όπως προδιαγράφεται στη συνέχεια.

¹ Μπορεί να πρέπει το POS να τυπώσει την απόδειξη πληρωμής με κάρτα, παρά την ικανότητα της ECR να το τυπώσει εκείνη. Τέτοια μπορεί να είναι η περίπτωση όπου το CVM της κάρτας απαιτεί υπογραφή του κατόχου της. Ειδικά σε υλοποιήσεις όπου η ECR εκτυπώνει μόνο το αντίγραφο απόδειξης πληρωμής με κάρτα του πελάτη, είναι αναγκαία η εκτύπωση του αντιγράφου για τον έμπορο της απόδειξης πληρωμής με κάρτα, από το EFTPOS.

Παραδείγματα :

Παράδειγμα απόρριψης

Παράδειγμα έγκρισης (χωρίς αποστολή δεδομένων εκτύπωσης – “variant-1”):

Παράδειγμα έγκρισης (με αποστολή δεδομένων εκτύπωσης – “variant-2”):

0A 0A 1B 53 41 50 2E 4C 41 42 45 4C 3A 20 56 69 |...SAP.LABEL: Vi

73 61 20 43 72 65 64 69 74 0A 1B 53 41 49 44 3A |sa Credit..SAID:

20 41 30 30 30 30 30 30 30 30 33 31 30 31 30 0A | A0000000031010.

1B 43 1B 42 D6 D5 CB C1 CE D4 C5 20 D4 CF 20 C1 |.C.B

CD D4 C9 C3 D1 C1 D6 CF 0A 1B 43 1B 42 C1 CD D4 | C.B...

C9 C3 D1 C1 D6 CF 20 C5 CC D0 CF D1 CF D5 0A 1B |

43 1B 42 2A 2A 2A 2A 20 C5 D5 D7 C1 D1 C9 D3 D4 |C.B****

CF D5 CC C5 20 2A 2A 2A 2A 0A 1B 4E 0A 0A 0A 0A | ****..N

0A 1B 0C 1B 01 0A 1B 4E C4 4F 4B 49 4D 41 D3 54 | N.OKIMA.T

49 4B 4F D3 20 45 4D D0 4F 50 4F D3 0A 1B 4E 54 |IKO. EM.OPO...NT

45 53 54 20 50 4F 53 0A 1B 4E 31 38 35 34 37 2C |EST POS..N18547,

20 20 D0 45 49 50 41 49 41 D3 0A 0A 1B 53 C1 D1 | .EIPAIA S..

2E D4 C1 CC C5 C9 C1 CA C7 D3 3A 20 41 42 43 30 | : ABC0

30 31 31 31 32 32 32 0A 1B 53 D7 C5 C9 D1 C9 D3 |0111222..S

D4 C7 D3 3A 20 31 32 31 0A 1B 53 C1 D1 2E D3 D5 |...: 121..S

CD C4 C5 D3 C7 D3 3A 20 31 30 35 33 0A 1B 53 C1 | : 1053..S.

D1 2E C1 CB D0 2F C1 D0 D5 3A 20 31 30 34 38 0A | /...: 1048.

0A 1B 4E 32 34 2F 30 35 2F 32 30 32 32 1B 52 1B |..N24/05/2022.R. 4E 31 39 3A 30 32 0A 1B 43 1B 42 56 69 73 61 20 |N19:02..C.BVisa 43 72 65 64 69 74 0A 0A 1B 4E 34 32 32 31 36 34 |Credit...N422164 2A 2A 2A 2A 2A 2A 35 32 35 37 0A 0A 1B 43 1B 53 |******5257...C.S 28 28 28 63 6F 6E 74 61 63 74 6C 65 73 73 29 29 |(((contactless)) 29 0A 1B 43 1B 53 56 49 53 41 20 43 4F 4E 54 41 |)..C.SVISA CONTA 43 54 4C 45 53 53 0A 1B 43 1B 42 C1 C3 CF D1 C1 |CTLESS..C.B

2D 53 41 4C 45 0A 1B 42 D0 CF D3 CF 2F C1 CC D4 |-SALE..B /... 3A 1B 52 1B 42 35 2C 30 30 20 45 55 52 0A 0A 1B |:.R.B5,00 EUR...

4E C1 D1 2E D4 C5 D1 CC C1 D4 C9 CA CF D5 3A 20 |N :

36 34 39 39 39 39 39 39 0A 1B 4E C1 D1 2E D0 C1 |64999999..N

CA C5 D4 CF D5 3A 20 31 32 36 0A 1B 4E C1 D1 2E | : 126..N...

D3 D5 CD C1 CB CB C1 C3 C7 D3 3A 20 38 39 0A 1B | : 89..

4E CA D9 C4 2E C5 C3 CA D1 C9 D3 C7 D3 3A 20 38 |N : 8

39 30 37 35 35 0A 1B 4E 52 52 4E 3A 20 32 31 34 |90755..NRRN: 214 34 33 30 32 35 33 30 31 36 0A 0A 1B 53 4D 49 44 |430253016...SMID 3A 20 31 32 33 34 38 31 34 20 30 30 30 37 0A 1B |: 1234814 0007..

53 4C 31 31 20 76 31 2E 35 2E 32 33 2E 30 0A 0A |SL11 v1.5.23.0.. 1B 53 41 50 2E 4C 41 42 45 4C 3A 20 56 69 73 61 |.SAP.LABEL: Visa 20 43 72 65 64 69 74 0A 1B 53 41 49 44 3A 20 41 | Credit..SAID: A 30 30 30 30 30 30 30 30 33 31 30 31 30 0A 1B 43 |0000000031010..C 1B 42 C1 CD D4 C9 C3 D1 C1 D6 CF 20 D0 C5 CB C1 |.B

D4 C7 0A 1B 43 1B 42 2A 2A 2A 2A 20 C5 D5 D7 C1 | C.B****

D1 C9 D3 D4 CF D5 CC C5 20 2A 2A 2A 2A 0A 1B 4E | ****..N

0A 0A 0A 0A 0A |

ECR->EFTPOS: BYTES 40

00 28 |.(

45 43 52 30 32 31 30 52 2F 53 30 30 31 30 35 33 |ECR0210R/S001053 2F 52 41 42 43 30 30 31 31 31 32 32 32 2F 46 35 |/RABC00111222/F5 30 30 2F 54 31 30 34 38 |00/T1048

[220524 190216] ECR connection closed

Εικόνα 7

Μήνυμα [ACK-RESULT]

Στέλνεται από την ECR ως επιβεβαίωση λήψης του [RESULT]

Σύνταξη :

ECR RESPONSE:

R/S <session number> / R<ecr-id> /F <amount>

/ T<receipt-number> { :<receipt-number> }

Παράδειγμα : στην ενότητα 5.5 για τις περιπτώσεις 2 και 3

Μήνυμα [REGRECEIPT]

Στέλνεται από την ECR με στοιχεία ΑΠΛ που εκδόθηκε για ετεροχρονισμένη πληρωμή (π.χ για παράδοση κατ’ οίκον). Πρόκειται για τη διαδικασία φόρτωσης στο EFTPOS αποδείξεων ή τιμολογίων που ήδη εκδόθηκαν από τον ΦΗΜ, και τα οποία πρέπει να εξοφληθούν με κάρτα αργότερα.

Το EFTPOS καταχωρεί τα στοιχεία της απόδειξης (ποσό, session number, receipt num ber) και τα έχει διαθέσιμα προς χρήση για 24 ώρες.

Είναι ίδιο με το μήνυμα [AMOUNT] με εξαίρεση το αρχικό σύμβολο που είναι W.

Το πεδίο custom-data μπορεί να φέρει κάποια σύντομη σημείωση, ως ελεύθερο κείμενο, σχετική με την πληρωμή.

Σύνταξη :

ECR REQUEST:

W/S <session number> /F <amount>:< cur-code>:<cur-exp>

/D <datetime>/R<ecr-id> / H<operator-number> / T<receipt number>

/M <custom-data>{ / Q<mac> }

Παράδειγμα :

[220711 115333] ECR connection from [10.1.101.217]

ECR->EFTPOS: BYTES 81 00 51 |.Q

45 43 52 30 31 31 30 57 2F 53 30 30 31 35 37 33 |ECR0110W/S001573 2F 46 35 30 30 30 3A 39 37 38 3A 32 2F 44 32 30 |/F5000:978:2/D20

32 32 30 37 31 31 31 30 35 30 30 39 2F 52 41 42 |220711105009/RAB

43 30 30 31 31 31 32 32 32 2F 48 31 32 31 2F 54 |C00111222/H121/T

31 32 32 38 2F 4D 30 2F 51 33 30 41 44 44 38 41 |1228/M0/Q30ADD8A

33 |3

EFTPOS->ECR: BYTES 12 00 0C 50 4F 53 30 31 31 30 45 2F 30 30 30 |..POS0110E/000

Μήνυμα [RESEND-ONE]

Στέλνεται από την ECR μετά από επιλογή του χειριστή, στην περίπτωση που το EFTPOS ενέκρινε τη συναλλαγή αλλά απέτυχε η αποστολή του [RESULT].

Σύνταξη :

ECR REQUEST:

Ο/S <session number> /F <amount>:<cur-code>:<cur-exp>

/ R<ecr-id> / T<receipt-number> {/ Q<mac> }

Παράδειγμα :

[220524 193308] ECR connection from [10.1.101.135]

ECR->EFTPOS: BYTES 56

00 38 |.8

45 43 52 30 31 31 30 4F 2F 53 30 30 31 30 35 38 |ECR0110O/S001058 2F 46 31 35 30 3A 39 37 38 3A 32 2F 52 41 42 43 |/F150:978:2/RABC

30 30 31 31 31 32 32 32 2F 54 31 30 35 31 2F 51 |00111222/T1051/Q

46 37 31 36 37 41 39 46 |F7167A9F

[220524 193309] ECR request

EFTPOS->ECR: BYTES 145

00 91 50 4F 53 30 31 31 30 52 2F 53 30 30 31 30 |..POS0110R/S0010

35 38 2F 52 41 42 43 30 30 31 31 31 32 32 32 2F |58/RABC00111222/

54 31 30 35 31 2F 4D 30 2F 43 30 30 2F 44 56 69 |T1051/M0/C00/DVi

73 61 20 43 72 65 64 69 74 3A 30 30 3A 34 32 32 |sa Credit:00:422

31 36 34 2A 2A 2A 2A 2A 2A 35 32 35 37 3A 31 35 |164******5257:15

30 3A 31 35 30 3A 30 3A 30 3A 30 3A 31 31 3A 36 |0:150:0:0:0:11:6

34 39 39 39 39 39 39 3A 31 32 36 3A 32 31 34 34 |4999999:126:2144

33 30 32 35 33 30 31 39 3A 39 32 3A 38 39 30 37 |30253019:92:8907

35 38 3A 32 30 32 32 30 35 32 34 31 39 33 32 30 |58:2022052419320

31 3A 31 |1:1

ECR->EFTPOS: BYTES 40

00 28 |.(

45 43 52 30 31 31 30 52 2F 53 30 30 31 30 35 38 |ECR0110R/S001058

2F 52 41 42 43 30 30 31 31 31 32 32 32 2F 46 31 |/RABC00111222/F1

35 30 2F 54 31 30 35 31 |50/T1051

[220524 193310] ECR connection closed

Μήνυμα [RESEND-ALL]

Στέλνεται από την ECR μετά από επιλογή του χειριστή, στην περίπτωση που το EFTPOS δεν μπορεί να κλείσει πακέτο λόγω συναλλαγών σε εκκρεμότητα ως προς την ECR.

Σύνταξη :

ECR REQUEST:

L/ R<ecr-id> /D <datetime> {/ Q<mac> }

Παράδειγμα :

Μήνυμα [ERROR]

Στέλνεται από το EFTPOS ως άμεση απάντηση στο αρχικό αίτημα της ECR στις περιπτώσεις που δεν είναι δυνατή η επεξεργασία του.

Σύνταξη :

EFTPOS RESPONSE:

E /<error code>

Επεξηγήσεις ανά κωδικό :

Κωδικός 001 : μη υποστηριζόμενο πρωτόκολλο. Ωστόσο η απάντηση του EFTPOS χρησιμοποιεί στην κεφαλίδα τα ίδια version και variant του αιτήματος της ECR.

Κωδικός 002 : το session number είναι το ίδιο με αυτό της προηγούμενης σ/γής.

Κωδικός 003 : συντακτικό λάθος στο σώμα του μηνύματος.

Κωδικός 004 : η ταμειακή στέλνει ποσό σε διαφορετικό νόμισμα από αυτό του EFTPOS.

Κωδικός 100 : εσωτερικό πρόβλημα του EFTPOS.

Κωδικός 500/501 : στέλνεται στην περίπτωση μη έγκυρου [CONTROL] μηνύματος.

Κωδικός 502 : στο αίτημα ECR λείπει MAC πεδίο ενώ είναι υποχρεωτικό

Κωδικός 503 : το αίτημα ECR έχει λάθος MAC

Κωδικός 504 : το EFTPOS δεν μπορεί να υποστηρίξει MAC (π.χ. λείπουν κλειδιά)

Κωδικός 777 : μη συνδεδεμένο EFTPOS (δεσμευμένος κωδικός για middleware)

Κωδικός 999 : το EFTPOS είναι κατειλημμένο (π.χ. εκτελούνται χειρισμοί από το μενού, επικοινωνεί για παραμέτρους κλπ).

Σημείωση: κατά το χρονικό διάστημα εξυπηρέτησης συναλλαγής προερχόμενης από την ECR, το EFTPOS δεν μπορεί να αποκριθεί σε άλλο αίτημα ούτε κατά την εκτύπωση της απόδειξης της τρέχουσας σ/γής.

Παραδείγματα :

Αίτημα από ECR σε κατειλημμένο EFTPOS

ECR->EFTPOS: BYTES 80

00 50 |.P

45 43 52 30 32 31 30 41 2F 53 30 30 31 30 31 35 |ECR0210A/S001015 2F 46 32 35 30 3A 39 37 38 3A 32 2F 44 32 30 32 |/F250:978:2/D202

32 30 35 32 34 31 32 33 32 32 39 2F 52 41 42 43 |20524123229/RABC

30 30 31 31 31 32 32 32 2F 48 31 32 31 2F 54 31 |00111222/H121/T1

30 32 37 2F 4D 30 2F 51 33 42 35 34 30 37 33 46 |027/M0/Q3B54073F EFTPOS->ECR: BYTES 12

00 0C 50 4F 53 30 32 31 30 45 2F 39 39 39 |..POS0210E/999

Αίτημα από ECR που έχει ρυθμισμένο άλλο νόμισμα

ECR->EFTPOS: BYTES 81

00 51 |.Q

45 43 52 30 32 31 30 41 2F 53 30 30 31 30 31 36 |ECR0210A/S001016

2F 46 32 30 30 30 3A 36 34 31 3A 32 2F 44 32 30 |/F2000:641:2/D20

32 32 30 35 32 34 31 32 33 35 32 30 2F 52 41 42 |220524123520/RAB

43 30 30 31 31 31 32 32 32 2F 48 31 32 31 2F 54 |C00111222/H121/T

31 30 32 38 2F 4D 30 2F 51 46 38 32 38 36 42 39 |1028/M0/QF8286B9

32 |2

EFTPOS->ECR: BYTES 12

00 0C 50 4F 53 30 32 31 30 45 2F 30 30 34 |..POS0210E/004

Αίτημα από ECR με μη υποστηριζόμενο protocol version ή variant

ECR->EFTPOS: BYTES 80

00 50 |.P

45 43 52 30 33 30 33 41 2F 53 30 30 30 36 37 35 |ECR0303A/S000675

2F 46 32 35 30 30 3A 39 37 38 3A 32 2F 44 32 30 |/F2500:978:2/D20

32 31 31 31 32 32 31 31 35 39 32 37 2F 52 38 2F |211122115927/R8/

48 31 32 31 2F 54 30 30 30 36 37 34 2F 47 3A 30 |H121/T000674/G:0

3A 30 3A 30 3A 30 2F 4D 31 32 33 34 35 36 37 38 |:0:0:0/M12345678

EFTPOS->ECR: BYTES 12

00 0C 4D 45 4C 30 33 30 33 45 2F 30 30 31 |..POS0303E/001

Μήνυμα [SUCCESS]

Αποτελεί ειδική περίπτωση μηνύματος [ERROR] με κωδικό 000

Σύνταξη :

EFTPOS RESPONSE:

E/000

Μήνυμα [CONTROL]

Γενικό μήνυμα για έλεγχο συμπεριφοράς του EFTPOS από την ECR.

Σύνταξη :

ECR REQUEST:

U /R<ecr-id>/ C <command-name> : <parameter-value>{:paramater-value}

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

Παραδείγματα :

Άνοιγμα – κλείσιμο πληκτρολογίου τερματικού (πιστωτικές συναλλαγές μόνο):

ECR->EFTPOS: BYTES 35

00 23 |.#

45 43 52 30 32 31 30 55 2F 52 41 42 43 30 30 31 |ECR0210U/RABC001

31 31 32 32 32 2F 43 55 4E 42 49 4E 44 5F 50 4F |11222/CUNBIND_PO

53 3A 31 |S:1

EFTPOS->ECR: BYTES 12

Επιτυχής αποστολή ΜΑC session κλειδιού:

ECR->EFTPOS: BYTES 68

44 |.D

45 43 52 30 32 31 30 55 2F 52 41 42 43 30 30 31 |ECR0210U/RABC001

31 31 32 32 32 2F 43 4D 41 43 5F 4B 3A 31 45 44 |11222/CMAC_K:1ED

39 46 37 41 45 30 42 32 35 30 39 32 38 31 42 42 |9F7AE0B2509281BB

43 32 44 45 33 38 45 46 32 41 31 32 42 3A 43 43 |C2DE38EF2A12B:CC

35 46 46 46 |5FFF

EFTPOS->ECR: BYTES 12

00 0C 50 4F 53 30 32 31 30 45 2F 30 30 30 |..POS0210E/000

Μηνύματα λοιπών συναλλαγών

Έχουν σύνταξη, περιεχόμενο και ροή ακριβώς όπως και το [AMOUNT] με μόνη διαφορά το αρχικό σύμβολο, το οποίο θα είναι και πρόθεμα στο αντίστοιχο μήνυμα [CONFIRM].

Όποια συμπληρωματικά στοιχεία είναι απαραίτητα για την ακύρωση, την επιστροφή κλπ (π.χ. αριθμός αρχικής συναλλαγής) εισάγονται πια στο EFTPOS από τον χειριστή και δε λαμβάνονται από την ECR.

ECR REQUEST (AMOUNT-INSTALM):

I/S <session number> /F <amount>:< cur-code>:<cur-exp> /D <datetime> / R<ecr-id> / H<operator-number> / T<receipt number> /M <custom-data> { /Q<mac> }

EFTPOS CONFIRMATION:

I/S <session number> /F <amount> / R<ecr-id> / T<receipt number>

ECR REQUEST (AMOUNT-REFUND):

Ζ/S <session number> /F <amount>:< cur-code>:<cur-exp> /D <datetime> / R<ecr-id> / H<operator-number>

/ T<receipt number> /M <custom-data> { /Q<mac> }

EFTPOS CONFIRMATION:

Z/S <session number> /F <amount> / R<ecr-id> / T<receipt number>

ECR REQUEST (AMOUNT-VOID):

V/S <session number> /F <amount>:< cur-code>:<cur-exp>

/D <datetime>/R<ecr-id> / H<operator-number>

/ T<receipt number> /M <custom-data> { /Q<mac> }

EFTPOS CONFIRMATION:

V/S <session number> /F <amount> / R<ecr-id> / T<receipt number>

ECR REQUEST (AMOUNT-COMPLETION):

P/S <session number> /F <amount>:< cur-code>:<cur-exp>

/D <datetime>/R<ecr-id> / H<operator-number>

/ T<receipt number> /M <custom-data> { /Q<mac> }

EFTPOS CONFIRMATION:

P/S <session number> /F <amount> / R<ecr-id> / T<receipt number>

ECR REQUEST (AMOUNT-MAIL):

M/S <session number> /F <amount>:< cur-code>:<cur-exp>

/D <datetime>/R<ecr-id> / H<operator-number>

/ T<receipt number> /M <custom-data> { /Q<mac> }

EFTPOS CONFIRMATION:

M/S <session number> /F <amount> / R<ecr-id> / T<receipt number>

Στην περίπτωση προφορτωμένων αποδείξεων μέσω μηνύματος REGRECEIPT, η επιλογή του τύπου της χρεωστικής συναλλαγής μπορεί να γίνει εκ των υστέρων μέσω μενού επιλογής στο EFTPOS. Μετά την επιλογή απόδειξης ακολουθεί η επιλογή του τύπου της συναλλαγής π.χ.: ΑΓΟΡΑ, ΔΟΣΕΙΣ, ΚΑΤΑΧΩΡΗΣΗ ΠΡΟΕΓΚΡΙΣΗΣ, MAIL ORDER, OFFLINE ΕΓΚΡΙΣΗ.

Για τη συναλλαγή ΤΟΠΙΚΗ ΕΓΚΡΙΣΗ (η οποία είναι υπό κατάργηση από τα τραπεζικά ιδρύματα) δεν προβλέπεται ξεχωριστός τύπος μηνύματος. Θα πραγματοποιείται μόνο ως προφορτωμένη απόδειξη.

Χειρισμός σφαλμάτων

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

• Είτε πρόβλημα της φυσικής σύνδεσης και του δικτύου που απαιτεί ανθρώπινη παρέμβαση

• Είτε εσωτερικό προγραμματιστικό λάθος και ελλιπή χειρισμό κάποια συγκυρίας

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

Το πρωτόκολλο για τέτοια σπάνια σφάλματα δεν προβλέπει μηχανισμούς επανάληψης της μετάδοσης ή αυτόματης διόρθωσης δεδομένων. Αυτό θα περιέπλεκε ανώφελα την υλοποίηση, δεδομένου κιόλας ότι η ακεραιότητα της μετάδοσης θεωρείται εξασφαλισμένη στις συνδέσεις TCP/IP και USB και για τόσο μικρό μέγεθος δεδομένων.

Κατ’ εξαίρεση για τη σύνδεση με RS232, μπορεί να υλοποιηθεί συμπληρωματικά μηχανισμός επιβεβαίωσης γνωστός από την εποχή των ασύγχρονων modem, όπου η κάθε πλευρά στο τέλος του εξερχόμενου μηνύματος προσθέτει ένα byte ελέγχου (LRC) ως αποτέλεσμα διαδοχικών XOR επί των χαρακτήρων που αποστέλλονται.

Ο λήπτης αν υπολογίσει διαφορετικό LRC από το δηλωθέν στο μήνυμα, απαντά με ένα μοναδικό χαρακτήρα ΝΑΚ (0x15) αιτώντας την επανάληψη της αποστολής ή, μετά από 3 επαναλήψεις, διακόπτει την επικοινωνία ως ατελέσφορη.

Ακολουθεί σύνοψη των περιπτώσεων σε ένα τυπικό κύκλο αγοράς που μπορεί να προκύψουν σφάλματα και των ενδεδειγμένων χειρισμών από πλευράς EFTPOS και ECR.

ΠΕΡΙΠΤΩΣΗ 1 (EFTPOS): Στο [t0] το EFTPOS είναι εκτός ρεύματος ή μη συνδεδεμένο στην ECR

Η ECR οφείλει να εγκαταλείψει την προσπάθεια σύνδεσης και να αναφέρει στο χειριστή αδυναμία σύνδεσης.

ΠΕΡΙΠΤΩΣΗ 2 (EFTPOS): Στο [t0] το EFTPOS λαμβάνει:

Για το a) το EFTPOS πρέπει να αγνοήσει και να απορρίψει τα δεδομένα και κατά προτίμηση να ενημερώσει το χειριστή τυπώνοντας ή εμφανίζοντας σχετικό μήνυμα.

Για το b) το EFTPOS πρέπει να απαντήσει με το αντίστοιχο μήνυμα λάθους (001, 002, 003, 004 κοκ) όπως περιγράφεται στην ενότητα 5.10.

ΠΕΡΙΠΤΩΣΗ 3 (EFTPOS): Στο [t1] το EFTPOS αντιλαμβάνεται αποτυχία αποστολής CONFIRM AMOUNT λόγω προβλήματος επικοινωνίας.

Το EFTPOS δεν πρέπει να προχωρήσει στην εκτέλεση της συναλλαγής παρά να εμφανίσει ή να εκτυπώσει σχετικό μήνυμα.

ΠΕΡΙΠΤΩΣΗ 4 (ECR): To μήνυμα CONFIRMED

Για το 4.a) η ECR μετά παρέλευση 5 sec μπορεί να ζητήσει επιβεβαίωση του χειριστή για διακοπή της προσπάθειας ή συνέχιση της αναμονής

Για το 4.b) η ECR αναφέρει το σχετικό λάθος και διακόπτει την επικοινωνία. Ειδικά για την περίπτωση του λάθους 503 και 504, η ECR μπορεί να στείλει μία φορά CONTROL μήνυμα με MAC session key και να επαναλάβει την αποστολή.

Για το 4.c) η ECR πρέπει να διακόψει την επικοινωνία με το EFTPOS και να εμφανίσει σχετικό μήνυμα ότι το σύστημα βρίσκεται σε μη έγκυρη κατάσταση.

Αν το EFTPOS είχε λάβει σωστά το αρχικό αίτημα και είχε εγκρίνει τη συναλλαγή, τότε θα επιχειρήσει να στείλει ανεπιτυχώς RESULT και η συναλλαγή θα αποθηκευτεί με ecr txn status 1. Σε αυτήν την περίπτωση η αποστολή RESEND- ONE εκ μέρους της ECR μπορεί να ολοκληρώσει επιτυχώς την επικοινωνία.

Για το 4.d) η ECR πρέπει να αγνοήσει το μήνυμα που για κάποιο λόγο ήρθε καθυστερημένο από προηγούμενη μη ολοκληρωμένη συναλλαγή και να περιμένει την έλευση του CONFIRMED (ή του ERROR).

ΠΕΡΙΠΤΩΣΗ 5 (ECR): Το διάστημα αναμονής t2 και t1 διαρκεί πολύ. Υπάρχουν δύο πιθανές αιτίες:

Η ECR πρέπει να παρέχει τη δυνατότητα διακοπής της επικοινωνίας. Τότε:

Στην περίπτωση 5.a) το EFTPOS τελικά λαμβάνει έγκριση και στέλνει RESULT μήνυμα, αλλά αυτό δε φτάνει στην ECR λόγω διακοπής της σύνδεσης Εναπόκειται στο χειριστή να κάνει τις απαιτούμενες ενέργειες, όπως το να εκτελέσει RESEND-ΟΝΕ.

Στην περίπτωση 5.b): απαιτούνται οι ανάλογες ενέργειες του χειριστή και της τεχνικής υποστήριξης.

ΠΕΡΙΠΤΩΣΗ 6: Στο [t2] η ECR δε λαμβάνει έγκυρη απάντηση στο RESULT (σκουπίδια, λάθος μήνυμα ή λάθος στοιχεία)

Η ECR θα πρέπει να διακόψει την επικοινωνία και να εμφανίσει σχετικό μήνυμα. Εναπόκειται στο χειριστή να κάνει τις απαιτούμενες ενέργειες, όπως το να ελέγξει το αν η συναλλαγή εγκρίθηκε από το EFTPOS και να εκτελέσει RESEND-ΟΝΕ.

Το EFTPOS εφόσον διαπιστώνει την αποτυχία αποστολής RESULT εμφανίζει ή εκτυπώνει σχετικό μήνυμα και καταχωρεί τη συναλλαγή (αν εγκρίθηκε) με ecr txn status 1.

ΠΕΡΙΠΤΩΣΗ 7 (EFTPOS): Στο [t3] το EFTPOS δε λαμβάνει ACK-RESULT

Αυτό μπορεί να οφείλεται είτε σε αποτυχία αποστολής του RESULT είτε σε εσωτερικό πρόβλημα της ECR είτε σε πρόβλημα επικοινωνίας κατά την αποστολή του ACK-RESULT.

Το EFTPOS καταχωρεί τη συναλλαγή με ecr txn status 1

Περιγραφή του μηχανισμού MAC

Ο σχετικός μηχανισμός του MAC (message authentication checksum) από πλευράς υλοποίησης για την επικοινωνία των δύο μερών συνοψίζεται στην Εικόνα 8.

1) Στο αρχικό στάδιο προετοιμασίας συμφωνείται μεταξύ των παρόχων EFTPOS και ECR η εμφύτευση σε αμφότερες τις συσκευές ενός κοινού αρχικού κλειδιού (master key - ΜΚ), με διαδικασίες και πρακτικές που θα το προστατεύουν από το να διαρρεύσει.

H διαδικασία περιγράφεται στο κεφάλαιο «Έκδοση και διάθεση αρχικού κλειδιού (master key-ΜΚ)»

2) Η ECR παράγει ένα ψευδοτυχαίο session κλειδί (SK) για χρήση.

3) Μέσω ροής ελέγχου ([CONTROL] μήνυμα), η ECR στέλνει στο EFTPOS το SK κρυπτογραφημένο υπό το ΜΚ με T-DES

4) Το EFTPOS αποκρυπτογραφεί το SK υπό το MK και το αποθηκεύει για χρήση.

5) Κατά τις ροές των συναλλαγών είναι το SK που χρησιμοποιείται για έλεγχο εγκυρότητας του αποστολέα των αιτημάτων.

Tο SK μπορεί να ανανεώνεται τακτικά με χρήση [CONTROL] μηνύματος από την ECR.

Το ΜΚ μπορεί να ανανεώνεται σε πιο αραιά χρονικά διαστήματα, με διαδικασίες και μηχανισμούς που θα συμφωνούν από κοινού οι πάροχοι των EFTPOS και των ECR.

Προτείνεται η χρήση T-DES MAC αλγορίθμου (του συνήθους mode CBC 1) με double length κλειδί (16 bytes).

Παράδειγμα κρυπτογράφησης session κλειδιού και υπολογισμού MAC

Test ΜΚ (plain): ABCDEF01234567899876543210ABCDEF (KCV: 48934A)

Test SΚ (plain): 12340000ABCD111122223333FFFFDDDD (KCV: CC5FFF)

Test SΚ (encr): 1ED9F7AE0B2509281BBC2DE38EF2A12B

Message:

Ι A/S000922/F2000:978:2/D20220513150958/RABC00111222/H121/T000922/M00000000 1

MAC: 4540A2547CFBA23A

Στοιχείο mac : /Q4540A254

Ο υπολογισμός του MAC του παραπάνω παραδείγματος γίνεται ως εξής:

Σύνοψη χειρισμών αντιστοίχισης συνόλων

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

ΣΤΗ ΝΕΑ ΔΙΑΣΥΝΔΕΣΗ :

Κάθε συναλλαγή του EFTPOS πρέπει να έχει αντιστοίχιση σε απόδειξη της ECR.

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

Σε κάθε περίπτωση, οι συναλλαγές στο EFTPOS που έγιναν χωρίς επικοινωνία της ECR έχουν διακριτή σήμανση τόσο στις αποδείξεις όπως και στις ημερήσιες αναφορές του EFTPOS, όπως:

• Σ/ΓΗ POS-3: αν ξεκίνησε από το EFTPOS με βάση προφορτωμένη απόδειξη ή τιμολόγιο που εκδόθηκε ήδη από την ECR όπου χρησιμοποιήθηκαν περισσότερες κάρτες για την ίδια αγορά.

• Σ/ΓΗ POS-4: πιστωτική συναλλαγή που έγινε στο EFTPOS αυτόνομα χωρίς χρήση ΦΗΜ, ή χρεωστική συναλλαγή που έγινε στο EFTPOS αυτόνομα, λόγω βλάβης της ECR ή βλάβης υποδομής, κατόπιν έγκρισης από το ΠΣ ΦΗΜ.

ΤΑ ΣΥΝΗΘΗ ΣΕΝΑΡΙΑ :

1) Αγορά στην ECR με μετρητά

2) Αγορά στην ECR

με κάρτα, αλλά ο πελάτης τελικά δεν είχε μαζί του κάρταΔιακόπτεται από το EFTPOS και η ECR λαμβάνει [RESULT] απόρριψης.

3) Αγορά στην ECR με χρήση κάρτας και ομαλή επικοινωνία EFTPOS-ECR

Το EFTPOS λαμβάνει αυτόματα, καταχωρεί και εκτυπώνει στην απόδειξή του: session number (ΑΡ.ΣΥΝΔΕΣΗΣ) , ecr Id (ΑΡ.ΜΗΤΡΩΟΥ ΜΗΧΑΝΗΣ) , receiptnumber (ΑΡ. ΑΠΟΔΕΙΞΗΣ) .

4) Αγορά στην ECR με χρήση κάρτας και προβληματική ολοκλήρωση επικοινωνίας EFTPOS-ECR

• Το EFTPOS λαμβάνει αυτόματα, καταχωρεί και εκτυπώνει: session number , ecrId , receipt-number .

• Η ECR δε λαμβάνει την τελική απάντηση του EFTPOS και δεν τυπώνει απόδειξη. Tο EFTPOS σημειώνει τη σχετική εγγραφή ως εκκρεμή ως προς την ECR . Στην απόδειξη του EFTPOS εκτυπώνεται συμπληρωματικά “**Σ/ΓΗ POS-1**”.

• Ο χειριστής της ECR μπορεί να ζητήσει από το EFTPOS επανάληψη της τελικής απάντησης (RESEND ONE π.χ. με μια επιλογή « POS ΞΑΝΑΣΤΕΙΛΕ ») και να τυπώσει απόδειξη. Τότε το EFTPOS σημειώνει τη σχετική εγγραφή ως διεκπεραιωθείσα ως προς την ECR .

5) Αγορά στο EFTPOS κατά την παράδοση κατ’ οίκον

To EFTPOS έχει λάβει κάποια «προφορτωμένη» απόδειξη ή τιμολόγιο από την ECR μέσω της ροής REGRECEIPT με τα στοιχεία της (ποσό, ecrid, session number, receipt number, custom data) και εκτελεί ετεροχρονισμένα και αυτόνομα μέσω ειδικής επιλογής χειρισμού μία ή περισσότερες χρεωστικές ή πιστωτικές συναλλαγές για την συγκεκριμένη προφορτωμένη απόδειξη, χωρίς ωστόσο το αλγεβρικό σύνολο των συναλλαγών αυτών να υπερβαίνει το συνολικό ποσό της προφορτωμένης απόδειξης.

Στην απόδειξη του EFTPOS εκτυπώνεται η σήμανση “**ΣΥΝ/ΓΗ POS-2**”

6) Εξόφληση πολλών προφορτωμένων αποδείξεων με μία χρεωστική συναλλαγή

Το EFTPOS έχει λάβει αρκετές προφορτωμένες αποδείξεις ή τιμολόγια από την ECR μέσω της ροής REGRECEIPT με τα στοιχεία τους (ποσό, ecrid, session number, receipt number, custom data) και εκτελεί ετεροχρονισμένα και αυτόνομα μέσω ειδικής επιλογής χειρισμού μία χρεωστική συναλλαγή εξόφλησης επιλέγοντας περισσότερες από μία προφορτωμένες αποδείξεις ή τιμολόγια, με τον περιορισμό πάντοτε της μη πληκτρολόγησης ποσού.

Στην απόδειξη του POS εκτυπώνεται η σήμανση “**ΣΥΝ/ΓΗ POS-3**”.

ΚΛΕΙΣΙΜΟ ΠΑΚΕΤΟΥ ΣΤΟ EFTPOS :

Εφόσον το EFTPOS εντοπίζει πιστωτικές συναλλαγές που εκτελέστηκαν αυτόνομα ή χρεωστικές συναλλαγές που εκτελέστηκαν με προφορτωμένες αποδείξεις ή τιμολόγια της ECR, δε θα επιτρέπει την εκτέλεση της ενέργειας και θα παραπέμπει στην ECR για τακτοποίηση των εκκρεμοτήτων μέσω επιλογής με ονομασία π.χ. « ΕΛΕΓΧΟΣ ΠΑΚΕΤΟΥ POS» .

Η επιλογή « ΕΛΕΓΧΟΣ ΠΑΚΕΤΟΥ POS» εκτελεί τη ροή RESEND-ALL όπου η ECR λαμβάνει μία-μία τις εκκρεμείς εγγραφές από το EFTPOS και επιστρέφει κάποιο sessionId.

Σε κάθε περίπτωση η ECR θα πρέπει επιστρέψει ένα ACK-RESULT μήνυμα στο EFTPOS για κάθε εκκρεμή εγγραφή ώστε το EFTPOS να μπορεί να κλείσει πακέτο.

Στο EFTPOS τηρείται επί μακρόν ξεχωριστό αρχείο με τα βασικά στοιχεία των συναλλαγών που εστάλησαν με RESEND-ALL. Συγκεκριμένα για κάθε συναλλαγή τηρούνται τα ακόλουθα στοιχεία:

• Ημερομηνία-χρόνος

• Τύπος (αγορά, ακύρωση, …)

• Ποσό

• Κατηγορία επικοινωνίας με την ECR (0,1,2,3,4,5)

• ecrId

• Session Id

Η χρονική διάρκεια τήρησης των εγγραφών αυτών περιορίζεται από το αποθηκευτικό χώρο του EFTPOS και την ημερήσια εμφάνιση εκκρεμών εγγραφών. Ως τυπικό όριο τίθενται οι 1000 εγγραφές.

Σε περίπτωση λειτουργίας του EFTPOS με βλάβη ECR, όχι όμως στην περίπτωση βλάβης υποδομής, επιτρέπεται το EFTPOS να εκτελέσει κλείσιμο πακέτου, με την προϋπόθεση της μη διαγραφής των εκκρεμών συναλλαγών προς την ECR. Η διάκριση στο EFTPOS αν πρόκειται για βλάβη ECR ή βλάβη υποδομής, προκύπτει από την τιμή του πεδίου UNLTime που έλαβε το EFTPOS από το ΠΣΦΗΜ Esend κατά την δήλωση της βλάβης. Ειδικότερα, αν το πεδίο UNLTime έχει τιμή μεγαλύτερη του 12, πρόκειται για βλάβη ECR, ενώ αν έχει τιμή μικρότερη ή ίση του 12, πρόκειται για βλάβη υποδομής.

Πιθανά σενάρια βλαβών και διαδικασίες αντιμετώπισής τους

Για την εύρυθμη λειτουργία των επιχειρήσεων, σε περίπτωση βλάβης της ECR ή σε περίπτωση βλάβης στην υποδομή της επιχείρησης ορίζεται η παρακάτω διαδικασία αποδέσμευσης του κλειδώματος του πληκτρολογίου του EFTPOS.

Διαδικασία ενεργοποίησης πληκτρολογίου τερματικού:

Ο χρήστης του EFTPOS, αφού διαπιστωθεί και επιβεβαιωθεί βλάβη στην επικοινωνία, μέσω κατάλληλου χειρισμού επιλέγει τον τύπο βλάβης, Βλάβη ECR ή Βλάβη Υποδομής. Μετά την επιλογή του χρήστη, το EFTPOS εκτελεί κλήση στον ΠΣ ΦΗΜ (Esend) όπου δηλώνεται ο τύπος της βλάβης (δείγμα επικοινωνίας παρακάτω). Εφόσον υπάρχει απάντηση επιτυχίας (SUCCESS) από το ΠΣΦΗΜ Esend, ξεκλειδώνεται το πληκτρολόγιο του EFTPOS και επιτρέπεται η χειροκίνητη έκδοση συναλλαγών. Το χρονικό διάστημα που επιτρέπεται να λειτουργεί το EFTPOS με ενεργοποιημένη την χειροκίνητη εισαγωγή ποσού συναλλαγής καθώς και συχνότητα που επιτρέπεται αυτή η ενεργοποίηση, αναφέρεται στην Απόφαση αυτή. Το χρονικό διάστημα που επιτρέπεται να λειτουργεί το EFTPOS με ενεργοποιημένη την χειροκίνητη εισαγωγή ποσού συναλλαγής ορίζεται σε ειδικό πεδίο (UNLTime) μέσα στην απάντηση που λαμβάνεται από τον server . Τα σενάρια για τα οποία επιτρέπεται η διαδικασία ενεργοποίησης του πληκτρολογίου είναι τα παρακάτω:

Σενάριο 1: Η ECR έχει βλάβη που δεν μπορεί να αντιμετωπιστεί άμεσα (κρίσιμο σφάλμα υλικού). Η συναλλαγή όταν εκτελεστεί αυτόνομα από το EFTPOS και παίρνει το num 4 στο πεδίο “txn-ecr-status”.

Σενάριο 2: H ECR λειτουργεί, αλλά υπάρχει βλάβη στην υποδομή της επιχείρησης που δεν επιτρέπει την επικοινωνία των συσκευών. Η συναλλαγή όταν εκτελεστεί αυτόνομα από το EFTPOS, παίρνει το num 5 στο πεδίο “txn-ecr- status”. Ο χειριστής είναι υποχρεωμένος σε κάθε συναλλαγή να εισάγει τον αριθμό της απόδειξης (Προοδευτικός Α/Α αποδείξεων). Μετά την εισαγωγή του αριθμού της απόδειξης προχωράει η διαδικασία έγκρισης.

Να σημειωθεί ότι σε όλα τα παραπάνω σενάρια οι συναλλαγές αυτές πρέπει υποχρεωτικά να διαφυλάσσονται στο EFTPOS έως ότου επανέλθει η ορθή επικοινωνία με την ECR.

Επαναφορά Επικοινωνίας - Διαδικασία Απενεργοποίησης πληκτρολογίου τερματικού:

Μετά την αποκατάσταση της βλάβης, πρέπει είτε μέσω ειδικού χειρισμού της ECR να στέλνεται η εντολή CONTROL (UNBIND_POS - 0) στο EFTPOS, είτε να γίνεται οποιαδήποτε άλλη ορθή επικοινωνία μεταξύ ECR->EFTPOS. Με τον τρόπο αυτό η ECR επιβεβαιώνει την αποκατάσταση της βλάβης. Λαμβάνοντας την εντολή αυτή, το EFTPOS αυτόματα κλειδώνει το πληκτρολόγιό του και ακολούθως κάνει νέα κλήση στο ΠΣΦΗΜ esend, όπου δηλώνει την επίλυση της βλάβης. Στη συνέχεια μέσω ειδικού χειρισμού, η ECR με την αποστολή της εντολής RESEND- ALL ζητάει από το EFTPOS όλες τις συναλλαγές που εκδόθηκαν αυτόνομα (είτε είναι για κάποιο άλλο λόγο σε εκκρεμότητα), έτσι ώστε να μπορέσουν να δημιουργηθούν οι έγγραφές των φορολογικών αρχείων e.txt με κωδικό παραστατικού 356 και ποσά amount, amount final θετικά εφόσον πρόκειται για πληρωμή με κάρτα ή αρνητικά, εφόσον πρόκειται για επιστροφή σε κάρτα. Έως ότου αποσταλούν επιτυχώς οι συναλλαγές αυτές στην ECR, το EFTPOS δεν θα μπορεί να εκτελέσει κλείσιμο πακέτου.

Στο EFTPOS υπάρχει ειδική αναφορά στην οποία αποτυπώνονται ξεχωριστά οι μετρητές, τα δεδομένα και τα ποσά για τις ως άνω συναλλαγές , βάσει ημερολογιακών κριτηρίων.

Τεχνικές προδιαγραφές εντολής αιτήματος στο Esend

Μορφή ανταλλαγής δεδομένων: JSON

HTTP method: POST

Security Rules: Οι ίδιοι που ισχύουν παρακάτω, στην διαδικασία λήψης του MK

Standard API Description (EFTPOS <--> e-Send)

Test endpoint: https://e-send.demo.gr/keyblock

Production endpoint: https//www1.aade.gr/tameiakes/mysec/keyblock.php

Πεδία πακέτου αποστολής

Μορφοποίηση πεδίων (αίτημα ενεργοποίησης πληκτρολογίου):

"TID": "99009999",

"UNBOUND_POS": "1"

"TAXID": "01345678"

Μορφοποίηση πεδίων (κλήση αποκατάστασης βλάβης):

"TID": "99009999",

"UNBOUND_POS": "0"

"TAXID": "01345678"

Πεδία απάντησης

Μορφοποίηση πεδίων απάντησης:

"Status": "000", "TID": "99009999"

"UNLTime": "12"

Response Status codes

Status Description

000 SUCCESS

Έκδοση και διάθεση αρχικού κλειδιού (master key-ΜΚ)

Για την αποφυγή της δημοσιοποίησης των κλειδιών κατά την σύζευξη της ECR και του EFTPOS και με σκοπό την αποτροπή οποιασδήποτε ενέργειας παράκαμψης της αρχικής σύνδεσης, η έκδοση και η εγκατάσταση του αρχικού κλειδιού (master key-MK) γίνεται μέσω ανεξάρτητων κλήσεων των ECR και EFTPOS στο ΠΣΦΗΜ Esend, που λειτουργεί και συντηρείται στις υποδομές της ΑΑΔΕ.

Οι κλήσεις εκτελούνται με πεδία αρχικοποίησης για την ECR: τον αριθμό μητρώου ECR και το ΑΦΜ της επιχείρησης, ενώ για το EFTPOS: το TID του EFTPOS και το ΑΦΜ της επιχείρησης.

Η διαδικασία δημιουργίας του αρχικού κλειδιού(master key-MK) εκκινεί από την ECR έτσι ώστε μετά τη δημιουργία και επιστροφή στην ECR του αρχικού κλειδιού από το ΠΣΦΗΜ Esend, αυτό να είναι διαθέσιμο για την λήψη του και από το EFTPOS.

Στην περίπτωση που η κλήση από την πλευρά του EFTPOS εκτελεστεί πριν την διαδικασία δημιουργίας αρχικού κλειδιού από την ECR, λαμβάνεται συγκεκριμένος κωδικός σφάλματος.

Security

• Για την επικοινωνία των EFTPOS με το ΠΣΦΗΜ Εsend χρησιμοποιούνται Client TLS πιστοποιητικά τα οποία θα διατίθενται από την υπηρεσία του ΠΣΦΗΜ Esend κατόπιν αιτήματος του κατασκευαστή EFTPOS. Το πιστοποιητικό Client TLS μπορεί να είναι ταυτόσημο για όλους τους κατασκευαστές EFTPOS ή διαφορετικό πιστοποιητικό για τον κάθε κατασκευαστή.

Το url επικοινωνίας των EFTPOS με το ΠΣΦΗΜ Esend για την λήψη του ΜΚ είναι το:

https//www1.aade.gr/tameiakes/mysec/eftposmk.php

• Για την επικοινωνία των ΦΗΜ με το ΠΣΦΗΜ Esend χρησιμοποιείται η διαδικασία κρυπτογράφησης μέσω AES-256 που καθορίζεται στην Απόφαση Διοικητή ΑΑΔΕ ΠΟΛ 1166/2018. Το url επικοινωνίας των ΦΗΜ με το ΠΣΦΗΜ Esend για την λήψη του ΜΚ είναι το: http//tam.gsis.gr/eafdss/myweb/fhmmk.php

Standard API Description (EFTPOS <--> Esend)

Test endpoint: https://e-send.demo.gr/genmac/

Production endpoint: https//www1.aade.gr/tameiakes/mysec/eftposmk.php

Μορφή ανταλλαγής δεδομένων: JSON

HTTP method: POST

Πεδία πακέτου αποστολής

Μορφοποίηση πεδίων:

{

"TID": "99009999",

"ECRID": "XXX99000000"

"TAXID": "01345678"

}

Πεδία απάντησης

Μορφοποίηση πεδίων:

{

"Status": "000",

"Description": "SUCCESS",

"TID": "990099",

"MACKEY": "30001234C330001234C330001234C322"

}

Standard API Description (ΦΗΜ <--> Esend)

Test endpoint: https://e-send.demo.gr/genmac/

Production endpoint: http//tam.gsis.gr/eafdss/myweb/fhmmk.php

Μορφή ανταλλαγής δεδομένων: ENCRYPTED RAW (AES KEY encryption method) HTTP method: POST

Πεδία πακέτου αποστολής

Μορφοποίηση πεδίων:

"XXX99000000;990099;01345678"

Πεδία απάντησης

Μορφοποίηση πεδίων:

"000;SUCCESS;XXX99000000;30001234C330001234C330001234C322"

Response Status codes

Λήψη του AESΚΕΥ από το ΠΣΦΗΜ για τους ΦΗΜ.

Ταυτόχρονα με την απόφαση έγκρισης ΦΗΜ, κοινοποιείται στην κατασκευάστρια επιχείρηση ΦΗΜ, το «βασικό AESKEY» της κατασκευάστριας επιχείρησης για τους ΦΗΜ της συγκεκριμένης έγκρισης. Μετά την υποβολή της δήλωσης έναρξης Δ13, ο ΦΗΜ μπορεί να επικοινωνήσει με ειδικό url του ΠΣΦΗΜ Esend, χρησιμοποιώντας ως AESKEY το βασικό AESKEY του κατασκευαστή. Το ΠΣΦΗΜ Esend, επιστρέφει στον ΦΗΜ κρυπτογραφημένο, το AESKEY του ΦΗΜ που θα χρησιμοποιείται για τις κρυπτογραφήσεις των διαβιβάσεων δεδομένων συναλλαγών.

Standard API Description (ΦΗΜ <--> Esend)

Production endpoint: http//tam.gsis.gr/eafdss/myweb/aeskey.php

Μορφή ανταλλαγής δεδομένων: ENCRYPTED RAW (AES KEY encryption method)

HTTP method: POST

Πεδία πακέτου αποστολής

Μορφοποίηση πεδίων:

"XXX99000000;01345678"

Πεδία απάντησης

Μορφοποίηση πεδίων:

"000;SUCCESS;XXX99000000;30001234C330001234C330001234C3223456

789F"

Response Status codes