Vendor Interface: Pipe Delimited Method
Use the Vendor Interface to load vendor information using data from external applications. Information you load using this interface adds to the data already stored in PENTA.
Data files you load must have Request Types assigned to the V Interface Type.
Related System Options
System Option 340 (Reject Vendor Interface on Error) controls whether PENTA rejects a Vendor Interface request when it contains errors. If this is set to:
N – PENTA rejects records in the interface file that generated errors. PENTA loads records that don't generate errors into the database.
Y – PENTA rejects the entire interface file if any record in the file generated an error.
Where to View Loaded Data
You can review interfaced data in the Vendor Information window.
Available Tables
Address Detail Record
Note: The specified vendor bank account will be created if it doesn’t already exist.
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be ADDRESS. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | ID of the Vendor. |
4 | Address # | Req | I 5 | ID of the Vendor’s address. |
5 | Address Name | Opt | C 30 | Name associated with the Vendor’s address. A value is required if the Vendor’s Type is M (Miscellaneous). |
6 | Address line 1 | Opt | C 30 | First line of the Vendor’s address. |
7 | Address line 2 | Opt | C 30 | Second line of the Vendor’s address. |
8 | Address line 3 | Opt | C 30 | Third line of the Vendor’s address. |
9 | City | Req | C 20 | The city associated with the Addr #. |
10 | State/ Province | Req | C! 4 | ID of the state associated with the Addr #. |
11 | Postal Cd | Req | C 10 | Postal (ZIP) code associated with the Addr #. |
12 | Country Cd | Opt | C! 3 | ID of the country associated with the Addr #. |
13 | Address Type | Opt | C! 3 | ID of the address type, which classifies the address. |
14 | Remit Addr | Opt | C! 1 | This indicates (with Y (yes) or N (no)) whether this address is allowed for remittances. This defaults as Y. |
15 | PO Addr | Opt | C! 1 | Indicate (with a Y (yes) or N (no)) if this address is allowed for purchase orders. This defaults as Y. |
16 | Phone Area Code | Opt | C 3 | Area code of the phone number associated with the address. |
17 | Phone # | Opt | C 11 | Phone number associated with the address. A value is required if there is a Phone Area Code value. |
18 | Fax Area Code | Opt | C 3 | Area code of the fax number associated with the address. |
19 | Fax # | Opt | C 11 | Fax number associated with the address. A value is required if there is a Fax Area Code value. |
20 | Sep Check by Inv | Opt | C! 1 | Indicate (with Y (yes) or N (no) if PENTA should create a separate check for each invoice for this address. This must be N if Remit Addr is N. |
21 | Website | Opt | C 100 | Address (URL) of the Vendor’s website. |
22 | Vendor Address – Additional Information, line 1 | Opt | C 50 | First additional line that will print below the vendor address on the AP Check. |
23 | Vendor Address – Additional Information, line 2 | Opt | C 50 | Second additional line that will print below the vendor address on the AP Check. |
24 | Direct Deposit of Payable Amounts? | Opt | C! 1 | Indicate (with Y (yes) or N (no)) if payments to this vendor address are directly deposited. This defaults as N. This must be N if Remit Addr is N. Note: When changing this value to N on an existing vendor address, the Bank Number, Bank Account Number, and Account Type Code Fields will be set to null (i.e., blank) in this vendor address table. |
25 | Bank Number | Opt | C! 9 | Number of the Vendor’s bank to be used for direct deposits for this address. A value is required if Print Direct Deposit Advice Notices value is Y; otherwise you cannot enter a value. If country is USA or System Option 263 is Y and country is anything other than CAN, this must be a valid U.S. bank number. |
26 | Bank Name | Opt | C30 | Name of the Vendor’s Bank. A value is required if Print Direct Deposit Advice Notices value is Y; otherwise you cannot enter a value. This defaults as Default Bank Name. |
27 | Bank Account Number | Opt | C 17 | Account number of the Vendor’s bank to be used for direct deposits for this address. A value is required if the Print Direct Deposit Advice Notices value is Y; otherwise, you cannot enter a value. |
28 | Account Type Code | Opt | C! 1 | The account type/classification for the Bank Account Number. A value is required if the Print Direct Deposit Advice Notices value is Y; otherwise, you cannot enter a value. Valid values are:
|
29 | Print Direct Deposit Advice Notices? | Opt | C! 1 | Indicate (with Y (yes) or N (no)) if PENTA should print direct deposit advice notices. This defaults as Y. |
30 | Email Direct Deposit Disbursement Information? | Opt | C! 1 | Indicate (with Y (yes or N (no)) if direct deposit advice notices should be emailed. This defaults as N. |
31 | Email Address | Opt | C 50 | The email address where advice notices should be sent. A value is required if Email Direct Deposit Disbursement Information is Y. |
Check Form Detail Record
The following information relates to the Vendor Check Form table, which contains default Check Forms for a Vendor.
Notes: Entry of at least one check form is required if System Option 260 is Y and the Vendor Detail record's Vendor Type value is E.
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be CHECKFORM. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | ID of the Vendor. |
4 | Check Form ID | Req | C! 8 | ID of the default form PENTA should use for checks for a particular balance sheet OU/currency combination. For each vendor, PENTA allows only one form per balance sheet/currency combination. |
Contact Detail Record
Note: You must enter at least one of the optional fields.
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be CONTACT. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | ID of the Vendor. |
4 | Addr # | Req | I 5 | ID of the Vendor’s address. |
5 | Contact # | Req | I 3 | ID of the contact person associated with the Vendor/address. |
6 | Last Name | Opt | C 20 | Last name of the Vendor’s contact. |
7 | First Name | Opt | C 15 | First name of the Vendor’s contact. |
8 | Type | Opt | C! 3 | ID that classifies the Vendor’s contact. |
9 | Title | Opt | I 4 | The title # of Vendor’s contact. |
10 | Email Address | Opt | C 50 | Email address of Vendor’s contact. |
Detail Record
Address Note (*): The addresses referenced on the VENDOR record must either already exist or be created as part of the same interface request.
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be VENDOR. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | The vendor’s ID. |
4 | Name | Req | C 30 | The vendor’s name. |
5 | Prefix | Opt | C 15 | Vendor’s name prefix. |
6 | Middle Name | Opt | C 15 | Vendor’s middle name. |
7 | Type | Opt | C! 1 | Type of vendor. Valid types are:
Notes:
|
8 | Status | Opt | C! 1 | Status of vendor. Valid statuses are:
Notes:
|
9 | Emp ID | Opt | X | ID of the employee linked to the vendor. A value is required if the (vendor) Type value is E; otherwise, values are not allowed. Notes
|
10 | Receive 1099 | Opt | C! 1 | This indicates (with a Y (yes) or N (no)) whether the Vendor receives a 1099. This must be set to:
Notes:
|
11 | Name Ctrl Code | Opt | C! 4 | The Name Control Code is for magnetic media reporting of 1099s. A value is only allowed if the Receive 1099 value is Y; otherwise, this must be blank. |
12 | Default 1099 Earn Cd | Opt | C 3 | This is the default code for 1099 earnings. A value is required if the Receive 1099 value is Y; otherwise, this must be blank. |
13 | State Code | Opt | C! 4 | This is the default state code for payments included on 1099s. A value is only allowed if the Receive 1099 value is Y; otherwise, this must be blank. |
14 | Withholding Required on Invoices | Opt | C! 1 | Indicates (with Y (yes) or N (no)) whether withholding is required on invoices; otherwise enter N. This must be N if the Receive 1099 value is N. This defaults as N. |
15 | Fed ID | Opt | C 10 | The Vendor’s Federal ID. A value is only allowed if the Tax ID is blank. |
16 | Tax ID | Opt | C 11 | The Vendor’s Tax ID. A value is only allowed if the Fed ID value is blank. |
17 | Parent Vendor | Opt | X | ID of the Vendor’s Parent Vendor. Parent/Child vendor relationships cannot be more than two levels deep (i.e., this parent cannot have a parent of its own). You cannot enter a value if the vendor has an Emp ID value. |
18 | Vendor Class | Opt | C! 3 | ID of the Vendor’s classification. This defaults as VEN for new vendors. |
19 | Payment Terms | Opt | I 3 | ID of the Vendor’s Payment Terms. |
20 | Payment Cycle | Opt | I 3 | ID of the Vendor’s Payment Cycle. A value is required if System Option 189 is 2. |
21 | Check Sort Group | Opt | I 3 | ID of the check sorting group PENTA defaults for invoices entered against this Vendor. |
22 | Currency ID | Opt | C! 3 | ID of the Vendor’s Currency. A value is only allowed if System Option 44 is Y. |
23 | Default Ship Method | Opt | C! 8 | ID of the default Shipping Method on Purchase Orders created for the Vendor. |
24 | Default F.O.B. Terms | Opt | C! 8 | ID of the default FOB/Freight Terms on Purchase Orders created for the Vendor. |
25 | Lien Waivers | Opt | C! 1 | Indicates (with Y (yes) or N (no)) whether lien waivers should be produced for the Vendor. This defaults according to setting in the System Configuration window. |
26 | Waiver Only for Cost Type Cd | Opt | C! 4 | If a lien waiver should print for only one Cost Type, this identifies that Cost Type. A value is only allowed if Lien Waivers value is Y. |
27 | Sep Check by Job | Opt | C! 1 | This indicates (with Y (yes) or N (no)) whether a separate AP Check prints for each invoice paid to the Vendor. This defaults according to setting in the System Configuration window. |
28 | Keep Activity Detail | Opt | C! 1 | This indicates (with Y (yes) or N (no)) if PENTA should keep activity detail until the vendor is purged. This defaults as Y. PENTA does not currently use this value. |
29 | AP Writeoff Threshold | Opt | F 5, 2 | The amount acceptable to write off for an open invoice balance. A value is only allowed if you are authorized to enter AP Writeoff Threshold and there is an AP Writeoff Account specified in the System Configuration window. |
30 | Boolean All OU Code | Req | C! 1 | The Boolean All OU Code indicates (with Y (yes) or N (no)) whether the Vendor has authorization for all organizational units. This defaults as Y if you are authorized for all OUs; otherwise this defaults as N. |
31 | Receive T5018 | Opt | C! 1 | Receive T5018 Code indicates (with Y (yes) or N (no) whether the Vendor receives a T5108. This value must be N if Receive 1099 is Y. This defaults as N. |
32 | Partnership Filer ID Number, Line 1 | Opt | C 30 | The first line of the name of a corporation or partnership that should appear on the Vendor’s T5018 slip. This defaults as NAME. |
33 | Partnership Filer ID Number, Line 1 | Opt | C 30 | The second line of the name of a corporation or partnership that should appear on the Vendor’s T5018 slip. |
34 | Recipient Type Code | Opt | I 1 | Recipient Type Code identifies the Vendor’s T5018 classification. Valid values are:
|
35 | Recipient Account Number | Opt | C! 15 | If the Vendor is a Corporation or Partnership, use Recipient Account Number to enter the Vendor’s complete RT Goods & Services Tax (GST) or RZ Business Number assigned by the CRA. A value is required if the Recipient Type Code is 3 or 4. Must be in the form of 9 digits followed by RT or RZ followed by 4 more digits (999999999RZ9999 or 999999999RT9999). |
36 | Partnership Filer ID Number | Opt | C! 9 | The Vendor’s partnership filer identification number. This must be in the form of 2 alpha characters followed by 7 digits (XY9999999). |
37 | T5018 Address | Opt | I 5 | This identifies which vendor address PENTA should use for T5018 reporting. A value is required if Receive T5018 is Y. |
38 | PO Address | Opt | I 5 | ID of the default address PENTA uses when generating 1099s for the Vendor. |
39 | Remit To Address | Opt | I 5 | ID of the default address PENTA assigns as the remit to address during invoice entry. This must be null (i.e., blank) when the (vendor) Type is M (Miscellaneous Vendor). |
40 | 1099 Address | Opt | I 5 | ID of the default address PENTA uses when generating 1099s for the Vendor. |
41 | Bid Address | Opt | I 5 | ID of the default address PENTA uses when generating bids for the Vendor. |
Contact Phone Detail Record
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be PHONE. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | ID of the Vendor. |
4 | Addr # | Req | I 5 | ID representing the Vendor’s address. |
5 | Contact # | Req | I 3 | ID of the contact person associated with the Vendor/address. |
6 | Phone Type | Req | C! 8 | Type of phone. Valid values are:
|
7 | Area Code | Req | C 3 | The area code of the corresponding number (e.g., home, office, fax, etc.). |
8 | Number | Req | C 11 | The Contact's number (e.g., home, office, fax, etc.). |
9 | Extension | Opt | C5 | The extension of the corresponding number (e.g., home, office, fax, etc.). |
UDF Detail Record
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be UDF. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | ID of the Vendor. |
4 | Column Name | Req | C! 30 | The user defined field to be updated. |
5 | Value | Opt | C 2000 | The data to assign to the Column Name (Field). This field should be used for the value of any type of user defined field:
|
6 | Effective Date | Opt | D | If the field was set up to accept an effective date, this is the data’s effective date. |
Valid OU Detail Record
# | Field | Entry | Value | Description |
---|---|---|---|---|
1 | Record Type | Req | C! 5 | The value should be VALIDOU. |
2 | Activity Code | Req | C! 1 | Required for all activity. Possible values:
|
3 | Vendor ID | Req | X | ID of the Vendor. |
4 | OU ID | Req | X | ID of organizational unit for which the Vendor is valid. |