Table of Contents

Bank Accounts

 

Reckon One Module

Endpoint

Additional Parameter(s)

HTTP Method

Request URL

Description

API Portal

Countries

Core

Bank Accounts

 

GET

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

Retrieve the list of bank accounts as per the chart of accounts UI

Portal

AU/NZ/UK

Core

Bank Accounts

 

POST

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

Post a new bank account to the Reckon One book

Portal

AU/NZ/UK

 

Retrieval of Bank Accounts 

Data Field

Description

Data Type

BankAccountID

The Unique ID of the Bank Account

GUID

Description

The description of the bank account within the Reckon One Book.

Text

IsBankAccountedOpened

Whether the bank account is active or not

Boolean: true/false

IsCash

Whether the account is cash based or not

Boolean: true/false

 

Adding a Bank Account

Endpoint: https://api.reckon.com/R1/{BOOKID}/bankaccounts 

Methods supported:  POST

Sample

Sample post
 {
   "AccountType": 1,
   "BankAccountStatus": 1,
   "BulkElectronicPaymentSettings": {
     "AccountName": "John Citizen",
     "IncludeBalancingTransaction": true,
     "PayerIdentifier": "300"
   },
   "DateFrom": "2016-10-02T00:00:00",
   "DateTo": "2017-01-01T00:00:00",
   "Description": "My Bank",
   "EFT": {
     "AccountName": "John Citizen",
     "EFT1": "623866",
     "EFT2": "20011223"
   },
   "IsBankAccountOpened": false,
   "LockoffDate": "0001-01-01T00:00:00",
   "OpeningBalance": 100.0
 }

 

Sample Minimum payload

Below call will create a Bank account called "My Bank Account", set it active and mark it as a "Bank" type account

 {
   "AccountType": 1,
   "BankAccountStatus": 1,
   "BulkElectronicPaymentSettings": {
     "AccountName": "My Bank Account"
   },
   "Description": "My Bank Account",
   "EFT": {
   }
 }

Details of each object

Data Field

Description

Data Type

UI

Mandatory?

AccountType

The type of the bank account

1 - Bank

2 - Credit

Account Type

Yes

BankAccountStatus

The status of the bank account, whether it is opened or closed

1 - Open

2 - Closed

Account status

Yes

BulkElectronicPaymentSettings

The settings for bulk payments for bank import files etc

 

 

 

IncludeBalancingTransaction

Whether to include a balancing transaction for the opening of the account

Boolean true/false

Include balancing transaction checkbox

No

PayerIdentifier

In Australia this is the APCA number, for other regions it is the equivalent of the APCA number

Alphanumeric

APCA #

No

DateFrom

The opening date of the account in universal time

Date/Time

Date account opened

No

DateTo

The closing date of the account in univesal time if required

Date/Time

Date account closed

No

Description

The description of the bank account

text

Account display name

Yes

EFT

The details of the bank account for electronic payments such as BSB/Account Details

Text

 

Only "EFT": { }" object is required

AccountName

The name of the account for interbank transfers

Text

Account name (name of the account holder)

No

EFT1

The BSB number of the bank account

Numeric

BSB

Required if EFT2 has data otherwise not required

EFT2

The account number of the bank account

Numeric

Account number

Required if EFT1 has data otherwise not required

LockoffDate

The account lock off time in universal time. Transactions cannot be entered against this account before this time.

Date/Time

Transactions locked off until

No

OpeningBalance

The opening balance of the account

Numeric

Opening balance

No

 

How did we do?

Chart of Accounts API v1

Bank Transfers

Related Articles

Bank Accounts - Reckon One
How to merge bank accounts
Bank Account BSB and Number must not be empty error when uploading to a SuperStream Clearing House
Powered by HelpDocs (opens in a new tab)

Powered by HelpDocs (opens in a new tab)