{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Canada ( CA )","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":"canada--ca-","__idx":0},"children":["Canada (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Canadian receipts and invoices use canonical tax fields. Add"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData"]}," only when Cheqi must preserve province or territory"," ","attribution that the current tax structure cannot represent."]},{"$$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":["Determine the place of supply, province or territory, customer-detail tier,"," ","and applicable taxes using your tax system."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Calculate every taxable base, rate, and amount outside Cheqi."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure the supplier context contains the Business Number and GST/HST account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Obtain any required provincial registration."]}]},{"$$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":["Province/territory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jurisdictionalData.additionalFields"]}," with code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA:REGION"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Business Number/GST-HST/PST/QST registrations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supplier identifiers in the context resolved by Cheqi"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GST/HST/PST/QST breakdown"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receipt and product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tax-and-region-placement","__idx":3},"children":["Tax and region placement"]},{"$$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":"Merchant tax result"},"children":["Merchant tax result"]},{"$$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":["HST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receipt and product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}," using the merchant-supplied tax type, rate, base, and amount"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GST"]},{"$$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":["PST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A separate receipt and product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}," entry"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["QST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A separate receipt and product ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes[]"]}," entry"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Province or territory attribution"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA:REGION"]}," when the attribution must be retained"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the actual tax scheme on each tax entry. The tax entries themselves show"," ","whether the transaction uses HST, GST, PST, or QST; do not repeat that"," ","combination as a country field. Cheqi does not decide which tax combination"," ","applies."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When region attribution is needed, add only the unsupported value:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"jurisdictionalData\": {\n    \"countryCode\": \"CA\",\n    \"additionalFields\": [\n      {\n        \"code\": \"CA:REGION\",\n        \"value\": \"merchant-supplied-province-or-territory\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$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":"Canada ( CA )","id":"canada--ca-","depth":1},{"value":"Before Cheqi","id":"before-cheqi","depth":2},{"value":"In the Cheqi request","id":"in-the-cheqi-request","depth":2},{"value":"Tax and region placement","id":"tax-and-region-placement","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Canada","description":"Create province-aware Canadian GST, HST, PST, and QST receipts","seo":{"title":"Canada ( CA )"}},"lastModified":"2026-07-30T07:15:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/countries/ca","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}