fiscalResponseGermany

Nachdem ein Dokument an das RetailForce Fiskalisierungs-Service übermittelt wurde (createDocument und storeDocument), antwortet das Service mit einer s.g. FiscalResponse. Dieses Objekt wird allgemein im Artikel FiscalResponse-Objekt beschrieben.

Je nachdem, welches Fiskalland dem jeweiligen Client zugeordnet ist (abhängig von der entsprechenden Konfiguration des Clients), finden sich im Array "AdditionalFields" unterschiedliche Informationen. Dieser Artikel zeigt die Informationen, welche im Rahmen der Fiskalisierung in Deutschland (entsprechen der Kassensicherungsverordnung - KassenSichV) als Antwort (response) zurückgegeben werden.

additionalFields in fiscalResponse für Deutschland

{
  "fiscalCountry": "[0] = Germany",
  "fiscalisationDocumentNumber": 561,
  "fiscalDocumentNumber": "561",
  "fiscalDocumentStartTime": 1683289833,
  "processStartTime": 0,
  "errorDescription": null,
  "cashRegisterId": "00345-00345",
  "signature": "WlVgLXiFXDzDID2BnqN3eZyiEPNAtu00iJOvHQA61FJMvO0G1jNWaXLFs8UFuYxo1IiVD50sR/DYQkAKvqQjEw==",
  "userMessage": null,
  "printMessage": "***Test***",
  "requestTime": "2023-05-05T14:32:03.9697128+02:00",
  "requestCompletionTime": "2023-05-05T14:32:04.4637647+02:00",
  "retailForceReceiptId": "0p4j0001",    /// nur bei createDocument
  "AdditionalFields": {
    "QrCodeDataString": "V0;00345-00345;Kassenbeleg-V1;Beleg^0.00_0.00_0.00_0.00_0.00^0.00:Bar;61;178;2023-05-05T12:30:33.000Z;2023-05-05T12:32:03.000Z;ecdsa-plain-SHA256;unixTime;WlVgLXiFXDzDID2BnqN3eZyiEPNAtu00iJOvHQA61FJMvO0G1jNWaXLFs8UFuYxo1IiVD50sR/DYQkAKvqQjEw==;BIKU1KFtZqOqfo5Uzrxqkm50mDeHu6e2besCl4WtFz7cXIjB25/LhynCuWQTlVUoSoWzx2gn8chos3/X1EOq8b0=",
    "TransactionStartTime": 1683289833,
    "TransactionEndTime": 1683289923,
    "ProcessData": "Beleg^0.00_0.00_0.00_0.00_0.00^0.00:Bar",
    "ProcessType": "Kassenbeleg-V1",
    "TseSerial": "7f18ca57319a2dfdad246da26ba0133a64304f56fe0573bb5fc90c0ff4c99c61",
    "TseTimeFormat": "unixTime",
    "TseHashAlgorithm": "ecdsa-plain-SHA256",
    "TsePublicKey": "BIKU1KFtZqOqfo5Uzrxqkm50mDeHu6e2besCl4WtFz7cXIjB25/LhynCuWQTlVUoSoWzx2gn8chos3/X1EOq8b0=",
    "TseSignatureCounter": 878,
    "TseCertificate": "MIIB0zCCAVigAwIBAgIgfxjKVzGaLf2tJG2ia6ATOmQwT1b+BXO7X8kMD/TJnGEwCgYIKoZIzj0EAwMwMTEVMBMGA1UEChMMZmlza2FseSBHbWJIMRgwFgYDVQQDEw9maXNrYWx5IFRlc3QgQ0EwHhcNMjMwMjIwMDgzMTMyWhcNMjQwMjIwMDgzMTMyWjAyMRUwEwYDVQQKEwxmaXNrYWx5IEdtYkgxGTAXBgNVBAMTEGZpc2thbHkgVGVzdCBUU0UwWTATBgcqhkjOPQIBBggqhkjOPQMBBwNCAASClNShbWajqn6OVM68apJudJg3h7untm3rApeFrRc+3FyIwdufy4cpwrlkE5VVKEqFs8doJ/HIaLN/19RDqvG9o0EwPzAOBgNVHQ8BAf8EBAMCB4AwDAYDVR0TAQH/BAIwADAfBgNVHSMEGDAWgBSWWUHKZAG6nqV0oaiNlWlm1Ybm1DAKBggqhkjOPQQDAwNpADBmAjEAlA2kITrQZzBca/Jn6oTJG1UJfwbuG7XKuokxWrUN2sZLJqKhkddS3l+bb2bkSADDAjEA4jngqpenY4bFKnGA55iFOTMD7klUoVXLmfmxHcTHaF95BbIGoCrpR/sT69qgEP1P",
    "fiscalDocumentRevision": 2
  }
}

Folgende zusätzliche Felder werden im Rahmen der Fiskalisierung in Deutschland verwendet (übermittelt).

Element		Typ	Beschreibung
additionalFields			Landesspezifische Informationen
	QrCodeDataString		QR-Code-Datenstring gemäß Anhang I der DSFinV-K. Daten im Feld QrCodeDataString können (alternativ zu den vollständigen TSE-Daten) in einen QR-Code konvertiert und am Beleg angedruckt werden. Beachten Sie auch: Beleganforderungen Deutschland
	TransactionStartTime		Die Startzeit dieses Fiskaldokuments (Zeitpunkt des Aufrufs von createDocument, in Sekunden der Unix-Zeit)
	TransactionEndTime		Zeitpunkt der Fertigstellung der Transaktion. Ein Zeit-Stempel / Zeitpunkt, gemessen in Sekunden seit der Unix-Epoche
	ProcessData		Prozessdaten der signierten Transaktion gemäß "Anwendungserlass zu §146a AO". Binärwert (base64 kodierter utf8-String).
	ProcessType		Prozesstyp der signierten Transaktion gemäß "Anwendungserlass zu §146a AO".
	TseSerial		Seriennummer der verwendeten TSE
	TseTimeFormat		Durch die TSE verwendetes Zeit Format
	TseHashAlgorithm		HASH-Algorithmus, welchen die TSE verwendet
	TsePublicKey		Öffentlicher Schlüssel des TSE Zertifikates
	TseSignatureCounter		Stand des Signaturzählers der TSE
	TseCertificate		TSE-Zertifikat
	fiscalDocumentRevision		Überarbeitungsnummer des Fiskal-Dokuments. Wird von der zertifizierten technischen Sicherheitseinrichtung (TSE) vergeben. Länderinformation: Deutschland: die Eigenschaft fiscalDocumentRevision (sowie deren Wert) aus der fiscalResponse nach Aufruf von createDocument, muss in das JSON-Dokument, welches an storeDocument geschickt werden soll, mit aufgenommen werden. Hinweis: mit Version 1.7.7 wird die frühere Eigenschaft "fiscalisationDocumentRevision" im Header der fiscalResponse durch die Eigenschaft "fiscalDocumentRevision" ersetzt und nur mehr im Bereich "additionalFields" der fiscalResponse Germany - Deutschland übermittelt.

FiscalResponseGermany

Verwandte Beiträge