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.

Tax Exclusive

Products - Tax Exclusive

In tax exclusive regions, a POS needs to sync product prices without tax included and specify the tax rate per item and fulfillment type as in example snippet below;

{
  "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 seperate tax calculation will be applied by the ordering platform and will be included as a single taxTotal

Example order

"items": [
  {
    "name": "Chicken Sate",
    "plu": "P-SATE",
    "price": 450,
    "productType": 1,
    "quantity": 1,
    "subItems": []
  }
],
"payment": {
  "amount": 495,
  "due": 0,
  "type": 0
},
"taxTotal": 45,

Tax Inclusive

Products - Tax Inclusive

In tax inclusive regions, a POS needs to sync product prices inclusive of tax and also specify the tax rate applied per item and fulfillment type as above

Order Payload - Tax Exclusive

For the order payload received, no seperate tax calculation will be applied