This chapter provides overviews of voucher build processing and voucher build source transactions, lists prerequisites, and discusses how to:
Run the Voucher Build Application Engine process (AP_VCHRBLD) and review messages.
Review Voucher Build process errors.
PeopleSoft Payables provides the Voucher Build process to build vouchers in batch from various source transactions, including transactions originating from third-party systems.
Due to the scope of the voucher build functionality, PeopleSoft Payables does not deliver all online voucher entry functionality as part of the Voucher Build process. Therefore, not all voucher fields are part of the staging and quick invoice tables.
Warning! If you add voucher fields to the staging or quick invoice tables, you must add the associated logic to the Voucher Build process code line. Also, you must modify non-accounts payable voucher source transactions, for example, procurement card invoices and XML invoices, to account for the new field.
This section discusses:
Voucher Build process flow.
Tables that are accessed by the Voucher Build process.
Voucher Build process errors.
The Voucher Build process comprises two subprocesses, pre-edit and voucher edit. The pre-edit subprocess builds skeleton voucher record sets from limited information that you enter online using the Quick Invoice Entry component (VCHR_QUICK_PNL) or the Summary Invoice Entry component (VCHR_SUMM_PNL), or that it retrieves from other sources. After the pre-edit subprocess builds voucher record sets successfully, it calls the voucher edit subprocess to complete these record sets.
Note. If financial sanctions validation is enabled, the Voucher Build process does not consider the financial sanctions status of the vendor, nor does it validate the vendor against any financial sanctions lists (for example, the Specially Designated Nationals (SDN) list). Therefore, you can build vouchers for any vendor with a financial sanctions status of Review or Blocked. However, the Pay Cycle Application Engine process (AP_APY2015) does not select vouchers for a vendor that has a financial sanctions status of Review or Blocked. You cannot pay these vouchers until the financial sanctions status of the vendor is set to Cleared or Valid.
See Understanding Financial Sanctions Validation.
The pre-edit subprocess works in the following way:
It accesses and retrieves invoice data from the source transaction tables or staging tables, and it uses the data to populate the Voucher Build temporary tables.
Note. The specific source tables and data that the subprocess
retrieves depends on the run control selection criteria that you specify on
the Voucher Build Request page.
Vouchers from prior Voucher Build process instances that have been staged
for review and released for processing, as well as vouchers with corrected
pre-edit errors, can also be selected for reprocessing and are inserted into
the temporary tables with the new transactions.
When loading invoices into the Voucher staging tables using an external
source (for example: from a legacy or third-party system) any extra spaces
at the end of character fields need to be trimmed, otherwise this extra space
can cause a voucher edit error and the voucher will be created in a Recycle status.
It performs header error processing by checking for a valid business unit, invoice ID, invoice date, vendor ID, vendor location, address sequence number, and voucher origin.
The invoice data from some source transactions receive additional error checks.
The subprocess verifies that voucher headers have voucher lines and that voucher lines have distribution lines.
If applicable, the subprocess creates control groups, builds miscellaneous charge records if absent (based on business unit defaults), and creates payment records.
Note. The pre-edit subprocess can create payment schedule records only if payment schedule information such as the bank or a payment message is entered through the source transaction component. Quick invoices and voucher data that is staged to the voucher staging tables enable the entry of payment schedule information. For all other source transaction types, the payment records must be created by the voucher edit subprocess using the PeopleSoft Payables control hierarchy defaults.
The subprocess copies purchase order and receiver fields to voucher lines and creates distribution lines, based on either the default voucher build criteria or the voucher build code that is specified in the voucher header.
This applies when voucher lines reference a purchase order, receiver, packing slip, or bill of lading, and contain no distribution lines.
If a voucher line has ChartField information and no associated distribution lines, the subprocess creates distribution lines for the voucher line.
You define voucher build codes in the Voucher Build Criteria component (VCHR_BLD_DEFN).
See Voucher Build Processing Logic for Associating Voucher Lines with Purchase Order and Receiver Lines.
It stores successfully built voucher record sets in the voucher build temporary tables and calls the voucher edit subprocess.
If the skeleton voucher fails any of the header error checks, or if the purchase order and receiver association for a quick invoice, summary invoice, or spreadsheet voucher fails, the subprocess marks the voucher as having a pre-edit error. Such errors prevent the vouchers from being processed by the voucher edit subprocess, and the pre-edit subprocess writes these vouchers with pre-edit errors to the quick invoice tables.
You can review vouchers with pre-edit errors using the Build Errors page and the Voucher Build Error Detail page. From these pages you can link directly to the Quick Invoice Entry component, where you can correct the vouchers and release them for reprocessing.
Voucher contracts, evaluated receipt settlement (ERS) vouchers, and return to vendor (RTV) vouchers can be designated as staged for review. The pre-edit subprocess also writes these to the quick invoice tables instead of passing them to the voucher edit subprocess. You review and release these vouchers for further voucher build processing by using the Quick Invoice Entry component.
The voucher edit subprocess works in the following way:
It loads newly built voucher data from the Voucher Build temporary processing tables to the Voucher Edit work tables.
If specifically requested on the run control, the voucher edit subprocess also loads any vouchers in the online voucher tables that match the run control criteria. These could be recycled vouchers or vouchers that were modified using the Voucher Mass Maintenance component (VCHR_MASS_MAINT) or the Voucher Maintenance component (VCHR_CORRECTION).
It performs the following tasks:
Uses the PeopleSoft Payables control hierarchy to determine the default values with which to populate voucher fields that don't contain data.
Performs field-level, relational, and balancing edits for the voucher header, voucher line, voucher distribution line, and scheduled payment records.
Calculates net payment due dates, discount due dates, and discount amounts according to the payment terms.
Prorates freight, miscellaneous charges, sales tax, use tax, value-added tax (VAT), and discounts across distribution lines for applicable voucher lines.
Schedules one or more payments according to payment terms and user-entered control data.
Validates the vouchers, assigning document sequencing numbers and updating the status of one-time vendors, where appropriate.
It moves the voucher data from the voucher edit work tables to the online voucher tables.
At the end of the voucher edit subprocess, error-free vouchers are set to the status Postable. Vouchers that are flagged with errors during the voucher edit subprocess are assigned the status Recycle. You can inquire on and correct batch-processed vouchers with voucher edit errors by using the Build Errors page, the Voucher Build Error Detail page, the Voucher Maintenance Search component, the Voucher Maintenance component, and the Voucher component.
It publishes an XML message with voucher details if you select the Publish Voucher Messages option on the Voucher Build page.
You can notify vendors that you have received their invoices for any sources transactions. The XML message structure is defined in the message AP_VCHR_MESSAGE_OUT.
See Also
Reviewing Voucher Build Process Errors
Understanding Debit Memo Processing
The following table lists the tables that the Voucher Build process accesses for each source transaction:
Source Transactions |
Tables Accessed |
|
Quick invoice tables:
|
|
Voucher staging tables:
|
Evaluated receipt settlement (ERS) vouchers. |
Receiver and purchase order tables:
|
Return to vendor (RTV) adjustments. |
RTV tables:
|
Voucher contracts. |
Contract staging tables:
|
Purchase order (PO) voucher contracts. |
Contract staging tables and PO tables:
|
Consigned inventory items. |
|
|
Voucher staging tables:
|
PeopleSoft Order Management claim transactions. |
Voucher staging tables:
|
The Voucher Build process can result in pre-edit errors, which are stored in the quick invoice tables, or vouchers in recycle status, which are stored in the online voucher tables.
Pre-edit errors prohibit the transaction from being processed by voucher edit processing. For example, if the transaction has an invalid vendor ID, the voucher edit subprocess cannot process default values correctly, because vendor ID is part of the PeopleSoft Payables control hierarchy. The following general conditions result in pre-edit errors:
Invalid business unit.
Invalid vendor.
No default location for vendor.
Blank invoice ID, and auto-assign option is not selected on the run control page.
No invoice date, and auto-assign option is not selected on the run control page.
Invalid vendor location (if specified).
Invalid vendor address (if specified).
Invalid voucher origin (if specified).
No association of purchase order or receiver lines with voucher lines, and distribution information is absent.
No voucher line information.
The following pre-edit error conditions are specific to Promotions Management transactions:
Payment action is Record, and no payment reference (check number) exists.
Payment action is Record, and the payment method is not manual payment.
Payment action is Record, and bank information is missing or invalid.
Payment action is Record, and a duplicate payment reference exists.
Vouchers without pre-edit errors pass to the voucher edit subprocess. The voucher edit subprocess marks any vouchers that fail its edits as Recycled. The edits that are performed by the voucher edit process are essentially the same as those that are performed by the Voucher component.
Note. Any voucher validations that you can set up to pass
and provide a warning during online voucher entry, such as duplicate invoice
checking or sales tax tolerance, pass the voucher edit process without warning.
Any voucher validations that you set up to reject an
online voucher that fails, such as duplicate invoice checking or ChartField
editing, are set to recycle by the Voucher Build process.
If the Voucher Build process finds duplicate vouchers, it sets both to recycle
status.
Note. Because VAT calculation, rebate, and recovery details for procurement card vouchers are maintained in PeopleSoft Purchasing, procurement card vouchers in a VAT environment can produce Voucher Build process errors. These are reported on the Build Errors and Voucher Build Error Detail pages like other Voucher Build process errors. However, unlike other Voucher Build process errors, you correct procurement card voucher errors using the Reconcile Statement page in PeopleSoft Purchasing.
See Also
Reviewing Voucher Build Process Errors
Understanding Voucher Processing and the Voucher Life Cycle
Reconciling Procurement Card Transactions Manually
Defining Voucher Error-Handling Options
The Voucher Build process creates voucher record sets from the following sources:
Claims Management data.
Consigned inventory items.
Customer refunds from PeopleSoft Receivables.
Debit memo vouchers that were created by the Matching Application Engine process (AP_MATCH).
EDI-formatted transactions.
ERS transactions that are based on PO receipts and non-PO receipts.
Interunit invoices from PeopleSoft Billing.
Invoices that you enter in the Spreadsheet Voucher worksheet.
Invoices that you enter in the Summary Invoice Entry component.
Invoices that you enter in the Quick Invoice Entry component.
PeopleSoft Pay/Bill Management contractor payment transactions.
Procurement cards.
PeopleSoft Promotions Management field drafts and scheduled payments.
PeopleSoft Real Estate Management lease payment data.
Recurring contract vouchers and PO contract vouchers.
RTV credit memos.
Self-Service invoices from PeopleSoft eSettlements.
Voucher EIP application messages (including voucher data from PeopleSoft Payroll, Student Administration, and any other sources connected through the Voucher EIP).
XML invoices.
These source transactions are discussed in detail in the following sections.
Important! If your organization is not using certain types of source transactions (for example, claim transactions from PeopleSoft Order Management), you should disable the respective applications that you don't have installed on the system on the Installed Products page. Disabling products that you do not have installed on the system improves performance.
Use the PeopleSoft Purchasing vendor rebate functionality to create and manage rebate claims with vendors. Then use PeopleSoft Payables to settle the claim vouchers for PeopleSoft Order Management and Receivables.
The PeopleSoft Purchasing Process Claims Application Engine process (PO_PRCSCLAIM) initiates the Claim Settlement Process for AP Application Engine process (PO_CLMSETTLE_AP), which in turn populates the voucher staging tables with claim voucher data for processing by the Voucher Build process.
See Also
Consignment inventory is a supply chain management strategy in which you store goods in a business unit without paying the vendor until after the goods are consumed. The Consignment Inventory feature, which enables you to implement this strategy across an entire enterprise, integrates a variety of functions within PeopleSoft Purchasing, Inventory, Production Management, Cost Management, and Payables.
In PeopleSoft Payables, the Voucher Build process creates voucher record sets for consigned items that have been consumed and costed. It does this by:
Extracting data from the Depletion Accounting Entry table (CM_DEPLETE).
Selecting rows for which the Voucher Build status is T (to be vouchered) or E (error).
Processing these rows according to the processing option that is set for vendor location (using the Consign Voucher field on the Vendor Information - Procurement Options page at the vendor location level.
Processing options are:
Auto |
The Voucher Build process automatically creates vouchers (assuming that no Voucher Build errors occurred). |
Manual |
The Voucher Build process sets the status of affected data on the Depletion Accounting Entry table to N (never to be vouchered). The Voucher Build process does not process these vouchers because, in the case of rows with a Voucher Build status of M (manual), usage reports are provided to the vendor, and the invoice is not finalized until an invoice is received from the vendor. |
Stage |
The Voucher Build process creates vouchers and places them in the quick invoice entry tables for further user review. |
When the Voucher Build process finishes processing a row in the Depletion Accounting Entry table by creating or staging a voucher, the process updates the status of that row to V (vouchered). If an error occurs during processing, the Voucher Build process changes the status to E.
Voucher details come from these sources:
The price is extracted from the purchase order, or the receipt if no purchase order exists.
Distribution information is extracted from the distribution lines on the receipt.
Order detail is extracted from the IN_DEMAND table.
Other voucher data that is extracted from the purchase order or receipt includes:
Unit of measure (UOM) and UOM conversion rate.
Note. The Depletion Accounting Entry table stores data in the item's standard UOM; the Voucher Build process converts this to the receipt vendor's UOM.
Invoice ID from the packing slip number that is referenced on the original receiver.
Vendor and vendor location.
PeopleSoft Payables business unit.
The CM_ACTUAL_COST table identifies the receipt with the depleted transaction. For the same receiver line or distribution, it is summed for one voucher or distribution line.
The Voucher Build process assigns voucher IDs for each voucher based on the next voucher ID that is available from the PeopleSoft Payables business unit. The process uses the packing slip number on the receiver as the invoice ID. To prevent duplicate invoice IDs, the process increments the ERS_INV_SEQ number field by one each time a packing slip is used as the invoice ID.
Voucher Build pre-edit errors for Consigned Inventory vouchers are logged on the Consigned Inventory Voucher Exceptions page.
See Also
Managing Consigned Purchases Inventory
PeopleSoft Payables generates refund checks for PeopleSoft Receivables. The Receivables Refund Application Engine process (AR_REFUND) populates the voucher staging tables with refund voucher data for processing by the Voucher Build process.
See Also
The Matching process calls the Voucher Build process to automatically create debit memo adjustment vouchers to resolve matching exceptions between the amount on a voucher and the purchase orders and receivers that are associated with that voucher. You can dispatch debit memo information to the vendor using print, phone, fax, email, or electronic data exchange (EDX). The creation of the debit memo voucher requires:
An agreement with the vendor that allows the adjustment to the voucher.
You define this agreement on the Vendor component (VNDR_ID).
A match rule that allows debit memo vouchers.
Match rules are defined on the Match Rule Type page, the Match Rules page, and the Match Rule Control page.
The Matching process to be run.
You can run the Matching process in batch or you can initiate the Matching process from the Match Workbench.
Note. You cannot select debit memos as a voucher build interface
from the Voucher Build page. The Matching process calls the Voucher Build
process to create the debit memo adjustment vouchers.
When the Voucher Build process is initiated, debit memo adjustment vouchers
are handled similarly to other voucher build source transactions.
See Also
Establishing Matching and Document Association Options
Managing Matches and Match Exceptions
Processing Debit Memo Adjustment Vouchers
The Voucher Build process provides support for data that is connected through EDI. This flowchart illustrates how the EDI Manager integrates with the Voucher Build process:
EDI Manager and Voucher Build process flow
Typically, you use a private value-added network (VAN) to exchange EDI transactions. However, you can also use the internet, a dedicated link, or a sole-source provider.
To process EDI transactions:
Translate the EDI file.
The translator converts the EDI transactions into a PeopleSoft business document format. A PeopleSoft business document is a layout that describes the fields—including name, type, length, format, short name, and long name—that make up the EDI file.
To translate a data file into a PeopleSoft business document, use a translation tool that prepares, parses, and maps the flat file into the PeopleSoft business document format. You can develop this tool yourself, or you can use third-party tools that are readily available.
Use EDI Manager to load the business document.
EDI Manager uses a supplied EDI agent Structured Query Report (SQR) to import the electronic data flat file, translate the data using the PeopleSoft business document layout, and stage the data in the Voucher Staging tables in the PeopleSoft database.
Use the Schedule Inbound EC Agent - Run Control Parameters page in EDI Manager to load the flat file with the invoice data into the staging tables.
Confirm that the data loaded into the staging tables successfully.
Use the Business Document Summary page in EDI Manager to confirm that the status is Loaded.
Run the Voucher Build process to create voucher records and load them in the Voucher tables.
Use the outbound AP_VCHR_MESSAGE_OUT EIP that was initiated in the Voucher Build process to send verification messages to the sender.
Note. In addition to delivering the outbound AP_VCHR_MESSAGE_OUT EIP as an application message, PeopleSoft also delivers it as a web service (VoucherOut). Enabling web services is discussed in the PeopleTools PeopleBook: Integration Broker.
See PeopleTools PeopleBook: Integration Broker
Invoices that are entered into the system through EDI Manager might contain a blank space or the word Next in the Voucher ID field. The system automatically assigns voucher IDs for these vouchers during the Voucher Build process regardless of whether the PeopleSoft Payables business unit is set up for auto-numbering.
The Voucher Build process assigns match delay days to EDI transactions that require matching based on the PeopleSoft Payables hierarchy, business unit, origin, control group, vendor, and the ability to override on the voucher. If you do not define match delay days on the PeopleSoft Payables hierarchy, the Voucher Build process will not assign match delay days. As an example, if the match delay days are five days, the system adds five days to the entry date to determine the match due date. On the Match Request page, enter a date in the As of Date field to work in conjunction with the match due date. The Matching process selects only the vouchers that are ready to be matched as of that date. Match delay days are applicable only to EDI transactions and XML transactions. These types of transactions usually are processed in the system before the lines are received. Using match delay days enables you to wait to include these transactions in the Matching process.
When EDI transactions have been processed, they are deleted from the voucher staging tables. The Voucher Build process places any vouchers that receive pre-edit validation errors in the quick invoice entry tables for review and correction using the Quick Invoice Entry component.
Voucher Build Minimum Data Requirements for EDI
The following lists show the minimum sets of fields that the Voucher Build process requires when you supply the voucher header, voucher line, and distribution line information:
Voucher header:
ROW_ID
BUSINESS_UNIT
INVOICE_ID
INVOICE_DT
VENDOR_ID
OPRID
GROSS_AMT
Voucher line:
ROW_ID
BUSINESS_UNIT
MERCHANDISE_AMT
VOUCHER_LINE_NUM
Distribution line:
ROW_ID
BUSINESS_UNIT
VOUCHER_LINE_NUM
DISTRIB_LINE_NUM
ACCOUNT
MERCHANDISE_AMT
The particular fields that are required for any given run of the Voucher Build process can vary depending on the following circumstances:
When you are trying to associate invoice lines to a purchase order, the vendor ID is optional and the distribution line should be absent.
The rest of the required fields vary depending on the Voucher Build code.
When you are trying to associate invoice lines to a receiver, the distribution line should be absent and the rest of the required fields vary depending on the Voucher Build code.
You can build distribution lines from voucher line information without associating purchase order or receiver lines by specifying the general ledger business unit and account, at a minimum, along with any additional ChartField information, on the voucher line.
See Also
Initiating the Matching Application Engine Process
PeopleTools PeopleBook: Supported Integration Technologies
The Voucher Build process creates ERS vouchers from procurement receipt records. The receipts must be priced and have extended merchandise amounts.
The Voucher Build process creates ERS vouchers from receipts that reference a purchase order, as well as receipts that do not (non-PO receipts). For non-PO receipts, the process creates ERS vouchers only for receipt lines that have unit prices (priced receipts). These unit prices can be populated online from the item master or supplied by an external receipt load interface module.
To create ERS vouchers, you must identify the vendor location as an ERS vendor and set up the PeopleSoft Payables business unit (on the Payables Definition - Voucher Build page) to allow ERS transactions. You establish ERS options on the Procurement Control - ERS Options page, but you can also override them on the Payables Definition - Voucher Build page.
The Voucher Build process creates separate ERS vouchers for each packing slip that is referenced on a single receipt and multiple ERS vouchers from a single receipt, as receipt lines are marked as received. You can either create the ERS voucher invoice date from the receipt date or let the freight terms on the ERS receipt determine whether to use the receipt of the shipment date as the invoice date.
If the same packing slip number is used as the invoice number on multiple ERS vouchers (because an ERS receipt was partially invoiced), the pre-edit subprocess adds an ERS sequence number (ERS_INV_SEQ) to the ERS voucher header. This prevents the Duplicate Invoice Checking feature from rejecting ERS vouchers that have the same packing slip number and have been built from the same receipt.
You can search using packing slip number information on two voucher entry pages:
Regular voucher entry, on vouchers with an ERS source type.
Summary Invoice Entry voucher.
Note. Matching does not create ERS vouchers in PeopleSoft Payables. However, on the receiver you can require that ERS vouchers be matched after they pass the voucher edit subprocess. If you do not require matching, the voucher edit subprocess flags the receipts as approved for payment.
See Also
Accessing the Voucher Component
The Billing Generate AP Vouchers SQR process (BIGNAP01) initiates the creation of PeopleSoft Payables vouchers for interunit bills. The process takes interunit billing information from the PeopleSoft Billing tables and populates the PeopleSoft Payables voucher staging tables with voucher data for processing by the Voucher Build process.
See Also
Running the Generate AP Vouchers Process (BIGNAP01)
The Spreadsheet Voucher feature provides an offline entry component that you use to enter invoice data. The Voucher Build process handles the defaults and edit processing, similarly to quick invoice processing. PeopleSoft provides you with an Microsoft Excel file that you can use to create multiple voucher entry worksheets.
The Voucher Build process assigns match delay days to XML transactions that require matching based on the PeopleSoft Payables hierarchy, business unit, origin, control group, vendor, and the ability to override on the voucher. As an example, if the match delay days are five days, the system adds five days to the entry date to determine the match due date. If you do not define match delay days on the PeopleSoft Payables hierarchy, the Voucher Build process will not assign match delay days and use the entry date as the match due date. On the Match Request page, enter a date in the As of Date field to work in conjunction with the match due date. The Matching process selects only the vouchers that are ready to be matched as of that date. Match delay days are applicable only to EDI transactions and XML transactions. These types of transactions usually are processed in the system before the purchase order lines are received. Using match delay days enables you to wait to include these transactions in the Matching process.
See Also
Initiating the Matching Application Engine Process
Entering and Importing Spreadsheet Vouchers
The Summary Invoice Entry component enables you to enter minimal invoice and purchase order information, such as vendor, PO number, invoice number, invoice date, nonmerchandise amounts, and gross amount, to create a voucher. The Voucher Build process builds the voucher, including the voucher lines and distribution lines, from the selected purchase order and associated receipts.
See Also
The Quick Invoice Entry component provides efficient data entry for large volumes of similar invoices or invoices for which you can rely on defaults to complete most of the voucher details. The Quick Invoice Entry component contains minimal online edits; default and edit processing is handled by the Voucher Build process.
See Also
PeopleSoft Pay/Bill Management generates payable time information for contractors that the Voucher Build process can build into vouchers. The Front Office to AP Application Engine process (FO_TO_AP) submits contractors' payable time to the voucher staging tables for voucher build processing.
See Also
As a part of the procurement card reconciliation process, PeopleSoft Purchasing stages PCard prepayment voucher and regular voucher data in the voucher staging tables. The Voucher Build process then creates payments and accounting entries for the PCard transactions. You can create both the expense and payment accounting entries from the PCard transactions in PeopleSoft Payables, and you can process PCard transactions against purchase orders.
For purchase order-related transactions, the merchandising vendor is retained on the voucher line to support the matching process, if applicable.
Note. The PCard interface between PeopleSoft Purchasing and Payables supports encumbrance accounting and Commitment Control budget-checking.
Note. Because VAT calculation, rebate, and recovery details for PCard vouchers are maintained in PeopleSoft Purchasing, PCard vouchers in a VAT environment can produce Voucher Build process errors. These are reported on the Build Errors page and the Voucher Build Error Detail page in a similar way as other Voucher Build process errors. However, unlike other Voucher Build process errors, you correct PCard voucher errors using the Reconcile Statement page in PeopleSoft Purchasing.
PCard vouchers are excluded from these Voucher Build process pages:
Voucher Build (VCHR_BATCH_RQST).
Voucher Build Application Engine Process (AP_VCHRBLD).
See Also
Loading Procurement Card Statements to Application Tables
PeopleSoft Promotions Management enables a salesperson to authorize a scheduled payment or issue a field draft, or manual check, to customers who are established vendors in PeopleSoft Payables. PeopleSoft Promotions Management sends voucher transactions to the Voucher Staging tables, from which the Voucher Build process selects data and processes it.
To process manual payments from PeopleSoft Promotions Management using the Voucher Build process, you must specify a valid bank code, bank account, and check number on the accompanying payment record.
PeopleSoft Payables online voucher processing does not allow recorded payment transactions to be saved with the status Recycle. If a recorded payment transaction passes the Voucher Build process pre-edit validation and receives an error such as an invalid ChartField combination, the transaction is modified from a recorded payment to a scheduled payment, with the payment placed on hold. You must correct this error in the online Voucher component, or delete the voucher from PeopleSoft Payables and resubmit it with valid information from PeopleSoft Promotions Management.
See Also
Processing Payments for Promotional Activity
PeopleSoft Real Estate Management generates lease payment information that the Voucher Build process can build into vouchers. The Voucher Build - Staged Voucher Selection process (AP_VB_STGVCH) transmits the lease payment data to voucher staging tables. The process applies PeopleSoft Payables defaulting logic, and then calculates the appropriate VAT and sales and use taxes. Though the process can create positive or negative vouchers, it does not create prepayment vouchers.
If the real estate transaction is withholding applicable but the vendor is not configured for withholding, the process generates an exception. You must correct the errors, by defining withholding values for the vendor and the voucher, to continue processing the voucher.
The Voucher Build process also updates the detailed lease payment transactions with the associated voucher ID after this ID has been assigned by the Voucher Build process. PeopleSoft Real Estate Management appends a three-digit sequence number to the lease payment number. This number is handled by the system as a voucher ID number, not as an invoice number. Because of this functionality, you must ensure that the Assign Invoice ID option is selected for these vouchers so that the system assigns the voucher ID number as the invoice ID number.
See Also
Running the Interface to AP/Billing Process
The Voucher Build process creates vouchers from recurring voucher contracts that were established using the contracts functionality in PeopleSoft Purchasing.
The Voucher Build process controls the release of the vouchers based on the contract release date option that is specified for the PeopleSoft Payables business unit on the Payables Definition - Voucher Build page.
The Voucher Build process selects contract data that is staged to the contract staging tables. In addition to the general Voucher Build edits, the process also ensures that the total gross amount does not exceed the maximum limit for the contract. If the voucher exceeds the limit, the Voucher Build process logs an error in the contract tables and does not process the voucher. When Voucher Build processes the staged contracts, it increases the cumulative total for the contract by the total gross amount for the new vouchers and registers the contract lines by sending data to the CNTRCT_EVT_VCHR table.
The Voucher Build process builds the associated nonmerchandise charge records for miscellaneous, freight, and tax charges that are associated with the recurring contract voucher.
If the contract has some retention amounts, the Voucher Build process creates a voucher with two scheduled payment records, one for the amount to be paid now and one for the retention amount that is created and placed on hold.
For recurring PO voucher contracts, which reference purchase orders, the Voucher Build process also accesses the PO tables in addition to the contract staging tables.
See Also
Using Voucher and Order Contracts
The Voucher Build process creates adjustment vouchers for RTV transactions that are created in Purchasing. If an RTV adjustment does not reference a receipt, it is treated as a nonmatch RTV. Through the PeopleSoft Payables default hierarchy, you can either create automatic adjustments for RTV transactions that require credit memos or pass those transactions to the Quick Invoice Entry tables for review before further processing. You can maintain pending adjustment transactions by adding a reference to vendor credit memo documents or by making other adjustments before having the Voucher Build process turn them into adjustment vouchers. The RTV transactions have a Vendor RTV action code that indicates whether the credit memo should be generated and the nature of the RTV transaction. This table lists the RTV action codes:
Action Code |
Description |
Issue Credit Only |
The vendor issues a credit memo only. |
Replace and Invoice |
The vendor issues a credit memo and reinvoices for replaced merchandise that was shipped against the original PO schedule. RTV credit vouchers for replacements are deducted from the matched quantities on the PO so that the replacements can be received against the original PO. These deductions occur from the Matching process. All replace and invoice RTV vouchers are created as requiring matching. |
Exchange and Invoice |
The vendor exchanges for like merchandise, issues credit for the returned merchandise, and reinvoices for the new merchandise against the original PO. A change order is created against the original PO to add the new item that the vendor ships. |
Before processing RTV transactions, you must enable RTV credit memo processing for PeopleSoft Payables business units on the Payables Definition - Voucher Build page and specify the voucher adjustment option.
The Voucher Build process accesses the RTV tables to obtain the information that is required to create adjustment vouchers and creates miscellaneous charges for any RTV fees. Sales tax and VAT applicability codes are taken from the original voucher, if they are available. The Voucher Build process accesses the RTV records that require vouchers to be created and assigns the voucher ID number.
When the Voucher Build process creates an RTV credit voucher that must be rematched, the following fields or sets of fields in the Voucher component are unavailable for modification:
Advanced Vendor Search.
Invoice Number.
Invoice Date.
Pay Terms.
Vendor.
Voucher line amount.
If the RTV credit voucher does not have to be rematched, the Invoice ID and Invoice Date fields are available for edit.
The following Voucher component fields or sets of fields are always available for modification, regardless of whether the RTV credit voucher needs to be rematched:
Voucher header amounts, including freight, miscellaneous, sales and use tax, and VAT, when applicable.
Invoice Number.
Invoice Date.
Distribution line amounts.
See Also
PeopleSoft eSettlements loads self-service invoices to the quick invoice entry tables for processing by the Voucher Build process.
See Also
PeopleSoft Payroll, Student Administration, and other external systems can process vendor payments, such as payroll deductions, through PeopleSoft Payables using the inbound Voucher EIP. The Voucher EIP uses Application Messaging and the VOUCHER_BUILD message definition to populate the voucher staging tables with the necessary information for building voucher record sets.
Note. In addition to delivering the inbound VOUCHER_BUILD EIP as an application message, PeopleSoft also delivers it as a web service (Voucher). Enabling web services is discussed in the PeopleTools PeopleBook: Integration Broker.
Note. Integration Point (IP) and Enterprise Integration Point (EIP) refer to the same functionality. You might see both used interchangeably.
This flowchart illustrates the VOUCHER_BUILD message subscription process:
VOUCHER_BUILD message subscription inbound process flow
To view the VOUCHER_BUILD application message definition in detail, see the Enterprise Integration Point Catalog.
PeopleSoft Payroll and Student Administration, as well as third-party applications, publish voucher data to the application message, and PeopleSoft Payables subscribes to it. The subscription process transfers the contents of the message to the inbound voucher staging tables. The Voucher Build process then builds voucher records from the staged data and writes them to the PeopleSoft Payables voucher tables.
If external parties send bad data (for example, an invalid business unit) as part of the message, the subscription process flags the message as being in error. You must intervene manually using the application messaging error correction feature to correct the data before the message can be processed successfully. When you save the message after correcting the data, the message status is automatically set to Reprocess.
The Voucher Build process assigns voucher IDs if they aren't passed by the application message. When the Voucher Build process finishes processing a staged record, the record is deleted from the staging table.
Note. The subscription process accepts data for new vouchers only. Vouchers that already exist in the PeopleSoft Payables voucher tables must be updated online using the Voucher component or the Voucher Maintenance component.
Note. You can use the outbound AP_VCHR_MESSAGE_OUT EIP to
dispatch voucher and debit memo adjustment voucher information to vendors.
In addition to delivering the outbound AP_VCHR_MESSAGE_OUT EIP as an
application message, PeopleSoft also delivers it as a web service (VoucherOut).
Enabling web services is discussed in the PeopleTools PeopleBook:
Integration Broker.
Note. You use the Vendor EIP to transfer vendor information
to PeopleSoft Payables from PeopleSoft Payroll, Student Administration, and
other external systems.
In addition to delivering the Vendor EIP as application messages, PeopleSoft
also delivers it as a web service (Vendor). Enabling web services is discussed
in the PeopleTools PeopleBook: Integration Broker.
See Also
Importing Vendors Using the Vendor EIP
Dispatching Debit Memo Information
PeopleSoft Global Payroll PeopleBook
PeopleSoft Integration Point Catalogue
PeopleTools PeopleBook: Integration Broker
Two ways are available to integrate XML invoices with the Voucher Build process:
Using XML invoices that are mapped to the VOUCHER_BUILD message definition for integrating with the Voucher Staging tables using Application Messaging.
This process is also known as the Voucher EIP.
Note. The Spreadsheet Voucher feature uses the Voucher EIP process (VOUCHER_BUILD) to import files to the PeopleSoft systems.
Using XML invoices that are defined in the Open Applications Group (OAG) standardized format, which are handled in Integration Broker, mapped to the PeopleSoft invoice structures by the Transform OAG to PSFT Invoice Application Engine process (EM_INV_OAG), and connected to the quick invoice tables using the EM_VOUCHER_IN application message definition.
Important! When you are building XML invoices using Integration Broker, the date format must be YYYY/MM/DD, or the subscription process fails.
The OAG XML invoice interface with the Voucher Build process is discussed in full in separate documentation.
See Processing Invoices.
Note. In addition to delivering the VOUCHER_BUILD and EM_VOUCHER_IN EIPs as application messages, PeopleSoft also delivers them as web services (Voucher and SelfServiceInvoice, respectively). Enabling web services is discussed in the PeopleTools PeopleBook: Integration Broker.
PeopleSoft Payables users should also know that:
PeopleSoft Payables users may need to define codesets in Integration Broker that differ from those that are used by eSettlements.
OAG XML invoices must use the GL_Element tag to identify the Account ChartField if the invoice includes distribution information.
The Voucher Build process assigns match delay days to XML transactions that require matching based on the PeopleSoft Payables hierarchy, business unit, origin, control group, vendor, and the ability to override on the voucher.
If you do not define match delay days on the PeopleSoft Payables hierarchy, the Voucher Build process will not assign match delay days. As an example, if the match delay days are five days, the system adds five days to the entry date to determine the match due date. On the Match Request page, enter a date in the As of Date field to work in conjunction with the match due date. The Matching process selects only the vouchers that are ready to be matched as of that date. Match delay days are applicable only to EDI transactions and XML transactions. These types of transactions usually are processed in the system before the lines are received. Using match delay days enables you to wait to include these transactions in the Matching process.
See Also
Entering and Importing Spreadsheet Vouchers
Initiating the Matching Application Engine Process
PeopleTools PeopleBook: Integration Broker
Before using the Voucher Build process, you must set up the standard procurement control tables and establish the PeopleSoft Payables control hierarchy, including entering approved vendors in the system. In addition, you:
(Optional) Define Voucher Build criteria on the Voucher Build Code Definition page if you want to use voucher build codes.
Define Voucher Build options for PeopleSoft Payables business units on the Payables Definition - Voucher Build page.
(Optional) Define the business unit combination edit template for the Voucher Build process on the Procurement Control - General Controls page if you want to use ChartField combination editing.
Setup that is specific to each source transaction is discussed in the source transaction overviews.
See Also
Understanding Voucher Build Source Transactions
Specifying Voucher Build Criteria
Defining Procurement Controls for General Ledger Business Units
This section lists common elements and discusses how to:
Run the Voucher Build process.
Review process messages.
Review vouchers with errors.
See Also
Understanding Voucher Build Processing
Request ID and Description |
Identifies the current run of the run control. |
Page Name |
Definition Name |
Navigation |
Usage |
VCHR_BATCH_RQST |
Accounts Payable, Batch Processes, Vouchers, Voucher Build, Voucher Build |
Create a run control and request a run of the Voucher Build process. |
|
VCHR_EDIT_REQUEST3 |
Accounts Payable, Batch Processes, Vouchers, Voucher Build, Process Messages |
Monitor a voucher build processing run. |
|
VCHR_EDIT_REQUEST4 |
Accounts Payable, Batch Processes, Vouchers, Voucher Build, Build Errors |
Review a log of any voucher errors that occur during a voucher build processing run. Link to pages where you can view error details and correct errors. Errors that are logged include both pre-edit errors and recycled vouchers. |
Access the Voucher Build page (Accounts Payable, Batch Processes, Vouchers, Voucher Build, Voucher Build).
Run Control Options
From Date and To Date |
Enter dates to have the Voucher Build process select vouchers for which invoices are dated within the specified range. |
Assign Invoice ID |
Select to have the Voucher Build process assign an invoice ID to vouchers that were built from voucher sources that have no invoice ID or an invoice ID value of NEXT. The process assigns the voucher ID as the invoice ID. Note. You must select this option when the Invoice ID field on Real Estate Management invoices is blank to prevent the Voucher Build process from having build errors. |
Assign Invoice Date |
Select to have the Voucher Build process assign the current date as the invoice date to vouchers that are built from voucher sources that have no invoice date. |
Process Option |
Select the level at which to process vouchers. Depending on the option that you select, different fields become available in the Selection Parameters group box. Values are: Business Unit: The system processes vouchers that belong to the business unit that you enter in Selection Parameters. Process All Units: The system processes all business units. No fields are available in Selection Parameters. Process Contract: The system processes vouchers that belong to the contract ID that you enter in Selection Parameters. You must also enter a business unit. Process Group: The system processes vouchers that belong to the control group ID that you enter in Selection Parameters. You must also enter a business unit. Process Origin: The system processes vouchers that belong to the origin that you enter in Selection Parameters. You must also enter a setID. Process Vendor: The system processes vouchers that belong to the vendor ID that you enter in Selection Parameters. You must also enter a business unit. Process Voucher: The system processes the voucher with the voucher ID that you enter in Selection Parameters. You must also enter a business unit. This value is valid only for quick invoices and transactions in the online voucher tables. This value does not appear if you have selected a Voucher Edit Source of All. |
Voucher Sources |
Select the status of the sources that you want to process. Values are: All (Unrestricted): Both new and recycled vouchers. Errors/Staged Vouchers: Only vouchers that have pre-edit errors from prior Voucher Build process runs or that were staged for review during a prior run. New Voucher Data: New transactions from selected interface sources. Recycled Vouchers: Recycled vouchers in the online voucher tables. Voucher Maintenance: Vouchers that have been modified using the Voucher Maintenance component. Voucher Mass Maintenance: Vouchers that have been modified using the Voucher Mass Maintenance component. See Managing Vouchers. |
Interfaces
Voucher Build Interfaces |
Select a source from which to create vouchers. Values are: All Interfaces: All sources. Asset Lease Payments: PeopleSoft Asset Management lease payments. Billing Vouchers: Source transactions that are created through the Billing Generate AP Vouchers SQR process (BIGNAP01). Consignment Inventory: Consignment inventory source transactions. Contracts: Source transactions that are created through the Purchasing voucher contracts functionality. Custom: Voucher EIP source transactions from customized external interfaces. This value is delivered as inactive and must be activated to appear. Debit Memo from Matching: Source transactions that are created from the Matching process. EDI: EDI source transactions. Evaluated Receipts (ERS): ERS source transactions. Lease Payments: Real Estate Management lease payment transactions. Pay/Bill Management: Contractors' payable time transactions from Pay/Bill Management. Payroll Interface: Voucher EIP source transactions from Payroll. Procurement Card: Procurement card source transactions from Purchasing. Promotions Management: Promotions Management source transactions. Quick Invoice: Quick invoice entry source transactions. The system considers summary invoices as quick invoices after they are saved. Receivables Customer Refunds: Refund source transactions that are created in Receivables. Return to Vendor: RTV source transactions. Self Service Invoices: Self-service invoice transactions from eSettlements. Services Procurement: Services Procurement transactions. Student Administration: Voucher EIP source transactions from Student Administration. Vendor Rebates/Claimbacks: Voucher source transactions and claim vendor rebate transactions from Purchasing, and indirectly from Receivables. XML Invoice: Spreadsheet vouchers and XML invoices that are interfaced using the EM_VOUCHER_IN application message definition or the SelfServiceInvoice web service. |
Publish Voucher Messages |
Select to publish the voucher message in XML format when the Voucher Build process successfully creates the voucher and the data exists in the PS_VOUCHER table. The outbound AP_VCHR_MESSAGE_OUT EIP application message or the VoucherOut web service dispatches the voucher information to a predefined location that the vendor can access to retrieve their voucher information. See PeopleSoft Integration Point Catalogue See PeopleTools PeopleBook: Integration Broker |
Contract Voucher Action |
This field is enabled when you select All Interfaces or Contracts in Voucher Build Interfaces. The default is to stage contract vouchers. Values are: Build Voucher: Create vouchers for all contracts that are processed and successfully pass all Voucher Build process editing requirements. Stage Voucher: Stage all contract vouchers that have been created in the pre-edit step of the Voucher Build process in the quick invoice entry tables for user review. Before you can run the voucher edit step of the Voucher Build process for these vouchers, you must release them by reviewing them in the Quick Invoice Entry component, modifying them as needed, and setting their build status to To Build. |
Important! You can specify up to a maximum of 27 business
units to run in a single run control; to process more than 27 business units,
create additional run controls. You can process multiple run controls concurrently.
After saving the run control, editing the business units (such as deleting
business units and adding new business units) may cause display issues. Click
the Refresh button or quit the page and access
it again to avoid this display issue.
See Also
Understanding Voucher Build Processing
Access the Process Messages page (Accounts Payable, Batch Processes, Vouchers, Voucher Build, Process Messages).
Review the messages that the Voucher Build process produces. These are the same messages that appear in the Process Monitor.
The Request Status group box shows the current status of the request. A process instance number appears after you run the request. The Details group box shows the time, severity, and text of the message. Click Refresh Log to display the messages that the run generated.
Access the Build Errors page (Accounts Payable, Batch Processes, Vouchers, Voucher Build, Build Errors).
Refresh Log |
Click to display the messages that the run generated. |
When you run the Voucher Build process for all business units, if there are any vouchers in stage that have invalid business units, the Vouchers in Stage with Invalid Business Unit grid will appear and show all vouchers with an invalid business unit.
Insert icon picture here |
Click this icon to delete individual vouchers. The deleted row will be removed from staging table after clicking save. |
Delete All |
Click this button to delete all returned rows from the staging table. After delete, this grid will become invisible. |
|
Click the Examine Error Messages button to access the Voucher Build Error Detail page, where you can view Voucher Build process error details for the voucher and transfer to the appropriate error correction component:
|
|
Click the Correct Errors button to access the appropriate error correction component directly. |
See Also
Understanding Voucher Build Processing
Entering and Processing Vouchers Online: General Voucher Entry Information
This section provides an overview of voucher build error review and discusses how to review Voucher Build process error details.
Two kinds of Voucher Build process errors exist: pre-edit errors for vouchers that cannot be passed to the voucher edit subprocess, and recycle status for vouchers that have gone through the voucher edit subprocess but failed at least one validation. You correct pre-edit errors in the Quick Invoice Entry component and vouchers that are in recycle status in the online Voucher component or the Voucher Maintenance component.
Note. You correct Voucher Build errors for procurement card vouchers in a VAT environment on the Reconcile Statement - Procurement Card page in Purchasing.
Several ways are available to search for and review vouchers with Voucher Build process errors:
You can view a list of vouchers with pre-edit errors and vouchers in recycle status for a particular processing run of the Voucher Build process on the Build Errors page, which is included in the Voucher Build run control component.
The Recycle Vouchers page contains links to the Voucher Build Error Detail page, where you can view error details and access the appropriate voucher correction component or page: the Quick Invoice Entry component, the online Voucher component, or the Reconcile Statement - Procurement Card page. The Build Errors page also contains direct links to the appropriate voucher correction component.
You can use the Voucher Build Error Detail page to search for vouchers with Voucher Build errors and link from there to the appropriate voucher correction component.
You can use the Voucher Maintenance Search page to search for vouchers in recycle status and correct them in the Voucher Maintenance component.
Note. Consigned Inventory vouchers with Voucher Build errors do not appear in the pages and components that are described here. You can view them on the Consigned Inventory Voucher Exceptions page and correct them in PeopleSoft Supply Chain Management.
See Also
Reviewing Vouchers with Errors
Entering and Processing Vouchers Online: General Voucher Entry Information
Page Name |
Definition Name |
Navigation |
Usage |
VCHR_BATCHERR_PG |
|
Review the details for any Voucher Build process errors on a voucher. Access the appropriate error correction component or page, the Quick Invoice Entry component, the online Voucher component, or the Reconcile Statement - Procurement Card page, depending on the type of voucher and error. |
|
AP_CONS_INV_ERRINQ |
Accounts Payable, Vouchers, Maintain, Consigned Item Errors, Consigned Inventory Voucher Exceptions |
Review consigned inventory items with Voucher Build process errors. View the PeopleSoft Payables business unit, vendor ID, vendor location, item ID, receiving business unit, receipt number, base quantity, and standard unit of measure for the consigned inventory item with Voucher Build process errors. |
Access the Voucher Build Error Detail page (Accounts Payable, Vouchers, Maintain, Voucher Build Error Detail).
Note. Five scroll areas can appear on this page: Header Errors, Miscellaneous Charge Errors, Invoice Line Errors, Distribution Line Errors, and Scheduled Payment Errors. Only scroll areas that contain errors appear.
Correct Errors |
Click to access the appropriate error correction component or page:
|
Field Name |
Displays the field where the error exists. |
Message |
Displays an explanation of the error. |
See Also
Entering and Processing Vouchers Online: General Voucher Entry Information
Reconciling Procurement Card Transactions Manually