Canadian receipts and invoices use canonical tax fields. Add jurisdictionalData only when Cheqi must preserve province or territory attribution that the current tax structure cannot represent.
- Determine the place of supply, province or territory, customer-detail tier, and applicable taxes using your tax system.
- Calculate every taxable base, rate, and amount outside Cheqi.
- Ensure the supplier context contains the Business Number and GST/HST account.
- Obtain any required provincial registration.
| Value | Request location |
|---|---|
| Province/territory | jurisdictionalData.additionalFields with code CA:REGION |
| Business Number/GST-HST/PST/QST registrations | Supplier identifiers in the context resolved by Cheqi |
| GST/HST/PST/QST breakdown | Receipt and product taxes[] |
| Merchant tax result | Request location |
|---|---|
| HST | Receipt and product taxes[] using the merchant-supplied tax type, rate, base, and amount |
| GST | Receipt and product taxes[] |
| PST | A separate receipt and product taxes[] entry |
| QST | A separate receipt and product taxes[] entry |
| Province or territory attribution | CA:REGION when the attribution must be retained |
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.
When region attribution is needed, add only the unsupported value:
{
"jurisdictionalData": {
"countryCode": "CA",
"additionalFields": [
{
"code": "CA:REGION",
"value": "merchant-supplied-province-or-territory"
}
]
}
}