fiscalResponseGermany

Une fois qu’un document a été soumis au service de fiscalisation de RetailForce (createDocument et storeDocument), le service renvoie une réponse appelée « fiscalResponse ». Cet objet est décrit de manière générale dans l’article consacré à l’objet fiscalResponse.

Selon le pays de fiscalisation attribué au client concerné (en fonction de la configuration correspondante du client), différentes informations peuvent figurer dans le tableau « AdditionalFields ». Cet article présente les informations renvoyées en réponse dans le cadre de la fiscalisation en Allemagne (conformément au règlement sur la protection des caisses enregistreuses contre la manipulation frauduleuse – KassenSichV).

AdditionalFields dans fiscalResponse pour l’Allemagne

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

Les champs supplémentaires suivants sont utilisés (transmis) dans le cadre de la fiscalisation en Allemagne.

Éléments		Type	Description
AdditionalFields			Informations spécifiques au pays
	QrCodeDataString		Chaîne de données du code QR conforme à l’annexe I du DSFinV-K. Les données du champ « QrCodeDataString » peuvent être converties en code QR (en remplacement des données TSE complètes) et imprimées sur le ticket de caisse. Veuillez également noter : Exigences relatives aux documents en Allemagne
	TransactionStartTime		Heure de début de ce document fiscal (heure de l'appel de la fonction createDocument, exprimée en secondes de temps Unix).
	TransactionEndTime		Heure à laquelle la transaction a été finalisée. Un horodatage / un instant mesuré en secondes depuis l’époque Unix.
	ProcessData		Données de traitement de la transaction signée conformément à l’« arrêté d’application relatif à l’article 146a du Code général des impôts / Anwendungserlass zu §146a AO ». Valeur binaire (chaîne UTF-8 encodée en base64).
	ProcessType		Type de traitement de la transaction signée conformément à l’« Arrêté d’application relatif à l’article 146a du Code général des impôts / Anwendungserlass zu §146a AO ».
	TseSerial		Numéro de série du TSE utilisé
	TseTimeFormat		Format de date et d’heure utilisé par le TSE
	TseHashAlgorithm		Algorithme de hachage utilisé par le TSE
	TsePublicKey		Clé publique du certificat TSE
	TseSignatureCounter		État du compteur de signatures du TSE
	TseCertificate		Certificat TSE
	fiscalDocumentRevision		Numéro de révision du document fiscal. Délivré par l’organisme technique de sécurité certifié (TSE). Informations relatives au pays : Allemagne : la propriété fiscalDocumentRevision (et sa valeur) de la réponse fiscale (fiscalResponse) après l’appel de la méthode createDocument doit être incluse dans le document JSON destiné à être envoyé à la méthode storeDocument . Remarque : à partir de la version 1.7.7, l’ancienne propriété « fiscalisation DocumentRevision » figurant dans l’header de la « fiscalResponse » est remplacée par la propriété « fiscalDocumentRevision » et n’est désormais transmise que dans la section « AdditionalFields » de la « fiscalResponse » pour l’Allemagne.

Cet article a été traduit automatiquement.

FiscalResponseGermany

Articles associés