Help Page Home - Journals
GET Journal/id
Return a single journal transaction detail record.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
WsAccessKey | The Web Service access key for this user and file which allows access to the API for the associated file (found in File - Settings). Using OAuth authentication mechanism is the preferred method to allow API access. | string |
Optional. Legacy authentication method and only required if not using OAuth. OAuth is preferred. |
FileId | Specifies the file id of the file to perform the operation upon. | integer |
Required |
id | Journal Id | integer |
Required |
Body Parameters
None.
Response Information
Resource Description
JournalDetailName | Description | Type | Additional information |
---|---|---|---|
Items | The items associated with this journal transaction. | Collection of JournalItem |
Required |
Notes | Textual notes set by the user. | string |
None. |
TransactionId | The Id/key of the journal/transaction. This data is returned only and cannot be added or updated when issuing a POST or PUT. | integer |
None. |
LastUpdatedId | A data field used to check concurreny when performing updates. This data is returned only and used for concurrency checking when performing an update/PUT. | string |
None. |
TransactionDate | Date of this transaction. | date |
Required |
Summary | Journal summary. | string |
None. |
Currency | The currrency code of the amounts. Eg. AUD. | string |
None. |
FxRate | FXRate (Foreign exchange rate) applied to this invoice. | decimal number |
None. |
AutoPopulateFxRate | Determines whether the FxRate is automatically populated using the Fx feed. | boolean |
None. |
Reference | Journal reference | string |
None. |
JournalContactId | The Id/key of the journal transaction's contact. | integer |
None. |
ContactFirstName | Contact first name. This data is returned only and cannot be added or updated when issuing a POST or PUT. | string |
None. |
ContactLastName | Contact last name. This data is returned only and cannot be added or updated when issuing a POST or PUT. | string |
None. |
ContactOrganisationName | Contact organisation name. This data is returned only and cannot be added or updated when issuing a POST or PUT. | string |
None. |
RequiresFollowUp | Journal transaction requires follow up | boolean |
None. |
Tags | List of tags associated with this resource. | Collection of string |
None. |
CreatedDateUtc | The date and time this resource was created in UTC. This data is returned only and cannot be added or updated when issuing a POST or PUT. | date |
None. |
LastModifiedDateUtc | The date and time this resource was last modified in UTC. This data is returned only and cannot be added or updated when issuing a POST or PUT. | date |
None. |
_links | Hypermedia links. Contains contextual links to possible next actions related to this resource. Only present in responses. This data is not to be sent to the server. | Collection of Link |
None. |
Response Formats
application/json, text/json
Sample:
{ "Items": [ { "Type": "Credit", "AccountId": 321, "TaxCode": "G1", "Amount": 10.0, "_links": [] } ], "Notes": "Test journal note", "TransactionId": 5093684, "LastUpdatedId": "AAAAAAAKgc=", "TransactionDate": "2015-01-24T00:00:00", "Summary": "Test Journal entry 1", "Currency": "AUD", "FxRate": 1.0, "AutoPopulateFxRate": false, "Reference": "123", "JournalContactId": 987, "ContactFirstName": "Joe", "ContactLastName": "Smith", "ContactOrganisationName": "Joes Toys", "RequiresFollowUp": false, "Tags": [ "Note", "Supplier", "Toys" ], "CreatedDateUtc": "2024-10-31T18:00:08.1703262Z", "LastModifiedDateUtc": "2024-11-01T18:00:08.1703262Z", "_links": [ { "rel": "self", "href": "https://api.saasu.com/Journal/5093684?FileId=123", "method": "GET", "title": null }, { "rel": "list", "href": "https://api.saasu.com/Journals?FileId=123", "method": "GET", "title": null }, { "rel": "update", "href": "https://api.saasu.com/Journal/5093684?FileId=123", "method": "PUT", "title": null }, { "rel": "delete", "href": "https://api.saasu.com/Journal/5093684?FileId=123", "method": "DELETE", "title": null } ] }
application/xml, text/xml
Sample:
<JournalDetail xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <_links> <Link> <rel>self</rel> <href>https://api.saasu.com/Journal/5093684?FileId=123</href> <method>GET</method> </Link> <Link> <rel>list</rel> <href>https://api.saasu.com/Journals?FileId=123</href> <method>GET</method> </Link> <Link> <rel>update</rel> <href>https://api.saasu.com/Journal/5093684?FileId=123</href> <method>PUT</method> </Link> <Link> <rel>delete</rel> <href>https://api.saasu.com/Journal/5093684?FileId=123</href> <method>DELETE</method> </Link> </_links> <TransactionId>5093684</TransactionId> <LastUpdatedId>AAAAAAAKgc=</LastUpdatedId> <TransactionDate>2015-01-24T00:00:00</TransactionDate> <Summary>Test Journal entry 1</Summary> <Currency>AUD</Currency> <FxRate>1</FxRate> <AutoPopulateFxRate>false</AutoPopulateFxRate> <Reference>123</Reference> <JournalContactId>987</JournalContactId> <ContactFirstName>Joe</ContactFirstName> <ContactLastName>Smith</ContactLastName> <ContactOrganisationName>Joes Toys</ContactOrganisationName> <RequiresFollowUp>false</RequiresFollowUp> <Tags> <string>Note</string> <string>Supplier</string> <string>Toys</string> </Tags> <CreatedDateUtc>2024-10-31T18:00:08.1703262Z</CreatedDateUtc> <LastModifiedDateUtc>2024-11-01T18:00:08.1703262Z</LastModifiedDateUtc> <Items> <JournalItem> <_links /> <Type>Credit</Type> <AccountId>321</AccountId> <TaxCode>G1</TaxCode> <Amount>10.00</Amount> </JournalItem> </Items> <Notes>Test journal note</Notes> </JournalDetail>