Για τη διασύνδεση της Pegasus Web App εφαρμογής με ΕΑΦΔΣΣ είναι απαραίτητη η εγκατάσταση του Pegasus .NET CnA App.

Η εφαρμογή αυτή υλοποιεί έναν WebSocket Server ο οποίος θα παραλαμβάνει τα αιτήματα από το Pegasus WebApp για έκδοση υπογραφών και θα επιστρέφει την υπογραφή της ΕΑΦΔΣΣ.
Από το Pegasus CnA. App, θα κάνουμε το πρώτο Register του φορολογικού, την πιθανή Αλλαγή Τίτλων και θα εκδίδουμε το Ζ ημέρας.
Τέλος, από το Pegasus CnA. App θα μπορούμε να ενεργοποιήσουμε το service για την αποστολή των παραστατικών στην ΑΑΔΕ.

• Η μελέτη αφορά κατόχους Pegasus Web App εφαρμογών. Η εφαρμογή Pegasus Web App θα πρέπει να είναι ενημερωμένη με όλες τις απαραίτητες αναβαθμίσεις.
• Απαιτείται το WebApp module Pegasus CnA.
• Θα πρέπει να γίνουν όλες οι παρακάτω βασικές ρυθμίσεις πριν την έναρξη της λειτουργίας π.χ. Αναβάθμιση της φόρμας του Παραστατικού μας σε TCPDF
• Αφορά σε διασύνδεση με ΕΑΦΔΣΣ που χρησιμοποιούν τη βιβλιοθήκη DocMSign.dll.
  • Η διασύνδεση έχει υλοποιηθεί για σύνδεση με Ethernet ή σειριακή πόρτα (ή προσομοίωση σύνδεσης σε σειριακή με την χρήση του σχετικού driver από τον κατασκευαστή της ΕΑΦΔΣΣ).
  • Η διασύνδεση έχει υλοποιηθεί μόνο για μία ΕΑΦΔΣΣ σε κάθε υπολογιστή. Η παραδοχή αυτή έχει γίνει για λόγους απλούστευσης της υλοποίησης και ταχυτητας στην έκδοση υποργαφής.

Σύνδεση ΕΑΦΔΣΣ στον υπολογιστή

Αναλυτικές οδηγίες για την πρώτη σύνδεση της ΕΑΦΔΣΣ σε επίπεδο Hardware μπορείτε να βρείτε εδώ.

Εγκατάσταση Pegasus .NET CnA App

Κατεβάζουμε το αρχείο PegasusCnA.exe και το εκτελούμε.
Καλούμαστε να επιλέξουμε το path εγκατάστασης. Το default path εγκατάστασης είναι το C:\TESAESA\PegasusCnA\ .Προτείνουμε αν αυτό χρειαστεί να αλλάξει, να χρησιμοποιηθεί κάποιο path χωρίς κενά και μόνο με λατινικούς χαρακτήρες
Θα εγκατασταθεί η εφαρμογή Pegasus .NET CnA και θα δημιουργηθεί το shortcut Pegasus CnA στην Επιφάνεια Εργασίας.

Τρέχουμε την εφαρμογή.
Η εκτέλεση της εφαρμογής δεν θα ανοίξει κάποιο παράθυρο αλλά θα προσθέσει στα Toolbar Items της Taskbar των Windows την εφαρμογή μας. Ανοίγουμε το παράθυρο με διπλό κλικ. 

Pegasus .NET CnA App: Βασικές Ρυθμίσεις

Ανοίγουμε το παράθυρο του Pegasus CnA App με διπλό κλικ στο ToolbarItem.

Serial Number & Activation key

Σε πρώτο βήμα θα πρέπει να ορίσουμε τα στοιχεία του φορολογικού μηχανισμού. Δίνουμε το Serial Number και το Activation Key, όπως μας δόθηκαν στην αγορά του φορολογικού. Συνήθως αναγράφονται στο παραστατικό αγοράς του.

Path Υπογραφών και BackUp

