Objekt FiscalResponse „fiscalResponse“ – RetailForce

Tento článok opisuje objekt fiscalResponse („pozície“) v rámci objektu Document (objekt Document
).

Úplný popis RetailForce DOM (Document Object Model), ako aj popis jednotlivých prvkov, nájdete v sekcii na stiahnutie na RetailForce website (Object model documentation.pdf) v príslušnom adresári verzií.

Objekt fiscalResponse sa vráti nadradenému systému (pokladni, elektronickému záznamovému systému) ako odpoveď na úspešný prenos dokumentu (createDocument a storeDocument).

Objekt fiscalResponse sa skladá z:

Štandardných informácií – informácií nezávislých od príslušnej (daňovej) krajiny (rovnakých pre každú krajinu)
Informácií špecifických pre danú krajinu – určitých informácií, ktoré musia byť v príslušnej krajine vytlačené na pokladničnom doklade alebo uložené v denníku. Tieto informácie sa vracajú v poli „AdditionalFields“ objektu fiscalResponse.

Objekt fiscalResponse

Nasledujúci objekt obsahuje vzorové údaje.

{
   "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 obsahuje nasledujúce informácie.

Informácie v stĺpci „Type“:

M ... povinné / vyžadované
M* ... povinné / vyžadované v určitých krajinách alebo za určitých podmienok
R ... odporúčané
O... voliteľné

Prvky		Typ	Popis
fiscalCountry			Indikátor príslušnej daňovej krajiny. Enum: [0] = Nemecko [1] = Rakúsko [2] = Francúzsko [3] = Bulharsko [4] = Dánsko [5] = Švédsko [6] = Slovinsko [7] = Poľsko [8] = Srbsko [9] = Taliansko [10] = Chorvátsko [12] = Rumunsko [15] = Litva [16] = Maďarsko [18] = Španielsko [99999] = Bez zdanenia
fiscalisationDocumentNumber			Číslo daňového dokladu (pridelené príslušným daňovým systémom – napr. TSE v Nemecku). Celé číslo Poznámka: Zastarané, v budúcich verziách bude nahradené stringovou vlastnosťou fiscalDocumentNumber.
fiscalDocumentNumber			Číslo daňového dokladu (priraďuje ho príslušný daňový systém – napr. TSE v Nemecku). Podrobnosti o krajine: Nemecko: Vlastnosť fiscalDocumentNumber (a jej hodnota) z odpovede fiscalResponse po volaní metódy createDocument musí byť zahrnutá v dokumente JSON, ktorý sa má odoslať metóde storeDocument . Poznámka: Poznámka: Zavedené vo verzii 1.7.7. fiscalDocumentNumber je, na rozdiel od fiscalisationDocumentNumber, prvkom typu „string“
~~fiscalisationDocumentRevision~~			Číslo revízie daňového dokladu. (priraďuje ho príslušný daňový systém – TSE v Nemecku). Upozornenie: Vlastnosť „fiscalisationDocumentRevision“ bola vo release 1.7.7 odstránená z hlavičky objektu fiscalResponse. Vlastnosť bola premenovaná na „fiscalDocumentRevision“ a teraz sa vracia iba ako súčasť AdditionalFields objektu fiscalResponse-Germany !
TaxPositions			Údaj o všetkých pozíciách Vat v dokumente.
	VatIdentification		ID označujúce sadzbu DPH pre danú položku DPH. Položka
	VatLabel
	VatPercent1		Daňová sadzba v percentách tejto položky Vat. Položka (v tomto prípade položka Vat 1)
	VatAmount		Suma Vat tejto položky Vat
	NetAmount		Čistá suma (bez DPH) tejto Vat pozície. Pozícia
	GrossAmount		Hrubá suma (vrátane Vat) položky Vat
fiscalDocumentStartTime			Čas vytvorenia daňového dokladu – časová pečiatka Unix (priraďuje ju príslušný daňový systém – napr. TSE v Nemecku).
processStartTime			Čas vytvorenia prvého dokumentu v rámci celého procesu (napr. Nemecko: Čas vytvorenia prvej zákazky zákazníka v súvislosti s príslušným platobným dokladom – pozri tiež „charakteristiky gastronómie“).
ErrorDescription			Popis chyby v prípade, že proces fiskalizácie zlyhal. Prázdne, ak nedošlo k žiadnej chybe.
cashRegisterId			Vráti číslo pokladnice, pod ktorou bol daňový doklad zaregistrovaný/spracovaný.
signature			Podpis dokumentu, vytvorený príslušným fiskalizačným systémom (napr. zariadenie na vytváranie podpisov v Rakúsku, TSE v Nemecku...)
UserMessage			Oznámenie, ktoré sa musí zobraziť používateľovi POS systému. Pozor: v niektorých krajinách sa prípadná správa pre používateľa musí zobraziť pokladníkovi. Odporúčame implementovať tento postup pre každú krajinu s daňovou povinnosťou.
PrintMessage			Musí byť vytlačená na dokumente (napr. „pokladničný doklad“), inak hrozí, že implementácia nebude spĺňať zákonné požiadavky v príslušnej krajine. Pozrite si tiež „PrintMessage“. Pozor: v niektorých krajinách musia byť informácie vrátené prostredníctvom prvku PrintMessage vytlačené na pokladničnom doklade. Odporúčame implementovať tento postup pre každú daňovú krajinu.
requestTime			Vráti čas odoslania žiadosti
requestCompletionTime			Vráti čas, kedy bola žiadosť spracovaná daňovým systémom
retailForceReceiptId			Globálne jedinečné ID dokumentu pridelené RetailForce systemom. Vrátené iba v fiscalResponse pri volaní PUT /api/v1/transactions/createDocument. Poznámka: Aby sa mohlo vygenerovať retailForceReceiptId, je potrebné túto funkciu pre príslušného klienta jednorazovo aktivovať volaním funkcie POST /api/v1/management/clients/ {clientId}/GlobalShortId . Ďalšie informácie nájdete v článku „Globálne ID pokladne a globálne ID dokumentu“.
AdditionalFields			Informácie špecifické pre danú krajinu
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseKanada fiškálnaReakciaChorvátsko fiškálna reakcia Dánsko fiškálna reakcia vo Francúzsku fiškálna reakcia Nemecko fiškálna reakcia Grécko fiškálna reakcia Maďarsko fiškálna reakcia Taliansko fiškálna reakcia Litva fiškálna reakcia Poľsko fiškálna reakcia Rumunsko fiškálnaReakciaSrbsko fiškálna reakcia na Slovensku fiškálnaReakciaSlovinsko fiškálnaReakciaŠpanielsko fiškálna reakcia vo Švédsku

Tento článok bol preložený automaticky.

Objekt fiscalResponse

Podobné články