question

EDIT: (20th April)Looks like I've been calculating taxes incorrectly on my end, thanks to @Sam for clearing it up over email. Here's a simple website example for VAT if anyone else is as unfamiliar with tax calculation as I am: http://vatcalconline.com/

EDIT: (13th April)

On testing this, i'm seeing incorrect figures for 'Tax Collected' for the tax rates under 'Payments'. With the following tax rate in my payment, I'm seeing a total 'Tax Collected' of €0.43 instead of €0.47

I'm so lost..

      {
        "name": "Food",
        "rate": 900000,
        "taxableAmount": 520
      }

EDIT: Below is what I see in the web reporting app for an order created manually on a sandbox clover mini dev kit (the register app, not the api). That order simply had a single item (americano @ €2.00), and was paid for in 'cash' via the register app. I'm testing this in Ireland, the merchant is set to Irish with tax already included in the item price. Am I wrong in saying the tax collected for this manual order should simply be €2.00 * 12% = €0.24 (using the Round up => 5 rule)

Old Answer I thought was correct:

I've figured it out:

Reporting > Taxes > Payments

Is made up solely from the payment attached to the order

"taxRates": [
    {
      //The total taxable amount (i.e. NOT the resulting tax amount)
      //e.g. if a coffee was bought for 4.50, the taxableAmount here would be 450
      //I believe it's the total of all the items paid
      //for (following guidelines: https://docs.clover.com/build/working-with-orders/), grouped by taxRates
      "taxableAmount": 450,
      "rate": 2300000,
      "id": "THETAXRATEID"
    }
]

Reporting > Taxes > Net Taxes

Is whatever you set for the taxAmount in the payment

This is where the manual tax calculation comes in https://docs.clover.com/build/working...

"taxAmount": 103 //e.g. 23% of the 4.50 coffee

Feedback:

I spent a lot of time thinking my 'order' object was incorrect/trying to set the lineItem tax rates to see if that would work.

I also assumed a lot of this tax stuff would be done automatically, considering the clover system is fully aware of the taxes for different items etc, although I don't know enough about tax, so maybe there's a good reason for not auto calculating. I'm almost sure I didn't miss docs or answers on how to do all this, and found the api documentation pretty poor too.

Documentation Suggestion: Official docs fully covering how to create an order covering all the different tax situations would be ideal (With examples on how it may differ between regions).

Thanks, Alan