Επίσης, ορίζουμε τα path για τον Φάκελο Υπογραφών, και πιθανώς το path όπου θα γίνεται αυτόματο backup των υπογραφών, π.χ. κάποιος δεύτερος δίσκος.
Ορίζοντας το path του backup των υπογραφών, η ΕΑΦΔΣΣ θα παίρνει αυτόματα backup. Σε περίπτωση που οι φάκελοι δεν υπάρχουν, θα πρέπει να δημιουργηθούν χειροκίνητα.

Σημείωση: Καλό είναι να παίρνουμε backup των υπογραφών σε τακτά χρονικά διαστήματα σε κάποιο ασφαλές αποθηκευτικό μέσο.

Φάκελος LOG

Ορίζουμε το path των logs της εφαρμογής στην οθόνη που θα εμφανιστεί. Σε περίπτωση που ο φάκελος δεν υπάρχει, θα πρέπει να δημιουργηθεί χειροκίνητα. 

Σειριακή Πόρτα ή IP

• Ορίζουμε τη σειριακή πόρτα που είναι συνδεδεμένη η ΕΑΦΔΣΣ. (σειριακή ή εικονική) ή 
• Ορίζουμε την IP που θα δώσυμε στην ΕΑΦΔΣΣ

Upload Password

Kαταχωρούμε το AES key, με το οποίο ανεβαίνουν οι υπογραφές της ΕΑΦΔΣΣ στην ΑΑΔΕ (το προμηθευόμαστε από το λογιστή μετά τη δήλωση της ΕΑΦΔΣΣ στο taxisnet).

Σημείωση: οι υπογραφές αποστέλλονται αυτόματα με κάθε έκδοση ΖΗΤΑ.

Register Φορολογικού

Εκτελούμε την ενέργεια Register / Ενεργοποίηση φορολογικού μηχανισμού. Η ενέργεια αυτή θα "δέσει" τη βιβλιοθήκη της ΕΑΦΔΣΣ με το δικό μας Serial No.

Αλλαγή Τίτλων

Εκτελούμε την ενέργεια Αλλαγής Τίτλων. Στην Αλλαγή Τίτλων θα πρέπει να ορίσουμε τα στοιχεία της επιχείρησής μας. Προσοχή τα στοιχεία αυτά μπορούν να αλλάξουν περιορισμένες φορές.Τα στοιχεία αυτά πρέπει να οριστούν πριν από το πρώτο Ζ.**

Έκδοση Ζ

Εφόσον έχουμε κάνει register και αλλαγή τίτλων, εκδίδουμε το πρώτο Ζ.

Pegasus .NET CnA App: Έναρξη WebSocket Server

Για την έναρξη του WebSocket Server, καλό είναι να έχουμε πρώτα ολοκληρώσει τις παραπάνω ρυθμίσεις και να έχουμε πάρει το πρώτο Ζ.
Μένει να ορίσουμε την Πόρτα στην οποία θα ακούει ο WebSocket Server. Είναι η πόρτα του WebSocket Server στην οποία θα δέχεται requests από το Web App. Δίνουμε π.χ. 50061
Εκτελούμε την ενέργεια “Αποθήκευση/Έναρξη server”.

Στην πρώτη εκτέλεση της εφαρμογής είναι πιθανό να υπάρξει κάποια ειδοποίηση από το antivirus του υπολογιστή. Ανάλογα το εκάστοτε antivirus, εξαιρούμε το Pegasus .NET CnA από τον έλεγχο του antivirus.

Pegasus Web App: Βασικές Ρυθμίσεις

Ορισμός ΑΦΜ

Ορίζουμε το ΑΦΜ της επιχείρησής μας στην επιλογή [Toolbox->Εργαλεία Παραμετροποίησης->Παράμετροι πυρήνα->Βασικές Παράμετροι εφαρμογής]

Έλεγχος Ορισμών Παραστατικών

Για κάθε ορισμό παραστατικού [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Παραγγελιών-Παραστατικών->Ορισμός Παραστατικών Πελάτων] ελέγχουμε τον κωδικό taxisnet.

Έλεγχος Κατηγοριών ΦΠΑ

