Pipe Delimited General Journal Entry Interface
Issue/Symptom/Question
Please provide an example of a text file to import non-labor costs into PENTA.
Applies To
PENTA for Windows
Pipe-delimited General Journal Entry Interfacing
Resolution/Fix/Answer
Example Pipe-delimited Journal Entry charging a job file:
1|JE|3|20191231|20191231|||
2||Journal Entry|718|6010||||-3200|||||
2|718|Journal Entry|||71864|M|1234568|3200||||| LINE_ITEM_NUM =10||||||
Use the General Journal Interface to load general ledger entries using data from external applications. Information you load using this interface adds to or updates the data already stored in PENTA.
This interface lets you:
- Interface journal entries for jobs, work orders, equipment and fixed assets whose OUs you are authorized for
- Associate a cash account number with a cash related journal entry
Data files you load must have Request Types assigned to the J Interface Type.
The following System Options affect interfaced records:
- 107 (Prevent Inter_BS Entries) - if set to Y, transactions for one balance sheet only can be included in the journal entry.
- 125 (Mark Batch for Distribution) controls whether PENTA automatically distributes the batches.
- 128 (Reject Interface File on Error) whether PENTA rejects a batch when errors exist in the file.
Processing
Only if the following is true will PENTA attempt to process the Detail Records and distribute the batch (Header Record and associated Detail Records):
- The record count equals the number counted by PENTA during processing.
- The batch is in balance. PENTA generates an exception message that states the amount the batch is out of balance, but the interface program cannot identify the exact transaction that is incorrect.
- The currency for all distributions within the batch is the same.
- The batch affects no more than two balance sheets. If System Option 107 is Y, you can only use one balance sheet. If a batch impacts more than two balance sheets, PENTA does not process it.
- The journal number is unique. If the journal number is not unique, PENTA does not process the batch.
Where to View Loaded Data
If System Option 125 is set to N, you can view and modify records in the Journal Entry window. PENTA creates the batch in the Journal Entry window so you can update, delete, or release the batch.
General Journal Header Record
Each interface file should consist of one Header Record and one or more Detail Records. PENTA uses the information defined within the Header Record to validate the content of the interface file. If any header field fails validation, PENTA rejects the header and associated Detail Records.
The following fields are part of the Header Record.
General Journal Interface: Header Fields | ||||
---|---|---|---|---|
# | Field | Entry | Format | Description |
1 | Record Type | Req | I 1 | Record Type 1 identifies the record as a Header Record. |
2 | Identifier | Req | C! 3 | Request Type code assigned to the J (Journal Entry) Interface Type. |
3 | Record Count | Req | I 10 | Each batch includes a count of the records (header and detail) within the file. If the number in the Header Record differs from the number read by PENTA, no update occurs and PENTA rejects the entire file. You must manually correct and resubmit the file. |
4 | Distribution Date | Req | D | Identifies the date on which the batch is distributed. |
5 | Journal Number | Req | C! 8 | This is a file integrity check. The Batch Number must be unique within PENTA. |
6 | Balance Sheet OU Id | Opt | X | If this field contains a value, all Detail Records must be set up in the Organization Unit table to share this balance sheet OU. |
7 | Description | Opt | C 30 | From sub-system—for reference only. PENTA does not use this field. |
General Journal Detail Record
Detail record(s) identify the data that is to be added, deleted, or modified.
The following fields are part of the Detail record.
General Journal Interface: Detail Fields | ||||
---|---|---|---|---|
# | Field | Entry | Format | Description |
1 | Record Type | Req | I 1 | Record Type 2 identifies the record as a Detail Record. |
2 | Balance Sheet OU Id | Opt | X | If this field contains a value, it must be an OU that is shared with the one identified in the Header Record. |
3 | Description | Opt | C 30 | Description of charge. |
4 | OU Id | Opt | X | Required if an Account Number exists; otherwise, do not enter a value. |
5 | Account Number | Opt | X | General ledger account number associated to the charge. Required if Job Id and Fixed Asset Id are null; otherwise, do not enter a value. |
6 | Job Id | Opt | X | The job associated with the general ledger transaction. Required if Account Number and Fixed Asset Id are null; otherwise, do not enter a value. |
7 | Cost Type Code | Opt | C! 4 | The Cost Type associated with the general ledger transaction. Enter a valid value for the Job Id. Required if Job Id is not null; otherwise, do not enter a value. |
8 | Costcode | Opt | X | The Costcode associated with the general ledger transaction. Enter a valid value for the Job/Cost Type. Required if Job Id is not null; otherwise, do not enter a value. |
9 | Amount | Req | F 12.2 | The charge associated with the general ledger transaction. The amount may be positive or negative but not zero. For a negative amount, you must place the minus sign immediately in front of the value (-43.21). |
10 | Cash Account # | Opt | I 3 | Can be included if the account is not null and the edit rule for the account is CASH. Must be a valid cash account number previously linked to the general ledger account. |
11 | Fixed Asset Id | Opt | X | Required if Job ID and OU ID are null; otherwise, do not enter a value. Enter a valid Fixed Asset Id. |
12 | Expense Category # | Opt | I 3 | Required if there is a Fixed Asset ID; otherwise, do not enter a value. Enter a valid expense category for the Fixed Asset Id’s Asset Class. |
13 | Hours | Opt | F 12.3 | The hours associated with the journal entry |
Optional Detail Fields (place after Field 13) | ||||
Field | Format | Description | ||
LINE_ITEM_NUM | C! 1 | Determines whether this Journal entry batch posts against the Contract Information Line Item contract value. | ||
CO_ID | X | Determines whether this Journal entry batch posts against the Contract Change Order contract value. | ||
WO_ID | C! 25 | The work order associated with the general journal transaction. You must enter a value if Account Number, Job Id, and Fixed Asset Id are null. | ||
WO_TASK_ID | C! 10 | Id of the Task associated with the general journal transaction. | ||
MAINT_CONTRACT_ ID | C! 15 | Id of the Maintenance Contract associated with this general journal transaction. | ||
TRANX_REF_ID | C 15 | PENTA marks job cost and billing transactions within the interface files with this Transaction Reference Id. This enables your external application to perform functions (e.g., billing and profit analysis) by whatever grouping this Id represents. |