FiscalResponse-objekt ”fiscalResponse” – RetailForce

Denna artikel beskriver fiscalResponse-objektet (”positioner”) inom Document-objektet (
Document-objektet).

En fullständig beskrivning av RetailForce DOM (Document Object Model), samt en beskrivning av de enskilda elementen, finns i nedladdningsområdet på RetailForce website (Object model documentation.pdf) i respektive versionskatalog.

FiscalResponse-objektet returneras till det uppströms liggande systemet (kassaapparat, elektroniskt registreringssystem) som svar på en lyckad dokumentöverföring (createDocument och storeDocument).

FiscalResponse-objektet består av:

Standardinformation – information som är oberoende av det aktuella (skattemässiga) landet (samma för varje land)
Landspecifik information – viss information som måste skrivas ut på ett kvitto i det aktuella landet eller lagras i journalen. Denna information returneras i arrayen ”AdditionalFields” i fiscalResponse.

fiscalResponse-objekt

Följande objekt innehåller exempeldata.

{
   "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-objektet innehåller följande information.

Information i kolumnen ”Type”:

M … obligatoriskt / krävs
M* ... obligatoriskt/krävs i vissa länder eller under vissa förutsättningar
R ... rekommenderat
O... valfritt

Element		Typ	Beskrivning
fiscalCountry			Indikator för respektive skatteland. Enum: [0] = Tyskland [1] = Österrike [2] = Frankrike [3] = Bulgarien [4] = Danmark [5] = Sverige [6] = Slovenien [7] = Polen [8] = Serbien [9] = Italien [10] = Kroatien [12] = Rumänien [15] = Litauen [16] = Ungern [18] = Spanien [99999] = Ingen skatteförrättning
fiscalisationDocumentNumber			Skattedokumentnummer (tilldelas av respektive skattesystem – t.ex. TSE i DE). Heltalsvärde Obs: Föråldrat, kommer att ersättas av stringegenskapen fiscalDocumentNumber i framtida versioner.
fiscalDocumentNumber			Skattedokumentnummer (tilldelas av respektive skattesystem – t.ex. TSE i Tyskland). Landsspecifikationer: Tyskland: egenskapen fiscalDocumentNumber (och dess värde) i fiscalResponse efter anropet till createDocument måste inkluderas i det JSON-dokument som ska skickas till storeDocument . Obs: Introducerades i v.1.7.7. fiscalDocumentNumber är, till skillnad från fiscalisationDocumentNumber, ett ”string”-element
~~fiscalisationDocumentRevision~~			Revisionsnummer för skattedokumentet. (tilldelas av respektive skattesystem – TSE i Tyskland). Observera: Egenskapen ”fiscalisationDocumentRevision” togs bort från headern på objektet fiscalResponse i release 1.7.7. Egenskapen har bytt namn till ”fiscalDocumentRevision” och returneras nu endast som en del av AdditionalFields i fiscalResponse-Tyskland !
TaxPositions			Angivelse av alle Vat-positioner i dokumentet.
	VatIdentification		ID-indikator för momsbeloppets momssats. Post
	VatLabel
	VatPercent1		Skattesats i procent för denna Vat-position. Position (i detta fall Vat-position 1)
	VatAmount		Momsbelopp för momspositionen
	NetAmount		Nettobelopp (exkl. Vat) för momspositionen
	GrossAmount		Bruttobelopp (inkl. Vat) för momspositionen
fiscalDocumentStartTime			Tidpunkt för skattedokumentets skapande – Unix-tidsstämpel (tilldelas av respektive skattesystem – t.ex. TSE i Tyskland).
processStartTime			Skapandetid för det första dokumentet inom hela processen (t.ex. Tyskland: Skapandetid för den första kundordern i samband med det aktuella betalningsdokumentet – se även ”egenskaper för gastronomi”).
ErrorDescription			Felbeskrivning om skattehanteringsprocessen misslyckades. Tomt om inget fel har inträffat.
cashRegisterId			Returnerar det kassaregisternummer under vilket det skattepliktiga dokumentet registrerades/behandlades.
signature			Dokumentets signatur, skapad av respektive skatteregistreringssystem (t.ex. signaturgenerator i Österrike, TSE i Tyskland...)
UserMessage			Meddelande som måste visas för användaren av kassasystemet. Observera: I vissa länder måste ett eventuellt användarmeddelande visas för kassapersonalen. Vi rekommenderar att denna procedur implementeras för varje land där skatteplikt gäller.
PrintMessage			Måste skrivas ut på dokumentet (t.ex. ”kassakvitto”), annars finns det en risk att implementeringen inte uppfyller de lagstadgade kraven i respektive land. Se även ”PrintMessage”. Observera: I vissa länder måste information som returneras via PrintMessage-elementet skrivas ut på kvittot. Vi rekommenderar att denna procedur implementeras för varje skattejuridiskt land.
requestTime			Returnerar tidpunkten för begäran
requestCompletionTime			Returnerar den tidpunkt då begäran slutfördes av det skattemässiga systemet
retailForceReceiptId			Globalt unikt dokument-ID tilldelat av RetailForce systemet. Returneras endast i fiscalResponse vid anrop av PUT /api/v1/transactions/createDocument. Obs! För att retailForceReceiptId ska kunna genereras måste detta aktiveras en gång för respektive klient genom att anropa funktionen POST /api/v1/management/clients/{clientId}/GlobalShortId . Mer information finns i artikeln ”Globalt kassaregister-ID och globalt dokument-ID”.
AdditionalFields			Landsspecifik information
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada fiscalResponseKroatien fiscalResponseDanmark finanspolitiska åtgärder Frankrike fiskalåtgärderTyskland fiscalResponseGreece finanspolitiska åtgärder Ungern finanspolitiska åtgärder Italien finanspolitiska åtgärder Litauen finanspolitiska åtgärder Polen finanspolitiska åtgärder Rumänien finanspolitiska åtgärder i Serbien finanspolitiska åtgärder i Slovakien finanspolitiska åtgärder i Slovenien finanspolitiska åtgärder Spanien fiscalResponseSverige

Den här artikeln har översatts automatiskt.

fiscalResponse-objekt

Relaterade artiklar