Using Oracle E-Business Suite Business Events

for Integrations in Integration Cloud Service

Tutorial: Order to Manual Invoice
ORACLE TUTORIAL | JUNE 2016
Disclaimer
The following is intended to outline our general product direction. It is intended for information
purposes only, and may not be incorporated into any contract. It is not a commitment to deliver any
material, code, or functionality, and should not be relied upon in making purchasing decisions. The
development, release, and timing of any features or functionality described for Oracle’s products
remains at the sole discretion of Oracle.

USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Table of Contents

Disclaimer 1

Introduction 1

Use Case 1

Steps Overview 1

Assumptions & Notes 1

Prerequisites 2

Preparing EBS Order Management System 2

Preparing EBS Accounts Receivables System 2

Steps 3

Creating Connection for EBS Order Management 3

Creating Connection for Receivables 5

Importing Integration 7

Activating the Integration 7

Raising Business Event from EBS Order Management 8

Verifying the Invoice in EBS Accounts Receivables 9

[O.FOOTER] USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Introduction

This document describes an example of using Oracle E-Business Suite Adapter in Integration Cloud Service for
outbound integrations from E-Business Suite (that is, inbound integrations to Integration Cloud Service).It describes
the steps to import existing ICS integration built for this tutorial.

Use Case
This tutorial considers the use case: Create a draft manual Invoice in Receivables system when a Sales Order is
booked in EBS Order Management.

EBS Order Management raises business event ‘oracle.apps.ont.oip.statuschange.update’ whenever the status of
Sales Order is updated as part of business flow. It contains information about the Header Id, Status of Sales Order.

For this example, we will create integration in Integration Cloud Service with EBS Order Management as Source
system and EBS Accounts Receivables as Target system. We will use EBS Adapter to connect to EBS Order
Management system whereas; we will use generic REST Adapter from ICS to connect to target Receivables
system. ICS integration will subscribe to above business event. When there is a change in Sales Order status in
EBS OM system, it will trigger ICS integration. For Booked Orders, integration will fetch the details of Sales Order
from EBS OM instance and data will be used to create draft manual invoice in Receivables system.

Steps Overview
Overview of steps:

 Creating Connections

 Importing & Activating the Integration

 Executing the Integration

 Verifying the result

Assumptions & Notes

 Assume that Oracle E-Business Suite Order Management and Oracle E-Business Suite Accounts
Receivables are two different systems.

 Assume that REST Services are directly accessible from Integration Cloud Service. Hence for this
example, ICS Connectivity Agent is not used. However, if EBS REST Services are behind corporate
firewall, you can configure agent for EBS Connection for this tutorial.

 This document describes the steps to import ICS integration built for this tutorial. By importing the existing
integration, you will be able to straightaway view and test the integration using your EBS instance
(provided the below mentioned prerequisites are implemented). If you are interested in building the ICS
integration from the beginning, refer following links for details:

o Creating an Integration

o Adding Trigger and Invoke endpoints

o Create Mappings

o Assigning Business Identifier for Tracking

1 | Using oracle e-business suite business events for integrations in integration cloud service
Prerequisites
Before starting this tutorial, you must have:

 Access to Oracle Integration Cloud Service (you may request for trial subscription from here, if you don’t
have one).

 Access to Oracle E-Business Suite Order Management & Accounts Receivables.

 Prepare Oracle E-Business Suite Order Management & Accounts Receivables systems for integration.
Perform one-time setup tasks in both systems:

Preparing EBS Order Management System

1. Refer Setup Tasks for Enabling the Oracle E-Business Suite Adapter:

 Ensure that EBS is configured for ISG REST Services and latest patches are applied as mentioned
MOS 556540.1. This is a one-time setup step.

 Deploy Metadata Provider API with GET HTTP Verb for all the methods contained in the API. Provide
service alias as provider.

 Grant access privileges to ‘operations’ user for all methods in Metadata Provider API.

 Deploy Event Manager API with POST HTTP Verb for all the methods contained in the API. Provide
service alias as subscription.

 Grant access privileges to ‘operations’ user for all methods in Event Manager API.

 Deploy OE_ORDER_PUB (Process Order API) as REST Service.

 Grant access privileges to ‘operations’ user for ‘Get Order’ method in OE_ORDER_PUB.

2. Refer Setup Tasks for Using the Oracle E-Business Suite Adapter as a Trigger (Source) Connection, to:

 Store ICS user credentials in EBS database Vault.

 Import SSL certificate of ICS to EBS (if required).

 Set up proxy URLs in EBS (if required).

3. Apply patch 16998134:R12.ONT.B, if it is not already applied.

4. Ensure that the value of profile option: ‘OM: Raise Status Change Business Event’ is set to ‘Yes’.

Preparing EBS Accounts Receivables System

1. Configure EBS for ISG REST Services as mentioned in MOS 556540.1.

2. Deploy ‘Invoice Creation’ API as REST Service (with alias invoice).

3. Grant access to ‘operations’ user to ‘Create Single Invoice’ method in ‘Invoice Creation’ service.

2 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Steps

Creating Connection for EBS Order Management

1. Log in to Oracle Integration Cloud Service.

2. Click Connections in Integration Cloud Service home page.

3. Click Create New Connection in Connections page.

