Example: Setting Up the Advanced Shipping Notice EIP

The Advanced Shipping Notice (ASN) EIP is an asynchronous outbound service operation to notify your customers that a sales order has been shipped. The data from this service operation is passed to an external system or to the PeopleSoft CRM Field Service and CRM Order Capture applications. The Advanced Shipping Notice EIP meets EDI requirements of the X.12 856−Shipping Notice/Manifest transaction set, and is also used with warehouse management systems. An ASN transaction is generated when a sales order entered from PeopleSoft Order Management has been depleted in PeopleSoft Inventory. You can specify whether to generate the ASN for all sales order shipments in the business unit, sales orders belonging to a specific shipping ID, sales orders for a specific sold to customer, or sales orders for a specific ship to customer.

Before you can publish messages with the Advanced Shipment Notice EIP, you must:

You must enable ASN generation in the business unit shipping the items.

Use the Business Unit Definition - Inventory Options page (BUS_UNIT_INV5) to define external interfaces.

Navigation:

Set Up Financials/Supply Chain > Business Unit Related > Inventory > Inventory Definition > Inventory Options

This example illustrates the fields and controls on the Inventory Definition - Business Unit Options page. You can find definitions for the fields and controls later on this page.

Select the Use Advanced Shipment Notice check box in the External Interfaces group box.

You must ensure that the customer you are interacting with has a contact set up to accept EDI transmissions, and that the contact is a ship to contact.

Use the Contact page (CONTACT) to maintain information about each contact.

Navigation:

Customers > Create Customer Contacts

This example illustrates the fields and controls on the Contact page. You can find definitions for the fields and controls later on this page.

Use the Contact Customer page (CONTACT_CUST_PAGE) to indicate the primary ship to contact.

Navigation:

Click the Contact Customer Information link on the Contact page.

This example illustrates the fields and controls on the Contact Customer page. You can find definitions for the fields and controls later on this page.

Select the Primary Ship To check box to receive the proper shipping notifications.

Click the Documentation link corresponding to the appropriate customer to access the Contact Additional Info page.

This example illustrates the fields and controls on the Contact Additional Info page. You can find definitions for the fields and controls later on this page.

Under the Documentation group box, make sure the Document Code is ASN (advanced shipping notification), and Preferred Communication is XML & Print or XML Only.

Use the PeopleSoft Integration Broker to activate the Advanced Shipping Notice service operation.

Use the Service Operations-General page (IB_SERVICE) to define and activate a service operation.

Navigation:

PeopleTools, Integration Broker, Integration Setup, Service Operations, General

This example illustrates the fields and controls on the Service Operations-General page (1 of 2). You can find definitions for the fields and controls later on this page.

This example illustrates the fields and controls on the Service Operations-General page (2 of 2). You can find definitions for the fields and controls later on this page.

For the ADVANCED_SHIPPING_NOTICE service operation, select the Active check box for the applicable service operation version. If the desired version is not the default version for the service operation, the default version must also be activated.

On the General tab of the Service Operations component, select the View Queue link at the bottom of the page to access the Queue Definitions page.

Use the Queue Definitions page (IB_QUEUEDEFN) to activate the queue used by the service operation.

Navigation:

• PeopleTools, Integration Broker, Integration Setup, Service Operations, General. Select the Queue link attached to this service operation.

• PeopleTools, Integration Broker, Integration Setup, Queues

This example illustrates the fields and controls on the Queue Definitions page. You can find definitions for the fields and controls later on this page.

For the ADVANCED_SHIPPING_NOTICE queue, verify the Queue Status field has a value of Run.

Click the Return button to go back to the Service Operations component.

Use the Service Operations-Handlers page (IB_SERVICEHDLR) to activate one or more service operation handlers.

Navigation:

PeopleTools, Integration Broker, Integration Setup, Service Operations, Handlers

This example illustrates the fields and controls on the Service Operations-Handlers page. You can find definitions for the fields and controls later on this page.

For the ADVANCED_SHIPPING_NOTICE service operation, click the Handlers tab of the Service Operations component. If you are using chunking, select the value of Active in the Status field for the OnRoute handler.

Use the Service Operations-Routings page (IB_SERVICERTNGS) to define and activate routing definitions on the service operation.

Navigation:

PeopleTools, Integration Broker, Integration Setup, Service Operations, Routings

This example illustrates the fields and controls on the Service Operations-Routings page. You can find definitions for the fields and controls later on this page.

For the ADVANCED_SHIPPING_NOTICE service operation, click the Routings tab of the Service Operations component. Activate an outbound routing definition for each receiver node and external alias name that data will be sent to. To activate a routing, select the check box next to the routing definition and click the Activate Selected Routings button. The following routing definitions are predefined:

• The ADVANCED_SHIPPING_NOTI_EDI_856 routing definition sends outbound shipping notices using the EDI X.12 856 format as a flat file. The data is converted from the PeopleSoft standard XML format to the EDI X.12 856 transaction format and then from XML to a flat file. If you wish to send the data as an XML file using the EDI X.12 856 format, then alter the routing definition to remove the second transform program.

• The ADVANCED_SHIPPING_NOTICE routing definition sends outbound shipping notices using the PeopleSoft standard XML format. This routing definition is used when you are sending data to a third-party system that is using the current version of the service operation.

