FiscalResponse-objekt "fiscalResponse" – RetailForce

Ovaj članak opisuje objekt FiscalResponse ("pozicije") unutar objekta dokumenta (Document
object).

Potpuni opis DOM-a (modela objekata dokumenta) sustava RetailForce, kao i opis pojedinih elemenata, možete pronaći u odjeljku za preuzimanje na web-stranici sustava RetailForce (Object model documentation.pdf) u odgovarajućem direktoriju s verzijama.

Objekt fiscalRsponse vraća se nadređenom sustavu (blagajni, elektroničkom sustavu evidencije) kao odgovor na uspješno slanje dokumenta (createDocument i storeDocument).

Objekt FiscalResponse sastoji se od:

Standardne informacije - informacije neovisne o dotičnoj (fiskalnoj) zemlji (iste za svaku zemlju)
Informacije specifične za zemlju - određene informacije koje se moraju ispisati na računu u odgovarajućoj zemlji ili pohraniti u dnevnik. Ove se informacije vraćaju u nizu "AdditionalFields" objekta fiscalResponse.

objekt fiscalResponse

Sljedeći objekt sadrži primjere podataka.

{
   "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 sadrži sljedeće informacije.

Informacije u stupcu "Type":

M ... obavezno / potrebno
M* ... obavezno / potrebno u određenim zemljama ili pod određenim uvjetima
R ... preporučeno
O... opcionalno

Elementi		Vrsta	Opis
zemljaFiskalne godine			Indikator za odgovarajuću fiskalnu zemlju. Enum: [0] = Njemačka [1] = Austrija [2] = Francuska [3] = Bugarska [4] = Danska [5] = Švedska [6] = Slovenija [7] = Poljska [8] = Srbija [9] = Italija [10] = Hrvatska [12] = Rumunjska [15] = Litva [16] = Mađarska [18] = Španjolska [99999] = Nema fiskalizacije
brojFiskalizacije			Broj fiskalnog dokumenta (dodjeljuje ga nadležni fiskalni sustav – npr. TSE u DE). Cjelobrojna vrijednost Napomena: zastarjelo, u budućim verzijama bit će zamijenjeno svojstvom string fiscalDocumentNumber.
fiskalni broj dokumenta			Broj fiskalnog dokumenta (dodjeljuje ga nadležni fiskalni sustav – npr. TSE u DE). Podaci o zemlji: Njemačka: svojstvo fiscalDocumentNumber (i njegova vrijednost) u odgovoru fiscalResponse nakon poziva createDocument mora biti uključeno u JSON dokument koji se šalje storeDocument . Napomena: Napomena: Uvedeno verzijom 1.7.7. fiscalDocumentNumber je, za razliku od fiscalisationDocumentNumber, element "string".
~~revidencijaFiskalnogDokumenta~~			Broj revizije fiskalnog dokumenta. (dodjeljuje ga nadležni fiskalni sustav – TSE u DE). Pažnja: svojstvo "fiscalisationDocumentRevision" uklonjeno je iz zaglavlja objekta fiscalResponse izdanom verzijom 1.7.7. Svojstvo je preimenovano u "fiscalDocumentRevision" i sada se vraća samo kao dio dodatnih polja (additionalFields) objekta fiscalResponse-Germany !
taxPositions			Oznaka svih PDV pozicija dokumenta.
	identifikacijaPDV-a		ID pokazatelja stope PDV-a stavke PDV-a. Stavka
	vatLabel
	vatPercent1		Stopa poreza u postotku ove PDV pozicije. Pozicija (u ovom slučaju PDV pozicija 1)
	iznosPDV-a		Iznos PDV-a za poziciju PDV-a
	netoIznos (bez PDV-a) poreznog položaja.		Neto iznos (bez PDV-a) PDV pozicije. Pozicija
	grossAmount		Bruto iznos (uključujući PDV) PDV stavke
fiscalDocumentStartTime			Vrijeme izrade fiskalnog dokumenta - Unix vremenski žig (dodjeljuje ga nadležni fiskalni sustav - npr. TSE u DE).
vrijemePočetkaProcesa			Vrijeme izrade prvog dokumenta unutar cijelog procesa (npr. Njemačka: vrijeme izrade prve narudžbe kupca u vezi s ovim dokumentom o plaćanju – vidi također "osobine gastronomije").
opisPogreške			Opis pogreške ako je proces fiskalizacije neuspio. Prazno ako nije došlo do pogreške.
cashRegisterId			Vraća broj blagajne pod kojom je fiskalni dokument registriran / obrađen.
potpis			Potpis dokumenta, generiran od strane odgovarajućeg sustava fiskalizacije (npr. uređaj za izradu potpisa u AT, TSE u DE...)
poruka za korisnika			Obavijest koja se mora prikazati korisniku POS sustava. Pažnja: u nekim zemljama moguća poruka za korisnika mora biti prikazana blagajniku. Preporučujemo implementaciju ovog postupka za svaku fiskalnu zemlju.
printMessage			Mora biti ispisano na dokumentu (npr. "gotovinski račun"), inače postoji rizik da implementacija neće biti u skladu sa zakonskim zahtjevima u dotičnoj zemlji. Također obratite pozornost na "printMessage". Pažnja: u nekim zemljama informacije vraćene putem elementa printMessage moraju biti ispisane na računu. Preporučujemo primjenu ovog postupka za svaku fiskalnu zemlju.
requestTime			Vraća vrijeme zahtjeva
requestCompletionTime			Vraća vrijeme kada je zahtjev dovršen u fiskalnom sustavu
retailForceReceiptId			Globalno jedinstveni ID dokumenta dodijeljen od strane sustava RetailForce. Vraća se samo u fiskalnom odgovoru (fiscalResponse) pri pozivu PUT /api/v1/transactions/createDocument. Napomena: Da bi se generirao RetailForceReceiptId, on se mora jednom aktivirati za odgovarajućeg klijenta pozivom funkcije POST /api/v1/management/clients/ {clientId}/globalShortId . Dodatne informacije možete pronaći u članku "Globalni ID blagajne i globalni ID dokumenta".
additionalFields			Informacije specifične za zemlju
	{...}		fiscalResponseAustrija fiscalResponseBugarska fiscalResponseCanada fiscalResponseCroatia fiscalResponseDanska fiscalResponseFrance fiscalResponseGermany fiscalResponseGrčka fiscalResponseMađarska fiscalResponseItaly fiscalResponseLitva fiscalResponsePoland fiscalResponseRumunjska fiscalResponseSerbia fiscalResponseSlovačka fiscalResponseSlovenija fiscalResponseŠpanjolska fiscalResponseŠvedska

Ovaj je članak automatski preveden.

objekt fiscalResponse

Povezani članci