Η RetailForce αναπτύσσει λογισμικό για τη συμμόρφωση με τους κανονισμούς σχετικά με τη φορολογική καταγραφή των ηλεκτρονικών συστημάτων καταγραφής σε διάφορες χώρες. Το λογισμικό αυτό ονομάζεται «Fiscal Middleware».

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

1. Βασικές αρχές

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

1.1 Επισκόπηση των παραλλαγών ενσωμάτωσης

Πριν ξεκινήσετε την ενσωμάτωση, αποκτήστε μια γενική εικόνα των διαφόρων παραλλαγών ενσωμάτωσης που είναι διαθέσιμες. Αυτές οι παραλλαγές περιγράφονται στο ακόλουθο άρθρο: Επισκόπηση της φορολογικής ενσωμάτωσης με το RetailForce – RetailForce Software GmbH (=άρθρο επισκόπησης).

Οι πηγές από τις οποίες μπορείτε να κατεβάσετε το RetailForce Middleware στις διάφορες παραλλαγές βρίσκονται επίσης στο άρθρο προς το οποίο παραπέμπει ο σύνδεσμος.

Αφού κατεβάσετε το Fiscal Middleware, προχωρήστε στην εγκατάσταση. Μια περιγραφή του τρόπου εγκατάστασης των διαφόρων παραλλαγών μπορεί να βρεθεί στο άρθρο επισκόπησης.

1.1.1 Σε σύνδεση (Online) έναντι εκτός σύνδεσης (Offline)

Το RetailForce Fiscal Middleware είναι βασικά ένα αυτόνομο σύστημα λογισμικού. Ωστόσο, διάφορες λειτουργίες είναι διαθέσιμες μόνο όταν το middleware είναι συνδεδεμένο με το RetailForce Cloud.

Το RetailForce Cloud παρέχει διάφορες λειτουργίες διαχείρισης, όπως την αυτόματη απομακρυσμένη διαμόρφωση του middleware, συμπεριλαμβανομένης της κατανομής αδειών χρήσης, καθώς και λειτουργίες ασφαλούς μακροπρόθεσμης αρχειοθέτησης.

Για να χρησιμοποιήσετε τις λειτουργίες του RetailForce Cloud, το Fiscal Middleware ή ο συγκεκριμένος πελάτης εντός της εγκατάστασης (πελάτης = μεμονωμένη παρουσία του συστήματος ηλεκτρονικής καταγραφής) πρέπει να είναι συνδεδεμένος με ένα terminal στο RetailForce Cloud.

Εάν το middleware πρόκειται να λειτουργήσει χωρίς τη δημιουργία σύνδεσης με το Cloud (σύστημα εκτός σύνδεσης), τα ακόλουθα βήματα μπορούν να παραλειφθούν. Συνεχίστε με το σημείο 1.5.

1.2 Πρόσβαση στην RetailForce portal

Όλες οι λειτουργίες του RetailForce Cloud παρέχονται μέσω