• The ADVANCED_SHIPPING_NOTICE_CR routing definition sends outbound shipping notices using the PeopleSoft standard XML format to PeopleSoft CRM.

• The ADVANCED_SHIPPING_NOTICE_V1 routing definition sends outbound shipping notices using the PeopleSoft standard XML format and converts the data from the current service operation version (version 2) to an older version (version 1) of the service operation. This routing definition is used when you are sending data to a third-party system that is still using an older version of the service operation.

Use the Routings-Parameters page (IB_ROUTINGDEFNDOC) to verify the external service alias name, nodes, and transform programs used by this routing.

Navigation:

• PeopleTools, Integration Broker, Integration Setup, Service Operations, Routings. Select the link attached to the routing definition name, then select the Parameters tab.

• PeopleTools, Integration Broker, Integration Setup, Routings, Parameters

This example illustrates the fields and controls on the Routings-Parameters page. You can find definitions for the fields and controls later on this page.

On the Routings tab of the Service Operations component, select the link attached to the routing definition name. This link accesses the Routing Definitions component. Select the Parameters tab and complete the following steps:

1. Confirm the external alias name in the External Alias field for the routing is correct. When sending or receiving data, the Integration Broker determines which routing to use by referring to the external alias name, not the routing name.

2. Verify or change the transform programs on this routing definition. A routing definition defines the sending and receiving nodes for a transaction and specifies any inbound and outbound transformations to invoke. A transform program is a type of PeopleSoft Application Engine program that can convert data from one format to another; for example, from XML to a flat file. Use a transform program when one node sends a request or response message with a data structure different from the structure required by the other node. You must decide, based on your environment, to change, remove, or add transform programs. The ADVANCED_SHIPPING_NOTI_EDI_856 routing definition is delivered with two transform programs. The EDI_856_O transform program converts outbound shipping notices from the standard PeopleSoft XML format to the EDI X.12 856 transaction format (still in XML). The XML_TO_FILE transform program converts the EDI X.12 856 formatted data from XML to a flat file format. You can remove the XML_TO_FILE transform program to send your data in the XML EDI X.12 856 format. If you are not using EDI then you will want to use the ADVANCED_SHIPPING_NOTICE routing definition instead.

   The transform program, to convert data from the current version of a service operation to an older version, is located on the Service Operation Version page of the non-default version. Select the non-default version on the Service Operations-General page to access the Service Operation Version page.

Use the Node Definitions page (IB_NODE) to activate node used by the service operation.

Navigation:

PeopleTools, Integration Broker, Integration Setup, Nodes, Node Definitions

This example illustrates the fields and controls on the Node Definitions page. You can find definitions for the fields and controls later on this page.

Verify the Active Node check box has been selected for any nodes used in the routings that you activated on the Service Operations-Routings page for ADVANCED_SHIPPING_NOTICE service operation.

Use the Nodes-Connectors page (IB_NODECONN) to for an outbound service operation, verify the node is connected to the correct network.

Navigation:

PeopleTools, Integration Broker, Integration Setup, Nodes, Connectors

This example illustrates the fields and controls on the Nodes-Connectors page. You can find definitions for the fields and controls later on this page.

For an outbound service operation, verify the node or routing is connected to the correct network using the Gateway ID and Connector ID fields. Depending on the file output location, you may need a password. If a password is needed, you should use the password encryption utility on this page.

Use the Batch Publish Rules page (EO_MSGPUBATCH ) to set up publication rules.

You must activate a publish rule for the publication messages you create to follow. This rule includes instructions on message chunking, if necessary.

Navigation:

Enterprise Components > Integration Definitions > Batch Publish Rules

This example illustrates the fields and controls on the Batch Publish Rules page. You can find definitions for the fields and controls later on this page.

For the ADVANCED_SHIPPING_NOTICE message name (service operation):

1. Select Active Status to activate this publish rule definition.

2. Select the appropriate Output Format. The PeopleSoft Application Engine program can create either an Extensible Markup Language (XML) message that flows through PeopleSoft Integration Broker architecture or a flat file generated on the PeopleSoft Process Scheduler server and not published elsewhere. If you are sending data to a PeopleSoft system, select Message as your format.

3. If you want to use message chunking, configure a chunking rule and then enter it in the Chunking Rule ID field.

Use the Customer ID Chunk page (OM_CHUNKCUSTID) to set up chunking for the batch publish rule.

Navigation:

SCM Integrations > Chunking Rule > CustID to Node Mapping

This example illustrates the fields and controls on the Customer ID Chunk page. You can find definitions for the fields and controls later on this page.

If using chunking for the batch publish rule, set up the chunking rule mapping definitions. You can use a delivered chunking rule or create a new chunking rule.

If using the CUSTOMER_ID chunking rule ID, access the Customer ID Chunk page.

Select the node for each customer that receives electronic data.

Chunking is only needed if you have requirements to break up the outbound data and send them to different destinations based on attributes in the message such as business unit or customer ID. The most common use of chunking with the ASN message is to send a single customer's messages to a specific node setup for that trading partner. If you are using a middleware product to actually determine trading partner destinations then a single transaction with all trading partner transactions can usually be sent directly to the middleware product. You would not need to activate message chunking in this situation.