Το παρόν άρθρο περιγράφει το αντικείμενο fiscalResponse («θέσεις») εντός του αντικειμένου Document (αντικείμενο
Document).
Μια πλήρης περιγραφή του RetailForce DOM (Document Object Model), καθώς και μια περιγραφή των επιμέρους στοιχείων, διατίθεται στην ενότητα «Λήψεις» του RetailForce website (Object model documentation.pdf) στον αντίστοιχο κατάλογο εκδόσεων.
Το αντικείμενο fiscalResponse επιστρέφεται στο ανάντη σύστημα (ταμειακή μηχανή, ηλεκτρονικό σύστημα καταγραφής) ως απάντηση σε μια επιτυχημένη μετάδοση εγγράφου (createDocument και storeDocument).
Το αντικείμενο fiscalResponse αποτελείται από:
- Τυποποιημένες πληροφορίες – πληροφορίες ανεξάρτητες από την εκάστοτε (φορολογική) χώρα (οι ίδιες για κάθε χώρα)
- Πληροφορίες ειδικές για κάθε χώρα – συγκεκριμένες πληροφορίες που πρέπει να εκτυπώνονται σε απόδειξη στην αντίστοιχη χώρα ή να αποθηκεύονται στο ημερολόγιο. Αυτές οι πληροφορίες επιστρέφονται στον πίνακα «AdditionalFields» του fiscalResponse.
Αντικείμενο fiscalResponse
Το παρακάτω αντικείμενο περιέχει δείγματα δεδομένων.
{
"fiscalCountry": "[0] = Germany",
"fiscalisationDocumentNumber": 52,
"fiscalDocumentNumber": "52",
"fiscalDocumentStartTime": 1674819139,
"processStartTime": 0,
"errorDescription": null,
"cashRegisterId": "00345-00345",
"signature": "pCeGi98gNNhshcGJkbw0DwtSzuJkaawON8l5QwsFDEaDHOyYK2aNVO4ZAlpkYYnub7oxM/2R1/KB36UzmOQwew==",
"userMessage": null,
"printMessage": "***Test***",
"requestTime": "2023-01-27T12:34:21.3088836+01:00",
"requestCompletionTime": "2023-01-27T12:34:22.4379009+01:00",
"retailForceReceiptId": "0p4j0001", /// only for createDocument
"AdditionalFields": {
"QrCodeDataString": "V0;00345-00345;Kassenbeleg-V1;Beleg^13.90_0.00_0.00_0.00_0.00^13.90:Unbar;52;197;2023-01-27T11:32:19.000Z;2023-01-27T11:34:20.000Z;ecdsa-plain-SHA256;unixTime;pCeGi98gNNhshcGJkbw0DwtSzuJkaawON8l5QwsFDEaDHOyYK2aNVO4ZAlpkYYnub7oxM/2R1/KB36UzmOQwew==;BNHckCuXF2fEktIp8qwtnMLLgvpJDX6wEOqFENlHXZpekBHxHniQh9gbigjWS9UbCwZSrOTJTMK7WiV5owAfXkk=",
"TransactionStartTime": 1674819139,
"TransactionEndTime": 1674819260,
"ProcessData": "Beleg^13.90_0.00_0.00_0.00_0.00^13.90:Unbar",
"ProcessType": "Kassenbeleg-V1",
"TseSerial": "e5f5836a57c50c526d4bed37f18823608f2f44e2c98cab73278a7676c5ea0885",
"TseTimeFormat": "unixTime",
"TseHashAlgorithm": "ecdsa-plain-SHA256",
"TsePublicKey": "BNHckCuXF2fEktIp8qwtnMLLgvpJDX6wEOqFENlHXZpekBHxHniQh9gbigjWS9UbCwZSrOTJTMK7WiV5owAfXkk=",
"TseSignatureCounter": 197,
"TseCertificate": "MIIB0jCCAVmgAwIBAgIhAOX1g2pXxQxSbUvtN/GII2CPL0TiyYyrcyeKdnbF6giFMAoGCCqGSM49BAMDMDExFTATBgNVBAoTDGZpc2thbHkgR21iSDEYMBYGA1UEAxMPZmlza2FseSBUZXN0IENBMB4XDTIyMTAzMDEyMjgzMloXDTIzMTAzMDEyMjgzMlowMjEVMBMGA1UEChMMZmlza2FseSBHbWJIMRkwFwYDVQQDExBmaXNrYWx5IFRlc3QgVFNFMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE0dyQK5cXZ8SS0inyrC2cwsuC+kkNfrAQ6oUQ2Uddml6QEfEeeJCH2BuKCNZL1RsLBlKs5MlMwrtaJXmjAB9eSaNBMD8wDgYDVR0PAQH/BAQDAgeAMAwGA1UdEwEB/wQCMAAwHwYDVR0jBBgwFoAUlllBymQBup6ldKGojZVpZtWG5tQwCgYIKoZIzj0EAwMDZwAwZAIwEFsoSON9cIBqA5d9vsGI2jSjDlZxHokDvJ4yBmayvigrDbdhMYe3hw3HyQbO2B/FAjBXSVNbYR6Wg2TVzL9BhCla+tewRDGcs6vnetJ4i3VRtya1+ejt+vRjWnb/RUyo0Uw=",
"fiscalDocumentRevision": 2
}
}Το αντικείμενο fiscalResponse περιέχει τις ακόλουθες πληροφορίες.
Πληροφορίες στη στήλη «Type»:
- M ... υποχρεωτικό / απαιτείται
- M* ... υποχρεωτικό / απαιτείται σε ορισμένες χώρες ή υπό ορισμένες προϋποθέσεις
- R ... συνιστάται
- O... προαιρετικό
| Στοιχεία | Τύπος | Περιγραφή | |
| fiscalCountry |
Δείκτης για την αντίστοιχη φορολογική χώρα. Enum:
|
||
| fiscalisationDocumentNumber |
Αριθμός φορολογικού εγγράφου (αποδίδεται από το αντίστοιχο φορολογικό σύστημα – π.χ. TSE στη Γερμανία). Ακέραιος αριθμός
Σημείωση:
Έχει καταργηθεί, θα αντικατασταθεί από την ιδιότητα string fiscalDocumentNumber σε μελλοντικές εκδόσεις.
|
||
| fiscalDocumentNumber |
Αριθμός φορολογικού εγγράφου (αποδίδεται από το αντίστοιχο φορολογικό σύστημα – π.χ. TSE στη Γερμανία). Λεπτομέρειες ανά χώρα:
Σημείωση:
Εισήχθη με την έκδοση v.1.7.7. Η fiscalDocumentNumber, σε αντίθεση με την fiscalisationDocumentNumber, είναι ένα στοιχείο τύπου «string»
|
||
|
Αριθμός αναθεώρησης του φορολογικού εγγράφου. (αποδίδεται από το αντίστοιχο φορολογικό σύστημα – TSE στη Γερμανία).
Προσοχή:
η ιδιότητα «fiscalisationDocumentRevision» καταργήθηκε από την κεφαλίδα του αντικειμένου fiscalResponse με την release 1.7.7. Η ιδιότητα μετονομάστηκε σε «fiscalDocumentRevision» και πλέον επιστρέφεται μόνο ως μέρος των AdditionalFields του fiscalResponse-Germany
!
|
|||
| TaxPositions | Ενδείξεις όλων των θέσεων Vat του εγγράφου. | ||
| VatIdentification | ID του συντελεστή ΦΠΑ του στοιχείου ΦΠΑ. Στοιχείο | ||
| VatLabel | |||
| VatPercent1 | Φορολογικός συντελεστής σε ποσοστό αυτής της θέσης Vat. Θέση (στην περίπτωση αυτή, θέση Vat 1) | ||
| VatAmount | Ποσό Vat της θέσης Vat | ||
| NetAmount | Καθαρό ποσό (χωρίς ΦΠΑ) της θέσης Vat | ||
| GrossAmount | Μικτό ποσό (συμπεριλαμβανομένου του Vat) της θέσης Vat | ||
| fiscalDocumentStartTime | Ώρα δημιουργίας του φορολογικού εγγράφου - Χρονοσήμανση Unix (αποδίδεται από το αντίστοιχο φορολογικό σύστημα - π.χ. TSE στη Γερμανία). | ||
| processStartTime | Χρόνος δημιουργίας του πρώτου εγγράφου στο πλαίσιο ολόκληρης της διαδικασίας (π.χ. Γερμανία: Χρόνος δημιουργίας της πρώτης παραγγελίας πελάτη σε σχέση με το παρόν έγγραφο πληρωμής - βλ. επίσης «χαρακτηριστικά εστίασης»). | ||
| ErrorDescription | Περιγραφή σφάλματος σε περίπτωση αποτυχίας της διαδικασίας φορολογικής καταχώρησης. Κενό πεδίο εάν δεν έχει προκύψει σφάλμα. | ||
| cashRegisterId | Επιστρέφει τον αριθμό του ταμειακού μηχανήματος υπό τον οποίο καταχωρήθηκε/επεξεργάστηκε το φορολογικό έγγραφο. | ||
| signature | Υπογραφή εγγράφου, που δημιουργήθηκε από το αντίστοιχο σύστημα φορολογικής καταχώρησης (π.χ. συσκευή δημιουργίας υπογραφών στην Αυστρία, TSE στη Γερμανία...) | ||
| UserMessage |
Ειδοποίηση που πρέπει να εμφανίζεται στον χρήστη του συστήματος POS.
Προσοχή:
σε ορισμένες χώρες, ένα πιθανό μήνυμα χρήστη πρέπει να εμφανίζεται στον ταμία. Συνιστούμε την εφαρμογή αυτής της διαδικασίας για κάθε χώρα που εφαρμόζει φορολογική καταγραφή.
|
||
| PrintMessage |
Πρέπει να εκτυπώνεται στο έγγραφο (π.χ. «απόδειξη μετρητών»), διαφορετικά υπάρχει κίνδυνος η εφαρμογή να μην συμμορφώνεται με τις νομικές απαιτήσεις της εκάστοτε χώρας. Σημειώστε επίσης το «PrintMessage».
Προσοχή:
σε ορισμένες χώρες, οι πληροφορίες που επιστρέφονται μέσω του στοιχείου PrintMessage πρέπει να εκτυπώνονται στην απόδειξη. Συνιστούμε την εφαρμογή αυτής της διαδικασίας για κάθε φορολογική χώρα.
|
||
| requestTime | Επιστρέφει την ώρα της αίτησης | ||
| requestCompletionTime | Επιστρέφει την ώρα κατά την οποία το αίτημα ολοκληρώθηκε από το φορολογικό σύστημα | ||
| retailForceReceiptId |
Παγκόσμια μοναδική ID εγγράφου που εκχωρείται από το RetailForce system. Επιστρέφεται μόνο στο fiscalResponse κατά την κλήση της εντολής PUT /api/v1/transactions/createDocument.
Σημείωση:
Για να δημιουργηθεί το retailForceReceiptId, πρέπει να ενεργοποιηθεί μία φορά για τον εκάστοτε πελάτη με την κλήση της συνάρτησης POST /api/v1/management/clients/ {clientId}/GlobalShortId
.
Περισσότερες πληροφορίες μπορείτε να βρείτε στο άρθρο «Παγκόσμιο ID ταμειακής μηχανής και παγκόσμιο ID εγγράφου». |
||
| AdditionalFields | Πληροφορίες για κάθε χώρα | ||
| {...} |
δημοσιονομική_αντίδραση_Κροατία δημοσιονομική_αντίδραση_Γαλλία δημοσιονομική_αντίδραση_Γερμανία δημοσιονομική_αντίδραση_Ελλάδα δημοσιονομική_αντίδραση_Ουγγαρία δημοσιονομική_αντίδραση_Ιταλία δημοσιονομική_αντίδραση_Λιθουανία δημοσιονομική_αντίδραση_Πολωνία δημοσιονομική_αντίδραση_Ρουμανία δημοσιονομική_αντίδραση_Σερβία δημοσιονομική_αντίδραση_Σλοβακία δημοσιονομική_αντίδραση_Σλοβενία |
||
Αυτό το άρθρο μεταφράστηκε αυτόματα.
Σχόλια
0 σχόλια
Πραγματοποιήστε είσοδο για να αφήσετε ένα σχόλιο.