Obiekt fiscalResponse „fiscalResponse” – RetailForce

W niniejszym artykule opisano obiekt fiscalResponse („pozycje”) w ramach obiektu Document (obiekt Document
).

Pełny opis RetailForce DOM, a także opis poszczególnych elementów, można znaleźć w sekcji plików do pobrania na stronie internetowej RetailForce (Object model documentation.pdf) w odpowiednim katalogu wersji.

Obiekt fiscalResponse jest zwracany do systemu nadrzędnego (kasa fiskalna, elektroniczny system rejestracji) jako odpowiedź na pomyślne przesłanie dokumentu (createDocument i storeDocument).

Obiekt fiscalResponse składa się z:

Informacji standardowych – informacji niezależnych od danego kraju (pod względem podatkowym) (takich samych dla każdego kraju)
Informacje specyficzne dla danego kraju – określone informacje, które muszą zostać wydrukowane na paragonie w danym kraju lub zapisane w dzienniku. Informacje te są zwracane w tablicy „AdditionalFields” obiektu fiscalResponse.

Obiekt fiscalResponse

Poniższy obiekt zawiera przykładowe dane.

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

Obiekt fiscalResponse zawiera następujące informacje.

Informacje w kolumnie „Type”:

M … obowiązkowe / wymagane
M* ... obowiązkowe / wymagane w niektórych krajach lub pod pewnymi warunkami
R ... zalecane
O... opcjonalne

Elementy		Typ	Opis
fiscalCountry			Wskaźnik odpowiadający danemu krajowi podatkowemu. Enum: [0] = Niemcy [1] = Austria [2] = Francja [3] = Bułgaria [4] = Dania [5] = Szwecja [6] = Słowenia [7] = Polska [8] = Serbia [9] = Włochy [10] = Chorwacja [12] = Rumunia [15] = Litwa [16] = Węgry [18] = Hiszpania [99999] = Brak fiskalizacji
fiscalisationDocumentNumber			Numer dokumentu podatkowego (przypisywany przez odpowiedni system podatkowy – np. TSE w Niemczech). Wartość całkowita Uwaga: Ta właściwość jest przestarzała; w przyszłych wersjach zostanie zastąpiona właściwością typu string o nazwie fiscalDocumentNumber.
fiscalDocumentNumber			Numer dokumentu podatkowego (przypisywany przez odpowiedni system podatkowy – np. TSE w Niemczech). Szczegóły dotyczące poszczególnych krajów: Niemcy: właściwość fiscalDocumentNumber (wraz z jej wartością) z odpowiedzi fiscalResponse po wywołaniu metody createDocument musi zostać uwzględniona w dokumencie JSON, który ma zostać przesłany do metody storeDocument . Uwaga: Wprowadzono w wersji 1.7.7. W odróżnieniu od „fiscalisationDocumentNumber”, „fiscalDocumentNumber” jest elementem typu „string”
~~fiscalisationDocumentRevision~~			Numer rewizji dokumentu podatkowego. (przypisywany przez odpowiedni system podatkowy – TSE w Niemczech). Uwaga: właściwość „fiscalisationDocumentRevision” została usunięta z nagłówka obiektu fiscalResponse w release 1.7.7. Właściwość ta została przemianowana na „fiscalDocumentRevision” i jest obecnie zwracana wyłącznie w ramach dodatkowych pól (AdditionalFields) obiektu fiscalResponse-Germany !
TaxPositions			Wskazanie wszystkich pozycji Vat w dokumencie.
	VatIdentification		ID Wskaźnik stawki Vat dla pozycji Vat. Pozycja
	VatLabel
	VatPercent1		Stawka podatku wyrażona w procentach dla tej pozycji Vat. Pozycja (w tym przypadku pozycja Vat nr 1)
	VatAmount		Kwota podatku Vat dla pozycji Vat
	NetAmount		Kwota netto (bez Vat) pozycji Vat. Pozycja
	GrossAmount		Kwota brutto (z Vat) pozycji Vat
fiscalDocumentStartTime			Czas utworzenia dokumentu fiskalnego – znacznik czasu Unix (przypisywany przez odpowiedni system fiskalny – np. TSE w Niemczech).
processStartTime			Czas utworzenia pierwszego dokumentu w ramach całego procesu (np. w Niemczech: czas utworzenia pierwszego zamówienia klienta związanego z niniejszym dokumentem płatniczym – zob. również „charakterystyka gastronomii”).
ErrorDescription			Opis błędu w przypadku niepowodzenia procesu fiskalizacji. Pole pozostaje puste, jeśli nie wystąpił żaden błąd.
cashRegisterId			Zwraca numer kasy fiskalnej, pod którym dokument fiskalny został zarejestrowany/przetworzony.
signature			Podpis dokumentu, utworzony przez odpowiedni system fiskalizacji (np. urządzenie do tworzenia podpisów w Austrii, TSE w Niemczech...)
UserMessage			Powiadomienie, które musi zostać wyświetlone użytkownikowi systemu POS. Uwaga: w niektórych krajach ewentualny komunikat dla użytkownika musi zostać wyświetlony kasjerowi. Zalecamy wdrożenie tej procedury dla każdego kraju objętego systemem fiskalnym.
PrintMessage			Musi zostać wydrukowane na dokumencie (np. „paragon kasowy”), w przeciwnym razie istnieje ryzyko, że wdrożenie nie będzie zgodne z wymogami prawnymi obowiązującymi w danym kraju. Proszę zwrócić również uwagę na element „PrintMessage”. Uwaga: w niektórych krajach informacje zwracane za pośrednictwem elementu PrintMessage muszą zostać wydrukowane na paragonie. Zalecamy wdrożenie tej procedury dla każdego kraju podlegającego przepisom podatkowym.
requestTime			Zwraca czas złożenia żądania
requestCompletionTime			Zwraca czas zakończenia żądania przez system fiskalny
retailForceReceiptId			Globalnie unikalny ID dokumentu przypisany przez RetailForce system. Zwracany wyłącznie w odpowiedzi fiscalResponse przy wywołaniu metody PUT /api/v1/transactions/createDocument. Uwaga: Aby identyfikator retailForceReceiptId mógł zostać wygenerowany, należy go jednorazowo aktywować dla danego klienta poprzez wywołanie funkcji POST /api/v1/management/clients/ {clientId}/GlobalShortId . Więcej informacji można znaleźć w artykule „Globalny ID kasy fiskalnej i globalny ID dokumentu”.
AdditionalFields			Informacje specyficzne dla danego kraju
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada reakcjafiskalnaChorwacja fiscalResponseDania reakcja budżetowa we Francji reakcja budżetowa w Niemczech reakcja budżetowa w Grecji reakcja budżetowa na Węgrzech reakcja budżetowa we Włoszech reakcja budżetowa na Litwie reakcja budżetowa w Polsce reakcja budżetowa w Rumunii reakcja budżetowa w Serbii reakcja budżetowa na Słowacji reakcja budżetowa Słowenii reakcja budżetowa w Hiszpanii fiscalResponseSzwecja

Ten artykuł został przetłumaczony automatycznie.

Obiekt fiscalResponse

Powiązane artykuły