Chart of Accounts API v1

Overview
Sample
Details of each object
- GET
- POST/PUT

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

Table of Contents