Table of Contents
Receipts (Receive Money) API v1
Overview
Receipts API v2 endpoints provides you with more information about your Receipts.
The Receipts endpoint can be found at: https://api.reckon.com/R1/{BOOKID}/receipts
Methods supported: GET, PUT, POST, 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 | /receipts | GET | Retrieve a list of receipts (money in) | AU/NZ/UK | |||
Core | /receipts | POST | Create a receipt (money in) | AU/NZ/UK | |||
Core | /receiptId | PUT | Allocate a receipt (money in) to an invoice | AU/NZ/UK | |||
Core | /receiptId | DELETE | Deletes a receipt | AU/NZ/UK |
Sample
Sample GET Response
Endpoint: https://api.reckon.com/R1/{BOOKID}/receipts
Method: GET
{
"Id":"0013ade2-80df-4fed-bac2-7fc1c43790d0",
"CashbookId":"e17417ac-fc79-4d4d-9ee8-1780b3bc326f",
"BankAccountId":"00feb5c9-6da3-4603-87d8-d1ee7d6de894",
"Amount":11.0000,
"ContactName":"Desc_AE94D6FA-2BD82002-49BF-874F-48720B990E87",
"Details":"abc",
"PaymentMethodType":1,
"PaymentMethodName":"Cash",
"IsReconciled":true,
"Reference":"def",
"TransDate":"2016-08-25T00:00:00+00:00"
}
Sample POST
Endpoint: https://api.reckon.com/R1/{BOOKID}/receipts
Method: POST
{
'TransDate': '10/10/2015',
'BankAccountId': '5b3a4f48-beb0-4e23-bf2f-2d7127239a00',
'Amount': 100,
'ContactId': '519403ea-bd33-4b7c-b71a-cd32b8fbe2c8',
'AllocateFullAmount': false,
'PaymentMethodId': '057ecf9c-b966-4fe5-93e5-edc8812344b3',
'Details': 'abc',
'Reference': 'def',
'IsReconciled': true,
'Narration': 'qqq',
'Allocations': [ ],
'AllocationSplit': [
{
'ProjectId': '24879c21-8e1f-4f50-b1a0-bb01d3447b7b',
'ChargeableItemId': 'af848ea8-cfdb-4768-a6f9-c916a873985f',
'LineNo': 1,
'Description': null,
'Quantity': 0,
'UnitPriceExTax': 10,
'UnitPriceTax': 1,
'UnitPricePrecision': 2,
'DiscountAmountExTax': null,
'DiscountAmountTax': null,
'DiscountAccuracy': null,
'DiscountPercent': null,
'TaxGroupId': 'fae4ba18-20db-4b35-a944-711f7c3273bb',
'TaxIsModified': false,
'AmountExTax': 10,
'Amount': 0,
'TaxAmount': 1,
'AmountAccuracy': null,
'InvoiceDiscountedAmountExTax': null,
'InvoiceDiscountedTaxAmount': null,
'HasDataForPosting': true,
'IsSubTotal': false,
'IsParent': false
}
]
}Sample minimum POST
Endpoint: https://api.reckon.com/R1/{BOOKID}/receipts
Method: POST
The below example will create a new Receive Money transaction with an item called Chocolate Nutella, including 1 quantity and use tax code GST:
{
"TransDate": "12/17/2018",
"BankAccountId": "4cd7c12f-1931-4938-a739-1fe758fbd633",
"Amount": 11,
"ContactId": "bf6c5017-3c3f-46bf-b8a8-af6eb31f9d98",
"AllocateFullAmount": true,
"AllocationSplit":
[
{
"ChargeableItemId": "53f23ccc-36e8-428c-b506-ca030df1f6ff",
"LineNo": 1,
"Quantity": 1,
"TaxGroupId": "0933b89e-0a9a-4d41-8c5b-1ec21509bfb5",
"AmountExTax": 10,
"TaxAmount": 1,
"HasDataForPosting": true
}
]
} 
Sample PUT
Endpoint: https://api.reckon.com/R1/{BOOKID}/receipts/{id}
Methods supported: PUT
{
"TransDate": "2017-11-27",
"BankAccountId": "f05d775a-5ace-48bd-8223-2635f0e08161",
"Amount": 1000,
"ContactId": "97cffe31-f8a5-49b4-bb6b-501309f4a815",
"AllocateFullAmount": false,
"PaymentMethodId": "00000000-0000-0000-0000-000000000000",
"Details": "details",
"Reference": "reference",
"IsReconciled": false,
"Narration": "narration",
"AccountsReceivableCategoryId": "1081463b-47f6-45a7-af51-815f1f0bf993",
"Allocations": [{
"AllocationAmount": 1000,
"AllocationTypeId": 1,
"RefId": "77aa026d-f731-4135-b40d-7f749de9f211"
}],
"AllocationSplit":[]
}
{
"AllocateFullAmount": false,
"AllocationSplit": [
{
"AccountId": "00000000-0000-0000-0000-000000000000",
"Amount": 0,
"AmountAccuracy": null,
"AmountExTax": 10,
"ChargeableItemId": "af848ea8-cfdb-4768-a6f9-c916a873985f",
"Description": null,
"DiscountAccuracy": null,
"DiscountAmountExTax": null,
"DiscountAmountTax": null,
"DiscountPercent": null,
"HasDataForPosting": false,
"InvoiceDiscountedAmountExTax": null,
"InvoiceDiscountedTaxAmount": null,
"IsParent": false,
"IsSubTotal": false,
"LineNo": 1,
"ProjectId": "24879c21-8e1f-4f50-b1a0-bb01d3447b7b",
"Quantity": 0,
"TaxAmount": 1,
"TaxGroupId": "fae4ba18-20db-4b35-a944-711f7c3273bb",
"TaxIsModified": false,
"UnitPriceExTax": 10,
"UnitPricePrecision": 2,
"UnitPriceTax": 1
}
],
"Allocations": [
{
"AllocationAmount": 11,
"AllocationType": "Invoice",
"AllocationTypeId": 1,
"RefId": "5aa063b7-50d8-49cc-ac57-6ed8e775daf4"
}
],
"Amount": 100,
"BankAccountId": "5b3a4f48-beb0-4e23-bf2f-2d7127239a00",
"ContactId": "519403ea-bd33-4b7c-b71a-cd32b8fbe2c8",
"Details": "Receipt ABC123",
"Id": "c3ea5df1-7ff9-42dd-8dae-7b84561d3867",
"IsReconciled": true,
"Narration": "Allocate a Receipt",
"PaymentMethodId": "057ecf9c-b966-4fe5-93e5-edc8812344b3",
"Reference": "ABC123",
"TransDate": "10/10/2015"
}Sample DELETE
Endpoint: https://api.reckon.com/R1/{BOOKID}/receipts/{id}
Methods supported: DELETE
Details of each object
Data Field | Description | Data Type | Mandatory? |
TransDate | The transaction date for the receipt | Date/Time | Yes |
BankAccountID | The GUID of the bank account to be associated with the receipt | GUID | Yes |
Amount | The amount of the receipt to be posted | Numeric | Yes |
ContactID | The id of the contact to be associated with the receipt | GUID | Yes |
AllocateFullAmount | Whether the full amount is to be allocated to another transaction | Boolean - true false | Yes |
PaymentMethodID | The GUID of the payment method to be used with the transaction | GUID | No |
Details | The description for the receipt | Alphanumeric | No |
Reference | The reference for the transaction | Alphanumeric | No |
Narration | The narration for the transaction | Alphanumeric | No |
Allocations Array | Where the transaction should be allocated if it is to be associated with a transaction | Array | Depends if you're allocating to an invoice or just creating a new transaction |
AllocationSplit Array | If the transaction is not to be associated with a previous transaction, how the amount should be allocated in the book | Array | Depends if you're allocating to an invoice or just creating a new transaction |
ProjectID | If the transaction should be allocated to a project, the GUID of the project. | GUID | No |
ChargeableItemId | If the transaction should be allocated to an item, the GUID of the item | GUID | Either ChargeableItemId or AccountId is required |
AccountId | If the transaction should be allocated to a Chart of Account, the GUID of the account | GUID | Either ChargeableItemId or AccountId is required |
LineNo | The line number in the transaction. Each line requires a separate entry in the AllocationSplit array | Numeric | No |
Description | The description for the line in the transaction | Alphanumeric | No |
Quantity | The quantity to be associated with the line | Numeric | No |
UnitPriceExTax | The unit price to be allocated to the line without tax included | Numeric | No |
UnitPriceTax | The tax amount to be allocated to the line | Numeric | No |
UnitPricePrecision | The number of decimal places the tax should be calculated on up to 8. is important for tax calcs by default will set to 2.0 | Numeric | No |
DiscountAmountExTax | The amount of the line with a discount applied minus tax | Numeric | No |
DiscountAmountTax | The amount of tax for the line with a discount applied | Numeric | No |
DiscountPercent | If a discount is to be applied via percentage, the percentage the discount should be | Numeric | No |
TaxGroupId | The GUID of the tax code to be applied to the line in the transaction | GUID | No |
TaxIsModified | If its false, your tax calculations will be compared against the Reckon One tax engine and if it does not match the transaction is blocked. If set to true, the engine is not checked and you can post any tax you desire. The UI also controls this function via SETTINGS for the same purpose. | Boolean - True/False | No |
AutoCalcTax | Allows Reckon to calculate the tax. You send the net amounts to us including "autocalctax": true and a TaxGroupId in the payload, and our tax engine figures out what the tax should be. It also means that by using that you are always complying with and using the R1 tax engine. ** Was not available in early API versions. | Boolean: true/false | No |
AmountExTax | The amount of the line without tax | Numeric | Yes |
Amount | The amount of the line including tax | Numeric | No |
TaxAmount | The amount of tax for the line | Numeric | Yes |
AmountAccuracy | How many decimal points are associated with the amount for the total transaction up to 8. Is 2 by default and can be posted as null. | Numeric | No |
InvoiceDiscountedAmountExTax | Always null |
| No |
InvoiceDiscountedTaxAmount | Always null |
| No |
HasDataForPosting | If not set to true this will post as a non-posting transaction which cannot be currently changed in the UI. ** POST AS TRUE. | Boolean - True/False | No |
IsSubtotal | Whether this line is a subtotal | Boolean - True/False | No |
IsParent | Whether this line is the parent of a group of other lines | Boolean - True/False | No |
AccountsReceivableCategoryId | Accounts Receivable account's ID. You can get it either via GET Chart of Accounts or by going to Chart of Accounts > Assets within Reckon One webapp | GUID | No |
