υποδεικνύει την αντίστοιχη χώρα.

Εάν ζητηθούν οι ιδιότητες fiscalCountryProperties μέσω GET /api/v1/information/client/{clientId}/countryProperties, καθορίζεται η χώρα που έχει αντιστοιχιστεί στον εκάστοτε πελάτη.

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

«υποχρεωτική» - Η πιστοποίηση του ανάντη συστήματος (π.χ. ταμειακή μηχανή) είναι υποχρεωτική. Σε αυτή την περίπτωση, η ταμειακή μηχανή πρέπει να υποβληθεί σε διαδικασία πιστοποίησης ή έγκρισης.

«miniPOS» – Η πιστοποίηση είναι υποχρεωτική, αλλά πληρούται από ένα ήδη πιστοποιημένο στοιχείο που μπορεί να ενσωματωθεί στο RetailForce Middleware.

"notNecessary" - Δεν απαιτείται πιστοποίηση του προηγούμενου συστήματος.

«true» – Στην εκάστοτε χώρα, τα δεδομένα πρέπει να αποστέλλονται γραμμή προς γραμμή, π.χ. σε φορολογικό εκτυπωτή.

• δεν υποστηρίζεται προς το παρόν

"false" - Διεπαφή βασισμένη σε έγγραφο (χωρίς εκτύπωση γραμμή προς γραμμή).

• Η υλοποίηση μεταξύ του ανάντη συστήματος και της Υπηρεσίας Φορολογικής Καταγραφής βασίζεται σε τυποποιημένα σημεία τερματισμού api.

Καθορίζει τον τύπο της φορολογικής καταγραφής.

"fiscalPrinter" - Η φορολογική εκτύπωση βασίζεται σε πιστοποιημένο φορολογικό εκτυπωτή ή σε πιστοποιημένο σύστημα φορολογικού ταμειακού μηχανήματος.

• Αυτό σημαίνει ότι, εκτός από το RetailForce system, απαιτείται ένας φορολογικός εκτυπωτής. Ενδέχεται να χρειαστεί να αγοραστεί από έναν τοπικό προμηθευτή.

"online" - Φορολογική καταγραφή μέσω διαδικτυακών συστημάτων των τοπικών φορολογικών αρχών.

• Δεν απαιτείται πρόσθετο υλικό.

"signature" - Φορολογική καταχώριση με υπογραφή των δεδομένων των αποδείξεων χρησιμοποιώντας ένα ψηφιακό πιστοποιητικό που είναι αποθηκευμένο στην υπηρεσία φορολογικής καταχώρισης.

• Σε ορισμένες χώρες, ενδέχεται να απαιτείται η απόκτηση πιστοποιημένου ψηφιακού πιστοποιητικού που παρέχεται από μια Αρχή Πιστοποίησης (CA).

«signatureWithOnline» - Φορολογική καταχώριση μέσω της δημιουργίας υπογραφών και της διαδικτυακής διαβίβασης δεδομένων στις φορολογικές αρχές.

• Συνδυασμός των δύο προαναφερθέντων τύπων.

Καθορίζει ποιο περιβάλλον υποστηρίζεται:

"local" - τοπική εγκατάσταση του φορολογικού middleware (τοπικά στο σύστημα POS, στον διακομιστή του καταστήματος κ.λπ.)

• Μπορούν να γίνουν κλήσεις api προς την τοπικά εγκατεστημένη υπηρεσία φορολογικής διαχείρισης:
  • http://localhost:7678/ στην περίπτωση υλοποίησης REST, ή
  • κλήση μεθόδου στην περίπτωση υλοποίησης μέσω nuget.

«cloud» - το φορολογικό middleware διατίθεται ως φιλοξενούμενη υπηρεσία cloud στη διεύθυνση https://fiscalisation.RetailForce Cloud.

• Μπορούν να γίνουν κλήσεις API προς την Υπηρεσία Φορολογικής Καταγραφής στο Cloud.

Καθορίζει ποια λειτουργικά συστήματα/πλατφόρμες υποστηρίζονται.

"linux"

• μέσω κοντέινερ Docker (υλοποίηση REST)

"windows"

• μέσω υπηρεσίας Windows (υλοποίηση REST) ή
• μέσω υλοποίησης nuget

"ios"

• μέσω υλοποίησης nuget

"android"

• μέσω υλοποίησης nuget, ή
• υπηρεσία Android (υλοποίηση REST)

Καθορίζει ποιες νομικές απαιτήσεις υποστηρίζονται και τις εκδόσεις τους.

Π.χ. για την Ελλάδα: «myDATA v1.x.x»

