# Canada (`CA`)

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.

## Before Cheqi

- 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.


## In the Cheqi request

| 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[]` |


## Tax and region placement

| 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:

```json
{
  "jurisdictionalData": {
    "countryCode": "CA",
    "additionalFields": [
      {
        "code": "CA:REGION",
        "value": "merchant-supplied-province-or-territory"
      }
    ]
  }
}
```

## Related

- [Supplying jurisdiction data](/countries/jurisdictional-data)
- [Country support boundary](/countries/overview)