Cette fonction de l’interface de conformité TVA de RetailForce permet de générer des données DSFinV-K à partir de données brutes ayant déjà fait l’objet d’une fiscalisation.
Contrairement à la mise en œuvre de la fiscalisation RetailForce pour l’Allemagne, dans ce cas précis, le système de caisse en amont transfère des données déjà sécurisées par un TSE (dispositif de sécurité technique certifié / système de sécurité technique). Cette fonction n’effectue aucun traitement supplémentaire des données (signature) via un TSE, mais se contente de convertir les données fournies au format officiel DSFinV-K / Taxonomie.
Fourniture des données
Les données sont fournies par le système en amont au format JSON, dans le modèle de document étendu RetailForce (DOM – Document Object Model). Vous trouverez une description générale de ce modèle dans l’article référencé.
Les données sont transmises au point de terminaison POST /v1.0/documents de l’API de conformité à la TVA, accessible via l’URL https://retailforcevatcomplianceprod.azurewebsites.net/api/swagger/ui
Extension de données TSE
Pour que le RetailForce system puisse convertir les données au format DSFinV-K, la requête JSON provenant du système en amont doit contenir les données TSE. Si la mise en œuvre de la fiscalisation est utilisée, ces données seraient renvoyées par le RetailForce system au système en amont dans ce que l’on appelle la « fiscalResponse ».
Outre les informations habituelles relatives au document, le payload destiné à la génération du format DSFinV-K doit inclure les propriétés suivantes.
Exemple :
"FiscalResponse": {
"FiscalCountry": "[0] = Germany",
"FiscalDocumentNumber": "456",
"FiscalDocumentStartTime": 1795079983,
"Signature": ""ZZxwQhSr73fn2m+XzGKavYaMbT3+IZ0JT5QK2JgYY/CV5ZTo4RL9hfJAJ4NF02PvkDQkY9e+USUH39UuqOhEHw==",
"CashRegisterId": "003-009",
"QrCode": "V0;00345-00340;Kassenbeleg-V1;Beleg^899.90_0.00_0.00_0.00_0.00^899.90:Bar;1;9;2026-11-13T06:52:41.000Z;2026-11-13T06:53:20.000Z;ecdsa-plain-SHA256;unixTime;ZZxwQhSr73fn2m+XzGKavYaMbT3+IZ0JT5QK2JgYY/CV5ZTo4RL9hfJAJ4NF02PvkDQkY9e+USUH39UuqOhEHw==;BE46T7QBOkFER5Mm3Q/YqRtCDI+dS5FJh8LrQ38MpSNTdwmP/N3ZHtKMQqvNCEoQOSjcnNVwXu+m8HyY0SdD8e0=",
"AdditionalFields": {
"QrCodeDataString": "V0;00345-00340;Kassenbeleg-V1;Beleg^899.90_0.00_0.00_0.00_0.00^899.90:Bar;1;9;2026-11-13T06:52:41.000Z;2026-11-13T06:53:20.000Z;ecdsa-plain-SHA256;unixTime;ZZxwQhSr73fn2m+XzGKavYaMbT3+IZ0JT5QK2JgYY/CV5ZTo4RL9hfJAJ4NF02PvkDQkY9e+USUH39UuqOhEHw==;BE46T7QBOkFER5Mm3Q/YqRtCDI+dS5FJh8LrQ38MpSNTdwmP/N3ZHtKMQqvNCEoQOSjcnNVwXu+m8HyY0SdD8e0=",
"TransactionStartTime": 1795079983,
"TransactionEndTime": 1795079983,
"ProcessData": "Beleg^899.90_0.00_0.00_0.00_0.00^899.90:Bar",
"ProcessType": "Kassenbeleg-V1",
"TseSerial": "941a7ca5395caba8c5672e8f9910d1c5620b51aa9ac2c16063e0b0560ff5ea3d",
"TseTimeFormat": "unixTime",
"TseHashAlgorithm": "ecdsa-plain-SHA256",
"TsePublicKey": "BE46T7QBOkFER5Mm3Q/YqRtCDI+dS5FJh8LrQ38MpSNTdwmP/N3ZHtKMQqvNCEoQOSjcnNVwXu+m8HyY0SdD8e0=",
"TseSignatureCounter": 578,
"TseCertificate": "-----BEGIN CERTIFICATE----- \nMIIBszCCAVmgAwIBAgIUJ8x7k9L2mN4pQ6rS8tU0vW2xY4zA6bC8dE0fG2hI4jKw \nCgYIKoZIzj0EAwIwEDEOMAwGA1UEAwwFdGVzdDAeFw0yNjAxMDEwMDAwMDBaFw0y \nNzAxMDEwMDAwMDBaMBAxDjAMBgNVBAMMBXRlc3QwWTATBgcqhkjOPQIBBggqhkjO \nPQMBBwNCAAQu/XH7f/zEnaT0viY3mlDqtLt1T7Vb3FjTMjFtIbd4T94QjlmUpLU3 \nO7tc/t/8xJ2k9L4mN5pQ6rS7tU8vW9xY0zA1bC2dE3fG4hI5jK6lM7nO8pQ9rS0t \nU1vW2xY3zA4bC5dE6fG7hKNCMEAwHQYDVR0OBBYEFJ8x7k9L2mN4pQ6rS8tU0vW2 \nxY4zMB8GA1UdIwQYMBaAFJ8x7k9L2mN4pQ6rS8tU0vW2xY4zMA8GA1UdEwEB/wQF \nMAMBAf8wCgYIKoZIzj0EAwIDSAAwRQIhAJ8x7k9L2mN4pQ6rS8tU0vW2xY4zA6bC \n8dE0fG2hI4jKAiEA7v1x+3/8xJ2k9L4mN5pQ6rS7tU8vW9xY0zA1bC2dE3fG4hI= \n-----END CERTIFICATE-----",
"FiscalDocumentRevision": 1
}Certaines des données requises doivent être extraites du TSE utilisé pour signer la transaction.
Informations figurant dans la colonne « Type » :
- M … obligatoire (« mandatory »)
- M* … obligatoire dans certains pays ou sous certaines conditions
- R … recommandé (« recommandé »)
- O … facultatif
| Élément | Type |
Description | ||
| fiscalResponse | M |
Objet contenant des informations TSE | ||
| fiscalCountry | M |
Pour la génération du DSFinV-K, il faut indiquer « [0] = Allemagne » | ||
| fiscalDocumentNumber | M |
Numéro attribué par la TSE au document concerné | ||
| fiscalDocumentStartTime | M |
Heure de début du processus générée par le TSE au format de temps UNIX | ||
| Signature | M |
Signature fournie par le TSE pour la transaction concernée | ||
| cashRegisterId | M |
ID unique du système de caisse | ||
| QrCode | M |
Chaîne de caractères du code QR de la transaction | ||
| AdditionalFields | M |
|||
| Chaîne de données du code QR | M |
Chaîne de données du code QR de la transaction | ||
| Heure de début de la transaction | M |
Heure de début de la transaction | ||
| TransactionEndTime | M |
Heure de fin de la transaction | ||
| ProcessData | M |
Données de traitement de la transaction (<type>^<valeurs>^<paiement>)</paiement></valeurs></type> | ||
| ProcessType | M |
Type de traitement de la transaction (par ex. Kassenbeleg-V1) | ||
| TseSerial | M |
Numéro de série du TSE utilisé pour signer la transaction (TSE_SERIAL) | ||
| TseTimeFormat | M |
Format d'heure du TSE (TSE_ZEITFORMAT) | ||
| TseHashAlgorithm | M |
Algorithme de signature utilisé par le TSE (TSE_SIG_ALGO) | ||
| TsePublicKey | M |
Clé publique du certificat du TSE (TSE_PUBLIC_KEY) | ||
| TseSignatureCounter | M |
Compteur de signatures (nombre total de signatures) du TSE utilisé pour signer la transaction | ||
| TseCertificate | M |
Certificat du TSE | ||
| FiscalDocumentRevision | M |
Compteur de signatures de la transaction lors de l’opération FinishTransaction | ||
Cet article a été traduit automatiquement.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.