Τύποι εγγράφων που πρέπει να «φορολογηθούν» στην εκάστοτε χώρα. Για παράδειγμα, πρέπει να υποβληθούν σε επεξεργασία από το προβλεπόμενο υλικό, να υπογραφούν κ.λπ.

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

Αυτοί οι τύποι εγγράφων ΠΡΕΠΕΙ να διαβιβάζονται στην υπηρεσία φορολογικής επικύρωσης της εκάστοτε χώρας, υπό την προϋπόθεση ότι το ανάντη σύστημα («ταμειακή μηχανή») τα υποστηρίζει.

Κατάλογος των τύπων εγγράφων που υποστηρίζονται σε κάθε χώρα.

Εκτός από τους «fiscalDocumentTypes», οι τύποι εγγράφων που αναφέρονται στην κατηγορία «supportedDocumentTypes» ΜΠΟΡΟΥΝ να διαβιβαστούν στην υπηρεσία φορολογικής επικύρωσης.

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

Κατάλογος τύπων εγγράφων που δεν υποστηρίζονται στην εκάστοτε χώρα.

Οι «documentTypes» που αναφέρονται στην κατηγορία «notSupportedDocumentTypes» δεν μπορούν να διαβιβαστούν στην υπηρεσία φορολογικής επικύρωσης της εκάστοτε χώρας.

Οι λόγοι για αυτό μπορεί να είναι τεχνική αδυναμία ή κανονισμοί/νόμοι που ισχύουν ειδικά για τη συγκεκριμένη χώρα.

Εάν ένας «notSupportedDocumentType» αποσταλεί στην υπηρεσία φορολογικής καταχώρησης, αυτή θα απαντήσει με ένα μήνυμα σφάλματος («documentType not supported!»).

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

Κατάλογος των υποστηριζόμενων (αποδεκτών) μεθόδων πληρωμής στην εκάστοτε χώρα.

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

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

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

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

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

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

Σύνολο απόδειξης = 38,50 EUR

• Ο πελάτης πληρώνει 50 EUR με χρεωστική κάρτα, επειδή επιθυμεί να λάβει τα ρέστα σε μετρητά.
• Ο πελάτης πληρώνει 50 EUR σε μετρητά και λαμβάνει 11,50 EUR ως ρέστα (απόδοση ρέστα).

Αυτές οι συναλλαγές δεν επιτρέπονται σε ορισμένες χώρες (δηλαδή, δεν μπορούν να αποσταλούν στο σύστημα φορολογικής καταγραφής).

Αυτό σημαίνει ότι τα ποσά πληρωμής («payment.amount») πρέπει πάντα να αντιστοιχούν στο ακαθάριστο σύνολο των ειδών («GrossValue» όλων των «positions») και δεν επιτρέπεται η μεταφορά αρνητικών ποσών πληρωμής.

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

Αυτές οι επιχειρηματικές περιπτώσεις μπορούν να χρησιμοποιηθούν στην αντίστοιχη χώρα, σε αντίθεση με τα notSupportedBusinessTransactionTypes.

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

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

Λεπτομερείς πληροφορίες σχετικά με τους συντελεστές Vat που υποστηρίζονται σε κάθε χώρα.

Αυτός ο πίνακας περιέχει τις ακόλουθες πληροφορίες:

• Συντελεστής ΦΠΑ: «VatPercent» / «VatPercent2»
• Εσωτερικό ID που χρησιμοποιείται για την αντιστοίχιση του αντίστοιχου συντελεστή ΦΠΑ: "VatIdentification"
• Όνομα του συντελεστή Vat: "caption" / "Caption_EN"
• Ιστορικοί συντελεστές Vat με λεπτομέρειες ισχύος («ValidFrom» - «ValidTo»)

«δεν είναι υποχρεωτικό» - Η εμφάνιση του πελάτη δεν απαιτείται (δεν υπάρχει υποχρέωση).

«υποχρεωτική (no-RF)» – Η εμφάνιση του πελάτη είναι υποχρεωτική, αλλά δεν ελέγχεται μέσω του RetailForce Middleware. Ο έλεγχος πραγματοποιείται αυτόματα από το αντίστοιχο σύστημα φορολογικής καταγραφής (π.χ. αυτόματα από τον φορολογικό εκτυπωτή).

«υποχρεωτικό (RF)» - Η χρήση οθόνης πελάτη είναι υποχρεωτική και ελέγχεται μέσω του RetailForce Middleware.

• Η οθόνη πελάτη ελέγχεται μέσω της λειτουργίας: POST /api/v1/transactions/display/{clientId}

«δεν επιτρέπεται» - Η χρήση οθόνης πελάτη απαγορεύεται σε αυτή τη χώρα.

