Table of Contents
Bank Accounts
Reckon One Module | Endpoint | Additional Parameter(s) | HTTP Method | Request URL | Description | API Portal | Countries |
Core |
| GET | Retrieve the list of bank accounts as per the chart of accounts UI | AU/NZ/UK | |||
Core |
| POST | Post a new bank account to the Reckon One book | 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 |