Professional Documents
Culture Documents
Approvals:
DOCUMENT CONTROL
Change Record
29-Aug-2014 Jay Shearn ISSUE V1.1 Updated with link to CV.010 – Financials Data
Migration Requirements document on
Sharepoint
Reviewers
Name Position
Distribution
P a g e |1
September 8, 2014
P a g e |2
September 8, 2014
Table of Contents
Document Control ......................................................................................................................1
Introduction..................................................................................................................................4
Data Normalization................................................................................................................. 24
P a g e |3
September 8, 2014
INTRODUCTION
Purpose
The purpose of this document is to explain how to use the AR Sales Invoice interface allowing
integration of legacy or external data with the Oracle Receivables module, and how to define the
data that must be assembled to accomplish this.
This approach by populating the AR interface tables directly without reference to the sales orders in
Order Management will be taken as an alternative to migrating mid-cycle sales orders from SFDC to
EBS and producing subsequent sales invoices (open or closed) in AR as a result of the orders.
Background
This document will outline and define the tasks and processes necessary to upload data to the Oracle
E-Business Suite to create AR Sales Invoices and Credit Notes.
NOTE: It is likely that specific distributions will be required to ensure the correct revenue account is
used.
P a g e |4
September 8, 2014
Audience
This document is intended to be used by those who will need to assemble to data to be migrated, and
those who will create the upload program (SQL Loader).
Business Rules
RX to complete.
Assumptions
1. All data to be considered will be cleaned and normalised prior to import to EBS.
2. All migrated invoices will not be required to be printed as customer facing documents once
migrated to EBS. Printing will have taken place via PRISM and any reprinting of these
transactions will take place in PRISM.
3. Products and Packages will be assigned an ‘Item Number’ that will identify them uniquely in the
EBS system.
4. Receivables distribution lines for all migrated invoices will be derived from the pre-configured
AutoAccounting Rules in AR. Revenue lines will be provided in the interface.
Definitions
Term Definition
EBS E-Business Suite. The target system for the conversion process.
PRISM The Reed Exhibitions Source system that will be providing the data for the conversion
process.
PRODUCT An object that Reed Exhibitions sell. This will sometimes be referred to as an Item in
the EBS system.
P a g e |5
September 8, 2014
Term Definition
PACKAGE An object that Reed Exhibitions sell. This will usually be a collection of PRODUCTS
grouped together to form a logical unit. A PACKAGE will be represented in EBS by the
creation of a Bill of Materials (BOM).
INTERFACE TABLE A data table used by an Interface Program. This table usually holds the data being
imported EBS.
ORGANIZATION Reed has one EBS Organization per Business Unit. Packages will belong to a specific
organization.
SQL LOADER An Oracle product that provides a simple way of uploading data from a flat file to an
Oracle Database table.
REVENUE ACCOUNT or DISTRIBUTION The GL account code combination that the value of the sale will be posted to.
DISTRIBUTION LINE A sales invoice line may have one or more distribution lines. Each distribution line may
nominate a different REVENUE ACCOUNT.
P a g e |6
September 8, 2014
P a g e |7
September 8, 2014
Overview
The following areas are covered within the Interface Functional Design section:
- RA_INTERFACE_LINES_ALL
This table lists all the transaction header and line data, and is grouped by the AutoInvoice process
into transactions as a result of the configuration within AR.
- RA_INTERFACE_DISTRIBUTIONS_ALL
This table details the accounting distributions for a transaction, and is limited in this interface to
revenue and tax accounts only. Predefined AutoAccounting rules will be used to derive Revenue, Tax
and Receivable accounts. The interface will cater for revenue for a single transaction line to be split
into multiple revenue account combination allocations if required.
- RA_INTERFACE_SALESCREDITS_ALL
Rows must be populated in this table because the Receivables System Option ‘Require Salesperson’ is
set to ‘Yes’. This information will be derived from the information in the RA_INTERFACE_LINES_ALL
table.
- AR_INTERFACE_CONTS_ALL
This table stores information about contingencies that impact revenue recognition for the imported
transactions. No data is required to be populated in this table as revenue recognition is not going to
be used on migrated transactions.
- RA_INTERFACE_ERRORS_ALL
This table records all the errors encountered when running the AutoInvoice concurrent program to
import invoices from the interface tables.
Note: Where migrated data refers to existing data in EBS (e.g. customer accounts, transaction types,
accounting etc.), IDs for the data need to be provided when the interface tables are populated in order for
P a g e |8
September 8, 2014
the corresponding records to be identified. In this case, scripts must be written to identify the IDs and
lookups carried out before the data is loaded into the interface tables.
Additional AR Configuration
The following additional configuration is required in AR to support the interface for the migration process
only.
- Transaction Source
A new Transaction Source ‘PRISM’ will be defined in AR for creating migrated transactions.
A Transaction Source determines whether AR automatically numbers transactions and what the
starting numbers are; additionally it determines what to do if an error occurs during the import
process and whether to expect an Oracle internal ID or a descriptive name for items of reference
data.
Rows are inserted into the open interface tables by Transaction Source, and the AutoInvoice import
program is run by Transaction Source.
The screen shots below depict the Transaction Source setup for migrated transactions.
Note: The information in the Batch Source tab will be different depending upon the Operating Unit
the Transaction Source it relates to. Thereafter, the other information is the same for each Operating
Unit.
The Standard Transaction Type field will specify the Transaction Type the interface will use
when creating transactions of an Invoice Class for this source. The Transaction Type the
interface will use when creating transactions of a Credit Memo Class will be derived from the
Credit Memo Transaction Type associated with the Invoice Transaction Type recorded in this
field. See screen shot below.
P a g e |9
September 8, 2014
If any problems occur with the interface (i.e. an invalid tax rate, invalid line or the GL Date is
in an unopened period), the AutoInvoice options have been set to reject the transaction. The
errored transaction will reside in the AutoInvoice tables with a status of ‘Error’ and will have
to be corrected before reimporting into AR.
P a g e | 10
September 8, 2014
IDs for all the customer information will be supplied by PRISM as shown in the screen print
below.
Sold To, Ship To, Bill To Contact, Payment Method and Customer Bank Account information
options are not significant for this Transaction Source, as this information is not required for
the AutoInvoice validation.
PRISM will only supply the Accounting Flexfield segment ID for the Revenue account.
The Tax and Receivables values will be created during the AutoInvoice process using the
AutoAccounting Rules already defined in AR.
Payment Terms ID and the Revenue Account Allocation percentage will be supplied for each
transaction.
P a g e | 11
September 8, 2014
Agreement, Memo Line Rule, Sales Territory, Inventory Item, FOB Point, Freight Carrier and
Related Document options are not significant for this Transaction Source and are not required
for AutoInvoice validation.
P a g e | 12
September 8, 2014
- Transaction Type
CUST_TRX_TYPE_ID will be derived from the Transaction Source. For invoice and credit note
transactions this will be the Standard Transaction Type of the Transaction Source (i.e. XXXX-
MIGRATED_INV where XXXX is the Legal Entity (see below).
Note: This Transaction Type must be assigned to the migration document sequence.
- Salesperson
PRIMARY_SALESREP_ID is required as the Receivables System Option ‘Require Salesperson’ is set to
‘Yes’. This will be provided by the feed from PRISM.
Company Confidential - For internal use only
P a g e | 13
September 8, 2014
Tax Lines: ACCOUNT_CLASS is a constant value of ‘TAX’ to indicate that the distribution rows are tax
distributions.
- Conversion Type
CONVERSION_TYPE is the mandatory field in the open interface tables and will be populated with a
constant value of ‘Corporate’. AutoInvoice uses this conversion type to derive exchange rate for a
given transaction date using corporate daily conversion rates defined in AR. It then converts the
foreign currency amount for foreign currency transactions) into sterling for accounting purposes.
To ensure AutoInvoice does not import duplicate transaction lines for a Transaction Source, the Line
Transaction Flexfield must be configured in AR so that the combination of its segment values is
unique for a line. AutoInvoice will reject lines where the combination of values already exists. The
combination of values is also used as a key to join transaction line information to its related rows in
the distribution and sales credit interface tables.
P a g e | 14
September 8, 2014
Lines to be grouped into a transaction will share some common segment values at the line level. The
common segments are specified in a Grouping Rule in AR, which AutoInvoice uses to group lines into
transactions thus rolling-up the common line level segments to segments in the Invoice Transaction
Flexfield.
No enabled segment of the transaction flexfields may be NULL, even if the required attribute is set to
No.
P a g e | 15
September 8, 2014
A simple example of using this flexfield is shown below, it builds on top of the example shown above
for Line Transaction Flexfield.
P a g e | 16
September 8, 2014
The Line Ordering Rule will order lines being imported based on ascending order of the PRISM
transaction line number, which will be captured in the interface in the field
INTERFACE_LINE_ATTRIBUTE2.
The structure of the Grouping Rule follows the structures of the line and invoice transaction flexfields
described previously. The Grouping Rule also specifies the Line Ordering Rule to be used.
P a g e | 17
September 8, 2014
- Inventory Item
- Description
- UOM Code
- Unit Selling Price
- Unit Standard Price
- Quantity Ordered
- REV: A revenue distribution records the income of the transaction in the profit and loss
- TAX: A tax distribution records any VAT that must be paid to HMRC in the balance sheet
- REC: A receivable distribution that records the debt collectable from the customer, also in the
balance sheet
The monetary value of each distribution is coded to a GL Account Code Combination, made up of a
combination of values in the Accounting Flexfield structure, shown below:
Each segment has its own distinct list of valid values, the combination of values must be complete (no null
segment values) and the combination of values must be pre-existing and valid.
P a g e | 18
September 8, 2014
CONVERSION MAPPING
The following spreadsheets show the conversion mapping to be used. The table details map directly to the
Open Interface requirements.
Note: The details contained in this file are subject to change due to a review of the configuration of EBS and
the data to be migrated.
Link to Conversion Mapping for AR Sales Invoices
P a g e | 19
September 8, 2014
Please refer to the following document written by John Gee and stored in Sharepoint.
P a g e | 20
September 8, 2014
The following diagram details the process to extract data from PRISM, load the data into the EBS interface
tables and import it into EBS:
In order to accomplish the data migration of AR invoices, the following tasks and activities need to take place
in the following sequence:
1. Create and publish a mapping document / file that Reed Exhibitions can use as the basis for
the package extract. This defines the content of the extract from the legacy system(s), and
will be in Excel format.
2. Reed Exhibitions will be responsible for completing the mapping document / file.
3. The Excel file created in (2) above will be enhanced / enriched / corrected / amended as
necessary.
4. Once the file in (3) above is complete, the Excel file will need to be saved as a flat, delimited
file (usually pipe [|]). A SQL Loader process will then be required to take the file and load it
into the relevant Oracle Interface tables for further processing. This will be a bespoke
process.
P a g e | 21
September 8, 2014
5. The AutoInvoice concurrent process (Autoinvoice Master Program) will be called from the
application to take the interface data and upload to the Receivables invoice tables.
6. Any errors reported will be stored in the RA_INTERFACE_ERRORS_ALL table, and may be
accessed via a simple SQL query or via the application (Navigation Path: Receivables Manager
Control AutoInvoice Interface Lines or Interface Exceptions). Once addressed, the
process from step (3) above should be re-iterated.
7. Once all the migrated transactions are created in AR, the standard ‘Create Accounting’
concurrent request will be run to create the accounting entries for the migrated transactions
with the following parameters:
8. The General Ledger batch created as a result of Step 7 will then be deleted or posted and
reversed to prevent the GL account codes being updated with the transaction balances.
P a g e | 22
September 8, 2014
DATA CLEAN UP
All migrated data will be subject to a process where it is enhanced / enriched / corrected / amended (where
necessary) prior to it being migrated to EBS via the interface tables.
RX will be responsible for this process.
P a g e | 23
September 8, 2014
DATA NORMALIZATION
As mentioned in the previous section, all migrated data will be subject to a process where it is enhanced /
enriched / corrected / amended (where necessary) prior to it being migrated to EBS via the interface tables.
RX will be responsible for this process.
P a g e | 24
September 8, 2014
Item Status Item Requiring Action or Resolution Issue Log Responsibility Target Resolution Closed Date
ID (Open / ID (if Completion
Closed) applic.) Date
1 Due Date: The standard AutoInvoice functionality only allows the HCL – Jay Shearn ASAP
due date on an imported invoice to be calculated based on the
Payment Terms (TERMS_ID or TERM_NAME) data supplied in the
interface table (RA_INTERFACE_LINES_ALL).
Passing in DUE_DATE
AutoInvoice does not allow you to pass interface data for due date.
The structure of RA_INTERFACE_LINES_ALL does not even have a
field to hold such a value. The only way to control the due date
derived by AutoInvoice is to pass in a transaction date (TRX_DATE)
and a payment term (TERM_ID or TERM_NAME). From these
values the code will calculate the due date. See Note 201241.1,
Troubleshooting AutoInvoice Date Derivation: GL Date, Invoice
Date, Due Date, Ship Date, Billing Date, Rule Date
How do we get the PRISM due date populated against the migrated
invoice with the correct PRISM value? POC used ‘IMMEDIATE’
therefore Due Date = Transaction Date.
P a g e | 25
September 8, 2014
The following script will create a simple invoice using the AutoInvoice interface.
Note: This information is for reference purposes only and will need to be amended to suite RX’s
configuration and migrated data.
-- Item Line
INSERT INTO ra_interface_lines_all(interface_line_context, interface_line_attribute1,
interface_line_attribute2,
amount, batch_source_name, conversion_rate,
conversion_type, currency_code, cust_trx_type_id,
description, gl_date, line_type,
orig_system_bill_address_id, orig_system_bill_customer_id,
quantity, unit_selling_price,
term_id, taxable_flag, amount_includes_tax_flag,
set_of_books_id, org_id)
VALUES
(‘PRISM', 'INVOICE123’, ‘ITEM LINE’',
1000.00, 'PRISM', 1,
'User', 'GBP', 3627,
'Migrated Invoice 123', '31-JUL-2014', 'LINE',
1088, 2040,
10, 100.00,
5, 'N', 'N',
2024, 85);
-- Tax Line
INSERT INTO ra_interface_lines_all
(interface_line_context, interface_line_attribute1, interface_line_attribute2,
link_to_line_context, link_to_line_attribute1, link_to_line_attribute2,
amount, batch_source_name, conversion_rate,
conversion_type, currency_code, cust_trx_type_id,
description, gl_date, line_type,
orig_system_bill_address_id, orig_system_bill_customer_id,
quantity, unit_selling_price,
term_id, taxable_flag, amount_includes_tax_flag,
set_of_books_id, org_id,
tax_regime_code, tax, tax_status_code,
tax_rate_code, tax_jurisdiction_code, tax_rate)
VALUES
(‘PRISM’, ‘INVOICE123’, 'TAX LINE’',
Company Confidential - For internal use only
P a g e | 26
September 8, 2014
For some fields, constant values are passed and for other fields values need to be provided that tie in with the
setup steps within AR.
INTERFACE_LINE_CONTEXT - identifies the Transaction Flexfield used by the interface data; this helps
AutoInvoice understand what data is being passed in the interface table's fields. The value here ties
in with the setup, where a Line Transaction Flexfield of ‘PRISM’ has been created and will be used for
data migration.
AMOUNT - this field contains the value of the transaction; pass in a constant. This value should be
the product of the numbers that are passed in for QUANTITY * UNIT_SELLING_PRICE.
BATCH_SOURCE_NAME - the value specified here identifies the transaction batch source to be used
by AutoInvoice when interfacing this transaction.
CONVERSION_RATE - For non-functional currency transactions, this field would contain the exchange
rate value.
GL_DATE - the value specified here will be used by AutoInvoice as the GL_DATE of the transaction.
Typically the period in which this GL_DATE value falls should be an open period.
P a g e | 27
September 8, 2014
TERM_ID - identifies the term ID associated with the Payment Terms of the invoice.
SET_OF_BOOKS_ID - identifies the Set of Books ID associated to the Operating Unit for the
transaction that is being created.
ORG_ID - indicates the ID of the Operating Unit against which this transaction is created.
P a g e | 28