Tax Groups API v1

Overview
Sample
Details of each object

Overview

Reckon One API v2 is now available.
Tax codes API v2 endpoints provides you with more information about your Tax Groups & Tax Codes.

Read the list of tax groups from a book. Tax groups are required for endpoints such as accounts and items.

Effective date is required as Reckon One has the ability to change the tax rate based on legislative changes without changing the tax code name. You can use today's date as the default date so that you always get the latest rate unless you need rate from a specific date.

Reckon One Module	Endpoint	Additional Parameter(s)	HTTP Method	Request URL	API Portal	Countries
Core	Tax Groups	/effectiveDate	GET	https://api.reckon.com/R1/{cashbookid}/taxgroups	Portal	AU/NZ/UK

Sample

Sample Request

https://api.reckon.com/R1/e673d490-4571-4a45-812e-8e0ght89674e56/taxgroups/2017-06-30

Sample response (AU Book)

{
         "ID": "7823bc0d-797f-4e2a-ae65-bcb7cd11d2c2",
         "Name": "FRE",
         "Rate": 0,
         "IsActive": true,
         "Description": "GST free sales",
         "TaxCodes": [
             {
                 "UseCodeOnPurchases": false,
                 "UseCodeOnSales": true
             }
         ],
         "UseOnPurchases": false,
         "UseOnSales": true,
         "TaxReportingLocations": "G1, G1, G3, G3"
     },
     {
         "ID": "8022e64c-1035-40d0-9e65-82b983dc490c",
         "Name": "GST",
         "Rate": 10,
         "IsActive": true,
         "Description": "GST on sales",
         "TaxCodes": [
             {
                 "UseCodeOnPurchases": false,
                 "UseCodeOnSales": true
             }
         ],
         "UseOnPurchases": false,
         "UseOnSales": true,
         "TaxReportingLocations": "1A, G1, G1"
 }

Sample response (UK Book)

{
"ID": "2b278c07-722e-44d1-9f7a-cad68a482b3f",
"Name": "X",
"Rate": 0.00000,
"IsActive": true,
"Description": "VAT exempt items",
"TaxCodes": [
{
"UseCodeOnPurchases": true,
"UseCodeOnSales": true
}
],
"UseOnPurchases": true,
"UseOnSales": true,
"TaxReportingLocations": "1, 6, 6, 7",
"ExportCode": null
},
{
"ID": "31a7e002-2d02-4bca-bd83-c644c17c7e53",
"Name": "S",
"Rate": 20.00000,
"IsActive": true,
"Description": "Standard rate VAT",
"TaxCodes": [
{
"UseCodeOnPurchases": true,
"UseCodeOnSales": true
}
],
"UseOnPurchases": true,
"UseOnSales": true,
"TaxReportingLocations": "1, 1, 4, 6, 6, 7",
"ExportCode": null
},
{..}

Details of each object

Data Field	Description	Data Type
ID	The unique ID of the tax group in the Reckon One book (file)	GUID
Name	The name of the tax group	Alphanumeric
Rate	The rate of the tax group	Numeric
IsActive	Whether the tax group is active or not	Boolean (True/False)
Description	Description of the tax group	Alphanumeric
Tax Codes Array	The settings for the tax code with regards to sales and purchases
UseCodeOnPurchases	Whether the tax code is used on purchases	Boolean (True/False)
UseCodeOnSales	Whether the tax code is used on sales	Boolean (True/False)
UseOnPurchases		Boolean (True/False)
UseOnSales		Boolean (True/False)

Table of Contents