Accounts Payable Interface: Pipe Delimited Method
Use the Accounts Payable Interface to load invoice data from external applications. Information you load using this interface adds to the data already stored in PENTA.
The Accounts Payable Interface has a Request Type of AP and an Interface Type of A. Data files you load must have Request Types assigned to the A Interface Type.
After performing several high-level integrity tests, PENTA attempts to process the Detail Records only if the following is true:
The Batch Number matches the file name.
The record count of the header equals the number of Detail Records.
The User Id is a valid PENTA user.
If PENTA rejects the entire file, you can modify and re-submit it.
Each Accounts Payable interface file constitutes one batch. PENTA processes interface batch files in the order that you originally enter them in the Initiate Batch Interface Requests window. You should enter requests in chronological order by creation date, so that a batch (which depends on previous invoices being distributed) processes only after PENTA has processed and committed previous or historical batches.
PENTA validates and accepts DOC (document) records for processing or rejects them along with all associated JOB, ACCT, FA, PO, WO, CREF, TAX, EAR, and SC records. If PENTA accepts a DOC record, it validates and either accepts the associated records for processing or rejects the associated records on a record-by-record basis. If PENTA rejects a record, you cannot resubmit the file because a batch already exists for the file name and file type.
Since you perform the batch balance and document balance in the Invoice and Credit Memo Entry window, the batch totals do not have to equal the sum of the document totals, and the distribution totals do not have to equal their associated document total.
After interfacing records, you can review and correct them as needed in the Invoice & Credit Memo Entry window.
Template:
Available Records
- 1 Account (ACCT) Detail Record
- 2 Customer Reference (CREF) Detail Record
- 3 Document (DOC) Detail Record
- 4 Document Hold (HOLD) Detail Record
- 5 Employee Advance Receivable (EAR) Detail Record
- 6 Fixed Asset (FA) Detail Record
- 7 Accounts Payable Header Record
- 8 Job (JOB) Detail Record
- 9 Purchase Order (PO) Detail Record
- 10 Subcontract (SC) Detail Record
- 11 Tax (TAX) Detail Record
- 12 Work Order (WO) Detail Record
A Note About Detail Records
All Detail Records have a set of common fields at the beginning of the record. PENTA first performs validation independent of the type of Detail Record as defined in the table below. If AP Interface Record Type is a recognized code, PENTA performs record-type-specific validation on the record’s remaining fields. PENTA does not perform additional edit checks if the field is blank or null, unless the check specifically requires that the field be valued under certain conditions.
The Record Type identifies the scope of the data involved, which helps you find and correct errors.
Note: If a DOC Detail Record has an invalid field, PENTA rejects that DOC and all associated ACCT, FA, JOB, PO, WO, CREF, TAX, EAR, and SC Detail Records. The entire file is not rejected, just that invoice.
Account (ACCT) Detail Record
|
Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be ACCT. |
4 | OU Id | Req | X | This must be an active general ledger account. The default is the AP OU Id from the DOC record. The User Id must have authorization for this OU. If System Option 107 is Y, this OU must be the AP OU Id from the DOC record. |
5 | GL Account Number | Req | X | This must be an active account with an edit rule of AR, Cash, or no edit rule. If the account’s edit rule is AR or Cash:
If System Option 44 is Y and the account’s currency is not equal to the Source Currency Id from the DOC record, an exchange rate must exist for the two currencies. |
6 | Distribution Description | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the DOC record. |
7 | Distribution Amount | Req | F 15.2 | Enter a value other than zero. |
8 | Exchange Rate | Opt | F 12.6 | Must be greater than zero. Required if System Option 44 is Y; otherwise, do not enter a value. The default is the exchange rate between the Source Currency Id and the GL Account Number’s currency. If that rate does not exist, the default is 1.0. If the GL Account Number’s currency is the same as the Source Currency Id, this field must be 1.0. |
9 | Customer Id | Opt | X | This must be an active customer. Required if the GL Account Number has an edit rule of AR; otherwise, do not enter a value. |
10 | Week Ending Date | Opt | D | Required if the GL Account Number has an edit rule of AR, the Customer Id is an employee, and System Option 105 is Y; otherwise, do not enter a value. |
11 | Check Form Id | Opt | C! 8 | The default is the Form Id of the following:
System Option notes:
|
12 | AP Account Number | Opt | X | This must be an active account with an edit rule of AP. System Option notes:
|
13 | Reference Job Id | Opt | X | A job related to the Job Id. This does not have to be a parent, child, or active job. |
14 | Tax Exempt Reason Code | Opt | C! 3 | The defaults are:
If System Option 152 is N, this must be blank or null. PENTA stores the default, but the document reason code overrides the distribution reason code. You cannot manually override it. If Tax Exempt Reason Code in the DOC record has a value, this field must use the default. |
15 | Tax Exempt Certificate Id | Opt | C 15 | The default is the GL Account Number tax certificate. If System Option 152 is N, this field must be blank or null. PENTA stores the default, but the document certificate overrides the distribution certificate. You cannot manually override it. If the Tax Exempt Certificate Id in the DOC record has a value, this field must use the default. |
16 | Earnings Code | Opt | C 3 | The 1099 Earnings Code PENTA associates with the invoice detail distribution. |
17 | State Code | Opt | C 4 | The 1099 State Code PENTA associates with the invoice detail distribution. |
Optional ACCT Detail Fields (place after Field 17)
Field | Format | Description | ||
---|---|---|---|---|
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. | ||
CASH_ACCT_NUM | Opt | Account # of the Cash Account. Required if the GL Account # has an edit rule of Cash; otherwise, do not enter a value. Cash Account must have the same GL account as entered in the GL Account # field. The cash account’s OU Id must have the same BS OU as the account on the OU ID field. |
Customer Reference (CREF) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be CREF. |
4 | Customer Reference Code | Req | C 15 | Code referring to Customer specific information. |
5 | Customer Reference Format | Opt | C 30 | The value for the associated Reference Code. |
Document (DOC) Detail Record
Note: If a DOC Detail Record has an invalid field, PENTA rejects that DOC and all associated ACCT, FA, JOB, PO, WO, CREF, TAX, EAR, and SC Detail Records. The entire file is not rejected, just that invoice.
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record |
2 | Invoice Number | Req | C! 15 | The invoice number must be unique. If the Invoice Number and Vendor Id match an invoice with a void status of Y, PENTA rejects this invoice (DOC and all associated ACCT, FA, JOB, PO, WO, CREF and TAX records). |
3 | Record Type | Req | C! 5 | The value should be DOC. |
4 | AP OU Id | Req | X | This must be an active balance sheet OU. The User Id in the Header Record must have authorization for this OU. PENTA will not verify OU authorization until a user tries viewing the batch in the Accounts Payable windows. The default is the OU of the user (User Id). |
5 | Vendor Id | Opt | X | The Vendor Id associated with the invoice. This must be a vendor with an “Active” or “Hold” status. The Vendor Type cannot be Miscellaneous* and the Vendor Class must be set up as a supplier. The default is the vendor associated with the user (User Id). Either enter this value or an Employee Id, not both. A value in either field is required. If System Option 109 is Y, the Vendor Id cannot be the same as the Vendor Id assigned to the AP OU. *This is a limitation specific to the interface and you can eliminate once you add the ability to specify new vendor addresses. |
6 | Employee Id | Opt | X | Default is the employee associated with the Vendor Id. Either enter this value or a Vendor Id, not both. A value in either field is required. |
7 | Invoice Amount | Req | F 15.2 | Amount on the invoice. |
8 | Invoice Date | Req | D | The invoice date must be less than or equal to a year from the current processing date (a year in the future). If this field is null and System Option 20 is Y, PENTA uses the system date. |
9 | Posting Date | Opt | D | The date must be less than or equal to a year from the current processing date (a year in the future). The default is the invoice date. The date must be within an open accounting period for the Accounts Payable OU. |
10 | Payment Terms | Opt | I 3 | The default is the vendor’s payment terms. Optionally, enter a Proximo date for the following conditions:
PENTA compares the invoice date to the cutoff day to determine which discount date and due date apply to the invoice. The payment month indicator tells PENTA whether the discount and/or due dates are in the same month as the invoice date, or in the month following the invoice date. |
11 | Discount Percent | Opt | F 6.3 | Must be between 0.001 and 100.000 percent. The default is the discount percent associated with the Payment Terms. If this field has a value, the Discount Amount must be blank. |
12 | Discount Amount | Opt | F 15.2 | Must be the same sign (+ or –) as Invoice Amount and less than the Invoice Amount. If this field has a value, the Discount Percent field must be blank. |
13 | Retention Percent | Opt | F 6.3 | Must be between 0.001 and 100.000 percent. If this field has a value, the Retention Amount field must be blank. |
14 | Retention Amount | Opt | F 15.2 | Must be the same sign (+ or –) as the Invoice Amount and less than the Invoice Amount. If this field has a value, the Retention Percent field must be blank. |
15 | Units | Opt | F 12.3 | The total units on the invoice. |
16 | Pay Request Number | Opt | C 15 | If System Option 148 is Y, the Pay Request Number must be in digits (rather than characters). |
17 | Invoice Type | Opt | C! 3 | The value should be REG. The default is REG. |
18 | Remit To Address Number | Opt | I 5 | Default is the Vendor’s remit-to address. Note: The vendor type cannot be Miscellaneous. PENTA does not support Miscellaneous vendor types with the accounts payable interface. Required if System Option 77 is Y; otherwise, do not enter a value. |
19 | Source Currency Id | Opt | C! 3 | Default is the Vendor’s currency. If the vendor does not have an assigned currency, PENTA uses the currency of the AP OU Id. Required if System Option 44 is Y; otherwise, do not enter a value. |
20 | Check Form Id | Opt | C! 8 | Default is the Source Currency’s Form Id. The User Id must have authorization to use this Check Form. Entry is required if System Option 75 is 3; otherwise, do not enter a value. If System Option 155 is Y, the Check Form type can be AP or GN. If System Option 155 is N, the Check Form type must be AP. If System Option 44 is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
21 | Tax Amount | Opt | F 15.2 | The amount of taxes for the invoice. If System Option 152 is N, do not enter a value. If System Option 271 is Y, PENTA records the sales tax amounts you enter on an AP invoice as sales tax for jurisdictions associated with the AP invoice distribution. Individual AP Invoice distributions are determined to be taxable or non-taxable (based on a purchase order’s set up, based on the Job an invoice is charged to, based on the OU/Account, etc.). PENTA will require that at least one AP invoice distribution is taxable; otherwise, PENTA issues an error message and prevents the user from entering the vendor’s invoice with a sales tax amount. You record sales tax charged by a vendor as a lump sum amount, PENTA does not require that you break down the sales tax amount by taxing jurisdiction when recording the vendor’s invoice. Therefore, PENTA must allocate the sales tax amount across the tax jurisdictions that are associated with distributions entered on the AP document (State, City, etc.):
PENTA sales & use tax reporting will provide detail reporting by sales tax jurisdiction those amounts paid as sales tax plus accruals made where a vendor did not charge tax in a taxable situation or where the amount of tax charged by the vendor does not agree with the sales tax rules defined for each jurisdiction. |
22 | Tax Exempt Reason Code | Opt | C! 3 | Must be a valid reason code. Required if System Option 152 is Y and no tax jurisdictions exist for Vendor Id and the postal code associated with that vendor’s remit-to address number; otherwise, do not enter a value. |
23 | Tax Exempt Certificate Id | Opt | C 15 | If System Option 152 is N, do not enter a value. |
24 | Payment Cycle # | Opt | I 3 | Id of the cycle you want to pay the invoice with. This helps in selecting items for payment. |
Optional Doc Detail Fields (place after Field 24)
Field | Format | Description | ||
---|---|---|---|---|
D_DUE_DATE | D | DUE_DATE=YYYY/MM/DD Note: YYYY = Year, MM = Month, DD = Day. This field must be entered as Field Name =Date. Example: DUE_DATE=2004/01/30 | ||
D_DSCNT_DATE | D | DSCNT_DATE=YYYY/MM/DD Note: YYYY = Year, MM = Month, DD = Day. This field must be entered as Field Name =Date. Example: DSCNT_DATE=2004/01/30. Must have a discount date if the Vendor has no payment terms set up and you enter a discount %. | ||
ST_WH_PCT | F 8.5 | The percent to withhold for the state. Must be non-zero or null. You can only enter this field if the FORM_1099_ST_CD has a valid value. | ||
ST_WH_VEN_ID | X | The vendor that receives the state withholding. Required if a State Withholding Percent exists; otherwise, do not enter a value. | ||
ST_WH_ACCT_NUM | X | The accrual account for the state withholding. Required if a State Withholding Percent exists; otherwise, do not enter a value.. | ||
FED_WH_PCT | F 8.5 | The percent to withhold for Federal withholding. Entries must be non-zero or null. | ||
FED_WH_VEN_ID | X | The vendor that receives the federal withholding. Required if a Federal Withholding Percent exists; otherwise, do not enter a value.. | ||
FED_WH_ACCT_NUM | X | The accrual account for the federal withholding. Required if a Federal Withholding Percent exists; otherwise, do not enter a value.. | ||
FREIGHT_AMT | F 15.2 | FREIGHT_AMT=xxxxx PENTA only uses Freight Amount to determine the Invoice Basis Amount. | ||
TRANX_REF_ID | C! 15 | PENTA marks job cost and billing transactions within the interface files with this Transaction Reference Id so your external application can perform functions (e.g., billing and profit analysis) by whatever grouping this Id represents. | ||
WH_ST_CD | C 4 | Id of the Withholding State. | ||
MISC_VEN_ADDR_ NAME | C! 30 | MISC_VEN_ADDR_NAME=XXXX, where XXXX is the Vendor Name in the address block. Enter this as Field Name =Name. Example: VEN_ADDR_NAME =Acme Supply You can enter this for any type vendor. | ||
MISC_VEN_ADDR_1 | C! 30 | MISC_VEN_ADDR_1=XXXX, where XXXX is the Address in line 1 of the address block. Enter this as Field Name =Address 1. Example: MISC_VEN_ADDR_1=123 Any Street | ||
MISC_VEN_ADDR_2 | C! 30 | MISC_VEN_ADDR_2=XXXX, where XXXX is the Address in line 2 of the address block. Enter this as Field Name =Address 2. Example: MISC_VEN_ADDR_2=PO Box 1234 | ||
MISC_VEN_ADDR_3 | C! 30 | MISC_VEN_ADDR_3=XXXX, where XXXX is the Address in line 3 of the address block. Enter this as Field Name =Address 3. Example: MISC_VEN_ADDR_3=C/O Accounts Payable Department | ||
MISC_VEN_CITY | C! 20 | MISC_VEN_CITY=XXXX, where XXXX is the City in the address block. Enter this as Field Name =City. Example: MISC_VEN_CITY =Brookfield Required if you entered a vendor address name; otherwise, do not enter a value. | ||
MISC_VEN_ST_CD | C! 4 | MISC_VEN_ST_CD=XX, where XX is the State in the address block. Enter this as Field Name =State. Example: MISC_VEN_ST_CD =WI | ||
MISC_VEN_POSTAL_CD | C! 10 | MISC_VEN_POSTAL_CD=XXXX(-XXX), where XXXX(-XXX) is the Postal Code in the address block. Enter this as Field Name =Postal Code. Example: MISC_VEN_POSTAL_CD =53188 Required if a vendor address name exists; otherwise, do not enter a value. | ||
MISC_VEN_COUNTRY_CD | C! 3 | MISC_VEN_COUNTRY_CD=XXXX, where XXXX is the Country in the address block. Enter this as Field Name =Country. Example: MISC_VEN_COUNTRY_CD =USA | ||
MISC_VEN_PHONE_AREA_CD | C! 3 | MISC_VEN_PHONE_AREA_CD=XXX, where XXX is the 3 digit phone number Area Code in the address block. Enter this as Field Name =Area Code. Example: MISC_VEN_PHONE_AREA_CD =262 | ||
MISC_VEN_PHONE_NUM | C! 11 | MISC_VEN_PHONE_NUM=XXXXXXX, where XXXXXXX is the 7 digit Phone number in the address block. Enter this as Field Name =Phone Number. Example: MISC_VEN_PHONE_AREA_CD =5740505. | ||
MISC_VEN_FAX_AREA_CD | C! 3 | MISC_VEN_FAX_AREA_CD=XXX, where XXX is the 3 digit Fax number Area Code in the address block. Enter this as Field Name =Area Code. Example: MISC_VEN_PHONE_AREA_CD =262 | ||
MISC_VEN_FAX_NUM | C! 11 | MISC_VEN_FAX_NUM=XXXXXXX, where XXXXXXX is the 7 digit Fax number in the address block. Enter this as Field Name =Phone Number. Example: MISC_VEN_FAX_AREA_CD =5741212. | ||
MISC_VEN_WWW_ADDR | C! 100 | MISC_VEN_WWW_ADDR=XXXX, where XXXX is the web address. Enter this as Field Name = web address. Example: MISC_VEN_WWW_ADDR=www.supplier.com. | ||
MISC_VEN_ADDL_CHECK_LINE_1 | C! 50 | MISC_VEN_ADDL_CHECK_LINE_1=XXXX, where XXXX is the line that prints below the vendor address on the AP check. Enter this as Field Name =Line 1 Information. Example: MISC_VEN_ADDL_CHECK_LINE_1=Attention: Ms. M. Berkly. | ||
MISC_VEN_ADDL_CHECK_LINE_2 | C! 50 | MISC_VEN_ADDL_CHECK_LINE_2=XXXX, where XXXX is the line that prints below the vendor address on the AP check. Enter this as Field Name =Line 2 Information. Example: MISC_VEN_ADDL_CHECK_LINE_2=Account #1234567. | ||
AP_STAT_CD | C! 1 | AP_STAT_CD=A or H. Indicates the Pay Status of the Invoice. Valid values are: A (Active & available for payment) and H (Hold upon distribution, not available for payment). |
Document Hold (HOLD) Detail Record
This interface will populate the Invoice & Credit Memo Entry window, unless the batch is immediately distributed. (System Option 125 (“Mark Batch for Distribution”) controls this.
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record |
2 | Invoice Number | Req | C! 15 | The invoice number must match the Invoice Number in the Document Record. |
3 | Record Type | Req | C! 5 | The value should be HOLD. |
4 | Hold Code | Req | C! 3 | Id of the Hold Reason currently against the Invoice. |
Employee Advance Receivable (EAR) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be EAR. |
4 | Amount Applied to Advance | Req | F 15.2 | Amount of the expense applied to an open employee advance. |
Fixed Asset (FA) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be FA. |
4 | Fixed Asset Id | Req | X | If Fixed Asset Id is not null, Fixed Asset Expense Category cannot be null. PENTA checks to insure the following are true:
|
5 | Expense Category | Req | I 3 | PENTA checks to insure that the expense category is active and associated with the asset’s class in the Classes window. |
6 | Distribution Description | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the INTR_AP_DOC record. If System Option 104 is N, there is no default. |
7 | Distribution Amount | Req | F 15.2 | Enter a value other than zero. |
8 | Exchange Rate | Opt | F 12.6 | Must be greater than zero. If the job’s currency is the same as the Source Currency Id, this field must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
9 | Check Form Id | Opt | C! 8 | Default is the Source Currency’s Form ID. The User ID must have authorization to use this Check Form. Required if System Option 75 is 3; otherwise, do not enter a value. If System Option 155 is Y, the Check Form type may be AP or GN. If System Option 155 is N, the Check Form type must be AP. If System Option 44 is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
10 | AP Account Number | Opt | X | This must be an active account with an edit rule of AP. If System Option 109 is Y, the default is the:
If System Option 44 is Y, the currency assigned to the account must equal the Source Currency from the INTR_AP_DOC record. If the account does not have a currency, then the currency of the job’s OU must equal the Source Currency from the INTR_AP_DOC record. The default is the AP account of the Source Currency Id. If System Options 109 and 44 are N, the default is the Job Type’s AP account number. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
11 | Tax Exempt Reason Code | Opt | C! 3 | The defaults are:
If System Option 152 is N, do not enter a value. If Tax Exempt Reason Code on the INTR_AP_DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the document reason code overrides the distribution reason code; you cannot manually override it. |
12 | Tax Exempt Certificate Id | Opt | C 15 | The defaults are:
If System Option 152 is N, do not enter a value. If the Tax Exempt Certificate Id on the INTR_AP_DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the Document certificate overrides the distribution certificate. You cannot manually override it. |
13 | Earnings Code | Opt | C 3 | The 1099 Earnings Code. |
14 | State Code | Opt | C 4 | The 1099 State Code. |
Optional FA Detail Field (place after Field 14)
Field | Format | Description | ||
---|---|---|---|---|
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. |
Accounts Payable Header Record
This information only applies if you are creating data files to be loaded using the Initiate Batch Interface Requests window.
Each interface file should consist of one Header Record, at least one DOC Detail Record, and one or more JOB, ACCT, FA, PO, WO, CREF, TAX, EAR, and SC Detail Records. PENTA uses the information defined in the Header Record to validate the content of the interface file. If a header field failed validation, PENTA rejects the header and associated Detail Records.
|
Field | Entry | Format | Description |
---|---|---|---|---|
1 | Identifier | Req | C! 3 | Request Type code assigned to the AP (Accounts Payable) Interface Type. |
2 | Record Count | Req | I 6 | Each batch includes a count of the records (header and detail) within the file. This must be greater than zero. If the number in the Header Record differs from the number read by PENTA, no update occurs and PENTA rejects the entire file. |
3 | Batch Number | Req | I 9 | The filename of the AP interface data file. PENTA will not process the batch if another batch exists with the same number and User Id. |
4 | Total Invoice Amount | Req | F 15.2 | The total amount of all invoices in this batch (file). PENTA uses this amount to determine if the batch is in balance when viewed in the Accounts Payable windows. |
5 | Total Units | Opt | F 12.3 | The total number of units of all invoices in this batch (file). PENTA uses this number to determine if the batch is in balance when viewed in the Accounts Payable windows. |
6 | User Id | Req | C! 6 | The user who views, edits, and distributes the batch. This does not have to be the same as the user who loads the interface file. If no User Id exists, PENTA rejects the entire file. |
Optional Header Fields (place after Field 6)
Field | Format | Description | ||
---|---|---|---|---|
DEF_CHK_FORM_ID | C! 8 | Document tab’s default Check Form. You establish the overriding default in the Organizational Unit or Currency Information window. Default Check Forms entered in the Vendor Information window override this default. | ||
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. |
Job (JOB) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be JOB. |
4 | Job Id | Req | X | Enter an active job. If System Option 69 is Y, the job cannot be closed as of the Posting Date. If System Option 44 is Y and the job’s currency is not the same as the Source Currency Id, there must be an exchange rate between the two currencies. If System Option 107 is Y and the job OU Id is the same as the balance sheet OU Id, the balance sheet OU Id must be the same as the AP OU Id in the DOC Detail Record. |
5 | Cost Type Code | Req | C! 4 | Must be an active Cost Type associated with the job, and the Cost Type’s All OU code must be A, or the OU associated with the Cost Type is the same as the job’s OU. |
6 | Costcode | Req | X | Must be an active Costcode. If Costcode validation for the Job Id is Y, this must be a valid Costcode for the job. |
7 | Item Number | Opt | I 15 | If System Option 22 is 2, PENTA refers to the Item Number as Tag Number in error messages. If System Option 122 is Y, the Item Number must be associated with the job. |
8 | Distribution Description | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the DOC record. If System Option 104 is N, there is no default. |
9 | Distribution Amount | Req | F 15.2 | Enter a value other than zero. |
10 | Units | Opt | F 12.3 | The number of units used on the job. Enter a value greater than zero. |
11 | Pay Request Number | Opt | C 15 | The default is the DOC record’s Pay Request Number. Required if System Option 87 is Y, and System Option 124 is 16, 20, 24, or 28; otherwise, do not enter a value. If System Option 148 is Y, Pay Request Number must be in digits (rather than characters). |
12 | Exchange Rate | Opt | F 12.6 | Must be greater than zero. If the job’s currency is the same as the Source Currency Id, this field must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
13 | Check Form Id | Opt | C! 8 | The default is the Form Id of the following:
Required if System Option 75 is 2; otherwise, do not enter a value. If System Option 155 is Y, the Check Form type may be AP or GN. If System Option 155 is N, the Check Form type must be AP. If System Option 44 is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
14 | AP Account Number | Opt | X | This must be an active account with an edit rule of AP. If System Option 109 is Y, the default is the:
If System Option 44 is Y, the currency assigned to the account must equal the Source Currency from the DOC record. If the account does not have a currency, then the currency of the job’s OU must equal the Source Currency from the DOC record. The default is the AP account of the Source Currency Id. If System Options 109 and 44 are set to N, the default is the Job Type’s AP account number. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
15 | Tax Exempt Reason Code | Opt | C! 3 | The defaults are:
If System Option 152 is N, do not enter a value. If Tax Exempt Reason Code on the DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the document reason code overrides the distribution reason code; you cannot manually override it. |
16 | Tax Exempt Certificate Id | Opt | C 15 | The defaults are:
If System Option 152 is N, this field must be blank or null. If the Tax Exempt Certificate Id on the DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the document certificate overrides the distribution certificate. You cannot manually override it. |
17 | Earnings Code | Opt | C 3 | 1099 Earnings Code |
18 | State Code | Opt | C 4 | 1099 State Code |
Optional JOB Detail Field (place after Field 18)
Field | Format | Description | ||
---|---|---|---|---|
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. |
Purchase Order (PO) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be PO. |
4 | OU Id | Req | X | The OU assigned to the purchase order |
5 | Purchase Order Number | Req | X | Id of the purchase order. |
6 | Vendor Product Id | Opt | C 26 | Id of the vendor’s product. |
7 | Line Number | Req | I 9 | The line number of the purchase order. PENTA allows the Purchase Order and Line Number to be Work Order related. |
8 | Job Id | Opt | X | Enter an active job. If System Option 69 is Y, the job cannot be closed as of the Posting Date. If System Option 44 is Y and the job’s currency is not the same as the Source Currency Id, there must be an exchange rate between the two currencies. If System Option 107 is Y and the job OU Id is the same as the balance sheet OU Id, the balance sheet OU Id must be the same as the AP OU Id in the DOC Detail Record. |
9 | Cost Type Code | Opt | C! 4 | Must be an active Cost Type associated with the job, and the Cost Type’s All OU code must be A, or the OU associated with the Cost Type is the same as the job’s OU. |
10 | Costcode |
| X | Enter an active Costcode. If Costcode validation for the Job Id is Y, this must be a valid Costcode for the job. |
11 | Debit OU Id | Opt | X | Id of the organizational unit where the expense was charged. |
12 | Debit Account Number | Opt | X | Id of the account debited for the transaction. |
13 | Fixed Asset Id | Opt | X | If Fixed Asset Id is not null, Fixed Asset Expense Category cannot be null. PENTA checks to ensure:
|
14 | Expense Category | Opt | I 3 | PENTA checks to insure that the expense category is active and associated with the asset’s class in the Classes window. |
15 | Distribution Description | Req | C 30 | The default is the description from the Purchase Order Line Number. |
16 | Units | Opt | F 12.3 | The total units for the purchase order line. |
17 | Unit Price | Opt | F 12.3 | The per-unit billing rate for the Product. |
18 | Distribution Amount | Req | F 15.2 | Enter a value other than zero. |
19 | Pay Request Number | Opt | C 15 | The default is the Pay Request Number from the DOC record. Required if System Option 87 is Y, and System Option 124 is 4, 12, 20, or 28; otherwise, do not enter a value. If System Option 148 is Y, Pay Request Number must be in digits (rather than characters). |
20 | Exchange Rate | Opt | F 12.6 | Enter a value greater than zero. If the job’s currency is the same as the Source Currency Id, this field must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
21 | Check Form Id | Opt | C! 8 | The default is the Form Id of the following:
Required if System Option 75 is 2; otherwise, do not enter a value. If System Option 155 is Y, the Check Form type may be AP or GN. If System Option 155 is N, the Check Form type must be AP. If System Option 44 is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
22 | AP Account Number | Req | X | This must be an active account with an edit rule of AP. If System Option 109 is Y, the default is the:
If System Option 44 is Y, the currency assigned to the account must equal the Source Currency from the DOC record. If the account does not have a currency, then the currency of the job’s OU must equal the Source Currency from the DOC record. The default is the AP account of the Source Currency Id. If System Options 109 and 44 are set to N, the default is the Job Type’s AP account number. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
23 | Tax Exempt Reason Code | Opt | C! 3 | The defaults are:
If System Option 152 is N, do not enter a value. If Tax Exempt Reason Code on the INTR_AP_DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the document reason code overrides the distribution reason code; you cannot manually override it. |
24 | Tax Exempt Certificate Id | Opt | C 15 | The defaults are:
If System Option 152 is N, do not enter a value. If the Tax Exempt Certificate Id on the INTR_AP_DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the Document certificate overrides the distribution certificate. You cannot manually override it. |
25 | Earnings Code | Opt | C 3 | 1099 Earnings Code |
26 | State Code | Opt | C 4 | 1099 State Code |
Optional PO Detail Fields (place after Field 26)
Field | Format | Description | ||
---|---|---|---|---|
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. | ||
WO_ID | C! 25 | Id of the Work Order. | ||
WO_OU_ID | X | Id of the Work Order Organizational Unit. | ||
WO_COST_TYPE_CD | C! 4 | Id of the Work Order Cost Type. | ||
WO_CUS_LOC_CD | C 8 | Id of the Work Order Customer Location. | ||
WO_CUS_EQ_ID | C! 15 | Id of the Work Order Customer Equipment. | ||
WO_TASK_ID | C! 10 | Id of the Work Order Task. | ||
WO_FA_ID | X | Id of the Work Order Fixed Asset. | ||
WO_FA_EXP_CAT_ NUM | I 3 | Id of the Work Order Fixed Asset Expense Category. | ||
WO_MAINT_SCHD_ NUM | I 6 | Id of the Work Order Maintenance Schedule. | ||
WO_MAINT_ CONTRACT_ID | C! 15 | Id of the Work Order Maintenance Contract. | ||
RET_AMT | F 15.2 | The Retention Amount. |
Subcontract (SC) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be SC. |
4 | Job Id | Req | X | The Job Id. |
5 | SC Number | Req | X | The Subcontract Number. |
6 | SC Line Number | Req | I 9 | The Subcontract Line Number. |
7 | Distribution Description | Req | C 30 | The default is the description from the Subcontract Line Number. |
8 | Distribution Amount | Req | F 15.2 | The Distribution Amount. |
9 | Units | Opt | F 12.3 | The number of Units for the line item. |
10 | Unit Price | Opt | F 12.3 | The Unit Price for the line item. |
11 | Retention Amount | Opt | F 15.2 | The Retention applied against all invoices entered for the Subcontract and line item. |
12 | Pay Request Number | Opt | C 15 | The default is the Pay Request Number from the DOC record. Required if System Option 87 is Y, and System Option 124 is 8, 12, 24, or 28; otherwise, do not enter a value. If System Option 148 is Y, Pay Request Number must be in digits (rather than characters). |
13 | Exchange Rate | Opt | F 12.6 | Must be greater than zero. If the job’s currency is the same as the Source Currency Id, this field must be 1.0. Entry is required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
14 | Check Form Id | Opt | C! 8 | The default is the Form Id of the following:
Entry is required if System Option 75 is 2; otherwise, do not enter a value. If System Option 155 is Y, the Check Form type may be AP or GN. If System Option 155 is N, the Check Form type must be AP. If System Option 44 is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
15 | AP Account Number | Req | X | This must be an active account with an edit rule of AP. If System Option 109 is Y, the default is the:
If System Option 44 is Y, the currency assigned to the account must equal the Source Currency from the DOC record. If the account does not have a currency, then the currency of the job’s OU must equal the Source Currency from the DOC record. The default is the AP account of the Source Currency Id. If System Options 109 and 44 are N, the default is the Job Type’s AP account number. If System Option 89 is Y and the user type is not H (home office), this field must be blank or null. |
16 | 1099 Earnings Code | Opt | C 3 | 1099 Earnings Code |
17 | 1099 State Code | Opt | C 4 | 1099 State Code |
Optional SC Detail Field (place after Field 17)
Field | Format | Description | ||
---|---|---|---|---|
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. |
Tax (TAX) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be TAX. |
4 | Tax Jurisdiction Id | Req | C 10 | Id of the Tax Jurisdiction. |
5 | Consol Tax Rate | Opt | F 6.3 | Consolidated rate for sales and use tax. |
6 | Sales Tax Rate | Opt | F 6.3 | Rate for sales tax. |
7 | Use Tax Rate | Opt | F 6.3 | Rate for use tax. |
Work Order (WO) Detail Record
# | Field | Entry | Format | Description |
---|---|---|---|---|
1 | Batch Number | Req | I 9 | Must match the Batch Id in the Header Record. |
2 | Invoice Number | Req | C! 15 | The Invoice Number from the DOC record. |
3 | Record Type | Req | C! 5 | The value should be WO. |
4 | Work Order Id | Req | C 25 | Id of the Work Order. |
5 | OU Id | Req | X |
|
6 | Cost Type Code | Req | C! 4 | Must be an active Cost Type associated with the WO, and the Cost Type’s All OU code must be A, or the OU associated with the Cost Type is the same as the WO’s OU. |
7 | Customer Location Code | Opt | C 8 | Id of the Customer Location. |
8 | Customer Equipment Id | Opt | C! 15 | Id of the Customer Equipment associated with the Work Order. |
9 | Task Id | Opt | C! 10 | Id of the Task associated with the Work Order. |
10 | Fixed Asset Id | Opt | X | PENTA checks to insure the following:
|
11 | FA Expense Category | Opt | I 3 | PENTA checks to insure that the expense category is active and associated with the asset’s class in the Classes window. If there is a fixed asset value, you must enter an expense category. |
12 | Maintenance Schedule Number | Opt | I 6 | Id of the Maintenance Schedule. |
13 | Maintenance Contract Id | Opt | C! 15 | Id of the Maintenance Contract. |
14 | Distribution Description | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the INTR_AP_DOC record. If System Option 104 is N, there is no default. |
15 | Distribution Amount | Req | F 15.2 | Enter a value other than zero. |
16 | Exchange Rate | Opt | F 12.6 | Must be greater than zero. If the job’s currency is the same as the Source Currency Id, this field must be 1.0. Entry is required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
17 | Check Form Id | Opt | C! 8 | The default is the Form Id of the following:
Entry is required if System Option 75 is 2; otherwise, do not enter a value. If System Option 155 is Y, the Check Form type may be AP or GN. If System Option 155 is N, the Check Form type must be AP. If System Option 44 is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89 is Y and the user type is not H (home office), do not enter a value. |
18 | AP Account Number | Opt | X | This must be an active account with an edit rule of AP. If System Option 109 is Y, the default is the:
If System Option 44 is Y, the currency assigned to the account must equal the Source Currency from the INTR_AP_DOC record. If the account does not have a currency, then the currency of the WO’s OU must equal the Source Currency from the INTR_AP_DOC record. The default is the AP account of the Source Currency Id. If System Option 89 is Y and the user type is not H (home office), this field must be blank or null. |
19 | Tax Exempt Reason Code | Opt | C! 3 | The defaults are:
If System Option 152 is N, this field must be blank or null. If Tax Exempt Reason Code on the INTR_AP_DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the document reason code overrides the distribution reason code; you cannot manually override it. |
20 | Tax Exempt Certificate Id | Opt | C 15 | The defaults are:
If System Option 152 is N, this field must be blank or null. If the Tax Exempt Certificate Id on the INTR_AP_DOC record has a value, this field must be one of the defaults. The default is stored in PENTA, but the Document certificate overrides the distribution certificate. You cannot manually override it. The tax Certificate should default as follows:
|
21 | Earnings Code | Opt | C 3 | 1099 Earnings Code |
22 | State Code | Opt | C 4 | 1099 State Code |
Optional WO Detail Fields (place after Field 22)
Field | Entry | Description | ||
---|---|---|---|---|
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. | ||
UNITS | F 12.3 | Quantifies the work order units associated with this purchase. |