Για κάθε κατηγορία ΦΠΑ [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Λογιστηρίου->Κατηγορίες ΦΠΑ] ελέγχουμε ότι έχει οριστεί σωστά το είδος taxisnet.

Επικοινωνία με τον WebSocket Server του Pegasus .NET CnA

Δημιουργούμε μία εγγραφή στον πίνακα [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση CnA->WebSocket Servers].

Εκεί, δίνουμε την πόρτα στην οποία ακούει ο WebSocket Server όπως την έχουμε ορίσει στο Pegasus .NET CnA App π.χ. 50061. 
Επίσης, ορίζουμε την IP του μηχανήματος στο οποίο θα εγκατασταθεί ο φορολογικός μηχανισμός. Η IP αυτή πρέπει να είναι static. Για να βρούμε την IP, αρκεί να εκτελέσουμε την εντολή ipconfig στο μηχάνημα του φορολογικού. Αν υπάρχει ένα μοναδικό μηχάνημα από το οποίο τρέχουμε το Pegasus Web App και είναι στημένος ο φορολογικός, μπορούμε να δώσουμε IP localhost. 

Σημείωση:

Στη περίπτωση που θέλουμε να συνδέσουμε παραπάνω απο ένα τερματικό , θα πρέπει να ορίσουμε την IP (πχ 192.168.*.*) έτσι ώστε να γνωρίζει η εφαρμογή σε ποια IP θα ψάξει την ΕΑΦΔΣΣ. Αν η ΕΑΦΔΣΣ είναι δικτυακή τότε θα πρέπει να ορίσουμε την IP της (για να βρείτε την ip της ΕΑΦΔΣΣ μπορείτε να ανατρέξετε στις οδηγίες της κατασκευάστριας εταιρείας). Επίσης, θα πρέπει τα τερματικά να βρίσκονται στο ίδιο τοπικό δίκτυο.

Το Pegasus .NET CnA App αρκεί να εγκατασταθεί σε ένα και μόνο Η/Υ.

Από το button “Έλεγχος συνδεσιμότητας” στην οθόνη του Web App βλέπουμε αν είναι δυνατή η επικοινωνία. Προσοχή! Για να μπορέσει να γίνει σύνδεση, Έχουμε τρέξει το Pegasus .NET CnA App και έχουμε εκκινήσει τον WebSocket Server. 
Αν η επικοινωνία δεν ήταν εφικτή κινούμαστε με βάση το μήνυμα που εμφανίζεται στην οθόνη. Για να εμφανιστεί το μήνυμα λάθους, μπορεί να χρειαστεί να περιμένουμε μερικά δευτερόλεπτα.

Συνήθη προβλήματα

Μήνυμα Λάθους: “Ανεπιτυχής Προσπάθεια Σύνδεσης στον WebSocket Server.”
Ελέγχουμε ότι έχει εκκινηθεί ο server από το Pegasus .NET CnA App
Ελέγχουμε ότι μπορούμε να “επικοινωνήσουμε” με την IP που δώσαμε π.χ. εκτελώντας ένα ping

Μήνυμα Λάθους: “SecurityError: Failed to construct 'WebSocket” - Google Chrome
Ορίζουμε το url ws://ip:port στο flag chrome://flags/#unsafely-treat-insecure-origin-as-secure του browser. Αντικαθιστούμε την ip και port με τα πραγματικά στοιχεία

ΠΡΟΣΟΧΗ: θα πρέπει να γίνει επανεκκίνηση του browser σας ώστε να ενεργοποιηθεί η ρύθμιση αυτή.

Μήνυμα Λάθους: “The operation is insecure: Code XX” - Mozilla Firefox
Πηγαίνουμε στο about:config του firefox βρίσκουμε το network.websocket.allowInsecureFromHTTPS και το κάνουμε true.

Φόρμα Παραστατικού

