Obiectul fiscalResponse „fiscalResponse” – RetailForce

Acest articol descrie obiectul fiscalResponse („poziții”) din cadrul obiectului Document (obiectul Document
).

O descriere completă a modelului RetailForce DOM (Document Object Model) și o descriere a elementelor individuale pot fi găsite în secțiunea de descărcări a RetailForce website (Documentația modelului de obiecte.pdf) în directorul versiunii respective.

Obiectul fiscalResponse este returnat sistemului din amonte (casă de marcat, sistem electronic de înregistrare) ca răspuns la o transmitere reușită a documentului (createDocument și storeDocument).

Obiectul fiscalResponse este alcătuit din:

Informații standard – informații independente de țara (fiscală) respectivă (identice pentru fiecare țară)
Informații specifice țării – anumite informații care trebuie tipărite pe o chitanță în țara respectivă sau stocate în jurnal. Aceste informații sunt returnate în matricea „AdditionalFields” a obiectului fiscalResponse.

Obiectul fiscalResponse

Următorul obiect conține date de exemplu.

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

Obiectul fiscalResponse conține următoarele informații.

Informații din coloana „Type”:

M ... obligatoriu / necesar
M* ... obligatoriu / necesar în anumite țări sau în anumite condiții
R ... recomandat
O... opțional

Elemente		Tip	Descriere
fiscalCountry			Indicator pentru țara fiscală respectivă. Enum: [0] = Germania [1] = Austria [2] = Franța [3] = Bulgaria [4] = Danemarca [5] = Suedia [6] = Slovenia [7] = Polonia [8] = Serbia [9] = Italia [10] = Croația [12] = România [15] = Lituania [16] = Ungaria [18] = Spania [99999] = Fără fiscalizare
fiscalisationDocumentNumber			Numărul documentului fiscal (este atribuit de sistemul fiscal respectiv – de exemplu, TSE în Germania). Valoare întreagă Notă: Obsolet, va fi înlocuit de proprietatea de tip string fiscalDocumentNumber în versiunile viitoare.
fiscalDocumentNumber			Numărul documentului fiscal (este atribuit de sistemul fiscal respectiv – de exemplu, TSE în Germania). Detalii privind țara: Germania: proprietatea fiscalDocumentNumber (și valoarea acesteia) din fiscalResponse, după apelarea createDocument , trebuie inclusă în documentul JSON care urmează să fie trimis către storeDocument . Notă: Notă: Introdusă odată cu v.1.7.7. fiscalDocumentNumber este, spre deosebire de fiscalisationDocumentNumber, un element de tip „string”
~~fiscalisationDocumentRevision~~			Numărul de revizie al documentului fiscal. (este atribuit de sistemul fiscal respectiv – TSE în Germania). Atenție: proprietatea „fiscalisationDocumentRevision” a fost eliminată din header-ul obiectului fiscalResponse odată cu release-ul 1.7.7. Proprietatea a fost redenumită „fiscalDocumentRevision” și este returnată acum doar ca parte a câmpurilor AdditionalFields ale obiectului fiscalResponse-Germania !
TaxPositions			Indicarea tuturor pozițiilor Vat din document.
	VatIdentification		ID Indicator al cotei de Vat a elementului Vat. Element
	VatLabel
	VatPercent1		Cota de impozit, exprimată în procente, a acestei poziții Vat. Poziție (în acest caz, poziția Vat 1)
	VatAmount		Suma Vat a poziției Vat
	NetAmount		Suma netă (fără Vat) a poziției Vat.
	GrossAmount		Suma brută (inclusiv Vat) a poziției Vat
fiscalDocumentStartTime			Ora creării documentului fiscal – timbru temporal Unix (este atribuit de sistemul fiscal respectiv – de exemplu, TSE în Germania).
processStartTime			Ora creării primului document din cadrul întregului proces (de exemplu, Germania: ora creării primei comenzi a clientului în legătură cu prezentul document de plată – a se vedea și „caracteristicile gastronomiei”).
ErrorDescription			Descrierea erorii în cazul în care procesul de fiscalizare a eșuat. Câmp gol dacă nu a apărut nicio eroare.
cashRegisterId			Returnează numărul casei de marcat sub care a fost înregistrat/procesat documentul fiscal.
signature			Semnătura documentului, creată de sistemul de fiscalizare respectiv (de exemplu, dispozitivul de creare a semnăturii în AT, TSE în DE...)
UserMessage			Notificare care trebuie afișată utilizatorului sistemului POS. Atenție: în unele țări, un eventual mesaj pentru utilizator trebuie afișat casierului. Recomandăm implementarea acestei proceduri pentru fiecare țară cu regim fiscal.
PrintMessage			Trebuie tipărit pe document (de exemplu, „bon de casă”), altfel există riscul ca implementarea să nu respecte cerințele legale din țara respectivă. A se nota, de asemenea, „PrintMessage”. Atenție: în unele țări, informațiile returnate prin elementul PrintMessage trebuie tipărite pe chitanță. Vă recomandăm să implementați această procedură pentru fiecare țară fiscală.
requestTime			Returnează ora solicitării
requestCompletionTime			Returnează ora la care cererea a fost finalizată de sistemul fiscal
retailForceReceiptId			ID-ul unic la nivel global al documentului, atribuit de RetailForce system. Este returnat numai în fiscalResponse atunci când se apelează PUT /api/v1/transactions/createDocument. Notă: Pentru ca retailForceReceiptId să fie generat, acesta trebuie activat o singură dată pentru clientul respectiv prin apelarea funcției POST /api/v1/management/clients/ {clientId}/GlobalShortId . Mai multe informații pot fi găsite în articolul „ID-ul global al casei de marcat și ID-ul global al documentului”.
AdditionalFields			Informații specifice fiecărei țări
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada fiscalResponseCroația măsuriFiscaleDanemarca răspuns fiscal Franța măsuri_fiscale_Germania măsuri_fiscale_Grecia măsuri_fiscale_Ungaria măsuriFiscaleItalia măsuri_fiscale_Lituania măsuri_fiscale_Polonia măsuri_fiscale_România măsuri_fiscale_Serbia măsuri_fiscale_Slovacia măsuriFiscaleSlovenia măsuri_fiscale_Spania răspuns fiscal Suedia

Acest articol a fost tradus automat.

Obiectul fiscalResponse

Articole conexe