4/13/2017 Document 1664398.

Revenue Management Cloud Service (RMCS) solution for Oracle E­Business Suite (EBS) (Doc
ID 2244173.1)

In this Document

Purpose
Scope
Details
  Introduction
  Feature Overview
  Configure your system
  1. Oracle E­Business Suite patches to be applied.
  2. Setup steps to Implement the Feature.
  2.1 System Options ­ Revenue Management Tab
  2.2 Profile Option : AR: Source System Value for Revenue Management
  2.3 Setup for Utilizing Fusion Web services via Business Events
  2.4 EBS SSL Setup, for consuming Fusion Services.
  Functional Changes:
  3. Oracle E­Business Suite Receivables Integration Concurrent Programs for Oracle Fusion Revenue Management
  4. User Interface Changes
  5. Batch Processing Changes for Oracle E­Business Suite Receivables.
References

APPLIES TO:

Oracle Receivables
Oracle E­Business Suite
Oracle Order Management
Oracle Projects
Oracle Fusion Revenue Management
Information in this document applies to any platform.
Oracle Revenue Management Cloud Services (RMCS)

PURPOSE

This document provides an overview of the technical uptake of the Oracle E­Business Suite coexistence solution for
integration with Revenue Management Cloud Service.

SCOPE

This document applies to customers who use Oracle E­Business Suite Service Contract, Order Management, General
Ledger and Receivables, and want to integrate with Oracle Revenue Management Cloud.

DETAILS

Introduction

Oracle Revenue Management Cloud Service (RMCS) co­existence feature enables you to deploy a uniform, centralized and
comprehensive view of contracts with customers, unifying the details tracked in a variety of sales cycle systems such as
order management, retail point of sales, and billing systems.

Native integration is available between Oracle Financials Cloud and RMCS
Pre­built integration between Oracle E­Business Suite and RMCS is provided.
Robust integration is available for third party applications.
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 1/10
4/13/2017 Document 1664398.1

For Oracle E­Business Suite the integrated data includes sales orders, service contracts,sales invoices and other
relevant sales and fulfillment data. Data from the various source systems is processed and managed centrally in
RMCS.
RMCS enables you to address the core principle of IFRS 15 / ASC 606 through the 5 steps, namely automatic
identification and creation of contracts and performance obligations, automatic identification of total transaction
price (TTP), automated allocation of TTP across performance obligations, and recognizing revenue as performance
obligations are satisfied, either over time of point in time.
RMCS generates accounting for performance obligation liability, discount liability,contract asset, and revenue.
RMCS facilitates audit and analysis through action history and seeded reports.
This co­existence solution provides out­of­the­box integration with Oracle E­business suite Service Contracts, Order
Management and Receivables in order to bring in source document lines from upstream systems.
Reference data, such as Customers and Inventory Items, need to be synchronized between Oracle E­Business Suite
and RMCS.

Feature Overview

After uptake of Oracle Fusion Revenue Management Cloud Service co­existence solution with Oracle E­Business Suite

Revenue will be managed in RMCS instead of Oracle E­Business Suite.
RMCS enables you to address the core principle of IFRS 15/ASC 606 through the 5 steps, namely automatic
identification and creation of contracts and performance obligations, automatic identification of total transaction
price (TTP), automated allocation of TTP across performance obligations, and recognizing revenue as performance
obligations are satisfied, either over time of point in time.
Oracle E­Business Suite Receivables will serve as a billing product and will track the Oracle Receivables balance.
Oracle E­Business Suite products namely Service Contracts and Order Management can use the E­Business Suite
Receivables product for Billing and RMCS for Revenue recognition.
Third party applications can integrate with RMCS directly.

Configure your system

1. Oracle E­Business Suite patches to be applied.

Oracle E­Business Suite Integration with RMCS patch is available on top of 12.1.3 and 12.2.x
Patch for 12.1.X would be like (23239450:R12.AR.B) and for 12.2.x would be like (23239450:R12.AR.C). 
Below are the list of patches which provide the features for integration with RMCS :

Patch Comments

Patch 25505159 ARU for Oracle E­Business Suite co­existence solution provides out­of­the­box
integration with Oracle Fusion Revenue Management Cloud.

Patch 23239450 ARU for Enabling the feature functionality.

2. Setup steps to Implement the Feature.

2.1 System Options ­ Revenue Management Tab

The Revenue Management tab is enabled only when the Oracle Fusion Revenue Management integration patch is
installed.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 2/10
4/13/2017 Document 1664398.1

