FiscalResponse-objekt "fiscalResponse" – RetailForce

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

Potpuni opis RetailForce DOM-a (Model objekata dokumenta), kao i opis pojedinačnih elemenata, možete pronaći u odjeljku za preuzimanje na web stranici RetailForce (Object model documentation.pdf) u odgovarajućem direktoriju za verzije.

Objekt fiscalRsponse se vraća nadređenom sistemu (blagajni, elektronskom sistemu za evidenciju) kao odgovor na uspješnu transmisiju dokumenta (createDocument i storeDocument).

Objekt FiscalResponse se sastoji od:

Standardne informacije - informacije nezavisne od odgovarajuće (fiskalne) zemlje (iste za svaku zemlju)
Informacije specifične za zemlju - određene informacije koje se moraju ispisati na račun u odgovarajućoj zemlji ili pohraniti u dnevnik. Ove informacije se 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 koloni "Type":

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

Elementi		Tip	Opis
fiskalna zemlja			Indikator za odgovarajuću fiskalnu državu. 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] = Rumunija [15] = Litvanija [16] = Mađarska [18] = Španija [99999] = Nema fiskalizacije
brojFiskalizacije			Broj fiskalnog dokumenta (dodjeljuje ga nadležni fiskalni sistem – 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 sistem - npr. TSE u DE). Podaci o zemlji: Njemačka: svojstvo fiscalDocumentNumber (i njegova vrijednost) u fiscalResponse-u nakon poziva createDocument mora biti uključeno u JSON dokument koji se šalje na storeDocument . Napomena: Napomena: Uvedeno verzijom 1.7.7. fiscalDocumentNumber je, za razliku od fiscalisationDocumentNumber, element tipa "string".
~~revidencijaFiskalnogDokumenta~~			Broj revizije fiskalnog dokumenta. (dodjeljuje ga odgovarajući fiskalni sistem - TSE u DE). Pažnja: svojstvo "fiscalisationDocumentRevision" je uklonjeno iz zaglavlja objekta fiscalResponse sa izdanjem 1.7.7. Svojstvo je preimenovano u "fiscalDocumentRevision" i sada se vraća samo kao dio dodatnih polja (additionalFields) objekta fiscalResponse-Germany !
pozicijePoreza			Oznaka svih PDV pozicija dokumenta.
	identifikacijaPDV-a		ID indikator stope PDV-a za stavku PDV-a. Stavka
	vatLabel
	vatPercent1		Poreska stopa u procentima za ovu PDV poziciju. Pozicija (u ovom slučaju PDV pozicija 1)
	iznosPDV-a		PDV iznos PDV pozicije
	netoIznos (bez PDV-a) poreznog položaja.		Neto iznos (bez PDV-a) pozicije PDV-a.
	brutoIznos		Bruto iznos (uključujući PDV) PDV stavke
fiscalDocumentStartTime			Vrijeme izrade fiskalnog dokumenta - Unix vremenski žig (dodjeljuje ga nadležni fiskalni sistem - npr. TSE u Njemačkoj).
vrijemePočetkaProcesa			Vrijeme kreiranja prvog dokumenta unutar cijelog procesa (npr. Njemačka: vrijeme kreiranja prve narudžbe kupca u vezi sa ovim dokumentom o plaćanju - vidi također "karakteristike gastronomije").
opisGreške			Opis greške ako je proces fiskalizacije neuspio. Prazno ako nije došlo do greške.
cashRegisterId			Vraća broj kase pod kojim je fiskalni dokument registrovan / obrađen.
potpis			Potpis dokumenta, kreiran od strane odgovarajućeg sistema fiskalizacije (npr. uređaj za kreiranje potpisa u AT, TSE u DE...)
userMessage			Obavijest koja se mora prikazati korisniku POS sistema. Pažnja: u nekim zemljama moguća poruka za korisnika mora biti prikazana blagajniku. Preporučujemo implementaciju ove procedure za svaku fiskalnu zemlju.
printMessage			Mora biti odštampano na dokumentu (npr. "gotovinski bon"), u suprotnom postoji rizik da implementacija neće biti u skladu sa zakonskim zahtjevima u dotičnoj zemlji. Također obratite pažnju na "printMessage". Pažnja: u nekim zemljama informacije vraćene putem elementa printMessage moraju biti odštampane na računu. Preporučujemo implementaciju ove procedure za svaku fiskalnu zemlju.
requestTime			Vraća vrijeme zahtjeva
requestCompletionTime			Vraća vrijeme kada je zahtjev dovršen od strane fiskalnog sistema
retailForceReceiptId			Globalno jedinstveni ID dokumenta dodijeljen od strane sistema RetailForce. Vraćeno samo u fiscalResponse pri pozivu PUT /api/v1/transactions/createDocument. Napomena: Da bi se generisao RetailForceReceiptId, on se mora jednom aktivirati za odgovarajućeg klijenta pozivanjem funkcije POST /api/v1/management/clients/ {clientId}/globalShortId . Dodatne informacije možete pronaći u članku "Global cash register ID and global document ID".
additionalFields			Informacije specifične za zemlju
	{...}		fiscalResponseAustrija fiscalResponseBugarska fiscalResponseCanada fiscalResponseHrvatska fiscalResponseDanska fiscalResponseFrance fiscalResponseNjemačka fiscalResponseGrčka fiscalResponseMađarska fiscalResponseItaly fiscalResponseLitvanija fiscalResponsePoland fiscalResponsePortugal fiscalResponseRumunija fiscalResponseSerbia fiscalResponseSlovačka fiscalResponseSlovenija fiscalResponseŠpanija fiscalResponseŠvedska

Ovaj članak je automatski preveden.

objekt fiscalResponse

Related articles