This chapter provides an overview of purchase order dispatch and discusses how to:
Dispatch purchase orders.
Use the Purchase Order Dispatch/Purchase Order Change Request EIP (enterprise integration point).
With PeopleSoft Purchasing, you can dispatch and print purchase orders individually or in volume. You can dispatch purchase orders by printing, fax, phone, email, or electronic data exchange (EDX). You can also dispatch them from the online pages or through a batch process. A purchase order must have a status of Approved and have passed the commitment control budget check to be eligible for dispatch.
Dispatching Purchase Orders Using Online Pages
Use one of these pages to dispatch purchase orders individually:
Maintain Purchase Order - Purchase Order page.
Express Purchase Order - Purchase Order page.
Buyer's WorkBench.
Here are the basic steps to dispatch purchase orders from an online page:
Access one of the online pages.
Click the Dispatch button on the page.
The Dispatch Options page appears.
Enter dispatch options for the purchase order.
(Optional) Select a report template if you are dispatching the purchase order using Oracle BI Publisher.
You have the flexibility of changing the purchase order formats by choosing different report template IDs for different types of purchase orders. The template ID for dispatched purchase order can be defined at the business unit level, on the run control for the dispatch process, or on the purchase order. To use the BI Publisher for purchase orders in both PeopleSoft eProcurement and PeopleSoft Purchasing, select the Enable XML Publisher check box on the Purchasing page of the Installation Options component.
The use of BI Publisher is based on whether the Enable XML Publisher check box is selected on the installation options Purchasing page. For batch processes, you can select to use BI Publisher or use the SQR from the Run Control page.
See PeopleTools PeopleBook: BI Publisher for PeopleSoft .
Click the OK button.
The system dispatches the purchase order using the method set up on the PO Header Details page.
Warning! If a purchase order is on hold, dispatching that purchase order from the Maintain Purchase Order - Purchase Order page, Express Purchase Order - Purchase Order page, or Buyer's WorkBench automatically removes the purchase order from hold and dispatches it. If a purchase order is on hold and you dispatch that purchase order through the PO Dispatch/Print process, the system does not dispatch the purchase order and it remains on hold.
Note. You can only print out a limited number of pages when dispatching comments.
Dispatching Purchase Orders Using a Batch Process
Use the Dispatch Purchase Orders page to schedule a background batch job that dispatches a single purchase order or multiple purchase orders that meet your selection criteria. After purchase orders are successfully dispatched, their statuses are updated to Dispatched.
Note. The PO Dispatch/Print process dispatches purchase orders associated with recurring purchase order vouchers; however, the PO_STATUS values on the purchase orders are never set to D (dispatched).
When you run the PO Dispatch/Print process from the Dispatch Purchase Orders page, the PeopleSoft Process Scheduler Request page offers you three options:
PO Dispatch & Email multi-process job |
Select to run the Single PO Dispatch/Print SQR Report process (POPO005) and then the Email Application Engine process (PO_PO_EMAIL). |
PO Dispatch/Print process |
Select to run only the PO Dispatch/Print SQR Report process (POPO005). |
PO XMLP Dispatch |
Select to run only the PO XMLP Dispatch process (PO_DISPATCH). |
Email process |
Select to run only the Email Application Engine process (PO_PO_EMAIL). |
When you use the email dispatch method, the PO Dispatch/Print process creates an output file in the location that you specify on the File Locations page. The Email process picks up the output file from the specified location and sends out an email message with the purchase order as an attachment. When the dispatch method is fax, the dispatch process creates a purchase order file and a fax control file in the locations that you specify on the File Locations page.
The PO Dispatch/Print process contains business process logic and is responsible for retrieving data from the database, constructing purchase orders, and sending the output files to the proper locations. To actually deliver purchase orders to the recipients through designated channels, a separate process is required.
To dispatch by email, you first need to run the PO Dispatch/Print process to create the output files and to update the PO Email queue table. You then run the Email process.
The Email process is a PeopleSoft Application Engine process that picks up the email output file created by the PO Dispatch/Print process in the location specified on the File Locations page and generates an email message through the SMTP gateway to be delivered to the recipient through the internet. If you specify a vendor contact on the Vendor Details page on the purchase order, the Email process sends the email to the address that you specify in the Email ID field on the Vendor Information - Contacts page. If you do not specify a vendor contact on the purchase order, the Email process sends the email to the address that you specify in the Email ID field on the Vendor Information - Address page. When a message is sent successfully, it is removed from the email queue table; however, the purchase order output files are not deleted.
To simplify dispatching by email, you can use the PO Dispatch & Email job on the PeopleSoft Process Scheduler Request page that you access from the Dispatch Purchase Orders page. The PO Dispatch & Email job automatically runs the PO Dispatch/Print process and then the Email process. For online dispatches, the system always schedules the PO Dispatch & Email job.
If you are using the fax dispatch method, you must use a third-party fax software to handle the output files.
If the dispatch method is EDX, the PO Dispatch/Print process does not create an output file, but it updates a series of EC outbound tables. These tables are updated: PS_PO_HDR_OUT_EC, PS_PO_LINE_OUT_EC, PS_PO_SHIP_OUT_EC, and PS_PO_SHIP_OUT_EC.
When you dispatch a purchase order by telephone, Phone must be selected as the dispatch method. This selection ensures that when you dispatch a purchase order either from one of the pages or using the PO Dispatch/Print process, the status of the purchase order updates to Dispatched.
An important factor to consider when you select an appropriate output format is the recipient. When you dispatch by email, you may want to select a dispatch output format of PDF or HTM, because these formats employ readers that are commonly found on user systems. When you dispatch by fax, you may want to consider that most fax software applications are compatible with Postscript - (PS) or PCL - (HP) encoded files.
When you generate the PO Dispatch/Print report from the Purchase Orders Print page, a hard copy of the purchase order prints, but the purchase orders are not dispatched. When you print the purchase order using the Purchase Orders Print page, the word Unauthorized prints on the purchase order to differentiate it from an actual dispatched purchase order.
Note. A purchase order cannot be dispatched using email or fax when the email ID or fax number is not available; in other words, they are either not specified on the document or they are not available from the vendor profile. Some purchase orders that are scheduled to be dispatched using the PO Dispatch/Print process may not be processed due to a missing email ID or fax number. Check the log file for those purchase orders that are not dispatched.
Dispatching Purchase Orders Using Oracle BI Publisher
The PO dispatch is available using Oracle BI Publisher through PeopleSoft Purchasing and eProcurement. This functionality provides you a seamless interface and consistent report format between Purchasing and eProcurement dispatches. You can print email, or fax the report as an attachment.
The Oracle BI Publisher feature is a template-based reporting solution that separates the data extraction process from the report layout and enables the reuse of extracted application data into multiple report layouts. You can change the format or layout of a purchase order report without changing the underlying program that controls the business logic. The format and layout include the appearance of the report and the addition or removal of fields on the report as long as those fields are available as part of the purchase order dispatch data. You can create the reports using SQR or BI Publisher formats.
You can change purchase order report formats by selecting different report template IDs for different types of purchase orders. You can define the template ID for dispatched purchase orders at the business unit level, the run control for the dispatch process, or the individual purchase order.
To use the Oracle BI Publisher for purchase orders in both PeopleSoft eProcurement and PeopleSoft Purchasing, select the Enable XML Publisher check box on the Purchasing page of the Installation Options component. This PeopleSoft application is delivered with sample data already set up to generate an BI Publisher purchase order that uses a similar format as the SQR report. Use this data as a starting point to create your own layout for purchase orders using the BI Publisher. Sample data in Oracle BI Publisher (Reporting Tools, BI Publisher) includes:
Report Definition: PO_DISPATCH
Data Source ID: PO_DISPATCH
Template File: PO_DISPATCH.RTF
When dispatching purchase orders, the system must identify the BI Publisher template ID. These steps describe how you use the system and the process the system uses for defining a template ID for a purchase order:
You enter the template ID for an individual purchase order using the PO Header Details page or the Dispatch Options page. If the Template ID field is blank on the purchase order, then the system checks the:
Run Control Page for the Dispatch Process: Enter the template ID for the individual process run of the dispatch process. This dispatch process is the PeopleSoft Job POXMLP and can be accessed from the Dispatch Purchase Orders page in PeopleSoft Purchasing. If the Template ID field is blank on this run control page, then the system checks the:
Purchasing Business Unit: Enter the template ID for all purchase orders dispatched within one business unit by entering the template ID on the Purchase Order Images page within the Purchasing Business Unit component (BUS_UNIT_PM). If the Template ID field is blank on the Purchase Order Images page, then the system uses the value that you enter for the purchase order.
See PeopleTools PeopleBook: BI Publisher for PeopleSoft .
Tips About Dispatching and Printing Transactions
Here are some tips about dispatching and printing transactions:
The entry in the SQRDIR set in the PSSQR.INI (Microsoft Windows environment) or PSSQR.UNX (UNIX environment) file must be correctly defined and must point to the correct BINW where the SQR executables are installed.
This PeopleSoft application delivers an undefined (dummy) SQRDIR to enable you to install the SQRs in a location that best suits your configuration. If the SQRDIR is not pointing to the correct BINW directory, certain features do not work as designed. For example, CSV, enhanced HTM, and Postscript files are not produced correctly.
The email dispatch method is designed to work with an SMTP gateway.
The settings for the SMTP gateway must be entered when you set up a PeopleSoft Process Scheduler server.
See Also
Entering Express Purchase Orders
Entering Purchase Order Dispatch Options
Entering Purchase Order Header Details
Entering Purchase Order Header Information
Defining Transaction Dispatch Methods
Viewing Requisition Information
Dispatching from the RFQ Component
Preparing to Dispatch by Fax and Email
Entering Vendor Contact Information
PeopleTools PeopleBook: PeopleSoft Process Scheduler
This section discusses how to:
Run the PO Dispatch/Print process.
Select purchase orders for dispatch.
Page Name |
Definition Name |
Navigation |
Usage |
RUN_DISP_POPO005 |
Purchasing, Purchase Orders, Dispatch POs, Dispatch POs |
Run the PO Dispatch/Print process and dispatch purchase orders, run the Email process, or run the PO Dispatch & Email multiprocess job. |
|
PO_PICK_ORD2 |
Click the Select Purchase Order link on the Dispatch Purchase Orders page. |
Select a purchase order for processing. |
|
VENDOR_LOOKUP_SEC |
Click the Vendor Lookup link on the Select Purchase Order page. |
Search for vendors. |
Access the Dispatch POs page (Purchasing, Purchase Orders, Dispatch POs).
You can dispatch purchase orders based on the criteria that you enter on this page. You can also specify the language in which the printed report should appear.
Process Request Parameters
Statuses to Include
In the Statuses to Include group box, select whether to include purchase orders with Approved, Dispatched, or Pending Cancel statuses in this run of the dispatch. When a specific purchase order ID is not entered, you must select at least one option.
Dispatched |
Select to redispatch a dispatched purchase order or to print copies of dispatched purchase orders. |
Dispatch Methods to Include
Select which dispatch methods to include in this run of the process. Selected values are only used as a part of the data selection criteria. To change the method by which the purchase order is to be dispatched, you must modify the dispatch method on the Maintain Purchase Order - Purchase Order page.
|
Prints the purchase order and sets the purchase order status to Dispatched. You can select to format the printed purchase order using the SQR report (default) or BI Publisher. |
FAX |
The default output format from the PeopleSoft Process Scheduler Request page is PDF. If the fax software does not support the PDF file format, then select an output format that the fax software can handle. If the fax software does not support PDF files, we recommend that you process all of the purchase orders that are to be dispatched through fax together and that you do not print a hard copy at the same time. In the Dispatch Methods to Include group box, select the FAX method only and do not select the Print Copy check box. Then, on the Process Scheduler Request page, select the appropriate output format supported by your fax software. |
EDX |
Uses the dispatch process to update a series of EC outbound staging tables, including; PS_PO_HDR_OUT_EC, PS_PO_LINE_OUT_EC, and PS_PO_SHIP_OUT_EC. A service operation within the PeopleSoft Integration Broker is required to deliver purchase orders to the recipients through designated channels. The publishing of the outbound data (using a service operation) is sometimes a separate process and sometimes combined with the initial process. |
|
Uses the dispatch process to set the purchase order status to Dispatched and to create a purchase order file in the location that you specify on the File Locations page. The Email process (PO_PO_EMAIL) picks up the output file from the specified location and sends an email message with the purchase order as an attachment. |
Phone |
Uses the dispatch process to change the purchase order status to Dispatched. |
Miscellaneous Options
Chartfields |
Select Recycled AND Valid ChartFields to process purchase orders regardless of whether the ChartFields are valid or recycled. Select Recycled Chartfields to process only purchase orders with distribution lines whose ChartFields are identified as Recycled. (PO_LINE_DISTRIB.CHARTFIELD_STATUS = 'R'). Select Valid Chartfields to process only purchase orders with distribution lines whose ChartFields are identified as Valid. (PO_LINE_DISTRIB.CHARTFIELD_STATUS = 'V'). |
Change Orders |
Select Changed Orders to process only purchase orders that have been changed. Select Changed and Unchanged Orders to process changed and unchanged purchase orders. Select Unchanged Orders to process only purchase orders that have never been changed. |
Print Changes Only |
If you select to dispatch changed orders in the Change Orders field, the Print Changes Only check box becomes available. Select to dispatch only the changes to the purchase order, rather than the entire purchase order. If you create the purchase order from a contract with the Release To Single PO Only option selected, select this check box to have the system send only the latest changes to the supplier. |
Test Dispatch |
Select this check box to perform a test run of the dispatch. When you select this check box, the process runs, but the purchase orders processed do not appear in Dispatched status, and the purchase orders are printed with the word Unauthorized at the bottom of the page. Selecting this option enables you to test the EDX, email, or fax setup without updating the system. |
Print Copy |
Select this check box to produce a printed copy of each processed purchased order. If any of the processed purchase orders is done by phone, fax, email, or EDX, the system prints a hard copy for review. |
Print BU Comments (print business unit comments) |
Select this check box to print comments (terms and conditions) defined for the PeopleSoft Purchasing business unit on the purchase order upon dispatch. Assign comments to the PeopleSoft Purchasing business unit by clicking the Comments link on the Purchasing Definition - Business Unit Definition page. |
Exclude POs tied to Authored Contract Documents (exclude purchase orders tied to authored contract documents) |
Select to exclude purchase orders that are linked to authored contract documents from the dispatch process. These documents are created using the PeopleSoft Supplier Contract Management application. When a purchase order has an authored contract document associated to it, certain changes could affect the authored document. Selecting this check box prevents changes to those purchase orders with authored contract documents. |
Print PO Item Description |
Select this check box to print the item description from the Maintain Purchase Order - Purchase Order page instead of from the Purchasing Attributes page. The item description stored on the purchase order is in the base language and may have been modified on the purchase order. |
Print Duplicate |
Select this check box to print the word Duplicate on each purchase order. |
Number of Copies |
Enter the number of copies of the report that you want. The field becomes available when you select the Print Copy check box. |
Sort By |
Select whether to sort the lines on the dispatched purchase order by Line No (line number) or ShipTo ID. |
See Also
Defining Dispatch Configurations
Preparing to Dispatch by Fax and Email
Using Recurring Purchase Order Vouchers
Entering Purchase Order Header Information
Creating PeopleSoft Purchasing Business Units
Defining Purchasing Item Attributes
Access the Select Purchase Order page (Purchasing, Purchase Orders, Dispatch POs, Dispatch Purchase Orders, and click the Select Purchase Order link on the Dispatch Purchase Orders page).
Note. Access the Buyer's WorkBench to select multiple purchase orders for dispatch.
PO Unit |
Select a business unit. |
ID |
Select a purchase order ID. |
Start Date and End Date |
Used as a comparison against the purchase order date to determine which schedules are retrieved. These values appear by default to the current date plus or minus the value in the Days +/− Today field. |
Search |
Click this button to display the purchase order lines and schedules that match the criteria that you entered. |
In the Retrieved Rows group box, click the Sel check box next to a purchase order to work with that particular purchase order.
Note. After you dispatch the purchase order, the vendor's last activity date (VENDOR.LAST_ACTIVITY_DT) is automatically updated to reflect the current date. You can use the vendor's last activity date to deactivate vendors that have had no activity in the previous fiscal year.
See Also
Maintaining Vendor Information
This section provides an overview of the Purchase Order Dispatch/Purchase Order Change Request EIP and discusses how to:
Set up the Purchase Order Dispatch/Purchase Order Change Order EIP.
Process the Purchase Order Dispatch/Purchase Order Change Order EIP.
The Purchase Order Dispatch/Purchase Order Change Request EIP sends purchase orders and purchase order change requests (change orders) to vendors. This asynchronous batch publish EIP also supports flat-file processing for EDI transaction X.12 850.
Use this EIP to process change order request to the vendors. You typically use EDI to process these transactions.
Run the PO Dispatch/Print process (POPO005) to stage the purchase order.
Use the common Publish Outbound Message page to initiate the PO_POD Application Engine process that processes the PURCHASE_ORDER_DISPATCH service operation.
Page Name |
Definition Name |
Navigation |
Usage |
RUN_DISP_POPO005 |
Purchasing, Purchase Orders, Dispatch POs, Dispatch Purchase Orders |
Run the PO Dispatch/Print process and dispatch purchase orders, run the Email process, or run the PO Dispatch & Email multiprocess job. |
|
IN_RUN_PUB_MSG |
SCM Integrations, Publish Outbound Message |
Initiate the outbound message publish process for outbound PeopleSoft Supply Chain Management service operations. . |
|
PO_RUN_POD |
Select the Purchase Order Dispatch check box on the Publish Outbound Message page to enable the Purchase Order Dispatch link. Click the Purchase Order Dispatch link to launch the PO Dispatch Message Selection Criteria page. |
Launch the Purchase Order Dispatch Outbound transaction. |
Service operations in PeopleSoft Integration Broker are delivered with a default status of Inactive. You must activate each service operation before attempting to send or receive data from a third-party source or another PeopleSoft system, such as CRM.
Before you can use the Purchase Order Dispatch/Purchase Order Change Request EIP, you must:
Set up the service operation within PeopleSoft Integration Broker and Enterprise Components.
Use the information in the following table and refer to the setup instructions in the PeopleSoft Supply Chain Management Integration 9.1 PeopleBook, "Implementing Integrations" chapter, Setting Up Service Operations section.
See Implementing Integrations.
Service Operation |
Direction and Type |
Handlers |
Chunking Available? |
Integrates With |
PURCHASE_ORDER_DISPATCH |
Outbound Asynchronous |
ROUTERSENDHDLR |
Yes |
third-party system EDI transaction X.12 850 |
On the purchase order, specify EDX as the dispatch method.
See Also
Understanding PeopleSoft Supply Chain Management Enterprise Integration Points
Understanding Electronic Data Interchange
PeopleTools PeopleBook: Integration Broker
Access the PO Dispatch Method Selection Criteria page (select the Purchase Order Dispatch check box on the Publish Outbound Message page to enable the Purchase Order Dispatch link).
The field values on this page are the same fields that appear on the Request for Quote Release Selection Criteria page.
Refer to the section about Request for Quote Release Selection Criteria for more information.