The enabling of integration mode is at ledger level.
The system options are defined at the operating unit level. The choice you make for RMCS will be applied to
all the operating units that belong to the same ledger to which the current operating unit is assigned.
For example if the there are four operating units assigned to the same ledger and you select values for these
fields for one of the operating unit then the same values will be automatically applied for the remaining
three operating units as well. On the E­Business Suite Oracle Receivables System Options form , you will see
the same value for all the four operating units.
Integration mode provides two values: "Revenue Recognition and Compliance" and "None". Revenue
Recognition and Compliance ­ Integration with Revenue Management is enabled and source documents are
sent to Oracle Fusion Revenue Management for the purpose of revenue recognition. None ­ No integration
with Revenue Management is enabled.
If you select option "Revenue Recognition and Compliance" from the drop down list of values, then all the
source documents are sent to RMCS for the purpose of revenue recognition.
Enable Source Application Documents region allows you to enable the documents in the source systems for
integration with revenue management for revenue recognition.
Out­of­the­box integration with Order Management, Service Contracts and Receivables is provided to
interface source documents to RMCS.
Configure start date. To import the documents which are created in the source application on or after the
start date are eligible to be interfaced to RMCS.
Start date cannot be updated or modified after one or more documents are extracted for the relevant
application.

For more details on Accounting Contracts creation, Accounting refer to Revenue Management TOI’s 
https://cloud.oracle.com/en_US/saas/readiness?offering=revenuemanagement&version=r11

2.2 Profile Option : AR: Source System Value for Revenue Management

The Profile "AR: Source System Value for Revenue Management" is used to point to the source system integrated
with RMCS
You must set the profile value to "EBIZ" for integration between Oracle EBusiness Suite and RMCS.
This is a mandatory profile option setting in order to extract the revenue basis source data from Oracle E­Business
Suite to RMCS.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 3/10
4/13/2017 Document 1664398.1

2.3 Setup for Utilizing Fusion Web services via Business Events

Fusion public web services are utilized to automate communication between Oracle E­Business Suite and Revenue
Management Cloud Service. This is implemented using Business Events and this invokes Web Service
Type Subscription, via Service Invocation Framework.
There are three business events configured for this feature as described below :

1. Upload data file to Universal Content Manager from Oracle E­Business Suite.

oracle.apps.wf.ar.vrm.coexist.fileupload.invoke ­ Used for uploading the data file to the universal
content manager server from E­Business Suite.

Example: Oracle E­Business Suite Receivables will upload the billing data file into universal content
manager server using this service

2. Invoke and verify status of ESS Job in RMCS.

oracle.apps.wf.ar.vrm.coexist.submitess.invoke ­ Used for spawn ESS Job request in RMCS

Example: Oracle E­Business Suite Receivables will spawn the "Load Interface for file import" ESS job to
import the billing data into RMCS based on the billing data file generated and uploaded to universal content
manager by E­Business Suite.

3. Invoke and verify status of request submitted in RMCS.

oracle.apps.wf.ar.vrm.coexist.essJobStatus.invoke ­ Used for checking the status of the request
submitted in RMCS.

