Table of Contents

Tax Groups API v1

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)

 

How did we do?

Company Info

Terms API v1

Related Articles

Tax Codes API v2
Classifications API v1
Expenses API v1
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)