FiscalResponse-objekt »fiscalResponse« – RetailForce

Ta članek opisuje objekt fiscalResponse („pozicije“) znotraj objekta Document (objekt Document
).

Celoten opis modela RetailForce DOM (Document Object Model) sistema ter opis posameznih elementov najdete v rubriki za prenose na RetailForce website (Object model documentation.pdf) v ustreznem imeniku različic.

Objekt fiscalResponse se vrne sistemu na višji ravni (blagajna, sistem elektronskega evidentiranja) kot odgovor na uspešen prenos dokumenta (createDocument in storeDocument).

Objekt fiscalResponse sestavljajo:

Standardnih informacij – informacij, ki so neodvisne od zadevne (davčne) države (enake za vsako državo)
Informacije, specifične za državo – določene informacije, ki morajo biti v zadevni državi natisnjene na računu ali shranjene v dnevniku. Te informacije so vrnjene v nizu »AdditionalFields« objekta fiscalResponse.

Objekt fiscalResponse

Naslednji objekt vsebuje vzorčne podatke.

{
   "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
   }
}

Objekt fiscalResponse vsebuje naslednje informacije.

Podatki v stolpcu »Type«:

M … obvezno / zahtevano
M* ... obvezno / zahtevano v nekaterih državah ali pod določenimi pogoji
R ... priporočeno
O... neobvezno

Elementi		Tip	Opis
fiscalCountry			Kazalnik za zadevno davčno državo. Enum: [0] = Nemčija [1] = Avstrija [2] = Francija [3] = Bolgarija [4] = Danska [5] = Švedska [6] = Slovenija [7] = Poljska [8] = Srbija [9] = Italija [10] = Hrvaška [12] = Romunija [15] = Litva [16] = Madžarska [18] = Španija [99999] = Brez obdavčitve
fiscalisationDocumentNumber			Številka davčnega dokumenta (jo dodeli ustrezni davčni sistem – npr. TSE v Nemčiji). Celoštevilčna vrednost Opomba: Zastarelo, v prihodnjih različicah bo nadomeščeno z lastnostjo stringa fiscalDocumentNumber.
fiscalDocumentNumber			Številka davčnega dokumenta (jo dodeli ustrezni davčni sistem – npr. TSE v Nemčiji). Podrobnosti o državi: Nemčija: lastnost fiscalDocumentNumber (v njeni vrednosti) iz odgovora fiscalResponse po klicu funkcije createDocument mora biti vključena v dokument JSON, ki se pošlje v storeDocument . Opomba: Uvedeno z različico 1.7.7. fiscalDocumentNumber je, v nasprotju s fiscalisationDocumentNumber, element tipa »string«
~~fiscalisationDocumentRevision~~			Številka revizije davčnega dokumenta. (jo dodeli ustrezni davčni sistem – TSE v Nemčiji). Pozor: lastnost »fiscalisationDocumentRevision« je bila v release 1.7.7 odstranjena iz hedera objekta fiscalResponse. Lastnost je bila preimenovana v »fiscalDocumentRevision« in se zdaj vrača le kot del AdditionalFields objekta fiscalResponse-Nemčija !
TaxPositions			Navedba vseh Vat-pozicij v dokumentu.
	VatIdentification		ID Kazalnik stopnje DDV za postavko DDV. Postavka
	VatLabel
	VatPercent1		Davčna stopnja v odstotkih za to postavko Vat. Postavka (v tem primeru postavka Vat 1)
	VatAmount		Znesek Vat za postavko Vat
	NetAmount		Neto znesek (brez Vat) te Vat-postavke. Postavka
	GrossAmount		Bruto znesek (vključno z Vatom) Vat-postavke
fiscalDocumentStartTime			Čas nastanka fiskalnega dokumenta – časovni žig Unix (ga dodeli ustrezni fiskalni sistem – npr. TSE v Nemčiji).
processStartTime			Čas nastanka prvega dokumenta v okviru celotnega procesa (npr. Nemčija: čas nastanka prvega naročila stranke v povezavi s tem plačilnim dokumentom – glej tudi »značilnosti gostinstva«).
ErrorDescription			Opis napake, če je proces fiskalizacije spodletel. Polje je prazno, če ni prišlo do napake.
cashRegisterId			Vrne številko blagajne, pod katero je bil fiskalni dokument registriran/obdelan.
signature			Podpis dokumenta, ki ga je ustvaril zadevni sistem za fiskalizacijo (npr. naprava za ustvarjanje podpisov v Avstriji, TSE v Nemčiji...)
UserMessage			Obvestilo, ki ga je treba prikazati uporabniku POS-sistema. Pozor: v nekaterih državah je treba morebitno sporočilo za uporabnika prikazati blagajniku. Priporočamo, da ta postopek izvedete za vsako državo, v kateri veljajo fiskalni predpisi.
PrintMessage			Mora biti natisnjeno na dokumentu (npr. »blagajniški bon«), sicer obstaja tveganje, da izvedba ne bo v skladu z zakonskimi zahtevami v zadevni državi. Upoštevajte tudi »PrintMessage«. Pozor: v nekaterih državah morajo biti podatki, vrnjeni prek elementa PrintMessage, natisnjeni na računu. Priporočamo, da ta postopek uvedete za vsako davčno državo.
requestTime			Vrne čas zahtevka
requestCompletionTime			Vrne čas, ko je fiskalni sistem zaključil zahtevo
retailForceReceiptId			Globalno edinstvena identifikacijska številka dokumenta, ki jo dodeli RetailForce system. Vrne se le v fiscalResponse ob klicu PUT /api/v1/transactions/createDocument. Opomba: Da se lahko generira retailForceReceiptId, je treba to za zadevnega stranko enkrat aktivirati s klicem funkcije POST /api/v1/management/clients/ {clientId}/GlobalShortId . Več informacij najdete v članku »Globalna ID blagajne in globalna ID dokumenta«.
AdditionalFields			Podatki, specifični za posamezno državo
	{...}		fiscalResponseAvstrija fiscalResponseBulgaria fiscalResponseKanada fiskalni odziv Hrvaška fiskalni odziv na Danskem fiskalni odziv Francije fiskalni odziv Nemčija fiskalni odziv Grčije fiskalni odziv na Madžarskem fiskalni odziv Italije fiskalni odziv Litve fiskalni odziv Poljske fiskalni odziv Romunije fiskalni odziv Srbije fiskalni odziv na Slovaškem fiskalni odziv v Sloveniji fiskalni odziv Španija fiskalni odziv Švedska

Ta članek je bil samodejno preveden.

Objekt fiscalResponse

Sorodni sklopi