{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Country Support","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":"country-support","__idx":0},"children":["Country Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cheqi can preserve and render country-specific receipt information supplied by"," ","your POS, fiscal device, or invoicing system. The current receipt engine accepts"," ","these canonical issuance countries:"]},{"$$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":"Region"},"children":["Region"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Countries"},"children":["Countries"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["European Union"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Austria (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AT"]},"), Belgium (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BE"]},"), Germany (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE"]},"), Denmark (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DK"]},"), Estonia (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EE"]},"), Spain (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ES"]},"), Finland (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FI"]},"), France (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FR"]},"), Greece (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GR"]},"), Ireland (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IE"]},"), Italy (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT"]},"), Netherlands (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NL"]},"), Poland (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PL"]},"), Portugal (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PT"]},"), Sweden (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Other Europe"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Switzerland (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CH"]},"), United Kingdom (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GB"]},"), Iceland (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IS"]},"), Norway (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["North America"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Canada (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]},"), United States (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GB"]}," is the canonical United Kingdom country code. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UK"]}," is accepted as an input"," ","alias and is normalized to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GB"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Capability is not legal certification"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Country support means the engine can create a receipt containing the supplied"," ","local fields. It does not mean Cheqi decides which rules apply, certifies the"," ","receipt as legally sufficient, or replaces a fiscal device, certified cash"," ","register, tax authority, Peppol validator, or local professional review."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-country-data-flows","__idx":1},"children":["How country data flows"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Country-specific data is part of the merchant's plaintext"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload.jurisdictionalData"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your POS determines whether the receipt needs country data that has no"," ","canonical field. If it does, select the applicable external regime and"," ","complete any required authority, fiscal-device, or certified-software"," ","operation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your integration adds the returned identifiers, signatures, URLs, legal"," ","text, and top-level barcode payloads to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ReceiptPayload"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The merchant SDK encrypts that payload independently for every matched owner"," ","device."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each owner device decrypts its copy and runs the shared Rust engine locally"," ","to generate and store its CHEQI receipt."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Exactly one leased owner device also generates the formats accepted by"," ","downstream third parties, encrypts one envelope per recipient, and submits"," ","only ciphertext and delivery metadata."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The backend knows routing metadata such as the merchant, recipient, and payment"," ","means, but it never receives or assembles plaintext receipt contents, CHEQI"," ","JSON, or UBL documents in this flow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-the-engine-does","__idx":2},"children":["What the engine does"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The engine:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["accepts optional country extensions and external-regime metadata;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["uses canonical receipt, party, payment, tax, identifier, and date fields"," ","before considering country extensions;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["preserves legal text and arbitrary country-namespaced fields;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["preserves POS- or authority-produced fiscal evidence;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["includes country data in canonical CHEQI JSON and document hashes;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["maps regimes, legal text, fiscal evidence, and extension fields to explicit"," ","UBL document references;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["can generate a missing UBL export from CHEQI JSON stored locally in a wallet;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["keeps non-VAT tax schemes such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GST"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QST"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SALES_TAX"]}," distinct;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["rejects only structurally unsafe final states, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FAILED"]}," ","fiscalization."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The engine does not:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["determine the applicable country, state, province, tax rate, threshold, or"," ","exemption;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["calculate or verify government signatures, hashes, QR payloads, or authority"," ","references;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["report transactions to tax authorities;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["infer whether a simplified invoice, full invoice, or fiscal receipt is"," ","required;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["enforce country-specific legal completeness."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"capability-test-coverage","__idx":3},"children":["Capability-test coverage"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The engine's executable capability suite covers:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["all 21 canonical countries;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["all currently documented external regimes plus ordinary receipts that need"," ","no jurisdiction data;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["cash, card, bank-transfer, and IBAN direct-debit examples;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["ordinary, fiscalized, correction, return, and credit-note examples;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["all 50 US states and the District of Columbia;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["deterministic CHEQI, UBL PurchaseReceipt, UBL Invoice, and UBL CreditNote"," ","generation;"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["wallet-side UBL export generation from locally stored CHEQI JSON."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These tests prove that the required information can be represented and"," ","preserved. They deliberately do not enforce local rules or claim legal"," ","compliance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"country-selection","__idx":4},"children":["Country selection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}," is needed, new integrations should set its"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}," explicitly. The supplier-country fallback remains available for"," ","compatibility:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["An explicit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.countryCode"]}," takes precedence."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Otherwise, the engine uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier.address.countryIsoCode"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If neither exists, the engine does not invent a country."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the issuance jurisdiction selected by your own transaction and compliance"," ","logic. Do not use the buyer's country automatically unless that is the correct"," ","issuance jurisdiction for the transaction."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The engine does not determine whether an external regime applies. Keep the"," ","country, selected regime, and legal supplier consistent in your integration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/jurisdictional-data"},"children":["Supply jurisdiction data"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/countries/profiles"},"children":["Open a country field mapping and example payload"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/creation"},"children":["Create a receipt"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/receipts/ubl-format"},"children":["Understand UBL output"]}]}]}]},"headings":[{"value":"Country Support","id":"country-support","depth":1},{"value":"How country data flows","id":"how-country-data-flows","depth":2},{"value":"What the engine does","id":"what-the-engine-does","depth":2},{"value":"Capability-test coverage","id":"capability-test-coverage","depth":2},{"value":"Country selection","id":"country-selection","depth":2},{"value":"Next steps","id":"next-steps","depth":2}],"frontmatter":{"title":"Country Support","description":"Understand Cheqi's country-specific receipt capabilities, coverage, and compliance boundary","seo":{"title":"Country Support"}},"lastModified":"2026-07-29T20:49:39.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}