RetailForce Fiscal Service - Περιγραφή API

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

Εναλλακτική λύση: Εναλλακτικά, το ταμείο μπορεί επίσης να καταχωρίσει ένα έγγραφο: documentType [11] = PayIn.

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

Εναλλακτική λύση: Εναλλακτικά, το ταμείο μπορεί επίσης να καταχωρίσει ένα έγγραφο με BusinessTransactionType [91] = CashDifference.

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

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

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

Κλείνει την τρέχουσα ημέρα με μια κατάσταση κλεισίματος.

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

Επιστρέφει το έγγραφο λήξης ημέρας για την τρέχουσα ημέρα.

Το έγγραφο που επιστρέφεται πρέπει να αποθηκευτεί (storeDocument > documentType 99)

Επιστρέφει την ημερομηνία και την ώρα του τελευταίου κλεισίματος ενός συγκεκριμένου πελάτη (terminal)

Επιστρέφει πληροφορίες σχετικά με το αν πρέπει να πραγματοποιηθεί η ημερήσια κλείσιμο σε ένα συγκεκριμένο terminal. (Ανάλογα με το RetailForce.Fiscalisation.Implementation.
IFiscalCountryProperties.
MaximumHourIntervalForClosing).

Δημιουργεί έναν νέο client στο αποθετήριο διαμόρφωσης. Το αντικείμενο διαμόρφωσης πρέπει να έχει προετοιμαστεί από το σύστημα POS.

Η διαμόρφωση ενός client είναι απαραίτητη για τη λειτουργία. Χρησιμοποιήστε είτε αυτό το endpoint, είτε:

• PUT /api/v1/management/clients, ή
• PUT /api/v1/management/clients/
  byCloud/ID.

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

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

Μπορεί επίσης να χρησιμοποιηθεί όταν χρησιμοποιείται διαμόρφωση Cloud.

Δημιουργεί έναν νέο client με διαμόρφωση που έχει προετοιμαστεί στο Cloud / ή φορτώνει έναν υπάρχοντα client.

Για τη λειτουργία απαιτείται η διαμόρφωση ενός client. Χρησιμοποιήστε είτε:

• αυτό το endpoint, ή
• PUT /api/v1/management/clients, ή
• PUT /api/v1/management/clients/
  byCloud/ID.

Δημιουργεί έναν client φορτώνοντας τα δεδομένα διαμόρφωσης από το Cloud.

Εναλλακτική λύση: εναλλακτικό σημείο τερματισμού για τις εντολές PUT /api/v1/management/clients και PUT /api/v1/management/clients/byCloud.

Ενημερώνει τη διαμόρφωση του πελάτη, λαμβάνοντας τη διαμόρφωση του πελάτη από το Cloud.

Χρησιμοποιείται όταν η διαμόρφωση που έχει προετοιμαστεί στο Cloud έχει ενημερωθεί και πρέπει να μεταφορτωθεί εκ νέου από τον πελάτη (ενημέρωση).

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

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

Σημείωση: Ο distributor πρέπει να έχει οριστεί στα δεδομένα του πελάτη και πρέπει να έχει το δικαίωμα να δημιουργεί νέους πελάτες.

Δημιουργεί σύνδεση στο Cloud για τον συγκεκριμένο πελάτη και φορτώνει τη διαπιστευμένη φορολογική ενότητα στην προσωρινή μνήμη.

Απαιτείται για συστήματα που χρησιμοποιούν λειτουργίες Cloud.

Απαιτείται μετά από κάθε επανεκκίνηση του συστήματος POS.

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

Μέθοδος για την έναρξη ή τη διακοπή της επεξεργασίας της ουράς στο Cloud (για όλους τους clients).

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

Η εντολή «Start» ξεκινά αμέσως την επεξεργασία της ουράς.

Εάν η επεξεργασία της ουράς στο Cloud διακοπεί, πρέπει να την επανεκκινήσετε, εκτός εάν επανεκκινηθεί η υπηρεσία (στην περίπτωση αυτή, η επεξεργασία στο Cloud ενεργοποιείται ξανά).

Επιστρέφει τη διαμόρφωση ενός συγκεκριμένου πελάτη.

Διαγράφει έναν συγκεκριμένο client

Προσοχή: να χρησιμοποιείται με προσοχή!

