Ez a cikk a Document objektumon belüli fiscalResponse objektumot („pozíciók”) írja le.
(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ára kell nyomtatni, vagy a naplóban kell tárolni. Ezeket az információkat a fiscalResponse „AdditionalFields” tömbjében adja vissza a rendszer.
fiscalResponse objektum
Az alábbi objektum mintaadatokat 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:
|
||
| 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árendelt – pl. TSE Németországban). Országspecifikus részletek:
Megjegyzés:
A v.1.7.7 verzióval vezetett be. A fiscalDocumentNumber – ellentétben a fiscalisationDocumentNumber-rel – egy „string” típusú elem.
|
||
|
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 headeréből. A tulajdonságot átnevezték „fiscalDocumentRevision”-ra, és mostantól kizárólag 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 Vat-tétel HÉA-kulcsának jelölője. Tétel | ||
| VatLabel | |||
| VatPercent1 | Az adott Vat-tétel adókulcsa százalékban kifejezve. 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 HÉA-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 „gastronomiai jellemzők”). | ||
| 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 |
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 elemen keresztül 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 | ||
| {...} |
fiskálisintézkedésekHorvátország fiskális intézkedések Németország fiskális intézkedések Görögországban fiskális intézkedések Magyarország fiskális intézkedések Litvániában fiskális intézkedések Lengyelországban fiskális intézkedések Portugáliában fiskális intézkedések Romániában Szerbia költségvetési intézkedései fiskális intézkedések Szlovákiában fiskális intézkedések Szlovénia |
||
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.