FiscalResponse-објекат "fiscalResponse" – RetailForce

Овај чланак описује објекат FiscalResponse ("positions") унутар Document објекта (
Document object).

Комплетна опис DOM-а RetailForce (модела објеката документа), као и опис појединачних елемената, може се наћи у одељку за преузимање на веб-сајту RetailForce (Object model documentation.pdf) у одговарајућем директоријуму верзија.

Објекат fiscalRsponse се враћа горењем систему (каси, електронском систему евиденције) као одговор на успешно преношење документа (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			Индикатор за одговарајућу фискалну земљу. Енум: [0] = Немачка [1] = Аустрија [2] = Француска [3] = Бугарска [4] = Данска [5] = Шведска [6] = Словенија [7] = Пољска [8] = Србија [9] = Италија [10] = Хрватска [12] = Румунија [15] = Литванија [16] = Мађарска [18] = Шпанија [99999] = Без фискализације
бројпорескогдокумента			Број фискалног документа (додељује га одговарајући фискални систем – нпр. TSE у DE). Целобројна вредност Напомена: Овај елемент је застарео и у будућим верзијама биће замењен својством string fiscalDocumentNumber.
бројФискалногДокумента			Број фискалног документа (додељује га одговарајући порески систем – нпр. TSE у DE). Подаци о земљи: Немачка: својство fiscalDocumentNumber (и његова вредност) у објекту fiscalResponse након позива createDocument мора бити укључено у JSON документ који се шаље преко storeDocument . Напомена: Напомена: Уведено са верзијом 1.7.7. fiscalDocumentNumber је, за разлику од fiscalisationDocumentNumber, елемент "string".
~~ревизија фискалног документа~~			Број ревизије фискалног документа. (додељује га одговарајући фискални систем - TSE у DE). Пажња: својство "fiscalisationDocumentRevision" је уклоњено из заглавља објекта fiscalResponse са издањем 1.7.7. Својство је преименовано у "fiscalDocumentRevision" и сада се враћа само као део additionalFields објекта fiscalResponse-Germany !
порескеПозиције			Приказ свих ПДВ позиција документа.
	порески идентификациони број		ИД индикатора стопе ПДВ-а за ставку ПДВ-а. Ставка
	vatLabel
	vatPercent1		Пореска стопа у процентима за ову ПДВ позицију. Позиција (у овом случају ПДВ позиција 1)
	износПДВ		Износ ПДВ-а за позицију ПДВ-а
	нетоИзнос (без ПДВ) позиције ПДВ-а. Позиција		Нето износ (без ПДВ) позиције ПДВ-а.
	grossAmount		Бруто износ (укљ. ПДВ) пореске позиције
fiscalDocumentStartTime			Време креирања фискалног документа - Unix временски жиг (додељује га одговарајући фискални систем - нпр. TSE у DE).
Време покретања процеса			Време креирања првог документа у оквиру целог процеса (нпр. Немачка: време креирања прве наруџбине купца у вези са овим плаћајним документом - видети такође "карактеристике гастрономије").
опис грешке			Опис грешке уколико је процес фискализације неуспео. Празно ако није дошло до грешке.
бројфискалногрегистратора			Враћа број фискалне касе под којим је фискални документ регистрован/обрађен.
потпис			Потпис документа, креиран од стране одговарајућег система фискализације (нпр. уређај за креирање потписа у AT, TSE у DE...)
userMessage			Обавештење које мора бити приказано кориснику ПОС система. Пажња: у неким земљама могућа порука за корисника мора бити приказана касиру. Препоручујемо да се ова процедура имплементира за сваку пореску земљу.
printMessage			Мора да се одштампа на документу (нпр. "кеш ваучер"), у супротном постоји ризик да имплементација неће бити у складу са законским захтевима у одговарајућој земљи. Такође обратите пажњу на "printMessage". Пажња: у неким земљама информације враћене преко елемента printMessage морају бити одштампане на потврди. Препоручујемо да се ова процедура имплементира за сваку пореску земљу.
requestTime			Враћа време захтева
requestCompletionTime			Враћа време када је захтев завршен у фискалном систему
retailForceReceiptId			Глобално јединствени ИД документа додељен од стране система RetailForce. Враћа се само у fiscalResponse приликом позива PUT /api/v1/transactions/createDocument. Напомена: Да би се генерисао RetailForceReceiptId, он мора једном бити активиран за одговарајућег клијента позивањем функције POST /api/v1/management/clients/ {clientId}/globalShortId . Додатне информације могу се наћи у чланку "Глобални ID касе и глобални ID документа".
additionalFields			Информације специфичне за земљу
	{...}		fiscalResponseAustrija fiscalResponseBulgaria fiscalResponseCanada fiscalResponseCroatia fiscalResponseДанска fiscalResponseФранцуска fiscalResponseНемачка fiscalResponseГрчка fiscalResponseМађарска fiscalResponseItaly fiscalResponseЛитва fiscalResponseПољска fiscalResponseРумунија fiscalResponseСрбија fiscalResponseСловачка fiscalResponseСловенија fiscalResponseШпанија fiscalResponseШведска

Овај чланак је аутоматски преведен.

објекат fiscalResponse

Povezani članci