Επιστρέφει το μοναδικό ID του πελάτη για τις ζητούμενες παραμέτρους.

Μπορούν να χρησιμοποιηθούν διαφορετικές παράμετροι για την αίτηση του uniqueClientId.

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

Επιστρέφονται μόνο τα LicenseConsumerId που έχουν ήδη αποθηκευτεί στο config store.

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

Χρησιμοποιείται για την επικύρωση μιας διαμόρφωσης που δημιουργήθηκε από το σύστημα ταμειακής μηχανής πριν από τη χρήση του /api/v1/management/clients.

Η επικύρωση της διαμόρφωσης στο Cloud παρέχεται στο σύστημα Cloud.

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

Η αρχικοποίηση πραγματοποιείται μέσω της απόδειξης έναρξης (αρχική απόδειξη), η οποία μπορεί είτε να αναζητηθεί χρησιμοποιώντας το σημείο τερματισμού GET /api/v1/transactions/document/
{clientId}/start, είτε να δημιουργηθεί από το σύστημα ταμειακής μηχανής.

Μεταφέρει έναν πελάτη από διαφορετικό πάροχο φορολογικής διαχείρισης.

Χρησιμοποιείται κατά τη μετάβαση από διαφορετικό πάροχο φορολογικού middleware στο RetailForce

Παρακαλώ σημειώστε τα υποστηριζόμενα συστήματα.

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

Παρακαλώ σημειώστε τα υποστηριζόμενα συστήματα!

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

Ανεβάζει ένα Support Package (αρχεία καταγραφής) στο Cloud για τον συγκεκριμένο πελάτη.

Αυτό το endpoint είναι απαραίτητο για τη χρήση της λειτουργίας «Ανεβάστε Support Package» στο σύστημα Cloud.

Δημιουργεί αντίγραφο ασφαλείας ενός πελάτη με το συγκεκριμένο filename (αντίγραφο ασφαλείας σε αρχείο zip).

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

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

Επαναφέρει έναν πελάτη (με όλα τα δεδομένα) από το δεδομένο αρχείο zip αντιγράφου ασφαλείας.

Δημιουργεί έναν νέο client με ρυθμίσεις από το Cloud ή φορτώνει έναν υπάρχοντα client.

Δημιουργεί έναν νέο client με ρυθμίσεις από το Cloud ή φορτώνει έναν υπάρχοντα client.

Δημιουργεί ένα νέο ή επιστρέφει ένα υπάρχον, παγκοσμίως μοναδικό ID για τον αντίστοιχο πελάτη. Επιπλέον, ενεργοποιείται η έκδοση του retailForceReceiptId για τον αντίστοιχο πελάτη.

Αποθηκεύει ένα εξωτερικό πιστοποιητικό στο αποθετήριο πιστοποιητικών της φορολογικής ενότητας.

Απαιτείται για συστήματα που ΔΕΝ χρησιμοποιούν τις λειτουργίες του RetailForce Cloud σε χώρες όπου ισχύει η φορολογική υποχρέωση και χρησιμοποιούνται πιστοποιητικά λογισμικού στο πλαίσιο της φορολογικής καταγραφής (Σλοβενία, Κροατία, Ισπανία,…)

Επιστρέφει αν ο ζητούμενος πελάτης διαθέτει την απαιτούμενη άδεια πρόσβασης.

Επιστρέφει αν ο ζητούμενος πελάτης διαθέτει την ζητούμενη άδεια.

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

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

Επιστρέφει το κλειδί AES για τον συγκεκριμένο client.

Εξάγει όλες τις γραμμές αποδείξεων των δεδομένων αποθήκευσης του τοπικού Μητρώου Συλλογής Δεδομένων (DEP §7 RKSV).

Απαιτείται για συστήματα εκτός σύνδεσης (συστήματα που ΔΕΝ χρησιμοποιούν αρχειοθέτηση φορολογικών δεδομένων στο Cloud).

Εξάγει όλα τα δεδομένα που απαιτούνται για το πρωτόκολλο DEP131 (DEP §131 BAO) από τα τοπικά αποθηκευμένα δεδομένα.

Επιστρέφει την αρχική απόδειξη για αυτόν τον πελάτη.