Για κάθε παραστατικό που θα παίρνει υπογραφή, είναι απαραίτητο να ρυθμίσουμε την Default φόρμα εκτύπωσης από τον ορισμό του Παραστατικού [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση Παραγγελιών-Παραστατικών->Ορισμός Παραστατικών Πελάτων]
Εφόσον έχουμε ορίσει default φόρμα, στην καταχώρηση του παραστατικού δεν μας ζητείται να επιλέξουμε φόρμα εκτύπωσης αλλά επιλέγεται αυτόματα και ανοίγει τόσα tab όσα το πλήθος τον αντιτύπων που ορίζουμε παρακάτω. Είναι πιθανόν ο browser να εμποδίζει να ανοίξουν πολλά παράθυρα μαζί (block popup Windows), θα χρειαστεί να το ενεργοποιήσουμε.

Προσοχή, η φόρμα που θα ορίσουμε στο σημείο αυτό πρέπει να πληροί τις παρακάτω προϋποθέσεις.
Οι default φόρμες Παραστατικών δεν χρειάζονται κάποια αλλαγή.
Σε περίπτωση που έχουν διαμορφωθεί custom Φόρμες, η ομάδα Support τις ΤΕΣΑΕ μπορεί να μας βοηθήσει με Οδηγίες ή Υλοποίηση.
Προϋποθέσεις:

1. Εάν η φόρμα δεν περιλαμβάνει τους τίτλους στοιχείων της επιχείρησης π.χ. Επειδή έχουμε προεκτυπωμένα έντυπα, θα πρέπει να τους προσθέσουμε στη φόρμα μας με την συνθήκη εκτύπωσης:
   

   if($p85_output['ca_server_without_images']){
    return true;
}
return false;

   Οι τίτλοι θα εκτυπωθούν μόνο στη δημιουργία του txt αρχείου που θα σταλεί στην ΕΑΦΔΣΣ.

2. Η φόρμα πρέπει να είναι TCPDF και version="function". Πρόκειται για τη νεότερη version φορμών του Πήγασου η οποία θα μας επιτρέψει να εκτυπώσουμε το QRCode στο παραστατικό και μας δίνει τη δυνατότητα παραγωγής των απαραίτητων αρχείων που ζητά η ΕΑΦΔΣΣ.
3. Θα πρέπει να μην έχει περιττές εικόνες για background, εικόνα συμβόλων π.χ. νομίσματος κοκ.
4. Θα πρέπει να ενσωματώσουμε τις παρακάτω αλλαγές για να εκτυπώνουμε την υπογραφή, το λεκτικό Πρωτότυπο/Αντίγραφο και το QRCode:
   Κώδικας Εκτύπωσης
   $ca_server_copy = isset($_REQUEST['ca_server_copy'])?$_REQUEST['ca_server_copy']:0;
$ca_server_without_images = isset($_REQUEST['ca_server_without_images'])?$_REQUEST['ca_server_without_images']:false;

   
   Πεδία
   1. QRCODE (το μέγεθος του barcode πρέπει να είναι τουλάχιστον 1.8cm x 1.8cm)
      Καταχωρείτε στοιχείο όπου θα επιλέξετε την Πρότυπη Έκφραση [Barcode (QRCode)]
   2. Πρωτότυπο - Αντίγραφο
      Καταχωρείτε στοιχείο όπου θα επιλέξετε την Πρότυπη Έκφραση [Authenticity]
      
   3. Υπογραφή
      Καταχωρείτε στοιχείο όπου θα επιλέξετε την Πρότυπη Έκφραση [Υπογραφή]
      
      
5. Στην περίπτωση που το πλάτος του χρησιμοποιούμενου χαρτιού δεν επιτρέπει την εκτύπωση ολόκληρης της συμβολοσειράς σήμανσης σε μια γραμμή, τότε είναι δυνατόν η συμβολοσειρά σήμανσης να εκτυπωθεί σε 2 ή εναλλακτικά 4, συνεχόμενες γραμμές (οι 40 πρώτοι χαρακτήρες στην πρώτη και οι υπόλοιποι 37 στην δεύτερη ή από 20 χαρακτήρες στις τρεις πρώτες γραμμές και οι υπόλοιποι 17 στην τέταρτη).  

Ορισμός Φορολογικής Σήμανσης

