Beruflich Dokumente
Kultur Dokumente
Management
Conversion CookbookPlan, Prepare & Execute
March, 2008
Table of Contents
1.
2.
Introduction ..........................................................................................................................................8
2.1
Overview ....................................................................................................................................8
2.2
Scope ..........................................................................................................................................9
2.3
2.4
Limitations ...............................................................................................................................10
2.5
Tools ........................................................................................................................................11
3.
Disclaimer ...........................................................................................................................................12
4.
Definitions ...........................................................................................................................................13
5.
6.
5.1
5.2
Parties.......................................................................................................................................21
5.3
Streams .....................................................................................................................................22
5.4
Contracts ..................................................................................................................................23
6.2
6.3
7.
8.
Overview
8.1
Overview ..................................................................................................................................28
8.2
Assumptions.............................................................................................................................29
Conversion Cookbook- Plan, Prepare & Execute
8.3
Tasks ........................................................................................................................................29
8.3.1
8.3.2
8.3.3
8.3.4
8.3.5
8.3.6
8.3.7
8.3.8
8.3.9
8.3.10
9.
8.4
8.5
Reconciliation ..........................................................................................................................31
8.6
Objective ..................................................................................................................................32
9.2
Overview ..................................................................................................................................32
9.3
Assumptions.............................................................................................................................32
9.4
Tasks ........................................................................................................................................33
9.4.1
9.4.2
9.4.3
9.4.4
9.4.5
9.4.6
10.
9.5
9.6
Reconciliation ..........................................................................................................................42
9.7
Objective ..................................................................................................................................43
10.2
Overview ..................................................................................................................................43
10.3
Assumptions.............................................................................................................................43
10.4
Tasks ........................................................................................................................................44
10.4.1
10.4.2
10.4.3
10.4.4
10.4.5
10.4.6
10.4.7
Overview
11.
10.5
10.6
Reconciliation ..........................................................................................................................50
Phase 4 Book & Terminate Expired Contracts (excluding Evergreen Contracts) ...................51
11.1
Objectives ................................................................................................................................51
11.2
Overview ..................................................................................................................................51
11.3
Assumptions.............................................................................................................................51
11.4
11.5
11.6
11.8
Reconciliation ..........................................................................................................................65
11.9
Objectives ................................................................................................................................67
12.2
Overview ..................................................................................................................................67
12.3
Assumptions.............................................................................................................................67
12.4
Tasks ........................................................................................................................................67
12.4.1
12.4.2
12.4.3
12.4.4
Overview
11.7
11.9.1
11.9.2
12.
12.5
12.6
Reconciliation ..........................................................................................................................71
Conversion Cookbook- Plan, Prepare & Execute
12.7
13.
Objectives ................................................................................................................................72
13.2
Overview ..................................................................................................................................72
13.3
Assumptions.............................................................................................................................72
13.4
Tasks ........................................................................................................................................72
13.4.1
13.4.2
13.4.3
13.4.4
13.4.5
13.4.6
13.4.7
13.4.8
13.4.9
13.4.10
14.
13.5
13.6
Reconciliation ..........................................................................................................................80
13.7
Objective ..................................................................................................................................81
14.2
Overview ..................................................................................................................................81
14.3
Assumptions.............................................................................................................................81
14.4
Tasks ........................................................................................................................................81
14.4.1
14.4.2
14.4.3
14.4.4
14.4.5
14.4.6
Overview
Activate Contracts.................................................................................................................................. 72
Suppress Booking Accounting Transactions in Lease and Finance Management ................................. 73
Flag Billed Streams ................................................................................................................................ 74
Flag Accrued Streams ............................................................................................................................ 75
Receivables Invoice Transfer to AR ...................................................................................................... 76
AR Auto Invoice Master Program ......................................................................................................... 77
Update Tax Lines in AR (Optional) ....................................................................................................... 77
Fetch AR Invoice Numbers ................................................................................................................... 78
Pay Invoices Transfer to AP Invoice Interface ...................................................................................... 78
Payables Open Interface Import ............................................................................................................. 79
14.5
14.6
Reconciliation ..........................................................................................................................85
14.7
15.
Risks ....................................................................................................................................................87
16.
17.
Overview
Overview
2. Introduction
2.1 Overview
In order to use Oracle Lease and Finance Management as the primary system for managing your
equipment-financing portfolio, you typically will consider converting data from legacy systems.
Data conversion can be complex as it usually involves multiple source legacy systems and it spans
various Oracle Applications modules.
To assist you with planning and executing your conversion, this document will outline a standard
approach as well as tools and other recommendations.
The conversion process is comprised of four major stages, each of which with a set of activities
intrinsic to the phase. The stages are displayed in the figure below.
Conversion
Proposal
Develop
conversion
strategy
Develop
conversion plan
Prepare
Conversion
Execute
conversion plan
Converted
Data
Identify Risks
Define Strategy
During Stage 2: Develop Conversion Plan; you develop a detailed plan for the conversion effort.
Planning includes the following activities:
In Stage 3: Prepare Conversion, you complete activities required before the actual data conversion
takes place. These activities include the following:
Overview
Cleanse Data
Map Data
In the final Stage 4: Execute Conversion Plan, the actual conversion of business data is executed.
Typical activities during this stage are the following:
The stages and activities in your conversion plans may be different. However, this document will
use the stages and activities above to outline a process for converting data from your legacy
system into Oracle Lease and Finance Management or other Oracle Application modules to insure
you can operate and service your contracts after performing a conversion.
A discussion of the stages, recommendations and suggested methodologies has been broken up
into two separate documents. This document focuses on the last two stages of the conversion
process: Prepare Conversion and Execute Conversion. The first and the second stages: Develop
Conversion Strategy and Develop Conversion Plan are addressed in a separate document, [add
document name].
2.2 Scope
This document describes activities associated to the third and fourth conversion stages,
Preparation and Execution, of converting leasing and loan data into Oracle Lease and Finance
Management. Each stage is comprised of one or more activities or phases. For each activity or
phase, the document provides a recommended approach; references for existing tools that can be
used for that activity, or a recommended approach for building conversion tools for activities that
have no existing supported tools available.
You may have many types of financial products and contracts in your legacy systems that you
plan to convert into Oracle Lease and Finance Management. However, in order to provide a
concise description of the steps in the basic recommended conversion process and address most of
the common data types and processes, the scope of the examples has been limited to the following
scenario:
Converted contracts have a book classification of Direct Finance (lease) and other
attributes as defined in the Sample Contract (see Appendix).
You are converting into a freshly installed instance with no existing active contracts or
other data. NOTE: The strategy for converting an acquired portfolio into an existing
production is not included in this document.
You are converting into an environment with Oracle Lease Management Minipack
OKL.H.
Scope
Two assets
Level payments
You have billed and accrued all contracts to be converted in your legacy systems up to the
conversion date.
Your users are familiar with the Oracle Lease and Finance Management application and all
supporting Oracle Applications modules.
You have completed all required setups to support full lifecycle processing of the converted
contracts. The development, testing and production environment should have all the required
functional set-ups and reference business objects before the start of the conversion process.
You are providing development and conversion environments for development of conversion
related programs.
You are not splitting transactions from the source instance to be migrated into the target
instance. The transactions are considered in entirety while converting into the new instance.
You have correctly mapped the data and setups from the legacy application(s) to the new
Oracle Lease and Finance Management instance, which has a direct impact on the accuracy of
the converted data. You may have to manually correct errors for those transactions that fail
conversion.
2.4 Limitations
Please be aware of the following limitations that apply to the activities described in this document:
Performance benchmarks and functional descriptions provided are limited to the import
interface, concurrent program, and APIs mentioned in the relevant phases.
Unless explicitly specified, programs mentioned perform a one-time INSERT only operation.
You cannot use the programs to perform updates to data or incremental loads (Incremental
means updating the changes to previously converted data at a later point of time).
You are expected to handle investigation and correction of any data fall-outs resulting from
production instance migration.
Some recommended APIs are designated as Private [filename].pvt). Such programs were not
originally designed for standalone use. While the use of such programs may be recommended,
you should be aware that product support for such programs might be limited.
Other assumptions specific to an activity or phase are addressed in the relevant phase descriptions
below.
Limitations
10
2.5 Tools
The following tools are available to facilitate a conversion project:
Oracle PL/SQL Language
SQL to access database
Oracle Development Platform (Forms, Reports, OAF etc.)
Telnet and FTP
Oracle Applications Modules
Dataloader
SQL Loader
Tools
11
3. Disclaimer
Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle
Corporation and/or its affiliates. Other names may be trademarks of their respective
owners.
Tools
12
4. Definitions
accrual accounting
Recognizing accounting for economic events regardless of when actual cash transactions occur.
The opposite of cash basis accounting.
aged contract
An aged contract is defined as a contract that has begun its lifecycle on another leasing system but
will be imported into Lease and Finance Management.
amortization
The systematic method for recording financial elements to income or expense over a defined
period, typically the lease or loan term.
API
An acronym for application programming interface
approver
The person who is authorized to approve a document before the next activity may be carried out.
asset item
Anything you make, purchase, or sell including components, subassemblies, finished products, or
supplies that carries a cost and is valued in your asset subinventories.
asset disposition
Sale or disposal of assets.
authoring
A process of creating a contract.
auto-invoice
The process of automatically invoicing the lessee for a payment due. This process can be
automated by running a concurrent program.
auto-terminate
The process of automatically terminating a lease contract when it reaches its end of term. This
process is automated by running a concurrent program.
benchmarks
An established point of reference against which computers or programs can be measured in tests
comparing their performance.
billed basis
An event initiated based on when the item is billed.
Tools
13
billing
The process of notifying the responsibility party of amounts due, usually through an invoice.
booking
The process of preparing and recording accounting records associated with a contract.
business unit
A business unit is an entity created by a company to manage a certain segment or segments of its
business. The business unit can span multiple product lines and geographies.
custom build
Interfaces are the regular inbound and outbound links between Oracle and other third party
systems.
concurrent program
An instance of an execution file, along with parameter definitions and incompatibilities.
Concurrent programs use concurrent program executables to locate the correct execution file.
Several concurrent programs may use the same execution file to perform their specific tasks, each
having different parameter defaults and incompatibilities.
consolidated billing
One or more billing items combined into one group for invoicing purposes.
contract
A written, signed, Legal Agreement between/among trading partners that has financial, legal, and
industry-specific operational consequences.
contract activation
A series of steps performed on an authored contract that culminates with a booked contract that is
ready to be billed.
contract ID
Unique identifier of a contract.
contract status
The state of the contract. Possible values: new, passed, complete, incomplete, pending approval,
booked, under revision, evergreen, litigation hold, bankruptcy hold, expired, terminated, reversed,
amended, abandoned
contract validation
The application of various QA logic and business rules to a contract to insure it meets business
requirements.
customization
Customizations are enhancements to an Oracle applications system made to fit the needs of a
specific user community.
Tools
14
data conversion
Data conversion is the inbound loading of required open and historic data from systems that are to
be replaced by the Oracle e-Business suite. It is the data required in the new system from the golive date.
data setup
Data Set-up is the manual entry of new data specific to the TCO e-Business Implementation.
direct finance(DF) lease
Direct finance lease is a non-leveraged lease by a lessor (not a manufacturer or dealer) in which
the lease meets any of the definitional criteria of a capital lease, plus certain additional criteria.
disposition
Sale or disposal of assets.
disbursement
Disbursements are payments to suppliers or other third parties for the cost of equipment, a
prepayment facility with lessor, maintenance, insurance and other services. Some disbursements
such as pass-through and investor payments are linked to billing events.
due date
The date on which payment is due from the customer.
effective dates
Effective dates are the dates a record is effective or to be in use.
evergreen
Evergreen refers to a lease contract period past the initial term end date, when rents are still
collected. Evergreen is the default contingent continuation of a lease after its contractual end-ofterm, where a lessee continues to pay indefinitely. The contract language includes an Evergreen
Eligibility Clause, indicating the customer will be billed a rental amount indefinitely unless they
provide the Equipment Return Notice by a certain date.
financial product
A financial product in Oracle Lease and Finance Management groups together a set of attributes
and rules based on which contracts are created. It is mandatory for every contract to be associated
with a single product.
flexfield
A flexible data field format that your organization can customize to your business needs without
programming.
FMV
An acronym for Fair Market Value. The price for which property is sold in an arms-length
transaction between two unrelated parties.
Tools
15
formula
An arithmetic operation over operands.
function
A function is a register of a function that returns a scalar numeric value.
function parameter
A function parameter passes a value to function. The function parameter gets its value from the
corresponding context parameter. The context parameter comes from an instance of context in
which the function is executed.
funding
Generally, funding is the process of paying a supplier for leased equipment.
general ledger
The General Ledger (GL) is the book of final entry summarizing all of a company's financial
transactions through offsetting debit and credit accounts.
interface
Interfaces are the regular inbound and outbound links between Oracle and other third party
systems.
inventory item
Items you stock in inventory. You control inventory for inventory items by quantity and value.
Typically, the inventory item remains an asset until you consume it. You recognize the cost of an
inventory item as an expense when you consume it or sell it.
You generally value the inventory for an item by multiplying the item standard cost by the
quantity on hand.
invoice
A bill sent to a customer, or a notice for the lessor to pay a disbursement to an investor.
invoice amount
Total amount of charges on an invoice.
invoice date
The date of the Oracle Receivables invoice. The invoice creation date, invoice date, invoice
printing date, and the due dates can be different in any receivables system. In Lease Management,
the invoice date and payment term derive the due date.
invoice format
Invoice format is a group of invoice types that specify how data is to appear on the invoices.
invoice generation
The process of creating an open receivables invoice within Oracle Receivables.
Tools
16
items
Items can be master documents, collateral, or attachments in fulfillment. Items are inserted in the
body of an email. Items are selected from the list of all possible documents and collateral material
available to the user from fulfillment templates.
journal entries
A set of financial data that is of significance for recording ledger transactions in accounting.
key flexfield
A key flexfield is a field format you can customize to enter multi-segment values such as part
numbers, account numbers, location, and so on. Key flexfields relate to specific uses in Oracle
applications.
lease
A lease is a contract in which one party conveys the use of an asset to another party for a specific
period of time for a predetermined payment amount.
lessee
User of the equipment being leased.
lessor
Owner of the equipment which is being leased.
OKL
An acronym for the Oracle Lease and Finance Management product, as designated in the Oracle
applications database.
Lease and Finance Management
A general reference acronym for Oracle Lease and Finance Management, not to be confused with
Oracle Learning Management.
open item
A receivable item that has not been paid.
partial termination
The amount a customer must pay for a subset of assets and a contract to terminate them and pay
off all future amounts due.
product
Usually, financial product (not an asset; for example, not a piece of equipment).
profile options
In Oracle Applications, profile options enable you to turn on or off specific functionality, such as
integrations and processes, and allows you to set specific parameters that govern a process or
transaction such as number of days before a task is due that the user is notified.
Tools
17
property tax
Tax assessed for owning property.
reconciliation
The act of reconciling data from Legacy or interface tables to the Lease and Finance Management
system.
residual amount
The estimated value of an asset at the end of a lease for which the lessee is not expected to pay.
responsibility
A responsibility is a level of authority in Oracle Applications that allows access only to those
Oracle Applications functions and data appropriate to fulfill your role in the organization.
service (1)
a) Customer Service, the Lease Center view of Oracle Lease and Finance Management provided to
a lessor's Customer Service agents who login using the Lease Center Agent profile. Lessees,
vendors, and other interested parties typically telephone into lessor's call center to ask questions
regarding specific account details.
b) Customer Self Service, web portal access to lessees so they can view their account and contract
information. Set up by the lessor so that lessees can access their own account information,
according to the lessor's information and security policies.
c) Vendor Self Service, web portal access to both vendor and customer contract and account
information. Set up by the lessor so that vendors and suppliers can access their own account
information, and information on lessees of their equipment, according to the lessor's information
and security policies. (May update and enter some transactions.)
service (2)
Service contracts on leased equipment assets. (Also, Oracle Service Contracts is a separate Oracle
E-Business Suite application that integrates with Oracle Lease and Finance Management.)
service and maintenance
Fees charged to a customer for servicing or warranting assets, such as extended warranty
contracts.
stream
A stream is a schedule of amounts and associated dates.
stream activity
Stream activity types describe the state of the stream. A stream can be ACTIVE, CURRENT,
HISTORY, or WORKING.
stream element
A single amount and its corresponding date (i.e., a cash flow). A stream element is the line level
detail of a stream. A stream can have multiple stream elements.
Tools
18
stream purpose
A stream purpose is an important attribute of a stream type that determines how Lease
Management processes the stream. Lease Management recognizes streams based on their stream
purpose name.
stream type
The functional name for a stream which relates to the attributes used to process a stream.
stream type subclass
Rent or Residual.
subledger
A book in which the monetary transactions related to a specific financial function of a business are
posted in the form of debits and credits before the financial transaction is posted in the General
Ledger.
supplier
Oracle Payables uses the term "Supplier" for vendors, so "Vendor" and "Supplier" are used
interchangeably for the purpose of this document, unless specified otherwise.
system administrator
The system administrator is the person who manages administrative tasks in Oracle Applications,
such as registering new users and defining system printers, using the system administrator
responsibility.
task
A task is a discrete unit of work that is assigned to one or more individuals. Tasks are managed by
the Task Manager. Tasks are often scheduled events and have defined expirations.
termination
The process of ending a leasing transaction with the lessee.
TCA
An acronym for Trading Community Architecture. This is a standardized approach in Oracle
Applications for handling customer and other party information.
termination quote
Termination quotes allow contracts or assets on a contract to terminate early or at the expiration of
a contract. Termination quotes identify the financial impact of the termination. The various
business rules specified in a contract's terms and conditions are the basis of calculating the
financial impact of a termination quote.
terms and conditions
Financial and legal arrangements that are agreed to by parties of a contract.
transaction type
An event in Oracle Lease and Finance Management relating to a contract or asset.
Tools
19
user
A user is any person who needs access to any application, including various types of customers,
partners, suppliers, and employees.
user ID
The User ID is a combination of a user name and its password.
user profile
User profiles, which are associated with responsibilities, are a set of user interfaces that give users
access to their personal data and preferences.
user type
A user type is a category of users that caters to the specific needs of an application's business
requirements in User Management. User types allow flexible and extensible ways for defining,
categorizing and implementing behavior of users. A user type is associated to only one template,
one responsibility, zero or one approval and zero or more roles.
vendor
A supplier of equipment or services. A vendor can be a manufacturer, reseller, distributor, or
dealer.
workflow
A complete workflow management system that supports business process definition and
automation in Oracle Applications. Typically, workflow is used for contract approval, change
requests, and notifications.
yield
A measurement of profitability obtained from a series of cash flows. This may represent the
lessor's return on invested funds.
Tools
20
Elimination of redundancies
Minimization of errors that normally occur when re-entering the same data multiple times
Improved ability to view and analyze business data for common transactional objects,
such as bank accounts, contracts, agreements, etc.
5.2 Parties
One of the most important Master Data Management features of the Oracle e-Business Suite is the
management of party relationships. Oracle Lease and Finance Management, through the
Master Data Management
21
Party sites: Addresses that parties use for specific purposes, or uses.
Customer accounts: The business relationships between the lessor and his lessees or
borrowers.
Customer account sites: Party sites used in the context of customer accounts for specific
purposes, or uses, for example ship-to and bill-to account sites.
Contact points: Means of contact, for example, phone and e-mail address.
You should study the required hierarchy of parties and accounts before deciding what data to
convert. Parties and their attributes is one of the main types of Master Data. As such, it must be
loaded and configured early before any transactional data is converted.
5.3 Streams
A significant aspect of the implementation and conversion efforts is associated to the setup and
generation of streams.
A stream is simply a series of elements comprised of amount and associated dates. In other words,
a stream is a flow of one or multiple amounts, each associated to a specific date. This is a central
concept to term lending or asset based financing because the lender or lessors investment is
Streams
22
recovered through a series of scheduled payment flows or streams. Cash flows are required for
appropriate financial analysis, for supporting transactions you have with customers and partners
and to support related accounting. The relationships between streams, transactions and rates are
balanced and any change to the streams requires an offsetting change in the transactions and rates
associated with the streams.
Lease and Finance Management crucially relies on streams for multiple aspects of a contract
processing such as billing, accounting, pricing and other financial calculations. Given their
fundamental role, streams must be generated at the time of contract activation and every time a
revision having a financial impact takes place.
The name of a stream is referred to as Stream Type. You are required to maintain a standard list of
stream types and setup templates of stream types associated to specific purposes that Lease
Management uses to determine the stream type to assign to the streams generated for new
contracts. A stream type is fundamental as it acts as an identifier for the various Lease
Management processes that need streams to produce transactions, such as billing and accounting.
In fact, the stream type is used by Lease and Finance Management to determine the accounting
entries applying to the stream for various types of transactions. It is for these reasons that any
financial amount created for the contract at any point during its lifecycle must be associated to a
stream type in order to be accounted for and processed correctly.
5.4 Contracts
In Lease and Finance Management, your financing deals are represented as contracts. Each
contract has a seller (the lessor) and buyer (the lessee/borrower). The lines on the contract
represent financial transactions that comprise your deal.
Contracts have the following primary components:
Header The contract header links together many important pieces of information you
need to maintain and control your financing contract over its life, such as the
lessee/borrower, dates, any vendor agreements or master lease agreements related to the
contract and certain financial settings.
Parties Parties are associated to a contract that control participants in the transactions
generated by the contract. For example, in order to pay suppliers/vendors they must be
associated to the contract as a party. The party association provides you the ability to
control access to contract information and insure that unrelated parties cannot participate
in contract transactions.
Terms and Conditions The terms you agree to in a contract with a customer that effect
the future contract transactions are recorded in the Terms and Conditions section. Lease
and Finance Management uses the information in the terms and conditions to perform
many automated activities and tasks. There are several options for you to create standard
templates that insure contracts of a particular type have the required terms associated to
them as well as streamline your deal authoring activities.
Lines Items that generate transactions in your deal are represented as lines on the
contract. Assets, financed amounts, income fees, expenses, services, usage meters and
other billable items are stored as contract lines. You can also relate some contract lines to
each other. For example, if you have an expense contract line, you can associate that line
to the asset lines on the contract. This enables to you look a the profitability of individual
assets in a deal.
Unless you create a transaction in a different E-Business Suite module, such as AR or AP, all
accountable transactions must be related to a contract so that the correct journal entries can be
derived.
Contracts
23
Cleanse Data
Customers Each customer you have should have only one master record in the EBusiness Suite. The customer may have multiple accounts that represent different billing
sites. This master record allows you to maintain a single view of your relationship with
them.
Suppliers Each supplier you do business with should have only one master record in the
E-Business Suite. The supplier may have multiple pay sites that represent different
payable locations. This master record allows you to maintain a single view of your
relationship with them.
Contacts Each contact you have, both internal and external, should have only one
master record in the E-Business Suite. This allows you to view relationships with
individual contacts, saves time and maintains accuracy when you add contacts to
contracts or accounts.
Inventory Master Items The inventory of master items you create forms a catalog that
allows you to maintain a common, consistent set of information about the equipment you
finance. The business information you are able to obtain about specific makes and models
can prove highly valuable as you track the assets with these master items over time.
Agreements Vendor, Investor and Master Lease Agreements are created once with a
common set of terms and conditions. You then reference those agreements when you
24
create and process contracts for deals. This insures that terms and conditions you
maintain separately from your contracts are consistent, reliable and verifiable.
Depreciation Categories You define a common set of depreciation methods, rates and
convention configurations that you apply to the different assets you finance on leases.
This insures that you can calculate and account for depreciation consistently for the same
types of assets.
25
contract is balanced at the time you book a contract. You must insure that the balances you convert
for a contract are balanced with the remaining stream elements and the accounting you expect to
generate for a contract after conversion.
Map Data
26
Each phase is comprised of a set of tasks you should perform and a recommended order of
execution.
27
8.1 Overview
The following diagram depicts the various phases in the conversion effort.
Source System
Legacy Instance
Da
ta
ba
se
Lin
Target system
Oracle Applications11.5.10
k
Conversion Download
Program
(Customization)
11.5.10 Staging
Tables
(Customization)
Interface Program
(Standard or Customization)
11.5.10 Open
Interface Tables
11.5.10 Production
Tables
Overview
28
8.2 Assumptions
You perform the data extraction process from your legacy system instance.
You analyze and cleanse data before conversion into the new Oracle Applications instance to
insure it is accurate, free from duplicates or errors.
You analyze and map the data that needs to be imported into Oracle Applications so that it
represents the same data in Lease Management and other Oracle Applications as it does in
your legacy system. This includes mapping scenarios that include: one to one, many to one,
one to many etc.
You merge and consolidate data as part of the data cleansing activity and not during the data
conversion activity. For example, merging multiple invoices for a supplier, multiple invoices
for a customer, merging two customers/suppliers into one, etc. is not considered for data
conversion.
8.3 Tasks
The following are typical tasks in the Extraction and Stage Legacy Data phase.
Assumptions
Discovery of hidden sensitive data such as the last four digits social security number
hidden in another user id as part of a data masking or de-identification project
29
The output of this section is data mapping spreadsheets that show what is needed for the Oracle
target application processing to meet business operational requirements and where these data
elements will come from.
Tasks
30
8.5 Reconciliation
The data should be reconciled between the legacy system and the staging area.
Task Order
31
9.1 Objective
The objective of this phase is to identify the list of master data objects necessary to load and
support a contract into Oracle Lease and Finance Management and recommend the interfaces
needed to upload these master data object records into Oracle Applications.
9.2 Overview
The Master Data Load phase of the conversion process covers the master data objects that must be
loaded into Oracle Applications prior to the Contract Import Interface process. The list of master
data objects required to support the sample Direct Finance lease contract addressed in this section
is:
Customers
Vendors
Items
Vendor Programs
Credit Lines
9.3 Assumptions
The assumptions for this phase are as follows.
You have extracted the required master data objects from the legacy systems and placed
it in staging tables
You have cleansed and transformed that master data records to meet the interface
requirements.
The tasks listed below are MANDATORY unless otherwise specified as OPTIONAL.
Objective
32
9.4 Tasks
9.4.1 Load Customers
The customer data object covers all information relating to customers, such as number, name,
address, payment terms, contact details etc. The customer master record is mandatory to load any
contract and perform billing and collecting activities for production contracts.
9.4.1.1 Interface and Programs Usage
Oracle Applications provides two methods for importing customer records from legacy
systems. Customer records can be imported using the Receivables Customer Interface or
through the TCA Bulk Import Process.
9.4.1.1.1 Customer Interface
Use Customer Interface to import and validate current or historical customer information
from other systems into Receivables. Once customer information is imported into the
system, you can use Customer Interface to import additional data for that customer (such
as additional contacts or addresses) and to update existing information.
The following is the list of customer interface tables.
Interface Name
Description
RA_CUSTOMER_INTERFACE
RA_CUSTOMER_PROFILES_INTERFACE
RA_CONTACT_PHONES_INTERFACE
RA_CUSTOMER_BANKS_INTERFACE
RA_CUST_PAY_METHOD_INTERFACE
For additional information on the customer interface, please refer to the Oracle
Receivables User Guide.
9.4.1.1.2 TCA Bulk Import
Bulk Import is used to load data from legacy or other external systems in bulk into the
TCA (Trading Community Architecture) Registry. TCA provides validations and optional
de-duplication to ensure the quality of the imported information. Bulk Import is used only
to import information on the party level. The concurrent program used is Import Batch to
TCA Registry (ARHIMAIN).
Interface Tables used in Bulk Import Process are:
Tasks
Interface Name
Description
HZ_IMP_PARTIES_INT
Party Information
33
HZ_IMP_ADDRESSES_INT
HZ_IMP_CONTACTS_INT
Party Contacts
Additional information on how to import customers using the TCA Bulk import can be
found in the Metalink document How To Import Parties Using Bulk Import Process,
Doc ID: 279924.1. Also refer to the Oracle Trading Community Architecture User Guide,
Release 11i.
9.4.1.2 Custom Build
The following is the list of custom build objects you may need to support the customer
interface and the TCA Bulk Import process.
9.4.1.2.1 Customer Interface
You must develop an import program that is compatible with the environment from which
you want to import your data to load the interface tables. Once the import data is loaded
into the interface tables, you can run Customer Interface to validate the data and convert it
into Receivables customer information. The type of feeder program you write depends on
the environment from which you are importing data. For example, you can use
SQL*Loader, SQL*Report, PL/SQL, or C to write an import program to import data from
a non-Oracle system. Regardless of the type of import program you write, the output
should be in a standard data format that Customer Interface could use to import the
information into Receivables.
More information on importing customer records through the customer interface can be
found in the Oracle Receivables Implementation and User Guides, Release 11i.
9.4.1.2.2 TCA Bulk Import
Custom scripts need to be created for importing data into the interface tables and to create
an import batch.
Additional information on the custom script logic and how to import customers using the
TCA Bulk import can be found in the Metalink document How To Import Parties
Using Bulk Import Process, Doc ID: 279924.1. Also refer to the Oracle Trading
Community Architecture User Guide, Release 11i.
9.4.1.3 Reconciliation
The number of customer records loaded into the customer tables must equal the number in
the interface tables. Use a sample of customer records within the Receivables module to
verify that the records operate as expected and without error. For instance use the
Tasks
34
converted customer record to enter sample invoices, credit memos, adjustments and
receipts, and use in billing interfaces.
9.4.1.3.1 Customer Interface
Oracle Receivables generates the Customer Interface Transfer report each time you run
Customer Interface. This report lists the number of records imported into each table and
records specific error messages describing any problems. You may need to make changes
in either your feeder program or Oracle Receivables to resolve the errors. For more
information, please refer to the Oracle Receivables User Guide, release 11i.
9.4.1.3.2 TCA Bulk Import
Once the Process is completed you can review the data. Use the following SQL mentioned
in the Metalink note - 279924.1.
select
party_number,party_id||','||party_type||','||party_name||','||orig_system_reference||','||status
from hz_parties where orig_system_reference in(select party_orig_system_reference from
hz_imp_parties_int where batch_id=10141);
This query will give you the party number. Then query the Party created using the Party
Number through the customer detail pages in Oracle TCA to verify accuracy of the
converted record.
9.4.1.4 Performance Considerations
If you are importing a large number of customers using the Customer Interface, use the
Customer Interface Master concurrent program to invoke parallel workers that process
data at the same time. Before you run this program, define the number of workers to use in
the HZ: Number of Workers Used by Customer Interface profile option.
9.4.1.5 Benchmarks
Typically, one million customer records per hour can be imported using the TCA Bulk
Import method. These performance metrics are based on one address per customer.
Tasks
35
Load supplier data into the supplier import interface tables. Once supplier records are
loaded into the interface tables, the following interface programs should be submitted.
Tasks
Interface Name
Description
AP_SUPPLIERS_INT
AP_SUPPLIER_SITES_INT
AP_SUPPLIER_SITES_INT_ALL
holds Supplier Site information that is
loaded by the user for import. The
columns in the table map to
corresponding columns in
PO_VENDOR_SITES_ALL table.
The Oracle Payables application uses
this information to create a new
Supplier Site record when the
Supplier Sites Open Interface Import
program is submitted. Each row in the
table will be joined to the appropriate
Supplier using the VENDOR_ID
column. This is the open interface
table for AP Supplier Sites. Use it in
conjunction with
AP_SUPPLIERS_INT table.
AP_SUP_SITE_CONTACT_INT
36
Description
AP_PO_VENDORS_APIS_PKG
AP_PO_VENDORS_APIS_PKG
AP_PO_VENDORS_APIS_PKG
For more information, please refer to the Oracle Payables User Guide, release 11i.
9.4.2.2 Custom Build
The following is the list of custom build objects needed for loading the supplier records
into Oracle Payables.
9.4.2.2.1 Supplier Interface
Depending on the source of data, you create customized scripts to upload data into the
interface tables.
9.4.2.2.2 Supplier Packages
Create custom scripts that call the supplier package APIs (routines) to load supplier data
into Oracle Payables. More information on the supplier package routines can be found in
the Oracle Payables User Guide, Release 11i.
9.4.2.3 Reconciliation
The number of supplier records loaded into the supplier table must equal the number in the
extract file if using Supplier Package APIs and must equal the number of records in the
open interface tables if using the open interface tables. Use a sample of supplier records
within the Payables module to verify that they operate as expected and without error. For
instance use the converted supplier record to enter invoices, credit memos etc.
Use any output files of the Supplier Interface Import programs to reconcile the supplier
records imported with the legacy system.
Tasks
37
MTL_INTERFACE_ERRORS
MTL_ITEM_REVISIONS_INTERFACE
Description
You use the
MTL_SYSTEM_ITEMS_INTERFACE
table for new item numbers and all item
attributes. This is the main item interface
table, and can be the only table you
choose to use.
This table is used for error tracking of all
items that the Item Interface fails.
If you are importing revision details for
new items, you can use the
MTL_ITEM_REVISIONS_INTERFACE
table. This table is used only for revision
information, and is not required.
After you load the items into these interface tables, you run the Item Interface to import
the data. The Item Interface assigns defaults, validates data you include, and then imports
the new items.
For more information, please refer to the Oracle Inventory User guide. Also refer to the
Metalink document Item Open Interface Setup and How-To Doc ID 115557.1.
9.4.3.2 Custom Build
Before you use the Item Interface, you must write and run a custom program that extracts
item information from your source system and inserts it into the
Tasks
38
Description
OKL_MASTER_LEASE_AGREEMENT_PUB.
CREATE_MASTER_LEASE_AGREEMENT()
This API creates one master lease agreement at a time. For more information on Master
Lease Agreements, please refer to the Oracle Lease and Finance Management User Guide,
release 11i.
9.4.4.2 Custom Build
You need to create your own custom scripts to load Master Lease Agreement records from
legacy systems and call the interface routine within the script to create Master Lease
Agreement records in Lease Management. For batch processing capabilities, you can
create custom wrappers.
9.4.4.3 Reconciliation
None
Tasks
39
Description
OKL_VENDOR_AGREEMENT_PUB.
CREATE_VENDOR_AGREEMENT()
This API creates one vendor agreement at a time. For more information on Vendor
Agreements, please refer to the Oracle Lease Management User Guide, Release 11i.
9.4.5.2 Custom Build
You need to create your own custom scripts to load vendor from legacy systems and call
the interface routine within the script to create the Vendor Agreements in Lease
Management. For batch processing capabilities, you can create custom wrappers.
9.4.5.3 Reconciliation
None
9.4.5.4 Performance Considerations
This API does not support parallel processing.
9.4.5.5 Benchmarks
Typically, 3000 Vendor Agreement records per hour can be created using the API and
60,000 Vendor Agreement records can be activated per hour.
40
request by setting up and activating a credit line in Lease Management. Lease Management allows
you to set up and execute checklist items before you activate credit lines. You can also set up
checklists for a credit line that apply to funding requests for contracts associated to credit lines. A
contract can only participate in one credit line, but you can associate a credit line to a master lease
agreement and all contracts associated with the master lease agreement will use the same credit
line.
Credit lines must be activated before you can use them with your contracts.
9.4.6.1 Interface and Programs Usage
Use the Credit Line APIs to import and create Credit Line records in Lease Management
from legacy systems and activate them.
Users can use the following API to create Credit Line records.
Interface Name
Description
OKL_CREDIT_PUB.CREATE_CREDIT
OKL_CREDIT_PUB.ACTIVATE_CREDIT
The APIs create and activate one credit line record at a time. For more information on
Credit Lines, please refer to the Oracle Lease Management User Guide, release 11i.
9.4.6.2 Custom Build
You need to create your own custom scripts to load and activate credit lines from legacy
systems and call the interface routine within the script to create the Credit Line records in
Lease Management. For batch processing capabilities, you can create custom wrappers.
9.4.6.3 Reconciliation
None
9.4.6.4 Performance Considerations
The APIs does not support parallel processing or bulk processing capabilities.
9.4.6.5 Benchmarks
Typically, 40000 Credit Line records per hour can be created using the API and 80,000
records can be activated per hour.
Task Order
1.
2.
3.
41
9.6 Reconciliation
As part of phase 1, the master data is extracted from the legacy system and staged in interim tables
prior to loading them into the interface tables or the production tables in Oracle Applications. The
following methods may be implemented for reconciling the master data objects loaded in this
phase:
The master data objects loaded into the interim staging tables may be reviewed and
compared with the Oracle Applications master data objects using custom built
reconciliation reports.
Various methods for reconciliation mentioned in the above sections and the referenced
Metalink documents could be implemented in such custom reconciliation reports.
To insure data is working as expected, test the data by booking a contract in Oracle Lease
and Finance Management using the converted master data objects.
Reconciliation
42
10.1 Objective
The following are the objectives for this phase.
To create funding requests and other pending disbursements for Active contracts
10.2 Overview
You create contracts in Lease Management using supported interfaces. Before activating a
converted contract, all contracts should be created, reconciled and verified. Importing in batches
allows you to more easily reconcile and control the contract creation process.
The following sections describe the process for importing a sample Direct Finance lease contract
with two asset lines during the base term of the contract. Initial Data Load phase of the conversion
process covers the following process:
Create Contract
Validate Contract
Approve Contracts
10.3 Assumptions
The assumptions for this phase are as follows:
Users have setup the external stream generator as the pricing engine.
Objective
43
10.4 Tasks
10.4.1 Contract Import
Oracle Lease and Finance Management allows you to import contracts through a standard set of
interface tables. The import program imports data from interface tables into the Oracle Lease and
Finance Management tables. After interface tables are populated, you submit a request to import
and process contracts.
10.4.1.1 Interface and Programs Usage
To submit the Import Contract concurrent program navigate to Processing->Interfaces>Import Contracts.
You can set the following parameters for the import batch: Batch Number, Contract
Number, Customer Number, Start Date From, Start Date To, Number of Parallel Instance.
Based on the parameter(s) entered, a set of contracts will be selected for import for the
specific request from the interface tables.
You populate the following interface tables before submitting the contract import
concurrent program.
Interface Table Name
Description
OKL_HEADER_INTERFACE
OKL_LINES_INTERFACE
OKL_PAYMENTS_INTERFACE
Payments table
OKL_PARTY_ROLES_INTERFACE
Party Roles
OKL_TERMS_INTERFACE
You can import contract in batches by populating the batch number field in the interface
header table.
The contract import program follows these processes:
Validate required values The program validates the required values are loaded for
each contract in the interface tables. The system marks the record status as
ELIGIBLE if all required values are found populated. Otherwise, it changes status
to ERROR and reports the error detail in a concurrent log/output file.
Load into Lease Management tables After the validation phase, each ELIGIBLE
contract is populated in the corresponding destination data table. The record status in
the Interface is set to either INTERFACED or ERROR depending on the result of
loading. This process continues for all ELIGIBLE contracts. The system generates a
detailed report as a concurrent manager log/output file.
Process After the load, the import program processes loaded contracts. As each activation
step is completed, the contract status is updated.
Tasks
Contract Status
Description
NEW
44
PASSED
COMPLETE
APPROVED
BOOKED
Based on the parallel processing capability, users can specify number of parallel workers
as a parameter for contract import program.
10.4.1.2 Custom Build
None
10.4.1.3 Reconciliation
Based on the status mentioned in interface header table, the import program will process
the contract to the specified contract status.
If the contracts are processed in batches, you can verify the number of contracts in the
interface tables compared to the contracts successfully processed in Lease and Finance
Management tables. You should verify the assets associated with the contract in legacy
systems are correct after the import.
If the contracts are imported through Booked status, make sure the asset values like Asset
Cost, Depreciation Values and In-Service Date for the assets in Oracle Assets are the same
as in your legacy system. You can verify the values through screen-based inquiries in
Oracle Assets or by custom scripts to verify these attributes.
10.4.1.4 Performance Considerations
None
10.4.1.5 Benchmarks
Typically 170,000 contracts with 240,000 assets can be imported to New status in 3.5 hrs
45
You should create actual funding requests for open or partially paid payable invoices. Update the
funding request to Approved using update APIs for each actual funding request that corresponds
to an open payable invoice. The Lease Management disbursement program picks up these funding
requests and creates payable invoices automatically when you run the correct programs.
10.4.2.1 Interface and Programs Usage
Create funding header, lines and approve funding using the following APIs.
API Name
Description
OKL_FUNDING_PVT.CREATE_FUNDING_HEADER()
OKL_FUNDING_PVT. CREATE_FUNDING_LINES()
OKL_FUNDING_PVT.
UPDATE_FUNDING_HEADER()
Tasks
46
Description
Description
OKL_CONTRACT_BOOK_PUB.VALIDATE_CONTRACT()
This API can be called one contract at a time. There is no parallel processing or bulk
processing capabilities for the validation program.
Tasks
47
Description
OKL_CONTRACT_BOOK_PUB.GENERATE_STREAMS()
There is no parallel processing or bulk processing capabilities for the pricing program.
10.4.5.2 Custom Build
This API can be called one contract at a time. If you need batch processing capabilities to
submit multiple contracts at one time, create custom wrappers.
10.4.5.3 Reconciliation
After the streams generated, check the contract for any errors or warnings. Errors or
warnings can be corrected and the streams program can be submitted to process those
records again.
The generated streams can be summarized and compared with legacy data like pricing,
payment schedules and/or yields for accuracy.
10.4.5.4 Performance Considerations
None
Tasks
48
10.4.5.5 Benchmarks
Typically, 170,000 contracts with 240,000 assets are validated in 20 hrs.
Description
OKL_CONTRACT_BOOK_PUB.
GENERATE_JOURNAL_ENTRIES ()
There is no parallel processing or bulk processing capabilities for draft journal entry
program.
10.4.6.2 Custom Build
This API can be called one contract at a time. If you need batch processing capabilities to
submit multiple contracts at one time, you can create custom wrappers.
If you want to reconcile accounting balances after generating draft journal entries, you
would build a custom report for generating a contract-level trial balance that can be
compared to your legacy system values.
10.4.6.3 Reconciliation
After the journal entries are generated, you can check the contract for any errors or
warnings. Errors or warnings can be corrected and the draft journal entry program can be
submitted to process those records again. You can verify the draft journal entries from the
screen through the accounting transaction inquiry pages or automate the reconciliation
process by creating a custom program to verify the journal entry records.
10.4.6.4 Performance Considerations
None
10.4.6.5 Benchmarks
Typically, for 170,000 contracts with 240,000 assets, journal entries can be created in 2
hrs.
49
status must be updated to APPROVED before a contract can be activated (booked), but execution
of the approval workflow is an optional step.
If the contract passes validation and was already approved in the legacy system, you may want to
skip the approval workflow step.
10.4.7.1 Interface and Programs Usage
Use the following API to submit contracts for approval.
API Name
Description
OKL_CONTRACT_BOOK_PUB.
SUBMIT_FOR_APPROVAL ()
10.6 Reconciliation
Before activating contracts, you should reconcile the contract attributes with the legacy system.
You can automate reconciliation process using custom build components such as checking for
accounting balances using a contract-level trial balance report
Task Order
50
11. Phase 4 Book & Terminate Expired Contracts (excluding Evergreen Contracts)
If you have off lease assets in your legacy system that you need to convert, they are likely from
lease contracts that are no longer active. These assets have values (Net Investment or Net Book
Values) that may be required in Oracle Assets (FA) or in your balance sheet (i.e., based on stream
values). You need this information in order to 1) put these assets on a new lease, 2) sell the asset
as a remarketed asset, or 3) scrap or otherwise dispose of the asset. During the time the asset is
"off-lease" (meaning is has been terminated but not yet re-leased/sold, etc.) you may also need to
depreciate it. In order to maintain association from the asset to the originating contract, you may
need to convert historical contracts.
11.1 Objectives
To create off-lease assets with balance in asset book including the originating expired
contract.
To create GL balance for terminated contract from legacy system for the assets.
11.2 Overview
In order to maintain the proper link for the off-lease assets between Lease and Finance
Management and FA, you should convert expired contracts related to off lease assets through the
contract life cycle, i.e., import, activation, and termination.
Depending upon the information you require and the number of contracts you need to convert,
there are two recommended approaches for converting the contracts and assets that are off lease.
1) Convert contracts with some simulated information, but enough information to
support the processing of off-lease assets.
2) Convert all contracts with all historical data to support processing off-lease assets.
11.3 Assumptions
Excludes evergreen contracts (i.e., contracts past the original end of term, but are still billing)
Assets that are sold in the legacy system are not converted
Funding (Payable invoices) and Billing (Receivable invoices) solution will be addressed in
Phase 3 - Initial Load, Phase 5 - Load Open Receivables (can be run in parallel with Phase 4,
and Phase 6 - Activation & Aging (Blackout Period Duration))
The asset cost for the imported assets are adjusted at NBV.
51
Seq
Task
Description
1
2
3
4
Solution 2
Consider this option when the volume of terminated contracts is high
Seq
Task
Note
GL balance adjustments
Tasks (Solution 1)
52
Update contract, line and stream statuses (if current streams are generated during a
previous step only the contract and line statuses are updated).
Billing transactions for interim interest invoices and upfront taxes invoices will be generated
and reside in the Lease and Finance Management internal billing transaction tables. In Phase 5
- Load Open Receivables (can be run in parallel with Phase 4) will prepare and post all
internal billing transactions to AR to create actual invoices. So you should suppress these
transactions if you dont want to transfer to AR for the creation of invoices.
The following APIs are used in this process:
API
Description
OKL_ACTIVATE_ASSET_PUB.ACTIVATE_ASSET
OKL_ACTIVATE_IB_PUB.ACTIVATE_IB_INSTANCE
Description
OKL_CONTRACT_BOOK_PUB.ACTIVATE_CONTRACT
Tasks (Solution 1)
53
You should use the following SQL to query the linkage between Fixed Asset and Lease
and Finance Management asset:
SELECT lse.lty_code, cle.id, cle.cle_id, itm.object1_id1, itm.jtot_object1_code
FROM apps.okc_k_lines_b cle,
apps.okc_line_styles_b lse,
apps.okc_k_items itm,
fa_additions ast
where lse.id = cle.lse_id
and itm.cle_id = cle.id
and ast.asset_id = itm.object1_id1
and cle.dnz_chr_id = (select khr.id from apps.okc_k_headers_b khr where
khr.contract_number = Contarct Number')
and itm.jtot_object1_code = 'OKX_ASSET';
You should use the following SQL to query the linkage between Install Base and Lease
and Finance Management asset instance:
SELECT lse.lty_code, cle.id, cle.cle_id, itm.object1_id1, itm.jtot_object1_code
FROM apps.okc_k_lines_b cle,
apps.okc_line_styles_b lse,
apps.okc_k_items itm,
csi_item_instances ib
where lse.id = cle.lse_id
and itm.cle_id = cle.id
and ib.instance_id = itm.object1_id1
and cle.dnz_chr_id = (select khr.id from apps.okc_k_headers_b khr where
khr.contract_number = 'Contarct Number')
and itm.jtot_object1_code = 'OKX_IB_ITEM';
11.5.1.4 Performance Considerations
None
11.5.1.5 Benchmarks
Typically, 500 contracts along with 4,500 - 5,000 assets will take about 60 seconds.
54
Below is the sample SQL script to allow you to update DATE_BILLED to conversion
date and ACCRUED_YN = Y for the converted contract stream elements:
update okl_strm_elements ste
set ste.DATE_BILLED = <Conversion date>,
ste.ACCRUED_YN = 'Y'
where exists
(select 1
from okl_streams stm
where stm.id = ste.stm_id
and stm.khr_id = <your khr_id>);
Below is the sample SQL script to allow you to update POST_TO_GL column to N in
accounting distribution table:
update okl_trns_acc_dstrs_all
set post_to_gl = 'N'
where source_table = 'OKL_TXL_CNTRCT_LNS'
and source_id in (select id
from okl_txl_cntrct_lns_all
where tcn_id in (select id
from okl_trx_contracts_all
where try_id in
(select id
from okl_trx_types_tl
where name in ('Booking')
and khr_id = <Contract ID>)));
11.5.2.3 Reconciliation
You should verify the total records and content that has been updated for the SQL script.
11.5.2.4 Performance Considerations
None
11.5.2.5 Benchmarks
None
55
Creates accrual accounting entries for catch-up (i.e., transfer accruals from nonincome bucket to income bucket). Only for Full Terminations.
11i10+ Reverse accruals (if excess accruals exist). Only for Full Terminations.
Accelerate income accrual recognition for financed fees. Only for Full
Terminations.
4) Dispose Asset
o
Retires assets in FA. Expires Item in Install base. 11i10+ Retires asset in FA on
quote effective from date.
Creates asset return record in Lease and Finance Management with return status
as Scheduled. 11i10+
Updates stream status to HISTORIZE (except for residual value and investor
contract obligation payable streams).
Sets the lines and contract to Terminated. 11i10+ Sets date terminated as quote
effective from date. (Only for Full Termination). If the contract is evergreen
eligible the contract and lines are updated to Evergreen status. Along with that
off-lease amortization and Termination accounting is also done for the contract.
Updates the payments i.e. remove future payments for terminated assets after
termination date.
Updates lines to Terminated for all the terminated financial assets. If the
financial asset is attached to service or fees, terminates those sub lines as well.
Terminates the primary service or fee line if all sub-lines terminated. (Does not
terminate those primary service and fee lines that do not have any sub lines).
Launches mass rebook, which rebooks the contract. 11i10+ Sets rebook date as
quote-effective date. Pass terminated assets to rebook API. (Only for Partial
Termination).
Tasks (Solution 1)
Concurrent Program
Description
56
Description
OKL_TRX_ASSETS
OKL_TXD_ASSETS_V
OKL_TXL_ASSETS_V
Below is the list of tables for asset return of Lease and Finance Management internal
transactions:
Table Name
Description
OKL_ASSET_RETURNS_B
Tasks (Solution 1)
57
2. Customer or Vendor
notification of intent to return
3. System notification of
potential return
Tasks (Solution 1)
API
Description
FA_ADDITION_PUB.DO_ADDITION
OKL_OKC_MIGRATION_PVT.UPDATE_CONTRACT_ITEM
OKL_TRX_ASSETS_PUB.CREATE_TRX_ASSET_DEF
OKL_TXL_ASSETS_PUB.CREATE_TXL_ASSET_DEF
OKL_TXD_ASSETS_PUB.CREATE_TXD_ASSET_DEF
OKL_SLA_ACC_SOURCES_PVT.POPULATE_SOURCES
OKL_AM_ASSET_DISPOSE_PUB.DISPOSE_ASSET
FA_ADJUSTMENT_PUB.DO_ADJUSTMENT
FA_RETIREMENT_PUB.DO_RETIREMENT
58
CSI_ITEM_INSTANCE_PUB.EXPIRE_ITEM_INSTANCE
59
11.5.4.5 Benchmarks
None available.
Tasks (Solution 2)
60
Description
OKL_CONTRACT_STATUS_PUB.UPDATE_CONTRACT_STATUS
OKL_CONTRACT_STATUS_PUB.CASCADE_LEASE_STATUS
OKL_ACTIVATE_ASSET_PUB.ACTIVATE_ASSET
Create Asset
Transaction from a
ready to be Booked
Contract which has
passed Approval
and created assets in
FA
OKL_ACTIVATE_IB_PUB.ACTIVATE_IB_INSTANCE
OKL_CONTRACT_STATUS_PUB.UPDATE_CONTRACT_STATUS
OKL_CONTRACT_STATUS_PUB.CASCADE_LEASE_STATUS
61
apps.okc_k_items itm,
fa_additions ast
where lse.id = cle.lse_id
and itm.cle_id = cle.id
and ast.asset_id = itm.object1_id1
and cle.dnz_chr_id = (select khr.id from apps.okc_k_headers_b khr where
khr.contract_number = Contarct Number')
and itm.jtot_object1_code = 'OKX_ASSET';
You should use the following SQL to query the linkage between Install Base and Lease
and Finance Management asset instance:
SELECT lse.lty_code, cle.id, cle.cle_id, itm.object1_id1, itm.jtot_object1_code
FROM apps.okc_k_lines_b cle,
apps.okc_line_styles_b lse,
apps.okc_k_items itm,
csi_item_instances ib
where lse.id = cle.lse_id
and itm.cle_id = cle.id
and ib.instance_id = itm.object1_id1
and cle.dnz_chr_id = (select khr.id from apps.okc_k_headers_b khr where
khr.contract_number = 'Contarct Number')
and itm.jtot_object1_code = 'OKX_IB_ITEM';
11.6.2.4 Performance Considerations
You should consider creating a custom wrapper to use parallel workers or bulk update to
execute the API.
11.6.2.5 Benchmarks
None available.
Lastly, you should update the contract, lines, and payments as Expired.
This process assumes the following:
Tasks (Solution 2)
Description
62
OKL_AM_LEASE_TRMNT_PVT.LEASE_TERMINATION
And then suppress the following procedures call inside the API
API
Description
OKL_AM_LEASE_TRMNT_PVT.VALIDATE_LEASE
OKL_AM_LEASE_TRMNT_PVT.PROCESS_EVERGREEN_
CONTRACT
OKL_AM_LEASE_TRMNT_PVT.PROCESS_CANCEL_INS
URANCE
OKL_AM_LEASE_TRMNT_PVT.PROCESS_CLOSE_BALA
NCES
OKL_AM_LEASE_TRMNT_PVT.PROCESS_ACCOUNTING
_ENTRIES
Tasks (Solution 2)
Table Name
Description
OKL_TRX_ASSETS
OKL_TXD_ASSETS_V
63
OKL_TXL_ASSETS_V
Below is the list of tables for asset return of Lease and Finance Management internal
transactions:
Table Name
Description
OKL_ASSET_RETURNS_B
Tasks (Solution 2)
API
Description
FA_ADDITION_PUB.DO_ADDITION
OKL_OKC_MIGRATION_PVT.UPDATE_CONTRACT_ITEM
OKL_TRX_ASSETS_PUB.CREATE_TRX_ASSET_DEF
OKL_TXL_ASSETS_PUB.CREATE_TXL_ASSET_DEF
OKL_TXD_ASSETS_PUB.CREATE_TXD_ASSET_DEF
OKL_SLA_ACC_SOURCES_PVT.POPULATE_SOURCES
64
OKL_AM_ASSET_DISPOSE_PUB.DISPOSE_ASSET
FA_ADJUSTMENT_PUB.DO_ADJUSTMENT
FA_RETIREMENT_PUB.DO_RETIREMENT
OKL_AM_ASSET_DISPOSE_PVT.EXPIRE_ITEM
CSI_ITEM_INSTANCE_PUB.EXPIRE_ITEM_INSTANCE
11.8 Reconciliation
None identified other than recommendations at the task level.
Task Order
65
Issue
Recommendations
11.9.2 Recommendations
Solution
Recommendations
Note
66
12.1 Objectives
The objective of this phase is to import open and partially paid receivables through the third party
billing import and associate the invoices to your converted lease and loan contracts.
12.2 Overview
You should create receivables in Lease and Finance Management using supported interfaces.
Before the receivables are created, you must have the respective contracts populated in third party
billing interface tables.
You should convert any receivables that are open or partially paid. Partially paid invoices can be
converted with reduced receivable balances.
In the standard billing process, any billing item for a contract is created in the Lease and Finance
Management billing transaction tables first. Lease and Finance Management then processes the
records by using your pre-defined business rules to group them into transactions that will
eventually form an invoice. Once the processing is complete, Lease and Finance Management
creates records in the Oracle Receivables import interface tables. You then use the standard Oracle
Receivables importing program to load the records into Oracle Receivables and create new
invoices.
12.3 Assumptions
You have converted contracts before the respective receivables are imported.
All tasks and activities listed are mandatory unless otherwise specified.
12.4 Tasks
12.4.1 Load Billing Interface
To process a billing item from a third-party company, Oracle Lease and Finance Management can
import billing files containing charges that the customer incurs that you want to pass through, for
example, property taxes, non-sufficient funds fees or service &maintenance charges. After you
import these records, you should review them, correct errors, and download them into Oracle
Lease and Finance Management tables.
You must include third-party billing data in a billing import file.
You may include the following data fields in your data file:
Objectives
67
Customer ID
Customer address
Type of charge
Amount
In addition, you can provide other fields, such as vendor, invoice, and source identifiers.
After contracts are created in Lease and Finance Management, you can bring open receivables
through the Lease and Finance Management billing interface. You populate billing interface tables
with receivable invoice lines and contract references.
12.4.1.1 Interface and Programs Usage
Use the following interface tables to populate receivables details.
Interface Table Name
OKL_EXT_BILLING_INTERFACE
Description
Third party billing interface table
In all rows, set the value of the column TRX_STATUS_CODE to "SUBMITTED". This
will make sure records are picked for processing
12.4.1.2 Custom Build
You can update the contract or asset reference information on each receivable line in the
interface table using a custom script.
12.4.1.3 Reconciliation
You should reconcile the total number of invoice lines and amount with the legacy
receivables details.
12.4.1.4 Performance Considerations
None
12.4.1.5 Benchmarks
Typically, 10000 receivable records take about 25 seconds to load.
68
Description
Process all records from the billing
import interface table to Oracle Lease
and Finance Management transaction
tables
Description
Process the billing transactions from
Lease and Finance Management
internal tables to external tables.
69
12.4.3.3 Reconciliation
Check the concurrent program log file and output files to make sure there are no errors.
12.4.3.4 Performance Considerations
None
12.4.3.5 Benchmarks
Typically, 60,000 assets + 10,000 receivables takes about 15 minutes to process.
Description
Process the consolidation of billing
transactions from Lease and Finance
Management external tables.
Task Order
Flag billed streams and flag accrued streams (can be executed together)
70
12.6 Reconciliation
After the receivables are imported and consolidated, check the consolidated invoice lines to make
sure invoices lines reflect legacy invoice structure.
You should also reconcile after the invoice lines are transferred to Account Receivables against
the legacy open/partial invoices.
Reconciliation
71
13.1 Objectives
To complete the data transfer into Receivables and Payables base tables from the Lease and
Finance Management interface and transaction tables.
13.2 Overview
After you create contracts and process them up to approved status, you must activate and book
the contracts so they can be billed and accrued. Activating or booking contracts creates
transactions and records such as FA asset records and Install Base information.
During the activation process, you must insure that there are no further transactions against the
contracts in your legacy systems unless you plan a process to catch up these transactions after you
convert your identified contracts. As such, this is considered a blackout period and you should
not service the contract in legacy system once you begin this process.
13.3 Assumptions
13.4 Tasks
13.4.1 Activate Contracts
During the contract activation process, the contract status is updated from Approved to Booked
and asset records are created in the Oracle Assets (FA) module. This process also creates
accounting entries for the contract booking. After successful booking, accounting entries are
generated in the sub-ledger and normally transferred into the general ledger (GL). You should
suppress this GL transfer and setup your existing account balances in the GL directly.
13.4.1.1 Active Contract Linkages
The contract activation process is comprised of multiple sub-tasks. The subtasks result in
new records and calls to APIs inform other Oracle modules to create linked records. The
functional steps executed during the contract activation are the following:
Objectives
72
The following is the list of APIs used by the processes described above:
API
Description
OKL_ACTIVATE_ASSET_PUB.ACTIV
ATE_ASSET
OKL_ACTIVATE_IB_PUB.ACTIVATE
_IB_INSTANCE
OKL_INTEREST_CALC_PUB.CALC_I
NTEREST_ACTIVATE
OKL_LA_JE_PVT.GENERATE_JOUR
NAL_ENTRIES
OKL_LA_SALES_TAX_PVT.PROCES
S_SALES_TAX
73
74
75
13.4.4.5 Benchmarks
None available.
Description
Process uses records in the Lease and
Finance Management external billing
tables and creates records in the
Receivables import interface tables
Tasks
76
Description
Process transfers records from the
import interface table to create
invoices in Oracle Receivables
77
13.4.7.5 Benchmarks
Typically a batch of 400 invoices will be updated in 2.0 seconds.
Description
Process retrieves invoice information
from Oracle Receivables for viewing
invoice records from Lease and
Finance Management pages.
Description
Process prepares disbursement records
for Payables import and puts them in
the AP open interface table.
Tasks
78
Description
Processes records in the open
interface tables and creates payable
invoices in Oracle Payables.
79
4) Receivables Invoice Transfer to AR,AR Auto Invoice Master Program,Update Tax Lines
in AR (Optional), Fetch AR Invoice Numbers, Pay Invoices Transfer to AP, Payables
Open Interface Import.
13.6 Reconciliation
None
Reconciliation
80
14.1 Objective
The objective of this phase is to identify the accounts that need to be imported into GL and import
the correct account balances.
14.2 Overview
This phase identifies the DF lease contract accounts necessary for import into GL and the method
for importing the opening account balances into GL.
14.3 Assumptions
The assumptions for this phase are as follows.
The opening balance amounts are as of the conversion date from the legacy system
14.4 Tasks
14.4.1 Create Trial Balance from Legacy System
Prior to importing the account balances, it is important to identify the candidate accounts for
import. This can be achieved by drawing up a trial balance from your legacy system for all Direct
Finance lease contracts being converted as of the conversion date. This step is a manual process
and a custom build item.
Based on the standard transaction accounting as described in the Oracle Lease and Finance
Management whitepaper, [need name], the following example describes sample accounting for a
direct finance lease contract. The example may be used to arrive at a trial balance or you may have
your own standard accounting.
Objective
81
Event
Accounting For
Phase
Module
Debit
Credit
Booking
Unbilled
Receivables
Unearned Income
Residual Value
Asset Cost
Asset Cost
Adjustment
Lease
Unbilled Receivables
Lease Funding
3
3
3
3
Lease
Lease
Assets
Assets
Lease Funding
Residual Value
Asset Cost
Asset Clearing
Unearned Income
Lease Funding
Asset Clearing
Asset Cost
Funding
Asset Funding
Payables
Lease Funding
Liability
Payment
Pay Invoice
NA
Payables
Liability
Bank
Billing
Rent
Receivables
Receivables
Unbilled
Receivables
Receipts
Receive Funds
NA
Receivables
Bank
Receivables
Accrual
Income Recognition
NA
Lease
Unearned Income
Finance Income
Termination
Residual Value
Residual Value
NA
NA
Assets
Lease
Asset Cost
Asset Clearing
Asset Clearing
Residual Value
Sale
Sale of Asset
Receive Funds
Sale of Asset
Retirement of Asset
Retirement of Asset
Gain / Loss on Sale
NA
NA
NA
NA
NA
NA
Receivables
Receivables
Assets
Assets
Assets
Assets
Receivables
Bank
Sale Proceeds
Depreciation Reserve
Sale Proceeds
Receivables
Loss on Sale
Asset Cost
Gain on Sale
Column 1 in the above examples lists the typical business events for DF Lease contracts.
Column 3 in the above table lists the phase number of this document that the business
event is handled in the conversion effort.
Column 4 describes the Oracle Application module that handles the accounting event.
Columns 5 and 6 describe the accounts impacted.
Based on the above example, the accounts necessary for a trial balance can be identified and a trial
balance for the DF lease contracts being converted can be created as of the conversion date.
Trial Balance as on <<conversion date>>
Account
Type
Debit
Unbilled Receivable
B/S
Lease Funding
B/S
Unearned Income
B/S
Residual Value
B/S
Asset Cost
B/S
Asset Clearing
B/S
Liability
B/S
Bank
B/S
Receivables
B/S
Finance Income
P&L
Total
Tasks
Credit
82
Comment
Unbilled Receivables
Unearned Income
Lease Funding
Residual Value
Bank
Finance Income
The accounts for which opening balances need not be imported into General Ledger for the
example provided are listed below.
Account
Comment
Receivables
Liability
Asset Cost
NOTE: Since the Receivables and Liability opening balances are not imported into GL, the trial
balance would be imbalanced. The imbalanced amount should be added to a Suspense Account.
The Suspense Account balance would be closed against the credit side of Receivables and the
Debit side of Liability when the subledger journal entries from AR & AP are posted into General
Ledger.
Tasks
83
Use Application Desktop Integrator (ADI) to create a journal spreadsheet and upload
amounts to the last non-adjusting period previous to the planned live period.
Use SQL*Loader or any other tool of your choice to populate the interface tables
according to the specifications defined in the Oracle General Ledger Users Guide (for
Release 11i). Enter your transactions for the last non-adjusting period previous to the
planned live period.
Description
GL_INTERFACE
For additional information on how, to load initial balances, please refer to the Oracle
General Ledger Users Guide, release 11i. Also refer to the Metalink document How To
Load Initial (Beginning) Balances Into General Ledger - Doc ID: 141069.1.
14.4.3.2 Custom Build
Journal Import receives accounting data from the GL_INTERFACE table. For nonOracle
applications, you must import data from your feeder systems to this table. Your import
program should convert data from your feeder system into a standard data format that
Journal Import can read from the GL_INTERFACE table. Journal Import can then convert
your import data into your General Ledger application journal entries.
14.4.3.3 Reconciliation
Use the Journal Import Execution Report to review the status of all import journal entries.
The Journal Import Execution Report prints a line for each journal entry source from
which you are importing journal entries. If you encounter relatively few Journal Import
errors, you can correct the data in the GL_INTERFACE table. If you encounter several
Journal Import errors, you should delete the Journal Import data from the
GL_INTERFACE table and correct the information in your feeder system before running
Journal Import again. Review the journal entries created by Journal Import before you post
them.
Tasks
84
2.
3.
4.
5.
14.6 Reconciliation
The following methods may be implemented for reconciling this phase.
Task Order
The sum of the receivable transactions imported in phase 5 and interfaced to AR must
equal the Receivable account balance in the trial balance.
The sum of the payable transactions imported in phase 6 and interfaced to AP must equal
the Liability account balance in the trial balance.
Compare the trial balances generated from the legacy system and Oracle General Ledger
for the portfolio of converted contracts.
85
86
15. Risks
Completing a detailed plan and testing sufficiently will help you reduce the overall risk in
your conversion project.
However, some of the areas that may need special attention include:
87
Phase
Task
Interface (import/API/concurrent
program)
Description
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Load
Customers
Load
Customers
RA_CUSTOMER_INTERFACE
RA_CUSTOMER_PROFILES_I
NTERFACE
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Load
Customers
Load
Customers
Load
Customers
Load
Customers
Load
Customers
Load
Customers
Load
Vendors/Suppli
ers
RA_CONTACT_PHONES_INTERF
ACE
RA_CUSTOMER_BANKS_INTERF
ACE
RA_CUST_PAY_METHOD_INTER
FACE
HZ_IMP_PARTIES_INT
HZ_IMP_ADDRESSES_INT
HZ_IMP_CONTACTS_INT
Party Contacts
AP_SUPPLIERS_INT
Phase 2 - Master
Data Load
Load
Vendors/Suppli
ers
AP_SUPPLIER_SITES_INT
Phase 2 - Master
Data Load
Load
Vendors/Suppli
ers
AP_SUP_SITE_CONTACT_INT
Phase 2 - Master
Data Load
Load
Vendors/Suppli
ers
Load
Vendors/Suppli
ers
Load
Vendors/Suppli
AP_PO_VENDORS_APIS_PKG
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
AP_PO_VENDORS_APIS_PKG
AP_PO_VENDORS_APIS_PKG
88
Phase
Phase 2 - Master
Data Load
Task
Interface (import/API/concurrent
program)
ers
Load Items
MTL_SYSTEM_ITEMS_INTERFA
CE
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Load Items
MTL_INTERFACE_ERRORS
Load Items
MTL_ITEM_REVISIONS_INTERF
ACE
Phase 2 - Master
Data Load
Load Master
Lease
Agreements
Phase 2 - Master
Data Load
Load Vendor
Program
Agreements
Load Credit
Lines
Load Credit
Lines
Contract
Import
Contract
Import
Contract
Import
Contract
Import
Contract
Import
Funding
Requests
Funding
Requests
Funding
Requests
Pay Invoice
Prepare for AP
Transfer
Validate
Contract
Generate
Stream
Generate Draft
Journal
Approve
Contract
Activate
Expired
Contracts
(solution1)
OKL_MASTER_LEASE_AGREEM
ENT_PUB.
CREATE_MASTER_LEASE_AGRE
EMENT
OKL_VENDOR_AGREEMENT_PU
B.
CREATE_VENDOR_AGREEMENT
OKL_CREDIT_PUB.CREATE_CRE
DIT
OKL_CREDIT_PUB.ACTIVATE_C
REDIT
OKL_HEADER_INTERFACE
Phase 2 - Master
Data Load
Phase 2 - Master
Data Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 3 - Initial
Load
Phase 4 Book &
Terminate
Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Activate
Expired
Contracts
(solution 2)
Description
AP.
You use the MTL_SYSTEM_ITEMS_INTERFACE table
for new item numbers and all item attributes. This is the
main item interface table, and can be the only table you
choose to use.
This table is used for error tracking of all items that the
Item Interface fails.
If you are importing revision details for new items, you can
use the MTL_ITEM_REVISIONS_INTERFACE table.
This table is used only for revision information, and is not
required.
The Master Lease Agreement API allows users to create
Master Lease Agreements in Lease Management.
OKL_LINES_INTERFACE
OKL_PAYMENTS_INTERFACE
Payments table
OKL_PARTY_ROLES_INTERFAC
E
OKL_TERMS_INTERFACE
Party Roles
OKL_FUNDING_PVT.CREATE_F
UNDING_HEADER
OKL_FUNDING_PVT.CREATE_F
UNDING_LINES
OKL_FUNDING_PVT.UPDATE_F
UNDING_HEADER
PAY INVOICE PREPARE FOR AP
TRANSFER CONCURRENT
PROGRAM
OKL_CONTRACT_BOOK_PUB.V
ALIDATE_CONTRACT
OKL_CONTRACT_BOOK_PUB.G
ENERATE_STREAMS
OKL_CONTRACT_BOOK_PUB.
GENERATE_JOURNAL_ENTRIES
OKL_CONTRACT_BOOK_PUB.
SUBMIT_FOR_APPROVAL
OKL_CONTRACT_BOOK_PUB.A
CTIVARE_CONTRACT
OKL_CONTRACT_STATUS_PUB.
UPDATE_CONTRACT_STATUS
89
Phase
Task
Interface (import/API/concurrent
program)
Description
Activate
Expired
Contracts
(solution 2)
OKL_CONTRACT_STATUS_PUB.
UPDATE_CONTRACT_STATUS
Activate
Expired
Contracts
(solution 2)
OKL_ACTIVATE_ASSET_PUB.AC
TIVATE_ASSET
Activate
Expired
Contracts
(solution 2)
OKL_ACTIVATE_IB_PUB.ACTIV
ATE_IB_INSTANCE
Activate
Expired
Contracts
(solution 2)
OKL_CONTRACT_STATUS_PUB.
UPDATE_CONTRACT_STATUS
Activate
Expired
Contracts
(solution 2)
OKL_CONTRACT_STATUS_PUB.
CASCADE_LEASE_STATUS
Terminate
Expired
Contracts
(Solution 1)
TERMINATE EXPIRED
CONTRACTS CONCURRENT
PROGRAM
Terminate
Expired
Contracts
(solution 2)
OKL_AM_LEASE_TRMNT_PV
T.LEASE_TERMINATION
Terminate
Expired
Contracts
(solution 2)
OKL_AM_LEASE_TRMNT_PV
T.VALIDATE_LEASE
Terminate
Expired
Contracts
(solution 2)
OKL_AM_LEASE_TRMNT_PV
T.PROCESS_EVERGREEN_CO
NTRACT
Terminate
Expired
Contracts
(solution 2)
OKL_AM_LEASE_TRMNT_PV
T.PROCESS_CANCEL_INSUR
ANCE
Terminate
Expired
Contracts
(solution 2)
OKL_AM_LEASE_TRMNT_PV
T.PROCESS_CLOSE_BALANC
90
Phase
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Task
Interface (import/API/concurrent
program)
Description
ES
Terminate
Expired
Contracts
(solution 2)
OKL_AM_LEASE_TRMNT_PV
T.PROCESS_ACCOUNTING_E
NTRIES
Terminate
Expired
Contracts
(solution 2)
FA_ADDITION_PUB.DO_ADD
ITION
Terminate
Expired
Contracts
(solution 2)
OKL_OKC_MIGRATION_PVT.
UPDATE_CONTRACT_ITEM
Terminate
Expired
Contracts
(solution 2)
OKL_TRX_ASSETS_PUB.CRE
ATE_TRX_ASSET_DEF
Terminate
Expired
Contracts
(solution 2)
OKL_TXL_ASSETS_PUB.CRE
ATE_TXL_ASSET_DEF
Terminate
Expired
Contracts
(solution 2)
OKL_TXD_ASSETS_PUB.CRE
ATE_TXD_ASSET_DEF
Terminate
Expired
Contracts
(solution 2)
OKL_SLA_ACC_SOURCES_P
VT.POPULATE_SOURCES
Terminate
Expired
Contracts
(solution 2)
OKL_AM_ASSET_DISPOSE_P
UB.DISPOSE_ASSET
Terminate
Expired
Contracts
(solution 2)
FA_ADJUSTMENT_PUB.DO_A
DJUSTMENT
Terminate
Expired
Contracts
(solution 2)
FA_RETIREMENT_PUB.DO_R
ETIREMENT
91
Phase
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 4 Book &
Terminate Expired
Contracts
(excluding
Evergreen
Contracts)
Phase 5 Load
Open Receivables
Task
Interface (import/API/concurrent
program)
Description
Terminate
Expired
Contracts
(solution 2)
OKL_AM_ASSET_DISPOSE_P
VT.EXPIRE_ITEM
Terminate
Expired
Contracts
(solution 2)
CSI_ITEM_INSTANCE_PUB.E
XPIRE_ITEM_INSTANCE
Load Billing
Interface
OKL_EXT_BILLING_INTERFACE
Lease and
Finance
Management
Billing
Interface
Prepare
Receivable
Bills
Receivable
Bills
Consolidation
Activate
Contracts
OKL_CONTRACT_BOOK_PUB.A
CTIVARE_CONTRACT
Activate
Contracts
Phase 5 Load
Open Receivables
Phase 5 Load
Open Receivables
Phase 5 Load
Open Receivables
Activate
Contracts
OKL_ACTIVATE_ASSET_PUB
.ACTIVATE_ASSET
OKL_ACTIVATE_IB_PUB.ACT
IVATE_IB_INSTANCE
OKL_INTEREST_CALC_PUB.
CALC_INTEREST_ACTIVATE
OKL_LA_JE_PVT.GENERATE
_JOURNAL_ENTRIES
OKL_LA_SALES_TAX_PVT.P
ROCESS_SALES_TAX
Receivables
Invoice
Transfer to AR
AR Auto
Invoice Master
Program
Update Tax
Lines in AR
AR_ADJUST_PUB.
CREATE_ADJUSTMENT
Activate
Contracts
Activate
Contracts
Activate
Contracts
92
Phase
Task
Interface (import/API/concurrent
program)
Description
Update Tax
Lines in AR
AR_ADJUST_PUB.
MODIFY_ADJUSTMENT
Update Tax
Lines in AR
AR_ADJUST_PUB.
REVERSE_ADJUSTMENT
Update Tax
Lines in AR
AR_ADJUST_PUB.
APPROVE_ADJUSTMENT
Fetch AR
Invoice
Numbers
Pay Invoices
Transfer to AP
Invoice
Interface
Payables Open
Interface
Import
Phase 7 Account
Balances Import
Payables
Accounting
Process
Payables
Transfer to GL
Phase 7 Account
Balances Import
Receivables
Transfer to GL
Phase 7 Account
Balances Import
Create
Receipts OnAccount /
Unapplied
Create
Receipts OnAccount /
Unapplied
Create
Receipts OnAccount /
Unapplied
AR_RECEIPT_API_PUB.Create_an
d_Apply
Aging (Active
Contracts Only)
Phase 6 Activation &
Aging (Active
Contracts Only)
Phase 6 Activation &
Aging (Active
Contracts Only)
Phase 6 Activation &
Aging (Active
Contracts Only)
Phase 6 Activation &
Aging (Active
Contracts Only)
Phase 6 Activation &
Aging (Active
Contracts Only)
Phase 6 Activation &
Aging (Active
Contracts Only)
Phase 7 Account
Balances Import
Phase 7 Account
Balances Import
Phase 7 Account
Balances Import
AR_RECEIPT_API_PUB.Create_Ap
ply_On_Acc
AR_RECEIPT_API_PUB.Create_cas
h
93
Seq
PreReq
1.1
Phase
Task
Mandatory
Method
Description
Phase 1
Extract and
Stage Legacy
Data
Yes
Custom
1.2
1.1
Phase 1 Extract
and Stage Legacy
Data
Data Standardization
Yes
Custom
1.3
1.2
Phase 1 Extract
and Stage Legacy
Data
Data Mapping
Yes
Custom
1.4
1.3
Phase 1 Extract
and Stage Legacy
Data
Conversion Download
Program
Yes
Custom
1.5
1.4
Phase 1 Extract
and Stage Legacy
Data
Staging tables
Yes
Custom
1.6
1.5
Phase 1 Extract
and Stage Legacy
Data
Yes
Custom
1.7
1.6
Phase 1 Extract
and Stage Legacy
Data
Yes
Custom
94
Seq
PreReq
Phase
Task
Mandatory
Method
1.8
1.7
Phase 1 Extract
and Stage Legacy
Data
Yes
Custom
1.9
1.8
Phase 1 Extract
and Stage Legacy
Data
Production Table
Yes
Custom
1.10
1.9
Phase 1 Extract
and Stage Legacy
Data
Testing
Yes
Custom
2.1
1.10
Phase 2 - Master
Data Load
Load Customers
Yes
2.2
1.10
Phase 2 - Master
Data Load
Load Vendors/Suppliers
Yes
Receivabl
es
Customer
Interface
or
through
the TCA
Bulk
Import
Process
Supplier
Open
Interface
Import or
through
the
Suppliers
Package
public
APIs
2.3
1.10
Phase 2 - Master
Data Load
Load Items
Yes
Customer
Item and
Customer
Item
Cross
Reference
Interfaces
.
2.4
2.1,
2.2
Phase 2 - Master
Data Load
No
Lease and
Finance
Managem
Description
before validating the data and loading the
application production tables. These
temporary interface tables need to be built
before you run the loader script to populate
these tables. The interface tables may be
standard Oracle Application interface
tables or may be custom interface tables.
There is standard Open Interface programs
and APIs available to validate and load the
records from the interface tables into main
Oracle Applications tables. In case, where
standard Interface programs or APIs are
not available, data will be uploaded
manually or using tools like data loaders,
which performs form level validations.
This is the final production data table
where the converted data resides. These
tables are identified early on when doing
the initial data mapping.
This test plan has been integrated into the
entire conversion process so that, even
during the pre-conversion steps, some type
of validation reports are generated from the
source systems, to be compared later with
the converted data.
The customer data object covers all
information relating to customers, such as
number, name, address, payment terms,
contact details etc. The customer master
record is mandatory to load any contract
and perform billing and collecting activities
for production contracts.
Seq
PreReq
Phase
Task
Mandatory
Method
Description
ent API
2.5
2.1
Phase 2 - Master
Data Load
No
Lease and
Finance
Managem
ent API
2.6
2.1,
2.5
(Opt
iona
l)
Phase 2 - Master
Data Load
No
Lease and
Finance
Managem
ent API
3.1
2.x
Phase 3 - Initial
Load
Contract Import
Yes
Lease and
Finance
Managem
ent
contract
import
interface
3.2
3.1
Phase 3 - Initial
Load
Funding Requests
No
Lease and
Finance
Managem
ent API
96
Seq
PreReq
Phase
Task
Mandatory
Method
3.3
3.2
Phase 3 - Initial
Load
No
Lease and
Finance
Managem
ent
concurren
t program
3.4
3.3
Phase 3 - Initial
Load
Validate Contract
Yes
Lease and
Finance
Managem
ent API
3.5
3.4
Phase 3 - Initial
Load
Generate Stream
Yes
Lease and
Finance
Managem
ent API
3.6
3.5
Phase 3 - Initial
Load
No
Lease and
Finance
Managem
ent API
Description
invoice. The Lease Management
disbursement program pickup these
funding requests and creates payable
invoices.
Performance should be considered when
deciding to bring historical funding
requests.
Approved funding requests and other
approved disbursements are imported
through the Oracle Payables interface to
create payable invoices you can pay to your
suppliers and vendors. The Pay Invoice
Prepare for Invoice Transfer program
picks up Approved funding requests and
creates disbursement records to prepare
them for the Payables import program.
Run this program after you create and
approve funding requests.
After contracts are created in NEW status,
you can validate them. After successful
validation, the contract is updated to
PASSED status. If there are any errors, the
status will be updated as ERROR or
WARNING.
You can submit a contract for validation
from the Lease Management contract
authoring pages or call a private Lease and
Finance Management API to process the
validation.
To improve conversion performance you
should process imported contracts up to the
validation step (status PASSED) unless you
need to update or reconcile a contract in
NEW status.
After contracts are validated, you submit
those contracts for pricing. Pricing
generates streams and yields for each
contract. After pricing is completed, the
contract status is updated to
COMPLETED. For imported contracts,
you can submit a contract for pricing from
the screen or call private Lease and Finance
Management APIs. You should submit the
contract through pricing (contract status
COMPLETED) at the time of import
unless you need to update or reconcile a
contract after validation. If a contract is
updated after validation, the contract status
reverts to INCOMPLETE.
If you want to see draft journal entry
records of the expected booking accounting
before booking the contract, you can
request draft journal entry creation. You do
not need to create or view draft journal
entries in order to book (activate) a
contract. Streams must be completed for a
contract (status COMPLETED) before you
can generate draft journal entries. After
generating draft journal entries, the
contract status remains as COMPLETED.
You can submit a contract for creating
journal entries from the screen or call
private Lease and Finance Management
APIs to process the draft journal entry
97
Seq
PreReq
Phase
Task
Mandatory
Method
3.7
3.6
Phase 3 - Initial
Load
Approve Contract
Yes
Lease and
Finance
Managem
ent API
4.1.
1
3.x
Phase 4 Book
& Terminate
Expired
Contracts
(excluding
Evergreen
Contracts)
Yes
Lease and
Finance
Managem
ent
concurren
t program
4.1.
2
4.1.
1
Yes
Custom
4.1.
3
4.1.
2
Yes
4.1.
4
4.1.
3
Suppress Termination
Accounting Transactions in
Lease and Finance
Management (solution 1)
Yes
Lease and
Finance
Managem
ent
concurren
t program
Custom
4.1.
5
4.1.
4
Yes
Custom
Description
generation.
If you want to review and approve the
contract before activation, you can approve
one contract at a time from the booking
page and initiating the approval workflow
or perform a mass update to change the
contract status to APPROVED using the
approval API. The contract status must be
updated to APPROVED, but execution of
the approval workflow is an optional step.
If the contract passes validation and was
already approved in the legacy system, you
may want to skip the approval workflow
step.
Convert expired contracts contracts with
end date that is less than the conversion
date and not eligible for evergreen from
your legacy system to Lease and Finance
Management using Lease and Finance
Management standard contract import
interface as NEW, PASSED, COMPLETE,
APPROVED, or BOOKED contract status.
The loading of contracts is covered in the
Phase 3 description above.
Once the contract status becomes
Approved, you should call
OKL_CONTRACT_BOOK_PUB.ACTIV
ATE_CONTRACT to activate the expired
contract.
An aged contract is defined as a contract
which has begun its lifecycle on another
leasing system that needs to be imported
into Lease and Finance Management; this
includes all statuses of active and
terminated contracts. In this step, you
update flags on stream elements that have
already been billed and accrued since the
contract is already terminated in legacy
system. This insures that billing and
accrual accounting and transactions will
not be created.
To avoid contract booking accounting
being posted to GL, you should flag the
booking accounting POST_TO_GL column
to N in accounting distribution table.
Run the standard Terminate Expired
Contracts concurrent program to set the
status of contracts to Expired. This step
will create the off-lease amortization
transaction for each asset in Lease and
Finance Management.
During the Lease and Finance Management
Terminate Expired Contracts concurrent
program execution, Termination
accounting transactions will be created in
Lease and Finance Management. In order
to avoid the transactions being posted to
GL, flags the POST_TO_GL column to N
in accounting distribution table.
Once the assets are imported for the
expired contracts and created in Oracle
Assets, the asset cost is adjusted at the
NBV. As a result, the asset cost and
98
Seq
PreReq
Phase
Task
Mandatory
Method
Evergreen
Contracts)
Description
depreciation account opening balances
would be created from the Oracle Assets
module in GL.
4.2.
1
3.1
Yes
Lease and
Finance
Managem
ent
contract
import
interface
4.2.
2
4.2.
1
Yes
Custom
4.2.
3
4.2.
2
Yes
Custom
4.2.
4
4.2.
3
5.1
3.1
5.2
5.1
Yes
Custom
No
Custom
build to
load data
to Lease
and
Finance
Managem
ent
interface
table
Phase 5 Load
Open Receivables
No
Lease and
Finance
Seq
PreReq
Phase
Task
Mandatory
Method
Description
Managem
ent
concurren
t program
5.3
5.2
Phase 5 Load
Open Receivables
No
Lease and
Finance
Managem
ent
concurren
t program
5.4
5.3
Phase 5 Load
Open Receivables
Receivable Bills
Consolidation
No
Lease and
Finance
Managem
ent
concurren
t program
6.1
3.7
Activate Contracts
Yes
Lease and
Finance
Managem
ent API
6.2
6.1
Yes
Custom
6.3
3.5
Yes
Custom
100
Seq
PreReq
Phase
Task
Mandatory
Method
6.4
3.5
Yes
Custom
6.5
5.3
No
Lease and
Finance
Managem
ent
concurren
t program
6.6
6.5
No
AR
concurren
t program
6.7
6.6
No
AR API
6.8
6.7
No
Lease and
Finance
Managem
ent
concurren
t program
Description
This prevents billing the customers again
for past periods.
After contracts are created and streams are
generated, you need to make sure accrued
amounts from legacy systems are not
accrued again in Lease and Finance
Management. All accruals should be
completed for the past accrual periods in
your legacy systems before the conversion
date.
Accrual streams that are dated before the
conversion date should be marked as
accrued.
The records you imported in Phase 5
Load Open Receivables, need to be
imported into Oracle Receivables as
invoices. You should only convert open
receivables to Lease and Finance
Management. If there are partially paid
invoices, you should only convert the open
balances, rather than converting the whole
invoice and creating adjustment receipts.
If you use the process in Phase 5, you
convert the open receivable through Lease
and Finance Management third party
billing interface. This insures the invoices
are associated to the source contracts. If
you choose to bring the open receivable
directly through AR interface, you wont
be able to see the open receivable invoices
in Lease Center (Lease and Finance
Managements customer service module)
for a contract.
For third party billing interface details,
please refer to Phase 5 Load Open
Receivables section.
During this step, you run the Invoice
Transfer to AR, which is a standard Oracle
concurrent program (CP). This CP transfers
Oracle Lease and Finance Management
billing transactions to the Oracle
Receivables import interface.
You cannot complete the import in Phase 5
since you must first activate the associated
contracts before you can run the import
programs.
During this step, you run AR Auto Invoice
Master Program, which is a standard
Oracle concurrent program (CP. This CP
imports the invoices from interface tables
into base receivables invoice tables to
create invoice records.
You may choose to use an external tax
engine rather than the Oracle Tax Engine to
calculate the tax for open receivables
invoices. As such, records on AR tables
can have the tax information adjusted using
the Oracle API AR_ADJUST_PUB.
During this step, you run the Lease and
Finance Management program Fetch AR
Invoice Number, which is a standard
Oracle concurrent program (CP). This CP
retrieves information from Oracle
Receivables for new invoices (i.e.,
101
Seq
PreReq
Phase
Task
Mandatory
Method
6.9
3.2
No
Lease and
Finance
Managem
ent
concurren
t program
6.10
6.9
No
AP
concurren
t program
7.1
6.10
Phase 7 Account
Balances Import
Yes
Custom
7.2
7.1
Phase 7 Account
Balances Import
Yes
Custom
7.3
7.2
Phase 7 Account
Balances Import
Yes
Custom
build to
load data
to GL
interface
table
7.4
7.3
Phase 7 Account
Yes
AP, AR
Description
previously unfetched records) within the
Lease and Finance Management invoice
grouping tables used to consolidate records
for invoice preparation.
During this step, you run the Pay Invoices
Transfer to AP Invoice Interface program,
which is a standard Oracle concurrent
program (CP) - This CP processes
disbursement records in the Lease
Management transaction tables and
prepares them for import to Oracle
Payables by placing them in the AP open
interface table.
During this step, you run the Payables
Open Interface Import program using the
parameter Source set as Oracle Lease
and Finance Management. This standard
Oracle concurrent program (CP) transfers
data from the Payables interface tables to
the AP base tables and creates payable
invoices.
Account balances for Direct Finance lease
contracts need to be imported into Oracle
General Ledger. Prior to importing the
account balances, it is important to identify
the candidate accounts for import. This can
be achieved by drawing up a trial balance
from the legacy system for all Direct
Finance lease contracts being converted as
of the conversion date. This step is a
manual process and a custom build item.
Based on the above trial balance, opening
balances as of the conversion date should
be imported into Oracle General Ledger.
There may also be other accounts not listed
in the above example, for which opening
balances may need to be imported.
Initial balances must be loaded into Oracle
General Ledger (GL). For this purpose, use
Journal Import to import historical data
from your previous accounting system.
You cannot directly update the
GL_BALANCES table. All balance data
coming into General Ledger (GL) must
come through the GL_INTERFACE table.
Oracle Applications provides two methods
for importing initial balances in GL from
legacy systems.
Seq
PreReq
Phase
Task
Balances Import
Journal Entries
Mandatory
Method
Description
concurren
t program
7.5
7.4
Phase 7 Account
Balances Import
Yes
GL
concurren
t program
7.6
7.5
Phase 7 Account
Balances Import
Yes
Custom
103