Dieser Artikel behandelt das FiskalResponse-Objekt ("positions") innerhalb des Dokumenten-Objekts
(Document object).
Eine vollständige Beschreibung des RetailForce DOM (Document Object Model), sowie eine Beschreibung der einzelnen Elemente, finden sie im Downloads-Bereich der RetailForce Website (Object model documentation.pdf) im jeweilige Versions-Verzeichnis.
Das Objekt fiscalRsponse wird anschließend an eine erfolgreiche Dokumenten-Übermittlung (createDocument und storeDocument) an das Vorsystem (Registrierkasse, elektronisches Aufzeichnungssystem) als Antwort zurückgegeben.
Das FiscalResponse-Objekt besteht aus:
- Standard Informationen - vom jeweiligen (Fiskal-) Land unabhängige Informationen (gleich für jedes Land)
- Landesspezifische Informationen - bestimmte Informationen, welche etwa auf einem Beleg im entsprechenden Land anzudrucken sind oder im Journal gespeichert werden müssen. Diese Informationen werden im Array "AdditionalFields" des fiscalResponse zurückgegeben.
fiscalResponse Objekt
Das nachfolgende Objekt enthält Beispieldaten.
{
"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",
"AdditionalFields": {
"fiscalisationDocumentRevision": 2,
"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="
}
}
Das FiscalResponse-Objekt beinhaltet nachfolgende Angaben.
| Element | Typ | Beschreibung | |
| fiscalCountry |
Indikator für das jeweilige Fiskalland. Enum:
|
||
| fiscalisationDocumentNumber | Fiskal-Dokumentennummer (wird vom jeweiligen Fiskalsystem - z.B. TSE in DE vergeben) | ||
|
Überarbeitungsnummer des Fiskal-Dokuments. (wird vom jeweiligen Fiskalsystem - z.B. TSE in DE vergeben) ACHTUNG: die Eigenschaft "fiscalDocumentRevision" wurde mit Release 1.7.7 aus dem Header des fiscalResponse-Objektes entfernt. Die Eigenschaft wird nun als Teil der additionalFields der fiscalRespones-Germany zurückgegeben!
|
|||
| taxPositions | Angabe aller MwSt. Positionen des Dokuments. | ||
| vatIdentification | ID Kennzeichen des MwSt.-Satzes der MwSt. Position | ||
| vatLabel | |||
| vatPercent1 | Steuersatz in Prozent dieser MwSt. Position (in diesem Fall MwSt. Position 1) | ||
| vatAmount | MwSt.-Betrag der MwSt. Position | ||
| netAmount | Nettobetrag (exkl. MwSt.) der MwSt. Position | ||
| grossAmount | Bruttobetrag (inkl. MwSt.) der MwSt. Position | ||
| fiscalDocumentStartTime | Zeitpunkt der Erstellung des Fiskal-Dokumentes (wird vom jeweiligen Fiskalsystem - z.B. TSE in DE vergeben) | ||
| processStartTime | Erstellungszeitpunkt des ersten Beleges innerhalb des gesamten Prozesses (z.B. Deutschland: Erstellungszeitpunkt der ersten Kundenbestellung im Zusammenhang mit dem vorliegenden Zahlungsbeleg - siehe auch "Besonderheiten Gastronomie") | ||
| errorDescription | Fehlerbeschreibung, wenn der Fiskalisierungsprozess fehlgeschlagen ist. Leer, wenn kein Fehler aufgetreten ist. | ||
| cashRegisterId | Gibt die Registrierkassennummer zurück unter welcher das Fiskaldokument registriert / verarbeitet wurde | ||
| signature | Belegsignatur, erstellt vom jeweiligen Fiskalisierungssystem (z.B. Signaturerstellungseinheit in AT, TSE in DE...) | ||
| userMessage | Benachrichtigung, welche dem Benutzer des Kassensystems angezeigt werden muss. | ||
| printMessage |
Muss am Dokument (z.B. "Kassenbeleg") angedruckt werden, andernfalls besteht Gefahr, dass die Implementierung nicht den gesetzlichen Anforderungen im jeweiligen Land entspricht. Beachten Sie auch "printMessage". |
||
| requestTime | gibt den Anfragezeitpunkt zurück | ||
| requestCompletionTime | gibt den Zeitpunkt zurück, an dem die Anfrage vom Fiskalsystem fertiggestellt wurde | ||
| additionalFields | Landesspezifische Informationen | ||
| {...} |
fiscalResponseAustria - Österreich fiscalResponseBulgaria - Bulgarien fiscalResponseCroatia - Kroatien fiscalResponseDenmark - Dänemark fiscalResponseFrance - Frankreich fiscalResponseGermany - Deutschland fiscalResponseLithuania - Litauen fiscalResponseRomania - Rumänien fiscalResponseSerbia - Serbien fiscalResponseSlovenia - Slowenien |
||
Kommentare
0 Kommentare
Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.