---
updatedAt: 2026-08-18T17:59:15.000Z
agentTools:
  projectIndex: https://developers.deliverect.com/v1.1-restaurants/llms.txt
---

# How to handle Taxes

## Introduction

Depending on whether a Location operates within a tax-exclusive or tax-inclusive region, the POS has certain fiscal responsibilities to properly handle taxation.

<HTMLBlock>{`
<div class="callout-banner callout-banner--neutral">
  <span class="callout-icon"><i class="fa-regular fa-square-info"></i></span>
  <p>

    Tax rates are stored as an int with 3 decimal digits, e.g. 5% would be <code>5000</code>. This convention applies to both tax-exclusive and tax-inclusive regions.
  </p>
</div>
`}</HTMLBlock>

***

## Tax Exclusive

### Products - Tax Exclusive

In tax-exclusive regions, the POS needs to sync product prices **without** tax included, and specify the tax rate per item and fulfillment type, as in the example below where `deliveryTax` , `takeawayTax` and `eatInTax` are defined;

```json Product Tax Example
{
  "name": "Chicken Sate",
  "productType": 1,
  "plu": "P-SATE",
  "price": 450,
  "deliveryTax": 10000,
  "takeawayTax": 10000,
  "eatInTax": 10000
}
```

### Order Payload - Tax Exclusive

For the order payload received, a separate tax calculation is applied by the ordering platform and is included as a single `taxTotal` The POS is responsible for fiscal reporting of this taxation.

```json Tax Exclusive - Example Order
"items": [
  {
    "name": "Chicken Sate",
    "plu": "P-SATE",
    "price": 450,
    "productType": 1,
    "quantity": 1,
    "subItems": []
  }
],
"payment": {
  "amount": 495,
  "due": 0,
  "type": 0
},
"taxes": [
    {
      "name": "GST",
      "taxClassId": 0,
      "total": 45
    }
  ],
"taxTotal": 45,
"taxRemitted": 45
```

| Attribute          | Meaning                                                                                                                                       | Type    |
| :----------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | :------ |
| `taxTotal`         | This is combined total of all taxes applied to the order                                                                                      | integer |
| `taxRemitted`      | In regions where the channel has responsibility for charging tax e.g. where they are 'Marketplace Facilitator' this is the total tax remitted | integer |
| taxes.`name`       | An optional value for channels to provide to specific the name for each tax applied                                                           | string  |
| taxes.`taxClassId` | An optional value for channels to provide to an Id  to identify the tax applied                                                               | integer |
| taxes.`total`      | An optional value for channels to provide to the total specific to the tax applied                                                            | integer |

***

## Tax Inclusive

### Products

In tax-inclusive regions, the POS needs to sync product prices **inclusive** of tax, while still specifying the tax rate applied per item and fulfillment type, as shown in the Tax Exclusive example above.

### Order Payload

For the order payload received, no separate tax calculation is applied, the item price already includes this calculation. The POS continues to be responsible for fiscal reporting of this taxation.

***

## Configuring Default Tax Setting&#x20;

An account will be automatically set per region to either tax exclusive or inclusive, depending on the region set.**&#x20;**&#x59;ou can verify this setting via editing the location settings and checking the toggle highlighted below.

<HTMLBlock>{`
<div class="callout-banner callout-banner--neutral">
  <span class="callout-icon"><i class="fa-regular fa-square-info"></i></span>
  <p>

    If tax exclusive/inclusive setting need adjusted, please contact our support team via integrations-support@deliverect.com
  </p>
</div>
`}</HTMLBlock>

1. ![shows tax exclusive setting that is enabled](https://files.readme.io/956598cff325525ea6feaed2ee6720179e0486653774bee441c64b5748182739-Screenshot_from_2025-08-13_11-51-24.png)

##