Η πρώτη κίνηση που χρειάζεται να κάνουμε, είναι να συνδέσετε το POS με το ERP. Για τον λόγο αυτό, στέλνουμε το ΑΡΧΕΙΟ 1.

Κατά την σύνδεση του POS με το ERP, επιστρέφεται ένα κλειδί API. Το κλειδί αυτό θα πρέπει να αποθηκευτεί στο ERP καθώς θα χρησιμοποιείται για όλες τις επικοινωνίες μεταξύ POS και ERP.


Για να αποκτηθεί το κλειδί API, πρέπει να ακολουθηθεί η παρακάτω ροή εργασίας:

  1. Ο χρήστης ενεργοποιεί το EFT-POS ή ανοίγει την εφαρμογή softPOS στο κινητό του.
  2. Ο χρήστης πλοηγείται στο σχετικό μενού POS με την επιλογή "Σύνδεση με υπηρεσίες τρίτων".
  3. Το EFT-POS εμφανίζει έναν κωδικό ταυτοποίησης [πεδίο authCode].
  4. Συντάσσεται το αρχείο διεπαφής όπως περιγράφεται παρακάτω.
  5. Η εφαρμογή επικοινωνεί με το POS και επιστρέφει το κλειδί API σε ένα αρχείο με την ονομασία mellon1.txt
  6. Το λογισμικό ERP αποθηκεύει το κλειδί API και το χρησιμοποιεί για όλη τη διάρκεια της ενσωμάτωσης. Ο έμπορος έχει τη δυνατότητα να ανακαλέσει τα δικαιώματα πρόσβασης ανά πάσα στιγμή, επομένως το κλειδί API μπορεί να καταστεί άκυρο. Σε αυτή την περίπτωση, το λογισμικό του πελάτη θα πρέπει να το διαχειριστεί ως συνθήκη σφάλματος.



ΔΟΜΗ ΑΡΧΕΙΟΥ

Το αρχείο διεπαφής, πρέπει να περιέχει τα πεδία το ένα κάτω από το άλλο.

Η σύνταξη των πεδίων είναι <πεδίο>:<τιμή>. Για παράδειγμα, issuerVatNumber:555777003


TEMPLATE ΑΡΧΕΙΟΥ ΔΙΕΠΑΦΗΣ

method:

issuerVatNumber:

nspProtocol:

authCode:


Τα πεδία του αρχείου διεπαφής για την Αποστολή Πληρωμών

ΠΕΔΙΟ

ΔΟΜΗ/ΕΠΕΞΗΓΗΣΗ

ΥΠΟΧΡΕΩΤΙΚΟ

method

71

ΝΑΙ

issuerVatNumber

ΑΦΜ ΟΝΤΟΤΗΤΑΣ ΠΟΥ ΣΤΕΛΝΕΙ ΤΗΝ ΠΛΗΡΩΜΗ

ΝΑΙ

nspProtocol

1: JCC, Attica Bank, Pancreta 

2: Nexi 

3: NBG (National Bank of Greece) 

4: Worldline 

NAI

authCode

Ο Κωδικός Ελέγχου Ταυτότητας του POS
Στη φάση δοκιμών, χρησιμοποιείται ο 999999

ΝΑΙ


Παράδειγμα διεπαφής εύρεσης διαθέσιμων POS

method:71

issuerVatNumber:555777040

nspProtocol:1

authCode:999999


ΕΠΙΣΤΡΕΦΟΜΕΝΟ ΑΡΧΕΙΟ

Το επιστρεφόμενο αρχείο θα περιέχει το κλειδί API για την επικοινωνία με το τερματικό POS του πελάτη.


ApiKey:Zg6xxfx_R1ePPGs39BPzqQ


Orininal File Name: mellonPos.txt


Η ονομασία του επιστρεφόμενου αρχείου, είναι πάντα mellon71.txt.


Τα επιστρεφόμενα αρχεία mellon αποθηκεύονται στη διαδρομή <ΦΑΚΕΛΟΣ ΥΠΟΓΡΑΦΩΝ>/MellonGroup/.