fiscalResponseGermany

Dopo che un documento è stato inviato al servizio di fiscalizzazione di RetailForce (createDocument e storeDocument), il servizio risponde con una cosiddetta fiscalResponse. Questo oggetto è descritto in generale nell’articolo «Oggetto fiscalResponse».

A seconda del paese di fiscalizzazione assegnato al rispettivo client (in base alla configurazione corrispondente del client), nell’array «AdditionalFields» possono essere presenti informazioni diverse. Il presente articolo illustra le informazioni restituite come risposta nell’ambito della fiscalizzazione in Germania (ai sensi del Regolamento sulla sicurezza dei registratori di cassa – KassenSichV).

AdditionalFields in fiscalResponse per la Germania

{
  "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
  }
}

Nel contesto della fiscalizzazione in Germania vengono utilizzati (trasmessi) i seguenti campi aggiuntivi.

Elementi		Tipo	Descrizione
AdditionalFields			Informazioni specifiche per paese
	QrCodeDataString		Stringa di dati del codice QR conforme all’Allegato I del DSFinV-K. I dati contenuti nel campo QrCodeDataString possono essere convertiti in un codice QR (in alternativa ai dati TSE completi) e stampati sulla ricevuta. Si prega inoltre di tenere presente: Requisiti documentali in Germania
	TransactionStartTime		L’ora di inizio del presente documento fiscale (ora della chiamata alla funzione createDocument, espressa in secondi di tempo Unix).
	TransactionEndTime		Ora in cui la transazione è stata completata. Un timestamp/punto temporale misurato in secondi a partire dall’epoca Unix.
	ProcessData		Dati di elaborazione della transazione firmata ai sensi del «Decreto applicativo relativo al §146a del Codice fiscale generale / Anwendungserlass zu §146a AO». Valore binario (stringa UTF-8 codificata in base64).
	ProcessType		Tipo di processo della transazione firmata ai sensi del «Decreto applicativo relativo al §146a del Codice fiscale generale / Anwendungserlass zu §146a AO».
	TseSerial		Numero di serie del TSE utilizzato
	TseTimeFormat		Formato data e ora utilizzato dal TSE
	TseHashAlgorithm		Algoritmo di hash utilizzato dal TSE
	TsePublicKey		Chiave pubblica del certificato TSE
	TseSignatureCounter		Stato del contatore delle firme del TSE
	TseCertificate		Certificato TSE
	fiscalDocumentRevision		Numero di revisione del documento fiscale. Rilasciato dall’organizzazione tecnica di sicurezza certificata (TSE). Dettagli relativi al Paese: Germania: la proprietà fiscalDocumentRevision (e il relativo valore) della fiscalResponse, dopo aver richiamato createDocument , deve essere inclusa nel documento JSON da inviare a storeDocument . Nota: a partire dalla versione 1.7.7, la precedente proprietà «fiscalisation DocumentRevision» nell’header della fiscalResponse è stata sostituita dalla proprietà «fiscalDocumentRevision» e ora viene trasmessa esclusivamente nell’area «AdditionalFields» della fiscalResponse Germania - Germania.

Questo articolo è stato tradotto automaticamente.

FiscalResponseGermany

Articoli correlati