fiscalResponseGermany

After a document has been submitted to the RetailForce Fiscalisation service (createDocument and storeDocument), the service responds with a so-called FiscalResponse. This object is described in general in the article FiscalResponse object.

Depending on which fiscal country is assigned to the respective client (depending on the corresponding configuration of the client), different information can be found in the array "AdditionalFields". This article shows the information that is returned as a response within the framework of fiscalisation in Germany (according to the Cash Register Anti-Tampering Ordinance - KassenSichV).

additionalFields in fiscalResponse for Germany

{
  "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",    /// only for 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
  }
}

The following additional fields are used (transmitted) in the context of fiscalisation in Germany.

Elements		Type	Description
additionalFields			Country-specific information
	QrCodeDataString		QR code data string according to Annex I of the DSFinV-K. Data in the QrCodeDataString field can be converted into a QR code (as an alternative to the complete TSE data) and printed on the receipt. Please also note: Document requirements Germany
	TransactionStartTime		The start time of this fiscal document (time of the call of createDocument, in seconds of Unix time).
	TransactionEndTime		Time at which the transaction was completed. A time stamp / point in time measured in seconds since the Unix epoch.
	ProcessData		Process data of the signed transaction according to "Application Decree on §146a General Tax Code / Anwendungserlass zu §146a AO". Binary value (base64 encoded utf8 string).
	ProcessType		Process type of the signed transaction according to "Application Decree on §146a General Tax Code / Anwendungserlass zu §146a AO".
	TseSerial		Serial number of the TSE used
	TseTimeFormat		Time format used by the TSE
	TseHashAlgorithm		HASH algorithm used by the TSE
	TsePublicKey		Public key of the TSE certificate
	TseSignatureCounter		Status of the TSE signature counter
	TseCertificate		TSE Certificate
	fiscalDocumentRevision		Revision number of the fiscal document. Issued by the certified technical security organisation (TSE). Country details: Germany: the fiscalDocumentRevision property (and its value) of the fiscalResponse after calling createDocument, must be included in the JSON document that is to be sent to storeDocument. Note: With version 1.7.7, the former property "fiscalisationDocumentRevision" in the header of the fiscalResponse is replaced by the property "fiscalDocumentRevision" and is now only transmitted in the "additionalFields" area of the fiscalResponse Germany - Germany.

FiscalResponseGermany

Related articles