{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Germany ( DE )","description":"Complete documentation for integrating Cheqi's digital receipt platform","keywords":["cheqi","digital receipts","api","sdk","java","javascript"]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"germany--de-","__idx":0},"children":["Germany (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE_KASSENSICHV"]}," to preserve final TSE evidence. The owner device joins the"," ","encrypted merchant payload with server-known party context and generates the"," ","receipt locally. Definitive payment details come from the encrypted payload."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-cheqi","__idx":1},"children":["Before Cheqi"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run the transaction through the merchant's TSE-connected POS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Wait for the TSE operation to complete successfully."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain the transaction times, TSE number, register and security-module"," ","identities, signature evidence, payment split, and DSFinV-K QR payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not mark the receipt final while the TSE operation is pending or failed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"in-the-cheqi-request","__idx":2},"children":["In the Cheqi request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Request location"},"children":["Request location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["External regime"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.regime = DE_KASSENSICHV"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Regime contract version"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.regimeVersion"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TSE system"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.system"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Final status"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.status = FISCALIZED"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TSE transaction number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.transactionId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Register ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.cashRegisterId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Security-module serial"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.fiscalization.fiscalDeviceId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature/verification value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}," and/or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationCode"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Signature counter"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal additional field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE:SIGNATURE_COUNTER"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction start"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionDate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction end"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Root field ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE:TRANSACTION_END"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment split"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Root fields such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE:PAYMENT_AMOUNT:CARD"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DSFinV-K payload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes[]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-payload-fragment","__idx":3},"children":["Example payload fragment"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"transactionDate\": \"2026-07-29T08:14:55Z\",\n  \"barcodes\": [\n    {\n      \"type\": \"QR_CODE\",\n      \"data\": \"exact-dsfinv-k-payload\",\n      \"label\": \"DSFinV-K\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"DE\",\n    \"regime\": \"DE_KASSENSICHV\",\n    \"regimeVersion\": \"2026-07\",\n    \"fiscalization\": {\n      \"system\": \"DE_TSE\",\n      \"status\": \"FISCALIZED\",\n      \"fiscalDocumentNumber\": \"BON-2026-0042\",\n      \"fiscalDeviceId\": \"TSE-SERIAL-001\",\n      \"cashRegisterId\": \"KASSE-01\",\n      \"transactionId\": \"TSE-TX-123\",\n      \"sequenceNumber\": \"42\",\n      \"verificationCode\": \"opaque-tse-verification-value\",\n      \"signature\": \"opaque-tse-signature\",\n      \"signatureAlgorithm\": \"authority-defined\",\n      \"timestamp\": \"2026-07-29T08:15:30Z\",\n      \"additionalFields\": [\n        {\n          \"code\": \"DE:SIGNATURE_COUNTER\",\n          \"value\": \"991\"\n        }\n      ]\n    },\n    \"additionalFields\": [\n      {\n        \"code\": \"DE:TRANSACTION_END\",\n        \"value\": \"2026-07-29T08:15:30Z\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a single card, cash, or bank payment, the merchant's encrypted"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentDetails"]}," and receipt total describe the payment; do not repeat the"," ","amount. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE:PAYMENT_AMOUNT:*"]}," extensions only for a genuine split"," ","payment that the current single-payment structure cannot represent. The device"," ","preserves these values exactly; Cheqi does not operate or emulate a TSE."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":4},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/jurisdictional-data"},"children":["Supplying jurisdiction data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/overview"},"children":["Country support boundary"]}]}]}]},"headings":[{"value":"Germany ( DE )","id":"germany--de-","depth":1},{"value":"Before Cheqi","id":"before-cheqi","depth":2},{"value":"In the Cheqi request","id":"in-the-cheqi-request","depth":2},{"value":"Example payload fragment","id":"example-payload-fragment","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Germany","description":"Create German KassenSichV receipts with TSE evidence","seo":{"title":"Germany ( DE )"}},"lastModified":"2026-09-30T12:24:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/de","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}