Το σύστημα ταμειακής μηχανής πρέπει να είναι σε θέση να παρέχει την αρχική απόδειξη (απόδειξη έναρξης) κατόπιν αιτήματος κατά τη διάρκεια ενός φορολογικού ελέγχου. Εάν το σύστημα POS δεν έχει αποθηκεύσει την αρχική απόδειξη, αυτή μπορεί να ζητηθεί χρησιμοποιώντας αυτό το endpoint.

Επιστρέφει όλες τις μηνιαίες αποδείξεις για το ζητούμενο χρονικό διάστημα.

Το σύστημα ταμειακής μηχανής πρέπει να είναι σε θέση να παρέχει μηνιαίες αποδείξεις κατόπιν αιτήματος κατά τη διάρκεια ενός φορολογικού ελέγχου. Εάν το σύστημα POS δεν έχει αποθηκεύσει αυτά τα έγγραφα, μπορούν να ζητηθούν χρησιμοποιώντας αυτό το endpoint.

Επιστρέφει όλες τις συσκευές υπογραφής και αν είναι ενεργοποιημένες στο FinanzOnline (Fon) ή όχι.

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

Σημείωση: Εάν χρησιμοποιούνται οι υπηρεσίες RetailForce Cloud, τα πιστοποιητικά καταχωρίζονται αυτόματα στην πύλη FinanzOnline (Fon) (à απαιτούνται διαπιστευτήρια για τον χρήστη της διαδικτυακής υπηρεσίας ταμειακής μηχανής!); το σημείο τερματισμού απαιτείται μόνο εάν η καταχώριση πρέπει να γίνει χειροκίνητα.

Αποεγγραφή της διαμορφωμένης συσκευής υπογραφής στο Fon (εάν έχει διαμορφωθεί κάποια) ή της συσκευής υπογραφής που προσδιορίζεται με το certificateSerial.

Προσοχή: να χρησιμοποιείται με προσοχή!

Επαληθεύει το τελευταίο υπογεγραμμένο έγγραφο στο DEP στο FinanzOnline (Fon).

Επαληθεύει το συγκεκριμένο έγγραφο DEP (κωδικός QR) στο Fon.

Επιστρέφει αν το ταμείο του συγκεκριμένου πελάτη είναι ενεργοποιημένο στο Fon.

Απαιτείται για συστήματα εκτός σύνδεσης.

Εγγραφή του συστήματος ταμειακής μηχανής στο Fon για τον συγκεκριμένο πελάτη.

Απαιτείται για συστήματα εκτός σύνδεσης.

Ακύρωση εγγραφής ταμειακού συστήματος στο Fon για τον συγκεκριμένο πελάτη.

Απαιτείται για συστήματα εκτός σύνδεσης.

Προσοχή: να χρησιμοποιείται με προσοχή!

Αποστέλλει εντολή κλεισίματος (Z) στον φορολογικό εκτυπωτή.

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

Αυτή η λειτουργία μπορεί να χρησιμοποιηθεί για τη δημιουργία της λεγόμενης αναφοράς KLEN.

(από την έκδοση v1.8.3)

Αυτή η συνάρτηση χρησιμοποιείται για την εκτύπωση

• λεπτομερείς και
• συνοπτικές εκθέσεις περιόδου.

(από την έκδοση v1.8.3)

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

(από την έκδοση v1.8.3)

Εξάγει τη μορφή SAF-T της Δανίας στο δεδομένο stream.

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

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

Μέθοδος για την επαλήθευση του γαλλικού αρχείου.

Επιστρέφει έναν πίνακα με τις συνδεδεμένες τοπικές συσκευές TSE και την κατάστασή τους.

Εκτελεί μια σύγχρονη αυτοδιάγνωση για το συγκεκριμένο ταμείο στο TSE (το ταμείο είναι προαιρετικό).

Πραγματοποιεί δοκιμαστική σύνδεση με το συγκεκριμένο TSE.

Επιστρέφει όλους τους πελάτες που αναφέρονται στο TSE του συγκεκριμένου πελάτη.

Επιστρέφει την κατάσταση του TSE. Εάν δεν εντοπιστεί κανένα φορολογικό module, επιστρέφεται η κατάσταση RetailForce.Fiscalisation.Implementation.
Germany.TSE.TSEStatus.Critical.

