PUT /api/v1/transactions/createDocument – RetailForce

Αυτό το σημείο τερματισμού αποτελεί το πρώτο βήμα στη διαβίβαση συναλλαγών από το ηλεκτρονικό σύστημα καταγραφής («ταμειακή μηχανή») προς τη Φορολογική Υπηρεσία. Η διαδικασία αποτελείται πάντα από δύο βήματα. Αυτή η διαδικασία δύο βημάτων για τη διαβίβαση συναλλαγών βασίζεται στις απαιτήσεις του γερμανικού κανονισμού κατά της παραβίασης ταμειακών μηχανών και πρέπει να εφαρμόζεται σε όλες τις χώρες με φορολογικό σύστημα, στο πλαίσιο μιας τυποποιημένης διεπαφής. Στη Γερμανία, όταν καλείται η εντολή PUT /api/v1/transactions/createDocument, μια συναλλαγή καταχωρείται στη λεγόμενη Τεχνική Συσκευή Ασφαλείας (TSE/TSS).

Καταχώριση συναλλαγής

Μια συναλλαγή/έγγραφο καταχωρείται στη φορολογική μονάδα:

PUT /api/v1/transactions/createDocument και
POST /api/v1/transactions/storeDocument

Ακύρωση συναλλαγής

Αυτό καταχωρεί τον τερματισμό μιας συναλλαγής στη φορολογική μονάδα:

PUT /api/v1/transactions/createDocument και
POST /api/v1/transactions/cancelDocument

Σημείωση: όλες οι συναλλαγές που ξεκίνησαν με PUT /api/v1/transactions/createDocument πρέπει να κλείνονται είτε με POST /api/v1/transactions/storeDocument είτε με POST /api/v1/transactions/cancelDocument! Παρακαλώ σημειώστε το listTransactions (DELETE).

Αποτέλεσμα

Μια επιτυχής κλήση στο τελικό σημείο (200)

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

Χρήση

Κάθε φορά που πρόκειται να αποσταλεί μια νέα συναλλαγή στη φορολογική μονάδα, πριν από την κλήση POST /api/v1/transactions/storeDocument ή POST /api/v1/transactions/cancelDocument.

Προαπαιτούμενα

Έχει αρχικοποιηθεί το Fiskal Client

Πεδία φόρμας

Πρέπει να αποσταλούν οι ακόλουθες πληροφορίες:

Ονομασία	Τύπος	Περιγραφή	Παράδειγμα
clientId	M	Το uniqueClientId του ταμείου (από το RetailForce system).	c1062c55-57c4-4ed2-9c53-aff1762326a4
documentType	M	Ο τύπος του εγγράφου που θα καταχωρηθεί. Enum: [0] = Απόδειξη [1] = Τιμολόγιο [2] = Δελτίο παράδοσης [10] = Πληρωμή [11] = PayIn [12] = Προτιμολόγιο [13] = Παραγγελία πελάτη [14] = PreliminaryReceipt [80] = LongTermOrder [90] = OpeningBalance [98] = CashCheck [99] = EndOfDay [100] = Αποθέματα [101] = Αγορά [1000] = Μηδενική απόδειξη [1100] = Διάφορα μη φορολογικά	-
DocumentGuid	R	Το GUID/UUID που αποδίδεται στη συναλλαγή από το σύστημα POS. Συμπεριφορά του "DocumentGuid" που περιλαμβάνεται στο αίτημα: Ο καθορισμός του «DocumentGuid» καθιστά την κλήση ιδεμπότερη. Η συνάρτηση createDocument μπορεί να κληθεί πολλές φορές χωρίς να ξεκινήσει νέα συναλλαγή στο TSE (Technical Security Device Germany). «fiscalResponse»: επιστρέφεται πάντα η ΊΔΙΑ απόκριση. Συμπεριφορά ΧΩΡΙΣ το "DocumentGuid" στο αίτημα: Εάν δεν καθοριστεί το "DocumentGuid", ξεκινά μια νέα συναλλαγή στο TSE (Γερμανία) με ΚΑΘΕ κλήση της createDocument! "fiscalResponse": κάθε φορά επιστρέφεται μια ΝΕΑ απόκριση. Σημείωση: Το ίδιο "DocumentGuid" πρέπει επίσης να χρησιμοποιηθεί στην επόμενη κλήση προς το POST /api/v1/transactions/storeDocument.	b5744d8c-71ec-4ea0-a340-53070da8b5a1

Απόκριση

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

Κωδικός	Περιγραφή	Παράδειγμα
200	Η συναλλαγή έχει ξεκινήσει και επιστρέφεται μια fiscalResponse στο ανάντη σύστημα	-

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

Αποτέλεσμα

Χρήση

Προαπαιτούμενα

Πεδία φόρμας

Απόκριση

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