Καθορίζει εάν οι συσκευές εισόδου πρέπει να είναι καταχωρημένες στην αντίστοιχη χώρα («true» / «false»).

Οι συσκευές εισόδου δεν αποτελούν αυτόνομα συστήματα καταγραφής. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα: Αρχιτεκτονικές ηλεκτρονικών συστημάτων καταγραφής (EAS)

«true» – στην εκάστοτε χώρα υπάρχει απαίτηση τήρησης τεχνικού ημερολογίου (audit log) (στην περίπτωση αυτή περιλαμβάνεται στην άδεια RF).

• Σε αυτή την περίπτωση, οι καταχωρήσεις τεχνικών συμβάντων πρέπει να αποστέλλονται στην υπηρεσία φορολογικής καταγραφής μέσω
  • POST /api/v1/transactions/AuditLog , ή
  • POST /api/v1/transactions/storeDocument ("documentType": "[1002] = AuditLog")

«false» — δεν υπάρχει απαίτηση τήρησης τεχνικού ημερολογίου (δεν περιλαμβάνεται στην άδεια).

• Τα τεχνικά συμβάντα ΜΠΟΡΟΥΝ να καταγράφονται, αλλά δεν είναι υποχρεωτικό.

"true" - στην αντίστοιχη χώρα, η ανατύπωση ενός εγγράφου πρέπει να καταγράφεται υποχρεωτικά.

• Κλήση ενός από τα εξής:
  • PUT /api/v1/transactions/reprintDocument/ {clientId}/{DocumentGuid}, ή

  • PUT /api/v1/transactions/reprintDocument

    υποχρεωτικό.

"false" - Η επανεκτύπωση ενός εγγράφου δεν χρειάζεται να καταχωρείται ως υποχρεωτική.

"terminal" - Ένα έγγραφο μπορεί να επανεκτυπωθεί μόνο στο ίδιο ταμείο στο οποίο εκδόθηκε το αρχικό έγγραφο.

«κατάστημα» - Η εκτύπωση ενός εγγράφου επιτρέπεται μόνο εντός του ίδιου υποκαταστήματος/καταστήματος όπου εκδόθηκε και το αρχικό έγγραφο.

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

«all» - Η επανεκτύπωση ενός εγγράφου μπορεί να πραγματοποιηθεί σε άλλο ταμείο καθώς και σε άλλο υποκατάστημα/κατάστημα της ίδιας εταιρείας.

• Η λειτουργία επανεκτύπωσης σε πολλαπλά καταστήματα πρέπει να υλοποιείται από το ανώτερο σύστημα.

«true» - Πρέπει να δημιουργείται καθημερινό κλείσιμο (αναφορά Z) μία φορά την ημέρα.

• ημερήσιο κλείσιμο
  • POST /api/v1/transactions/storeDocument
  • "documentType": "[99] = EndOfDay"

"false" - δεν απαιτείται ημερήσιο κλείσιμο.

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

"-1" - δεν έχει οριστεί.

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

"oneReceiptAllowed" - επιτρέπεται (οι πωλήσεις και οι επιστροφές μπορούν να εμφανίζονται αναμεμειγμένες σε μία απόδειξη).

• Πωλήσεις:
  • "positions" (Τύπος 0 ή 1) με θετικές τιμές,
• Επιστροφές:
  • "positions" (Τύπος 0 ή 1) με αρνητικές τιμές και
  • "documentReference" ορισμένο.

«oneReceiptAllowedVat» – εφόσον το ποσό του Vat παραμένει θετικό, οι πωλήσεις και οι επιστροφές μπορούν να καταχωρηθούν σε μία (την ίδια) απόδειξη.

«multiReceipt» – Οι πωλήσεις και οι επιστροφές πρέπει να καταγράφονται σε διαφορετικές αποδείξεις.

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

«NoReturnAllowed» – στη συγκεκριμένη χώρα, η επεξεργασία επιστροφών μέσω του συστήματος φορολογικής καταγραφής δεν είναι δυνατή. Σε αυτές τις χώρες, οι επιστροφές συχνά διεκπεραιώνονται μέσω ειδικών εντύπων ή παρόμοιων μέσων στο λογιστήριο.

Πού μπορούν να επιστραφούν τα αγορασμένα είδη;

«terminal» — Τα είδη μπορούν να επιστραφούν μόνο στο ίδιο ταμείο (έκδοση απόδειξης) στο οποίο πραγματοποιήθηκε η αρχική πώληση.

«store» - Τα προϊόντα μπορούν να επιστραφούν μόνο στο ίδιο κατάστημα (έκδοση απόδειξης) όπου πραγματοποιήθηκε η αρχική πώληση.

