FiscalResponse objektas „fiscalResponse“ – RetailForce

Šiame straipsnyje aptariamas „FiscalResponse“ objektas („positions“) dokumento objekte
(Document object).

Išsamų „RetailForce DOM“ (dokumento objektų modelio) aprašymą, taip pat atskirų elementų aprašymą rasite „RetailForce“ svetainės atsisiuntimų skyriuje (Object model documentation.pdf) atitinkamoje versijų kataloge.

Objektas „fiscalRsponse“ grąžinamas kaip atsakymas po sėkmingo dokumento perdavimo (createDocument ir storeDocument) į pirminę sistemą (kasos aparatą, elektroninę registravimo sistemą).

„FiscalResponse“ objektą sudaro:

Standartinės informacijos – informacijos, nepriklausančios nuo konkrečios (fiskalinės) šalies (vienodos visoms šalims)
Šaliai būdinga informacija – tam tikra informacija, kuri turi būti atspausdinta ant kvito atitinkamoje šalyje arba išsaugota žurnale. Ši informacija grąžinama „fiscalResponse“ masyve „AdditionalFields“.

„fiscalResponse“ objektas

Toliau pateiktame objekte yra 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",     /// nur bei 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 šiuos duomenis.

Elementas		Tipas	Aprašymas
fiscalCountry			Atitinkamos fiskalinės šalies indikatorius. 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 stygos savybe fiscalDocumentNumber.
fiscalDocumentNumber			Fiskalinio dokumento numeris (priskiriamas atitinkamos fiskalinės sistemos, pvz., TSE Vokietijoje) Informacija apie šalį: Vokietija: savybė fiscalDocumentNumber (taip pat jos vertė) iš fiscalResponse po createDocument iškvietimo turi būti įtraukta į JSON dokumentą, kuris turi būti siunčiamas į storeDocument . Pastaba: Įdiegtas su v.1.7.7. fiscalDocumentNumber, priešingai nei fiscalisationDocumentNumber, yra „string“ elementas
~~fiscalisationDocumentRevision~~			Fiskalinio dokumento peržiūros numeris. (priskiriamas atitinkamos fiskalinės sistemos – pvz., TSE Vokietijoje) Dėmesio: savybė „fiscalisationDocumentRevision“ buvo pašalinta iš „fiscalResponse“ objekto antraštės su versija 1.7.7. Savybė buvo pervadinta į „fiscalDocumentRevision“ ir ateityje bus grąžinama tik kaip „fiscalRespones-Germany “ papildomų laukų dalis!
taxPositions			Visų dokumento PVM pozicijų nurodymas.
	vatIdentification		PVM pozicijos PVM tarifo identifikatorius
	vatLabel
	vatPercent1		Šios PVM pozicijos (šiuo atveju PVM pozicijos 1) mokesčio tarifas procentais
	vatAmount		PVM pozicijos PVM suma
	netAmount		PVM pozicijos grynoji suma (be PVM)
	grossAmount		PVM pozicijos bruto suma (su PVM)
fiscalDocumentStartTime			Fiskalinio dokumento sukūrimo laikas – Unix laiko žyma (priskiriama atitinkama fiskalinė sistema, pvz., TSE Vokietijoje)
processStartTime			Pirmojo dokumento sukūrimo laikas visame procese (pvz., Vokietija: pirmojo kliento užsakymo, susijusio su šiuo mokėjimo dokumentu, sukūrimo laikas – žr. taip pat „Maisto paslaugų ypatumai“)
errorDescription			Klaidos aprašymas, jei fiskalinis procesas nepavyko. Tuščias, jei klaida neatsirado.
cashRegisterId			Grąžina kasos aparato numerį, kuriuo fiskalinis dokumentas buvo užregistruotas / apdorotas
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 kasos sistemos vartotojui. Dėmesio: kai kuriose šalyse galimas vartotojo pranešimas turi būti rodomas kasos operatoriaus ekrane. Rekomenduojame šią procedūrą įgyvendinti kiekvienoje fiskalinėje šalyje.
printMessage			Turi būti atspausdinta ant dokumento (pvz., „kasos kvito“), kitaip kyla pavojus, kad įgyvendinimas neatitiks atitinkamos šalies teisinių reikalavimų. Taip pat atkreipkite dėmesį į „printMessage“. Dėmesio: kai kuriose šalyse informacija, grąžinama per „printMessage“ elementą, privalo būti atspausdinta ant kvito. Rekomenduojame šią procedūrą įgyvendinti kiekvienoje fiskalinėje šalyje.
requestTime			grąžina užklausos laiką
requestCompletionTime			grąžina laiką, kuriuo užklausa buvo užbaigta fiskalinėje sistemoje
retailForceReceiptId			„RetailForce“ sistemos suteiktas, visame pasaulyje unikalus dokumento ID. Grąžinamas tik fiscalResponse, kai iškviečiamas PUT /api/v1/transactions/createDocument. Pastaba: kad būtų sukurtas „RetailForceReceiptId“, tai turi būti aktyvuota atitinkamam klientui vieną kartą, iškviesiant funkciją POST /api/v1/management/clients/ {clientId}/globalShortId . Daugiau informacijos rasite straipsnyje „Visuotinis kasos ID ir visuotinis dokumento ID“.
additionalFields			Šaliai būdinga informacija
	{...}		fiscalResponseAustria – Austrija fiscalResponseBulgaria – Bulgarija fiscalResponseCanada – Kanada fiscalResponseCroatia – Kroatija fiscalResponseDenmark – Danija fiscalResponseFrance – Prancūzija fiscalResponseGermany – Vokietija fiscalResponseGreece – Graikija fiscalResponseHungary – Vengrija fiscalResponseItaly – Italija fiscalResponseLithuania – Lietuva fiscalResponsePoland – Lenkija fiscalResponseRomania – Rumunija fiscalResponseSerbia – Serbija fiscalResponseSlovakia – Slovakija fiscalResponseSlovenia – Slovėnija fiscalResponseSpain – Ispanija fiscalResponseSweden – Švedija

„fiscalResponse“ objektas

Susiję straipsniai