„FiscalResponse“ objektas „fiscalResponse“ – RetailForce

Šiame straipsnyje aprašomas „fiscalResponse“ objektas („pozicijos“) „Document“ objekte
(„Document“ objektas).

Išsamus „RetailForce“ DOM (dokumento objektų modelio) aprašymas, taip pat atskirų elementų aprašymas pateikiami „RetailForce“ website atsisiuntimų skyriuje (Object model documentation.pdf) atitinkamame versijų kataloge.

Objektas „fiscalResponse“ grąžinamas į aukštesnio lygio sistemą (kasos aparatą, elektroninę registravimo sistemą) kaip atsakymas į sėkmingą dokumento perdavimą („createDocument“ ir „storeDocument“).

„fiscalResponse“ objektą sudaro:

Standartinės informacijos – informacijos, nepriklausančios nuo atitinkamos (fiskalinės) šalies (vienodos kiekvienai šaliai)
Šaliai būdinga informacija – tam tikra informacija, kuri atitinkamoje šalyje turi būti išspausdinta ant kvito arba įrašyta į žurnalą. Ši informacija grąžinama „fiscalResponse“ masyve „AdditionalFields“.

„fiscalResponse“ objektas

Šiame objekte pateikiami pavyzdiniai duomenys.

{
   "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“ objektas apima šią informaciją.

Informacija stulpelyje „Type“:

M ... privaloma / reikalaujama
M* ... privaloma / reikalaujama tam tikrose šalyse arba tam tikromis sąlygomis
R ... rekomenduojama
O... neprivaloma

Elementai		Tipas	Aprašymas
fiscalCountry			Atitinkamos fiskalinės šalies rodiklis. Enum: [0] = Vokietija [1] = Austrija [2] = Prancūzija [3] = Bulgarija [4] = Danija [5] = Švedija [6] = Slovėnija [7] = Lenkija [8] = Serbija [9] = Italija [10] = Kroatija [12] = Rumunija [15] = Lietuva [16] = Vengrija [18] = Ispanija [99999] = Neapmokestinama
fiscalisationDocumentNumber			Fiskalinio dokumento numeris (priskiriamas atitinkamos fiskalinės sistemos – pvz., TSE Vokietijoje). Sveikasis skaičius Pastaba: Pasenęs, būsimose versijose bus pakeistas į string savybę fiscalDocumentNumber.
fiscalDocumentNumber			Fiskalinio dokumento numeris (priskiriamas atitinkamos fiskalinės sistemos – pvz., TSE Vokietijoje). Šalies informacija: Vokietija: „fiscalResponse“ savybė „fiscalDocumentNumber“ (ir jos reikšmė) po „createDocument“ iškvietimo turi būti įtraukta į JSON dokumentą, kuris turi būti siunčiamas į „storeDocument “. Pastaba: Įvesta nuo v.1.7.7. „fiscalDocumentNumber“, skirtingai nuo „fiscalisationDocumentNumber“, yra „string“ tipo elementas
~~fiscalisationDocumentRevision~~			Fiskalinio dokumento redagavimo numeris. (jį priskiria atitinkama fiskalinė sistema – Vokietijoje – TSE). Dėmesio: savybė „fiscalisationDocumentRevision“ buvo pašalinta iš „fiscalResponse“ objekto antraštės versijoje 1.7.7. Savybė buvo pervadinta į „fiscalDocumentRevision“ ir dabar grąžinama tik kaip „fiscalResponse-Germany“ AdditionalFields („additionalFields“) dalis!
TaxPositions			Visų dokumente nurodytų Vat pozicijų sąrašas.
	VatIdentification		ID Vat pozicijos PVM tarifo identifikatorius. Pozicija
	VatLabel
	VatPercent1		Šios Vat pozicijos mokesčio tarifas procentais. Pozicija (šiuo atveju Vat pozicija 1)
	VatAmount		Vat pozicijos PVM suma
	NetAmount		PVM pozicijos grynoji suma (be Vat). Pozicija
	GrossAmount		PVM pozicijos bruto suma (įskaitant Vat)
fiscalDocumentStartTime			Fiskalinio dokumento sukūrimo laikas – Unix laiko žyma (priskiriama atitinkamos fiskalinės sistemos, pvz., TSE Vokietijoje).
processStartTime			Pirmojo dokumento viso proceso metu sukūrimo laikas (pvz., Vokietija: pirmojo kliento užsakymo, susijusio su šiuo mokėjimo dokumentu, sukūrimo laikas – žr. taip pat „gastronomijos ypatumus“).
ErrorDescription			Klaidos aprašymas, jei fiskalizacijos procesas nepavyko. Laukelis tuščias, jei klaidų nebuvo.
cashRegisterId			Grąžina kasos aparato numerį, kuriuo buvo užregistruotas / apdorotas fiskalinis dokumentas.
signature			Dokumento parašas, sukurtas atitinkamoje fiskalizacijos sistemoje (pvz., parašo kūrimo įrenginys Austrijoje, TSE Vokietijoje...)
UserMessage			Pranešimas, kuris turi būti rodomas POS sistemos vartotojui. Dėmesio: kai kuriose šalyse galimas vartotojo pranešimas turi būti rodomas kasininkui. Rekomenduojame įgyvendinti šią procedūrą kiekvienoje fiskalinėje šalyje.
PrintMessage			Turi būti atspausdinta ant dokumento (pvz., „grynųjų pinigų kvito“), kitaip kyla rizika, kad įgyvendinimas neatitiks atitinkamos šalies teisinių reikalavimų. Taip pat atkreipkite dėmesį į „PrintMessage“. Dėmesio: kai kuriose šalyse per „PrintMessage“ elementą grąžinta informacija turi būti atspausdinta ant kvito. Rekomenduojame įgyvendinti šią procedūrą kiekvienai fiskalinei šaliai.
requestTime			Grąžina užklausos laiką
requestCompletionTime			Grąžina laiką, kada užklausą užbaigė fiskalinė sistema
retailForceReceiptId			Visuotinai unikalus dokumento ID, kurį priskiria „RetailForce“ sistema. Grąžinamas tik „fiscalResponse“ atsakymuose, kai iškviečiama PUT /api/v1/transactions/createDocument. Pastaba: Kad būtų sukurtas „retailForceReceiptId“, šią funkciją reikia vieną kartą aktyvuoti atitinkamam klientui, iškviesdami funkciją POST /api/v1/management/clients/ {clientId}/GlobalShortId . Daugiau informacijos rasite straipsnyje „Visuotinis kasos aparatas ID ir visuotinis dokumento ID“.
AdditionalFields			Šaliai būdinga informacija
	{...}		„fiscalResponseAustria“ fiscalResponseBulgaria fiscalResponseKanada fiskalinė reakcija Kroatijoje fiskalinė reakcija Danijoje fiskalinė reakcija Prancūzijoje fiskalinės priemonės Vokietijoje fiskalinė reakcija Graikijoje fiskalinė reakcija Vengrijoje fiskalinės priemonės Italijoje fiskalinė reakcija Lietuvoje fiskalinės priemonės Lenkijoje fiskalinės priemonės Portugalijoje fiskalinė reakcija Rumunijoje fiskalinė reakcija Serbijoje fiskalinės priemonės Slovakijoje fiskalinės priemonės Slovėnijoje fiskalinės priemonės Ispanijoje fiskalinės priemonės Švedijoje

Šis straipsnis buvo išverstas automatiškai.

„fiscalResponse“ objektas

Susiję straipsniai