{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Supplying Jurisdiction Data","description":"Complete documentation for integrating Cheqi's digital receipt platform","keywords":["cheqi","digital receipts","api","sdk","java","javascript"],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"supplying-jurisdiction-data","__idx":0},"children":["Supplying Jurisdiction Data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}," is an optional top-level field of the merchant's plaintext"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload"]},". The SDK encrypts that payload independently for every matched"," ","owner device. Cheqi's backend stores and routes only the encrypted copies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After decryption, the owner device combines the merchant payload with"," ","server-known supplier, customer, payment, and store context and invokes the"," ","Rust receipt engine locally."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-request-fragment","__idx":1},"children":["Example request fragment"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"jurisdictionalData\": {\n    \"countryCode\": \"US\",\n    \"additionalFields\": [\n      {\n        \"code\": \"US:REGION\",\n        \"value\": \"CA\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only add this object when the selected country/regime has information without a"," ","canonical receipt field. Merge it into the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload"]}," that contains"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentNumber"]},", amounts, products, taxes, and other merchant-supplied receipt"," ","content."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Do not duplicate canonical receipt data"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}," only for a value that has no suitable place in the"," ","normal receipt or generation context. Do not repeat document numbers, dates,"," ","party identities, payment means, products, prices, discounts, taxes, totals,"," ","original-document references, or barcodes as country extension fields."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-canonical-fields-first","__idx":2},"children":["Use canonical fields first"]},{"$$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":"Information"},"children":["Information"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Canonical location"},"children":["Canonical location"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receipt/invoice number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["documentNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Issue date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issueDate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transaction/tax-point date"]},{"$$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":["Purchase/delivery date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["purchaseDate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supplier legal identity and registrations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server-known ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier"]}," context"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer legal identity and registrations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server-known ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerParty"]}," context"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Products, quantities, unit prices, and discounts"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products[]"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["discounts[]"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charges[]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tax rate, base, amount, and exemption"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receipt and product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency and totals"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," and receipt total fields"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment method, card, IBAN, merchant ID, or payment terminal ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server-known ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMeans"]}," context from recipient resolution; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentTerminalId"]}," for optional card MID/TID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Original or related document"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identifiers[]"]},"; use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["originatorDocumentReference"]}," for a credit note"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["QR or barcode payload"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Top-level ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes[]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Common fiscal evidence"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Named fields under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only after checking this table should you add a namespaced"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalFields[]"]}," value. For example, Portugal's ATCUD has no generic"," ","receipt field and therefore remains a Portuguese extension."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All example rates, amounts, identifiers, wording, and authority values are"," ","illustrative. They are not defaults and must not replace current values from"," ","your tax, POS, fiscal-device, or authority integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"jurisdictionaldata-fields","__idx":3},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}," fields"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommended"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 3166-1 alpha-2 issuance country. Explicit country wins over supplier-country fallback."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["External fiscal, authority, or regulated-system regime, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE_KASSENSICHV"]},". Do not use it for ordinary document types."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regimeVersion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recommended with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regime"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Version of Cheqi's data contract for the selected regime."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Final evidence returned by a POS, fiscal device, certified system, or authority integration."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalTexts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact jurisdictional wording, with a stable code, optional BCP 47 language tag, and optional semantic ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["displayRole"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalFields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Extensible country-specific values using the codes defined on each country page."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["New integrations should always set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]},". Supplier-country fallback"," ","exists for compatibility. If both are present, the explicit jurisdiction"," ","country takes precedence."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Legacy input names ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profile"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["profileVersion"]}," remain accepted for encrypted"," ","payloads created by older SDKs. New integrations must use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regime"]}," and"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regimeVersion"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fiscalization-fields","__idx":4},"children":["Fiscalization fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use common slots whenever one exists:"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["system"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal regime, device, or provider identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FISCALIZED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_REQUIRED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalDocumentNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number allocated by the fiscal system."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalDeviceId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal device, module, control unit, or certificate identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cashRegisterId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Merchant cash-register identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businessPremiseId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Registered business location or premise."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operatorId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cashier or operator identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fiscal transaction identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sequenceNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Register or document sequence."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorityReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authority submission, response, or registration reference."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["softwareId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certified or registered software identifier."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authority- or device-produced verification value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opaque signature or seal."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signatureAlgorithm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Algorithm label supplied by the producing system."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationUrl"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authority or provider verification URL."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["timestamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 fiscalization timestamp."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalFields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Country-specific fiscal values without a common slot."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not duplicate a common value under a country code. For example, put a"," ","register ID in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization.cashRegisterId"]},", not in a second"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE:REGISTER_ID"]}," field."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Do not create a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization"]}," object merely to say that the selected country"," ","regime is not fiscalized. Omit it when no external fiscal operation occurred."," ","Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_REQUIRED"]}," only when the status itself is meaningful data produced by"," ","the merchant's workflow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"status-and-operation-order","__idx":5},"children":["Status and operation order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a receipt that depends on an external fiscal operation:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the device/provider/authority operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain its final evidence."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FISCALIZED"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Generate the receipt on the owner device."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Final receipt generation rejects ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]},". ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FISCALIZED"]}," requires"," ","at least one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalDocumentNumber"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authorityReference"]},","," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationCode"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signature"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOT_REQUIRED"]}," only when the merchant's own compliance logic has selected a"," ","flow that does not require external fiscalization."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"extension-field-rules","__idx":6},"children":["Extension-field rules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The country pages define the authoritative extension codes. Examples:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"PT:ATCUD\nGR:MYDATA_MARK\nUS:REGION\nCH:VAT_INCLUDED\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Codes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["use uppercase country namespaces;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["may contain ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A-Z"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0-9"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["_"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["-"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["."]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[":"]},";"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["may be at most 64 characters;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["must be unique, case-insensitively, within their array."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unknown future fields remain accepted, but integrations should reuse a"," ","documented code when it already represents the value."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"machine-readable-codes","__idx":7},"children":["Machine-readable codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["QR and barcode payloads are top-level receipt fields:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"barcodes\": [\n    {\n      \"type\": \"QR_CODE\",\n      \"data\": \"exact-payload-produced-by-the-pos-or-authority\",\n      \"label\": \"Fiscal verification\"\n    }\n  ],\n  \"jurisdictionalData\": {\n    \"countryCode\": \"DE\",\n    \"regime\": \"DE_KASSENSICHV\",\n    \"regimeVersion\": \"2026-07\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The engine treats ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," as opaque. It preserves and references the payload but"," ","does not construct, sign, parse, or normalize it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"legal-text","__idx":8},"children":["Legal text"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"legalTexts\": [\n    {\n      \"code\": \"REVERSE_CHARGE_NOTICE\",\n      \"text\": \"Exact wording supplied by the merchant system\",\n      \"languageCode\": \"en-IE\",\n      \"displayRole\": \"NOTICE\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["displayRole"]}," to tell a receiving or rendering application how the exact"," ","text is intended to appear:"]},{"$$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":"Meaning"},"children":["Meaning"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DOCUMENT_HEADING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A regulated document title or heading, for example the Belgian GKS ticket heading"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NOTICE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A required legal or tax notice"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FOOTER"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A required footer line returned by a fiscal system"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The role is semantic: Cheqi preserves it but does not select the text, language,"," ","or position for the merchant. Do not translate or paraphrase required wording"," ","inside Cheqi."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalTexts"]}," is not the merchant's free receipt message. That message is"," ","configured on the company in the Cheqi app and remains available as CHEQI"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["note"]}," and UBL ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cbc:Note"]},". Do not put it in the receipt payload."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"output-mapping","__idx":9},"children":["Output mapping"]},{"$$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":"Input"},"children":["Input"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"CHEQI JSON"},"children":["CHEQI JSON"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"UBL"},"children":["UBL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regime"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["regimeVersion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserved in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JURISDICTION_REGIME"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JURISDICTION_REGIME_VERSION"]}," document references"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legalTexts"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserved exactly, including ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["displayRole"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cheqi jurisdictional-legal-text UBL extension"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["additionalFields"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserved exactly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cac:AdditionalDocumentReference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fiscalization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserved exactly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Namespaced ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cac:AdditionalDocumentReference"]}," entries"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["barcodes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserved exactly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Machine-readable document references"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMeans.merchantId"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentMeans.paymentTerminalId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserved exactly"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Native ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cac:Payment/cbc:MerchantID"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cbc:PaymentTerminalID"]}," in UBL PurchaseReceipt"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The engine writes the legal text to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ext:UBLExtensions"]}," in UBL PurchaseReceipt,"," ","Invoice, and CreditNote:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"xml","header":{"controls":{"copy":{}}},"source":"<ext:UBLExtensions>\n  <ext:UBLExtension>\n    <ext:ExtensionAgencyID>CHEQI</ext:ExtensionAgencyID>\n    <ext:ExtensionVersionID>1</ext:ExtensionVersionID>\n    <ext:ExtensionURI>urn:cheqi:ubl:extension:jurisdictional-legal-text:1</ext:ExtensionURI>\n    <ext:ExtensionContent>\n      <cheqi:JurisdictionalLegalTexts>\n        <cheqi:LegalText\n            code=\"REVERSE_CHARGE_NOTICE\"\n            displayRole=\"NOTICE\"\n            languageCode=\"en-IE\">Exact wording supplied by the merchant system</cheqi:LegalText>\n      </cheqi:JurisdictionalLegalTexts>\n    </ext:ExtensionContent>\n  </ext:UBLExtension>\n</ext:UBLExtensions>\n","lang":"xml"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This deliberately does not use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cbc:Note"]},", so jurisdictional wording cannot"," ","overwrite or become confused with the company-configured receipt message."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cheqi regime identifiers are not written to UBL ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cbc:ProfileID"]},". That element"," ","is reserved for a genuine UBL customization/business-process profile and is"," ","not inferred from country receipt data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every owner device generates and stores its CHEQI document locally. Only the"," ","device holding the downstream distribution lease generates the formats"," ","currently accepted by third parties, encrypts one envelope per recipient, and"," ","submits ciphertext."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Generating a missing UBL document later is a wallet export fallback. It uses"," ","CHEQI JSON stored locally on the device; the backend does not store plaintext"," ","CHEQI JSON."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same jurisdiction structure is available on credit-note payloads."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related","__idx":10},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/profiles"},"children":["Country capabilities and examples"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/overview"},"children":["Country coverage and boundaries"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/creation"},"children":["Receipt creation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/creditnote/credit-notes"},"children":["Credit notes"]}]}]}]},"headings":[{"value":"Supplying Jurisdiction Data","id":"supplying-jurisdiction-data","depth":1},{"value":"Example request fragment","id":"example-request-fragment","depth":2},{"value":"Use canonical fields first","id":"use-canonical-fields-first","depth":2},{"value":"jurisdictionalData fields","id":"jurisdictionaldata-fields","depth":2},{"value":"Fiscalization fields","id":"fiscalization-fields","depth":2},{"value":"Status and operation order","id":"status-and-operation-order","depth":2},{"value":"Extension-field rules","id":"extension-field-rules","depth":2},{"value":"Machine-readable codes","id":"machine-readable-codes","depth":2},{"value":"Legal text","id":"legal-text","depth":2},{"value":"Output mapping","id":"output-mapping","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Supplying Jurisdiction Data","description":"Add external regimes, fiscalization evidence, legal text, and extension fields to an encrypted receipt payload","seo":{"title":"Supplying Jurisdiction Data"}},"lastModified":"2026-08-03T03:31:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/jurisdictional-data","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}