Objekt FiscalResponse „fiscalResponse“ – RetailForce

Tento článek popisuje objekt FiscalResponse („pozice“) v rámci objektu Document
(objekt Document).

Úplný popis DOM (Document Object Model) systému RetailForce, stejně jako popis jednotlivých prvků, naleznete v sekci ke stažení na webových stránkách RetailForce (Object model documentation.pdf) v příslušném adresáři s verzemi.

Objekt fiscalResponse se vrací do nadřazeného systému (pokladna, elektronický záznamový systém) jako odpověď na úspěšný přenos dokumentu (createDocument a storeDocument).

Objekt FiscalResponse se skládá z:

Standardních informací – informací nezávislých na příslušné (daňové) zemi (stejných pro každou zemi)
Informace specifické pro danou zemi – určité informace, které musí být v dané zemi vytištěny na účtence nebo uloženy v deníku. Tyto informace jsou vráceny v poli „AdditionalFields“ objektu fiscalResponse.

Objekt fiscalResponse

Následující objekt obsahuje ukázková data.

{
   "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 následující informace.

Informace ve sloupci „Type“:

M ... povinné / vyžadované
M* ... povinné / vyžadované v určitých zemích nebo za určitých podmínek
R ... doporučeno
O... volitelné

Prvky		Typ	Popis
fiscalCountry			Indikátor příslušné fiskální země. Výčet: [0] = Německo [1] = Rakousko [2] = Francie [3] = Bulharsko [4] = Dánsko [5] = Švédsko [6] = Slovinsko [7] = Polsko [8] = Srbsko [9] = Itálie [10] = Chorvatsko [12] = Rumunsko [15] = Litva [16] = Maďarsko [18] = Španělsko [99999] = Bez zdanění
číslo daňového dokladu			Číslo daňového dokladu (přiřazuje ho příslušný daňový systém – např. TSE v Německu). Celé číslo Poznámka: Zastaralé, v budoucích verzích bude nahrazeno řetězcovou vlastností fiscalDocumentNumber.
fiscalDocumentNumber			Číslo daňového dokladu (přiřazuje příslušný daňový systém – např. TSE v Německu). Údaje o zemi: Německo: vlastnost fiscalDocumentNumber (a její hodnota) z fiscalResponse po volání createDocument musí být zahrnuta v dokumentu JSON, který má být odeslán do storeDocument . Poznámka : Zavedeno ve verzi 1.7.7. fiscalDocumentNumber je, na rozdíl od fiscalisationDocumentNumber, prvkem typu „string“
~~fiscalisationDocumentRevision~~			Číslo revize daňového dokladu. (přiděluje jej příslušný daňový systém – v Německu TSE). Upozornění: vlastnost „fiscalisationDocumentRevision“ byla ve verzi 1.7.7 odstraněna z hlavičky objektu fiscalResponse. Vlastnost byla přejmenována na „fiscalDocumentRevision“ a nyní je vracena pouze jako součást AdditionalFields objektu fiscalResponse-Germany !
TaxPositions			Údaje o všech pozicích Vat v dokladu.
	vatIdentification		ID označující sazbu DPH u dané položky Vat. Položka
	VatLabel
	VatPercent1		Sazba daně v procentech této položky Vat. Položka (v tomto případě položka Vat 1)
	VatAmount		Částka Vat této položky Vat
	NetAmount		Čistá částka (bez DPH) daně Vat. Položka
	GrossAmount		Hrubá částka (vč. Vat) položky Vat
fiscalDocumentStartTime			Čas vytvoření daňového dokladu – časové razítko Unix (přiřazuje jej příslušný daňový systém – např. TSE v Německu).
processStartTime			Čas vytvoření prvního dokladu v rámci celého procesu (např. Německo: čas vytvoření první zákaznické objednávky související s daným platebním dokladem – viz také „charakteristiky gastronomie“).
errorDescription			Popis chyby v případě, že proces fiskální registrace selhal. Prázdné, pokud k žádné chybě nedošlo.
cashRegisterId			Vrací číslo pokladny, pod kterým byl fiskální doklad zaregistrován / zpracován.
signature			Podpis dokladu, vytvořený příslušným fiskalizačním systémem (např. zařízení pro vytváření podpisů v Rakousku, TSE v Německu...)
userMessage			Oznámení, které musí být zobrazeno uživateli pokladního systému. Upozornění: v některých zemích musí být případná zpráva pro uživatele zobrazena pokladníkovi. Doporučujeme tento postup implementovat pro každou fiskální zemi.
printMessage			Musí být vytištěno na dokladu (např. „pokladní stvrzenka“), jinak hrozí, že implementace nebude v souladu s právními požadavky v dané zemi. Viz také „printMessage“. Upozornění: v některých zemích musí být informace vrácené prostřednictvím prvku printMessage vytištěny na účtence. Doporučujeme tento postup implementovat pro každou fiskální zemi.
requestTime			Vrací čas odeslání žádosti
requestCompletionTime			Vrací čas, kdy byl požadavek dokončen fiskálním systémem
retailForceReceiptId			Globálně jedinečné ID dokumentu přidělené systémem RetailForce. Vráceno pouze v fiscalResponse při volání PUT /api/v1/transactions/createDocument. Poznámka: Aby bylo možné vygenerovat RetailForceReceiptId, je nutné tuto funkci pro daného klienta jednou aktivovat voláním funkce POST /api/v1/management/clients/ {clientId}/globalShortId . Další informace najdete v článku „Globální ID pokladny a globální ID dokladu“.
AdditionalFields			Informace specifické pro danou zemi
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada fiskální opatření v Chorvatsku fiskální opatření v Dánsku fiskální opatření ve Francii fiskální opatření v Německu fiskální opatření Řecko fiskální opatření v Maďarsku fiskální opatření v Itálii fiskální opatření v Litvě fiskální opatření v Polsku fiskální opatření v Portugalsku fiskální opatření v Rumunsku fiskální opatření Srbsko fiskální opatření na Slovensku fiskální opatření ve Slovinsku fiskální opatření Španělsko fiskální opatření ve Švédsku

Tento článek byl přeložen automaticky.

Objekt fiscalResponse

Související články