4. Create Connection – Select Adapter dialog appears. Enter “Oracle E-Business Suite” in Search bar.

5. Oracle E-Business Suite Adapter is filtered from the list of Adapters. Click Select.

6. New Connection – Information dialog page appears. Enter “Order Management” as the connection
name.

7. Ensure that “Trigger and Invoke” is selected as Connection Role.

8. Enter a meaningful description for this connection.

9. Click Create in New Connection – Information dialog page.

3 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
 10. Connection Details page is displayed for “Order Management” connection. Click Configure Connectivity
in Connection Properties section.

11. Enter connection URL of EBS Order Management instance as https://<ebs host name>:<port> .

12. Click OK.

13. Click Configure Security in Security section.

14. Enter operations as the username and its associated password in the Credentials dialog to access the
EBS Order Management instance you specified earlier in the Connection Properties dialog.

15. Click OK.

16. Click Test to test the connection you just specified for Oracle E-Business Suite.

17. Click Save to save your connection.

4 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
 18. Click Exit Connection.

19. Oracle E-Business Suite connection "Order Management" now appears in the Connections page.

Creating Connection for Receivables

1. We will use REST Adapter to connect to Receivables system. Click Create New Connection in
Connections page.

2. Create Connection – Select Adapter dialog appears. Enter “REST” in Search bar.

3. REST Adapter is filtered from the list of Adapters. Click Select.

4. New Connection – Information dialog page appears. Enter “Receivables” as the connection name.

5. Select either “Invoke” or “Trigger and Invoke” as Connection Role.

5 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
 6. Enter a meaningful description for this connection.

7. Click Create in New Connection – Information dialog page.

8. Click Configure Connectivity to open the Connection Properties dialog.

9. Select REST API Base URL as Connection Type.

10. Enter URL for Invoice REST Service in Receivables system. For example,
http://<ebs host name>:<port>/webservices/rest/invoice.

11. Click OK.

12. Click Configure Security to open the Credentials dialog.

6 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
 13. Enter credentials to access Invoice REST Service. For example, enter operations as the username and its
associated password in the Credentials dialog.

14. Click OK.

15. Click Test to test the connection you just specified for Oracle E-Business Suite.

16. Click Save to save your connection.

17. Click Exit Connection.

18. Oracle E-Business Suite connection "Receivables" now appears in the Connections page.

Importing Integration
1. Navigate to Integrations Home page.

2. Click Import Integrations.

3. Browse and select Order to Invoice iar file (ORDER_TO_INVOICE_01.00.0000.iar).

4. Integration is successfully imported message is displayed. And, Order to Invoice integration is listed in
Integrations home page.

5. Click integration name to view the imported integration.

Note: Refer An Example of Using a Business Event as a Trigger (Source) in Integration. It describes the steps
to create integration, add Trigger and Invoke endpoints and, define mappings.

Activating the Integration

1. In the Integrations page, click Activate for the "Order to Invoice" integration that you imported earlier.

2. The Confirmation dialog appears. Click Yes for ‘Are you sure you want to activate integration “Order to
Invoice”?’

3. "Order to Invoice" integration is now ACTIVE.

7 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
Raising Business Event from EBS Order Management
1. Log in to Oracle E-Business Suite as the operations user who has access to Order Management Super
User, Vision Operations (USA) responsibility.

2. Select Order, Returns and then Sales Order from the navigation menu to open the Sales Orders form.

3. In the Sales Orders form, select the Order Information tab.

4. Create a new Sales Order for customer "A.C. Networks”.

5. Select the Line Items tab and add the following line item:

 Ordered Item: AS54888

 Quantity: 1

 UOM: Each

8 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
  Unit Price: Accept the populated unit price.

 Request Date: Accept the populated date (such as 14-MAY-2016)

6. Save this new order. This order is created with "Entered" status.

7. Click Book Order. The order status is now updated to "Booked". It internally raises a business event

oracle.apps.ont.oip.statuschange.update which will trigger the integration.

Verifying the Invoice in EBS Accounts Receivables

1. Log in to Oracle Accounts Receivables as the operations user who has access to Receivables, Vision
Operations (USA) responsibility.

2. Select Transactions and then Transactions from the navigation menu.

3. Search for the invoice transaction by transaction number. Note: Header ID of Sales Order from Order
Management was mapped to transaction number of Invoice.

4. Invoice would be found in Oracle Accounts Receivables for ‘A.C. Networks’ for corresponding Sales Order.

9 | USING ORACLE E-BUSINESS SUITE BUSINESS EVENTS FOR INTEGRATIONS IN INTEGRATION CLOUD SERVICE
 Oracle Corporation, World Headquarters Worldwide Inquiries
500 Oracle Parkway Phone: +1.650.506.7000
Redwood Shores, CA 94065, USA Fax: +1.650.506.7200

CONNECT W ITH US

blogs.oracle.com/oracle
Copyright © 2016, Oracle and/or its affiliates. All rights reserved. This document is provided for information purposes only, and the
contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other
facebook.com/oracle warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or
fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are
formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any
twitter.com/oracle means, electronic or mechanical, for any purpose, without our prior written permission.

oracle.com Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and
are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are
trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0116

Using Oracle E-Business Suite Business Events from Integration Cloud Service
June 2016
Author: Rekha Ayothi