Фискален отговор – обект „fiscalResponse“ – RetailForce

Настоящата статия описва обекта fiscalResponse („позиции“) в рамките на обекта Document (обект Document
).

Пълно описание на RetailForce DOM (Document Object Model), както и описание на отделните елементи, можете да намерите в раздела за изтегляне на RetailForce website (Object model documentation.pdf) в съответната директория с версии.

Обектът fiscalResponse се връща към системата нагоре по веригата (касов апарат, електронна система за регистриране) като отговор на успешно предаване на документ (createDocument и storeDocument).

Обектът fiscalResponse се състои от:

Стандартна информация – информация, независима от съответната (фискална) държава (еднаква за всяка държава)
Информация, специфична за страната – определена информация, която трябва да бъде отпечатана на касовата бележка в съответната страна или съхранена в дневника. Тази информация се връща в масива „AdditionalFields“ на fiscalResponse.

Обект fiscalResponse

Следващият обект съдържа примерни данни.

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

Обектът fiscalResponse съдържа следната информация.

Информация в колоната „Type“:

M ... задължително / изисквано
M* ... задължително / изисквано в определени държави или при определени условия
R ... препоръчително
O... по избор

Елементи		Тип	Описание
fiscalCountry			Индикатор за съответната фискална държава. Enum: [0] = Германия [1] = Австрия [2] = Франция [3] = България [4] = Дания [5] = Швеция [6] = Словения [7] = Полша [8] = Сърбия [9] = Италия [10] = Хърватия [12] = Румъния [15] = Литва [16] = Унгария [18] = Испания [99999] = Без фискализация
fiscalisationDocumentNumber			Номер на фискалния документ (присвоява се от съответната фискална система – например TSE в Германия). Целочислена стойност Забележка: Остаряло, ще бъде заменено от свойството от тип string fiscalDocumentNumber в бъдещи версии.
fiscalDocumentNumber			Номер на фискалния документ (присвоява се от съответната фискална система – например TSE в Германия). Подробности за държавата: Германия: свойството fiscalDocumentNumber (и неговата стойност) от fiscalResponse след извикване на createDocument трябва да бъде включено в JSON документа, който ще бъде изпратен към storeDocument . Забележка: Въведено с версия 1.7.7. fiscalDocumentNumber, за разлика от fiscalisationDocumentNumber, е елемент от тип „string“
~~fiscalisationDocumentRevision~~			Номер на ревизия на фискалния документ. (присвоява се от съответната фискална система – TSE в Германия). Внимание: свойството „fiscalisationDocumentRevision“ беше премахнато от header-то на обекта fiscalResponse с release 1.7.7. Свойството беше преименувано на „fiscalDocumentRevision“ и вече се връща само като част от AdditionalFields на fiscalResponse-Germany !
TaxPositions			Посочване на всички позиции по Vat в документа.
	VatIdentification		ID на ставката на Vat за позицията с Vat. Позиция
	VatLabel
	VatPercent1		Данъчна ставка в проценти за тази позиция по Vat. Позиция (в този случай позиция по Vat 1)
	VatAmount		Сума по Vat на позицията по Vat
	NetAmount		Нетна сума (без Vat) на позицията за Vat
	GrossAmount		Брутна сума (вкл. Vat) на позицията по Vat
fiscalDocumentStartTime			Време на създаване на фискалния документ – Unix Time Stamp (присвоява се от съответната фискална система – например TSE в Германия).
processStartTime			Време на създаване на първия документ в рамките на целия процес (например Германия: Време на създаване на първата клиентска поръчка във връзка с настоящия платежен документ – вижте също „характеристики на гастрономията“).
ErrorDescription			Описание на грешката, ако процесът на фискализация е завършил неуспешно. Полето остава празно, ако не е възникнала грешка.
cashRegisterId			Връща номера на касовия апарат, под който е регистриран/обработен фискалният документ.
signature			Подпис на документа, създаден от съответната система за фискализация (например устройство за създаване на подписи в Австрия, TSE в Германия...)
UserMessage			Уведомление, което трябва да се покаже на потребителя на POS системата. Внимание: в някои държави евентуално съобщение за потребителя трябва да се показва на касиера. Препоръчваме тази процедура да се приложи за всяка държава, в която се прилага фискализация.
PrintMessage			Трябва да бъде отпечатано върху документа (например „касов бон“), в противен случай съществува риск прилагането да не отговаря на законовите изисквания в съответната държава. Вижте също „PrintMessage“. Внимание: в някои държави информацията, върната чрез елемента PrintMessage, трябва да бъде отпечатана върху касовата бележка. Препоръчваме тази процедура да бъде приложена за всяка фискална държава.
requestTime			Връща времето на заявката
requestCompletionTime			Връща времето, когато заявката е била завършена от фискалната система
retailForceReceiptId			Глобално уникален ID на документа, присвоен от RetailForce system. Връща се само в fiscalResponse при извикване на PUT /api/v1/transactions/createDocument. Забележка: За да бъде генериран retailForceReceiptId, той трябва да бъде активиран еднократно за съответния клиент чрез извикване на функцията POST /api/v1/management/clients/ {clientId}/GlobalShortId . Допълнителна информация можете да намерите в статията „Глобален ID на касовия апарат и глобален ID на документа“.
AdditionalFields			Информация, специфична за страната
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada фискална_реакция_Хърватия фискална_реакция_Дания фискална реакция във Франция фискална реакция Германия фискална реакция в Гърция фискална реакция в Унгария фискална реакция в Италия фискална реакция в Литва фискална реакция в Полша фискална реакция в Румъния фискална реакция в Сърбия фискална реакция в Словакия фискална реакция в Словения фискална реакция в Испания фискална реакция в Швеция

Тази статия е преведена автоматично.

Обект fiscalResponse

Подобни статии