«all» - Τα προϊόντα μπορούν επίσης να επιστραφούν σε διαφορετικά καταστήματα της ίδιας εταιρείας.

Αναφορά εγγράφου για επιστροφές

«single» – Σε περίπτωση επιστροφών, επιτρέπεται η αναφορά μόνο σε ΕΝΑ προηγούμενο έγγραφο (έγγραφο πώλησης των επιστραφέντων υπηρεσιών ή αγαθών).

• «documentReference»: επιτρέπεται μόνο για ένα προκαταρκτικό έγγραφο, ή
• η αναφορά σε επίπεδο είδους («positionReference») επιτρέπεται μόνο για ένα μόνο προκαταρκτικό έγγραφο.

«multiple» — σε περίπτωση επιστροφών, επιτρέπεται η αναφορά σε πολλαπλά προηγούμενα έγγραφα (πολλαπλές αποδείξεις πώλησης, εάν επιστρέφονται πολλαπλές υπηρεσίες ή αγαθά από πολλαπλές αγορές). 

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

Καθορίζει εάν το στοιχείο «fiscalDocumentNumber» του «fiscalResponse» της αντίστοιχης χώρας πρέπει να εκτυπώνεται στα έγγραφα.

• Οι αριθμοί εγγράφων που μεταφέρονται από το ανάντη σύστημα αγνοούνται. Το φορολογικό σύστημα (π.χ. ο εκτυπωτής) εκχωρεί αυτόνομα τον αντίστοιχο αριθμό εγγράφου/ID εγγράφου.

"true" - στη συγκεκριμένη χώρα επιτρέπονται επιπλέον χρεώσεις σε αγαθά ή υπηρεσίες.

• surcharges:
  • "positions.discounts" με ΑΡΝΗΤΙΚΕΣ τιμές

"false" - Δεν επιτρέπονται επιπλέον χρεώσεις στις τιμές.

Δείχνει αν επιτρέπεται η λειτουργία εκπαίδευσης / επίδειξης του ταμειακού μηχανήματος στην αντίστοιχη χώρα

"true" - επιτρέπεται.

• Λειτουργία εκπαίδευσης:
  • "IsTraining": true

"false" - Το ταμείο δεν πρέπει να διαθέτει λειτουργία εκπαίδευσης/επίδειξης.

"true" - Το άθροισμα των μεμονωμένων ειδών υπολογίζεται με βάση το καθαρό ποσό (NetValue) (π.χ. Québec/Καναδάς).

"false" - Το άθροισμα των μεμονωμένων ειδών υπολογίζεται με βάση το μικτό ποσό (GrossValue) (προεπιλογή).

«true» - Τα στοιχεία που έχουν εισαχθεί αλλά δεν περιλαμβάνονται στη συνέχεια στο έγγραφο πρέπει να διαβιβάζονται στο payload (JSON).

"false" - Τα στοιχεία που έχουν εισαχθεί αλλά δεν περιλαμβάνονται στη συνέχεια στο έγγραφο δεν χρειάζεται να διαβιβαστούν.

Καθορίζει τον τύπο του αρχικού εγγράφου στη σχετική χώρα.

Ισχύει μόνο εάν το ανάντη σύστημα ΔΕΝ χρησιμοποιεί τη λειτουργία GET /api/v1/transactions/document/{clientId}/start κατά την αρχικοποίηση και δημιουργεί το αντίστοιχο αρχικό έγγραφο από μόνο του.

Λίστα των τύπων πληρωμών που υποστηρίζονται στη σχετική χώρα.

Τα στοιχεία που αναφέρονται στην ενότητα «supportedPayOutTypes» μπορούν/πρέπει να καθοριστούν για τις πληρωμές («documentType»: «[10] = PayOut» και «BusinessTransactionType»: «[10] = PayOut»).

Υποδεικνύει εάν οι συντελεστές Vat υπολογίζονται από την αντίστοιχη ενότητα φορολογικής διαχείρισης της χώρας.

"true" - Η ενότητα φορολογικής διαχείρισης υπολογίζει τους συντελεστές Vat.

"false" - το ταμείο πρέπει να υπολογίζει τους συντελεστές Vat.

Καθορίζει εάν και πόσα δεκαδικά ψηφία πρέπει να περιλαμβάνονται στο έγγραφο JSON που αποστέλλεται στο Fiscal Middleware κατά την αποστολή ποσών / συνόλων.

Ισχύει για όλες τις προδιαγραφές τιμών στο payload («GrossValue», «NetValue», «TaxValue», «Amount» κ.λπ.)