Understanding Voucher Build Source Transactions

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 Lease Administration 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).

  • Payment Request Transactions.

  • Document Management Transactions (Invoice Imaging interface).

  • IPAC Vouchers.

  • 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.

Consignment inventory is a supply chain management strategy in which you store goods in a business unit without paying the supplier 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 supplier location (using the Consign Voucher field on the Supplier Information - Procurement Options page at the supplier location level.

Processing options are:

Term

Definition

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 supplier, and the invoice is not finalized until an invoice is received from the supplier.

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 supplier's UOM.

  • Invoice ID from the packing slip number that is referenced on the original receiver.

  • Supplier and supplier 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.

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.

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 supplier using print, phone, fax, email, or electronic data exchange (EDX). The creation of the debit memo voucher requires:

  • An agreement with the supplier that allows the adjustment to the voucher.

    You define this agreement on the Supplier 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.

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.

EDI Transaction Processing

To process EDI transactions:

  1. 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.

  2. 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.

  3. 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.

  4. 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: Integration Broker.

    See PeopleTools: 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, supplier, 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 only applicable to EDI, XML, Document imaging, Spreadsheet vouchers, Online, Quick and Self Service invoices. 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 supplier 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.

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 supplier location as an ERS supplier 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.

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.

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, supplier, 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 only applicable to EDI, XML, Document imaging, Spreadsheet vouchers, Online, Quick and Self Service invoices. 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.

The Summary Invoice Entry component enables you to enter minimal invoice and purchase order information, such as supplier, 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.

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.

The Voucher Build process assigns match delay days to Quick Invoice transactions that require matching based on the PeopleSoft Payables hierarchy, business unit, origin, control group, supplier, and the ability to override on the voucher.

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.

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 supplier 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).

PeopleSoft Lease Administration 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 supplier is not configured for withholding, the process generates an exception. You must correct the errors, by defining withholding values for the supplier 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 Lease Administration 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.

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.

PO Voucher Contracts

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.

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 supplier 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 supplier issues a credit memo only.

Replace and Invoice

The supplier 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 supplier 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 supplier 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 Supplier Search.

  • Invoice Number.

  • Invoice Date.

  • Pay Terms.

  • Supplier.

  • 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.

PeopleSoft eSettlements loads self-service invoices to the quick invoice entry tables for processing by the Voucher Build process.

The Voucher Build process assigns match delay days to self-service invoices that require matching based on the PeopleSoft Payables hierarchy, business unit, origin, control group, supplier, and the ability to override on the voucher.

PeopleSoft Payroll, Student Administration, and other external systems can process supplier 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: 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 suppliers.

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: Integration Broker.

Note: You use the Supplier EIP to transfer supplier information to PeopleSoft Payables from PeopleSoft Payroll, Student Administration, and other external systems.

In addition to delivering the Supplier EIP as application messages, PeopleSoft also delivers it as a web service (Supplier). Enabling web services is discussed in the PeopleTools: 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.

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: 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, supplier, 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 only applicable to EDI, XML, Document imaging, Spreadsheet vouchers, Online, Quick and Self Service invoices. 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.