DELETE /api/v1/management/germany/ {clientId}/TSE/listTransactions – RetailForce

Το

DELETE /api/v1/management/germany/{clientId}/TSE/listTransactions

μπορεί να χρησιμοποιηθεί για το κλείσιμο ανοιχτών συναλλαγών TSE.

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

POST /api/v1/transactions/storeDocument – εάν έχει πραγματοποιηθεί πώληση, ή
POST /api/v1/transactions/cancelDocument — εάν δεν έχει πραγματοποιηθεί πώληση.

Προσοχή: λάβετε υπόψη ότι οι ακυρώσεις εγγράφων καταγράφονται (πρέπει να καταγράφονται) επίσης στο TSE. Επομένως, είναι επίσης απαραίτητο να ολοκληρώνεται κάθε συναλλαγή που ξεκίνησε με PUT /api/v1/transactions/createDocument με "storeDocument " ή "cancelDocument ". Σε περίπτωση συχνών ακυρώσεων εγγράφων, δεν μπορούμε να αποκλείσουμε το ενδεχόμενο οι φορολογικές αρχές να θέσουν ερωτήσεις σχετικά με τους λόγους των ακυρώσεων κατά τη διάρκεια ελέγχου του ταμειακού μηχανήματος .

Αποτέλεσμα

Οι ανοιχτές συναλλαγές στο TSE κλείνονται συλλογικά με την εντολή POST /api/v1/transactions/cancelDocument, χωρίς να απαιτείται το κλείσιμό τους ξεχωριστά.

Χρήση

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

Η κλήση δημιουργεί πρώτα ένα ερώτημα προς το TSE σχετικά με το ποιες συναλλαγές είναι ανοιχτές. Οι διαφορετικοί τύποι TSE (Cloud TSE, hardware TSE) δεν επιστρέφουν έναν πλήρη κατάλογο ανοιχτών συναλλαγών, αλλά μόνο «πακέτο προς πακέτο»:

swissbit Hardware TSE: 8 συναλλαγές η καθεμία,
fiskal Cloud TSE: 100 συναλλαγές η καθεμία

Αφού το TSE επιστρέψει το πακέτο των ανοιχτών συναλλαγών, οι συναλλαγές που περιέχονται κλείνονται μέσω ενός κενού εγγράφου, με τις ακόλουθες πληροφορίες:

DocumentId: Guid που δημιουργείται από την υπηρεσία
DocumentNr: GUID που δημιουργείται από την υπηρεσία
DocumentGuid: GUID που δημιουργείται από την υπηρεσία
DocumentType: Απόδειξη
documentTypeCaption: CancelTransaction

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

Όλες οι κλειστές συναλλαγές αποθηκεύονται επίσης αναλόγως στα δεδομένα DSFinV-K.

Προϋποθέσεις

Υπάρχουν ανοιχτές (ξεκινήσες), δηλαδή μη κλειστές, συναλλαγές στο TSE.

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

Μπορείτε να ανακτήσετε τον αριθμό των ανοιχτών συναλλαγών μέσω του τελικού σημείου:

GET /api/v1/management/germany/{clientId}/TSE/listTransactions

Παράδειγμα:

Το TSE επιστρέφει τον αριθμό των συναλλαγών που έχουν ξεκινήσει στο πεδίο «startedTransactions».

{
   ...
   "startedTransactions": 512,
   "maxStartedTransactions": 512,
   ...
}

Σημείωση: λειτουργεί μόνο για hardware TSE. Το όριο των ταυτόχρονων ανοιχτών συναλλαγών του Fiskaly Cloud TSE είναι 2.000.

Πεδία φόρμας

Πρέπει να διαβιβάζονται οι ακόλουθες πληροφορίες:

Ονομασία	Περιγραφή	Παράδειγμα
clientId	Το uniqueClientId του ταμείου (από το RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4

Απαντήσεις

Πιθανές απαντήσεις:

Κωδικός	Περιγραφή	Παράδειγμα
200	fiscalResponse - οι ανοιχτές συναλλαγές έχουν κλείσει με επιτυχία (cancelDocument)	-
400	"Tse not connected" - Δεν υπάρχει TSE συνδεδεμένο στο σύστημα ή εκχωρημένο στον αντίστοιχο client. Αντιμετώπιση προβλημάτων: Ελέγξτε αν το TSE είναι συνδεδεμένο στο σύστημα , π.χ.: με GET /api/v1/management/germany/tse	-
404	«Ο πελάτης δεν βρέθηκε» – δεν υπάρχει καμία διαμόρφωση σε αυτό το σύστημα με το συγκεκριμένο clientId Αντιμετώπιση προβλημάτων: Έλεγχος του καθορισμένου clientId Ελέγξτε αν το καθορισμένο clientId έχει διαμορφωθεί στο middleware (στο αρχείο fiscalService.config.json στο φάκελο C:\Program Files\RetailForce\Fiscal Webservice\Config)	-
422	«Το clientId ορίστηκε σε Guid.Empty» Αντιμετώπιση προβλημάτων:	-
500	«Εσωτερικό σφάλμα διακομιστή» - Άλλο σφάλμα. Αντιμετώπιση προβλημάτων: Επαναλάβετε την κλήση, επανεκκινήστε την υπηρεσία, αν χρειαστεί, εκτελέστε το CloudConnect.	-

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

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

Αποτέλεσμα

Χρήση

Προϋποθέσεις

Πεδία φόρμας

Απαντήσεις

Σχετικά άρθρα