• Home
  • Anonymous
  • Sign in
  • Create
  • Ask a question
  • Create an article
  • Post an idea
  • Spaces
  • App Market Developer Platform
  • Clover GO
  • Ideas & Feedback
  • Semi-Integration
  • Explore
  • Topics
  • Questions
  • Articles
  • Ideas
Skip to main content
  • Create
    • Ask a question
    • Post an idea
    • App Market Developer Platform
    • Clover GO
    • Ideas & Feedback
    • Semi-Integration
    • Topics
    • Questions
    • Articles
    • Ideas
  • Sign in
  • Home
  • App Market Developer Platform
This question was closed Apr 02 at 09:52 PM by Clover_Community_Bot for the following reason: automated

question

Alan avatar image
Alan asked · Apr 12, 2017 at 02:38 PM

Tax for an API created order

Hi Clover,

I'm struggling to figure out tax on API created orders.

The closest documentation I could find is this: https://docs.clover.com/build/working...

But I haven't found any guides or good full answers here on how to 100% handle tax properly for an API created order.

I'm close, I have my api payments adding to 'Tax Collected' in the reporting app, but I'm struggling to get my tax Rates to appear under 'Payments' in the taxes section of the reporting app.

Rather than me explaining what I'm doing/not doing, could I please get a guide/documentation on what I should be doing? We've already lost a lot of time so far trial and erroring, and would appreciate help.

Best regards,

Alan

Orders
Comment
0
10 |2000 characters needed characters left characters exceeded
  • Viewable by all users
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Toggle Comment visibility. Current Visibility: Viewable by all users

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

1 Answer

Alan avatar image
Alan answered · Apr 12, 2017 at 03:08 PM Locked

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)

Cash order taxes for a clover pos cash created order

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

· 3 comments · Share
10 |2000 characters needed characters left characters exceeded
  • Viewable by all users
  • Viewable by moderators
  • Viewable by moderators and the original poster
  • Advanced visibility
Toggle Comment visibility. Current Visibility: Viewable by all users

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Sam avatar image Sam · Apr 14, 2017 at 07:07 PM

Thanks for the detailed feedback, @Alan

0 · ·
Alan avatar image Alan · Apr 15, 2017 at 08:04 AM

Thanks @Sam, the top of my answer has edits with new issues I'm seeing with tax. The result seems wrong whether its an API payment or a cash/manual payment. Can you clarify why the result isn't what i expected? Thanks

0 · ·
Alan avatar image Alan · Apr 19, 2017 at 06:41 AM

Hi @Sam This looks like a bug to me considering cash orders are off too. Is this particular question being followed up by clover? I'm going to submit my apk for a second review but also don't want to cause merchants to report incorrect tax returns. It doesn't look like there's anything I can do about it though. Would appreciate hearing any info on this at all, Thanks

1 · ·

Welcome to the
Clover Developer Community

question details

2 People are following this question.

Alan follows this question Sam follows this question
Answers Subscribe to Answers Answers and Comments Subscribe to Comments and Answers

Related Questions

Looking for a proper way of adding payment for order 3 Answers

High-level integration questions for mobile taxi payment 1 Answer

Rest API get last payment ID? 2 Answers

Which Broadcast should I use to check when an Order is fully paid? 1 Answer

Rest API - Create order with manualTransaction total $ keeps disappearing. 1 Answer

Answerhub Logo
  • About
  • ·
  • FAQ
  • ·
  • Privacy
  • ·
  • Copyright © 2010-19 DZone, Inc.