FiscalResponse-objektum „fiscalResponse” – RetailForce

Ez a cikk a Document objektumon belüli fiscalResponse objektumot („pozíciók”) ismerteti.
(Document objektum).

A RetailForce DOM (Document Object Model) teljes leírása, valamint az egyes elemek leírása megtalálható a RetailForce website letöltési részében (Object model documentation.pdf) a megfelelő verzió könyvtárában.

A fiscalResponse objektumot a sikeres dokumentumátvitelre (createDocument és storeDocument) adott válaszként visszaküldik a felettes rendszernek (pénztárgép, elektronikus nyilvántartási rendszer).

A fiscalResponse objektum a következőkből áll:

Szabványos információk – az adott (adóügyi) országtól független információk (minden országban azonosak)
Országspecifikus információk – bizonyos információk, amelyeket az adott országban a nyugtán ki kell nyomtatni, vagy a naplóban tárolni kell. Ezeket az információkat a fiscalResponse „AdditionalFields” tömbjében adja vissza a rendszer.

fiscalResponse objektum

Az alábbi objektum mintadadatokat tartalmaz.

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

A fiscalResponse objektum a következő információkat tartalmazza.

A „Type” oszlopban szereplő információk:

M ... kötelező / előírt
M* ... kötelező / előírt bizonyos országokban vagy bizonyos feltételek mellett
R ... ajánlott
O... opcionális

Elemek		Típus	Leírás
fiscalCountry			Az adott adóügyi országra vonatkozó jelző. Enum: [0] = Németország [1] = Ausztria [2] = Franciaország [3] = Bulgária [4] = Dánia [5] = Svédország [6] = Szlovénia [7] = Lengyelország [8] = Szerbia [9] = Olaszország [10] = Horvátország [12] = Románia [15] = Litvánia [16] = Magyarország [18] = Spanyolország [99999] = Nincs adóügyi nyilvántartás
fiscalisationDocumentNumber			Adóügyi dokumentumszám (az adott adórendszer által hozzárendelt – pl. TSE Németországban). Egész szám Megjegyzés: Elavult, a jövőbeli verziókban a fiscalDocumentNumber string-tulajdonság váltja fel.
fiscalDocumentNumber			Adóügyi dokumentumszám (a megfelelő adórendszer által hozzárendelve – pl. TSE Németországban). Országspecifikus részletek: Németország: a createDocument hívás után a fiscalResponse fiscalDocumentNumber tulajdonságát (és annak értékét) fel kell tüntetni a storeDocument -nek elküldendő JSON-dokumentumban. Megjegyzés: A v.1.7.7-es verzióval bevezetve. A fiscalDocumentNumber – ellentétben a fiscalisationDocumentNumber-rel – egy „string” típusú elem.
~~fiscalisationDocumentRevision~~			Az adóügyi dokumentum revíziós száma. (Ezt a megfelelő adórendszer rendeli hozzá – Németországban a TSE.) Figyelem: a „fiscalisationDocumentRevision” tulajdonságot az 1.7.7-es release-vel eltávolították a fiscalResponse objektum headerjéből. A tulajdonságot átnevezték „fiscalDocumentRevision”-ra, és most már csak a fiscalResponse-Germany AdditionalFields részeként kerül visszaadásra!
TaxPositions			A dokumentum összes Vat-pozíciójának feltüntetése.
	VatIdentification		ID A HÉA-tétel HÉA-kulcsának jelölője. Tétel
	VatLabel
	VatPercent1		Az adott Vat-tétel százalékos adókulcsa. Tétel (ebben az esetben az 1. Vat-tétel)
	VatAmount		Vat-tétel Vat-összege
	NetAmount		A Vat nettó összege (Vat nélkül). Tétel
	GrossAmount		A Vat-tétel bruttó összege (Vat-val együtt)
fiscalDocumentStartTime			Az adóügyi dokumentum létrehozásának ideje – Unix időbélyeg (az adott adórendszer – pl. a német TSE – rendeli hozzá).
processStartTime			Az egész folyamaton belüli első dokumentum létrehozásának ideje (pl. Németország: a jelen fizetési dokumentumhoz kapcsolódó első vevői megrendelés létrehozásának ideje – lásd még „a vendéglátás jellemzői”).
ErrorDescription			Hiba leírása, ha a fiskális feldolgozás sikertelen volt. Üres, ha nem történt hiba.
cashRegisterId			Visszaadja azt a pénztárgép-azonosítót, amely alatt a pénzügyi dokumentumot regisztrálták/feldolgozták.
signature			A dokumentum aláírása, amelyet az adott adóügyi rendszer hozott létre (pl. aláírás-készítő eszköz Ausztriában, TSE Németországban...)
UserMessage			A POS-rendszer felhasználójának megjelenítendő értesítés. Figyelem: egyes országokban az esetleges felhasználói üzenetet a pénztárosnak is meg kell jeleníteni. Javasoljuk, hogy ezt az eljárást minden adóügyi ország esetében valósítsák meg.
PrintMessage			Ezt a dokumentumra (pl. „pénztári bizonylat”) ki kell nyomtatni, ellenkező esetben fennáll a kockázata, hogy a megvalósítás nem felel meg az adott ország jogi követelményeinek. Lásd még: „PrintMessage”. Figyelem: egyes országokban a PrintMessage elem révén visszaküldött információkat fel kell tüntetni a nyugtán. Javasoljuk, hogy ezt az eljárást minden egyes adóügyi ország esetében valósítsák meg.
requestTime			Visszaadja a kérelem időpontját
requestCompletionTime			Visszaadja azt az időpontot, amikor a kérelem feldolgozása befejeződött az adórendszerben
retailForceReceiptId			A RetailForce system által hozzárendelt, globálisan egyedi dokumentumID. Csak a fiscalResponse-ban kerül visszaadásra, amikor a PUT /api/v1/transactions/createDocument hívásra kerül sor. Megjegyzés: A retailForceReceiptId generálásához ezt az adott ügyfél számára egyszer aktiválni kell a POST /api/v1/management/clients/ {clientId}/GlobalShortId művelet végrehajtásával. További információk a „Globális pénztárgép-ID és globális dokumentum-ID” című cikkben találhatók.
AdditionalFields			Országspecifikus információk
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada fiskálisintézkedésekHorvátország fiscalResponseDánia fiskális intézkedések Franciaországban fiskális intézkedések Németország fiskális intézkedések Görögországban fiskális intézkedések Magyarország fiscalResponseOlaszország fiskális intézkedések Litvánia fiskális intézkedések Lengyelország fiskális intézkedések Romániában fiskális intézkedések Szerbiában fiskális intézkedések Szlovákiában fiskális intézkedések Szlovénia fiskális intézkedések Spanyolországban fiscalResponseSvédország

Ezt a cikket automatikusan lefordították.

fiscalResponse objektum

Kapcsolódó cikkek