Pipe-Delimited AP Interface Doc Tab Guide Specifications
Issue/Symptom/Question
What is the guide for each field in the Pipe-Delimited AP Interface Doc tab?
Applies To
Pipe Delimited Interfaces
Accounts Payable (AP) Interface
Resolution/Fix/Answer
Document (DOC) Detail Record
The following fields are part of the Detail Record if the Record Type is DOC.
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.
Accounts Payable Interface: DOC Detail Fields | ||||
---|---|---|---|---|
# | 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. Example = 20190125 |
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=YYYYMMDD Note: YYYY = Year, MM = Month, DD = Day. This field must be entered as Field Name =Date. Example: DUE_DATE=20040130 | ||
D_DSCNT_DATE | D | DSCNT_DATE=YYYYMMDD Note: YYYY = Year, MM = Month, DD = Day. This field must be entered as Field Name =Date. Example: DSCNT_DATE=20040130. 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). |