Example: Oracle E­Business Suite Receivables will check the status of the ESS job ( "Load Interface for
file import" ) and then record the status in Oracle E­Business Suite Receivables accordingly.

Download data file from Universal Content Manager from Oracle E­Business Suite.

2.4 EBS SSL Setup, for consuming Fusion Services.

Oracle E­Business Suite will consume the SSL enabled services only, which are provided by Fusion.
Fusion needs to provide the Service Authentication details as well. Username and Password to be sent in the service
call.

Getting the SSL certificate

Open the SSL Enabled Service URL using browser,say firefox for example.
Verify the SSL Certificate imported from the URL, using browser options ­> Security.
Verify that the SSL Certificate is Valid.
Using Export Feature of Browser, export the SSL Certificate.
Note: Use the Same Host name as that of the URL. Example:X XY.idc.oracle.com.cer

Import the SSL Certificate to Oracle E­Business Suite Instance
FTP the above certificate to Oracle E­Business Suite instance.
Import the certificate to the Oracle E­Business Suite keystore.
It prompts for the keystore password. Enter the Keystore Password (for internal environments, default
password:"changeit") (",double quotes, provided for understanding only).
keytool ­import ­alias FAFusionImportExport ­file <fusion certificate> ­ keystore
$AF_JRE_TOP/lib/security/cacerts.
After successfully importing the certificate bounce the Oracle E­Business Suite Instance

Note: To delete the certification enter: keytool­delete­alias<mydomain>­
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 4/10
4/13/2017 Document 1664398.1

keystore $AF_JRE_TOP/lib/security/cacerts)

Setting the username token authentication credentials for the service

Enter the value sqlplus apps/apps@db @$FND_TOP/sql/afvltput.sql <Module> <Key> <Value>
Module: AR, Key: REV_MGR_OPERATIONS_USA,Value:Welcome1 
Password will be stored in the fndvault, and is secured from the end user, while creating the subscriptions.
Oracle will be using the Key and Module Pairs to idenitfy the passwords. Key and Module Pairs have to be unique.
Note: The above steps are executed once for any number of services to be configured, which use the same SSL
certificate and UserName Token.

Add the Service Invocation Subscription to the above listed events, to invoke the service

Navigate to Workflow Administrator Web Applications ­> Administrator Workflow ­> Business Events.
Search for above seeded business event,
"oracle.apps.wf.ar.vrm.coexist.fileupload.invoke"

Sample wsdl url:
For other business events, use https://efops­rel9st1­provcdrm­externalfin.
us.oracle.com/finFunShared/FinancialUtilService?WSDL
 
Click on Create New Subscription
Enter the Subscription Details:
1. System: <Oracle E­Business Suite Instance>
2. Source Type: Local
3. Event Filter: This will be auto­populated for the event that was queried in step 2. Ensure you do not
change the value.
4. Execution Phase:1 (to ensure synchronous execution and to avoid deferred call)
5. Status: Enabled
6. Rule Data: Message
7. Action Type: Invoke Web Service
8. On Error: Stop and Rollback 

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 5/10
4/13/2017 Document 1664398.1

Click on next
Provide the WSDL URL from the Fusion cloud instance. It will be similar to the URL example shown
above.

Click on Next, for selecting the Service

Click on Next, for selecting the EndPoint

Click on Next, for selecting the operations, Here select the Revenue Adjustment Synchronous service.
The image below is just for reference.

Now provide the subscription parameter, as configured in the above steps,
Owner: Receivables
Owner Tag: AR
WFBES_SOAP_USERNAME, WFBES_SOAP_PASSWORD_KEY, WFBES_SOAP_PASSWORD_MOD are as
entered in the above step in
afvltput.sql

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 6/10
4/13/2017 Document 1664398.1

Functional Changes:

3. Oracle E­Business Suite Receivables Integration Concurrent Programs for Oracle Fusion Revenue Management

3.1 Extracting Revenue Basis Data Import file from Oracle E­Business Site Receivables to feed
into RMCS.

Execute the following two steps to extract the Revenue Basis Data Import file for RMCS.

1. Extract Revenue Basis Data

This Concurrent Program extracts the Revenue Basis data from the source transaction tables.
This program is executed at the Transaction Source System (Application) Level.

2. Create Revenue Management Data Export File

This Concurrent Program will gather the above extracted information and prepare the data file.

Steps:
1. Submit a New Concurrent Request, Extract Revenue Basis Data
This Program will extract the transaction data of the source application, which were not extracted in the
prior runs and funnel the data to Revenue Management Cloud Service canonical tables on E­Business Suite.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 7/10
4/13/2017 Document 1664398.1

2. Submit a New Concurrent Request, Create Revenue Management Data Export File

3.

1. The data file will be created in the UTL_FILE_DIRECTORY.
2. The system takes the file from the UTL_FILE_DIRECTORY and places it on the universal content
manager server.
3. This system will also spawn ESS Job in the fusion environment ("Load Interface for file import") with
the necessary parameters which would import the data from the data file into RMCS canonical tables.

3.2 Create Billing Data File, From Oracle E­Business Suite Receivables to Revenue Management Cloud
Service

Create Billing Data File

The steps to create the Billing Data file are listed below.
1. Generate the data file with Billing Document Data for Data Reconciliation in Oracle E­Business
Suite Receivables. The data file
contains billing transaction details such as Account Date, Billing Amounts, etc…
2. This Program extracts the billing information to a data file, which were not extracted
previously.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 8/10
4/13/2017 Document 1664398.1

3. The data file will be created in the UTL_FILE_DIRECTORY.
4. The system takes the file from the UTL_FILE_DIRECTORY and places it on the universal
content manager server.
5. The system will also spawn ESS Job in the Fusion environment ("Load Interface for file
import") with the necessary parameters which would import the data from the data file into
Revenue Management Cloud Service canonical tables.

3.3 Recommendations for file naming conventions.

Create Revenue Management Data File:
          Suggested File Name Suffix: RMRBDImport
Create Billing Data File:
           File Name is Autogenerated, starts with : RMBDImport

4. User Interface Changes

4.1 Transactions Workbench

The system creates a Billing document based on transaction source setup in the system options.
The source product Revenue Recognition application is stored in the Billing document header.

4.2 Credit Transactions.

The source product Revenue Recognition application is stored in the Billing document header.

5. Batch Processing Changes for Oracle E­Business Suite Receivables.

5.1 Auto Invoice/Invoice API.

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 9/10
4/13/2017 Document 1664398.1

The system creates a Billing document based on transaction source setup in the system options.

The source product Revenue Recognition application is stored in the Billing document header.
Note:

Since revenue is maintained in Revenue Management Cloud Service for Billing documents, revenue
activity is not supported in Oracle E­Business Suite Receivables.
User cannot modify or create revenue distributions.
Receivables will not send revenue information for billing documents to the Costing Application.

This document will provide a brief overview of the technical update and steps to be executed for the
integration between Oracle E­Business Suite Oracle Fusion Revenue Management Cloud Service

Didn't find what you are looking for?

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl­state=11kd1ffusw_171&id=1664398.1 10/10