• το RetailForce Cloud Portal (https://portal.retailforce.cloud) καθώς και μέσω
• Cloud API (https://api.retailforce.cloud/swagger)

Η αυτοεγγραφή στο RetailForce portal δεν είναι δυνατή για λόγους ασφαλείας. Για να αποκτήσετε πρόσβαση στο RetailForce portal, πρέπει να λάβετε έναν σύνδεσμο πρόσκλησης από έναν ήδη εξουσιοδοτημένο χρήστη. Η διαδικασία εγγραφής που ακολουθεί περιγράφεται στο ακόλουθο άρθρο: Εγγραφή στο RetailForce portal – RetailForce Software GmbH.

1.3 Οργανωτική δομή

Πρώτα πρέπει να δημιουργηθεί μια οργανωτική δομή στην πύλη. Το άρθρο «Δημιουργία οργανωτικής δομής στο RetailForce Cloud – RetailForce Software GmbH» παρέχει μια επισκόπηση των λειτουργιών που διατίθενται για το σκοπό αυτό.

1.4 Διαμόρφωση

Αφού δημιουργηθούν η οργανωτική δομή, τουλάχιστον ένας οργανισμός (=πελάτης), ένα κατάστημα (=υποκατάστημα) και ένα terminal (=ταμείο), πρέπει να προετοιμαστεί ένα αντικείμενο διαμόρφωσης στο Cloud και να αντιστοιχιστεί σε μια οντότητα (οργανισμός, εταιρεία, κατάστημα ή terminal). Μπορείτε να βρείτε περιγραφή αυτής της διαδικασίας στην ενότητα: Γενικές πληροφορίες σχετικά με τη διαμόρφωση – RetailForce Software GmbH.

1.5 Αρχική ρύθμιση

Εάν τα προηγούμενα βήματα έχουν ολοκληρωθεί με επιτυχία, το Fiscal Middleware μπορεί να τεθεί σε λειτουργία. Τα βήματα που απαιτούνται για τη θέση σε λειτουργία (με ή χωρίς τη δημιουργία σύνδεσης με το cloud) εξηγούνται λεπτομερέστερα στο άρθρο «Αρχικοποίηση (γενικά)» – RetailForce Software GmbH.

Ως αποτέλεσμα της διαδικασίας θέσης σε λειτουργία/αρχικοποίησης, το Fiscal Client θα πρέπει

• να έχει διαμορφωθεί πλήρως,
  • είτε μέσω ενός αντικειμένου διαμόρφωσης που έχει προετοιμαστεί στο Cloud, είτε
  • «χειροκίνητα» από το σύστημα ηλεκτρονικής καταγραφής,
• και να διαθέτει ένα μοναδικό ID πελάτη.

2. Ενσωμάτωση

Αφού ολοκληρωθεί με επιτυχία η ενεργοποίηση ενός πελάτη («ταμειακή μηχανή»), μπορεί να ξεκινήσει η ενσωμάτωση.

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

2.1 Υπηρεσία REST

Το παρακάτω άρθρο σας βοηθά να ξεκινήσετε την ενσωμάτωση της διεπαφής REST Webservice, η οποία χρησιμοποιείται για

• την υπηρεσία των Windows καθώς και
• το κοντέινερ Docker.

Πρώτα βήματα με τη φορολογική υπηρεσία – RetailForce Software GmbH

2.2 Εφαρμογή μέσω NuGet

Βοήθεια για την υλοποίηση του middleware μέσω nuget (DLL) παρέχεται στο ακόλουθο άρθρο: Πρώτα βήματα στην υλοποίηση μέσω nuget – RetailForce Software GmbH.

2.3 Διεπαφή συστήματος αρχείων

Εκτός από τις δύο παραπάνω παραλλαγές υλοποίησης, τη διαδικτυακή υπηρεσία REST και το nuget, η πρόσβαση στο middleware είναι δυνατή και μέσω διεπαφής αρχείων. Περισσότερες πληροφορίες σχετικά με αυτό μπορείτε να βρείτε στο άρθρο: Διεπαφή συστήματος αρχείων – RetailForce Software GmbH.

2.4 Διαδικασία διαβίβασης εγγράφων

Αφού εγκατασταθεί το Fiscal middleware, κατά κάποιον τρόπο με τη μορφή υπηρεσίας των Windows, σε έναν υπολογιστή. Η περιγραφή του api είναι προσβάσιμη μέσω του http://localhost:7678/swagger/index.html.

Σε περίπτωση εγκατάστασης σε απομακρυσμένο υπολογιστή (π.χ. LAN), χρησιμοποιήστε τη διεύθυνση IP του συστήματος στο οποίο εγκαταστάθηκε το middleware αντί για το «localhost».

Όλα τα τελικά σημεία του middleware περιγράφονται στο swagger. Σημαντικά για τη διαβίβαση εγγράφων (π.χ. αποδείξεων μετρητών) είναι τα τελικά σημεία της ενότητας «Συναλλαγές».

Η διαβίβαση εγγράφων αποτελεί πάντα μια διαδικασία δύο βημάτων, η οποία ξεκινά με την εντολή

1. «createDocument» και ολοκληρώνεται είτε με
2. «storeDocument» είτε με το «cancelDocument», σε περίπτωση ακύρωσης εγγράφου.

Η διαδικασία διαβίβασης εγγράφων εξηγείται λεπτομερώς εδώ: Βασική διαδικασία διαβίβασης εγγράφων – RetailForce Software GmbH.

2.5 Fiscal Service Client Sample

Η RetailForce παρέχει ένα δείγμα προγράμματος, το «Fiscal Service Client Sample». Αυτό παρέχει οδηγίες για τον τρόπο δημιουργίας της δομής JSON με την οποία τα έγγραφα αποστέλλονται στη Φορολογική Υπηρεσία.

Το «Fiscal Service Client Sample» μπορεί να χρησιμοποιηθεί για τη δημιουργία παραδειγμάτων διαφορετικών τύπων εγγράφων και επιχειρηματικών περιπτώσεων.

Μια περιγραφή του προγράμματος μπορείτε να βρείτε στη διεύθυνση: Fiscal Service Client Sample – RetailForce Software GmbH.

Μπορείτε επίσης να βρείτε παραδείγματα διαφορετικών εγγράφων και επιχειρηματικών περιπτώσεων στο Κέντρο Λύσεων στη διεύθυνση: Επιχειρηματικές συναλλαγές – RetailForce Software GmbH.

2.6 Κατάλογος τελικών σημείων

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

Αυτό το άρθρο μεταφράστηκε αυτόματα.