FiscalResponse-objektet "fiscalResponse" – RetailForce

Denne artikel beskriver fiscalResponse-objektet ("positioner") inden for Document-objektet
(Document-objektet).

En fuldstændig beskrivelse af RetailForce DOM (Document Object Model) samt en beskrivelse af de enkelte elementer findes i downloadområdet på RetailForce website (Object model documentation.pdf) i det respektive versionsbibliotek.

FiscalResponse-objektet returneres til det opstrøms system (kasseapparat, elektronisk registreringssystem) som svar på en vellykket dokumentoverførsel (createDocument og storeDocument).

FiscalResponse-objektet består af:

Standardoplysninger – oplysninger, der er uafhængige af det pågældende (skattemæssige) land (de samme for hvert land)
Landespecifikke oplysninger – visse oplysninger, der skal udskrives på en kvittering i det pågældende land eller gemmes i journalen. Disse oplysninger returneres i arrayet "AdditionalFields" i fiscalResponse.

fiscalResponse-objekt

Følgende objekt indeholder eksempeldata.

{
   "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 indeholder følgende oplysninger.

Oplysninger i kolonnen "Type":

M ... obligatorisk / påkrævet
M* ... obligatorisk / påkrævet i visse lande eller under visse betingelser
R ... anbefalet
O... valgfrit

Elementer		Type	Beskrivelse
fiscalCountry			Indikator for det pågældende skatteland. Enum: [0] = Tyskland [1] = Østrig [2] = Frankrig [3] = Bulgarien [4] = Danmark [5] = Sverige [6] = Slovenien [7] = Polen [8] = Serbien [9] = Italien [10] = Kroatien [12] = Rumænien [15] = Litauen [16] = Ungarn [18] = Spanien [99999] = Ingen beskatning
fiscalisationDocumentNumber			Skattedokumentnummer (tildeles af det respektive skattesystem – f.eks. TSE i DE). Heltalsværdi Bemærk: Forældet, vil i fremtidige versioner blive erstattet af strengegenskaben fiscalDocumentNumber.
fiscalDocumentNumber			Fiskalt dokumentnummer (tildeles af det respektive skattesystem – f.eks. TSE i Tyskland). Landespecifikke oplysninger: Tyskland: Egenskaben fiscalDocumentNumber (og dens værdi) i fiscalResponse efter kald af createDocument skal medtages i det JSON-dokument, der skal sendes til storeDocument . Bemærk : Indført med v.1.7.7. fiscalDocumentNumber er, i modsætning til fiscalisationDocumentNumber, et "string"-element
~~fiscalisationDocumentRevision~~			Revisionsnummer for det skattemæssige dokument. (tildeles af det pågældende skattesystem – TSE i Tyskland). OBS: Egenskaben »fiscalisationDocumentRevision« blev fjernet fra headeren på »fiscalResponse«-objektet med release 1.7.7. Egenskaben er blevet omdøbt til »fiscalDocumentRevision« og returneres nu kun som en del af »AdditionalFields« i »fiscalResponse-Germany« !
TaxPositions			Angivelse af alle Vat-positioner i dokumentet.
	VatIdentification		ID-indikator for Vat-satsen for Vat-posten. Post
	VatLabel
	VatPercent1		Momsats i procent for denne Vat-position. Position (i dette tilfælde Vat-position 1)
	VatAmount		Momsbeløb for Vat-positionen
	NetAmount		Nettobeløb (ekskl. Vat) for Vat-positionen
	GrossAmount		Bruttobeløb (inkl. Vat) for Vat-positionen
fiscalDocumentStartTime			Tidspunkt for oprettelse af det skattemæssige dokument – Unix-tidsstempel (tildeles af det respektive skattesystem – f.eks. TSE i Tyskland).
processStartTime			Oprettelsestidspunkt for det første dokument i hele processen (f.eks. Tyskland: Oprettelsestidspunkt for den første kundeordre i forbindelse med det aktuelle betalingsdokument – se også "karakteristika for gastronomi").
ErrorDescription			Fejlbeskrivelse, hvis registreringsprocessen mislykkedes. Tom, hvis der ikke er opstået nogen fejl.
cashRegisterId			Returnerer kasseapparatets nummer, under hvilket det skattepligtige dokument blev registreret/behandlet.
signature			Dokumentunderskrift, oprettet af det respektive fiskaliseringssystem (f.eks. underskriftsgenerator i AT, TSE i DE...)
UserMessage			Meddelelse, der skal vises til brugeren af POS-systemet. Bemærk: I nogle lande skal en eventuel brugermeddelelse vises til kasseassistenten. Vi anbefaler, at denne procedure implementeres for hvert skattepligtigt land.
PrintMessage			Skal udskrives på dokumentet (f.eks. »kassebon«), ellers er der risiko for, at implementeringen ikke overholder de lovmæssige krav i det pågældende land. Se også "PrintMessage". Bemærk: I nogle lande skal oplysninger, der returneres via PrintMessage-elementet, udskrives på kvitteringen. Vi anbefaler, at denne procedure implementeres for hvert skatte- og afgiftsland.
requestTime			Returnerer anmodningstidspunktet
requestCompletionTime			Returnerer det tidspunkt, hvor anmodningen blev afsluttet af det skattemæssige system
retailForceReceiptId			Globalt unikt dokument-ID tildelt af RetailForce systemet. Returneres kun i fiscalResponse, når der kaldes PUT /api/v1/transactions/createDocument. Bemærk: For at retailForceReceiptId kan genereres, skal dette aktiveres én gang for den pågældende klient ved at kalde funktionen POST /api/v1/management/clients/{clientId}/GlobalShortId . Yderligere oplysninger findes i artiklen "Globalt kasseapparat-ID og globalt dokument-ID".
AdditionalFields			Landespecifikke oplysninger
	{...}		fiscalResponseAustria fiscalResponseBulgaria fiscalResponseCanada fiskalReaktionKroatien fiskalReaktionDanmark finanspolitisk reaktion Frankrig finanspolitisk reaktion Tyskland fiskalReaktionGrækenland finanspolitisk reaktion Ungarn finanspolitisk reaktion i Italien finanspolitisk reaktion Litauen finanspolitisk reaktion Polen finanspolitisk reaktion i Portugal finanspolitisk reaktion Rumænien finanspolitisk reaktion i Serbien finanspolitisk reaktion i Slovakiet finanspolitisk reaktion i Slovenien finanspolitisk reaktion Spanien fiskalReaktionSverige

Denne artikel er oversat automatisk.

fiscalResponse-objekt

Relaterede artikler