Table of Contents

Chart of Accounts API v1

 Overview

Reckon One API v2 is now available.
Ledger Accounts API v2 endpoints provides you with more information about your Ledger Accounts.

The Invoices endpoint can be found at:   https://api.reckon.com/R1/{BOOKID}/accounts 

Methods supported:   GET, POST, PUT, DELETE

The Book ID represents the unique GUID of the Book the user wants to write data to. For example, c1b3da90-e9df-4d57-8cfb-71a1d7bfe401

Reckon One Module

Endpoint

Additional Parameter(s)

HTTP Method

Request URL

Description

API Portal

Countries

Core

Accounts

 

GET

https://api.reckon.com/R1/{BOOKID}/accounts  

Retrieve the chart of accounts list

Portal

AU/NZ/UK

Core

Accounts

 

PUT

https://api.reckon.com/R1/{BOOKID}/accounts  

Update a general ledger account from the book's chart of accounts

Portal

AU/NZ/UK

Core

Accounts

 

POST

https://api.reckon.com/R1/{BOOKID}/accounts  

Create a general ledger account in the book's chart of accounts 

Portal

AU/NZ/UK

Core

Accounts

/accountId

DELETE

https://api.reckon.com/R1/{BOOKID}/accounts  

Delete a general ledger account in the book's chart of accounts 

Portal

AU/NZ/UK

 

Sample

Sample POST
{
    "AccountType":1,
    "AccountName":"Bank Fees",
    "Hint":"test_Hint",
    "Status":1,
    "TaxGroupId":"D56763CA-EA2F-484A-B475-002779134965",
    "SortOrder":1
}

 

Sample minimum post

The below example will create a new income account called My income Account:

 {
     "AccountName": "My Income Account",
     "AccountType": 1,
     "Status": 1
 }

 

Sample GET
 {

        "Id": "01786fe1-ab30-4f12-b59a-706124ce041e",

        "Name": "Bank Fees",

        "Description": "Description of the account",

        "AccountType": 1,

        "AccountStatus": 1,

        "AccountCode": null,

        "DefaultTaxCode": "GST",

        "ParentAccountingCategoryId": "00000000-0000-0000-0000-000000000000",

        "ExportCode": "EC_20180222_143952",

        "LastModifiedDate": "2018-02-22T14:39:05.04"

}

Details of each object

GET

Data Field

Description

Data Type

Id

The unique ID of the account in the Reckon One book (file)

GUID

Name

The name of the account

Alphanumeric

Description

The description of the account

Alphanumeric

AccountType

 

 

The type of the account

Set data types:

0- Unknown

1- Income

2- Expense

3- Current Asset

4- Other current liability

5- Equity

6- Other Income

7- Other Expense

8- Cost of Goods Sold

9- Bank

10- Accounts Receivable

11- Fixed Assets

12- Other non-current asset

14- Credit Card

15- Accounts Payable

16- Non Current Liability

AccountStatus

 

 

Whether the account is active or not

Set data types:

0- Unknown

1- Active

2- Inactive

AccountCode

The Account Code set by the user in Reckon One

Alphanumeric

DefaultTaxCode

The default Tax code that's set in the Account

Alphanumeric

ParentAccountingCategoryId

If this is a subaccount, this is the main account's Id

GUID

ExportCode

The Account's export code

Alphanumeric

LastModifiedDate

NEW - Last modified date and time of the Account

UTC

POST/PUT

Data Field

Description

Data Type

Mandatory?

AccountName

The name of the account

Alphanumeric

Yes

AccountType

 

 

The type of the account

 

 

Note

The following account types are Default system accounts and should NOT be created by the the API Post/Put methods under any circumstances:

10 - Accounts Receivable

15 - Accounts Payable

 

Furthermore Bank Accounts should be created via the Bank Account endpoint - POST method. See here for details.

Set data types:

0- Unknown

1- Income

2- Expense

3- Current Asset

4- Other current liability

5- Equity

6- Other Income

7- Other Expense

8- Cost of Goods Sold

9- Bank [Put/Post using Bank endpoint]

10- Accounts Receivable [forbidden]

11- Fixed Assets

12- Other non-current asset

14- Credit Card

15- Accounts Payable [forbidden]

16- Non Current Liability

Yes

Status

 

 

Whether the account is active or not

Set data types:

0- Unknown

1- Active

2- Inactive

No

If it's not passed, then it marks the stats "Unknown" as default

AccountCode

The Account Code set by the user in Reckon One

Alphanumeric

No

ParentAccountingCategoryId

 

If this is to be a subaccount, the main account that this account should be linked to. The account types MUST be the same for this to be successful

GUID

No

Hint

 

This is a hint that appears to the user in Reckon One as to what this account should be used for when they are for example adding it to a invoice

Alphanumeric

No

TaxGroupID

The tax code that should be associated with the account

GUID – The list of tax codes can be retrieved from the Tax Group endpoint.

No

SortOrder

How high the account will appear in the chart of accounts by default

Numeric

No

How did we do?

Templates API v1

Bank Accounts

Related Articles

Chart of Accounts
Ledger Accounts API v2
Import Chart of Accounts
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)