Στο βήμα αυτό θα ορίσουμε ποια παραστατικά θα παίρνουν σήμανση, πόσα θα είναι τα αντίγραφα για το κάθε παραστατικό καθώς και τον τύπο της φορολογικής Σήμανσης, αν δηλαδή θα δημιουργείται Ξεχωριστή Υπογραφή για κάθε αντίγραφο ή θα είναι κοινή.
Οι ρυθμίσεις της φορολογικής σήμανσης μπορεί να διαφέρουν ανά κατάστημα της επιχείρησης ή Σειρά παραστατικού.
Για κάθε διαφορετικό σενάριο δημιουργώ μία εγγραφή εδώ: [Toolbox->Εργαλεία Παραμετροποίησης->Παραμετροποίηση CnA->Ρυθμίσεις Φορολογικής Σήμανσης]

Στην Καταχώρηση ή Ενημέρωση ενός παραστατικού θα γίνεται έλεγχος αν το παραστατικό πρέπει να πάρει υπογραφή, δεν χρειάζεται ή έχει ήδη πάρει υπογραφή. Στην περίπτωση που θα πρέπει να γίνει έκδοση νέας υπογραφής, επιλέγεται ένα από τα Σενάρια/Ρυθμίσεις φορολογικής σήμανσης. Στην περίπτωση που προκύπτουν 2 ή παραπάνω σενάρια φορολογικής σήμανσης, ο χρήστης καλείται να επιλέξει. Προτείνουμε να αποφευχθούν τέτοιες περιπτώσεις.

Έχουμε τελειώσει με τις βασικές ρυθμίσεις. Δοκιμάζουμε να καταχωρήσουμε ένα παραστατικό που θα πρέπει να πάρει σήμανση. Στην εκτύπωση του παραστατικού θα πρέπει να εμφανιστεί η Υπογραφή, το QRCode και η υπόδειξη αν πρόκειται για Πρωτότυπο ή Αντίγραφο.

Pegasus .NET CnA App: Service αυτόματης αποστολής παραστατικών στην ΑΑΔΕ

Για να λειτουργήσει η συνεχής επικοινωνία της ΕΑΦΔΣΣ με την ΑΑΔΕ, θα πρέπει να ενεργοποιηθεί το Service DocMPend.
Προσοχή! Προκειμένου να ενεργοποιήσουμε το service θα πρέπει να ορίσουμε ότι η εφαρμογή Pegasus CnA.exe τρέχει ως administrator.
Θα πρέπει να έχουμε ανάλογο Activation Key. H ενεργοποίηση του Service και η Λειτουργία γίνεται από ένα μόνο τερματικό που "βλέπει" την ΕΑΦΔΣΣ.

Για να λειτουργήσει το DocMPend θα πρέπει η ΕΑΦΔΣΣ να έχει, τουλάχιστον, Firmware Τ15 (NET) ή Τ44 (NET II).
Registration Key: Το κλειδί για την ενεργοποίηση του service. Τον παραλαμβάνετε από την εταιρεία που σας προμήθευσε την ΕΑΦΔΣΣ. Με την παραλαβή του activation key, πατάτε το [Ενεργοποίηση] για να γινει ενεργοποίηση του service.
Upload Port: Είναι συνήθως η 80
Upload URL: Είναι το http://tam.gsis.gr/eafdss/myweb/websend.php (Οδηγίες για την παραλαβη από το gsis)
Upload Password: To password για το Upload στην ΑΑΔΕ. (Οδηγίες για την παραλαβή από το gsis)

Pegasus .NET CnA App: Εκτέλεση Pegasus .NET CnA App από το Windows Scheduler

Μπορούμε να ρυθμίσουμε το Pegasus .NET CnA App να τρέχει με την εκκίνηση των Windows.

Στο χρονοπρογραμματιστή των windows μπορούμε να ρυθμίσουμε να εκτελείται το exe απο τη διαδρομη \TESAESA\PegasusCnA\CnA100Interface.exe στην εκκίνηση των Windows, με argument autorun.

Με το argument αυτό, θα εκκινείται και ο server αυτόματα, με την εκτέλεση της εφαρμογής.