Accounts Payable Interface: Table Driven 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.
PENTA accepts data:
Regardless of whether the batch is in balance. PENTA notifies you if the batch is not in balance in the Invoice and Credit Memo Entry window.
If the currency for all distributions in the batch is the same.
If the batch number is unique for the User Id assigned to the batch, and the User Id is a valid PENTA User Id.
If PENTA is unable to load an individual row, it bypasses that invoice (or line item) and moves on to the next. It creates or updates invoices using the accepted rows from the file. It notes the rejected rows and does not load them into PENTA.
After loading, reviewing, and modifying the data, you can use PENTA to distribute the Accounts Payable batch and process AP checks.
Accounts Payable Limitations & Restrictions
The interface does not perform batch and document balancing.
There are no defaults or substitutes that you can set up for scenarios where there is missing information in the interface data file.
PENTA places the following limitations and restrictions on invoice data loaded with the interface:
The User Id entered in the interface data file is the only user who can edit and distribute the batch.
The person loading the interface file does not have to be the user identified in the Header Record. Zach can load the file, but if Larry is the user in the Header Record, only he can edit and distribute the batch once Zach loads the file.
If PENTA rejects a record, you cannot resubmit the file because a batch already exists for the file name and file type.
Accounts Payable Where to View Loaded Data
You can review interfaced data and make any corrections and/or late entries in the Invoice & Credit Memo Entry window.
Available Tables
- 1 Account Detail Tax Record
- 2 Accounts Payable Detail Record
- 3 Customer Reference Detail Record
- 4 Document Detail Record
- 5 Document Hold Detail Record
- 6 Document Tax Detail Record
- 7 Employee Advance Receivable Detail Record
- 8 Fixed Asset Tax Detail Record
- 9 Fixed Assets Detail Record
- 10 Accounts Payable Header Record
- 11 Job Detail Record
- 12 Job Tax Detail Record
- 13 Purchase Order Customer Reference Detail Record
- 14 Purchase Order Detail Record
- 15 Purchase Order Tax Detail Record
- 16 Subcontract Detail Record
- 17 Work Order Detail Record
- 18 Work Order Tax Detail Record
Account Detail Tax Record
The following information relates to the INTR_AP_ACCT_TAX table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
JURIS_ID | Req | C 10 | Id of the taxing authority. |
CONSOL_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. This tax rate is the same for sales and use tax and PENTA applies it in all taxable situations. |
SALES_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only applies it in situations where that type is applicable. |
USE_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only applies it in situations where that type is applicable. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Accounts Payable Detail Record
The following information relates to the INTR_AP_DTL_ACCT table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | Must match the vendor Id in the document row. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within request/vendor/invoice. |
DR_OU_ID | Req | X | This must be an active general ledger account. The default is the AP OU Id from the INTR_AP_DOC row. 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 INTR_AP_DOC row. |
DR_ACCT_NUM | 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 INTR_AP_DOC row, an exchange rate must exist for the two currencies. |
CUS_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. |
D_PRD_END_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. |
REF_JOB_ID | Opt | X | A job related to the Job ID. This does not have to be a parent, child, or active job. |
DESCR | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the INTR_AP_DOC row. If System Option 104 is N, there is no default. |
AMT | Req | F 15.2 | Enter a value other than zero. |
CR_ACCT_NUM | 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 INTR_AP_DOC row. 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 row. 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), this column must be blank or null. |
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 column must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
FORM_ID | Opt | C! 8 | The default is the Form Id for the Source Currency 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. |
TAX_EXEMPT_ | Opt | C! 3 | The defaults are:
If System Option 152 is N, this column must be blank or null. If Tax Exempt Reason Code on the INTR_AP_DOC row has a value, this column 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. |
TAX_CERTIFICATE | Opt | C 15 | The defaults are:
If System Option 152 is N, this column must be blank or null. If the Tax Exempt Certificate Id on the INTR_AP_DOC row has a value, this column 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. |
EARN_CD | Opt | I 2 | 1099 Earnings Code. |
TRANX_REF_ID | Opt | 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. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_DATE | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
FORM_1099_ST_CD | Opt | C 4 | The 1099 State Code. |
CASH_ACCOUNT_NUM | Opt | X | Account # of the Cash Account. Required if the GL Account Number has an edit rule of Cash; otherwise, do not enter a value. Cash Account must have the same GL account as entered in the DR_ACCT_NUM. The Cash Account's OU Id must have the same BS OU as the account on the DR_OU_ID row. |
Customer Reference Detail Record
The following information relates to the INTR_AP_DTL_CUS_REF table, and is part of the Customer Reference record.
Customer Reference records are optional. A Customer Reference record must follow a work order-related Detail record.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
CUS_REF_CD | Req | C 15 | A reference code that pertains to the work order’s distribution. |
CUS_REF_VALUE | Opt | C 30 | The value for the associated Customer Reference Code. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Document Detail Record
The following information relates to the INTR_AP_DOC table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | The invoice number must be unique. If the Invoice Number and Vendor Id match an invoice that has a void status of Y, PENTA rejects this invoice (INTR_AP_DOC and all associated INTR_AP_JOB and INTR_AP_ACCT rows). |
VEN_ID | Req | X | ID of the Vendor 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. You can only enter a Vendor ID or Employee ID. Required if Employee ID is blank or null; otherwise, do not enter a value. If System Option 109 is Y, the Vendor Id cannot be the same as the Vendor Id assigned to the AP OU. |
CR_OU_ID | Req | X | This must be an active balance sheet OU. The User Id passed to the package must have authorization for this OU. PENTA will not verify authorization for this OU until the user attempts to view the batch using the Accounts Payable windows. The default is the OU of the user (User Id). |
EMP_ID | Opt | X | You can only enter a Vendor ID or Employee ID. Required if Vendor Id is blank or null; otherwise, do not enter a value. The default is the employee associated with the vendor. |
INVOICE_AMT | Req | F 15.2 | The total amount of all invoices in this INTR_RQST_ID. |
D_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 column is null and System Option 20 is Y, PENTA uses the system date. |
D_DISTR_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. |
PAY_TERM_NUM | Opt | I 3 | The default is the vendor’s payment terms. Optionally, enter a Proximo date for the following conditions:
Notes:
|
DSCNT_PCT | Opt | F 8.5 | Must be between 0.001 and 100.000 percent. The default is the discount percent associated with the Payment Terms. Either enter this value or a Discount Amount, not both. |
DSCNT_AMT | Opt | F 15.2 | Must be the same sign (+ or –) as Invoice Amount and less than the Invoice Amount. Either enter this value or a Discount Percent, not both. |
RET_PCT | Opt | F 8.5 | Must be between 0.001 and 100.000 percent. Either enter this value or a Retention Amount, not both. |
RET_AMT | Opt | F 15.2 | Must be the same sign (+ or –) as Invoice Amount and less than the Invoice Amount. Either enter this value or a Retention Percent, not both. |
INVOICE_UNITS | Opt | F 12.3 | The total units on the invoice |
PAY_RQST_NUM | Opt | C 15 | If System Option 148 is Y, the Pay Request Number must be in digits (rather than characters). |
INVOICE_TYPE_CD | Req | C! 3 | The value should be REG. The default is REG. |
REMIT_ADDR_NUM | Opt | I 5 | The default is the remit-to address of the Vendor Id. 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. |
SOURCE_CURRENCY_ | Opt | C! 3 | The default is the currency of the Vendor Id. 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. |
FORM_ID | Opt | C! 8 | The default is the Form Id for the Source Currency 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. |
TAX_AMT | Opt | F 15.2 | The amount of taxes for the invoice. If System Option 152 is N, this column must be blank or null. If System Option 271 is Y, PENTA records sales tax amounts entered by the user 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. Users record sales tax charged by a vendor as a lump sum amount. PENTA does not require users to 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 associated with distributions entered on the AP document (State, City, etc.):
The Sales & Use Tax reporting gives detailed sales tax jurisdiction reporting for amounts paid as sales tax plus accruals made where one of the following is true:
|
TAX_EXEMPT_ | 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. |
TAX_CERTIFICATE | Opt | C 15 | If System Option 152 is N, this column must be blank or null. |
PAYMENT_CYCLE_ | Opt | I 3 | The cycle you plan to pay the Invoice with. This value helps in selecting items for payment. |
TRANX_REF_ID | Opt | 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. |
D_DUE_DATE | Opt | D | The due date for the invoice payment. |
D_DSCNT_DATE | Opt | D | The date by which you must pay the invoice amount in order to receive a discounted price. |
MISC_VEN_ADDR_ | Opt | C! 30 | MISC_VEN_ADDR_NAME=XXXX, where XXXX is the Vendor Name in the address block. Enter this as Column Name =Name. Example: MISC_VEN_ADDR_NAME =Acme Supply You can enter this for any Vendor Type. |
MISC_VEN_ADDR_1 | Opt | C! 30 | MISC_VEN_ADDR_1=XXXX, where XXXX is the Address in line 1 of the address block. Enter this as Column Name =Address 1. Example: MISC_VEN_ADDR_1=123 Any Street |
MISC_VEN_ADDR_2 | Opt | C! 30 | MISC_VEN_ADDR_2=XXXX, where XXXX is the Address in in line 2 of the address block. Enter this as Column Name =Address 2. Example: MISC_VEN_ADDR_2=PO Box 1234 |
MISC_VEN_ADDR_3 | Opt | C! 30 | MISC_VEN_ADDR_3=XXXX, where XXXX is the Address that appears in line 3 of the address block. Enter this as Column Name =Address 3. Example: MISC_VEN_ADDR_3=C/O Accounts Payable Department |
MISC_VEN_CITY | Opt | C! 20 | MISC_VEN_CITY=XXXX, where XXXX is the City in the address block. Enter this as Column Name =City. Example: MISC_VEN_CITY =Brookfield. Required if a MISC_VEN_ADDR_NAME exists; otherwise, do not enter a value. |
MISC_VEN_ST_CD | Opt | C! 4 | MISC_VEN_ST_CD=XX, where XX is the name in the State field of the address block. Enter this as Column Name =State. Example: MISC_VEN_ST_CD =WI |
MISC_VEN_POSTAL_ | Opt | C! 10 | MISC_VEN_POSTAL_CD=XXXX(-XXX), where XXXX(-XXX) is the Numeric Code in the Postal Code field of the address block. Enter this as Column Name =Postal Code. Example: MISC_VEN_POSTAL_CD =53188 Required if you entered a vendor address name; otherwise, do not enter a value. |
MISC_VEN_COUNTRY_CD | Opt | C! 3 | MISC_VEN_COUNTRY_CD=XXXX, where XXXX is the Country in the address block. Enter this as Column Name =Country. Example: MISC_VEN_COUNTRY_CD =USA |
MISC_VEN_PHONE_ | Opt | C! 3 | MISC_VEN_PHONE_AREA_CD=XXX, where XXX is the 3 digit Area Code in the address block. Enter this as Column Name =Area Code. Example: MISC_VEN_PHONE_AREA_CD =262 |
MISC_VEN_PHONE_ | Opt | C! 11 | MISC_VEN_PHONE_NUM=XXXXXXX, where XXXXXXX is the 7 digit Phone number in the address block. Enter this as Column Name =Phone Number. Example: MISC_VEN_PHONE_AREA_CD =5740505. |
MISC_VEN_FAX_AREA_CD | Opt | 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 Column Name =Area Code. Example: MISC_VEN_PHONE_AREA_CD =262 |
MISC_VEN_FAX_NUM | Opt | C! 11 | MISC_VEN_FAX_NUM=XXXXXXX, where XXXXXXX is the 7 digit Fax number in the address block. Enter this as Column Name =Phone Number. Example: MISC_VEN_FAX_AREA_CD =5741212. |
MISC_VEN_WWW_ | Opt | C! 100 | MISC_VEN_WWW_ADDR=XXXX, where XXXX is the web address. Enter this as Column Name = web address. Example: MISC_VEN_WWW_ADDR=www.supplier.com. |
MISC_VEN_ADDL_ | Opt | 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 Column Name =Line 1 Information. Example: MISC_VEN_ADDL_CHECK_LINE_1=Attention: Ms. M. Berkly |
MISC_VEN_ADDL_ | Opt | 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 Column Name =Line 2 Information. Example: MISC_VEN_ADDL_CHECK_LINE_2=Account #1234567. |
WH_ST_CD | Opt | C 4 | The withholding state’s code. |
ST_WH_PCT | Opt | F 8.5 | The percent to withhold for the state. Must be non-zero or null. PENTA only allows entry in this column if the FORM_1099_ST_CD has a valid value. |
ST_WH_ACCT_NUM | Opt | X | The accrual account for the state withholding. Required if a ST_WH_PCT exists; otherwise, do not enter a value. |
ST_WH_VEN_ID | Opt | X | The vendor that receives the state withholding payment. Required if a ST_WH_PCT exists; otherwise, do not enter a value |
FED_WH_PCT | Opt | F 8.5 | The percent to withhold for Federal withholding. Must be non-zero or null. |
FED_WH_ACCT_NUM | Opt | X | The accrual account for the federal withholding. Required if the FED_WH_PCT has a non-zero value; otherwise, do not enter a value. |
FED_WH_VEN_ID | Opt | X | The vendor you pay federal withholding to. Required if the FED_WH_PCT has a non-zero value; otherwise, do not enter a value. |
FREIGHT_AMT | Opt | F 15.2 | PENTA only uses Freight Amount to determine the Invoice Basis Amount. |
AP_STAT_CD | Opt | C! 1 | Indicates the Pay Status of the Invoice. Possible values are: A (Active & available for payment) and H (Hold upon distribution, not available for payment). If you enter nothing, this defaults according to System Option 87: If the System Option is N and the Vendor Status is H (hold), Status defaults as H. Otherwise, this defaults as A. Error occurs if System Option 87 is Y, this value is H, and there is no HOLD record for the document. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | This defaults as the current date. This column contains the date that the record is marked as modified in the database once the process initiates and completes. |
Document Hold Detail Record
The following information relates to the INTR_AP_DOC_HOLD table. 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.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Vendor’s Invoice Number. This must be unique. If the Invoice Number and Vendor Id match an invoice that has a void status of Y, PENTA rejects this invoice (INTR_AP_DOC and all associated INTR_AP_JOB and INTR_AP_ACCT rows). |
VEN_ID | Req | 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. If System Option 109 is Y, the Vendor Id cannot be the same as the Vendor Id assigned to the AP OU. |
HOLD_CD | Req | C! 3 | Id of the Hold Reason currently against the Invoice. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_DATE | Opt | D | This defaults as the current date. This column contains the date that the record is marked as modified in the database once the process initiates and completes. |
Document Tax Detail Record
The following information relates to the INTR_AP_DOC_TAX table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | Id of the Invoice’s vendor. |
JURIS_ID | Req | C 10 | Id of the taxing authority. |
CONSOL_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. This tax rate is the same for sales and use tax and PENTA applies it in all taxable situations. |
SALES_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it in when this type applies. |
USE_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when this type applies. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Employee Advance Receivable Detail Record
The following information relates to the INTR_AP_DTL_EAR table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | Id of the vendor on the invoice. |
AMT | Req | F 15.2 | The Payment Amount applied to the advance. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Fixed Asset Tax Detail Record
The following information relates to the INTR_AP_FA_TAX table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
JURIS_ID | Req | C 10 | Id of the taxing authority. |
CONSOL_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. This tax rate is the same for sales and use tax and PENTA applies it in all taxable situations. |
SALES_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that type is applicable. |
USE_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Fixed Assets Detail Record
The following information relates to the INTR_AP_DTL_FA table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | Must match the vendor Id in the document row. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within request/vendor/invoice. |
FA_ID | Opt | X | If Fixed Asset Id is not null, Fixed Asset Expense Category cannot be null. PENTA checks to ensure the following:
|
FA_EXP_CAT_NUM | Opt | I 3 | PENTA checks to insure that the expense category is active and associated with the asset’s class in the Asset Class Information window. |
DESCR | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the INTR_AP_DOC row. If System Option 104 is N, there is no default. |
AMT | Req | F 15.2 | Enter a value other than zero. |
CR_ACCT_NUM | 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 INTR_AP_DOC row. 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 row. 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 column must be blank or null. |
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 column must be 1.0. Entry is required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
FORM_ID | Opt | C! 8 | The default is the Form Id for the Source Currency Id. The User Id must have authorization to use this Check Form. Required if System Option 75’s value is 3; otherwise, do not enter a value. If System Option 155’s value is Y, the Check Form type may be AP or GN. If System Option 155’s value is N, the Check Form type must be AP. If System Option 44’s value is Y, the currency of the Check Form must be the same as Source Currency Id. If System Option 89’s value is Y and the user type is not H (home office), do not enter a value. |
TAX_EXEMPT_ | Opt | C! 3 | The defaults are:
If System Option 152’s value is N, this column must be blank or null. If Tax Exempt Reason Code on the INTR_AP_DOC row has a value, this column 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. |
TAX_CERTIFICATE | Opt | C 15 | The defaults are:
If System Option 152 is N, this column must be blank or null. If the Tax Exempt Certificate Id on the INTR_AP_DOC row has a value, this column 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. |
EARN_CD | Opt | I 2 | 1099 Earnings Code. |
TRANX_REF_ID | Opt | 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. |
FORM_1099_ST_CD | Opt | C 4 | The 1099 State Code |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Accounts Payable Header Record
The following information relates to the INTR_AP_HDR table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records that PENTA should process together. |
RECORD_COUNT | Req | I 10 | Each batch includes a count of the rows (header and detail) within the INTR_AP_HDR and INTR_AP_DTL tables for the INTR_RQST_ID. This number must be greater than zero. If the number in the header row differs from the number read by PENTA, no update occurs and PENTA rejects the entire file. |
BATCH_NUM | Req | I 10 | Id of the Batch. |
INVOICE_AMT | Req | F 15.2 | The total amount of all invoices in this INTR_RQST_ID. PENTA uses this amount to determine if the batch is in balance when viewed in the PENTA Accounts Payable windows. |
INVOICE_UNITS | Opt | F 12.3 | The total number of units of all invoices in this INTR_RQST_ID. PENTA uses this number to determine if the batch is in balance when viewed in the PENTA Accounts Payable windows. |
TRANX_REF_ID | Opt | 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. |
DEF_CHK_FORM_ID | Opt | C! 8 | The Document tab’s default Check Form. You establish the overriding default at the Organizational Units or Currency level. Default Check Forms you enter in the Vendor Information window override this default. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_DATE | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Job Detail Record
The following information relates to the INTR_AP_DTL_JOB table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | Must match the vendor Id in the document row. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within request/vendor/invoice. |
JOB_ID | Req | X | Must be an active job.
|
COST_TYPE_CD | 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. |
CC | 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. |
ITEM_NUM | Opt | X | 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. |
DESCR | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the INTR_AP_DOC row. If System Option 104 is N, there is no default. |
AMT | Req | F 15.2 | Enter a value other than zero. |
UNITS | Opt | F 12.3 | The number of units used on the job. Enter a value greater than zero. |
PAY_RQST_NUM | Opt | C 15 | Defaults as 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). |
CR_ACCT_NUM | 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 INTR_AP_DOC row. 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 row. 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), this column must be blank or null. |
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 column must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
FORM_ID | Opt | C! 8 | The default is the Form Id for the Source Currency 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. |
TAX_EXEMPT_ | Opt | C! 3 | The defaults are:
If System Option 152 is N, this column must be blank or null. If Tax Exempt Reason Code on the INTR_AP_DOC row has a value, this column 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. |
TAX_CERTIFICATE | Opt | C 15 | The defaults are:
If System Option 152 is N, this column must be blank or null. If the Tax Exempt Certificate Id on the INTR_AP_DOC row has a value, this column 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. |
EARN_CD | Opt | I 2 | 1099 Earnings Code. |
TRANX_REF_ID | Opt | 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. |
FORM_1099_ST_CD | Opt | C 4 | The 1099 State Code |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Job Tax Detail Record
The following information relates to the INTR_AP_JOB_TAX table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA processes together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
JURIS_ID | Req | C 10 | Id of the taxing authority. |
CONSOL_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. This tax rate is the same for sales and use tax and PENTA applies it in all taxable situations. |
SALES_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
USE_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Purchase Order Customer Reference Detail Record
The following information relates to the INTR_AP_PO_CUS_REF table, and is part of the Customer Reference record.
Customer Reference records are optional. A Customer Reference record must follow a work order-related Detail record.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
CUS_REF_CD | Req | C 15 | ID referring to Customer-specific information. |
CUS_REF_VALUE | Opt | C 30 | The value for the associated Customer Reference Code. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Purchase Order Detail Record
The following information relates to the INTR_AP_DTL_PO table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
PO_OU_ID | Req | X | OU that issued the purchase order. |
PO_NUM | Req | X | Id of the purchase order. |
VEN_PROD_ID | Opt | C 26 | The vendor associated with the purchase order. |
PO_LINE_NUM | Opt | I 9 | PENTA validates this against the PO_DTL table. |
UNITS | Opt | F 12.3 | Units associated with the line item, invoiced to date. |
UP | Opt | F 12.3 | The unit’s price. |
AMT | Opt | F 15.2 | Lump sum amount of the amount invoiced to date. |
JOB_ID | Req | X | Enter an active job. If System Option 69 is Y, the job must not 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. |
COST_TYPE_CD | 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. |
CC | Opt | X | Enter an active Costcode. If Costcode validation for the Job Id is Y, enter a valid Costcode for the Job. |
DR_OU_ID | Opt | X | The Id of the OU associated with the debit. |
DR_ACCT_NUM | Opt | X | The debit account number. |
FA_ID | Opt | X | If the Fixed Asset Id has a value, the Fixed Asset Expense Category must have a value. PENTA checks to ensure the following are true:
|
FA_EXP_CAT_NUM | Opt | I 3 | PENTA checks to insure that the expense category is active and associated with the asset’s class in the Classes window |
CR_ACCT_NUM | Req | X | The payable account to which you want to post the distribution. |
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 column must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
TAX_EXEMPT_ | Opt | C! 3 | The defaults are:
If System Option 152 is N, this column must be blank or null. If Tax Exempt Reason Code on the INTR_AP_DOC row has a value, this column 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. |
TAX_CERTIFICATE | Opt | C 15 | The defaults are:
If System Option 152 is N, this column must be blank or null. If the Tax Exempt Certificate Id on the INTR_AP_DOC row has a value, this column 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. |
EARN_CD | Opt | I 3 | 1099 Earnings Code |
PAY_RQST_NUM | Opt | C 15 | The Id of the pay request (progress billing) that the customer must pay before you pay the Vendor for this Invoice. |
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. |
DESCR | Req | C 30 | The description of the Purchase Order’s line item. |
TRANX_REF_ID | Opt | C! 15 | PENTA marks the interface files’ job cost and billing transactions with this Transaction Reference Id so your external application can perform functions (e.g., billing and profit analysis) by whatever grouping this Id represents. |
FORM_1099_ST_CD | Opt | C! 4 | 1099 State Code. |
WO_ID | Opt | C! 25 | The work order to which you are charging the distribution. |
WO_OU_ID | Opt | X | The organizational unit associated with the work order. |
WO_COST_TYPE_CD | Opt | C! 4 | The Cost Type to which you are charging the work order. |
WO_CUS_LOC_CD | Opt | C 8 | The Customer Location associated with the work order. |
WO_CUS_EQ_ID | Opt | C! 15 | The piece of customer equipment impacted by the work order’s distribution. |
WO_TASK_ID | Opt | C! 10 | The work order task to which you are charging the distribution. |
WO_FA_ID | Opt | X | The fixed asset you are charging the distribution to when performing maintenance. |
WO_FA_EXP_CAT_ | Opt | I 3 | The type of expense you are charging to the fixed assed. |
WO_MAINT_SCHD_ | Opt | I 6 | The Maintenance Schedule associated with the customer equipment or the fixed asset. |
WO_MAINT_ | Opt | C! 15 | The Maintenance Contract associated with the distribution. |
RET_AMT | Opt | F 15.2 | The amount you plan to withhold payment on when you pay the invoice. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Purchase Order Tax Detail Record
The following information relates to the INTR_AP_PO_TAX table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
JURIS_ID | Req | C 10 | Id of the taxing authority. |
CONSOL_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. This tax rate is the same for sales and use tax and PENTA applies it in all taxable situations. |
SALES_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
USE_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Subcontract Detail Record
The following information relates to the INTR_AP_DTL_SC table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
JOB_ID | Req | X | The Job Id. |
SC_NUM | Req | X | The Subcontract number. |
SC_LINE_NUM | Req | I 9 | The Subcontract Line number. |
DESCR | Req | C 30 | The description of the Subcontract Line number. |
AMT | Opt | F 15.2 | The Distribution Amount. |
UNITS | Opt | F 12.3 | The number of Units. |
UP | Opt | F 12.3 | The Unit Price. |
RET_AMT | Opt | F 15.2 | The Retention Amount. |
PAY_RQST_NUM | Opt | C 15 | Defaults as the DOC record’s Pay Request Number. 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). |
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 column must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
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. |
CR_ACCT_NUM | Opt | X | Number of the account credited for the transaction. |
EARN_CD | Opt | C 3 | 1099 Earnings Code |
FORM_1099_ST_CD | Opt | C! 4 | 1099 State Code |
TRANX_REF_ID | Opt | 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. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Work Order Detail Record
The following information relates to the INTR_AP_DTL_WO table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
WO_ID | Req | C! 25 | The work order to which you are charging the current distribution. |
WO_OU_ID | Opt | X | The OU associated with the work order’s distribution. |
WO_COST_TYPE_CD | 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. |
WO_CUS_LOC_CD | Opt | C 8 | The customer location associated with the work order. |
WO_CUS_EQ_ID | Opt | C! 15 | The piece of customer equipment impacted by the work order’s distribution. |
WO_TASK_ID | Opt | C! 10 | The work order task to which you are charging the distribution. |
WO_FA_ID | Opt | X | PENTA checks to insure the following:
|
WO_FA_EXP_CAT_ | Opt | I 3 | PENTA checks to insure that the expense category is active and associated with the asset’s class in the Classes window. You must enter an expense category if a Fixed Asset exists. |
WO_MAINT_SCHD_ | Opt | I 6 | The maintenance schedule associated with the customer equipment or fixed asset. |
WO_MAINT_CONTRACT_ID | Opt | C! 15 | The maintenance contract associated with the distribution. |
DESCR | Req | C 30 | If System Option 104 is Y, the default is the vendor name of the Vendor Id from the INTR_AP_DOC row. If System Option 104 is N, there is no default. |
AMT | Req | F 15.2 | Enter a value other than zero. |
CR_ACCT_NUM | Opt | X | Number of the account credited for the transaction. |
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 column must be 1.0. Required if System Option 44 is Y; otherwise, do not enter a value. The default is:
|
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. |
TAX_EXEMPT_ | 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 row has a value, this column 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. |
TAX_CERTIFICATE | Opt | C 15 | The defaults are:
If System Option 152 is N, this column must be blank or null. If the Tax Exempt Certificate Id on the INTR_AP_DOC row has a value, this column 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:
|
EARN_CD | Opt | C 3 | 1099 Earnings Code |
FORM_1099_ST_CD | Opt | C 4 | 1099 State Code |
TRANX_REF_ID | Opt | 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 | Opt | F 12.3 | Work Order units. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |
Work Order Tax Detail Record
The following information relates to the INTR_AP_WO_TAX table.
Column | Entry | Format | Description |
---|---|---|---|
INTR_RQST_ID | Req | C! 13 | The interface request value that you enter to initiate the interface process. The value must be consistent for all records PENTA should process together. |
VEN_INVOICE_NUM | Req | C! 15 | Must match the invoice number in the document row. |
VEN_ID | Req | X | The invoice’s vendor. |
SEQ_NUM | Req | I 10 | Sequence number uniquely identifying this row within interface request. |
JURIS_ID | Req | C 10 | Id of the taxing authority. |
CONSOL_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. This tax rate is the same for sales and use tax and PENTA applies in all taxable situations. |
SALES_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
USE_TAX_RATE | Opt | F 6.3 | One of three tax types PENTA uses to determine whether a taxable transaction is sales tax or use tax. PENTA considers the tax rate sales or use tax and only uses it when that tax type applies. |
RECORD_NUM | Opt | I 10 | Do not assign this value. PENTA assigns this record number, which you can use to identify records with errors or warning messages. |
USER_ID | Req | C 6 | Id of the employee performing the load process. This user_id must exist in PENTA. |
MODIFICATION_ | Opt | D | Once the process completes, this displays the date PENTA marked the record as modified in the database. The current date is the default value. |