JournalEntries

Create, update, delete, and query Reckon Journal Entries. Note that while Journal Entry Lines can be created with a new Journal Entry, they cannot be added or removed from an existing Journal Entry.

Table Specific Information

JournalEntries are unique in that the Credit Line Items and Debit Line Items must add up to the same total in one transaction. It is not possible to change a Journal Line Item one at a time and thus end up with an unbalanced transaction.

Select

By default, SupportEnhancedSQL is set to true, and the following will be honored if present. Other filters will be executed client side. If SupportEnhancedSQL is set to false, only the following filters will be honored.

Reckon allows only a small subset of columns to be used in the WHERE clause of a SELECT query. These columns can typically be used with only the equals or = comparison. The available columns for JournalEntries are Id, Date, TimeCreated, ReferenceNumber, LineEntityName, LineEntityId, LineAccount, and LineAccountId. TimeModified and Date may be used with the >, >=, <, <=, or = conditions and may be used twice to specify a range. ReferenceNumber may be used with the = or LIKE conditions to establish a starts-with, ends-with, or contains syntax. For example:

SELECT * FROM JournalEntries WHERE TimeModified > '1/1/2011' AND TimeModified < '2/1/2011' AND ReferenceNumber LIKE '%12345%'

Insert

To add a JournalEntry, specify at least one Credit and one Debit Line. The LineAggregate column may be used to specify an XML aggregate of JournalEntry Line data. The columns that may be used in these aggregates are defined in the JournalEntryLines table and it starts with Line. For example, the following will insert a new JournalEntry with two Credit Lines and one Debit Line:

INSERT INTO JournalEntries 
         (ReferenceNumber, LineAggregate) 
VALUES ('12345', 
'<JournalEntryLines>
<Row><LineType>Credit</LineType><LineAccount>Retained Earnings</LineAccount><LineAmount>100</LineAmount></Row>
<Row><LineType>Credit</LineType><LineAccount>Note Payable - Bank of Anycity</LineAccount><LineAmount>20</LineAmount></Row>
<Row><LineType>Debit</LineType><LineAccount>Checking</LineAccount><LineAmount>120</LineAmount></Row>
</JournalEntryLines>')

To insert subitems, set the ItemName field to the FullName of the item; for example, '<Row><ItemName>Subs:Carpet</ItemName><ItemQuantity>0</ItemQuantity></Row>'

To delete a JournalEntry, simply perform a DELETE statement and set the Id equal to the JournalEntryId you wish to delete. For example:

DELETE FROM JournalEntries WHERE Id = '16336-1450191232'

Columns


Name	Type	ReadOnly	References	Description
ID [KEY]	String	True		The unique identifier for the journal entry.
ReferenceNumber	String	False		The transaction reference number.
TxnNumber	Integer	True		The transaction number. An identifying number for the transaction, different from the Reckon-generated Id.
Date	Date	False		The transaction date. If it is set in the WHERE clause of a SELECT query, the pseudo columns StartDate and EndDate are overwritten with the value.
CreditLineCount	Integer	False		Number of credit lines.
DebitLineCount	Integer	False		Number of debit lines.
FirstCreditAccount	String	False	Accounts.FullName	The first credit account associated with the JournalEntry.
FirstCreditAmount	Double	False		The first credit amount associated with the JournalEntry.
FirstCreditMemo	String	False		The first credit memo associated with the JournalEntry.
FirstCreditEntityName	String	False		The first credit entity name associated with the JournalEntry.
FirstCreditEntityId	String	False		The first credit entity id associated with the JournalEntry.
FirstDebitAccount	String	False	Accounts.FullName	The first debit account associated with the JournalEntry.
FirstDebitAmount	Double	False		The first debit amount associated with the JournalEntry.
FirstDebitMemo	String	False		The first debit memo associated with the JournalEntry.
FirstDebitEntityName	String	False		The first debit entity name associated with the JournalEntry.
FirstDebitEntityId	String	False		The first debit entity id associated with the JournalEntry.
LineAggregate	String	False		An aggregate of the credit lines and debit ines data which can be used for adding a journal entry and its line item data.
EditSequence	String	False		An identifier used for versioning for this copy of the object.
TimeModified	Datetime	False		When the journal entry was last modified.
TimeCreated	Datetime	False		When the journal entry was created.

Pseudo-Columns

Pseudo Column fields are used in the WHERE clause of SELECT statements and offer a more granular control over the tuples that are returned from the data source.