Ενημερώνει την ώρα στο TSE σύμφωνα με την πραγματική ώρα του υπολογιστή.

Εξάγει τα αρχεία tar από το κύριο TSE.

Απαιτείται για συστήματα εκτός σύνδεσης.

Εξάγει την ταξινόμηση (DSFinV-K export) και την επιστρέφει ως αρχείο λήψης (μορφή αρχείου zip).

Απαιτείται για συστήματα εκτός σύνδεσης.

Επιστρέφει όλες τις ενεργές (ξεκινήσες) συναλλαγές στο TSE.

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

Ακυρώνει τις ενεργές (ξεκινήσες) συναλλαγές στο TSE.

Επιστρέφει τον αριθμό των συναλλαγών εκτός σύνδεσης (= συναλλαγές που δεν έχουν σταλεί στο TSE λόγω εκτός σύνδεσης TSE – βλάβη, μη διαθεσιμότητα).

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

Επεξεργασία ανοιχτών υπογραφών εκτός σύνδεσης.

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

Εκτελεί μια σύγχρονη αυτοδιάγνωση για το συγκεκριμένο ταμειακό μηχάνημα στο TSE (το ταμειακό μηχάνημα είναι προαιρετικό).

Ενημερώνει το υλικολογισμικό στη συσκευή SWISSBIT HARDWARE TSE.

Επιστρέφει τα αποθηκευμένα αρχεία TicketBAI (αρχεία αποστολής, αρχεία απαντήσεων, αρχεία σφαλμάτων) ως αρχείο zip.

Επιστρέφει τα αποθηκευμένα αρχεία TicketBAI για τον αριθμό εγγράφου που ζητήθηκε (αρχεία αποστολής, αρχεία απαντήσεων, αρχεία σφαλμάτων) ως αρχείο zip.

Ανεβάζει ένα αρχείο ψηφιακής απόδειξης στο σύστημα Cloud.

Εναλλακτική λύση: Χρησιμοποιήστε είτε αυτό είτε το εναλλακτικό τελικό σημείο εντός αυτής της ενότητας για την αποστολή δεδομένων ψηφιακών αποδείξεων.

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

Εναλλακτική λύση: Χρησιμοποιήστε είτε αυτό είτε το εναλλακτικό endpoint εντός αυτής της ενότητας για την αποστολή δεδομένων ψηφιακών αποδείξεων.

Δημιουργεί ένα έγγραφο στη μονάδα φορολογικής καταχώρισης. Αυτή η μέθοδος δεν δημιουργεί το ίδιο το έγγραφο, αλλά απλώς ξεκινά τη διαδικασία, για παράδειγμα στο TSE.

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

Ακυρώνει ένα έγγραφο στη μονάδα φορολογικής καταχώρησης.

Μέθοδος για την αποθήκευση του αριθμού επανεκτυπώσεων ενός εγγράφου χρησιμοποιώντας το αποθηκευμένο έγγραφο (αναφορά: DocumentGuid).

Εναλλακτικά: χρησιμοποιήστε την εντολή PUT /api/v1/transactions/reprintDocument

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

Εναλλακτική λύση: εναλλακτικά, χρησιμοποιήστε PUT /api/v1/transactions/reprintDocument/
{clientId}/{DocumentGuid}.

Επαναφέρει ένα έγγραφο (μετατρέπει όλες τις τιμές σε αρνητικές).

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

Αποστολή του εγγράφου σε μορφή JSON στην υπηρεσία για επικύρωση.

Επιστρέφει ένα αρχικό έγγραφο για τον συγκεκριμένο πελάτη.

Το αρχικό έγγραφο χρησιμοποιείται για την αρχικοποίηση του πελάτη καθώς και της φορολογικής μονάδας (/api/v1/management/clients/initialize).

Εμφάνιση κειμένου στην οθόνη του φορολογικού πελάτη.

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

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

Επιστρέφει δεδομένα κωδικού QR ως string κωδικοποιημένη σε βάση 64 από τα δεδομένα.

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

Επιστρέφει όλες τις εγγραφές ελέγχου που αναζητήθηκαν με βάση τις ημερομηνίες fromDate/tillDate.

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

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

Επιστρέφει το ζητούμενο έγγραφο, εφόσον είναι αποθηκευμένο στην εσωτερική αποθήκη.

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

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

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

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

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

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