Professional Documents
Culture Documents
Implementation Guide
11g Release 7 (11.1.7)
Part Number E36898-02
February 2013
Oracle® Fusion Applications Project Financial Management Implementation Guide
Authors: Marilyn Crawford, Gayathri Akkipeddi, Sreya Dutta, Asad Halim, Doug Myers, Tanya Poindexter, Tejaswi
Tatavarthi
Contributors: Tina Brand, Hema Hardikar, Essan Ni Jirman, Mary Kalway, Suzanne Kinkead, Ari Langer, Peggy Larson,
Michael Laverty, P. S. G. V. Sekhar, Barbara Snyder, Rick Stober, Srinivas Vellikad, Megan Wallace, Kathryn Wohnoutka,
Jacqui Wood
This software and related documentation are provided under a license agreement containing restrictions on use and
disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or
allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform,
publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this
software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any
errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the
U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs
installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer
software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such,
use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated
software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license
restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications that may create a risk of
personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all
appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates
disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of
their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under
license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the
AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of
The Open Group.
This software or hardware and documentation may provide access to or information on content, products and services from
third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind
with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for
any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.
Contents
1 Overview
Project Financial Management Offering: Overview .......................................................... 1-1
Define Common Applications Configuration for Project Financial Management:
Overview ...............................................................................................................................1-3
Getting Started with an Implementation: Overview .........................................................1-4
Manage Application Implementation ............................................................................... 1-6
43 Define Project Control Configuration: Manage Financial and Project Plan Types
Financial and Project Plan Types: Explained .................................................................. 43-1
Planning Amounts in Financial Plan Versions: Critical Choices ..................................... 43-2
Summarized Financial Plan Types: Explained ................................................................ 43-3
Manage Financial and Project Plan Types: Set General Planning Options .......................43-3
Manage Financial Plan Types: Set Forecasting Options .................................................. 43-6
Manage Project Plan Types: Set Project Plan Options ..................................................... 43-7
FAQs for Manage Financial and Project Plan Types ....................................................... 43-9
58 External Integration
Web Services: Overview ................................................................................................. 58-1
Files for Import and Export ............................................................................................ 58-2
External Data Integration Services for Oracle Cloud ...................................................... 58-6
You can add custom help files to replace or supplement the provided content.
Each release update includes new help content to ensure you have access to the
latest information. Patching does not affect your custom help content.
• User Guides address the tasks in one or more business processes. They are
intended for users who perform these tasks, and managers looking for an
overview of the business processes. They are organized by the business
process activities and tasks.
• Implementation Guides address the tasks required to set up an offering,
or selected features of an offering. They are intended for implementors.
They are organized to follow the task list sequence of the offerings, as
displayed within the Setup and Maintenance work area provided by
Oracle Fusion Functional Setup Manager.
• Concept Guides explain the key concepts and decisions for a specific
area of functionality. They are intended for decision makers, such as chief
financial officers, financial analysts, and implementation consultants. They
are organized by the logical flow of features and functions.
• Security Reference Manuals describe the predefined data that is included
in the security reference implementation for one offering. They are
intended for implementors, security administrators, and auditors. They are
organized by role.
These guides cover specific business processes and offerings. Common areas are
addressed in the guides listed in the following table.
For guides that are not available from the Guides menu, go to Oracle Technology
Network at http://www.oracle.com/technetwork/indexes/documentation.
Use the My Oracle Support Knowledge Browser to find documents for a product
area. You can search for release-specific information, such as patches, alerts,
white papers, and troubleshooting tips. Other services include health checks,
guided lifecycle advice, and direct contact with industry experts through the My
Oracle Support Community.
Note
The content of Oracle Enterprise Repository reflects the latest release of Oracle
Fusion Applications.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle
Accessibility Program website at http://www.oracle.com/us/corporate/
accessibility/index.html.
Option Feature
Project Financial Management • Enterprise Structures Guided Flow
• Help Customization
• WebCenter Integration
• Project Extensions
• Click To Dial
Burdening Burdening Extensions
Cross-Charge Transactions
Overview 1-1
Cross-Charge Transactions: Borrowed and Lent • Borrowed and Lent Extensions
• Transfer Pricing
• Application Integrations
Project Costing: Allocations Allocation Extensions
Project Costing: Capital Projects • Retirement Processing
• Capital Interest
Next, create one or more implementation projects for the offerings and options
that you want to implement first, which generates task lists for each project. The
application implementation manager can customize the task list and assign and
track each task.
If you select all of the options, the generated task list for this offering contains the
groups of tasks listed in the following table:
You can also customize and extend applications using other tools. For more
information, see the Oracle Fusion Applications Extensibility Guide.
Overview 1-3
Task List Description
Define Synchronization of Users and Roles from Run a process to populate the product tables
LDAP containing user and role information with the users
and roles held in LDAP. This process is always
the first implementation task but can also run
periodically to keep the product tables synchronized
with subsequent updates to LDAP.
Define Implementation Users Create implementation users and roles. Provision
implementation users with job and data roles.
Define Currencies and Currency Rates Define the currencies and currency rates that your
organization does business in.
Define Enterprise Structures for Project Financial Access your enterprise organization, such as legal
Management entities, legal jurisdictions and authorities, and
business units, and specify their use in Oracle
Fusion Project Financial Management. Define the
accounting configuration and chart of accounts that
serve as a framework for how financial records are
maintained for an organization.
Define Social Networking Review options related to social networking and
update as necessary.
Define Security for Project Financial Management Enable users to perform functions related to their job
roles.
Define Automated Governance, Risk, and Define the controls that automate the analysis of
Performance Controls data-related and address-related issues to mitigate
risk and optimize performance of an organization.
Define Approval Management for Project Financial Define approval routing structures and controls to
Management match your organization's needs.
Define Help Configuration Define what users can see and do in a local
deployment of Oracle Fusion Applications Help.
Define Application Toolkit Configuration Set up Oracle Fusion Application Toolkit
features, which are common across Oracle Fusion
applications.
Maintain Common Reference Objects Review and manage common objects, for example
profiles and lookups, that affect the functionality and
look of applications.
Define WebLogic Communication Services Configure WebLogic Communication Services,
Configuration security, and gateways for third-party call control,
session initiation protocol telephony, or soft
switch serving the users within that domain, and
automated dialing.
The figure shows the task flow from provisioning the IT Security Manager job
role with the user and role management entitlement to creating and provisioning
implementation users for enterprise setup.
Overview 1-5
Manage Application Implementation
The Setup and Maintenance work area offers you the following benefits:
Task lists can be easily configured and extended to better fit with business
requirements. Auto-generated, sequential task lists include prerequisites
and address dependencies to give full visibility to end-to-end setup
requirements of Oracle Fusion applications.
• Rapid Start
• Export and import data from one instance to another for rapid setup.
Overview 1-7
Implementation Projects: Explained
Selecting Offerings
When creating an implementation project you see the list of offerings and
options that are configured for implementation. Implementation managers
specify which of those offerings and options to include in an implementation
project. There are no hard and fast rules for how many offerings you should
include in one implementation project. The implementation manager should
decide based on how they plan to manage their implementations. For example,
if you will implement and deploy different offerings at different times, then
having separate implementation projects will make it easier to manage the
implementation life cycles. Furthermore, the more offerings you included in an
implementation project, the bigger the generated task list will be. This is because
the implementation task list includes all setup tasks needed to implement all
included offerings. Alternatively, segmenting into multiple implementation
projects makes the process easier to manage.
Offerings: Explained
Enabling Offerings
Offerings and their options are presented in an expandable and collapsible
hierarchy to facilitate progressive decision making when specifying whether or
not an enterprise plans to implement them. An offering or its options can either
be selected or not be selected for implementation. Implementation managers
decide which offerings to enable.
Provisioning Offerings
The Provisioned column on the Configure Offerings page shows whether or
not an offering is provisioned. While you are not prevented from configuring
offerings that have not been provisioned, ultimately the users are not able to
perform the tasks needed to enter setup data for those offerings until appropriate
enterprise applications (Java EE applications) are provisioned and their location
(end point URLs) is registered.
Options: Explained
Yes or No
If a feature can either be applicable or not be applicable to an implementation, a
single checkbox is presented for selection. Check or uncheck to specify yes or no
respectively.
Overview 1-9
Single Select
If a feature has multiple choices but only one can be applicable to an
implementation, multiple choices are presented as radio buttons. You can turn
on only one of those choices.
Multi-Select
If the feature has multiple choices but one or more can be applicable to an
implementation then all choices are presented with a checkbox. Select all that
apply by checking the appropriate choices.
Note
For security and audit best practice, implementation users have person records
and appropriate role-based security access. So that appropriate roles can be
assigned to implementation users, you must run the process Retrieve Latest
LDAP Changes before you create implementation users.
During initial implementation, the installation super user performs the task Run
User and Role Synchronization Process to run the Retrieve Latest LDAP Changes
process.
Tip
The user name and password of the installation super user are created during
installation provisioning of Oracle Fusion Applications. For details of the user
name and password, contact your system administrator or the person who
installed Oracle Fusion Applications.
Common Applications Configuration: Define Synchronization of Users and Roles from LDAP 2-1
2-2 Oracle Fusion Applications Project Financial Management Implementation Guide
3
Common Applications Configuration:
Define Implementation Users
Initially the super user is not provisioned to manage users and roles.
You must add the following Oracle Identity Management (OIM) roles to the IT
Security Manager job role's role hierarchy to enable the super user to create one
or more initial implementation users.
• Identity User Administrators
• Role Administrators
Additionally, you must assign the Xellerate Users organization to the IT Security
Manager role.
After configuring an offering and setting up the task lists for implementation, the
Run User and Roles Synchronization Process task is available to the super user
for synchronizing users and roles in the LDAP store with Oracle Fusion Human
Capital Management (HCM).
The super user is provisioned with roles that provide broad access to Oracle
Fusion Middleware and Oracle Fusion Applications administration, and is
not suitable as an implementation user in most enterprises. The super user
should define at least one implementation user, which consists of creating the
user account and provisioning it with at least the Application Implementation
Consultant and Application Implementation Manager job roles.
Depending on the size of your implementation team, you may only need a
single implementation user for security administration, implementation project
management, enterprise structures setup, and application implementation. That
single user must then be provisioned with all indicated roles, and therefore
broad access.
Note
After creating an implementation user, you must provision the user with one or
more roles by performing the Provision Roles to Implementation Users task.
Caution
This example illustrates initial security administration after having installed and
provisioned an Oracle Fusion Applications environment.
In Oracle Fusion Applications, you manage users and security through Oracle
Fusion Human Capital Management (HCM) user management flows, which
are included in each of the offering task lists. However, the HCM task flows
require that enterprise structures have been set up, and yet to add users who
can set up enterprise structures you need to have set up HCM. Therefore, you
need to create one or more initial implementation users who are responsible for
providing the following.
Note
The following tasks assume that the super user has configured an offering and
set up task lists. When not following a task flow within an activity, you can find
tasks in Navigator > Tools > Setup and Maintenance > All Tasks . Search for
the task and click its Go to Task icon in the search results.
Click the arrow icon to show the list of available roles. Select IT Security
Manager and move it to the Roles to Add list. Click Save.
5. Search for the Role Administrators role, and repeat steps 1 to 4 to add that
role to the IT Security Manager role's role inheritance.
6. Assign the IT Security Manager role to the Xellerate Users organization.
a. In the Welcome to Identity Manager Delegated Administration menu
(see step 1, above), in the Organizations list of tasks, click Advanced
Search - Organizations.
b. Search for the Xellerate Users organization by entering Xellerate Users
in Display Name and clicking Search.
c. In the Search Results, click the organization's Display Name. The
Xellerate Users page appears.
d. Click the Administrative Roles link in the row of links above the
Xellerate Users.
e. In Filter By Role Name of the Details window, enter the following
string:
*IT_SECURITY_MANAGER*
Click Find.
f. Enable Read, Write, Delete, and Assign.
g. Click Assign.
h. Click Confirm.
1. Sign in to Oracle Fusion Applications using the super user's user name
(for example FAADMIN) and password.
If you do not know the super user name and password, check with
your system administrator or the person who installed Oracle Fusion
Applications. For more information about account creation in Oracle
Fusion Applications provisioning, see the Oracle Fusion Applications
Installation Guide.
2. Perform the Run User and Roles Synchronization Process task by clicking
Submit in the Process Details page.
The Retrieve Latest LDAP Changes process takes some time to complete
the first time it is run.
Note
In Oracle Fusion Applications, an implementation user is a user account
created in OIM only, specifically for implementation tasks, and is not
related to a real person or identity such as a user defined in HCM.
4. Click Save.
5. On the Roles tab in the IT_SECURITY_MANAGER user creation task
flow, click Assign.
6. In the Add Role window, search for the IT Security Manager role and click
Add.
Note
Manage Currencies
Currency Codes
You cannot change a currency code after you enable the currency, even if you
later disable that currency.
Date Ranges
Users can enter transactions denominated in the currency only for the dates
within the specified range. If you do not enter a start date, then the currency is
valid immediately. If you do not enter an end date, then the currency is valid
indefinitely.
Symbols
Even if you enter a symbol for a currency, the symbol is not always displayed
when an amount is displayed in this currency. Some applications use currency
symbols when displaying amounts. Others, like Oracle Fusion General Ledger,
do not.
Note
If you need to use a different currency code for Euro, you can disable the
predefined Euro currency and create a new one.
Derivation Type
The Euro currency derivation type is used only for the Euro, and the Euro
derived derivation type identifies national currencies of EMU member states. All
other currencies do not have derivation types.
Derivation Factor
The derivation factor is the fixed conversion rate by which you multiply one
Euro to derive the equivalent EMU currency amount. The Euro currency itself
should not have a derivation factor.
The derivation effective date is the date on which the relationship between the
EMU currency and the Euro begins.
Create currencies to use, for example for reporting purposes, if they are not
already provided. All currencies from the International Organization for
Standardization (ISO) 4217 standard are provided.
Enable any currency other than USD for use in Oracle Fusion Applications, for
example for displaying monetary amounts, assigning to sets of books, entering
transactions, and recording balances. Only USD is enabled by default.
Precision is the number of digits to the right of the decimal point used in regular
currency transactions. Extended precision is the number of digits to the right
of the decimal point used in calculations for this currency, and it must be
greater than or equal to the standard precision. For example, USD would have
2 for precision because amounts are transacted as such, for example $1.00. For
calculations, for example adding USD amounts, you might want the application
to be more precise than two decimal digits, and would enter an extended
precision accordingly.
Some applications use extended precision. Others, such as Oracle Fusion General
Ledger, do not.
Minimum accountable unit is the smallest denomination for the currency. For
example, for USD that would be .01 for the cent. This unit does not necessarily
correspond to the precision for all currencies.
The statistical unit currency type is used only for the Statistical (STAT) currency.
The Statistical currency is used to record statistics such as the number of items
bought and sold. Statistical balances can be used directly in financial reports,
allocation formulas, and other calculations.
Maintain different conversion rates between currencies for the same period
with the Oracle Fusion General Ledger conversion rate types functionality. Four
predefined daily conversion rate types are seeded: Spot, Corporate, User, and
Fixed, allowing you to use different rate types for different business needs.
During journal entry, the conversion rate is provided automatically by the
General Ledger based on the selected conversion rate type and currency, unless
the rate type is user. For user rate types, you must enter the conversion rate.
Define additional rate types as needed. Set your most frequently used rate type
as the default. Conversion rate types cannot be deleted.
Assign conversion rate types to automatically populate the associated rate for
your period average and period end rates for the ledger. For example, you can
assign the predefined rate type Spot to populate your period average rates and
the predefined rate type Corporate to populate your period end rates. Period
average and period end rates are used in translation of account balances.
Conversion rate types are used to automatically assign a rate when you perform
the following accounting functions:
Check the Enforce Inverse Relationship check box to specify whether or not to
enforce the automatic calculation of inverse conversion rates when defining daily
rates.
Action Results
Checked When you enter a daily rate to convert currency A to
currency B, General Ledger automatically calculates
the inverse rate, currency B to A, and enters it in
the adjacent column. If either rate is changed, the
application automatically recalculates the other rate.
If you want the application to create cross rates against a base currency, define
the base currency as the pivot currency. Selected pivot currencies can be changed
in the Rate Types page.
Select currencies available on the list of values as contra currencies. The available
currencies are those currencies which are enabled, effective, not STAT currency,
and not the pivot currency selected earlier. The description of the contra currency
is populated automatically based on the currency definition. Add or delete
contra currencies in the Contra Currencies region of the Rate Types page.
Check the Enable Cross Rates check box to calculate conversion rates based
on defined currency rate relationships. General Ledger calculates cross rates
based on your defined cross rate rules. Associate your cross rate rules with a
conversion rate type, pivot currency, and contra currencies. Cross rates facilitate
the creation of daily rates by automatically creating the rates between contra
currencies based on their relationship to a pivot currency. If the Enable Cross
Rates check box is changed to unchecked after entering contra currencies,
the application stops calculating cross rates going forward for that particular
rate type. All the earlier calculated cross rates for that rate type remain in the
database unless you manually delete them.
For example, if you have daily rates defined for the pivot currency, USD to the
contra currency, EUR, and USD to another contra currency, CAD, the application
will automatically create the rates between EUR to CAD and CAD to EUR. This
prevents the need to manually define the EUR to CAD and CAD to EUR rates.
Check the Allow Cross Rates Override check box to permit your users
to override application generated cross rates. If you accept the default of
unchecked, the application generated cross rates cannot be overridden
Define or update your cross rate rules at any time by adding or removing
contra currency assignments. Add a contra currency to a cross rate rule and run
the Daily Rates Import and Calculation process to generate the new rates. If
your remove a cross rate rule or a contra currency from a rule, any cross rates
generated previously for that contra currency remain unless you manually delete
them. Changes to the rule are not retroactive and will not affect previously stored
cross rates. The Cross Rate process generates as many rates as possible and skips
currencies where one component of the set is missing.
Note
With a defined web service that extracts daily currency conversion rates
from external services, for example Reuters, currency conversion rates are
automatically updated for the daily rates and all cross currency relationships.
There are four seeded conversion rate types in Oracle Fusion applications:
• Spot
• Corporate
• User
Scenario
You are the general ledger accountant for InFusion America Inc. You are entering
a journal entry to capture three transactions that were transacted in three
different foreign currencies:
You enter two lines with accounts and amounts for each foreign currency
transaction. Based on your company procedures, you select the appropriate rate
type to populate the rate for Corporate and Spot rate types from your daily rates
table. You manually enter the current rate for the User rate type.
Note
Your company does not currently use the Fixed rate type. From January 1, 1999,
the conversion rate of the French franc (FRF) against the euro currency (EUR)
was set at a fixed rate of 1 EUR to 6.55957 FRF. Your French operations were
started in 2007, so you maintain all your French business records in the EUR.
What's the difference between spot, corporate, user, and fixed rate types?
Spot, corporate, user, and fixed conversion rate types differ based on the
fluctuations of your entered foreign currency and your company procedures for
maintaining daily rates.
If you have infrequent foreign currency transactions, the user rate type can
simplify your currency maintenance while providing an accurate conversion rate
on the date of the transaction.
Use the Period Close work area to link to close processes and currency
process.
2. Click the Manage Currency Rates link.
Use the Currency Rates Manager page to create, edit, and review currency
rate types, daily rates, and historical rates.
3. Click the Daily Rates tab.
Use the Daily Rates tab to review and enter currency rates.
4. Click the Create in Spreadsheet button.
Use the Create Daily Rates spreadsheet to enter daily rates in a template
that you can save and reuse.
5. Click in the From Currency field. Select the GBP - Pound Sterling list item.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-1
Legal Structure
The figure above shows a typical group of legal entities, operating various
business and functional organizations. Your ability to buy and sell, own, and
employ comes from your charter in the legal system. A corporation is a distinct
legal entity from its owners and managers. The corporation is owned by its
shareholders, who may be individuals or other corporations. There are many
other kinds of legal entities, such as sole proprietorships, partnerships, and
government agencies.
A legally recognized entity can own and trade assets and employ people in the
jurisdiction in which it is registered. When granted these privileges, legal entities
are also assigned responsibilities to:
• Account for themselves to the public through statutory and external
reporting
• Comply with legislation and regulations
• Pay income and transaction taxes
• Process value added tax (VAT) collection on behalf of the taxing authority
Many large enterprises isolate risk and optimize taxes by incorporating
subsidiaries. They create legal entities to facilitate legal compliance, segregate
operations, optimize taxes, complete contractual relationships, and isolate risk.
Enterprises use legal entities to establish their enterprise's identity under the
laws of each country in which their enterprise operates.
In the figure above, a separate card represents a series of registered companies.
Each company, including the public holding company, InFusion America, must
be registered in the countries where they do business. Each company consists
of various divisions created for purposes of management reporting. These are
shown as vertical columns on each card. For example, a group might have a
separate company for each business in the United States (US), but have their
United Kingdom (UK) legal entity represent all businesses in that country. The
divisions are linked across the cards so that a business can appear on some or
all of the cards. For example, the air quality monitoring systems business might
be operated by the US, UK, and France companies. The list of business divisions
is on the Business Axis. Each company's card is also horizontally striped by
functional groups, such as the sales team and the finance team. This functional
list is called the Functional Axis. The overall image suggests that information
might, at a minimum, be tracked by company, business, division, and function
in a group environment. In Oracle Fusion Applications, the legal structure is
implemented using legal entities.
Management Structure
Successfully managing multiple businesses requires that you segregate them
by their strategic objectives, and measure their results. Although related to
your legal structure, the business organizational hierarchies do not need to
be reflected directly in the legal structure of the enterprise. The management
structure can include divisions, subdivisions, lines of business, strategic business
units, and cost centers. In the figure above, the management structure is shown
on the Business Axis. In Oracle Fusion Applications, the management structure
is implemented using divisions and business units.
Functional Structure
Straddling the legal and business organizations is a functional organization
structured around people and their competencies. For example, sales,
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-3
BPM Activities Description
Define Enterprise Define the enterprise to capture the name of
the deploying enterprise and the location of the
headquarters. There is normally a single enterprise
organization in a production environment. Multiple
enterprises are defined when the system is used
to administer multiple customer companies, or
when you choose to set up additional enterprises for
testing or development.
Define Enterprise Structures Define enterprise structures to represent an
organization with one or more legal entities under
common control. Define internal and external
organizations to represent each area of business
within the enterprise.
Define Legal Jurisdictions and Authorities Define information for governing bodies that
operate within a jurisdiction.
Define Legal Entities Define legal entities and legal reporting units for
business activities handled by the Oracle Fusion
Applications.
Define Business Units Define business units of an enterprise to allow for
flexible implementation, to provide a consistent
entity for controlling and reporting on transactions,
and to be an anchor for the sharing of sets of
reference data across applications.
Define Financial Reporting Structures Define financial reporting structures, including
organization structures, charts of accounts,
organizational hierarchies, calendars, currencies and
rates, ledgers, and document sequences which are
used in organizing the financial data of a company.
Define Chart of Accounts Define chart of accounts including hierarchies and
values to enable tracking of financial transactions
and reporting at legal entity, cost center, account, and
other segment levels.
Define Ledgers Define the primary accounting ledger and any
secondary ledgers that provide an alternative
accounting representation of the financial data.
Define Accounting Configurations Define the accounting configuration that serves as a
framework for how financial records are maintained
for an organization.
Define Facilities Define inventory, item, and cost organizations.
Inventory organizations represent facilities that
manufacture or store items. The item master
organization holds a single definition of items that
can be shared across many inventory organizations.
Cost organizations group inventory organizations
within a legal entity to establish the cost accounting
policies.
Define Reference Data Sharing Define how reference data in the applications is
partitioned and shared.
Note
There are product specific implementation activities that are not listed here
and depend on the applications you are implementing. For example, you can
• Enterprise Configuration
• Security Structure
• Compliance Requirements
Enterprise Configuration
What reporting do I need by business unit? How can you set up your
departments or business unit accounts to achieve departmental hierarchies that
report accurately on your lines of business? What reporting do you need to
support the managers of your business units, and the executives who measure
them? How often are business unit results aggregated? What level of reporting
detail is required across business units?
Security Structure
What level of security and access is allowed? Are business unit managers
and the people that report to them secured to transactions within their own
business unit? Are the transactions for their business unit largely performed by a
corporate department or shared service center?
Compliance Requirements
How do you comply with your corporate external reporting requirements and
local statutory reporting requirements? Do you tend to prefer a corporate first or
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-5
an autonomous local approach? Where are you on a spectrum of centralization,
very centralized or decentralized?
This example uses a fictitious global company to demonstrate the analysis that
can occur during the enterprise structure configuration planning process.
Scenario
Your company, InFusion Corporation, is a multinational conglomerate that
operates in the United States (US) and the United Kingdom (UK). InFusion
has purchased an Oracle Fusion enterprise resource planning (ERP) solution
including Oracle Fusion General Ledger and all of the Oracle Fusion subledgers.
You are chairing a committee to discuss creation of a model for your global
enterprise structure including both your US and UK operations.
InFusion Corporation
InFusion Corporation has 400 plus employees and revenue of $120 million.
Your product line includes all the components to build and maintain air quality
monitoring (AQM) systems for homes and businesses. You have two distribution
centers and three warehouses that share a common item master in the US and
UK. Your financial services organization provides funding to your customers for
the start up costs of these systems.
Analysis
The following are elements you need to consider in creating your model for your
global enterprise structure.
• Your managers need reports that show profit and loss (revenue and
expenses) for their lines of business. Do you use business units and
balancing segments to represent your divisions and businesses? Do you
secure data by two segments in your chart of accounts which represents
each department and legal entity or one segment that represents both to
produce useful, but confidential management reports?
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-7
In this chart, the green globe stands for mandatory and gold globe stands for
optional setup. The following statements expand on the data in the chart.
• The enterprise is mandatory because it serves as an umbrella for the entire
implementation. All organizations are created within an enterprise.
• Legal entities are also mandatory. They can be optionally mapped to
balancing segment values or represented by ledgers. Mapping balancing
segment values to legal entities is mandatory if you plan to use the
intercompany functionality.
• At least one ledger is mandatory in an implementation in which you
record your accounting transactions.
• Business units are also mandatory because financial transactions are
processed in business units.
• A shared service center is optional, but if used, must be a business unit.
• Divisions are optional and can be represented with a hierarchy of cost
centers or by a second balancing segment value.
• Departments are mandatory because they track your employees.
• Optionally, add an item master organization and inventory organizations
if you are tracking your inventory transactions in Oracle Fusion
Applications.
Note
Some Oracle Fusion Human Capital Management and Customer Relationship
Management implementations do not require recording of accounting
transactions and therefore, do not require implementation of a ledger.
Note
The InFusion Corporation is a legal entity but is not discussed in this example.
Even when case sensitivity is enabled in an aggregate storage outline for which
duplicate member names is enabled, do not use matching names with only case
differences for a dimension name. For example, do not:
• Name two dimensions Product and product.
• Use quotation marks or brackets.
• Use tabs in dimension, member, or alias names.
• Use accent characters.
• Use the characters for dimension or member names.
Restricted Characters
The following is a list of characters that are restricted and can not be used in
dimension, member, or alias names.
Character Meaning
@ at sign
\ backslash
, comma
- dash, hyphen, or minus sign
= equal sign
< less than sign
() parentheses
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-9
. period
+ plus sign
' single quotation mark
_ underscore
| vertical bar
Other Restrictions
• Do not place spaces at the beginning or end of names. Essbase ignores
such spaces.
To be able to use the Enterprise Structures Configurator, you must select the
Enterprise Structures Guided Flow feature for your offerings on the Configure
Offerings page in the Setup and Maintenance work area. If you do not select
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-11
this feature, then you must set up your enterprise structure using individual
tasks provided elsewhere in the offerings, and you cannot create multiple
configurations to compare different scenarios.
Review Configuration
Finally, you can review a summary of the results of the two interview processes.
For each configuration, the online summary lists the divisions, legal entities,
business units, reference data sets, and job and position structures that the
application will create when you load the configuration.
For a more detailed analysis of a configuration, you can access the Technical
Summary Report. This report lists the same information as the online summary,
but also lists the following information that will be created by the application
when you load the configuration, based on your configuration:
• Legislative data groups (the application creates one legislative data group
for each country that is identified in the configuration.)
• Name of the legislative data group that will be assigned to the payroll
statutory unit that is generated for each legal entity.
• Organization hierarchy.
The Technical Summary report also lists the default settings that will be
loaded for these fields, which you access from the Manage Enterprise HCM
Information task: Worker Number Generation, Employment Model and Allow
Employment Terms Override. You can print the Technical Summary Report for
each of your configurations and compare each scenario.
Note
If your PDF viewer preferences are set to open PDFs in a browser window, the
Technical Summary report replaces the Oracle Fusion application. Use your
browser's Back button to return to the application.
Manual Rollback
Use the manual method for rolling back an enterprise configuration when you
have loaded a configuration, but then decide you do not want to use it.
Automatic Rollback
The automatic rollback is used when you run the Load Configuration process,
but the process encounters an error. In this case, the application rolls back any
enterprise structures that were created before the error was encountered.
Scenario
InFusion Corporation is a multinational enterprise in the high technology
industry with product lines that include all the components that are required
to build and maintain air quality monitoring (AQM) systems for homes and
businesses. Its primary locations are in the US and the UK, but it has smaller
outlets in France, Saudi Arabia, and the United Arab Emirates (UAE).
Enterprise Details
In the US, InFusion employs 400 people and has a company revenue of $120
million. Outside the US, InFusion employs 200 people and has revenue of $60
million.
Analysis
InFusion requires three divisions. The US division will cover the US locations.
The Europe division will cover the UK and France. Saudi Arabia and the UAE
will be covered by the Middle East division.
InFusion requires legal entities with legal employers, payroll statutory units, tax
reporting units, and legislative data groups for the US, UK, France, Saudi Arabia,
and UAE, in order to employ and pay its workers in those countries.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-13
InFusion requires a number of departments across the enterprise for each area of
business, such as sales and marketing, and a number of cost centers to track and
report on the costs of those departments.
InFusion requires business units for human capital management (HCM)
purposes. Infusion has general managers responsible for business units within
each country. Those business units may share reference data. Some reference
data can be defined within a reference data set that multiple business units may
subscribe to. Business units are also required for financial purposes. Financial
transactions are always processed within a business unit.
Based on this analysis, InFusion requires an enterprise with multiple divisions,
ledgers, legal employers, payroll statutory units, tax reporting units, legislative
data groups, departments, cost centers, and business units.
This figure illustrates the enterprise configuration that results from the analysis
of InFusion Corporation.
Division: Explained
Managing multiple businesses requires that you segregate them by their strategic
objectives and measure their results. Responsibility to reach objectives can be
delegated along the management structure. Although related to your legal
structure, the business organizational hierarchies do not need to reflect directly
Divisions
A division refers to a business oriented subdivision within an enterprise, in
which each division organizes itself differently to deliver products and services
or address different markets. A division can operate in one or more countries,
and can be comprised of many companies or parts of different companies that
are represented by business units.
A division is a profit center or grouping of profit and cost centers, where the
division manager is responsible for attaining business goals including profit
goals. A division can be responsible for a share of the company's existing
product lines or for a separate business. Managers of divisions may also have
return on investment goals requiring tracking of the assets and liabilities of the
division. The division manager reports to a top corporate executive.
By definition a division can be represented in the chart of accounts. Companies
may choose to represent product lines, brands, or geographies as their divisions:
their choice represents the primary organizing principle of the enterprise. This
may coincide with the management segment used in segment reporting.
Oracle Fusion Applications supports a qualified management segment and
recommends that you use this segment to represent your hierarchy of business
units and divisions. If managers of divisions have return on investment goals,
make the management segment a balancing segment. Oracle Fusion applications
allows up to three balancing segments. The values of the management segment
can be comprised of business units that roll up in a hierarchy to report by
division.
Historically, divisions were implemented as a node in a hierarchy of segment
values. For example, Oracle E-Business Suite has only one balancing segment,
and often the division and legal entity are combined into a single segment where
each value stands for both division and legal entity.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-15
A legal entity has responsibility for elements of your enterprise for the following
reasons:
• Facilitating local compliance
• Taking advantage of lower corporation taxation in some jurisdictions
• Preparing for acquisitions or disposals of parts of the enterprise
• Isolating one area of the business from risks in another area. For example,
your enterprise develops property and also leases properties. You could
operate the property development business as a separate legal entity to
limit risk to your leasing business.
If you are not certain of the number of legal entities that you need, you can create
them automatically. To use this option, you first identify all of the countries in
which your enterprise operates. The application opens the Map Divisions by
Country page, which contains a matrix of the countries that you identified, your
enterprise, and the divisions that you created. You select the check boxes where
your enterprise and divisions intersect with the countries to identify the legal
entities that you want the application to create. The enterprise is included for
situations where your enterprise operates in a country and acts on behalf of
several divisions within the enterprise and is a legal employer in a country. If
you select the enterprise for a country, the application creates a country holding
company.
The application automatically creates the legal entities that you select, and
identifies them as payroll statutory units and legal employers. For each country
that you indicated that your enterprise operates in, and for each country that you
created a location for, the application also automatically creates a legislative data
group.
Any legal entities that you create automatically cannot be deleted from the
Create Legal Entities page within the Enterprise Structures Configurator. You
must return to the Map Divisions by Country page and deselect the legal entities
that you no longer want.
This table represents the selections that InFusion Corporation makes when
specifying which legal entities to create on the Map Divisions by Country page.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-17
Based on the selections made in the preceding table, the ESC creates the
following four legal entities:
• InFusion Lighting Japan LE
• InFusion Lighting US LE
• InFusion Security UK LE
• InFusion Security India LE
If you have a list of legal entities already defined for your enterprise, you can
upload them from a spreadsheet. To use this option, you first download a
spreadsheet template, then add your legal entity information to the spreadsheet,
and then upload directly to your enterprise configuration. You can export and
import the spreadsheet multiple times to accommodate revisions.
All of the assets of the enterprise are owned by individual legal entities. Oracle
Fusion Financials allow your users to enter legal entities on transactions that
represent a movement in value or obligation.
In some cases, your legal entity is inferred from your business unit that is
processing the transaction. For example, your business unit A agrees on
terms for the transfer of inventory to your business unit B. This transaction is
binding on your default legal entities assigned to each business unit. Oracle
Fusion Procurement, Oracle Fusion Projects, and Oracle Fusion Supply Chain
applications rely on deriving the legal entity information from the business unit.
One of your major responsibilities is to file financial statements for your legal
entities. Map legal entities to specific ledgers using the Oracle Fusion General
Ledger Accounting Configuration Manager. Within a ledger, you can optionally
map a legal entity to one or more balancing segment values.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-19
1. Identify the legal entities within the ledger.
2. Balance transactions that cross legal entity boundaries through
intercompany transactions.
3. Decide which balancing segments correspond to each legal entity and
assign them in Oracle Fusion General Ledger Accounting Configuration
Manager. Once you assign one balancing segment value in a ledger, then
all your balancing segment values must be assigned. This recommended
best practice facilitates reporting on assets, liabilities, and income by legal
entity.
Represent your legal entities by at least one balancing segment value. You may
represent it by two or three balancing segment values if more granular reporting
is required. For example, if your legal entity operates in multiple jurisdictions
in Europe, you might define balancing segment values and map them to legal
reporting units. You can represent a legal entity by more than one balancing
segment value, do not use a single balancing segment value to represent more
than one legal entity.
In Oracle Fusion General Ledger, there are three balancing segments. You can
use separate balancing segments to represent your divisions or strategic business
units to enable management reporting at the balance sheet level for each division
or business unit. For example, use this solution to empower your business
unit and divisional managers to track and assume responsibility for their asset
utilization or return on investment. Using multiple balancing segments is also
useful when you know at the time of implementation that you are disposing of a
part of a legal entity and need to isolate the assets and liabilities for that entity.
Note
To use this feature for disposal of a part of a legal entity, implement multiple
balancing segments at the beginning of the legal entity's corporate life or on
conversion to Oracle Fusion.
If you decided to account for each legal entity in a separate ledger, there is no
requirement to identify the legal entity with a balancing segment value within
the ledger.
Note
While transactions that cross balancing segments don't necessarily cross legal
entity boundaries, all transactions that cross legal entity boundaries must cross
balancing segments. If you make an acquisition or are preparing to dispose
of a portion of your enterprise, you may want to account for that part of the
enterprise in its own balancing segment even if it is not a separate legal entity.
If you do not map legal entities sharing the same ledger to balancing segments,
you will not be able to distinguish them using the intercompany functionality or
track their individual equity.
In Oracle Fusion Applications you can map legal entities to balancing segments
and then define consolidation rules using your balancing segments. You are
creating a relationship between the definition of your legal entities and their role
in your consolidation.
Note
In the Oracle Fusion Supply Chain applications, model intercompany
relationships using business units, from which legal entities are inferred.
Legal Entity and Its Relationship to Worker Assignments and Legal Employer
Legal entities that employ people are called legal employers in the Oracle
Fusion Legal Entity Configurator. You must enter legal employers on worker
assignments in Oracle Fusion HCM.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-21
process transactions on behalf of many legal entities. Normally, it will have a
manager, strategic objectives, a level of autonomy, and responsibility for its profit
and loss. Roll business units up into divisions if you structure your chart of
accounts with this type of hierarchy. In Oracle Fusion Applications, you assign
your business units to one primary ledger. For example, if a business unit is
processing payables invoices they will need to post to a particular ledger. This
assignment is mandatory for your business units with business functions that
produce financial transactions.
In Oracle Fusion Applications, use business unit as a securing mechanism for
transactions. For example, if you run your export business separately from your
domestic sales business, secure the export business data to prevent access by the
domestic sales employees. To accomplish this security, set up the export business
and domestic sales business as two separate business units.
The Oracle Fusion Applications business unit model:
• Allows for flexible implementation
• Provides a consistent entity for controlling and reporting on transactions
• Anchors the sharing of sets of reference data across applications
Business units process transactions using reference data sets that reflect your
business rules and policies and can differ from country to country. With Oracle
Fusion Application functionality, you can choose to share reference data, such as
payment terms and transaction types, across business units, or you can choose to
have each business unit manage its own set depending on the level at which you
wish to enforce common policies.
In countries where gapless and chronological sequencing of documents is
required for subledger transactions, define your business units in alignment with
your ledger definition, because the uniqueness of sequencing is only ensured
within a ledger. In these cases, define a single ledger and assign one legal entity
and business unit.
In summary, use business units in the following ways:
• Management reporting
• Processing of transactions
• Security of transactional data
• Reference data definition and sharing
To create business units automatically, you must specify the level at which to
create business units. Business units within your enterprise may be represented
at the business function level, such as Sales, Consulting, Product Development,
and so on, or they may be represented at a more detailed level, where a business
unit exists for each combination of countries in which you operate and the
functions in those countries.
You can automatically create business units at the following levels:
• Country
• Country and Division
• Country and business function
• Division
• Division and legal entity
• Division and business function
• Business function
• Legal entity
• Business function and legal entity
Select the option that best meets your business requirements, but consider the
following:
• If you use Oracle Fusion Financials, the legal entity option is
recommended because of the manner in which financial transactions are
processed.
• The business unit level that you select determines how the application
automatically creates reference data sets.
After you select a business unit level, the application generates a list of business
units, and you select the ones you want the application to create. If you select a
level that has two components, such as country and division, then the system
displays a table listing both components, and you select the check boxes at the
intersections of the components.
The business units listed by the application are suggestions only, and are meant
to simplify the process to create business units. You are not required to select all
of the business units suggested. When you navigate to the next page in the ESC
guided flow, which is the Manage Business Units page, you cannot delete any of
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-23
the business units that were created automatically. You must return to the Create
Business Units page and deselect any business units that you no longer want.
Example: Selecting Business Unit Levels
InFusion Corporation is using the Enterprise Structures Configurator to set up
their enterprise structure. They have identified two divisions, one for Lighting,
and one for Security. They operate in four countries: US, UK, Japan, and India,
and they have created a legal entity for each of the countries. The sales and
marketing functions are based in both India and Japan, while the US and the UK
have only the sales function.
This figure illustrates InFusion Corporation's enterprise structure.
The following table lists the options for business unit levels and the resulting
business units that the application suggests for InFusion Corporation.
• UK
• Japan
• India
Country and Division • InFusion Lighting: Japan
• InFusion Lighting: US
• Infusion Security: UK
• Marketing: Japan
• Sales: US
• Sales: UK
• Marketing: India
• Sales: India
• InFusion Security
Division and Legal Entity • InFusion Lighting: Japan
• InFusion Lighting: US
• Infusion Security: UK
• Marketing
Legal Entity • Legal Entity: Japan
• Legal Entity: US
• Legal Entity: UK
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-25
can be understood as buckets of reference data assigned to multiple business
units or other application components.
Reference Data Sets
You begin this part of your implementation by creating and assigning reference
data to sets. Make changes carefully as changes to a particular set will affect
all business units or application components using that set. You can assign a
separate set to each business unit for the type of object that is being shared. For
example, assign separate sets for payment terms, transaction types, and sales
methods to your business units.
Your enterprise can decide that some aspects of corporate policy should affect
all business units and leave other aspects to the discretion of the business unit
manager. This allows your enterprise to balance autonomy and control for each
business unit. For example, if your enterprise holds business unit managers
accountable for their profit and loss, but manages working capital requirements
at a corporate level, you can let managers define their own sales methods, but
define payment terms centrally. In this case, each business unit would have
its own reference data set for sales methods, and there would be one central
reference data set for payment terms assigned to all business units.
The reference data sharing is especially valuable for lowering the cost of setting
up new business units. For example, your enterprise operates in the hospitality
industry. You are adding a new business unit to track your new spa services. The
hospitality divisional reference data set can be assigned to the new business unit
to quickly setup data for this entity component. You can establish other business
unit reference data in a business unit specific reference data set as needed
Reference Data Sharing Methods
There are variations in the methods used to share data in reference data sets
across different types of objects. The following list identifies the methods:
• Assignment to one set only, no common values allowed. The simplest
form of sharing reference data that allows assigning a reference data
object instance to one and only one set. For example, Asset Prorate
Conventions are defined and assigned to only one reference data set.
This set can be shared across multiple asset books, but all the values are
contained only in this one set.
• Assignment to one set only, with common values. The most commonly
used method of sharing reference data that allows defining reference data
object instance across all sets. For example, Receivables Transaction Types
are assigned to a common set that is available to all the business units
without the need to be explicitly assigned the transaction types to each
business unit. In addition, you can assign a business unit specific set of
transaction types. At transaction entry, the list of values for transaction
types includes transaction types from the set assigned to the business unit,
as well as transaction types assigned to the common set that is shared
across all business units.
• Assignment to multiple sets, no common values allowed. The method
of sharing reference data that allows a reference data object instance to
be assigned to multiple sets. For instance, Payables Payment Terms use
this method. It means that each payment term can be assigned to one
or more than one set. For example, you assign the payment term Net
30 to several sets, but the payment term Net 15 is assigned to only your
corporate business unit specific set. At transaction entry, the list of values
Business Units and Reference Data Sets: How They Work Together
Reference data sharing is a feature within Oracle Fusion that enables you to
group set-enabled reference data such as jobs or grades so that the data can be
shared across different parts of the organization. Sets also enable you to filter
reference data at the transaction level so that only data that has been assigned
to certain sets is available to select. To filter reference data, Oracle Fusion
Human Capital Management (HCM), applications use the business unit on the
transaction. To set up reference data sharing in Oracle Fusion HCM, you create
business units and sets, and then assign the sets to the business units.
Common Set Versus Specific Sets
Some reference data in your organization may be considered global, and should
therefore be made available for use within the entire enterprise. You can assign
this type of data to the Common Set, which is a predefined set. Regardless of
the business unit on a transaction, reference data that has been assigned to the
Common Set will always be available, in addition to the reference data that has
been assigned to the set that corresponds to the business unit on the transaction.
Other types of reference data may be specific to certain business units, so you
want to restrict the use of the data to those business units. In this case, you can
create sets specifically for this type of data, and assign the sets to the business
units.
Business Unit Set Assignment
When you assign reference data sets to business units, you assign a default
reference data set that will be used for all reference data types for that business
unit. You can override the set assignment for one or more data types.
Example: Assigning Sets to Business Units
InFusion Corporation has two divisions: Lighting and Security, and the divisions
each have two locations. Each location has one or more business functions.
The following figure illustrates the structure of InFusion Corporation.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-27
When deciding how to create business units, InFusion decides to create them
using the country and business function level. Therefore, they created the
following business units:
• Sales_Japan
• Marketing_Japan
• Sales_US
• Sales_UK
• Marketing_India
• Sales_India
Because locations, departments, and grades are specific to each business unit,
InFusion does not want to share these types of reference data across business
units. They will create a reference data set for each business unit so that data
of those types can be set up separately. Because the jobs in the Sales business
function are the same across many locations, InFusion decides to create one
additional set called Jobs and they will override the set assignment for the Jobs
reference data group and assign it to the Jobs set. Based on these requirements,
they create the following sets:
• Sales_Japan_Set
• Mktg_Japan_Set
• Sales_US_Set
• Sales_UK_Set
• Mktg_India_Set
• Sales_India_Set
• Grades_Set
InFusion assigns business units to sets as follows:
When setting up grades, departments, and locations for the business units,
InFusion will assign the data to the default set for each business unit. When
setting up jobs, they will assign the Jobs set and will assign the Common Set to
any jobs that may be used throughout the entire organization.
Common Set
The common set is a predefined set that enables you to share reference data
across business units. When you select set-enabled data at the transaction level,
the list of values includes data in both the common set and the set associated
with the data type for the business unit on the transaction. For example, when
you create an assignment, the list of values for grades will include both grades in
the common set and in the set that is assigned to grades for the business unit in
which you creating the assignment.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-29
positions is how each is used. Positions offer a well-defined space independent
of the person performing the job. Jobs are a space defined by the person. A job
can be defined globally in the Common Set, whereas a position is defined within
one business unit.
You can update the job and department of a position at any time. This is useful
if you hire someone into a new role and want to transfer the position to another
department.
During implementation, one of the earliest decisions you will make is whether
to use jobs or a combination of jobs and positions. The determinants for this
decision are:
Primary industries and how they usually set up their workforce are listed in the
table below.
Management of People
Positions: Examples
Positions are typically used by industries that use detailed approval rules, which
perform detailed budgeting and maintain head counts, or have high turnover
rates.
Retail Industry
ABC Corporation has high turnover. It loses approximately 5% of their cashiers
monthly. The job of cashier includes three positions: front line cashier, service
desk cashier, and layaway cashier. Each job is cross trained to take over another
cashier position. When one cashier leaves from any of the positions, another
existing cashier from the front line, service desk or layaway can assist where
needed. . But to ensure short lines and customer satisfaction, ABC must replace
each cashier lost to turnover.
Since turnover is high in retail it is better for this industry to use positions.
There is an automatic vacancy when an employee terminates employment.
The position exists even when there are no holders. This is important if the
person who leaves the company is a manager or supervisor with direct reports.
All direct reports continue reporting to the position even if it is empty. You do
not need to reassign these employees to another manager or supervisor; the
replacement manager is assigned to the existing position.
Also, an advantage to using positions is that when you hire somebody new
many of the attributes are defaulted in from the position. This speeds up the
hiring process.
This figure illustrates the retail position setup.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-31
Health Care Industry
The hospital has a structured head count and detailed budgeting. For example,
a specific number of surgeons, nurses, and interns of various types are needed.
These positions need to be filled in order for the hospital to run smoothly. Use
jobs and positions if you need to apply detailed head count rules.
Jobs: Example
Jobs are typically used without positions by service industries where flexibility
and organizational change are key features.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-33
Enterprise-Level Position Attributes
Position attributes at the enterprise level are similar to those for jobs. Each
position that you define identifies a specific role in the enterprise, which you
can manage independently of the person in the position, and it will belong to
one specific department or organization. The name of each position must be
unique. To simplify the process of managing unique names for positions, set up
enterprise-level attributes to identify separate components of the position name.
For example, you can set up an attribute for position title and one for position
number. When defining the attributes that make up the structure of a position
name you should also consider if any of your attributes are part of the definition
of a common job type. Using job types for a position can help you manage
common information that applies to many different positions. For example you
can define a job type of Manager.Level 1 and use this for comparison of positions
across departments or lines or business, or for setting common job requirements.
You can then define multiple manager type positions in your HR department,
each of which has responsibility for a different management function or group.
This figure illustrates how title and position number provide further details for
the manager position.
The legal entity that represents the top level in your organization hierarchy, as
defined by the legal name entered for the enterprise. This designation is used
only to create an organization tree, with the ultimate holding company as the top
level, divisions and country holding companies as the second level, and legal
employers as the third level.
The reference data set that is assigned to a business unit for all reference data
groups, such as grades, locations, departments, and jobs. You can override the
default reference data set for any reference data group.
For the selected business unit, you can override the default reference data set
for one or more reference data groups. For example, assume you have three
reference data groups: Vision 1 SET, Vision 2 SET, and Vision 3 SET, where Vision
SET 1 is the default set for business unit United Kingdom Vision 1 BU. You can
override the default so that grades are assigned to Vision 2 SET, departments are
assigned to Vision 3 SET, and jobs are assigned to the default set, Vision 3 SET.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-35
Define Reference Data Sharing
Note
For specific information on configuring reference data sharing for a particular
object or product, refer to its product documentation.
Partitioning
The partitioning of reference data and creation of data sets enable you to create
reference entities across tables or lookup types, and share modular information
and data processing options among business units. With the help of partitioning,
you can choose to create separate sets and subsets for each business unit
depending upon its business requirement, or create common sets or subsets to
enable sharing reference data between several business units, without the need
for duplicating the reference data. Partitioning provides you the flexibility to
handle the reference data in a way appropriate to your business needs.
The following figure illustrates the reference data sharing method (assignment to
one set only, with common values) where the user can access the data assigned
to a specific set in a particular business unit, as well as access the data assigned
to the common set.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-37
all business units or application components using that set. You can assign a
separate set to each business unit for the type of object that is being shared. For
example, assign separate sets for payment terms, transaction types, and sales
methods to your business units.
Your enterprise can decide that some aspects of corporate policy should affect
all business units and leave other aspects to the discretion of the business unit
manager. This allows your enterprise to balance autonomy and control for each
business unit. For example, if your enterprise holds business unit managers
accountable for their profit and loss, but manages working capital requirements
at a corporate level, you can let managers define their own sales methods, but
define payment terms centrally. In this case, each business unit would have
its own reference data set for sales methods, and there would be one central
reference data set for payment terms assigned to all business units.
The reference data sharing is especially valuable for lowering the cost of setting
up new business units. For example, your enterprise operates in the hospitality
industry. You are adding a new business unit to track your new spa services. The
hospitality divisional reference data set can be assigned to the new business unit
to quickly setup data for this entity component. You can establish other business
unit reference data in a business unit specific reference data set as needed
Determinant Types
Type Description
Asset Book Information about the acquisition, depreciation, and
retirement of an asset that belongs to a ledger or a
business unit.
Business Unit The departments or organizations within an
enterprise.
Cost Organization The organization used for cost accounting and
reporting on various inventory and cost centers
within an enterprise.
Project Unit A logical organization within an enterprise that
is responsible for enforcing consistent project
management practices.
Reference Data Set References to other shared reference data sets.
Determinant
Reference Groups
Note
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-39
The reference groups are predefined in the reference groups table and are
available for selection and assignment.
Items
If you share your items across warehouses or manufacturing facilities, you
can access them through a common item master. Configure one or multiple
item masters for your enterprise, based your enterprise structure. A single
item master is recommended because it provides simpler and more efficient
maintenance. However, in rare cases, it may be beneficial to keep multiple item
masters. For example, if you acquire another enterprise and need to continue
to operate your lines of business separately, maintaining a second item master
might be the best decision.
Suppliers Sites
You can approve particular suppliers to supply specified commodities and
authorize your business units to buy from those suppliers when the need arises.
For example, you might be a household cleaning products manufacturer and
need dyes, plastics, and perfumes to make your products. You purchase from a
central supplier 70% of your perfume supplies with an additional supplier, in
reserve, from whom you purchase the remaining 30%. At the same time, each
of your business units purchases plastics and dyes from the same supplier, but
from different local supplier sites to save transportation costs.
To implement business unit specific supplier sites, Oracle Fusion Procurement
supports a method for defining suppliers sites as owned and managed by the
business unit responsible for negotiating the supplier terms. Your other business
units that have a service provider relationship defined with your procurement
business unit, subscribe to the supplier sites using the supplier site assignments
feature. In addition, Procurement allows sharing of the following procurement
data objects across business units:
• Supplier qualification data, such as approved supplier lists
• Catalog content, such as agreements, smart forms, public shopping lists,
and content zones
• Procurement configuration data
You assign a default set to each business unit. You can optionally override the
default set for the Project Accounting Definition and Project Rates reference
data objects. To enable a project type or rate schedule for use within the business
unit, you must assign the same reference data set to that entity.
Note
If you assign a common set to a rate schedule, then that rate schedule is available
for use across business units.
When specifying project unit implementation options, you select a default set.
You can optionally override the default set for the Project Definition and Project
Transaction Types reference data objects. To enable an entity like a financial plan
type for use on projects owned by a project unit, assign the set associated with
the Project Definition reference data object to the financial plan type.
Similarly, to enable expenditure types and work types for use on projects owned
by a project unit, assign the set associated with the Project Transaction Types
reference data object to those entities.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-41
This topic illustrates the following scenarios.
1. Maintaining separate project management methodologies and data across
units within an enterprise while centralizing financial management of
data
2. Enforcing a single project management methodology across units within
an enterprise while partitioning financial data
Note
These examples are only illustrative. Any combination of business units and
project units can exist.
Note
The default set is used as the reference data set for both the Project Definition
and Project Transaction Types reference data objects.
Vision Corporation can maintain independent setup data for each project unit,
while sharing a single approach to financial management across all project units.
The Labor expenditure type can be used for projects belonging to any project
unit. However, expenditure types for airfare and hotel accommodation are used
only on consulting projects.
• Business Units
• InFusion Canada
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-43
These set assignments govern how planned and actual amounts are calculated
for projects.
The following list contains the reference data objects for the Oracle Fusion
Applications that can be shared across business units and the method in which
the reference data for each is shared.
The following list contains the reference data objects for Oracle Fusion Assets
that can be shared across asset books and the method in which the reference data
for each is shared.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-45
Assets Depreciation Methods Assignment to one set only, with
common values
Assets Asset Descriptions Assignment to one set only, no
common values allowed
Assets Property Types Assignment to one set only, with
common values
Assets Prorate Conventions Assignment to one set only, no
common values allowed
Assets Asset Queue Names Assignment to one set only, with
common values
Assets Retirement Types Assignment to one set only, with
common values
Assets Unplanned Types Assignment to one set only, with
common values
The following list contains the reference data objects for Oracle Fusion Cost
Management that can be shared across cost organizations and the method in
which the reference data for each is shared.
The following list contains the reference data objects for Oracle Fusion Project
Foundation that can be shared across project units and the method in which the
reference data for each is shared.
Define Geographies
You can specify the real time address cleansing level for each country by
choosing either None, meaning that there is no real time address cleansing, or by
choosing Optional, meaning that you will have the choice to cleanse addresses.
Once you have enabled address cleansing for a country a Verify Address icon
appears at address entry points in the application. You can then click the icon
to perform address cleansing and receive a corrected, standardized address.
If Trading Community Data Quality does not find a matching address the
application will alert you.
Geography Structure
Firstly, you need to create a geography structure for each country to define
which geography types are part of the country structure, and how the geography
types are hierarchically related within the country structure. For example, you
can create geography types called State, City, and Postal Code. Then you can
rank the State geography type as the highest level within the country, the City
as the second level, and the Postal Code as the lowest level within the country
structure. Geography structure can be defined using the Manage Geographies
task, or can be imported using tasks in the Define Geographies activity.
Geography Hierarchy
Once the geography structure is defined, the geographies for each geography
type can be added to the hierarchy. For example, below the United States you
can create a geography called California using a State geography type.
As part of managing the geography hierarchy you can view, create, edit, and
delete the geographies for each geography type in the country structure. You
can also add a primary and alternate name and code for each geography. A
geography hierarchy can be created using the Manage Geographies task, or can
be imported using tasks in the Define Geographies activity.
Geography Validation
After defining the geography hierarchy, you need to specify the geography
validations for the country. You can choose which address style formats you
would like to use for the country, and for each selected address style format
you can map geography types to address attributes. You can also select which
geography types should be included in geography or tax validation, and which
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-47
geography types will display in a list of values during address entry in other
user interfaces. The geography validation level for the country, such as error or
warning, can also be selected.
You must add a geography type as a level in the country structure before you
can define a geography for that geography type in a country. For example, before
defining the state of California, the State geography type must be added to the
United States country structure. Only one geography type can be used for each
level, you cannot define more than one geography type at the same level.
Note
After you first define a country structure you can only add geography types
below the current lowest level, and delete geography types without defined
geographies.
To simplify the creation of a country structure you can copy a structure from
another country, and then amend the geography type hierarchy for the country.
The application provides you with a set of available master reference geography
types. If required, you can create a geography type before adding it to the
country structure. Each geography type is added below the current lowest level.
Note
If you want to delete a geography type that is not at the lowest level in the
country structure, then you have to delete the geography type level and all the
levels below it.
Geography hierarchy is a data model that lets you establish conceptual parent-
child relationships between geographies. A geography, such as Tokyo or Peru,
describes a boundary on the surface of the earth. The application can extrapolate
information based on this network of hierarchical geographical relationships.
The top level of the geography hierarchy is Country, so the hierarchy essentially
contains countries and their child geographies. Other aspects of the geography
hierarchy include:
• Geography
• Geography type
• Geography usage
Geography
Geography Type
Geography Usage
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-49
Reference. User defined zones can have the usages of Tax, Shipping, or Territory,
based on what is relevant for their purpose.
The geography hierarchy data is considered to be the single source of truth for
geographies. It is all the data, including geography types and geographies, that
you define and maintain in the Trading Community Model tables.
The geography usage for the entire hierarchy is the master reference, and defined
geography types and geographies are considered as master reference geography
types and geographies. For example, Country is a universally recognized
geography type, and United States is considered a master geography.
User defined zones are a collection of geographical data, created from master
reference data for a specific purpose. For example, territory zones are collections
of master reference geographies ordered in a hierarchy. Tax and shipping zones
are collections of master reference geographies without a hierarchical grouping.
The No Styles Format address style format is the default address style format
for a country. By defining the mapping and validation for this format you will
ensure that validations can be performed for any address in the country. After
the No Styles Format is defined you can set up additional mapping for specific
address styles.
For each address style format, you can define the following:
• Map to attribute
• Tax validation
• Geography validation
Map to Attribute
For every address style format, you can map each geography type to an address
attribute. For example, you can map the State geography type to the State
address attribute for the United States, or map the State geography type to
the County address attribute for the United Kingdom. The geography types
that appear are based on how the country structure is defined. The list of
Note
You only need to map geography types that you want to use for geography or
tax validation purposes.
Once a geography type is mapped to an attribute, then you can specify whether
the geography type will appear in a list of values during address entry in user
interfaces. It is very important to review carefully if you want to enable a list of
values. You should only enable a list of values if you have sufficient geography
data imported or created for that geography. Once you have enabled a list of
values for an address attribute, you can only select the geography data available
for the geography type. This means that if a specific geography value is not
available in the geography hierarchy, you cannot create an address with a
different geography value.
Tax Validation
You can also specify whether a geography type will be included in tax
validation. For example, for the United States North America address style
format you specify that County, State, and City are used for tax validation.
This will mean that when a transaction involves an address with the North
America address style, the address must have the correct county, state, and city
combination based on the geography hierarchy data, to be considered valid for
tax calculation.
Geography Validation
Note
For either the tax or geography validation, do not skip more than one
consecutive level unless you are certain that the selected geography types can
uniquely identify geographies. For example, the United States country structure
is: State, County, City, and Postal Code, and you want to select just State and
Postal Code for geography or tax validation. However, for the combination of
California and 94065, the city can be either Redwood Shores or Redwood City. In
this case, you should also select at least the City geography type for geography
or tax validation.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-51
Geography Validation Control
You can select the geography validation level for a country. Validation will check
if the entered address maps to the geography hierarchy data available for the
country, and the geography validation control determines whether you can save
an address that did not pass validation during address entry. For example, if the
validation level is Error, then an address cannot be saved if the values do not
match the geography hierarchy data.
These are the geography validation levels you can choose:
• Error - only completely valid addresses can be saved, with all mandatory
address elements entered.
• No Validation - all addresses can be saved including incomplete and
invalid addresses.
Regardless of the result of validation, the validation process will try to map
any address attribute to a geography of the country, and store any mapping
it could establish based on the available data. This is called Geography
Name Referencing and it is executed as part of validation. The result of this
referencing is used in several business processes in the application to map an
address to a specific geography or zone.
Note
The Geography Dimension value in territories is derived from sell-to addresses
of sales accounts. To use geography dimensions in territories, ensure that
the geography elements in addresses, such as state, city, and postal code, are
validated. You can do so by enabling geography validation for each country
using the Manage Geographies task. While doing so, ensure that at least one
level in the geography hierarchy is enabled for geography validation. It is
recommended that you enable geography validation for all geography levels that
you intend to use for territory definition for each country. You can enable a list
of values containing specific geography elements. This will help users search
and select appropriate geography values during addresses entry and eliminate
all possibilities of wrong address entry. You can also set geography validation
control to Error in the Manage Geography Validation page. This ensures that
users can only use valid geography elements in addresses. If you have already
created addresses before setting up geography validation for a country, you must
execute the Run Maintain Geography Name Referencing task for that country
after enabling geography validation to ensure that all your geography elements
are validated.
The file-based import process reads the data included in your XML or text
file, populates the interface tables, and imports the data into the application
destination tables. The File-Based Data Import Setup and Maintenance task
list includes the tasks needed to configure the geography import object, create
source file mappings, and schedule the import activities.
Populate the interface table with your import data, then navigate to the Run
Geography Loader Setup and Maintenance task to schedule the import of data
from the interface table to the destination table.
The geography import object consists of one entity and interface table that forms
the geography. If you are using file-based import, you can map your source file
data to import entity attributes that correspond to the interface table columns.
The import activity process populates the interface table based on the mapping
and your source file. If using the geography loader scheduled process, populate
the interface table directly using your preferred tool. If you need the unique IDs
of existing application data for your import data, use the Define Data Export
Setup and Maintenance task list to export the information.
Note
The following lists the object entity, tables, and resulting application object:
HZ_GEOGRAPHY_IDENTIFIERS
HZ_GEOGRAPHY_TYPES_B
HZ_HIERARCHY_NODES
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-53
Importing Country Structures Using File-Based Import: Explained
This topic explains how to prepare and import country structure data from an
external data source into Oracle Fusion Applications using the File-Based Data
Import feature. A country structure is a hierarchical grouping of geography
types for a country. For example, the geography structure for the United States
has the geography type of State at the top, followed by the County, then the City,
and finally the Postal Code.
You can use the country structure to set up the following:
• The relationships between geographies within a country
• The types of geographies that you can define for a country
Consider the following questions when importing your data:
• How does your legacy system or source system represent the country
structure compared to how Oracle Fusion Applications represent the same
data?
• Do you have to configure values in Oracle Fusion Applications to map to
your data values?
• Do you have to customize Oracle Fusion Applications to capture
additional attributes that are critical to the way you do business?
• What import features are available for importing your business object?
• How do you verify your imported data?
You must understand how your country structure data corresponds with the
data in Oracle Fusion Applications in order to be able to map your legacy data
to the data needed by Oracle Fusion Applications. First, you must understand
how Oracle Fusion Applications represent the structure of the data for a country
structure.
You must import a separate country structure import object for each country.
Each of these import objects must contain the geography types that are used in
the country's structure, organized in a hierarchy using geography level numbers.
For example, if you are importing the country structure of Australia, the country
structure could be the following: 1: Country, 2: State, 3: County, 4: Town, 5: ZIP.
Each import object is a collection of attributes that helps to map your data to
the Oracle Fusion Applications data and to support one-to-many relationships
between the structural components that make up the country structure.
Extensible Attributes
If you need to extend the Oracle Fusion Applications object to import your
legacy or source data, you must use Oracle Fusion CRM Application Composer
to design your object model extensions and to generate the required artifacts
to register your extensions and make them available for importing. The
corresponding import object is updated with the extensible attributes, which
can then be mapped to your source file data. You can use the same source file
to import both extensible custom attributes and the standard import object
attributes.
For the country structure business object, you must use the File-Based Data
Import feature. You prepare XML or text source data files in a form that is
suitable for file-based import. The file-based import process reads the data
included in your source file, populates the interface tables according to your
mapping, and imports the data into the application destination tables.
The Define File-Based Data Import Setup and Maintenance task list includes the
tasks needed to configure the import objects, to create source-file mappings, and
to schedule the import activities. You submit file-based import activities for each
import object. When creating a new country structure, you import the Country
Structure object.
You must be assigned the Master Data Management Administrator job role to
access and submit the import activities for country structures.
You can view the list of import activities from the Manage Import Activities
page. You can verify your imported data by clicking the Status column for your
import activity.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-55
Country Structure Import Objects: How They Work Together
This topic describes the Country Structure import object. You use the Country
Structure import object when you submit a file-based import activity to import
your country structure information. This topic introduces the following:
• Target import object concepts
• Target objects for the Country Structure import object
• Target import object attributes
• Target object attribute reference guide files
Note
If any of the attributes you want to import does not have an equivalent target
object attribute, then review the Oracle Fusion CRM Application Composer
extensibility features for country structures.
Sample attributes:
GeographyType,
GeographyTypeName,
LevelNumber, and
ParentGeographyType.
You must understand how your geography data corresponds with the data in
Oracle Fusion Applications in order to be able to map your legacy data to the
data needed by Oracle Fusion Applications. First, you must understand how
Oracle Fusion Applications represent the structure of the data for a geography.
You must import a separate country structure import object for each country.
Each of these import objects must contain the geography types that are used in
the country's structure, organized in a hierarchy using geography level numbers.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-57
For example, if you are importing the country structure of Australia, the country
structure could be the following: 1: Country, 2: State, 3: County, 4: Town, 5: ZIP.
Each import object is a collection of attributes that helps to map your data to
the Oracle Fusion Applications data and to support one-to-many relationships
between the structural components that make up the geography.
A good understanding of the attribute details of the import objects is critical
to preparing your import data. For information about the Oracle Fusion
Applications attributes, see the Oracle Enterprise Repository. The reference
files contain descriptions, logic used to choose default values, and validation
information for each of the Oracle Fusion Applications attributes. The validation
information includes the navigation to the task where you can define values
in Oracle Fusion Applications. For example, if you have values in your
data that correlate to a choice list in Oracle Fusion Applications, then the
validation information for that attribute provides the task name in the Setup
and Maintenance work area where you can define your values. For additional
information, including a list of reference file names and locations that you need
to complete this task, see the following table.
Hint: You can use the keyword importing geographies to search for related
topics in Oracle Fusion Applications Help.
Extensible Attributes
For the geography business object, you must use the File-Based Data Import
feature. You prepare XML or text source data files in a form that is suitable for
file-based import. The file-based import process reads the data included in
your source file, populates the interface tables according to your mapping, and
imports the data into the application destination tables.
The Define File-Based Data Import Setup and Maintenance task list includes
the tasks needed to configure the import objects, to create source-file mappings,
and to schedule the import activities. You submit file-based import activities for
each import object. When creating a new geography, you import the Geography
object. You must be assigned the Master Data Management Administrator job
role to access and submit the import activities for geographies.
Note
Before you import geography data for a country, you must define the country's
geography structure.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-59
default values, and validations performed by the import process. Review
the validation for each attribute to determine whether there are functional
prerequisites or setup tasks that are required.
To import your source file data, you define a mapping between your source file
data and the combination of the target object and target object attribute. You can
predefine and manage import mappings using the File-Based Import Mapping
task, or you can define the mapping when you define the import activity using
the File-Based Import Activity task. Both tasks are available in the Setup and
Maintenance work area.
The following table lists the reference guide files that are available from the
Documentation tab for the Geography File-Based Data Import asset.
Sample attributes:
CountryCode, GeoDataProvider,
GeographyType,
PrimaryGeographyCode,
PrimaryGeographyCodeType, and
PrimaryGeographyName.
The following table summarizes the key decisions for this scenario:
These are the steps that are required to create an import activity and submit the
import:
Prerequisites when importing additional geography data after your initial import
1. You need to ensure that the combination of Source ID and Parent
Source ID values are unique for each row of data within a single import.
However, your source data files do not need to have the same Source
ID and Parent Source ID values as your previously imported geography
data. If the geography structure levels and the parents for each geography
value are the same, the changed IDs will not affect the import.
2. Ensure that all of the parents of a child geography are included in your
data file so that the child geography can be added. For example, if you
originally imported US, CA, and San Francisco, and now you want to
import the city of San Jose in CA, then your data file needs to include US,
CA, and San Jose.
3. Check that your source data file has the correct values for the geography
data that you have already loaded. For example, if your initial import
included the value US for country and CA as state, and in a subsequent
import you have California as a state, your geography import will result
in two state records (CA and California) in the application data, with the
US as the country parent.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-61
Create and schedule the import activity
You create an import activity, enter the import details, and schedule the import.
An import activity definition provides the instructions for the import processing
- this includes selecting the source file, or file location; mapping fields from the
source file to the Oracle Fusion object and attribute; and scheduling the import.
1. Navigate to Setup and Maintenance and search for the Manage File
Import Activities task. Click Go to Task.
2. In the Manage Import Activities page, click the Create icon.
3. In the Create Import Activity: Set Up page, create an import activity for
the Geography object type by completing the fields, as shown in this table:
Field Value
Name Master Reference Geographies
Object Geography
File Type Text File
File Selection Specific file
Upload From Desktop
File Name Choose relevant file from desktop
Data Type Comma separated
Note
Ensure that the file type that you select in the Create Import Activity: Set
Up page matches the file type of the source data file.
4. Click Next.
5. On the Create Import Activity: Map Fields page, map each field from
your source file to the Oracle Fusion object and attribute, as shown in this
example:
Note
If you have any difficulties mapping the fields from your source file to the
relevant Oracle Fusion applications object, you can use the import object
spreadsheets for reference.
6. Click Next.
7. On the Create Import Activity: Create Schedule page, select Immediate in
the Schedule field so that the import will start immediately.
1. On the Create Import Activity: Review and Activate page, you verify your
import details in the Import Details, File Details, Import Options, and
Schedule sections.
2. Your import details are correct so you click Activate to submit the import.
Once the import activity has completed, the Status field value will change
to Completed.
To define your territory geography zones and then import your territory zones
into another Oracle Fusion applications instance, you need to complete the
following steps:
1. Import the master reference geography data into the Oracle Fusion
application.
2. Define your territory geography zones using the Manage Territory
Geographies task.
3. Export the territory geography zones.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-63
4. Import the territory geography zones into another Oracle Fusion
applications instance.
Firstly, you need to import the master reference geography data. Master
reference geography data consists of geography elements such as country, state,
and city, and is required for any geographical information you store in the
application, such as address information used in customer and sales records.
For more information, refer to the Geography Hierarchy: Explained topic listed
in the related topics section. Master reference geography data can be imported
into the application using the Manage File Import Activities task in Setup and
Maintenance - refer to the Importing Master Reference Geography Data: Worked
Example topic listed in the related topics section for more information.
Once the master reference geography data has been imported, you can then
create your territory geography zones in the application using the Manage
Territory Geographies task in Setup and Maintenance. For more information,
refer to the Managing Territory Geographies: Worked Example topic listed in the
related topics section.
Once you have completed importing the master reference geography data and
defining your territory geography zone tasks, you can create a configuration
package to export the territory zone data. For more information, refer to the
Exporting Setup Data demo listed in the related topics section.
Once you have downloaded your configuration package for your territory
geography zone setup, you can import the territory zones into another Oracle
Fusion application instance. For more information, refer to the Importing Setup
Data listed in the related topics section.
Note
Ensure that you import your master reference geography data into the new
Oracle Fusion instance before you import the configuration package.
1. County
2. Post Town
What is the geography hierarchy? Create the following hierarchy:
Add the County and Post Town geography types to the geography structure.
Next, add the geographies for the County and Post Town geography types to
define the geography hierarchy. Finally, specify the geography validations for the
geography types you have added to the geography structure.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-65
6. Click Save and Close.
7. On the Manage Geography Hierarchy page, Geography Hierarchy
section, click Berkshire to highlight the table row.
8. Click the Create button.
9. In the Create Post Town page, Primary and Alternate Names section,
enter Reading in the Name field.
10. Click Save and Close.
When address data entered into the application needs to conform to a particular
format, in order to achieve consistency in the representation of addresses. For
example, making sure that the incoming data is stored following the correct
postal address format.
You can only update a geography structure by adding existing geography types,
or by creating new geography types and then adding them to the geography
structure. You can only copy an existing country structure when you are defining
a new country structure.
If a geography exists for a country geography structure level then you cannot
delete the level. For example, if a state geography has been created for the United
States country geography structure, then the State level cannot be deleted in the
country geography structure.
Yes. However, the geography type for the geography that you want to add must
be already added to the country geography structure.
Yes. In the Manage Geography Hierarchy page you can edit details such as the
geography's date range, primary and alternate names and codes, and parent
geographies.
How can I add a geography that is the level below another geography in a
geography hierarchy?
Select the geography that you want your geography to be created below, and
then click the Create icon. This will allow you to create a geography for a
geography type that is the level below the geography type you selected. The
structure of the country's geography types are defined in the Manage Geography
Structure page.
Jurisdictions: Explained
Jurisdiction is a physical territory such as a group of countries, country, state,
county, or parish where a particular piece of legislation applies. French Labor
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-67
Law, Singapore Transactions Tax Law, and US Income Tax Laws are examples of
particular legislation that apply to legal entities operating in different countries'
jurisdictions. Judicial authority may be exercised within a jurisdiction.
• Identifying Jurisdiction
Identifying Jurisdiction
For example, the Internal Revenue Service is the authority for enforcing income
tax laws in United States. In some countries, such as India and Brazil, you
are required to print legal authority information on your tax reports. Legal
authorities are defined in the Oracle Fusion Legal Entity Configurator. Tax
authorities are a subset of legal authorities and are defined using the same setup
flow.
Legal Jurisdictions
Create a legal jurisdiction by following these steps:
1. Navigate to the Manage Legal Jurisdictions page from the Setup and
Maintenance work area by querying on the Manage Legal Jurisdictions
task and selecting Go to Task.
2. Select Create.
3. Enter a unique Name, United States Income Tax.
4. Select a Territory, United States.
5. Select a Legislative Category, Income tax.
6. Select Identifying, Yes. Identifying indicates the first jurisdiction a legal
entity must register with to do business in a country.
7. Enter a Start Date if desired. You can also add an End Date to indicate a
date that the jurisdiction may no longer be used.
8. Select a Legal Entity Registration Code, EIN or TIN.
9. Select a Legal Reporting Unit Registration Code, Legal Reporting Unit
Registration Number.
10. Optionally enter one or more Legal Functions.
11. Select Save and Close.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-69
8. Optionally enter a Time Zone, US Pacific Time.
9. Select OK.
10. Select Save and Close.
Legal Authorities
Create a legal authority by following these steps:
1. Navigate to the Manage Legal Authorities page from the Setup and
Maintenance work area by querying on the Manage Legal Authorities
task and selecting Go to Task.
2. Enter the Name, California Franchise Tax Board.
3. Enter the Tax Authority Type, Reporting.
Note
Create an address for the legal authority.
4. Select Create.
5. The Site Number is automatically assigned.
6. Optionally enter a Mail Stop.
7. Select Country, United States
8. Enter Address Line 1, 121 Spear Street, Suite 400.
9. Optionally enter Address Line 2, and Address Line 3.
10. Enter or Select Zip Code, 94105.
11. Select Geography 94105 and Parent Geography San Francisco, San
Francisco, CA.
12. Select OK.
13. Optionally enter a Time Zone, US Pacific Time.
14. Optionally click the One-Time Address check box.
15. The From Date defaults to today's date. Update if necessary.
16. Optionally enter a To Date to indicate the last day the address can be
used.
Note
You can optionally enter Address Purpose details.
Note
Working within an implementation project is required because you select a scope
value within an implementation project. The scope value is the legal entity that
you will create or select to work within for your implementation project.
Note
The following message appears:
You must first select a scope value to perform the task.
• Select and add an existing scope value to the implementation project.
• Create a new scope value and then add it to the implementation
project.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-71
Note
Enter the Registration Information.
13. Accept the default Identifying Jurisdiction, United States Income Tax.
14. Search for and select a Legal Address, 500 Oracle Parkway, Redwood
Shores, CA 94065.
Note
The legal address must have been entered previously using the Manage Legal
Address task.
Note
Enter Registration Information.
Note
Enter Main Legal Reporting Unit information.
8. Select the value Yes or No for the Main Legal Reporting Unit. Set value to
yes only if you are creating a new main (primary) legal reporting unit.
9. Enter the Main Effective Start Date, 1/1/11.
10. Save and Close.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-73
recognized in law for which you want to record assets, liabilities, expenses and
income, pay transaction taxes, or perform intercompany trading.
A legal entity has responsibility for elements of your enterprise for the following
reasons:
• Facilitating local compliance
• Taking advantage of lower corporation taxation in some jurisdictions
• Preparing for acquisitions or disposals of parts of the enterprise
• Isolating one area of the business from risks in another area. For example,
your enterprise develops property and also leases properties. You could
operate the property development business as a separate legal entity to
limit risk to your leasing business.
The Role of Your Legal Entities
In configuring your enterprise structure in Oracle Fusion Applications, you need
to understand that the contracting party on any transaction is always the legal
entity. Individual legal entities own the assets of the enterprise, record sales and
pay taxes on those sales, make purchases and incur expenses, and perform other
transactions.
Legal entities must comply with the regulations of jurisdictions, in which they
register. Europe now allows for companies to register in one member country
and do business in all member countries, and the US allows for companies to
register in one state and do business in all states. To support local reporting
requirements, legal reporting units are created and registered.
You are required to publish specific and periodic disclosures of your legal
entities' operations based on different jurisdictions' requirements. Certain annual
or more frequent accounting reports are referred to as statutory or external
reporting. These reports must be filed with specified national and regulatory
authorities. For example, in the United States (US), your publicly owned entities
(corporations) are required to file quarterly and annual reports, as well as other
periodic reports, with the Securities and Exchange Commission (SEC), who
enforces statutory reporting requirements for public corporations.
Individual entities privately held or held by public companies do not have to
file separately. In other countries, your individual entities do have to file in
their own name, as well as at the public group level. Disclosure requirements
are diverse. For example, your local entities may have to file locally to comply
with local regulations in a local currency, as well as being included in your
enterprise's reporting requirements in different currency.
A legal entity can represent all or part of your enterprise's management
framework. For example, if you operate in a large country such as the United
Kingdom or Germany, you might incorporate each division in the country as a
separate legal entity. In a smaller country, for example Austria, you might use a
single legal entity to host all of your business operations across divisions.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-75
Legal Entity and Its Relationship to Divisions
One of your major responsibilities is to file financial statements for your legal
entities. Map legal entities to specific ledgers using the Oracle Fusion General
Ledger Accounting Configuration Manager. Within a ledger, you can optionally
map a legal entity to one or more balancing segment values.
Legal Entity and Its Relationship to Balancing Segments
Note
Implementing multiple balancing segments requires every journal entry that is
not balanced by division or business unit, to generate balancing lines. Also, you
If you decided to account for each legal entity in a separate ledger, there is no
requirement to identify the legal entity with a balancing segment value within
the ledger.
Note
While transactions that cross balancing segments don't necessarily cross legal
entity boundaries, all transactions that cross legal entity boundaries must cross
balancing segments. If you make an acquisition or are preparing to dispose
of a portion of your enterprise, you may want to account for that part of the
enterprise in its own balancing segment even if it is not a separate legal entity.
If you do not map legal entities sharing the same ledger to balancing segments,
you will not be able to distinguish them using the intercompany functionality or
track their individual equity.
In Oracle Fusion Applications you can map legal entities to balancing segments
and then define consolidation rules using your balancing segments. You are
creating a relationship between the definition of your legal entities and their role
in your consolidation.
Legal Entity and its Relationship to Intercompany Transactions
Note
In the Oracle Fusion Supply Chain applications, model intercompany
relationships using business units, from which legal entities are inferred.
Legal Entity and Its Relationship to Worker Assignments and Legal Employer
Legal entities that employ people are called legal employers in the Oracle
Fusion Legal Entity Configurator. You must enter legal employers on worker
assignments in Oracle Fusion HCM.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-77
Legal Entity and Payroll Reporting
Your legal entities are required to pay payroll tax and social insurance such as
social security on your payroll. In Oracle Fusion Applications, you can register
payroll statutory units to pay and report on payroll tax and social insurance
on behalf of many of your legal entities. As the legal employer, you might be
required to pay payroll tax, not only at the national level, but also at the local
level. You meet this obligation by establishing your legal entity as a place of
work within the jurisdiction of a local authority. Set up legal reporting units to
represent the part of your enterprise with a specific legal reporting obligation.
You can also mark these legal reporting units as tax reporting units, if the legal
entity must pay taxes as a result of establishing a place of business within the
jurisdiction.
One Payroll Statutory Unit and Two Tax Reporting Units That Are Subsidiaries
of the Legal Entity
This model makes no distinction between a legal employer and a payroll
statutory unit. Tax reporting units are defined as subsidiaries to the legal entity.
In this enterprise, legal entity is the highest level of aggregation for payroll
calculations and reporting, and statutory reporting boundaries are assumed to
be the same for both payroll and HR management. An example of a country that
might use this model is France.
This figure illustrates an example of an organization with one legal entity that is
both a legal employer and a payroll statutory unit and that has two tax reporting
units.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-79
One Payroll Statutory Unit with Several Tax Reporting Units That Are
Independent from the Legal Employer
In this model, the enterprise has one legal entity, and legal employers and tax
reporting units are independent from each other within a payroll statutory unit,
because there is no relationship from a legal perspective. Therefore, you can
run reporting on both entities independently. Using this model, you would not
typically need to report on tax reporting unit balances within a legal employer,
and balances can be categorized by either or both organizations, as required. An
example of a country that might use this model is India.
This figure illustrates an enterprise with one legal entity that is a payroll
statutory unit and a legal employer, and the tax reporting units are independent
from the legal employer.
This figure illustrates an enterprise with two legal entities, and legal employers
and tax reporting units are independent from each other.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-81
Payroll Statutory Units, Legal Employers, and Tax Reporting Units:
How They Work Together
When you set up legal entities, you can identify them as legal employers
and payroll statutory units, which makes them available for use in Oracle
Fusion Human Capital Management (HCM). A tax reporting unit is created
automatically when you add a legal entity and identify it as a payroll statutory
unit. Depending on how your organization is structured, you may have only one
legal entity that is also a payroll statutory unit and a legal employer, or you may
have multiple legal entities, payroll statutory units, and legal employers.
A legal employer is a legal entity that employs workers. You define a legal entity
as a legal employer in the Oracle Fusion Legal Entity Configurator.
The legal employer is captured at the work relationship level, and all
employment terms and assignments within that relationship are automatically
with that legal employer. Legal employer information for worker assignments is
also used for reporting purposes.
Payroll statutory units are legal entities that are responsible for paying workers,
including the payment of payroll tax and social insurance. A payroll statutory
unit can pay and report on payroll tax and social insurance on behalf of one or
many legal entities, depending on the structure of your enterprise. For example,
if you are a multinational, multicompany enterprise, then you register a payroll
statutory unit in each country where you employ and pay people. You can
optionally register a consolidated payroll statutory unit to pay and report on
workers across multiple legal employers within the same country. You associate
a legislative data group with a payroll statutory unit to provide the correct
payroll information for workers.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-83
• Tax authorities: Parties that administer tax rules and regulations.
First Parties
Set up tax profiles for your first party legal entities, legal reporting units, and
business units.
First party legal entities identify your organization to the relevant legal
authorities, for example, a national or international headquarters. Legal
entities let you more accurately model your external relationships to legal
authorities. The relationships between first party legal entities and the relevant
tax authorities normally control the setup of the transaction taxes required by
your business. Under most circumstances the tax setup is used and maintained
based on the configuration of the legal entity. Enter the default information,
party fiscal classifications, tax reporting codes, and configuration options for
your legal entities. You can also specify if you are using the tax services of an
external service provider for tax calculation.
First party legal reporting units identify each office, service center, warehouse
and any other location within the organization that has a tax requirement. A
legal reporting unit tax profile is automatically created for the headquarter
legal entity. Set up additional legal reporting unit tax profiles for those needed
for tax purposes. For legal reporting units, enter the default information, tax
registrations, party fiscal classifications, and tax reporting codes. Also, define
tax reporting details for your VAT and global tax reporting needs for tax
registrations of tax regimes that allow this setup.
• Indicate that business unit tax setup is used and maintained based on
the configuration of the associated legal entity at transaction time. The
tax setup of the associated legal entity setup is either specific to the legal
entity or shared across legal entities using the Global Configuration
Owner setup.
• Indicate that tax setup is used and maintained by a specific business unit.
Create configuration options for the business unit to indicate that the
subscribed tax content is used for the transactions created for the business
unit.
For business units that maintain their own setup, enter the default information,
tax reporting codes, configuration options, and service providers as required.
Third Parties
Set up third party tax profiles for parties with the usage of customer, supplier,
and their sites. Enter the default information, tax registrations, party fiscal
classifications, and reporting codes required for your third parties or third party
sites. You can set up tax exemptions for your customers and customer sites.
Banks are also considered third parties. When a bank is created, the tax
registration number specified on the bank record is added to the party tax profile
record in Oracle Fusion Tax. You can not modify the party tax profile for a bank
as it is view only. You can only modify the bank record itself.
Setting up party tax profiles for third parties is not required. Taxes are still
calculated on transactions for third parties that do not have tax profiles
Tax Authorities
Set up a tax authority party tax profile using the Legal Authorities set up task.
The tax authority party tax profile identifies a tax authority party as a collecting
authority or a reporting authority or both. A collecting tax authority manages
the administration of tax remittances. A reporting tax authority receives and
processes all company transaction tax reports.
The collecting and reporting tax authorities appear in the corresponding list of
values on all applicable Oracle Fusion Tax pages. All tax authorities are available
in the list of values as an issuing tax authority.
Set up first party tax profiles for all legal entities, legal reporting units, and
business units in your organization that have a transaction tax requirements.
How you set up your first parties can impact the tax calculation on your
transactions.
• Tax reporting codes: Applicable to legal entities, legal reporting units, and
business units who do not use the tax setup of the legal entity.
The following table describes the defaults and controls available at the first party
tax profile level:
Option Description
Set as self-assessment (reverse charge) Automatically self-assess taxes on purchases.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-85
Rounding Level Perform rounding operations on the:
Note
Set Invoice Values as Tax Inclusive This first party intends to send or receive invoices
with invoice line amount inclusive of the tax
amount.
Note
Tax Registrations
You must set up a separate tax registration to represent each distinct registration
requirement for a first party legal reporting unit. Oracle Fusion Tax uses tax
registrations in tax determination and tax reporting. If your first party has
more than one tax registration under the same tax regime, then the application
considers the tax registration in the order: tax jurisdiction; tax; tax regime.
You must enable the Use tax reporting configuration option on the first party
tax regime to allow entry of global tax reporting configuration details during tax
registration setup for legal reporting units for these tax regimes.
If applicable, associate first party fiscal classification codes with this party. The
party fiscal classification codes you enter become part of tax determination for
invoices associated with this party. Specify start and end dates to control when
these fiscal classifications are applicable for this party and transaction.
For legal entities, you can view the associated legal classifications that were
assigned to the tax regime defined for this first party. The legal classifications are
used in the tax determination process, similarly to the party fiscal classifications.
Configuration Options
The legal entities and business units in your organization are each subject to
specific sets of tax regulations as designated by the tax authorities where you do
business. Use configuration options to associate legal entities and business units
with their applicable tax regimes. You can set up tax configuration options when
you create a tax regime or when you create a party tax profile. Both setup flows
display and maintain the same party and tax regime definitions.
Service Subscriptions
Oracle Fusion Tax lets you use the tax services of external service providers for
tax calculation of US Sales and Use Tax on Receivables transactions. The setup
for provider services is called a service subscription. A service subscription
applies to the transactions of one configuration option setup for a combination
of tax regime and legal entity or business unit. Set up service subscriptions when
you create a tax regime or when you create a party tax profile for a first party
legal entity or business unit.
When does a party tax profile get created for a legal entity?
The legal entity party tax profile is automatically created when a legal entity
record is created. If a legal entity party tax profile record is not created, for
example, when a legal entity is created through a back-end process, a legal entity
party tax profile is created upon saving the tax regime when a legal entity is
subscribed to or upon saving the configuration owner tax options when they are
defined for the legal entity. Otherwise, create a party tax profile using the Create
Legal Entity Tax Profile page. You can edit the tax profile that was automatically
generated with the relevant tax information, but it is not required.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-87
• Anticipates growth and maintenance needs as organizational changes
occur
• Facilitates an efficient data processing flow
• Allows for delegation of responsibility for cost control, profit attainment,
and asset utilization
• Measures performance against corporate objectives by your managers
The chart of accounts facilitates aggregating data from different operations,
from within an operation, and from different business flows, thus enabling
the organization to report using consistent definitions to their stakeholders in
compliance with legislative and corporate reporting standards and aiding in
management decisions.
Best practices include starting the design from external and management
reporting requirements and making decisions about data storage in the general
ledger, including thick versus thin general ledger concepts.
With a thin general ledger, you use the general ledger for internal control,
statutory reporting, and tracking of asset ownership. You minimize the data
stored in your general ledger. A thin general ledger has many of the following
characteristics:
• Minimal chart of accounts
A thin general ledger has natural accounts at a statutory reporting level, for
example, payroll expense, rent, property taxes, and utilities. It has cost centers
at the functional expense level, such as Research and Development (R&D)
or Selling, General, and Administrative (SG&A) expense lines, rather than at
department or analytic levels. It omits business unit, division, and product
detail.
One example of an industry that frequently uses a thin general ledger is retail. In
a retail organization, the general ledger tracks overall sales numbers by region.
A retail point of sales product tracks sales and inventory by store, product,
supplier, markup, and other retail sales measures.
With a thick general ledger, you use the general ledger as a detailed, analytic
tool, performing analytic functions directly in the general ledger. Data is broken
down by many reporting labels, and populated frequently from the subledgers.
You maximize the data stored in the general ledger. A thick general ledger has
many of the following characteristics:
In a thick general ledger, you obtain detail for cost of goods sold and inventory
balances and track property plant and equipment at a granular level. Cost
centers represent functional expenses, but also roll up to departmental or other
expense analysis levels. Using product and location codes in optional segments
can provide reporting by line of business. Posting daily, at the individual
transaction level, can maximize the data stored in the general ledger.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-89
Other Considerations
Consider implementing a thick ledger if there are business requirements to do
any of the following:
• Track entered currency balances at the level of an operational dimension
or segment of your chart of accounts, such as by department or cost center
• Generate financial allocations at the level of an operational dimension or
segment
• Report using multiple layered and versioned hierarchies of the
operational dimension or segment from your general ledger
Consider implementing a thin ledger in addition to a thick ledger, if there are
additional requirements for:
• Minimal disclosure to the authorities in addition to the requirements
listed above. For example, in some European countries, fiscal authorities
examine ledgers at the detailed account level.
• Fiscal only adjustments, allocations, and revaluations, which don't impact
the thick general ledger.
The important consideration in determining if a thick ledger is the primary or
secondary ledger is your reporting needs. Other considerations include how the
values for an operational dimension or segment are derived and the amount of
resources used in reconciling your different ledgers. If values for the operational
dimension are always entered by the user like other segments of the accounting
flexfield, then a thick primary ledger is the better choice.
However, if values for the operational dimension or segment are automatically
derived from other attributes on the transactions in your subledger accounting
rules, rather than entered in the user interface, then use a thick secondary ledger.
This decision affects the amount of:
• Storage and maintenance needed for both the general ledger and
subledger accounting entries
• System resources required to perform additional posting
• In summary, you have:
• Minimum demand on storage, maintenance, and system resources with
the use of a thin ledger
• Greater demand on storage, maintenance, and system resources with
the use of a thick ledger
• Greatest demand on storage, maintenance and system resources with
the use of both thick and thin ledgers
Note
Generally speaking, there is a tradeoff between the volume of journals and
balances created and maintained versus system resource demands. Actual
performance depends on a wide range of factors including hardware and
network considerations, transaction volume, and data retention policies.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-91
Chart of Accounts
The chart of accounts defines the number and attributes of various segments,
including the order of segments, the width of segments, prompts, and segment
labels, such as balancing, natural account, and cost center.
The chart of accounts further defines the combination of value sets associated
with each segment of the chart of accounts, as well as the type, default value,
additional conditions designating the source of the values using database tables,
and the required and displayed properties for the segments.
Segments
A chart of accounts segment is a component of the account combination. Each
segment has a value set attached to it to provide formatting and validation of
the set of values used with that segment. The combination of segments creates
the account combination used for recording and reporting financial transactions.
Examples of segments that may be found in a chart of accounts are company,
cost center, department, division, region, account, product, program, and
location.
Segment Labels
Segment labels identify certain segments in your chart of accounts and assign
special functionality to those segments. Segment labels were referred to as
flexfield qualifiers in Oracle E-Business Suite. Here are the segment labels that
are available to use with the chart of accounts.
• Balancing: Ensures that all journals balance for each balancing segment
value or combination of multiple balancing segment values to use in trial
balance reporting. There are three balancing segment labels: primary,
second, and third balancing. The primary balancing segment label is
required.
Note
All segments have a segment qualifier that enables posting for each value. The
predefined setting is Yes to post.
Account Combinations
An account combination is a completed code of segment values that uniquely
identifies an account in the chart of accounts, for example 01-2900-500-123,
might represent InFusion America (company)-Monitor Sales (division)-Revenue
(account)-Air Filters (product).
Rules
The chart of accounts uses two different types of rules to control functionality.
The chart of accounts within the ledger facilitates aggregating data from different
operations, from within an operation, and from different business flows.
This functionality enables you to report using consistent definitions to your
stakeholders in compliance with legislative and corporate reporting standards
and aids in management decisions.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-93
• Legal Entities: Identifies a recognized party with rights and
responsibilities given by legislation, which has the right to own property
and the responsibility to account for themselves.
• Balancing Segment: Ensures that all journals balance for each balancing
segment value or combination of multiple balancing segment values to
use in financial processes and reporting. The three balancing segment
labels are: primary, second, and third balancing. The primary balancing
segment label is required.
Note
On the Instruction sheet is a link to a completed sample data workbook.
Process Overview
Begin by downloading the Rapid Implementation for General Ledger
workbook using the Create Chart of Accounts, Ledger, Legal Entities, and
Business Units in Spreadsheet task on the Setup and Maintenance work area.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-95
The following figure illustrates the Create Chart of Accounts, Ledger, Legal
Entities, and Business Units process, what data is entered into each sheet of the
workbook, and the components that the process creates.
Process
Enter Data
The Create Chart of Accounts, Ledger, Legal Entities, and Business Units
workbook provides five sheets.
1. Instructions
2. Chart of Accounts, Calendar, and Ledger
3. Business Units
4. Companies and Legal Entities
5. Natural Accounts
Sheets used to enter other segment values and hierarchies for additional
segments are created by entering the segments on the Chart of Accounts,
Calendar, and Ledger sheet and then clicking the Add Segment Sheets button.
Instructions Sheet
Read the planning tips, loading process, best practices, and recommendations.
Tip
When the data is uploaded, the Allow Dynamic Insertion option used to enable
the generation of new account combinations dynamically instead of creating
them manually is enabled by default. To prevent the creation of invalid accounts,
you must define cross-validation rules. Define cross-validation rules before
entering data or loading history. Cross-validation rules only prevent creation of
new accounts, not disabling of preexisting accounts.
Tip
If you select No and uploaded the options, this region cannot be changed and
does not display on the Specify Ledger Options page.
• Fiscal Year Start Date is the beginning date of your calendar for the
ledger and cannot be changed once the ledger is saved.
Important
Select a period before the first period you plan to load history or perform
translations to enable running translation. You cannot run translation in the first
defined period of a ledger calendar.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-97
• Period Frequency must be Monthly and is predefined.
Note
If you require a calendar other than monthly, such as 4-4-5 or weekly, define the
calendar in the regular calendar page.
• Adjusting Periods add one or more periods that are used to enter closing,
audit, or other adjustments in the General Ledger at quarter or year end.
The entries are tracked in the adjusting period and not in your monthly
activity.
• Chart of Accounts region is where you enter your segments, segment
labels, short prompts, and display length data that is used to create your
chart of accounts. Plan this data carefully, as you are defining the basic
structure for your accounting and reporting.
• Display Length sets the segment size so select carefully and leave room
for growth. For example, if you have 89 cost centers, enter 3 for the
Display Length to allow for more than 100 cost centers in the future.
• Add Segment Sheets button to create sheets for additional segments.
Only the Company and Natural Account segment sheets are provided.
Note
If you select an intercompany segment, you must complete at least one
intercompany rule and check the Enable Intercompany Balancing option in the
Specify Ledger Options task for the Balancing API to perform intercompany
balancing.
Note
Enter a list of your legal entities. Include their registration number and assigned
parent or child value.
• Parent and Child Values with Descriptions are used to build hierarchies.
Hierarchies are used for chart of accounts mappings, revaluations,
data access sets, cross validation rules, and segment value set rules.
The balances cube and account hierarchies are also used for financial
reporting, Smart View queries, and allocations.
• Account Type is used to identify the type of account, Asset, Liability,
Revenue, Expense, or Owner's Equity. Account types are used in yearend
close processes and to correctly categorize your account balances for
reporting.
• Financial Category (optional) is used to identify groups of accounts for
reporting with Oracle Fusion Transactional Business Intelligence.
Upload the Sheets and Run Deployment
Return to the Chart of Accounts, Calendar, and Ledger sheet after completing the
other sheets complete the following steps:
1. (B) Generate Chart of Accounts File: The program generates an XML
data file for the entered chart of accounts and hierarchies setup data. Save
the file to a network or local drive.
2. (B) Generate Ledger, Legal Entity, and Business Units File: The program
generates an XML data file for the entered ledger, legal entities, and
business unit setup data. Save the file a network or local drive.
3. (N) Setup and Maintenance > Functional Setup Manager > Upload
Chart of Accounts task. The Upload Enterprise Structures process is
launched.
4. (B) Upload File.
5. (B) Browse. Select the first file you saved: ChartOfAccounts.xml
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-99
6. (B) Submit.
7. Verify that the process was completed without errors or warnings.
8. (N) Setup and Maintenance > Deploy Chart of Accounts task > (B)
Deploy the Accounting Flexfield.
9. (I) Refresh until the green check mark appears and verifies that the
deployment is successful.
10. (N) Setup and Maintenance > Upload Ledger, Legal Entities, and
Business Units task. The Upload Enterprise Structures process is
launched.
11. (B) Upload File.
12. (B) Browse. Select the second file you saved:
FinancialsCommonEntities.xml
13. (B) Submit.
14. Verify that the process was completed without errors or warnings.
Tip
You cannot change the chart of accounts, accounting calendar, or currency for
your ledger after the setup is created. Assign the data role that was automatically
generated for the ledger to your users. Then open the first period to begin
entering data.
Scenario
Your company, InFusion Corporation, is a multinational conglomerate that
operates in the United States (US) and the United Kingdom (UK). InFusion
has purchased an Oracle Fusion enterprise resource planning (ERP) solution
including Oracle Fusion General Ledger and all of the Oracle Fusion subledgers.
You are chairing a committee to discuss creation of a model for your global
financial reporting structure including your charts of accounts for both your US
and UK operations.
Analysis
In Oracle Fusion General Ledger, the chart of accounts model is framed around
the concept of a chart of accounts structure, under which one or more chart of
accounts structure instances can be created.
The chart of accounts structure provides the general outline of the chart of
accounts and determines the number of segments, the type, the length, and
the label (qualifier) of each segment. This forms the foundation of the chart of
accounts definition object.
For each chart of accounts structure, it is possible to associate one or more chart
of accounts structure instances. Chart of accounts structure instances under the
same structure share a common configuration with the same segments, in the
same order, and the same characteristics. Using one chart of accounts structure
with multiple instances simplifies your accounting and reporting.
At the chart of accounts structure instance level, each segment is associated with
a value set that conforms to the characteristic of that segment. For example,
you assign a value set with the same segment type and length to each segment.
You are using hierarchies with your chart of accounts segments. Each structure
instance segment is assigned a tree code to indicate the source of the hierarchy
information for the associated value set. The same value set can be used multiple
times within the same or across different chart of accounts instances within the
same structure or in different structures. This functionality reduces your segment
value creation and maintenance across your charts of accounts.
The collective assignment of value sets to each of the segments forms one chart
of accounts instance. At the chart of accounts structure instance level, you can
select to enable dynamic insertion. Dynamic insertion allows the creation of
account code combinations automatically the first time your users enter that new
account combination. The alternative is to create them manually. By deciding to
enable dynamic insertion, you save data entry time and prevent delays caused
by the manual creation of new code combinations. Well defined cross validation
rules help prevent the creation of inappropriate account code combinations.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-101
Creating Chart of Accounts Structure and Instances: Examples
In Oracle Fusion General Ledger, the chart of accounts model is framed around
the concept of a chart of accounts structure, under which one or more chart of
accounts structure instances can be created. A chart of accounts structure defines
the key attributes for your chart of accounts, such as the number of segments, the
segment sequences, the segment names, segment prompts, segment labels, for
example natural account and primary balancing, and default value sets.
The chart of accounts instance is exposed in the user interfaces and processes.
By default, a chart of accounts instance inherits all the attributes of the chart
of accounts structure, meaning that all instances of the same structure share
a common shape and have the same segments in the same order. However,
at the chart of accounts instance level, you can override the default value set
assignments for your segments and assign a unique account hierarchy that
determines the parent and child relationships between the value set values.
At the chart of accounts instance level, determine if allow dynamic insertion is
enabled to generate new account combinations dynamically instead of creating
them manually.
Parameter Value
Segment Code INFUSION_AM_CO
Name InFusion America Company
Description InFusion America Inc. Company
Note
Two segment labels are required: primary balancing segment and natural
account segment. These labels are not used with each other or with other labels
in a specific segment.
Note
By default, an instance inherits the key attributes of the associated structure.
Some attributes, such as the value set assigned to each the segment, can be
modified.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-103
8. Click Save.
9. Optionally, select the segment row and click Edit to modify instance
segments.
10. Check Required, Displayed, and Business intelligence enabled check
boxes.
Note
The Business Intelligence check box is only valid when enabled on segments
with segment labels. Check the Required and Displayed options for all segments
including those intended for future use. The recommended best practice is to
define one segment for future use and set a default value. This ensures room for
expansion in your chart of accounts and that the extra segment is populated in
the account combinations.
Note
Alternatively, proceed directly with creating your value set values by selecting
the corresponding Value Set Code in the Segment Instances table.
Balancing segments ensure that all journals balance for each balancing segment
value or combination of multiple balancing segment values. You can secure
access to your primary balancing segment values only with data access sets. The
general ledger application automatically calculates and creates balancing lines
as required in journal entries. For example, recognizing an entity's receivable
and the other entity's payable. There are three balancing segment labels: primary,
second, and third balancing. The primary balancing segment label is required.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-105
associated with the company dimension of a business organization, two
additional segments of the chart of accounts can be optionally qualified as the
second and third balancing segments respectively. Possible chart of accounts
segments that can be tagged as these additional balancing segments include
cost center or department, additional aspects of a business commonly used in
measuring financial results.
There are several points to consider in using multiple balancing segments:
• Journal entry processing
• Implementation timing
• Change options
• Migration adjustments
Multiple balancing segments ensure that account balances come from journal
entries where the debits equal the credits, and thus, the financial reports are
properly generated for each unique instance of account value combinations
across the balancing segments. Consider this option carefully as it provides more
granular reporting but requires more processing resources.
Implementation Timing
Note
Do not set a segment already qualified as a natural account or intercompany
segment as any of the three balancing segments. Validations are not performed
when segment labels are assigned, so verify that all are assigned correctly before
using your chart of accounts.
Change Options
Once a segment has been enabled and designated as a balancing segment, you
must not change the segment. Do not disable the segment or remove the segment
labels. These settings must be consistently maintained throughout the life of the
chart of accounts to control the accuracy and integrity of the financial data.
Migration Adjustments
For charts of accounts migrated from Oracle E-Business Suite to Oracle Fusion
General Ledger that use a segment with the secondary balance tracking segment
For ledgers associated with a migrated chart of accounts, its balances must
be adjusted manually to be consistent with the second and third balancing
segments as though these segment labels have been in place since the beginning
of entries for these ledgers. This requires recomputing and updating of the
following processes to reflect the correct balancing for each unique combination
of segment values across the additional second and third balancing segments.
• Intercompany balancing
• Suspense posting
Note
All previously translated balances must also be purged, and new translations
run to properly account for translated retained earnings and cumulative
translation adjustments with the correct level of balancing.
Scenario
Your company has a chart of accounts with two balancing segments and three
segments, qualified as follows:
The following multiple company and cost center journal has been entered to
transfer advertising and phone expense from Company 1, Cost Center A to
Company 2, Cost Center B.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-107
Company 1-Cost Center A-Phone 800
Expense Account
Company 2-Cost Center B-Phone 800
Expense Account
During the posting process, the last four lines are created to balance the entry
across the primary and second balancing segments, company and cost center.
To plan for future growth in the business organization that requires additional
segments in the chart of accounts, extra segments can be added to the chart of
accounts structure during your original implementation. Since all segments of
the chart are required and have to be enabled, these unused segments can be
assigned value sets that have a single value in the chart of accounts structure
instance. This value is set as a default for that segment so that the extra segments
are automatically populated when an account code combination is used.
Module Designation
The module designation is used to tag value sets in Oracle Fusion Applications
and sets the value sets apart during upgrades and other processes. Chart
of accounts value sets upgraded from Oracle E-Business Suite Release 12
generically bear the module value of Oracle Fusion Middleware. When creating
new value sets for a chart of accounts, the module can be specified as Oracle
Fusion General Ledger to distinctly identify its intended use in an accounting
flexfield, basically a chart of accounts.
Validation Type
Assign one of the following validation types to chart of accounts value sets:
• Independent: The values are independently selected when filling out the
segment in the account combination.
• Table Validated: The values are stored in an external table to facilitate
maintenance and sharing of the reference data.
Format Assignments
Value sets for chart of accounts must use the Value Data Type of Character.
The Value Subtype is set to Text. These two setting support values that are both
numbers and characters, which are typical in natural account segment values. Set
the maximum length of the value set to correspond to the length of the chart of
accounts segment to which it is assigned. Best practices recommend restricting
values to Upper Case Only or Numeric values that are zero filled by default.
Security Rules
If flexfield data security rules are to be applied to the chart of accounts segment
associated with the value set, the Enable Security check box must be checked
for the assigned value set. In addition, assign a data security resource name to
enable creation of a data security object automatically for the value set. The data
security object is used in the definition of flexfield data security rules.
Value Definition
Once these basic characteristic are defined for the value set, values can be added
to the set in the Manage Values page.
• Set the values to conform to the value set length and type.
• Enter the value, its description, and its attributes including the Enable
check box, Start Date, and End Date.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-109
• Assign the following attributes: Parent or Summary check box, Posting is
allowed, and Budgeting is allowed.
Note
If the value set is used with a natural account segment, the value also requires
you set the Natural Account Type, with one of the following values: Asset,
Liability, Equity, Revenue or Expense. Other attributes used are Third Party
Control Account, Reconciliation indicator, and Financial Category used with
Oracle Transaction Business Intelligence reporting.
Oracle Fusion General Ledger best practice is to define the values for the value
set after the value set is assigned to a chart of accounts structure instance.
Otherwise you are not able to define the mandatory value attributes, such as
summary flag, posting allowed, and account type for natural account segment.
The attributes must be added after the value set is assigned to a chart of accounts
structure instance.
Scenario
You are creating a company value set to be used in your chart of accounts for
your enterprise, InFusion America, Inc. Follow these steps:
1. Navigate to the Manage Chart of Accounts Value Sets task from within
your implementation project and click the Go to Task.
2. Click the Create icon on the toolbar of the Search Results table. The Create
Value Set page opens.
3. Enter a unique Value Set Code, InFusion America Company, and an
optional Description, Company values for InFusion America Inc.
4. Select General Ledger from the list in the Module field.
5. Select Independent as Validation Type.
6. Select Character as the Validation Data Type.
7. Click Save and Close.
Check each of the Chart of Accounts segments' BI enabled check box on all
segments that you intend to map in the RPD by performing the following steps:
Populate the BI Object Name for each of the Segment Labels. This name is the
logical table name in the RPD which would be used as the dimension for the
corresponding segment. Perform the following steps:
Note
For all the non qualified segment labels, the BI Object Name should be
populated with one of the following:
• Dim - GL Segment1
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-111
• Dim - GL Segment2
• Dim - GL Segment3
• Dim - GL Segment4
• Dim - GL Segment5
• Dim - GL Segment6
• Dim - GL Segment7
• Dim - GL Segment8
• Dim - GL Segment9
• Dim - GL Segment10
Deploy the flexfield using the Deploy Flexfield button from Manage Key
Flexfields page.
• Start Date
• Period Frequency
Note
Start Date
If you plan to run translation, specify a calendar start date that is a full year
before the start date of the year of the first translation period for your ledger.
Period Frequency
Use period frequency to set the interval for each subsequent period to occur,
for example, monthly, quarterly, or yearly. If you select the period frequency of
Other, by default, the application generates the period names, year, and quarter
number. You specify the start and end dates. You must manually enter the period
information. For example, select the period frequency of Other and enter 52 as
the number of periods when you want to define a weekly calendar. For manually
entered calendars, when you click the Add Year button, the application creates
a blank year. Then, you must manually enter the periods for the new year. The
online validation helps prevent erroneous entries.
Note
In Oracle Fusion applications a calendar can only have one period frequency
and period type. Therefore, if you have an existing calendar with more than one
period type associated with it, during the upgrade from Oracle E-Business Suite,
separate calendars are created based on each calendar name and period type
combination.
Use the adjusting period frequency to control when the application creates
adjusting periods. For example, some of the frequencies you select add one
adjusting period at year end, two at year end, or one at the end of each quarter.
The default is None which adds no adjusting periods. If you select the frequency
of Other, the Number of Adjusting Periods field is displayed. Enter the number
of desired adjusting periods and then, manually define them.
The User-Defined Prefix field in the Period Name Format region is an optional
feature that allows you to enter your own prefix. For example, define a weekly
calendar and then enter a prefix of Week, - as the separator, and the period name
format of Period numberYY fiscal year. The application creates the names of
Week1-11, Week2-11, through Week52-11. The options for the Format field are
predefined values. The list of values is filtered based on the selected separator
and only displays the options that match the selected separator.
The year displayed in the period names is based on the selected period name
format and the dates the period covers or if the period crosses years, on the year
of the start date of the period. For example, April 10, 2010 to May 9, 2010 has the
period name of Apr-10 and December 10, 2010 to January 9, 2011 has the name
of Dec-10. If period frequency is Other, then the period format region is hidden.
The application generates a temporary period name for calendars with period
frequency of Other, using a fixed format of Period numberYY. You can override
this format with your own customized period names.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-113
Note
Oracle Fusion General Ledger identifies erroneous entries online as you enter
a new calendar or change data on an existing calendar. The application also
automatically validates the data when you save the calendar.
The period naming format determines the year that is appended to the prefix for
each period in the calendar. For the example, your accounting year has a set of
twelve accounting period with a start date of September 1, 2011 and the end date
is August 31, 2012, with each period's date range following the natural calendar
month date range.
Calendar period naming format: Select the calendar period format to append
the period's start date's year to the prefix. For the period covering September 1,
2011 to December 31, 2011, then 2011 or just 11, depending on the period format
selected, is appended to each period's name. For the remaining periods covering
January 1, 2012 to August 31, 2012, then 2012 or 12, is appended to each period's
name.
Fiscal period naming format: Select the fiscal period format to always append
the period's year assignment to the prefix. If the accounting periods in the set of
twelve are all assigned the year of 2012, then 2012 or just 12, depending on the
period format selected, is appended to the period name of all 12 periods.
Update an existing calendar before the new periods are needed as future
periods, based on the future period setting in your accounting configuration.
If a complete year has been defined and validated, use the Add Year button
to add the next year quickly. Accept or change the new rows as required. For
example, with the Other frequency type calendar, dates may differ from what the
application generates.
The migration script assigns a period frequency that most closely matches your
Oracle E-Business Suite Release 12 calendar. When you use the Oracle Fusion
applications Add Year functionality for the first time, you have an opportunity to
review and change the period frequency. The Calendar Options page opens only
for calendars upgraded from Release 12 to allow one time modification.
Make your changes to the period frequency, adjusting period frequency, and
period name format, including the prefix and separator, as needed. Changes can
not conflict with the existing upgraded calendar definition. Update the calendar
name and description in the calendar header, as needed, for all calendars.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-115
Period details for a new year will be generated automatically based on the latest
calendar options. You can also manually update the calendar. The modified
calendar options affect future years only.
Note
Setup tasks that are not related to the ledger or legal entity specific setup tasks
can be invoked from either an implementation project or launched directly from
the Setup and Maintenance work area.
• The Oracle Fusion Accounting Hub offering is used to add the Oracle
Fusion General Ledger and Oracle Fusion Subledger Accounting
application features to an existing enterprise resource planning (ERP)
system to enhance the current reporting and analysis.
• The Oracle Fusion Financials offering, which includes the Oracle Fusion
General Ledger and Oracle Fusion Subledger Accounting application
features, as well as at least one of the subledger financial applications.
Single Ledger
If your subsidiaries all share the same ledger with the parent company
or they share the same chart of accounts and calendar, and all reside on
the same applications instance, you can consolidate financial results in
Oracle Fusion General Ledger in a single ledger. Use Oracle Fusion Financial
Reporting functionality to produce individual entity reports by balancing
segments. General Ledger has three balancing segments that can be combined
to provide detailed reporting for each legal entity and then rolled up to provide
consolidated financial statements.
Multiple Ledgers
Subledgers
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-117
convert your local currency to your parent's ledger currency to report your
consolidated financial results using reporting currencies or translation.
Primary Ledgers
A primary ledger is the main record-keeping ledger. Like any other ledger, a
primary ledger records transactional balances by using a chart of accounts with
a consistent calendar and currency, and accounting rules implemented in an
accounting method. The primary ledger is closely associated with the subledger
transactions and provides context and accounting for them.
Secondary Ledgers
Note
For example, you maintain a secondary ledger for your International Financial
Reporting Standards (IFRS) accounting requirements, while your primary ledger
uses US Generally Accepted Accounting Principles (GAAP). You decided to
select the subledger level for your IFRS secondary ledger. However, since most
of the accounting is identical between US GAAP and IFRS, a better solution is
to use the adjustment only level for your secondary ledger. The subledger level
secondary ledger requires duplication of most subledger journal entries, general
ledger journal entries, and general ledger balances. With the adjustment only
level, your secondary ledger contains only the adjustment journal entries and
balances necessary to convert your US GAAP accounting to the IFRS accounting,
which uses a fraction of the resources that are required by full subledger level
secondary ledger.
Following are scenarios that may require different combinations of primary and
secondary ledgers:
Note
Use the same currency for primary and secondary ledgers to avoid difficult
reconciliations, if you have the resources to support the extra posting time
and data storage. Use reporting currencies or translations to generate the
different currency views needed to comply with internal reporting needs and
consolidations.
Reporting Currencies
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-119
If you need to maintain and report accounting records in different currencies,
you do this by defining one or more reporting currencies for the ledger. There are
three conversion levels for reporting currencies:
• Balance: Only General Ledger balances are converted into the reporting
currency using translation.
Note
Of the three data conversion levels available, the balance data conversion
level is typically the least expensive, requiring duplication of only the balance
level information. The journal and subledger data conversion levels are more
expensive, requiring duplication of most general ledger and subledger journal
entries, as well as general ledger balances.
Note
The second option is rare since most companies have moved beyond the initial
conversion to the EMU currency. However, future decisions could add other
countries to the EMU, and then, this option would again be used during the
conversion stage.
This figure shows the enterprise structure components and their relationships to
each other. Primary ledgers are connected to reporting currencies and secondary
ledgers to provide complete reporting options. Legal entities are assigned to
ledgers, both primary and secondary, and balancing segments are assigned to
legal entities. Business units must be connected to both a primary ledger and a
default legal entity. Business units can record transactions across legal entities.
Primary Ledgers
A primary ledger is the main record-keeping ledger. Create a primary ledger
by combining a chart of accounts, accounting calendar, ledger currency,
and accounting method. To determine the number of primary ledgers, your
enterprise structure analysis must begin with determining financial, legal, and
management reporting requirements. For example, if your company has separate
subsidiaries in several countries worldwide, create multiple primary ledgers
representing each country with the local currency, chart of accounts, calendar,
and accounting method to enable reporting to each country's legal authorities.
If your company just has sales in different countries, with all results being
managed by the corporate headquarters, create one primary ledger with
multiple balancing segment values to represent each legal entity. Use secondary
ledgers or reporting currencies to meet your local reporting requirements, as
needed. Limiting the number of primary ledgers simplifies reporting because
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-121
consolidation is not required. Other consideration such as corporate year end,
ownership considerations, and local government regulations, also affect the
number of primary ledgers required.
Secondary Ledgers
A secondary ledger is an optional ledger linked to a primary ledger. A secondary
ledger can differ from its related primary ledger in chart of accounts, accounting
calendar, currency, accounting method, or ledger processing options. Reporting
requirements, for example, that require a different accounting representation to
comply with international or country-specific regulations, create the need for a
secondary ledger.
Below are scenarios and required action for different components in primary and
secondary ledgers:
Note: Journal conversion rules, based on the journal source and category, are
required to provide instructions on how to propagate journals and types of
journals from the source ledger to the secondary ledger.
Reporting Currencies
Reporting currencies are the currency you use for financial, legal, and
management reporting. If your reporting currency is not the same as your ledger
currency, you can use the foreign currency translation process or reporting
currencies functionality to convert your ledger account balances in your
reporting currency. Currency conversion rules are required to instruct the
system on how to convert the transactions, journals, or balances from the source
representation to the reporting currency.
Legal Entities
Legal entities are discrete business units characterized by the legal environment
in which they operate. The legal environment dictates how the legal entity
should perform its financial, legal, and management reporting. Legal entities
generally have the right to own property and the obligation to comply with
labor laws for their country. They also have the responsibility to account for
themselves and present financial statements and reports to company regulators,
taxation authorities, and other stakeholders according to rules specified in the
relevant legislation and applicable accounting standards. During setup, legal
Balancing Segments
You assign primary balancing segment values to all legal entities before
assigning values to the ledger. Then, assign specific primary balancing segment
values to the primary and secondary ledgers to represent nonlegal entity related
transactions such as adjustments. You can assign any primary balancing segment
value that has not already been assigned to a legal entity. You are allowed to
assign the same primary balancing segment values to more than one ledger. The
assignment of primary balancing segment values to legal entities and ledgers
is performed within the context of a single accounting setup. The Balancing
Segment Value Assignments report is available to show all primary balancing
segment values assigned to legal entities and ledgers across accounting setups to
ensure the completeness and accuracy of their assignments. This report allows
you to quickly identify these errors and view any unassigned values.
Business Units
A business unit is a unit of an enterprise that performs one or many business
functions that can be rolled up in a management hierarchy. When a business
function produces financial transactions, a business unit must be assigned
a primary ledger, and a default legal entity. Each business unit can post
transactions to a single primary ledger, but it can process transactions for many
legal entities. Normally, it will have a manager, strategic objectives, a level of
autonomy, and responsibility for its profit and loss. You define business units as
separate task generally done after the accounting setups steps.
Transactions are exclusive to business units. In other words, you can use
business unit as a securing mechanism for transactions. For example, if you
have an export business that you run differently from your domestic business,
use business units to secure members of the export business from seeing the
transactions of the domestic business.
Create a primary ledger as your main record-keeping ledger. Like any other
ledger, a primary ledger records transactional balances by using a chart of
accounts with a calendar, currency, and accounting rules implemented in an
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-123
accounting method. The primary ledger is closely associated with the subledger
transactions and provides context and accounting for them.
Scenario
Your company, InFusion Corporation is implementing Oracle Fusion
Applications. You have been assigned the task of creating a primary ledger for
your InFusion America entity.
Field Value
Name InFusion America
Description InFusion America primary ledger for
recording transactions.
Chart of Accounts InFusion America Chart of Accounts
Accounting Calendar Standard Monthly
Currency USD
Accounting Method Standard Accrual
4. Click Save and Edit Task List to navigate back to the accounting
configuration task list.
Note
You cannot change the chart of accounts, accounting calendar, or currency for
your ledger after you save your ledger.
This example demonstrates specifying the ledger options for your primary
ledger. Your company, InFusion Corporation, is a multinational conglomerate
that operates in the United States (US) and the United Kingdom (UK). InFusion
has purchased an Oracle Fusion enterprise resource planning (ERP) solution
including Oracle Fusion General Ledger and all of the Oracle Fusion subledgers.
After completing your InFusion America Primary Ledger, select Specify Ledger
Options under the Define Accounting Configuration task list on the Functional
Setup Manager page.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-125
Option Setting
Enable Suspense General Ledger
Default Expense Account 101-00-98199999-0000-000-0000-0000
Rounding Account 101-10-98189999-0000-000-0000-0000
Entered Currency Balancing Account 101-10-98179999-0000-000-0000-0000
Balancing Threshold Percent 10
Option Description
Enable journal approval Click to enable journal approval
functionality. Approval rules must be
created in the Oracle Fusion Approvals
Management (AMX).
Notify when prior period journal Notify the user when a prior period
date is selected on a journal entry.
Allow mixed and statistical journals Enter both monetary and statistical
amounts on the same line in a journal
entry.
Validate reference date Requires a reference date in an open or
future enterable period.
3. Click the Separate journals by accounting date during journal import for
the Import option to create individual journal entries for each accounting
date.
4. For the Reversal options, select InFusion America Accrual Set from the
list of values in the Journal Reversal Criteria Set field and click the
Launch AutoReverse after open period to reverse accrual journal entries
automatically when a new period is opened.
5. Click the Enable intercompany accounting for the Intercompany option
to enable automatic balancing by the application for primary, second,
and third balancing segments (if implemented) on intercompany journal
entries and transactions.
To avoid data corruption, your cumulative adjustment account (CTA) can only
be changed if you first perform the following set of steps:
To avoid data corruption, your retained earnings account can only be changed if
you first perform the following set of steps:
• Enter and post journals to bring the ending balances for your income
statement accounts to zero at the end of each accounting year
• Reverse the journal entries use to bring the ending account balances to
zero and rerun translation
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-127
2. Select the balancing segment value.
3. Optionally enter a start date.
4. Click Save and Close.
Note
The balancing segment values that are assigned to the ledger represent nonlegal
entity transactions, such as adjustments. If you use legal entities, you must
assign balancing segment values to all legal entities before assigning values to
the ledger. The only available balancing segment values that can be assigned to
ledgers are those not assigned to legal entities.
Business units process transactions using reference data sets that reflect your
business rules and policies and can differ from country to country. With Oracle
Fusion Application functionality, you can choose to share reference data, such as
payment terms and transaction types, across business units, or you can choose to
have each business unit manage its own set depending on the level at which you
wish to enforce common policies.
• Management reporting
• Processing of transactions
Business Functions
A business function represents a business process, or an activity that can be
performed by people working within a business unit and describes how a
business unit is used. The following business functions exist in Oracle Fusion
applications:
• Collections management
• Customer payments
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-129
• Expense management
• Incentive compensation
• Marketing
• Materials management
• Inventory management
• Payables invoicing
• Payables payments
• Procurement
• Project accounting
• Receiving
• Requisitioning
• Sales
Note
This hierarchy definition is not required in the setup of your applications, but is
a recommended best practice.
In other cases, where your managers have a responsibility for the assets of the
business unit, a balance sheet can be produced. The recommended best practice
to produce a balance sheet, is to setup the business unit as a balancing segment
in the chart of accounts. The business unit balancing segment can roll up to
divisions or other entities to represent your enterprise structure.
• Collections management
• Customer payments
• Expense management
• Materials management
• Payables invoicing
• Project accounting
• Receiving
• Requisitioning
The InFusion Air Systems division further segments your business into the
System Components and Installation Services subdivisions. Your subdivisions
are divided by business units:
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-131
Hierarchies created using the management segment can provide the divisional
results. For example, it is possible to define management segment values to
correspond to business units, and arrange them in a hierarchy where the higher
nodes correspond to divisions and subdivisions, as in the Infusion US Division
example above.
The setup options available for the Contract Terms Library are applicable
to both customer and supplier contracts, and are described in the business
unit setup topic for the Contract Terms Library. That topic is available as a
related link to this topic.
Project billing can behave differently for external contracts (customer billing) or
intercompany and interproject contracts (internal billing).
There are two sets of the following options, one for customer billing and a
second for internal billing:
You can specify a wide variety of Contract Terms Library settings for either
customer or supplier contracts within each business unit, by using either the
Specify Customer Contract Management Business Function Properties or the
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-133
Specify Supplier Contract Management Business Function Properties tasks.
These tasks are available by navigating to the Setup and Maintenance work area
and searching on the task name.
For the Contract Terms Library in each business unit, you can:
• Specify the layout for printed clauses and contract deviation reports.
If you are implementing the adoption feature, then you can have all the
global clauses in the global business unit automatically approved and
available for use in the local business by selecting the Autoadopt Global
Clauses option. If you do not select this option, the employee designated
as the Contract Terms Library Administrator must approve all global
clauses before they can be adopted and used in the local business unit.
This option is available only for local business units.
You can choose to display the clause number in front of the clause title in
contracts by selecting the Display Clause Number in Clause Title option.
You must select the Enable Contract Expert option to be able to use the Contract
Expert feature in a business unit. This setting takes precedence over enabling
Contract Expert for individual contract terms templates.
Enter the RTF file you want used for formatting the printed clauses in the
Clause Layout Template field.
The RTF file you select as the Deviations Layout Template determines the
appearance of the contract deviations report PDF. This PDF is attached to
the approval notification sent to contract approvers.
Locations: Explained
A location identifies physical addresses of a workforce structure, such as a
department or a job. You can also create locations to enter the addresses of
external organizations that you want to maintain, such as employment agencies,
tax authorities, and insurance or benefits carriers.
The locations that you create exist as separate structures that you can use for
reporting purposes, and also in rules that determine employee eligibility for
various types of compensation and benefits. You enter information about a
location only once. Subsequently, when you set up other workforce structures
you select the location from a list.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-135
Location Sets
When you create a location, you must associate it with a set. Only those users
who have access to the set's business unit can access the location set and other
associated workforce structure sets, such as those that contain departments and
jobs.
You can also associate the location to the common set so that users across your
enterprise can access the location irrespective of their business unit. When users
search for locations, they can see the locations that they have access to along with
the locations in the common set.
The following figure shows how locations sets restrict access to users.
You can search for approved locations only. Also, if you created a location in
Oracle Fusion Trading Community Model, then you can't access that location
from Oracle Fusion Global Human Resources. For use in Oracle Fusion HCM,
you must recreate the location from the Manage Locations page.
From the Manage Locations page in Oracle Fusion Global Human Resources.
The calendar events that were created for the geographical node start to apply
for the location and may impact the availability of worker assignments at
that location. The geographical hierarchy nodes available for selection on the
Locations page display from a predefined geographic hierarchy.
Starting from the effective date that you entered, you can no longer associate
the location with other workforce structures, assignments, or applications. If the
location is already in use, it will continue to be available to the components that
currently use it.
Division: Explained
Managing multiple businesses requires that you segregate them by their strategic
objectives and measure their results. Responsibility to reach objectives can be
delegated along the management structure. Although related to your legal
structure, the business organizational hierarchies do not need to reflect directly
the legal structure of the enterprise. The management entities and structure can
include divisions and subdivisions, lines of business, and other strategic business
units, and include their own revenue and cost centers. These organizations can
be included in many alternative hierarchies and used for reporting, as long as
they have representation in the chart of accounts.
Divisions
A division refers to a business oriented subdivision within an enterprise, in
which each division organizes itself differently to deliver products and services
or address different markets. A division can operate in one or more countries,
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-137
and can be comprised of many companies or parts of different companies that
are represented by business units.
A division is a profit center or grouping of profit and cost centers, where the
division manager is responsible for attaining business goals including profit
goals. A division can be responsible for a share of the company's existing
product lines or for a separate business. Managers of divisions may also have
return on investment goals requiring tracking of the assets and liabilities of the
division. The division manager reports to a top corporate executive.
This example shows how to restructure your enterprise after acquiring a new
division.
Scenario
You are part of a senior management team at InFusion Corporation. InFusion
is a global company with organizations in the United States (US), the United
Kingdom (UK), France, China, Saudi Arabia, and the United Arab Emirates
(UAE). Its main area of business is in the high tech industry, and it has just
acquired a new company. You must analyze their current enterprise structure
and determine what new organizations you need to create to accommodate the
new company.
Analysis
The following table summarizes the key decisions that you must consider
when determining what new organizations to set up and how to structure the
enterprise.
Note
Create legislative data group? Yes. Because you currently do not employ or pay
people in Germany, you must create one legislative
data group to run payroll for the workers in
Germany.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-139
Based on the analysis, you must create the following:
A cost center represents the smallest segment of an organization for which costs
are collected and reported. A department is an organization with one or more
operational objectives or responsibilities that exist independently of its manager
and has one or more workers assigned to it.
• Cost centers
• Departments
Cost Centers
A cost center is generally attached to a single legal entity. To identify the cost
centers within a chart of accounts structure use one of these two methods:
• Assign a cost center value in the value set for each cost center.
For example, assign cost center values of PL04 and G3J1 to your
manufacturing teams in the US and India. These unique cost center values
allow easy aggregation of cost centers in hierarchies (trees) even if the
cost centers are in different ledgers. However, this approach will require
defining more cost center values.
The cost center value of PL04 has a consistent meaning. This method
requires fewer cost center values to be defined. However, it prevents
construction of cost center hierarchies using trees where only cost center
values are used to report results for a single legal entity. You must specify
a balancing segment value in combination with the cost center values to
report on a single legal entity.
Departments
Note
The manager of a sales department may also be responsible for meeting the
revenue targets.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-141
The financial performance of departments is generally tracked through one
or more cost centers. In Oracle Fusion Applications, departments are defined
and classified as Department organizations. Oracle Fusion Human Capital
Management (HCM) assigns workers to departments, and tracks the headcount
at the departmental level.
Project Organization
Cost Organization
A job family is a group of jobs that have different but related functions,
qualifications, and titles. They are beneficial for reporting. You can define
competencies for job families by associating them with model profiles.
A job set is an organizational partition of jobs. For example, a job set can be
global and include jobs for use in all business units, or it can be restricted to jobs
for a specific country or line of business. When you select a job, for a position or
an assignment, the available jobs are those in the set associated with the business
unit in which you are working, and also those in the Common set.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-143
What's the difference between a job set and a job family?
A job family is a group of jobs that have different but related functions,
qualifications, and titles. They are beneficial for reporting. You can define
competencies for job families by associating them with model profiles.
A job set is an organizational partition of jobs. For example, a job set can be
global and include jobs for use in all business units, or it can be restricted to jobs
for a specific country or line of business. When you select a job, for a position or
an assignment, the available jobs are those in the set associated with the business
unit in which you are working, and also those in the Common set.
Jobs: Explained
As part of your initial implementation, you specify whether to use jobs and
positions, or only jobs. Jobs are typically used without positions by service
industries where flexibility and organizational change are key features.
Basic Details
Basic details for a job include an effective start date, a job set, a name, and a code.
A job code must be unique within a set. Therefore, you can create a job with the
code DEV01 in the US set and another job with the same code in the UK set.
However, if you create a job with the code DEV01 in the Common set, then you
cannot create a job with the same code in any other set.
Benchmark Information
You can identify a job as being a benchmark job. A benchmark job represents
other jobs in reports and salary surveys. You can also select the benchmark for
jobs. Benchmark details are for informational purposes only. A progression job is
the next job in a career ladder.
Progression Information
Progression jobs enable you to create a hierarchy of jobs and are used to provide
the list of values for the Job field in the Promote Worker and Transfer Worker
tasks. The list of values includes the next three jobs in the progression job
hierarchy. For example, assume that you create a job called Junior Developer and
select Developer as the progression job. In the Developer job, you select Senior
Developer as the progression job. When you promote a junior developer, the list
of values for the new job will include Developer and Senior Developer. You can
select one of these values, or select another one.
Jobs: Example
Jobs are typically used without positions by service industries where flexibility
and organizational change are key features.
Software Industry
For example, XYZ Corporation has a director over the departments for
developers, quality assurance, and technical writers. Recently, three developers
have left the company. The director decides to redirect the head count to other
areas. Instead of hiring all three back into development, one person is hired to
each department, quality assurance, and technical writing.
In software industries, the organization is fluid. Using jobs gives an enterprise
the flexibility to determine where to use head count, because the job only exists
through the person performing it. In this example, when the three developers
leave XYZ Corporation, their jobs no longer exist, therefore the corporation has
the flexibility to move the headcount to other areas.
This figure illustrates the software industry job setup.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-145
Search Relevance Profile Options: Explained
The strength of the relationship between the person performing a gallery search
and each person whose assignment appears in the search results can determine
the order of the results: the stronger the relationship, the closer to the top of the
results an assignment appears. The search relevance profile options control how
the strength of the relationship between the searcher and the search result is
calculated.
The default value of each weighting profile option is 0.5. To increase the
relevance of a factor relative to other factors, you increase its weighting; to
decrease its relevance, you reduce its weighting.
Common Applications Configuration: Define Enterprise Structures for Project Financial Management 5-147
5-148 Oracle Fusion Applications Project Financial Management Implementation Guide
6
Common Applications Configuration:
Define Project Organizations
Define Project Units and Organizations
Setting Up Organizations for Oracle Fusion Projects: Worked
Example
This example describes the creation of three organizations for use in Oracle
Fusion Projects. One organization is the project unit, the second organization
can own projects and tasks, and the third organization can incur project
expenditures. This example also describes the selection of the organization
hierarchy type that controls the hierarchies that can be assigned to business
units, and the association of project units and organizations to business units.
The following table summarizes key decisions for this scenario.
Project Services
Field Value
Create new Selected
Code PROJECT_OPS
Name Project Operations
Field Value
Classify as Project Task Owning Selected
Organization
Allow indirect projects Selected
Note
For organizations that can own capital contract projects, select the options
to allow projects enabled for capitalization and enabled for billing
options.
4. Select Save and Close, then proceed to the next step to specify a project
expenditure organization.
5. In the Search: Organization region of the Manage Project Organization
Classifications page, enter the name Fusion Corporation and click Search.
6. In the Search Results: Organization region, select the Fusion Corporation
row and click Edit.
7. In the Change All Selected region of the Edit Project Organization
Classifications page, complete the field, as shown in this table.
Field Value
Classify as Project Expenditure Selected
Organization
Important
The organization hierarchy type that you select for Oracle Fusion Projects
in this step must be the same organization hierarchy type that is set
up in Oracle Fusion Human Capital Management for Oracle Fusion
applications.
Field Value
Available Asset Organization
Business Unit
Partner Organization
3. Click the right arrow to move the selected items to the Selected column.
To select multiple organizations, hold down the control key as you select
the desired organizations, then click the right arrow.
Selecting Organization Hierarchies for the Business Unit
Associate project and task owning organizations to the business unit to restrict
the project owning organizations in the project creation flow. Associate project
expenditure organizations to the business unit to restrict which organizations
can incur costs on the project. Specify an entire organization hierarchy to
associate with the business unit by selecting the top node on the tree, rather
than individually associating organizations with the business unit. Specify part
of an organization hierarchy by selecting an organization at any level of the
hierarchy as the starting node on the tree. Oracle Fusion Projects associates all
organizations in the hierarchy from the starting node down with the business
unit.
Note
The following conditions are required for an organization to be eligible to be a
project and task owning organization:
• You must assign the Project and Task Owning Organization classification
to the organization.
• The organization must belong to the hierarchy that you specify in the
project implementation options for the business unit.
The following conditions are required for an organization to be eligible to be a
project expenditure organization:
• You must assign the Project Expenditure Organization classification to the
organization.
• The organization must belong to the hierarchy that you specify in the
project implementation options for the business unit.
Field Value
Tree Name Corporate Tree Structure
Tree Version Name Corporate Tree Structure Version 1
Organization Project Operations
Field Value
Tree Name Corporate Tree Structure
Tree Version Name Corporate Tree Structure Version 1
Organization Corporate Operations
Field Value
Available Project Units Project Services
Project Manufacturing
Project Operations
4. Click the right arrow to move the selected items to the Selected Project
Units column.
5. Click Save and Close.
Note
What transactions should I include in project Cost, commitment, and budget and forecast
performance data summarization? transactions
Note
For each project unit, you configure project management settings such as the
default set assignment, project numbering series, full-time equivalent hours,
related business units, and reporting options.
Prerequisites
This example is based on the assumption that the following prerequisite setup
tasks are complete:
1. Set up organization hierarchies, organization classifications, and
organizations.
2. Enable the Project Accounting business unit function for all project
business units.
3. Classify organizations as project units.
Field Value
Default Set ENTERPRISE
Project Numbering - Method Manual
Project Numbering -Type Alphanumeric
Full-Time Equivalent Hours -Daily 8
Full-Time Equivalent Hours -Weekly 40
Field Value
Available Business Units Corporate Enterprise
Corporate Manufacturing
3. Click the right arrow to move the selected business units to the Selected
column.
To select multiple items, press the control key while you select the desired
business units, then click the right arrow.
Defining Project Unit Summarization Options
Specify which transaction amounts are summarized for display on project
performance reports and whether to automatically summarize the data when
a transaction is created. Specify which commitment types and statuses are
summarized for display on project performance reports. Select the currency
and calendar types to summarize and display financial information on project
performance reports.
1. Click Next on the Manage Project Units: Related Business Units page.
2. On the Summarization Options tab, Data Sources region, complete the
fields, as shown in this table.
4. In the Currency Types region, complete the fields, as shown in this table.
Field Value
Project currency Selected
Transaction currency Not selected
Project ledger currency Selected
5. In the Calendar Types region, complete the fields, as shown in this table.
Field Value
Project accounting calendar Selected
Accounting calendar Selected
Field Value
Basis Period start date
Field Value
Currency Type Project currency
Calendar Type Accounting
Effort Unit of Measure Hours
Project Accounting Period Current period
Field Value
Track key performance indicators Selected
Generate key performance indicators Not selected
Summarize project data Selected
Field Value
Track missing time Selected
Number of Prior Weeks 3
Include current week Selected
Comparison Period in Days 35
3. In the Missing Time Sources region, complete the field, as shown in this
table.
After you run summarization, the KPI related information is rendered out of
date with respect to the latest summarized information. Therefore, it is important
that you generate KPI values once the summarization process is completed. You
can avoid generating KPI values manually, by enabling automatic generation of
KPI values in the summarization options.
• Delete and resummarize, for correcting summary data when the source
system data is changed outside the regular transaction flow.
• Your data is corrupt and you want to delete the existing data and
resummarize.
• You have a large volume of data that is not yet summarized and want to
summarize the entire bulk of data in one run.
After you select the parameters for summarization and submit a request, the
application performs the following steps to generate the data that you view in
the application:
• Load data into Essbase and merge data into summary tables.
You can track the progress of summarization on the process monitor. If the
process fails to complete, it continues from the point of failure when you
resubmit it.
Oracle Fusion Projects employs two set determinants: business unit and project
unit.
Business unit is a set determinant for the following project-related reference data
objects.
You assign a default set to each business unit. You can optionally override the
default set for the Project Accounting Definition and Project Rates reference
data objects. To enable a project type or rate schedule for use within the business
unit, you must assign the same reference data set to that entity.
Note
If you assign a common set to a rate schedule, then that rate schedule is available
for use across business units.
When specifying project unit implementation options, you select a default set.
You can optionally override the default set for the Project Definition and Project
Transaction Types reference data objects. To enable an entity like a financial plan
type for use on projects owned by a project unit, assign the set associated with
the Project Definition reference data object to the financial plan type.
Similarly, to enable expenditure types and work types for use on projects owned
by a project unit, assign the set associated with the Project Transaction Types
reference data object to those entities.
Note
• Project Units
• Consulting
• Real Estate
Set assignments for reference data objects, where project unit is the set
determinant, are as follows:
Note
The default set is used as the reference data set for both the Project Definition
and Project Transaction Types reference data objects.
Vision Corporation can maintain independent setup data for each project unit,
while sharing a single approach to financial management across all project units.
For example, Vision Corporation uses different expenditure types across project
units, as described in the table below.
The Labor expenditure type can be used for projects belonging to any project
unit. However, expenditure types for airfare and hotel accommodation are used
only on consulting projects.
• Business Units
• InFusion Canada
These set assignments govern how planned and actual amounts are calculated
for projects.
You can associate a business unit with a project unit during the Related Business
Units step of the Manage Project Units setup task if the business unit is already
configured using the Configure Project Accounting Business Function setup task.
If the business unit is not configured, then you can associate a project unit with
the business unit on the Project Units tab of the Configure Project Accounting
Business Function page.
What happens if I change the organization hierarchy type that is available for
project applications?
Important
The organization hierarchy type used in Oracle Fusion Projects must be the
same organization hierarchy type that is set up in Oracle Fusion Global Human
Resources for Oracle Fusion applications.
The business unit implementation options for project and task owning
organizations and project expenditure organizations may become invalid. A
Organization hierarchies help you manage expenditure and reporting data, and
coordinate the project-owning organizations in your enterprise.
During implementation, you select the organization hierarchy type for use in
Oracle Fusion Projects, either the department hierarchy tree structure or the
generic organization hierarchy tree structure. Then you assign hierarchies to the
project implementation options for each business unit used in Oracle Fusion
Projects.
Important
The organization hierarchy type used in Oracle Fusion Projects must be the
same organization hierarchy type that is set up in Oracle Fusion Global Human
Resources for Oracle Fusion applications.
The automatic method of project numbering requires that you set up the first
project number during project unit configuration, and then the application
automatically assigns an incremental project number at project creation.
What's the difference between the project unit organization code and name?
Typically the project unit name is logical, descriptive, and easily recognizable.
Both the project unit organization code and name are used to identify the project
unit.
Certain financial plan types are included in summarization by default, while you
must manually select others. Approved forecast and baseline budget versions of
the following financial plan types are automatically included in summarization
of project performance data:
Apart from the default financial plan types, you can include up to four others in
summarization of project performance data.
What happens when I select a planning amount allocation basis for the project
unit?
The Period Start Date option allocates amounts based on the period start
date. The Period End Date option allocates amounts based on the period end
date. The Daily Proration option spreads plan amounts evenly across the plan
duration.
Business units are subsets of an enterprise that perform one or more business
functions and can be consolidated in both a managerial and legal hierarchy.
Project accounting is an example of a business function that is set up by business
unit. Other examples are billing and revenue management, customer contract
management, and payables invoicing.
Business units are defined centrally. During implementation, you must enable
the Project Accounting business unit for use with Oracle Fusion Projects.
You can partition financial data using business units while sharing a single
approach to project management across all business units. The following
diagram shows two business units, one from the United Kingdom (UK) and one
from the United States (US). These business units have the same research and
development processes, so a single project unit is used by both business units to
facilitate common project management practices.
Project Setup
Following are project setup options for each business unit that you enable for use
with Oracle Fusion Projects.
• Project and task owning organization name, tree name, and tree version
name.
Note
Note
A project can be associated with only one business unit.
Project Expenditure
Following are business unit project expenditure implementation options.
• Day of the week when the expenditure cycle begins.
• Project expenditure organizations to associate with the business unit to
restrict which organizations can incur costs on the project.
Project Costing
Following are business unit project costing implementation options.
• Project accounting calendar, either the default project accounting calendar
from primary ledger calendar, or a different calendar to assign to the
business unit. You can change this calendar until you copy the project
accounting periods.
• Default asset book for assets in the business unit. The asset initiator can
select a different asset book for the asset.
• Option to use either common accounting and project accounting periods,
or unique project accounting periods.
• Overtime calculations option.
• Asset retirement processing option to capture and record the cost of
removal and the proceeds of sale amounts for retiring an asset.
• Separation of duties option for entering and releasing expenditure batches
to ensure accuracy and accountability of project costs.
• Conversion rate type to use when converting the amount on cost
transactions in this business unit from the transaction currency to the
ledger currency.
Project Units
Project units are associated with business units to restrict the business units
that can handle project transactions. When a project unit is not associated
with a business unit, any business unit in your enterprise can process project
transactions.
Cross-Charge Transactions
Following are business unit cross-charge transaction implementation options.
• Transfer price currency conversion rate date type and rate type for the
business unit.
If you want to report project information with the same frequency as the
accounting periods, you can use the accounting period as both the accounting
and project accounting period.
When you maintain common accounting and project accounting periods, period
maintenance is simplified, calendar periods are not copied to Oracle Fusion
Defining Project Accounting Periods that are Different from Accounting Periods
If you want to account for project transactions and report project information
more frequently than the accounting periods allow, you can define project
accounting periods that are shorter than the accounting periods. For example,
you can define weekly project accounting periods and monthly accounting
periods, as shown in the following diagram.
Use Oracle Fusion General Ledger to maintain accounting period statuses and
run the processes to open and close accounting periods, and Oracle Fusion
Projects to maintain project accounting period statuses and run the processes to
open and close project accounting periods.
How can I set up project accounting periods that are different from accounting
periods?
Complete these tasks to set up project accounting periods that are different from
accounting periods.
• Copy the accounting calendar into the project accounting period table,
which copies the period start and end dates.
Project accounting periods are used to track budgets and forecasts, summarize
project amounts for reporting, and track project status. Project accounting
periods are maintained by business unit. You can set up project accounting
periods to track project periods on a more frequent basis than accounting
periods. For example, you can define weekly project accounting periods and
monthly accounting periods. If you use the same calendar as your accounting
periods, the project accounting periods and accounting periods will be the same,
although the statuses are maintained independently.
Accounting periods, which are used to derive accounting dates, are maintained
by ledger and use the same calendar as the general ledger periods. Period
statuses for the accounting period and general ledger period are maintained
independently.
Note
You can select an option on the business unit definition to maintain common
accounting and project accounting periods. This option allows the accounting
period to be used as the project accounting period so you need to maintain only
one period status.
You cannot enter any transactions in the period you have closed and you can
adjust transactions in subsequent periods.
You can associate a business unit with a project unit during the Related Business
Units step of the Manage Project Units setup task if the business unit is already
configured using the Configure Project Accounting Business Function setup task.
Note
Security setup and administration tasks typically use integrated user interface
pages that are provided by the following products.
• Oracle Identity Manager (OIM)
• Oracle Authorization Policy Manager (APM)
• Oracle Fusion Human Capital Management (HCM) products
• Oracle Application Access Control Governor (AACG) in Oracle Enterprise
Governance, Risk and Compliance (GRC)
Common Applications Configuration: Define Security for Project Financial Management 7-1
organization and assign it to the IT Security Manager role. Refer to the
Oracle Fusion Middleware User's Guide for Oracle Identity Manager.
See: User Management Tasks
• Create users. Refer to the Oracle Fusion Middleware User's Guide for
Oracle Identity Manager.
Common Applications Configuration: Define Security for Project Financial Management 7-3
• Since security in Oracle Fusion Applications is based on integrations
with Oracle Identity Management in Fusion Middleware, security
features in the database, and Oracle Enterprise Governance, Risk and
Compliance (GRC), additional resources in support of performing
security tasks include the following.
• Authorization Policy Manager (APM) is available in Oracle Fusion
Applications through integration with Oracle Identity Management
(OIM). Authorization policy management involves managing
duty roles, data role templates, and data security policies. Refer
to the Oracle Fusion Middleware Authorization Policy Manager
Administrator's Guide (Oracle Fusion Applications Edition).
See: Getting Started With Oracle Authorization Policy Manager
• Oracle Identity Management (OIM) is available in Oracle Fusion
Applications through integration with Oracle Fusion Middleware.
Identity management in Oracle Fusion Application involves creating
and managing user identities, creating and linking user accounts,
managing user access control through user role assignment,
managing enterprise roles, and managing workflow approvals and
delegated administration.
See: Oracle Fusion Middleware User's Guide for Oracle Identity
Manager
• Oracle Fusion Applications is certified to integrate with Applications
Access Controls Governor (AACG) in the Oracle Enterprise
Governance, Risk and Compliance (GRC) suite to ensure effective
segregation of duties (SOD).
See: Oracle Application Access Controls Governor Users Guide
See: Oracle Application Access Controls Governor Implementation
Guide
• Configure and manage auditing. Refer to the Oracle Fusion Middleware
Application Security Guide.
See: Configuring and Managing Auditing
If legacy employees, contingent workers, and their assignments exist, the HCM
Application Administrator imports these definitions by performing the Initiate
HCM Spreadsheet Load task. If user and role provisioning rules have been
defined, the Initiate HCM Spreadsheet Load process automatically creates user
and role provisioning requests as the workers are created.
Once the enterprise is set up, performing the Initiate HCM Spreadsheet Load
task populates the enterprise with HR workers in records linked by global user
ID (GUID) to corresponding user accounts in the LDAP store. If no user accounts
exist in the LDAP store, the Initiate HCM Spreadsheet Load task results in new
user accounts being created. Worker email addresses as an alternate input for
the Initiate HCM Spreadsheet Load task triggers a search of the LDAP for user
GUIDs, which may perform more slowly than entering user names.
In the security reference implementation, the HCM Application Administrator
job role hierarchy includes the HCM Batch Data Loading Duty role, which
is entitled to import worker identities. This entitlement provides the access
necessary to perform the Initiate HCM Spreadsheet Load task in HCM.
Note
The Import Person and Organization task in the Define Trading Community
Import activity imports the following resources, creates users, and links the
resources to users for use in CRM.
• Internal employees
• Contingent workers
• External partner contacts
• Partner companies
• Legal entities
• Customers
• Consumers
If role provisioning rules have been defined, the Import Person and Organization
task automatically provisions role requests as the users are created.
Import Users
If legacy users (identities) and user accounts exist outside the LDAP store that
is being used by the Oracle Fusion Applications installation, the IT security
manager has the option to import these definitions to the LDAP store by
performing the Import Worker Users and Import Partner Users tasks.
Common Applications Configuration: Define Security for Project Financial Management 7-5
If no legacy users or user accounts can be imported or exist in an LDAP
repository accessible to Oracle Identity Management (OIM), the IT security
manager creates users manually in OIM or uses the Initiate HCM Spreadsheet
Load task to create users from imported HR workers.
Once users exist, their access to Oracle Fusion Applications is dependent on
the roles provisioned to them in OIM or Human Capital Management. Use the
Manage HCM Role Provisioning Rules task to define rules that determine what
roles are provisioned to users.
Job and abstract roles are managed in OIM. This task includes creating and
modifying job and abstract roles, but not managing role hierarchies of duties for
the jobs.
Note
Manage Job Roles does not include provisioning job roles to users. Provisioning
users is done in OIM, HCM, CRM or Oracle Fusion Supplier Portal.
Roles control access to application functions and data. Various types of roles
identify the functions performed by users.
The Oracle Fusion Applications security reference implementation provides
predefined job and abstract roles. In some cases, the jobs defined in your
enterprise may differ from the predefined job roles in the security reference
implementation. The predefined roles and role hierarchies in Oracle Fusion
may require changes or your enterprise may require you to create new roles.
For example, you need a job role for a petty cash administrator, in addition to
an accounts payable manager. The security reference implementation includes
a predefined Accounts Payable Manager, and you can create a petty cash
administrator role to extend the reference implementation.
In the security reference implementation, the IT Security Manager job role
hierarchy includes the Enterprise Role Management Duty role, which is entitled
to manage job and abstract roles (the entitlement is Manage Enterprise Role).
This entitlement provides the access necessary to perform the Manage Job Roles
task in OIM.
Manage Duties
A person with a job role must be able to perform certain duties. In the Oracle
Fusion Applications security reference implementation, enterprise roles inherit
Tip
As a security guideline, use only the predefined duty roles, unless you have
added new applications functions. The predefined duty roles fully represent
the functions and data that must be accessed by application users and contain
all appropriate entitlement. The predefined duty roles are inherently without
segregation of duty violations of the constraints used by the Application Access
Controls Governor.
Note
Product family administrators are not entitled to create role hierarchies or
manage duty roles and must work with the IT security manager to make changes
such as localizing a duty role to change a role hierarchy. Setup for localizations is
documented in HCM documentation.
Prevent or limit the business activities that a single person may initiate or
validate by managing segregation of duties policies in the Application Access
Controls Governor (AACG) .
Note
In AACG, segregation of duties policies are called access controls or segregation
of duties controls.
Common Applications Configuration: Define Security for Project Financial Management 7-7
Security Tasks and Oracle Fusion Applications: How They Fit
Together
The major security tasks and their order within the context of an overall Oracle
Fusion Applications implementation extend from security setup through
production deployment audits.
The Oracle Fusion business process model (BPM) provides a sequence of security
implementation tasks that includes the following.
• Security setup (Define Common Applications Configuration activity)
• Define Implementation Users task group (optional)
• Create Implementation Users task
• Create Data Role for Implementation Users task
• Provision Roles to Implementation Users task
• Define security - tasks vary depending on deployed Oracle Fusion
product family
• Revoke Data Role from Implementation Users task
• Import Worker Users task
• Import Partner Users task
• Manage Duties task
• Manage Job Roles task
• Manage Application Access Controls task
• Define Automated Governance, Risk, and Performance Controls
activity
• Manage Application Access Controls task (AACG settings)
• Manage Application Preventive Controls task
• Manage Application Transaction Controls task
• Manage Application Configuration Controls task
• User and role provisioning tasks
• Implement Role Request and Provisioning Controls activity
• Import Worker Users task
• Import Partner Users task
• Self Request User Roles task
• Approve User and Role Provisioning Requests task
Note
Go live deployment does not require lockdown or specific security tasks because
security is enforced across the test to production information life cycle.
Required Roles
The following enterprise roles are provisioned to a single super user that is set
up by the Oracle Fusion Applications installation process, and to the initial user
set up by Oracle for Oracle Cloud Application Services:
Common Applications Configuration: Define Security for Project Financial Management 7-9
• Application Implementation Consultant
• IT Security Manager
• Application Administrators for the provisioned products
Initial security administration also includes provisioning the IT Security
Manager role with Oracle Identity Management (OIM) roles for user and role
management.
• Identity User Administrator
• Role Administrator
Additionally, the Xellerate Users organization must be assigned to the IT
Security Manager role.
Important
As a security guideline, provision a dedicated security professional with the IT
Security Manager role at the beginning of an implementation, and revoke that
role from users provisioned with the Application Implementation Consultant
role.
Common Applications Configuration: Define Security for Project Financial Management 7-11
View Segregation of Manage Application • Application Access The Security Reference
Duties (SOD) policies Access Controls Controls Governor Manuals (SRM)
respected by a duty role (AACG) in document the
Governance, Risk, segregation of duties
and Compliance (SOD) policies respected
Controls (GRCC) within each job role
View SOD policy Manage Application • AACG in GRCC The Security Reference
violations carried by the Access Controls Manuals (SRM)
duty roles inherited by a document the SOD
job role policies respected within
each job role
View SOD policy Manage Segregation of • AACG in GRC The SRM documents the
violations Duties Policies SOD conflicts for each
job role
View the data security Manage Data Security • APM Oracle Fusion Data
policies carried by a job, Policies Security stores data
abstract, and data roles security policies in the
policy store.
• Import Partner
Users
Create a new user Manage Users • HCM HCM creates a new user
and identity when a new
worker is created. The
Hire Employee and Add
Contingent Worker tasks
also result in new user
creation requests.
Common Applications Configuration: Define Security for Project Financial Management 7-13
Provision roles to a user 1. Provision Roles to • OIM Implementation users
Implementation are provisioned through
Users • Oracle Fusion OIM since HCM is not
2. Manage Users HCM setup at the start of
the implementation.
• Oracle Fusion The Provision Roles
CRM to Implementation
Users is not needed
• Oracle Fusion
once implementation is
Suppliers
complete.
There may be more than one navigation path to the graphical user interface in
which the task is performed. You can access most security tasks by starting in the
Setup and Maintenance Overview page and searching for security tasks and task
lists.
The Define Data Security activity within the Information Technology (IT)
Management business process includes the following tasks.
These tasks address data security administration. For information on using the
user interface pages for setting up and managing data security, see the Oracle
Fusion Middleware Administrator's Guide for Authorization Policy Manager
(Oracle Fusion Applications edition).
Note
The Manage Data Role and Security Profiles task, and all other HCM security
profile setup tasks are documented in Human Capital Management (HCM)
documentation.
Data access sets define a set of access privileges to one or more ledgers or ledger
sets.
The information on ledgers that are attached to data access sets are secured by
function security. Users must have access to the segment values associated with
the data access sets to access the corresponding GL account.
Common Applications Configuration: Define Security for Project Financial Management 7-15
Set). This entitlement provides the access necessary to perform the Manage Data
Access Sets task in General Ledger.
Data security grants provisioned to roles are data security policies. The security
reference implementation provides a comprehensive set of predefined data
security policies and predetermined data security policies based on data role
templates.
Data security policies are available for review in Authorization Policy Manager
(APM). Data security policies are implemented by grants stored in Oracle Fusion
Data Security (FND_GRANTS).
Data security policies secure the database resources of an enterprise. Database
resources are predefined applications data objects and should not be changed.
However, for cases where custom database resources must be secured objects,
the IT security manager is entitled to manage database resources and create new
data security policies.
Warning
Review but do not modify HCM data security policies in APM except as a
custom implementation. Use the HCM Manage Data Role And Security Profiles
task to generate the necessary data security policies and data roles.
Tip
When extending the reference implementation with additional data security
policies, identify instance sets of data representing the business objects that
need to be secured, rather than specific instances or all instances of the business
objects.
Predefined data security policies are stored in the data security policy store,
managed in the Authorization Policy Manager (APM), and described in the
Oracle Fusion Applications Security Reference Manual for each offering. A data
Common Applications Configuration: Define Security for Project Financial Management 7-17
security policy for a duty role describes an entitlement granted to any job role
that includes that duty role.
Warning
Review but do not modify HCM data security policies in APM except as a
custom implementation. Use the HCM Manage Data Role And Security Profiles
task to generate the necessary data security policies and data roles.
Data Roles
When you provision a job role to a user, the job role implicitly limits data
access based on the data security policies of the inherited duty roles. When you
provision a data role to a user, the data role explicitly limits the data access of the
inherited job role to a dimension of data.
The sets of data that a user can access via roles are defined in Oracle Fusion Data
Security. Oracle Fusion Data Security integrates with Oracle Platform Security
Services (OPSS) to entitle users or roles (which are stored externally) with access
to data. Users are granted access through the entitlement assigned to the roles
or role hierarchy with which the user is provisioned. Conditions are WHERE
clauses that specify access within a particular dimension, such as by business
unit to which the user is authorized.
Data security policies articulate the security requirement "Who can do What
on Which set of data," where 'Which set of data' is an entire object or an object
instance or object instance set and 'What' is the object entitlement.
For example, accounts payable managers can view AP disbursements for their
business unit.
Common Applications Configuration: Define Security for Project Financial Management 7-19
Who can do what on which set of data
Accounts payable view AP disbursements for their business unit
managers
• Table or view
Note
Some data security policies are not defined as grants but directly in applications
code. The security reference manuals for Oracle Fusion Applications offerings
differentiate between data security policies that define a grant and data security
policies defined in Oracle Fusion applications code.
Data security policies that use job or duty roles refer to data security entitlement.
For example, the data security policy for the Accounts Payable Manager job role
refers to the view action on AP disbursements as the data security entitlement.
Important
The duty roles inherited by the job role can be moved and job roles reassembled
without having to modify the data security.
For example, a Sales Party Management Duty can update Sales Party where
the provisioned user is a member of the territory associated with the sales
account. Or the Sales Party Management Duty can update Sales Party where
the provisioned user is in the management chain of a resource who is on the
sales account team with edit access. Or the Participant Interaction Management
Duty can view an Interaction where the provisioned user is a participant of the
Interaction.
A data security policy identifies the entitlement (the actions that can be made on
logical business objects or dashboards), the roles that can perform those actions,
and the conditions that limit access. Conditions are readable WHERE clauses.
The WHERE clause is defined in the data as an instance set and this is then
referenced on a grant that also records the table name and required entitlement.
Data Roles
Data roles are implemented as job roles for a defined set of data.
A data role defines a dimension of data within which a job is performed. The
data role inherits the job role that describes the job. For example, a data role
entitles a user to perform a job in a business unit.
The data role inherits abstract or job roles and is granted data security privileges.
Data roles carry the function security privileges inherited from job roles and also
the data security privilege granted on database objects and table rows.
Data roles are created using data role templates. You create and maintain data
roles in the Authorization Policy Manager (APM). Use the Manage Data Roles
and Security Profiles task to create and maintain HCM data roles in Oracle
Fusion HCM.
HCM security profiles are used to secure HCM data, such as people and
departments. You use HCM security profiles to generate grants for an enterprise
role. The resulting data role with its role hierarchy and grants operates in the
same way as any other data role.
For example, an HCM security profile identifies all employees in the Finance
division.
Oracle Fusion Payroll uses HCM security profiles to secure project organizations.
Applications outside of HCM can use the HCM Data Roles UI pages to give their
roles access to HR people.
Common Applications Configuration: Define Security for Project Financial Management 7-21
non-production instances and Oracle Transparent Data Encryption is available
for protecting data in transit or in backups independent of managing encryption
keys.
If a user has access to the same function through different roles that access
different data sets, then the user has access to a union of those data sets.
Data is either identified by the primary key value of the row in the table where
the data is stored. Or data is identified by a rule (SQL predicate) applied to the
WHERE clause of a query against the table where the data is stored.
Grants
• Rows that are returned by a given query based on the intended business
operation
Note
Data security policies identify sets of data on the registered business object and
the actions that may be performed on the business object by a role The grant can
be made by data instance, instance set or at a global level..
Note
Use parameterized object instance sets whenever feasible to reduce the number
of predicates the database parses and the number of administrative intervention
required as static object instances sets become obsolete. In HCM, security profiles
generate the instance sets.
Database Resources and Data Security Policies: How They Work Together
The database resource defines and instance of a data object. The data object is a
table, view, or flexfield.
The following figure shows the database resource definition as the means by
which a data security policy secures a data object. The database resource names
the data object. The data security policy grants to a role access to that database
resource based on the policy's action and condition.
Common Applications Configuration: Define Security for Project Financial Management 7-23
Database Resources
A database resource specifies access to a table, view, or flexfield that is secured
by a data security policy.
• Name providing a means of identifying the database resource
• Data object to which the database resource points
Note
If the data security policy needs to be less restrictive than any available database
resource for a data object, define a new data security policy.
Actions
Actions correspond to privileges that entitle kinds of access to objects, such as
view, edit, or delete. The actions allowed by a data security policy include all or a
subset of the actions that exist for the database resource.
Conditions
A condition is either a SQL predicate or an XML filter. A condition expresses
the values in the data object by a search operator or a relationship in a tree
hierarchy. A SQL predicate, unlike an XML filter, is entered in a text field in the
data security user interface pages and supports more complex filtering than an
Tip
An XML filter can be effective in downstream processes such as business
intelligence metrics. A SQL predicate cannot be used in downstream metrics.
Note
HCM data roles are generated using the Manage Data Roles and Security Profiles
task, which uses HCM security profiles, not data role templates, to define the
data security condition.
Note
Abstract, job, and data roles are enterprise roles in Oracle Fusion Applications.
Oracle Fusion Middleware products such as Oracle Identity Manager (OIM)
and Authorization Policy Manager (APM) refer to enterprise roles as external
roles. Duty roles are implemented as application roles in APM and scoped to
individual Oracle Fusion Applications.
Common Applications Configuration: Define Security for Project Financial Management 7-25
An example of a dimension is a business unit. An example of a dimension value
is a specific business unit defined in your enterprise, such as US. An example
of a data security policy is a grant to access a business object such as an invoice
with a view entitlement.
When you generate data roles, the template applies the values of the dimension
and participant data security policies to the group of base roles.
The template generates the data roles using a naming convention specified
by the template's naming rule. The generated data roles are stored in the
Lightweight Directory Access Protocol (LDAP) store. Once a data role is
generated, you provision it to users. A user provisioned with a data role is
granted permission to access the data defined by the dimension and data
security grant policies of the data role template.
For example, a data role template contains an Accounts Payable Specialist
role and an Accounts Payable Manager role as its base roles, and region as its
dimension, with the dimension values US and UK. The naming convention
is [base-role-name]:[DIMENSION-CODE-NAME]. This data role template
generates four data roles.
• Accounts Payable Specialist - US (business unit)
• Accounts Payable Specialist - UK (business unit)
• Accounts Payable Manager - US (business unit)
• Accounts Payable Manager - UK (business unit)
If you add a base role to an existing data role template, you can generate a
new set of data roles. If the naming rule is unchanged, existing data roles are
overwritten.
If you remove a base role from a data role template and regenerate data roles, a
resulting invalid role list gives you the option to delete or disable the data roles
that would be changed by that removal.
If you add a dimension value to your enterprise that is used by a data role
template, you must regenerate roles from that data role template to create a
data role for the new dimension. For example if you add a business unit to your
enterprise, you must regenerate data roles from the data role templates that
include business unit as a dimension.
If you add or remove a dimension value from your enterprise that is used to
generate data roles, regenerating the set of data roles adds or removes the data
roles for those dimension values. If your enterprise has scheduled regeneration
as an Oracle Enterprise Scheduler Services process, the changes are made
automatically.
For information on working with data role templates, see the Oracle Fusion
Middleware Administrator's Guide for Authorization Policy Manager (Oracle
Fusion Applications Edition).
HCM data roles, like all Oracle Fusion Applications data roles, define data
security policies: they enable users to perform a set of tasks, using identified
menus, menu items, and pages in application user interfaces, on a specified set of
data within those user interfaces. Because data roles are specific to the enterprise,
no predefined HCM data roles exist.
Note
If you create custom job roles in OIM, you must add them to a locally defined
role category that ends with "Job Roles"; otherwise, they do not appear in the list
of job roles when you create an HCM data role. Do not add custom job roles to
the predefined role category HCM - Job Roles.
Common Applications Configuration: Define Security for Project Financial Management 7-27
Users with Multiple HCM Data Roles
When users have multiple HCM data roles, the data security policies arising
from each role remain separate. For example, being able to promote or terminate
workers in the purchasing department in one HCM data role and view contact
details of all workers in the sales department in another HCM data role does not
enable a user to promote or terminate workers in the sales department.
For example, the human resource specialist job role inherits the employee hire
and worker promotion duty roles, among many others. The inherited duty roles
provide both function privileges, such as Hire Employee, Rehire Employee,
and Promote Workers, and data privileges to HCM objects, such as person
and assignment. The specific instances of those objects required by this HCM
data role, such as people with assignments in a specified legal employer and
department, are identified in security profiles.
A security profile defines the criteria that identify instances of a human capital
management (HCM) object. For example, a person security profile defines the
criteria that identify one or more person records, and a position security profile
defines the criteria that identify one or more positions. When you include a
security profile in an HCM data role and provision the data role to a user, that
user can access the data instances identified in the security profile. The type of
access available to the user (for example whether the user can edit or simply
view the data) depends on the job role identified in the HCM data role.
Common Applications Configuration: Define Security for Project Financial Management 7-29
hierarchy and organization classification, then both sets of criteria apply, and
only those organizations that satisfy all criteria belong to the data instance set.
You can include the predefined security profiles in any HCM data role, but you
cannot edit them. Note also that the View all option is disabled in any security
profile that you create; this restriction exists because predefined security profiles
exist for this requirement.
Abstract roles define a worker's role in the enterprise independently of the job
that the worker is hired to do.
These abstract roles are predefined in Oracle Fusion Human Capital
Management:
• Line manager
• Employee
• Contingent worker
Common Applications Configuration: Define Security for Project Financial Management 7-31
Payroll Flow Not applicable Not applicable View All Flows
Workforce Business Not applicable Not applicable View All Workforce
Process Business Processes
After implementation, you may want to change aspects of this data access. For
example, you may want to create your own security profiles and assign those
directly to abstract roles; however, you must remember that such changes apply
to all users who have the abstract role.
This example shows how to assign predefined security profiles to the employee,
contingent worker, and line manager abstract roles.
Field Value
Organization Security Profile View All Organizations
Position Security Profile View All Positions
Country Security Profile View All Countries
LDG Security Profile View All Legislative Data Groups
Person Security Profile (Person View Own Record
section)
2. Click Review.
3. On the Assign Data Role: Review page, click Submit.
4. On the Manage Data Roles and Security Profiles page, search again for the
predefined Employee role.
5. In the Search Results region, confirm that a green check mark appears
in the Security Profiles column for the Employee role. The check mark
confirms that security profiles are assigned to the role.
Repeat the steps in Searching for the Employee Abstract Role and
Assigning Security Profiles to the Employee Abstract Role for the
predefined Contingent Worker role.
Field Value
Organization Security Profile View All Organizations
Position Security Profile View All Positions
LDG Security Profile View All Legislative Data Groups
Person Security Profile (Person View Manager Hierarchy
section)
Person Security Profile (Public Person View All Workers
section)
Document Type Security Profile View All Document Types
Payroll Flow View All Flows
Workforce Business Process View All Workforce Business Processes
2. Click Review.
3. On the Assign Data Role: Review page, click Submit
4. On the Manage Data Roles and Security Profiles page, search again for the
predefined Line Manager role.
Common Applications Configuration: Define Security for Project Financial Management 7-33
5. In the search results, confirm that a green check mark appears in the
Security Profiles column for the Line Manager role. The check mark
confirms that security profiles are assigned to the role.
Define Users
Stores
Importing Users
You can import users or user attributes in bulk from existing legacy identity and
user stores.
Your tasks may include the following.
• Create users in bulk
• Update specific attributes for all users, such as postal code
• Link users to HR or Trading Community Model persons
• Monitor progress of the import process
• Correct errors & re-import
• Export users in bulk
• Import and export users using a standard plain text data interchange
format like Lightweight Data Interchange Format (LDIF)
You can reserve a specific user name not currently in use for use in the future,
or release a reserved username from the reservation list and make it available
for use. Between a user registration request and approved registration, Oracle
Fusion Applications holds the requested user name on the reservation list, and
releases the name if an error occurs in the self-registration process or the request
is rejected. Self-registration processes check the reservation list for user name
availability and suggest alternative names.
Provisioning Events
New identities, such as new hires, trigger user and role provisioning events. In
addition to user creation tasks, other tasks, such as Promote Worker or Transfer
Worker, result in role provisioning and recalculation based on role provisioning
rules.
When an identity's attributes change, you may need to provision the user
with different roles. Role assignments may be based on job codes, and a
promotion triggers role provisioning changes. Even if the change in the identities
attributes requires no role assignment change, such as with a name change, OIM
synchronizes the corresponding user information in the LDAP store.
Deactivating or terminating an identity triggers revocation of some roles to
end all assignments, but may provision new roles needed for activities, such as
a pay stub review. If the corresponding user for the identity was provisioned
with a buyer role, terminating the identity causes the user's buyer record in
Procurement to be disabled, just as the record was created when the user was
first provisioned with the buyer role.
Common Applications Configuration: Define Security for Project Financial Management 7-35
Notifications and Audits
For information on configuring audit policies and the audit store, see the Oracle
Fusion Applications Administrator's Guide.
Delegated Administration
For example, a payroll manager may submit a payroll run. The payroll
application may need access to the employee's taxpayer ID to print the payslip.
However, the payroll manager is not authorized to view taxpayer IDs in the user
interface as they are considered personally identifiable information (PII).
• Automatically
For both automatic and manual role provisioning, you create a role mapping to
identify when a user becomes eligible for a role.
Common Applications Configuration: Define Security for Project Financial Management 7-37
Oracle Identity Management (OIM) can be configured to notify users when their
roles change; notifications are not issued by default.
Role Types
Data roles, abstract roles, and job roles can be provisioned to users. Roles
available for provisioning include predefined roles, HCM data roles, and roles
created using OIM.
Role Deprovisioning
Automatically provisioned roles are deprovisioned automatically as soon as
a user no longer satisfies the role-mapping conditions. For example, a line
manager role that is provisioned to a user automatically is deprovisioned
automatically when the user ceases to be a line manager.
Automatically provisioned roles can be deprovisioned manually at any time.
Manually provisioned roles are deprovisioned automatically only when all of the
user's work relationships are terminated; in all other circumstances, users retain
manually provisioned roles until they are deprovisioned manually.
Roles at Termination
When a work relationship is terminated, all automatically provisioned roles for
which the user does not qualify in other work relationships are deprovisioned
automatically. Manually provisioned roles are deprovisioned automatically
only if the user has no other work relationships; otherwise, the user retains all
manually provisioned roles until they are deprovisioned manually.
Automatic deprovisioning can occur either as soon as the termination is
submitted or approved or on the day after the termination date. The user who is
terminating the work relationship selects the appropriate deprovisioning date.
Role mappings can provision roles to users automatically at termination. For
example, the locally defined roles Retiree and Beneficiary could be provisioned
to users at termination based on assignment status and person type values.
User access to data and functions is determined by abstract, job, and data roles,
which are provisioned to users either automatically or manually. To enable a
role to be provisioned to users, you define a relationship, known as a mapping,
between the role and a set of conditions, typically assignment attributes such
as department, job, and system person type. In a role mapping, you can select
any role stored in the Lightweight Directory Access Protocol (LDAP) directory,
including Oracle Fusion Applications predefined roles, roles created in Oracle
Identity Management (OIM), and HCM data roles.
• You select the Autoprovision option for the role in the role mapping.
For example, for the HCM data role Sales Manager Finance Department, you
could select the Autoprovision option and specify the following conditions.
Attribute Value
Department Finance Department
Job Sales Manager
Assignment Status Active
Common Applications Configuration: Define Security for Project Financial Management 7-39
The HCM data role Sales Manager Finance Department is provisioned
automatically to users with at least one assignment that satisfies all of these
conditions.
Note
• At least one of the assignments of the user who is provisioning the role
(for example, the line manager) satisfies all conditions associated with the
role mapping.
• You select the Requestable option for the role in the role mapping.
For example, for the HCM data role Quality Assurance Team Leader, you could
select the Requestable option and specify the following conditions.
Attribute Value
Manager with Reports Yes
Assignment Status Active
Any user with at least one assignment that satisfies both of these conditions can
provision the role Quality Assurance Team Leader manually to other users, who
are typically direct and indirect reports.
• You select the Self-requestable option for the role in the role mapping.
Attribute Value
Department ABC Department
System Person Type Employee
Assignment Status Active
Any user with at least one assignment that satisfies all of these conditions can
request the role. The user acquires the role either immediately or, if approval
is required, once the request is approved. Self-requested roles are classified as
manually provisioned.
In this case, all assignments and role mappings in the enterprise are reviewed.
Roles are:
• Provisioned immediately to all users who do not currently have roles for
which they are eligible
Role-Mapping Names
The names of role mappings must be unique in the enterprise. You are
recommended to devise a naming scheme that reveals the scope of each role
mapping. For example:
Name Description
Autoprovisioned Roles Sales Department Mapping includes all roles provisioned
automatically to anyone in the sales department
Benefits Specialist Autoprovisioned Mapping defines the conditions for autoprovisioning
the Benefits Specialist role
Line Manager Requestable Roles Mapping includes all roles that a line manager can
provision manually to direct and indirect reports
Common Applications Configuration: Define Security for Project Financial Management 7-41
Role Mappings: Examples
Roles must be provisioned to users explicitly, either automatically or manually;
no role is provisioned to a user by default. This topic provides some examples of
typical role mappings to support automatic and manual role provisioning.
You create a role mapping called All Employees and enter the following
conditions.
Attribute Value
System Person Type Employee
Assignment Status Active
You could create a similar role mapping for contingent workers called All
Contingent Workers, where you would set the system person type to contingent
worker.
Note
Attribute Value
Business Unit Sales
Assignment Status Active
Manager with Reports Yes
You include the Line Manager role and select the Autoprovision option. This
role mapping ensures that the Line Manager role is provisioned automatically
In the same role mapping, you could include roles that line managers in this
business unit can provision manually to other users by selecting the roles and
marking them as requestable. Similarly, if line managers can request roles for
themselves, you could include those in the same role mapping and mark them as
self-requestable.
Attribute Value
System Person Type Retiree
Assignment Status Inactive
You include the locally defined role Retiree in the role mapping and select the
Autoprovision option. When at least one of a worker's assignments satisfies
the role-mapping conditions, the Retiree role is provisioned to that worker
automatically.
Attribute Value
Department Sales
Job Sales manager
Grade 6
Assignment Status Active
Common Applications Configuration: Define Security for Project Financial Management 7-43
The Define Security activity within the Information Technology (IT)
Management business process includes the following tasks.
• Manage Duties
If no legacy users, user accounts, roles, and role memberships are available in the
Lightweight Directory Access Protocol (LDAP) store, and no legacy workers are
available in Human Resources (HR), the implementation user sets up new users
and user accounts and provisions them with roles available in the Oracle Fusion
Applications reference implementation.
If legacy employees, contingent workers, and their assignments exist, the HCM
Application Administrator imports these definitions by performing the Initiate
HCM Spreadsheet Load task. If user and role provisioning rules have been
defined, the Initiate HCM Spreadsheet Load process automatically creates user
and role provisioning requests as the workers are created.
Once the enterprise is set up, performing the Initiate HCM Spreadsheet Load
task populates the enterprise with HR workers in records linked by global user
ID (GUID) to corresponding user accounts in the LDAP store. If no user accounts
exist in the LDAP store, the Initiate HCM Spreadsheet Load task results in new
user accounts being created. Worker email addresses as an alternate input for
the Initiate HCM Spreadsheet Load task triggers a search of the LDAP for user
GUIDs, which may perform more slowly than entering user names.
Note
The Import Person and Organization task in the Define Trading Community
Import activity imports the following resources, creates users, and links the
resources to users for use in CRM.
• Internal employees
• Contingent workers
• Partner companies
• Legal entities
• Customers
• Consumers
If role provisioning rules have been defined, the Import Person and Organization
task automatically provisions role requests as the users are created.
Import Users
If legacy users (identities) and user accounts exist outside the LDAP store that
is being used by the Oracle Fusion Applications installation, the IT security
manager has the option to import these definitions to the LDAP store by
performing the Import Worker Users and Import Partner Users tasks.
Job and abstract roles are managed in OIM. This task includes creating and
modifying job and abstract roles, but not managing role hierarchies of duties for
the jobs.
Note
Common Applications Configuration: Define Security for Project Financial Management 7-45
Manage Job Roles does not include provisioning job roles to users. Provisioning
users is done in OIM, HCM, CRM or Oracle Fusion Supplier Portal.
Roles control access to application functions and data. Various types of roles
identify the functions performed by users.
Manage Duties
A person with a job role must be able to perform certain duties. In the Oracle
Fusion Applications security reference implementation, enterprise roles inherit
duties through a role hierarchy. Each duty corresponds to a duty role. Duty roles
specify the duties performed within applications and define the function and
data access granted to the enterprise roles that inherit the duty roles.
Managing duties includes assigning duties to job and abstract roles in a role
hierarchy using Authorization Policy Manager (APM). If your enterprise needs
users to perform some actions in applications coexistent with Oracle Fusion
applications, you may wish to remove the duty roles that enable those actions.
For details about which duty roles are specific to the products in an offering, see
the Oracle Fusion Applications Security Reference Manual for each offering.
OIM stores the role hierarchy and the spanning of roles across multiple pillars or
logical partitions of applications.
Tip
As a security guideline, use only the predefined duty roles, unless you have
added new applications functions. The predefined duty roles fully represent
the functions and data that must be accessed by application users and contain
all appropriate entitlement. The predefined duty roles are inherently without
segregation of duty violations of the constraints used by the Application Access
Controls Governor.
Note
Prevent or limit the business activities that a single person may initiate or
validate by managing segregation of duties policies in the Application Access
Controls Governor (AACG) .
Note
1. On the Initiate Data Load page, you generate and complete the Create
Worker spreadsheet. You must map your data to the spreadsheet columns
and provide all required attributes. Once the spreadsheet is complete, you
import the data to the HCM Data Loader stage tables.
HCM Data Loader is a generic utility for loading data to Oracle Fusion
Human Capital Management from external sources.
2. In the Data Exchange work area, you run the Load Batch Data process to
load data from the HCM Data Loader stage tables to the Oracle Fusion
application tables.
Common Applications Configuration: Define Security for Project Financial Management 7-47
User-Account Creation
Oracle Fusion user accounts are created automatically for imported workers
in Oracle Identity Management (OIM), unless automatic account creation is
disabled.
By default, user account names and passwords are sent automatically to users
when their accounts are created. This default action may have been changed at
enterprise level, as follows:
Role Provisioning
Once user accounts exist, roles are provisioned to users automatically in
accordance with current role-provisioning rules. For example, current rules
could provision the employee abstract role to every worker. Role provisioning
occurs automatically unless it has been disabled for the enterprise.
This example shows how to import worker users from legacy applications to
Oracle Fusion Applications.
Prerequisites
Before you can complete this task, you must have:
1. Installed the desktop client Oracle ADF 11g Desktop Integration
2. Enabled the Trust Center setting Trust access to the VBA project object in
Microsoft Excel
Field Name
Search Task
Name Import Worker Users
3. Click Search.
4. In the search results, click Go to Task for the task Import Worker Users.
The task navigates to the Initiate Data Load page.
Alternatively, you can select the Import Worker Users task from an
implementation project.
Common Applications Configuration: Define Security for Project Financial Management 7-49
Importing the Spreadsheet Data to the HCM Data Loader Stage Tables
Use the default values except where indicated.
As each row of data is uploaded to the HCM Data Loader stage tables, its
status is updated.
3. When uploading completes, identify any spreadsheet rows with the status
Insert Failed, which indicates that the row failed to upload.
4. For any row that failed to upload, double-click the status value to display
a description of the error.
5. When you have corrected any errors, click Upload again to load the
remaining rows to the same batch.
Loading Workers to the Application Tables from the HCM Data Loader Stage
Tables
Use the default values except where indicated.
Reviewing the Results of the Load Batch Data Process and Correcting Errors
1. On the Load Batch Data page, search again for the batch
Workers042713Batch01 and review its status in the Batch Status column
of the Search Results region.
2. If the batch status is Complete, click Done to close the Load Batch Data
page; otherwise, continue with the next step.
3. If the batch completed with errors, select the batch in the search results.
4. On the Batch Summary tab of the Batch Details region, select Action -
Extract Failed Objects to Spreadsheet .
Manage Users
You can create users by entering basic person and employment data. A user
account is created automatically for a person when you create the user record.
You can assign the users Oracle Fusion Human Capital Management (HCM) and
non-HCM data roles, each providing access to specific functions and data. This
example demonstrates how to create a user and assign roles to the user.
Note
Prerequisites
1. Create a role mapping called All Employees and enter the following
conditions.
Attribute Value
System Person Type Employee
Assignment Status Active
Common Applications Configuration: Define Security for Project Financial Management 7-51
In the role mapping you include the:
Creating a User
1. On the Search Person page, click the Create icon to open the Create User
page.
2. Complete the fields, as shown in this table:
Field Value
Last Name Williams
First Name Gail
E-Mail gail.williams@vision.com
Hire Date 4/12/11
3. In the User Details region, leave the User Name field blank. The user
name defaults to the user's e-mail ID.
4. In the Employment Information region, select the person type Employee
and complete the fields as shown in the table:
Field Value
Legal Employer Vision Corporation
Business Unit Vision Canada
Department Human Resources
To run this report, you must have an HCM data role that provides view-all
access to person records for the Human Capital Management Application
Administrator job role.
Parameters
User Population
Enter one of the following values to identify the group of user accounts to
include in the report.
Value Description
HCM User accounts with an associated HCM
person record.
TCA User accounts with an associated TCA
party account.
OIM Accounts for users in the PER_USERS table
who do not have an associated person
number or party ID. OIM users are also
referred to as implementation users.
ALL HCM, TCA, and OIM users accounts.
From Date
Accounts for HCM and OIM users created on or after this date are included in
the report. If you specify no From Date value, then accounts with any creation
date are included, subject only to any To Date value that you specify.
From and to dates do not apply to the TCA user population; the report includes
all TCA users if you include them in the report's user population.
To Date
Accounts for HCM and OIM users created on or before this date are included in
the report. If you specify no To Date value, then accounts with any creation date
are included, subject only to any From Date value that you specify.
From and to dates do not apply to the TCA user population; the report includes
all TCA users if you include them in the report's user population.
Value Description
A Include active accounts, which belong to
users with current roles.
Common Applications Configuration: Define Security for Project Financial Management 7-53
I Include inactive accounts, which belong to
users with no current roles.
All Include both active and inactive user
accounts.
The output is an XML-formatted file where user accounts are grouped by type,
as follows:
The information provided in the extract varies with the account type.
The date when any one of a number of values, including assignment managers,
location, job, and person type, was last updated.
A list of roles currently provisioned to workers whose work relationships are all
terminated. This value appears for active user accounts only.
A resource group.
An e-mail containing the user name and password is sent to the user's primary
work e-mail address. If the user has no primary work-email address, then the
user name and password are sent to the primary work e-mail address of the
user's line manager, if available; otherwise, no notification is sent.
You can select Send user name and password only if these details have not
already been sent for this user: the user name and password can be sent
Yes. The Oracle BI Publisher User Details System Extract report includes details
of all user accounts or a specified subset. For example, you can produce a report
showing inactive user accounts, accounts created between specified dates, or
accounts associated with TCA parties only.
To run the report, you must have an HCM data role that provides view-all
access to person records for the Human Capital Management Application
Administrator job role.
Common Applications Configuration: Define Security for Project Financial Management 7-55
7-56 Oracle Fusion Applications Project Financial Management Implementation Guide
8
Common Applications Configuration:
Define Automated Governance, Risk, and
Performance Controls
You manage, remediate, and enforce access controls to ensure effective SOD
using the Application Access Controls Governor (AACG) product in the Oracle
Enterprise Governance, Risk and Compliance (GRC) suite.
AACG applies the SOD policies of the Oracle Fusion Applications security
reference implementation using the AACG Oracle Fusion Adapter.
AACG is integrated with Oracle Identity Management (OIM) in Oracle Fusion
Applications to prevent SOD control violations before they occur by ensuring
SOD compliant user access provisioning. SOD constraints respect provisioning
workflows. For example, when provisioning a Payables role to a user, the SOD
policy that ensures no user is entitled to create both an invoice and a payment
prevents the conflicting roles from being provisioned. AACG validates the
request to provision a user with roles against SOD policies and provides a
remediating response such as approval or rejections if a violation is raised.
Use AACG to for the following.
• Define SOD controls at any level of access such as in the definition of an
entitlement or role.
• Simulate what-if SOD scenarios to understand the effect of proposed SOD
control changes.
Common Applications Configuration: Define Automated Governance, Risk, and Performance Controls 8-1
• Use the library of built-in SOD controls provided as a security guideline.
Note
AACG entitlements are logical groupings of security objects that represent
Oracle Fusion Application access points such as roles or entitlement.
Note
In AACG, segregation of duties policies are called access controls.
Oracle Fusion Applications does not predefine business logic for dealing with
SOD conflicts. Oracle Fusion Applications does define a set of states where role
requests are suspended pending resolution of SOD violations the role request
introduces. In most cases, Oracle Fusion Applications invokes OIM to handle
role requests. Enterprises define SOD resolution rules when defining SOD policy.
The risk tolerance of your enterprise determines what duties must be segregated
and how to address violations.
AACG assists in remediation of violations with a guided simulation that
identifies corrective action. You determine the exact effects of role and
entitlement changes prior to putting them into production, and adjust controls as
needed.
Note
SOD policies are not enforced at the time of role definition.
Common Applications Configuration: Define Automated Governance, Risk, and Performance Controls 8-3
Conflicts
Tip
As a security guideline, use only the predefined duty roles, unless you have
added new applications functions. The predefined duty roles fully represent
the functions and data that must be accessed by application users and contain
all appropriate entitlement. The predefined duty roles are inherently without
segregation of duty violations of the constraints used by the Application Access
Controls Governor.
Violations
For information on configuring audit policies, see the Oracle Fusion Applications
Administrator's Guide.
For more information on managing segregation of duties, see the Oracle
Application Access Controls Governor Implementation Guide and Oracle
Application Access Controls Governor User's Guide.
Data Contexts
You can extend SOD policies to control access to specific data contexts.
For example, no single individual must be able to source a supplier in a business
unit and approve a supplier invoice in the same business unit.
SOD policies may include exclusion conditions to narrow the SOD scope and
reduce false positive violations, or inclusion conditions to broaden the scope.
Conditions apply to access points globally, to policies, or to access paths defined
by policies. Access path conditions can exclude a user from a role, an Oracle
Fusion Applications entitlement from a role, or a permission from an Oracle
Fusion Applications entitlement.
The following global exclusion conditions are predefine in Oracle Fusion
Applications and available when creating SOD policies.
• User Status
• User Name
• Enterprise Role
• Action
• Business Unit
• Within Same Business Unit
Enforcement
Note
SOD policies are not enforced at the time of role definition.
A single SOD policy can include entitlement from multiple instances of a single
enterprise resource planning environment. For example, one SOD policy is
enforced in implementation, test, and production instances of Oracle Fusion
Applications.
Common Applications Configuration: Define Automated Governance, Risk, and Performance Controls 8-5
Managing Segregation of Duties Risks and Violations: Critical
Choices
You assess and balance the cost of duty segregation against reduction of risk
based on the requirements of your enterprise.
The types of people who resolve SOD conflicts include the following.
You view and respond to risks and violations in the Application Access Controls
Governor (AACG).
You may wish to override an SOD violation. For example, the Accounts Payable
Supervisor includes incompatible duties to create both invoices and payments.
When you provision this job role to a user, you may waive the violation in the
AACG. You may waive the violation for the currently provisioned user, for the
SOD policy that raised the violation, or for the SOD policy within a particular
data set, such as a business unit.
The risk tolerance of your enterprise guides how you respond to conflicts. For
example, a user may be provisioned with both the role of Order Manager and
Shipping Agent. The Order Manger role entitles the user to enter orders, which
could result in exploitation when filling shipping quotas. You can remove the
entitlement to enter orders that the Order Manger job role inherits from the
Orchestration Order Scheduling Duty role. Or you could segregate the shipping
and order entry duties by defining an SOD policy that allows a user to have
either job role but not both.
False Positives
False positives can be SOD policy violations that are not actually violations, or
are violations within your risk tolerance and therefore do not require corrective
action.
Conflict analysis detects a user's multiple paths to one or more conflicting access
points.
For example, a user may be able to reach a single access point through one
or more roles, or by one entitlement leading to another through submenus
to a function that represents a risk. The resulting conflict path shows if the
conflict is generated by inappropriate role provisioning or configuration of
applications. The audit shows the paths from any number of users to any
number of access points involved in conflicts, which lets you visualize the root
cause and remediate effectively.
AACG assigns one or more users to review all paths involved in a given conflict
so that the entire conflict can be addressed in a coherent way.
AACG lets you accept or waive a violation. Your reasons may include that you
accept the risk or will define compensating controls.
A waiver may apply to the current user, constraint, or constraint within a
dimension such as the business unit.
Resolving Conflicts
Common Applications Configuration: Define Automated Governance, Risk, and Performance Controls 8-7
Role Provisioning and Segregation of Duties: How They Work
Together
Segregation of duties (SOD) checks occur when roles are assigned to users. The
checks are based on Oracle Application Access Controls Governor (AACG)
policies in Oracle Enterprise Governance, Risk and Compliance (GRC). The
Oracle Identity Management (OIM) integration includes predefined routing rules
for remediation in the Manage IT Security business process.
Note
In Oracle Identity Management (OIM), external users means users who are not
specific to applications, such as enterprise roles or the absence of entitlement to
access an application.
The figure shows the role provisioning request flow. OIM uses AACG to check
segregation of duties violations.
• Interface Staging
Oracle Fusion Applications collects the employee names for the supplier or
partner company at the time the company submits its request to join the program
so that all employees accessing Oracle Fusion Applications on behalf of the
supplier or partner are provisioned.
AACG in the Oracle Enterprise Governance, Risk and Compliance (GRC) suite
is certified to synchronize with the policy and identity stores for all pillars or
partitions of Oracle Fusion Applications and integrated with the Oracle Fusion
Applications security approach to roll up entitlements (by means of duty roles)
to the roles that are provisioned to internal users. SOD policies can be defined
and enforced at any level of authorization. For external users, SOD policies use
attribute information stored in the Trading Community Model tables.
OIM recognizes the role provisioning request and initiates a call to AACG.
OIM apprises the SPML client of the current state of the role provisioning
request as SOD_CHECK_IN_PROGRESS.
OIM stores the SOD check result as part of OIM audit data.
OIM apprises SPML client of the current state of the SPML request. The
provisioning is either still in progress with segregation of duties being checked,
or conflicts were found. If conflicts exist, AACG rejects the request and notifies
the application.
Common Applications Configuration: Define Automated Governance, Risk, and Performance Controls 8-9
SOD_REMEDIATION_REJECTED Conflict found AACG detected violations that are
rejected by approver
Note
When a partner user is provisioned, all employees of the partner enterprise are
provisioned. SOD checks occur when an external user requests to join a program,
because SOD policies operate across Oracle Fusion Applications, not at the
individual level. Supplier or partner company user requests are not approved if
there is an SOD conflict against the supplier company.
OIM provides AACG with the details of SOD exception approval workflow.
AACG audits the outcome for use in future detective controls and audit
processes.
• SOD conflict is found and request is denied because the relevant SOD
policy is to be strictly enforced and no exception approval should be
allowed
• SOD conflict is found and the exception to the policy is allowed, so the
request goes through additional processing, such as an approval process.
If one of the paths for exception resolution is to get an approval, then the SOD
exception resolution drives the approval using AMX. Standard AMX rules,
not business rules, resolve the approval for the SOD exception, including the
following.
• Organizational hierarchies
The approver resolution uses AMX Rules Designer to access various user
attributes and organizational hierarchies managed in Oracle Fusion Applications
repositories. This information is typically not available in OIM or the LDAP
identity store repository. Enterprises can define additional approval rules using
AMX Thin Client.
The SOD exception approval task shows the details of the SPML request and
SOD Provisioning results in a page rendered by OIM. The approver may take
one of the following actions.
1. If the role requested is Chief Financial Officer, the SOD remediation task is
assigned to the IT Security Manager role.
2. If the SOD violation results from a policy where the SOD control tag
is the Information Technology Management business process and the
control priority is 1, the SOD remediation task is assigned to Application
Administrator role.
3. In all other scenarios, the SOD remediation task is assigned to the
Controller role.
For more information about configuring audit policies, see the Oracle Fusion
Applications Administrator's Guide.
Common Applications Configuration: Define Automated Governance, Risk, and Performance Controls 8-11
8-12 Oracle Fusion Applications Project Financial Management Implementation Guide
9
Common Applications Configuration:
Define Approval Management
Overview
• Approval management is an extension of the human workflow services of
Oracle SOA Suite. Refer to the Oracle Fusion Middleware Modeling and
Implementation Guide for Oracle Business Process Management.
See: Introduction to Approval Management
See: Understanding Approval Management Concepts
Customization
• You can optionally customize predefined approval workflows, for
example add post-approval activities or additional stages. Refer to the
Oracle Fusion Applications Extensibility Guide.
Select the Local Installation of Help feature choice so that the Define Help
Configuration task list appears in your implementation project, and you can
select two additional features (Access to Internet-Based Help Features and Help
Customization) to control the fields available on the Set Help Options page.
Select this feature choice to provide users access to features that involve
navigation to sites on the Web. If you select this feature choice, then the Web
Important
For non-Cloud implementations only: Some help includes links to the Oracle
Fusion Applications Technology Library. If you select this feature, then these
links open the library on the Oracle Technology Network Web site. If you do not
select this feature, then your system administrator must download the library
from Oracle Technology Network (http://www.oracle.com/technetwork/
documentation/fusion-apps-doc-1508435.html) and put all the content from
within the extracted folder (for example E28271_01) directly into the appmgr/
APPLTOP/fusionapps/applications/ahc/afh/reference/TechLib folder.
Help Customization
Select this feature choice if you want certain help files to be available only
to a restricted set of users. You can define the user groups allowed to view
corresponding help files. Do not select this feature choice if you do not have this
requirement, because the feature can have an impact on performance.
If you select the Custom Help Security feature choice, then the Manage Help
Security Groups task is available in the Define Help Configuration task list in
your implementation project. There are no help options associated with this
feature choice.
Announcements
Use announcements to broadcast information to all users of your help site. You
can provide information about help, for example new custom help that was
recently added, or about anything that users should take note of, for example
a change in company policy. Announcements can appear on any of the tabs
on the home page of Oracle Fusion Applications Help. You can target specific
user groups by posting announcements to specific tabs, for example, posting
information related to implementation to the Functional Setup tab.
Only users with the Application Help Text Administration duty role have access
to the Manage Announcements icon button in the Announcements sections.
They can create, edit, and delete announcements for the tab that they are on, and
set the date range for when each announcement is to be displayed.
Note
Use the full URL, for example http://www.oracle.com, when creating links.
Discussions
Users can use discussions to post questions or comments about subjects covered
in specific help files. For example, after reading help on expense reports, users
might have questions or comments about company policies or processes for
expenses. Other users who later access this help file would benefit from the
information in the discussion.
You can set a help option to enable discussions. Each help file would contain
a Discuss link that all users can use to read discussions about that file. They
can also start a discussion topic or post to existing topics. These discussions are
visible only to users in your enterprise.
Important
Do not enable discussions until servers for discussions are up and running.
Only users with the appropriate administrator role can moderate discussions.
For more information on granting the administrator role on the discussions
server, see the Oracle Fusion Middleware Administrator's Guide for Oracle
WebCenter Portal.
Users can rate any help file on a five star system and provide feedback about the
content. This information is helpful to other users in deciding which help file to
open. Help files with a higher average rating are listed first in help windows,
and in the help listings you see as you browse using the help navigators.
The scope of ratings and reviews is limited to your enterprise.
Provide a link to your Oracle User Productivity Kit (UPK) library if you have
UPK licensed and custom UPK content to share with your users. You give them
access to a library of custom UPK content in addition to any custom UPK demos
that you added to the help site itself. UPK demos that you add as custom help
are available only in the See It mode, so the library can include the same demo
in other modes. If you have UPK versions earlier than 3.6.1, then you cannot add
UPK demos as custom help, so the link is the only way for users to access custom
UPK content from the help site.
How can I find the URL to the Oracle User Productivity Kit library?
The URL to enter on the Set Help Options page should be the full path from
the Web server where you are hosting your Oracle User Productivity Kit (UPK)
content to the index.html file that opens the table of contents for the library, for
example, http://<your domain>.com/UPKcontent/PlayerPackage/index.html.
In this example, you or your UPK administrator would publish one UPK
player package that contains all the content to be linked to from Oracle Fusion
Applications Help, as well as the index.html file, and place the PlayerPackage
folder in a manually created folder called UPKcontent on the Web server.
Users with the Application Help Text Administration duty role have access to
customize help in Oracle Fusion Applications Help. This duty is assigned by
default to various job roles, in particular the administrators for product families.
You can assign the duty role to other users who need access to customize help.
Use the Manage Duties task in the Setup and Maintenance work area to search
for the Application Help Text Administration duty role on the Role Catalog page,
and map additional job roles to this duty role.
Define a help security group and assign a duty role to the group.
1. From the Setup and Maintenance work area, find the Manage Help
Security Groups task and click Go to Task.
2. On the Manage Help Security Groups page, add a new row.
3. Complete the fields, as shown in this table. Leave the start and end dates
blank.
Field Value
Help Security Group HR
Meaning HR Only
Description Viewing by HR specialists only
Display Sequence 1
4. Click Save.
5. With your new help security group selected, go to the Associated Roles
section and add a new row.
6. Select PER_HUMAN_RESOURCE_SPECIALIST as the role name.
7. Click Save and Close.
You have created a new lookup code for the Help Security Groups
lookup type, which is a standard lookup. The lookup code has the name,
meaning, and description that you defined for the help security group.
You have also created a data security policy for the help database
resource, specifying that the Human Resource Specialist role can view
help that is defined with the HR security group. If you go to the Manage
Database Resources and Policies page and find the database resource,
or object, ATK_KR_TOPICS, then you can see the policy for the Human
Resource Specialist role, with the condition that the column name,
SECURITY_CODE, is equal to the value HR.
Note
To make a copy of all custom help for testing, migration, or other purposes, use
the export and import feature in the Setup and Maintenance work area.
• Many help files can be accessed from help windows in the application. If
you want to customize help in the context of a help window, for example
create a custom help file and add a link to it from a specific help window,
then start by opening that help window. When you click the Manage
Custom Help link, you go to the Manage Custom Help page, and the help
location fields are automatically populated with values that correspond
to the help window. This way you can easily select existing files to add
to the same help location, and when you create a new file, the same help
location appears by default.
• Open the Manage Custom Help page directly from the home page of
Oracle Fusion Applications Help or from search result pages.
• To edit a specific file, you can either find it in the Manage Custom Help
page, or open the file itself and click the Edit link.
• Likewise, you can find glossary terms in the Manage Custom Help page,
or click the Glossary link in the global area to open the Glossary tab,
search for the term, and click Edit.
Note
When you search in the Manage Custom Help page, make sure that the Custom
Help Only check box is not selected if you are looking for predefined help.
If your enterprise has purchased Oracle User Productivity Kit (UPK) content,
then your administrator can also add a UPK item to the Help menu in the global
area of Oracle Fusion Applications. When users select this menu item, they
access UPK content specific to the page that they are on.
Demo
Demos are Oracle User Productivity Kit (UPK) topics that visually demonstrate
how to use the application to complete a short task or portion of a task. Demos
can also provide an introduction to complex dashboards and work areas.
Examples provide real use cases of features to illustrate how and when to use
the feature, or scenarios to illustrate abstract concepts. Worked examples show
exactly what you need to do to achieve a specific result, emphasizing decisions
that you make and values that you enter.
FAQ
FAQs, or frequently asked questions, provide brief answers to questions that you
might have regarding a task or page. For example, they can briefly explain what
a term means, why something happened, how you can perform an action, or
what happens if you perform the action.
Glossary
Glossary terms provide definitions for words or phrases used in help. You
can search or browse glossary terms in the Glossary tab of Oracle Fusion
Applications Help. Where the links are available, you can also see the definition
when you hover over the term in help content for other help types.
Help Topic
Help topics explain key concepts, illustrate how application components work
together, or assist in decision-making by explaining points to consider or the
options you have. Help topics can also provide reference, overview, and other
information.
PDF Guide
PDF guides present a collection of help content from the other help types,
except demos, in an organized and logical format. For example, there are guides
addressing specific business processes and setup offerings. You can see lists of all
guides from the Guides menu in Oracle Fusion Applications Help.
The value in the Page or Section field on the help customization pages
represents where users can click a help icon to open a help window that contains
The page or section value reflects the logical navigation to the help window. For
example, Edit Opportunity page, Revenue tab, Recommendations window
does not mean that the help file is available in three different places. The help
icon is in the Recommendations window, which is accessed from the Revenue
tab on the Edit Opportunity page.
If the value suggests multiple locations, for example Create and Edit
Opportunity pages, then the help file is available from the page header of both
the Create Opportunity and Edit Opportunity pages. If the page or section value
is, for example, a dashboard region that appears in multiple dashboards, then
the value does not specify the page name but just the region. The help file is
available from that region in multiple dashboards.
Help Hierarchies
Help files are associated with help hierarchies, which are used to categorize help
files and aid users in finding help. Each help file can have multiple hierarchies,
with at least one of type Business Processes. The business process hierarchy is
based on the Business Process Management model. Every page or section value
is predefined with a specific business process hierarchy. If you select a page or
section without entering a business process hierarchy, the predefined hierarchy
appears by default.
The Search by Business Process navigator in the help site is based on the
business process hierarchy. For example, if you assign two business process
hierarchies to a help file, users can find the file in both locations in the navigator.
When the user clicks More Help from a help window, all help files assigned to
the same business process hierarchy as the page or section value are returned as
search results.
• Functional Setup Manager, which includes help about using the Setup
and Maintenance work area.
• Offerings, which contains level 2 nodes for each setup offering, and lower
levels for the main task lists in the offerings. Help for the task lists and
tasks are included.
The Search by Common Tasks navigator is based on the Welcome hierarchy type.
The level 1 nodes represent categories of functional areas common to all users.
The primary location of a help file designates the hierarchy that is displayed
for the help file in search results and within the help content as breadcrumbs.
You cannot change the primary location of a help file that came with your help
installation. Primary locations of predefined help are based on the business
process hierarchy, while custom help files can have primary locations based on
hierarchies of any type.
When you open any predefined help file, including glossary terms, that came
with Oracle Fusion Applications Help, you can see an edit option if you have
roles allowing edit access. When you edit predefined help, keep in mind:
When you edit predefined help, you are actually creating a new custom help file
based on the original file, with the same help locations. The customized version
replaces the original, which becomes inactive and hidden from users. You can
display both versions by reactivating the original in the Manage Custom Help
page.
Note
In the Search Results: Existing Help region on the Manage Custom Help page,
there is no option to edit predefined help. You can duplicate a predefined help
file, edit the copy, and optionally inactivate the original.
All predefined help comes with preassigned help locations, including at least one
based on the hierarchy of type Business Processes. Many also have predefined
page or section values that indicate where the help can be accessed from help
windows in the application.
To change where predefined help appears, either in the help site navigators or in
the application, create a duplicate in the Manage Custom Help page. Change or
add help locations to your custom copy, and inactivate the original.
Even though glossary terms do not appear in the help site navigators, you still
need to enter at least one help location to categorize the glossary term.
When you edit a predefined glossary term, the original term becomes inactive.
Existing links to the glossary term, from other predefined and custom help
files, will automatically point to your custom version. If you later inactivate the
custom glossary term, make sure to activate the original term so that the links
still work.
For all link types, except the standard hypertext links, you must create or edit
custom help with a Text or Desktop source type. In other words, you must type
the help content directly in the application or use an HTML file that you upload
to help. For standard hypertext links, the source type can also be URL.
Related help is the section at the end of help files that contains links to other help
files. The syntax for related help contains a comma-separated list of title IDs that
represent help files.
• To replace existing links or add new links, you need to retain the code
syntax and enter desired title IDs. To find title IDs, search for the help files
on the Manage Custom Help page. Title IDs are displayed in the search
results, but the Title ID column is hidden by default.
You can create standard hypertext links to any file or Web site as long as you
ensure the stability and validity of the links, including links to other help files,
In the Help Content section, highlight the text that you want to use as link text
and click the Add Link icon button.
For links to other help files, open the file to which you want to link, and click the
E-Mail link. Use the URL in the autogenerated e-mail text as the link to the file.
Note
Use the full URL, for example http://www.oracle.com, when creating links.
The syntax for links to HTML files in documentation libraries, for example the
Oracle Fusion Applications Technology Library, is:
<span class="HP_topic-link_bridgeDocument-linkToSTDoc_"><?ofa
linkToSTDoc(WCSUG4636) ?><span class="HP_topic-linktext_">Understanding
Tags</span><?ofa endLink ?></span>.
WCSUG4636 is the anchor ID and Understanding Tags is the link text. You can:
• Modify the link by replacing the existing anchor ID or editing the link
text, or both.
Important
Glossary term links provide definitions in a note box when users hover over the
term in help files.
In this example, accounting period is the link text, or glossary term, and
ACCOUNTING_PERIOD_001 is the identifier, or title ID.
• To remove the link but retain the text, delete all the code except the term
itself.
Note
If your custom help has glossary terms and the source type is Desktop File, then
make sure before uploading that the quotes around the glossary term are actual
quotation marks in raw HTML, not ". Otherwise, quotation marks will
appear when users view the help file.
This example demonstrates how to customize a PDF guide that came with
Oracle Fusion Applications Help. This guide is currently not available from any
help window in the application.
Edit a copy of the original PDF guide, and use the Manage Custom Help page to
replace the original PDF guide with your new file.
Note
Your demo must be made with UPK 3.6.1 or later to be added as help.
Generate a report of UPK document IDs, which you will use when creating
custom help, to identify the UPK topics that you want to add. Publish the UPK
module as a player package, then create custom help for the UPK topics that you
want to use as help demos.
Field Value
Title The name of the UPK topic.
Source Type Oracle User Productivity Kit
File Location The full URL of the player package
folder on the Web server, for example,
http://<your domain>.com/
UPKcontent/PlayerPackage.
The Help Location section contains values for the help window in the
Activity Stream region. This help file will also appear in the Search by
Business Process navigator under this predefined hierarchy.
5. Click Save and Close.
6. On the Manage Custom Help page, open the help locations for the help
file that you just created.
7. Add a help location with the Welcome hierarchy type and select
Collaboration Features as the level 1 node.
8. Add another help location with the Business Processes hierarchy type and
select Information Technology Management as the level 1 node, Manage
Networking and Communications as the level 2 node, and Manage
Social Networking Capabilities as the level 3 node.
9. Click Save and Close.
10. Starting at the Connections region, repeat steps 1 to 9 for the other UPK
topic that you want to add.
When you create or edit help, select a help security group that represents the set
of roles that you want to have access to the help. If you do not see the Security
Group field, then your administrator has not selected the Custom Help Security
feature choice. The Unsecured group has no associated roles, so anyone can view
the help. The predefined Secured group includes all internal employees and
contingent workers, unless this group has been edited. You can create security
groups and associate roles using the Manage Help Security Groups page, which
you can access by starting in the Setup and Maintenance Overview page and
searching for the Manage Help Security Groups task. Your new security groups
are immediately available for use to secure new or edited help files.
You must specify a page or section to add the existing help to. To ensure that
help is added to the correct help window, go to the page or section in the
You cannot select and add help to a particular hierarchy, on the Manage Custom
Help page, without a page or section. To add just a hierarchy, search for the help
file, add a new help location, and specify only the hierarchy information.
Oracle Fusion Applications Help patches update all help files, both active and
inactive, except custom help. Custom help files are not affected by patches.
Consider reviewing inactive files to see if you want to activate the updated
version, or to make similar edits to the custom versions of those files, if any.
You can customize help that is embedded in the application, for example hints
and help windows, for all users of Oracle Fusion Applications.
• Edit, create, or delete hint text that appears on hover over buttons, links,
icons, or tab titles.
Note
The Define Application Toolkit Configuration task list is available in
implementation projects only if the Application Toolkit Component Maintenance
feature choice is selected.
Use the Setup and Maintenance work area to access the tasks in the Define
Application Toolkit Configuration task list.
Report Permissions
• You can restrict access to specific reports for specific users, and this
security is not limited to the Reports and Analytics pane. Refer to the
How can I set up the Reports and Analytics pane for all users?
You can remove any currently mapped report from the Reports and Analytics
pane, or add mappings to reports from the Oracle Business Intelligence (BI)
Presentation catalog. To access the setup, click Edit Settings in the Reports
and Analytics pane, or use the Map Reports to Work Areas task in the Setup
and Maintenance work area. If you do the former, then you can set up only the
Reports and Analytics pane on the work area that you are in.
If you do the latter, then you can select a work area to set up. If you do not see
the desired work area, most likely you do not have access to it due to security.
You can request to be granted a role that has access to the work area, or another
administrator or business user with access to the work area can be granted the
Reports and Analytics Region Administration Duty to be able to map reports to
the work area.
Tip
On the Map Reports to Work Areas page only, you can also use the Synchronize
button to remove mappings to reports that are no longer in the catalog, for all
work areas at once.
Any changes you make in either UI apply to all users with access to the mapped
work area.
Why can't I see reports when mapping reports to work areas for the Reports
and Analytics pane?
It is possible that there are no reports currently mapped to the work area that
you select in the Map Reports to Work Areas page. Alternatively, reports are
mapped, but you do not see them due to security.
Why can't I see reports when I edit settings for the Reports and Analytics pane?
In the Edit Settings window, you may not be able to see a currently mapped
report because you do not have access to it due to security.
Similarly, in the list of all available reports from the catalog, you can see only
the reports that you have access to. You can request to be granted a role that has
access to the reports that you want to map, or another administrator or business
user with access to those reports can be granted the Reports and Analytics
Region Administration Duty to be able to map reports to work areas.
For all users across the site, you can disable or enable predefined Watchlist
categories and items, edit their names, and determine how often item counts
refresh. You cannot delete predefined Watchlist categories and items, nor create
any for the site. Users can create their own Watchlist items through saved
searches.
Access the Set Watchlist Options page by starting in the Setup and Maintenance
Overview page and searching for the Set Watchlist Options task.
Use the Set Watchlist Options page to enable or disable predefined Watchlist
categories and items. Disabling any category or item also disables associated
processes involved in calculating the Watchlist item counts for all users. These
processes include creating data caches, performing security checks, invoking
services across domains, running queries, and so on.
An item with the Predefined type represents the actual predefined Watchlist
item that appears in the Watchlist. If you disable this type of Watchlist item, then:
A Watchlist item with the User-created saved search type does not appear in the
Watchlist; it controls the display of the Manage Watchlist button or menu item in
pages with saved searches. If you disable this type of Watchlist item, then:
• Any user-defined saved searches from that work area already used as
Watchlist items are no longer available in the users' watchlist. The user-
defined saved searches are still available to be used for searching, but not
for the Watchlist.
If you disable a Watchlist category, then the category is not available for users
to include in their watchlist, and all Watchlist items within the category are also
disabled.
Ultimately, the Watchlist for any user contains the subset of categories and items
that are enabled in the Set Watchlist Options page:
• Minus any categories or items that the user chooses to hide using
Watchlist preferences
• Minus any items with no results found, if the user chooses to hide such
items using Watchlist preferences
All Watchlist items have a predefined refresh interval, which controls how
often the query that calculates the count for a Watchlist item can be run. Use
the Set Watchlist Options page to edit the interval values. What you specify
as the refresh interval for a Watchlist item of type User-created Saved Search
applies to all Watchlist items based on saved searches created by users on the
corresponding search page.
When the user is in the Welcome dashboard with the Watchlist open for at least
two and a half minutes, the query automatically runs for all Watchlist items if
no refresh already ran in this user session. To subsequently run the query again,
users can manually refresh the Watchlist region. The Refresh icon is enabled
after five minutes since the last refresh.
Note
During a refresh, the query runs for an individual Watchlist item only if the time
since the last query for this item is equal to or greater than the specified refresh
interval. Since the manual refresh of the entire Watchlist is not available until five
minutes after the last refresh, you should not set a Watchlist item refresh interval
that is less than five minutes.
When users open Watchlist from the global area, a refresh automatically runs
if five minutes have passed since the last refresh. During this refresh, the query
runs for an individual Watchlist item only if the time since the last query for this
item is equal to or greater than the specified refresh interval.
For example, you set the interval to eight minutes for a particular Watchlist item.
When the user signs in and goes to the Welcome dashboard, with the Watchlist
open, the query automatically runs for this Watchlist item after two and a half
Five minutes after the query ran, the Refresh icon is enabled and the user
performs a manual refresh. However, the query does not run for this Watchlist
item, because the refresh interval is eight minutes. The user navigates away from
the Welcome dashboard and opens the Watchlist from the global area six minutes
later. A refresh automatically runs because more than five minutes have passed
since the last refresh. This time, the query runs for this Watchlist item because it
has been more than eight minutes since the query last ran for this item.
Note
Offerings also include application-specific tasks for managing Applications
Core objects. For example, the Financials offering includes tasks such as Manage
Receivables Descriptive Flexfields, and Manage Receivables Lookups.
For more information on configuring custom objects, see the Oracle Fusion
Applications Extensibility Guide.
To make the Maintain Common Reference Objects task list available in your
implementation project, go to Setup and Maintenance Overview - Configure
Offerings , and for a specific offering, select the Maintain Common Reference
Objects feature choice.
Hierarchy
• The application taxonomy hierarchy contains various levels and types of
nodes, or modules.
See: Characteristics of the Level Categories
See: Benefits of a Logical Hierarchy
Usage
• Use application taxonomy to understand relationships among
applications and between an application and its files. This information is
helpful in managing various phases of the product lifecycle.
See: How to Manage the Lifecycle
Product Line
Product Family
Application
Identifiers
Module ID is the unique primary key for nodes in the taxonomy table. When
you create a module, an ID is automatically generated. Once the module is
created, you cannot update the ID.
Module key and alternative ID are additional identifiers of the module,
presented in a way that is easier to read than the module ID. The module key is a
string identifier, for example AP for the Oracle Fusion Payables application. The
alternative ID is a numeric identifier, for example 1 for the Oracle Fusion product
line. These IDs are provided for the product line, product family, and application
modules, but you can optionally add them for logical business areas and new
custom modules.
Note
Do not change the module key or alternative ID for predefined modules.
The product code is relevant only to application and logical business area
modules. You can leave the field blank for other module types. The product code
for applications is the short name that can be displayed in lists of application
values, for example FND for Oracle Fusion Middleware Extensions for
Applications.
Names
Module name is the logical name for the module and is always available. The
name must be unique among nodes in the same hierarchy level with the same
parent, but try to make it as unique in the whole hierarchy as possible.
The user name and description can appear to users in other parts of Oracle
Fusion Applications, so make sure that the values are something that users know
to represent the module.
Usage Types
Though you can update the usage type to reflect the current state of the module,
just doing so does not affect the actual state. For example, setting a module
as installed does not mean it is actually installed if the installation itself has
Seed Data
If seed data is allowed, then seed data such as flexfields and lookups can be
extracted for the module using seed data loaders. By default, extract is allowed
for all predefined modules of type application and logical business area.
Associations
You can associate a logical domain to modules of type product family, as well
as one or more enterprise applications to modules of type application. This
association represents the relationship between the taxonomy modules and the
corresponding domain and enterprise applications stored in the Oracle Fusion
Applications Functional Core (ASK) tables.
Note
For specific information on configuring reference data sharing for a particular
object or product, refer to its product documentation.
Partitioning
The partitioning of reference data and creation of data sets enable you to create
reference entities across tables or lookup types, and share modular information
and data processing options among business units. With the help of partitioning,
you can choose to create separate sets and subsets for each business unit
depending upon its business requirement, or create common sets or subsets to
enable sharing reference data between several business units, without the need
for duplicating the reference data. Partitioning provides you the flexibility to
handle the reference data in a way appropriate to your business needs.
The following figure illustrates the reference data sharing method (assignment to
one set only, with common values) where the user can access the data assigned
to a specific set in a particular business unit, as well as access the data assigned
to the common set.
Determinant Types
Type Description
Asset Book Information about the acquisition, depreciation, and
retirement of an asset that belongs to a ledger or a
business unit.
Business Unit The departments or organizations within an
enterprise.
Cost Organization The organization used for cost accounting and
reporting on various inventory and cost centers
within an enterprise.
Project Unit A logical organization within an enterprise that
is responsible for enforcing consistent project
management practices.
Reference Data Set References to other shared reference data sets.
Reference Groups
Note
The reference groups are predefined in the reference groups table and are
available for selection and assignment.
Define Lookups
Lookups: Explained
Lookups are lists of values in applications. You define a list of values as a lookup
type consisting of a set of lookup codes, each code's translated meaning, and
optionally a tag. End users see the list of translated meanings as the available
values for an object.
Lookups provide a means of validation and lists of values where valid values
appear on a list with no duplicate values. For example, an application might
store the values Y and N in a column in a table, but when displaying those
values in the user interface, Yes or No (or their translated equivalents) should be
available for end users to select. For example, the two lookup codes Y and N are
defined in the REQUIRED_INDICATOR lookup type.
In another example, a lookup type for marital status has lookup codes for users
to specify married, single, or available legal partnerships.
Use lookups to provide validation or a list of values for a user input field in a
user interface.
An example of a lookup used for validation is a flexfield segment using a
table-validated value set with values from a lookup type. An example of a
lookup in a list of values is a profile option's available values from which users
select one to set the profile option. Invoice Approval Status gives the option of
including payables invoices of different approval statuses in a report. The lookup
code values include All so that users can report by all statuses: Approved,
Resubmitted for approval, Pending or rejected, and Rejected.
Customization Level
The customization level of a lookup type determines whether the lookups in that
lookup type can be edited. This applies data security to lookups.
Some lookup types are locked so no new codes and other changes can be added
during implementation or later, as needed. Depending on the customization
level of a lookup type, you may be able to change the codes or their meanings.
Some lookups are designated as extensible, so new lookup codes can be created
during implementation, but the meanings of predefined lookup codes cannot be
modified. Some predefined lookup codes can be changed during implementation
or later, as needed.
The customization levels are user, extensible, and system. The following table
shows which lookup management tasks are allowed at each customization level.
Lookup Description
Standard Lists the available codes and translated meanings
Set enabled Additionally associates a reference data set with the
lookup codes
Common Legacy lookups
Standard lookups are the simplest form of lookup types consisting only of codes
and their translated meaning. They differ from common lookups only in being
defined in the standard lookup view.
Common lookups exist for reasons of backward compatibility and differ from
standard lookups only in being defined in the common lookup view.
Set enabled lookup types store lookup codes that are enabled for reference data
sharing. At runtime, a set-enabled lookup code is visible because the value of the
determinant identifies a reference data set in which the lookup code is present.
Accessing Lookups
Standard, set-enabled, and common lookups are defined in the Standard, Set-
enabled, and Common views, respectively. Applications development may
define lookups in an application view to restrict the UI pages where they may
appear.
In lookups management tasks, lookups may be associated with a module in the
application taxonomy to provide a criteria for narrowing a search or limiting
the number of lookups accessed by a product specific task such as Manage
Purchasing Lookups.
Enabling Lookups
For more information on the predefined lookups and lookup codes, see assets
with the Lookup type in the Oracle Enterprise Repository for Oracle Fusion
Applications (http://fusionappsoer.oracle.com).
Note
You can only create or edit the lookup codes for a particular lookup type if its
customization level supports it.
The lookup codes you define for the COLORS lookup type are, BLUE, RED,
GREEN, and YELLOW.
Analysis
The BLUE lookup code was not enabled and does not appear in the list of values.
The display sequence of values in the list of values is alphabetical unless you
enter a number manually to determine the order of appearance. Number 1
indicates the value listed first in the list of values.
Note
Only lookups that are enabled and active, meaning between start and end dates,
are visible.
When users enter one of the values from the list of values for the lookup type
COLORS, the transaction table records the lookup code. In this example, the
code is stored in the Status column
The status for one user is BLUE because at the time they entered a value, BLUE
was enabled. Disabling a lookup code does not affect transaction records in
which that code is stored. Data querying and reporting have access to disabled
lookup codes in transaction tables.
Note
You can only create or edit the lookup codes for a particular lookup type if its
customization level supports it.
The reference data set for a set-enabled lookup code is part of its foreign key.
This is unlike other set-enabled entities.
Using the Manage Set Assignments task, you have defined assignments that
designate the China business unit to refer to the CHINA and the US business
unit to refer to the US and all business units to refer to the COMMON set.
When end users place a contract hold in the US business unit, only the three
reason codes in US_SET are available. When placing a contract hold in the China
business, only the two codes in China_SET are available.
You can edit the existing lookup codesof a lookup type or add new lookup codes
on the Define Lookups pages, which you can access by starting in the Setup and
Lookups are listed by lookup type. Typically lookup types are managed using
tasks that handle a group of related lookups, such as Manage Geography
Lookups. Each task gives you access only to certain lookup types. The generic
tasks provide access to all lookups types of a kind, such as all common lookups
using the Manage Common Lookups task.
If existing lookups are not available to the tasks of the Define Lookups activity,
they may be validated for use in a lookup view that is not central to all
applications or whose owning application has not been specified in a lookup
view.
Lookups can only be managed in the Define Lookups tasks if the lookup's view
application is the standard lookups view, common lookups view, or set-enabled
lookups view. Lookups defined in an application view can only be managed by
following instructions provided by the owning application.
Note
A lookup type and its codes can only be defined in one lookup view.
A lookup type consists of lookup codes that are the values in a static list of
values. Lookup code validation is a one to one match.
A table-validated value set can consist of values that are validated through a
SQL statement, which allows the list of values to be dynamic.
Tip
A table validated value set can be defined based on any table, including the
lookups table. This allows a lookup type to be made into a table-validated value
set that can be used in flexfields.
Both lookup types and value sets are used to create lists of values from which
users select values.
Tags on lookup codes allow you to add a label to your lookup codes.
Lookup tags are unvalidated and uninterpreted by lookups. A tag can be used
to categorize lookups based on facilitating searches or guiding how a lookup
should be used.
Document what the tag on a lookup represents and how to use it.
Manage Messages
Messages: Highlights
The message dictionary contains messages that tell users about business rule
errors, such as missing or incorrect data, and how to resolve them, to warn users
about the consequences of intended actions, and provide information in log files.
These messages are defined for specific applications and modules, but a few are
common messages that can be used in any application. All applications also use
messages stored outside of the message dictionary.
The message dictionary is described in the Oracle Fusion Applications
Developer's Guide, and other messages in the Oracle Fusion Middleware
Web User Interface Developer's Guide for Oracle Application Development
Framework.
Managing Messages
• Use the Manage Messages page to create and edit custom messages in the
message dictionary, as well as edit predefined messages. Do not delete
predefined messages unless you are sure that they are not used anywhere.
Refer to the Oracle Fusion Applications Developer's Guide.
See: Introduction to Message Dictionary Messages
See: Displaying Hints and Error Messages for Validation and Conversion
Each message in the message dictionary has many attributes and components,
including message properties, text, and tokens, that you define when creating or
editing the message.
Details about these messages are described in the Oracle Fusion Applications
Developer's Guide.
Message Properties
• The message type identifies the type of information that the message
contains.
You can create custom common messages for use in multiple places within
a single product. Do not begin the message name with FND_CMN, but use
another suitable convention. The message number should be within the range
that is designated for the product.
Currency Codes
You cannot change a currency code after you enable the currency, even if you
later disable that currency.
Date Ranges
Users can enter transactions denominated in the currency only for the dates
within the specified range. If you do not enter a start date, then the currency is
Symbols
Even if you enter a symbol for a currency, the symbol is not always displayed
when an amount is displayed in this currency. Some applications use currency
symbols when displaying amounts. Others, like Oracle Fusion General Ledger,
do not.
Use the Derivation Type, Derivation Factor, and Derivation Effective Date fields
to define the relationship between the official currency (Euro) of the European
Monetary Union (EMU) and the national currencies of EMU member states. For
each EMU currency, you define its Euro-to-EMU fixed conversion rate and the
effective starting date.
Note
If you need to use a different currency code for Euro, you can disable the
predefined Euro currency and create a new one.
Derivation Type
The Euro currency derivation type is used only for the Euro, and the Euro
derived derivation type identifies national currencies of EMU member states. All
other currencies do not have derivation types.
Derivation Factor
The derivation factor is the fixed conversion rate by which you multiply one
Euro to derive the equivalent EMU currency amount. The Euro currency itself
should not have a derivation factor.
The derivation effective date is the date on which the relationship between the
EMU currency and the Euro begins.
Natural languages are all the languages that humans use, written and spoken.
If a language is enabled, then users can associate it with entities, for example as
languages spoken by sales representatives. When managing natural languages,
consider tasks to perform and best practices for entering particular values.
Once you add a language, it cannot be deleted, just disabled. You can optionally
associate natural languages with International Organization for Standardization
(ISO) languages and territories, just for reference.
Values
When you create a natural language, use the alpha-2 ISO code as the language
code, or, if not available, then alpha-3. If the language is not an ISO language,
then use x- as a prefix for the code, for example x-ja for a Japanese dialect.
Use the sgn code of ISO-639-2 for sign languages, followed by territory code,
for example sgn-US for American Sign Language. You can also use Internet
Assigned Numbers Authority (IANA) language tags.
The natural language description should be the language name with territory
name in parenthesis where needed, for example English (Australia) and English
(Canada).
Edit industry descriptions to determine how they are displayed in Oracle Fusion
Applications. You usually would not edit industry names, which are from the
North American Industry Classification System (NAICS). Enabled industries are
mainly used in the context of customization, though these values can also appear
in any application.
Create industries if you have particular ones you need, for example for
customization, that are not included in the NAICS standard.
Create currencies to use, for example for reporting purposes, if they are not
already provided. All currencies from the International Organization for
Standardization (ISO) 4217 standard are provided.
Enable any currency other than USD for use in Oracle Fusion Applications, for
example for displaying monetary amounts, assigning to sets of books, entering
transactions, and recording balances. Only USD is enabled by default.
Precision is the number of digits to the right of the decimal point used in regular
currency transactions. Extended precision is the number of digits to the right
of the decimal point used in calculations for this currency, and it must be
greater than or equal to the standard precision. For example, USD would have
2 for precision because amounts are transacted as such, for example $1.00. For
calculations, for example adding USD amounts, you might want the application
to be more precise than two decimal digits, and would enter an extended
precision accordingly.
Note
Some applications use extended precision. Others, such as Oracle Fusion General
Ledger, do not.
Minimum accountable unit is the smallest denomination for the currency. For
example, for USD that would be .01 for the cent. This unit does not necessarily
correspond to the precision for all currencies.
The statistical unit currency type is used only for the Statistical (STAT) currency.
The Statistical currency is used to record statistics such as the number of items
bought and sold. Statistical balances can be used directly in financial reports,
allocation formulas, and other calculations.
You can edit the names and descriptions of International Organization for
Standardization (ISO) languages to determine how they are displayed in lists
of ISO language values in Oracle Fusion Applications. The ISO languages are
from the ISO 639 standard. If there were changes to the ISO standard and the
system has not yet been patched with the latest ISO values, you can update the
ISO alpha-2 code or add languages as needed.
Though all standard time zones are provided, optionally enable only a subset for
use in lists of time zone values in Oracle Fusion Applications. You can add time
zones if new zones became standard and the system has not yet been patched
with the latest values.
Tip
When extending the reference implementation with additional data security
policies, identify instance sets of data representing the business objects that
need to be secured, rather than specific instances or all instances of the business
objects.
Predefined data security policies are stored in the data security policy store,
managed in the Authorization Policy Manager (APM), and described in the
Warning
Review but do not modify HCM data security policies in APM except as a
custom implementation. Use the HCM Manage Data Role And Security Profiles
task to generate the necessary data security policies and data roles.
Data Roles
When you provision a job role to a user, the job role implicitly limits data
access based on the data security policies of the inherited duty roles. When you
provision a data role to a user, the data role explicitly limits the data access of the
inherited job role to a dimension of data.
The sets of data that a user can access via roles are defined in Oracle Fusion Data
Security. Oracle Fusion Data Security integrates with Oracle Platform Security
Services (OPSS) to entitle users or roles (which are stored externally) with access
to data. Users are granted access through the entitlement assigned to the roles
or role hierarchy with which the user is provisioned. Conditions are WHERE
clauses that specify access within a particular dimension, such as by business
unit to which the user is authorized.
Data security policies articulate the security requirement "Who can do What
on Which set of data," where 'Which set of data' is an entire object or an object
instance or object instance set and 'What' is the object entitlement.
For example, accounts payable managers can view AP disbursements for their
business unit.
• Table or view
Note
Some data security policies are not defined as grants but directly in applications
code. The security reference manuals for Oracle Fusion Applications offerings
differentiate between data security policies that define a grant and data security
policies defined in Oracle Fusion applications code.
Data security policies that use job or duty roles refer to data security entitlement.
For example, the data security policy for the Accounts Payable Manager job role
refers to the view action on AP disbursements as the data security entitlement.
Important
The duty roles inherited by the job role can be moved and job roles reassembled
without having to modify the data security.
For example, a Sales Party Management Duty can update Sales Party where
the provisioned user is a member of the territory associated with the sales
account. Or the Sales Party Management Duty can update Sales Party where
the provisioned user is in the management chain of a resource who is on the
sales account team with edit access. Or the Participant Interaction Management
Duty can view an Interaction where the provisioned user is a participant of the
Interaction.
A data security policy identifies the entitlement (the actions that can be made on
logical business objects or dashboards), the roles that can perform those actions,
and the conditions that limit access. Conditions are readable WHERE clauses.
The WHERE clause is defined in the data as an instance set and this is then
referenced on a grant that also records the table name and required entitlement.
Data Roles
Data roles are implemented as job roles for a defined set of data.
A data role defines a dimension of data within which a job is performed. The
data role inherits the job role that describes the job. For example, a data role
entitles a user to perform a job in a business unit.
The data role inherits abstract or job roles and is granted data security privileges.
Data roles carry the function security privileges inherited from job roles and also
the data security privilege granted on database objects and table rows.
Data roles are created using data role templates. You create and maintain data
roles in the Authorization Policy Manager (APM). Use the Manage Data Roles
and Security Profiles task to create and maintain HCM data roles in Oracle
Fusion HCM.
HCM security profiles are used to secure HCM data, such as people and
departments. You use HCM security profiles to generate grants for an enterprise
role. The resulting data role with its role hierarchy and grants operates in the
same way as any other data role.
For example, an HCM security profile identifies all employees in the Finance
division.
Oracle Fusion Payroll uses HCM security profiles to secure project organizations.
Applications outside of HCM can use the HCM Data Roles UI pages to give their
roles access to HR people.
The database resource defines and instance of a data object. The data object is a
table, view, or flexfield.
The following figure shows the database resource definition as the means by
which a data security policy secures a data object. The database resource names
the data object. The data security policy grants to a role access to that database
resource based on the policy's action and condition.
Database Resources
A database resource specifies access to a table, view, or flexfield that is secured
by a data security policy.
Note
If the data security policy needs to be less restrictive than any available database
resource for a data object, define a new data security policy.
Actions
Actions correspond to privileges that entitle kinds of access to objects, such as
view, edit, or delete. The actions allowed by a data security policy include all or a
subset of the actions that exist for the database resource.
Conditions
A condition is either a SQL predicate or an XML filter. A condition expresses
the values in the data object by a search operator or a relationship in a tree
hierarchy. A SQL predicate, unlike an XML filter, is entered in a text field in the
data security user interface pages and supports more complex filtering than an
XML filter, such as nesting of conditions or sub queries. An XML filter, unlike a
SQL predicate, is assembled from choices in the UI pages as an AND statement.
Tip
An XML filter can be effective in downstream processes such as business
intelligence metrics. A SQL predicate cannot be used in downstream metrics.
Grants
Note
Attribute level security using grants requires a data security policy to secure the
attribute and the entitlement check enforces that policy.
Note
Note
HCM data roles are generated using the Manage Data Roles and Security Profiles
task, which uses HCM security profiles, not data role templates, to define the
data security condition.
• Template name
• Template description
• Template group ID
• Base roles
• Data dimension
The data role template specifies which base roles to combine with which
dimension values for a set of data security policies. The base roles are the parent
job or abstract roles of the data roles.
Note
Abstract, job, and data roles are enterprise roles in Oracle Fusion Applications.
Oracle Fusion Middleware products such as Oracle Identity Manager (OIM)
and Authorization Policy Manager (APM) refer to enterprise roles as external
roles. Duty roles are implemented as application roles in APM and scoped to
individual Oracle Fusion Applications.
When you generate data roles, the template applies the values of the dimension
and participant data security policies to the group of base roles.
The template generates the data roles using a naming convention specified
by the template's naming rule. The generated data roles are stored in the
Lightweight Directory Access Protocol (LDAP) store. Once a data role is
generated, you provision it to users. A user provisioned with a data role is
granted permission to access the data defined by the dimension and data
security grant policies of the data role template.
If you add a base role to an existing data role template, you can generate a
new set of data roles. If the naming rule is unchanged, existing data roles are
overwritten.
If you remove a base role from a data role template and regenerate data roles, a
resulting invalid role list gives you the option to delete or disable the data roles
that would be changed by that removal.
If you add a dimension value to your enterprise that is used by a data role
template, you must regenerate roles from that data role template to create a
data role for the new dimension. For example if you add a business unit to your
enterprise, you must regenerate data roles from the data role templates that
include business unit as a dimension.
If you add or remove a dimension value from your enterprise that is used to
generate data roles, regenerating the set of data roles adds or removes the data
roles for those dimension values. If your enterprise has scheduled regeneration
as an Oracle Enterprise Scheduler Services process, the changes are made
automatically.
Note
Plan your document sequencing carefully before you use the options available
in the application to apply sequence numbers. Avoid changes to the options
after you saved your work on the Manage Document Sequences and Manage
Document Sequence Categories pages.
Automatic Sequencing
Automatic document sequencing assigns a unique number to each document
as it is generated, and this unique number is stored in the database. The
numbering is sequential by date and time of creation. If you define a sequence to
automatically number documents, you can provide an initial value to begin the
sequence. In absence of a custom value, the default value 1 is used.
Manual Sequencing
Manual sequencing requires you to assign a unique number to each document
before it is generated. In manual sequencing, the numerical ordering and
completeness of a transaction is not enforced. Users can skip or omit numbers
when entering the sequence value. However, each time that a number is
assigned, the application validates its uniqueness.
Gapless Sequencing
Gapless sequencing is similar to automatic sequencing. It automatically
generates a unique number for each document, but does that only for
successfully generated documents. As a result, the sequence is maintained for
all the documents that are generated, and no sequence numbers are lost due to
incomplete or failed document generation.
Use this type of sequencing only if necessary because it may affect the
performance of the system and slow down transaction processing.
Restriction
Once you create a document sequence category, it is available for use under
the Document Sequences: Assignments section on the Manage Document
Sequences page. The Category field contains the name of the document sequence
category. After you create a document sequence, you can assign it to a document
sequence category.
Note
You can create document sequences that are automatic, manual, or gapless,
depending on the business or legal requirement. By default, the current date
is considered as the start date. If the end date is left blank, it means that the
sequence definition never expires. Among the several options used in creating
and editing document sequences, the following options are functionally more
important and therefore need to be carefully determined:
• Determinant Type: Select to limit the document sequencing activity to
certain documents that belong to a specific business entity, such as Ledger,
Tax Registration, and so on.
• Initial Value: Enter a value for the first document in your sequence. This
field applies only to sequences with automatic or gapless numbering
types. Sequence numbers should not be greater than eight digits. If you
leave this field blank, the first document is automatically assigned a value
of 1. Once a document sequence is defined, you cannot change this initial
value.
You can audit document sequences, if required, to provide an audit trail of the
document sequences used in a specific product. However, before enabling the
audit functionality for a document sequence, you must have created an audit
table for the specific document sequence, using appropriate details. Enabling the
audit functionality is permitted only for newly created document sequences. You
cannot audit document sequences that are already in use by a specific product.
For more information about defining a document sequence audit table, see the
Oracle Fusion Applications Developer's Guide.
Define Trees
Trees: Overview
Use the tree management feature in Oracle Fusion applications to organize data
into hierarchies. A hierarchy contains organized data and enables the creation
of groups and rollups of information that exist within an organization. Trees are
hierarchical structures that enable several data management functions such as
better access control, application of business rules at various levels of hierarchies,
improved query performance, and so on.
For example, XYZ Corporation has two departments: Marketing and Finance.
The Finance department has two functional divisions: Receivables and Payables.
Defining a tree for the XYZ Corporation establishes a hierarchy between the
organization and its departments, and between the departments and their
respective functional divisions. Such a hierarchical modeling of organizational
data could be used for executing several data management functions within that
organization.
You can create one or more versions of trees, and they can be labeled for better
accessibility and information retrieval. You can create trees for multiple data
sources, which allow the trees to be shared across Oracle Fusion applications.
Tree Structures
A tree structure is a representation of the data hierarchy, and guides the creation
of a tree. A tree is an instance of the hierarchy as defined in the tree structure.
Tree structures enable you to enforce business rules to which the data must
adhere.
The root node is the topmost node of a tree. Child nodes report to the root node.
Child nodes at the same level, which report to a common parent node, are called
siblings. Leaves are details branching off from a node but not extending further
down the tree hierarchy.
Tree Versions
A tree is created having only one version. However, users can create more than
one tree version depending on the need, and they can make changes to those
Tree Labels
Tree labels are short names associated with trees and tree structures and point
directly to the data source. Tree labels are automatically assigned to the tree
nodes. You can store labels in any table and register the label data source with
the tree structure.
A tree structure defines the hierarchy for creating trees and prescribes rules
based on which trees are created, versioned, and accessed. You can associate
multiple data sources with a tree structure. A tree is an instance of this hierarchy.
Every tree structure can contain one or more trees.
You can create tree structures specific to an application but you can share tree
structures across applications. If you apply version control to the tree structure, it
is carried over to the trees that are based on the tree structure. Each tree version
contains at least one root node. Occasionally, a tree version may have more than
one root node.
An administrator controls the access to tree structures through a set of rules that
are periodically audited for validity.
The Tree Node table displays data in nodes that exist in the data hierarchy.
You must select the correct and most appropriate tree node table to be able to
define the tree structure, based on the tree hierarchy you want to establish. This
selection also affects the level of security that is set on a tree node and its child
entities.
The following options are used to determine the mode of sharing a tree structure
across the applications.
• Open: Indicates that the tree is associated with all reference data sets.
• Set ID: Indicates that the tree will be associated with a specific reference
data set.
Indicates the source where the tree structure is being defined. For predefined tree
structures select Oracle and for custom structures, select Customers.
Customization
You can customize the predefined tree structures as well as the ones that
you created. However, customizing the predefined tree structures involves
certain level of access restrictions, and will be limited to specific tree nodes and
downwards in hierarchy.
One or more trees and tree versions can be based on a tree structure. A tree
structure can have one or more trees and tree versions based on it. Usually, only
one active version is permitted at any given point of time. However, depending
on the requirement, you can allow two or more tree versions to be in the active
state for the same date range. This flexibility allows you to choose the tree
version that you want to implement.
You can create, edit, and delete tree structures depending upon the requirement.
You can also audit and change the status a tree structure.
You can create trees on the basis of a tree structure. When you edit an active
tree structure, the status of the tree structure and all associated trees and their
versions change to draft. To reuse a tree structure, you can create a copy of
it without copying the associated trees and tree versions. If you delete a tree
structure, all the associated trees and tree versions are automatically deleted.
Note
For specific information on working with the predefined tree structures that exist
in an Oracle Fusion application, refer to the specific product documentation.
Setting Status
If you change the status of a tree structure, the status of the trees and tree
versions associated with that tree structure also changes.
Status Meaning
Draft Yet to be published or is in a modified state.
Use the tree structure audit results to verify the tree structure's correctness and
data integrity. The audit results include the following details:
Running an Audit
Setting the status of a tree structure to active automatically triggers an audit of
that tree structure. You can also manually trigger an audit on the manage Tree
Structures page, using Actions - Audit . The Tree Structure Audit Result table
shows a list of validations that ran against the selected tree structure.
Validation Details
The following table lists the validators used in the audit process and describes
what each validator checks for. It also lists possible causes for validation errors
and suggests corrective actions.
• Any common
attribute that exists
in both the data
source view object
and the tree node
view object is not
of the same data
type in both view
objects.
The data sources provide the items for establishing hierarchy in a tree structure.
In the tree management infrastructure, these data sources are Oracle Application
Note
Data sources form the foundation for tree management in Oracle Fusion
Applications. Tree structures, trees, and tree versions establish direct and
real-time connectivity with the data sources. Changes to the data sources
immediately reflect on the Manage Trees and Tree Versions page and wherever
the trees are being used.
Metadata
Tree structures contain the metadata of the actual data that is used in Oracle
Fusion Applications. Tree structures contain the core business logic that is
manifested in trees and tree versions.
Data Storage
Trees and tree versions are built upon the tree structures. They employ the
business rules defined in the tree structures and allow an application to select
and enable a subset of trees to fulfill a specific purpose in that application.
Access Control
Source data is mapped to tree nodes at different levels in the database. Therefore,
changes you make to the tree nodes affect the source data. Access control set on
trees prevents unwanted data modifications in the database. Access control can
be applied to the tree nodes or anywhere in the tree hierarchy.
Tree nodes are points of data convergence that serve as the building blocks of a
tree structure. Technically, the node may be stored either in a product-specific
table or in an entity that has been established by tree management as the default
Nodes are attached to tree versions. Whenever you create or edit a tree version,
you need to specify its tree node.
You can create, modify, or delete tree nodes on the Tree Version: Specify Nodes
page. To add a tree node, ensure that the tree structure with which the tree
version is associated is mapped to a valid data source. You can also duplicate a
tree node if the multiple root node feature is enabled.
Node Levels
In most trees, all nodes at the same level represent the same kind of information.
For example, in a tree that reflects the organizational hierarchy, all division nodes
appear on one level and all department nodes on another. Similarly, in a tree that
organizes a user's product catalog, the nodes representing individual products
might appear on one level and the nodes representing product lines on the next
higher level.
When levels are not used, the nodes in the tree have no real hierarchy or
reporting structure but do form a logical summarization structure. Strictly
enforced levels mean that the named levels describe each node's position in the
tree. This is natural for most hierarchies. Loosely enforced levels mean that the
nodes at the same visual level of indentation do not all represent the same kind
of information, or nodes representing the same kind of information appear at
multiple levels. With loosely enforced levels, users assign a level to each node
individually. The level is not tied to a particular visual position.
Node Types
• Range: Indicates that the node represents a range of values and possibly
could have many children. For example, a tree node representing account
numbers 10000 to 99999.
• Referenced Tree: Indicates that the tree node is actually another version
for the tree based on the same tree structure, which is not physically
stored in the same tree. For example, a geographic hierarchy for the
United States can be referenced in a World geographic hierarchy.
Use Import Segment Values and Hierarchies process to load segment values
and hierarchies if you maintain your chart of accounts reference data outside
Oracle Fusion applications. You can load your segment values and hierarchies
by populating two tables: GL_SEGMENT_VALUES_INTERFACE table and
Note
You can load data to interface tables using predefined templates and the Load
Interface File for Import scheduled process, which are both part of the External
Data Integration Services for Oracle Cloud feature. For other implementations,
optionally use this feature only if you have SFTP configured for it.
The following columns should be left as null as Import Segment Values and
Hierarchies process uses them for internal processing or does not use them in the
current release.
• CREATION_DATE
• CREATED_BY
• LAST_UPDATE_DATE
• LAST_UPDATE_LOGIN
• LAST_UPDATED_BY
• SEGMENT_VALUE_INTERFACE_ID
• REQUEST_ID
• LOAD_REQUEST_ID
• CREATION_DATE
• CREATED_BY
• LAST_UPDATE_DATE
• LAST_UPDATE_LOGIN
• LAST_UPDATED_BY
• SEGMENT_VALUE_INTERFACE_ID
• REQUEST_ID
• LOAD_REQUEST_ID
Loading Data to the Segment Value and Hierarchies Interface Tables: Explained
Load the segment values and hierarchies to the interface table by using the
following steps.
You can add and configure new profile options in addition to configuring
predefined profile options that are implemented as updateable.
The Manage Profile Option Values task flow allows an administrator to set
updatable profile option values at the available levels, including the user level.
You can access the Manage Profile Option Values task starting in the Setup and
Maintenance Overview page and searching for profile option tasks.
You can set profile option values at different levels: site, product, and user. The
following table provides examples.
Profile Option Level Value of the Profile Profile Option Value Effect
Option Level
User Manager1 UK pound sterling Access to site and all
products shows UK
pounds sterling in effect
User Manager2 US dollar Access to site and all
products shows US
dollars in effect
Product Financials for EMEA Euro Unless superseded by a
user level value, Euros in
effect for Financials for
EMEA applications
Categories group profile options based on their functional area. Profile option
categories facilitate searching and defining data security.
The hierarchy levels specified in the profile option definition determine the
context in which a profile option value may be set. If the profile option value at
a particular level is updatable, an administrator can update the profile option
value for that context.
Note
Profile options should only be enabled for context levels that are appropriate
for that profile option. For example, a profile option indicating a global
configuration setting should not be enabled at the user level, if users cannot
choose a different value for that setting.
For security, one level in the hierarchy is designated as a user level. A profile
option may be enabled at any or all hierarchy levels. When enabled at all levels,
the predefined ordering of profile option hierarchy levels gives precedence to the
values that are set at the user level over values set at the product and site levels,
and precedence to values set at the product level to values set at the site level. If
there is no value for the current user, then the product value applies. If there is
no value for the user or product, then the site value applies.
The table shows the predefined profile option hierarchy and ordering.
You can configure updatable values for profile options at one or more levels
depending on which levels are enabled in the profile option definition. When a
profile is set at more than one level, higher levels of specificity override lower
levels of specificity.
In the example, if the currency setting for the site is UK pounds sterling, but
the Financials division works in the Netherlands using the Euro, a manager in
the US can override that product level setting at the user level to use US dollars
when accessing Financials applications.
In another example, if a profile option called Printer is set only at the site and
product levels. When a user logs on, the Printer profile option assumes the value
set at the product level, since it is the highest level setting for the profile.
Tip
Set site-level profile option values before specifying values at any other level.
The profile option values specified at the site-level work as defaults until profile
option values are specified at the other levels.
For more information on the predefined profile options, see assets with the
Profile Option type in the Oracle Enterprise Repository for Oracle Fusion
Applications (http://fusionappsoer.oracle.com).
The following aspects assist you in better planning how to manage profile
options.
Users may be able to set their own profile options, depending on settings in the
profile option definition. However, not all profile options are visible to end users,
and some profile options, while visible, may not be updated by end users.
The following table lists tasks and considerations relevant to planning profile
options.
Note
Profile options are best defined for managing configuration data centrally and
influencing the behavior of applications.
Do not use profile options to capture a dynamic system states, such as data
stored in a temporary table. Use Global Variables for temporary states instead.
Evaluate if there is a genuine need before creating a profile option. Do not force
users to make a decision about an aspect of their application use that is of no
concern.
Evaluating need includes looking for duplicate or similar profile options, even
in other products, before creating a new one. For example, you do not need
multiple profile options to choose a preferred currency.
The profile option data model illustrates the relationships among profile option
elements.
The figure shows the data model of profile option entities.
For more information about planning profile options, see the Oracle Fusion
Applications Developer's Guide.
Profile options should only be enabled for context levels that are appropriate
for that profile option. For example, a profile option indicating a global
configuration setting should not be enabled at the user level, if users cannot
choose a different value for that setting.
SQL Validation
The SQL validation of the profile option definition determines what valid profile
option values are available. In the absence of validation, any value is valid.
For example, SQL validation provides a means of defining a list of values for the
valid values of the profile option. The SQL validation can use lookups to provide
the valid values for profile options, such as the lookup codes of the YES_NO
lookup type.
Tip
Define profile option categories first and assign new profile options to existing
categories rather than defining profile options first and then defining categories
to categorize them.
You can create a profile option category by duplicating an existing category and
editing it for a new grouping of profile options. You can add multiple profile
options to a category. A profile option can exist in multiple categories.
Specify a profile option sequence to determine the order of profile options when
queried by profile option category.
A profile option value consists of the value and the context or level where the
value is set. You specify the context with a pairing of the profile option value's
level and level value, such as the product level and the level value GL for Oracle
Fusion General Ledger. Adding or modifying profile option values can include
deciding which valid values are enabled or updatable at which level.
The SQL validation of the profile option definition determines what valid profile
option values are available. In the absence of validation, any value is valid.
Site level profile option values affect the way all applications run for a given
implementation. Product level profile option values affect the way applications
owned by a particular product code behave. For example, a product may use
profile options set at the product level to determine how regions provided
by a common module such as those available from Oracle Fusion Trading
Community Model or Customer Relationship Management (CRM) display in
a particular work area or dashboard. User level profile option values affect the
way applications run for a specific application user
Whichever profile option value is most specific to a user session, that is the value
at which the profile option is set for the user session.
Values at the site level take effect for any user unless overridden by a different
value set at the more specific levels of product and user. Product level profile
option values affect the way applications owned by a particular product code
behave. In addition to user level profile option values in applications, selections
may be available in the user preferences workspace.
Note
More than one site level value is relevant in an enterprise with multiple tenants
using a single instance of Oracle Fusion Applications.
Any change you make to a user level profile option has an immediate effect on
the way applications run for that session. When you sign in again, changes made
to your user level profile options in a previous session are still in effect. When
you change profile option value at the product level and no user level values are
set, you see the update immediately, but other users may not see the changed
value until signing out and back in. When you change a profile option value and
Changes to site level profile options take effect for any user session that is started
after the setting has been changed. Changes to site or user level profile options
do not affect any user sessions that are already in progress when the change is
made.
Changes to site or user level profile options take effect for any C or PL/SQL
processes, such as scheduled jobs, that are launched after the setting has been
changed. Profile option changes do not affect C or PL/SQL processes that are
already running.
Define Flexfields
Flexfields: Overview
Flexfields are a mechanism for configuring and extending applications to meet
enterprise-specific needs. Using flexfields, you can extend application objects
to capture data that would not otherwise be tracked by the application, or
configure intelligent key codes comprised of meaningful parts according to your
business practices. Flexfields encapsulate all of the pieces of information related
to a specific purpose, such as a key identifying a particular purchase, or the
components of a student's contact information, or the features of a product in
inventory.
Accessing Flexfields
Manage flexfields using tasks you access by starting in the Setup and
Maintenance Overview page.
Tip
For lists of flexfields, see assets with the Flexfield: Descriptive, Flexfield:
Extensible, or Flexfield: Key type in Oracle Enterprise Repository for Oracle
Fusion Applications (http://fusionappsoer.oracle.com).
Types of Flexfields
The following three types of flexfields are available in Oracle Fusion
Applications and provide a means to customize applications features without
programming.
• Key
• Descriptive
• Extensible
For example, in Oracle Fusion Financials, key flexfields represent objects such
as accounting codes and asset categories. Generally, correct operations of a
product depend on key flexfield setup. In Oracle Fusion Payables, a descriptive
flexfield expands a customizable area of an invoices page by providing subfields
for collecting invoice details. You can implement these subfields, which are
descriptive flexfield segments, as context sensitive so they appear only when
needed. Extensible flexfields are similar to descriptive flexfields, but provide
additional advanced features. Generally setup of descriptive and extensible
flexfields is optional because their segments capture additional information that
is stored attributes on an entity
Segments
All flexfields consist of segments. Segments represent attributes of information.
They can appear globally wherever the flexfield is implemented, or based on a
structure or context.
You define the appearance and meaning of individual segments when
configuring a flexfield.
A key flexfield segment commonly describes a characteristic of the entity
identified by the flexfield, such as a part number structured to include
information about the type, color, and size of an item. A descriptive flexfield
segment represents an attribute of information that describes a characteristic
of the entity identified on the application page, such as details about a device
containing components, some of which are globally present on the page while
others are contextually dependent on the category of the device.
Value Sets
A value set is a predefined, named group of values that can be used to validate
the content of a flexfield segment.
You configure a flexfield segment with a value set that establishes the valid
values that an end user can enter for the segment. You define the values in a
value set, including such characteristics as the length and format of the values.
You can specify formatting rules, or specify values from an application table or
predefined list. Multiple segments within a flexfield, or multiple flexfields, can
share a single value set.
Deployment
A flexfield must be deployed to display its current definition in a runtime
application user interface. For example, if the deployment status is Edited, the
flexfield segments may appear in the UI based on the flexfield definition at the
time of last deployment, rather than the current definition.
You can deploy a flexfield as a sandbox for testing the configuration before
deploying it to the mainline for all users. In the case of extensible flexfields, you
can deploy offline as a background process.
Runtime Appearance
In an application user interface, descriptive flexfield segments appear as label
and field pairs or as a table of fields where the column headers correspond to the
labels. The fields represent the flexfield segments and accept entered input or a
selection from a list of choices that correspond to the segment's assigned value
set. Extensible flexfield segments appear grouped within labeled regions, where
each grouping is a context and the region labels are the context names.
You can use Oracle Composer to edit the layout, position, or other display
features of the flexfield segments.
The figure shows the layers of a flexfield: the business entity table and metadata
in the database, business components that are Application Development
Framework (ADF) objects or ADFbc objects derived from the metadata and
stored in the Metadata Services Repository (MDS), and the user interface where
the input fields defined by the flexfield segments are rendered. The flexfield
definition consists of all the metadata defined during configuration and stored in
the database.
Integration
A flexfield affects the Web Services Description Language (WSDL) schemas
exposed by ADF services and used by SOA composites. The Web services that
expose base entity data also expose flexfield segment data.
Attributes incorporate into SOA infrastructure (BPEL, Rules) and integrate
with business intelligence (Oracle Business Intelligence, Extended Spread Sheet
Database (ESSbase)).
Flexfield configurations are preserved across Oracle Fusion Applications
updates.
Deployment
The metadata for the flexfield is stored in the application database as soon as
you save your configuration changes. Deploying the flexfield generates the
ADF business components so that the runtime user interface reflects the latest
definition of the flexfield in the metadata.
Runtime
For a flexfield to reflect the latest flexfield definition at runtime it must be
deployed. The user interface accesses a business object and the deployed
flexfield definition indicates which business object attributes the flexfield
captures values for. If you add display customizations for a flexfield using
Oracle Composer, these are customizations on the page so that the same flexfield
segments can appear differently on various different pages.
Values entered for segments are validated using value sets.
Flexfield Management
Registering Flexfields
Planning Flexfields
Configuring Flexfields
• Defining value sets against which the values entered by end users are
validated
• Specifying the prompt, length and data type of each flexfield segment
• Specifying valid values for each segment, and the meaning of each value
within the application
Tip
Some descriptive flexfields provide parameters that are attributes of the same
or related entity objects. You use parameters to set the initial value or derivation
value of an attribute from external reference data, such as a column value or a
session variable, rather than from user input.
Note
For more information on adding columns to a table, see the Oracle Fusion
Applications Developer's Guide.
For more information on configuring flexfields for custom attributes, see also the
Oracle Fusion Applications Extensibility Guide.
You can enable key flexfield segment instances and descriptive flexfield
segments for business intelligence if the flexfield is registered in the database
Deploying Flexfields
After you configure or change a flexfield, you must deploy it to make the latest
definition available to end users.
You deploy a flexfield in the mainline for general use in a test or production
environment, or you can deploy a flexfield as a flexfield-enabled sandbox to
confirm that it is correctly configured before deploying it to the mainline.
The flexfield attributes you define integrate with the user interface pages where
users access the attributes' business object. Application development determines
the UI pages where business objects appear and the display patterns used by
default to render flexfield segments.
You can customize the appearance of the flexfield segments in the UI page using
Oracle Composer once the flexfield is deployed to the mainline.
For more information on creating flexfields and adding them to a UI page, see
Oracle Fusion Applications Developer's Guide.
Even if a flexfield has not yet been deployed and does not appear on the runtime
page in normal view, it appears in the Highlight Flexfield view for that page.
Highlight Flexfields accesses the current flexfield metadata definition.
Use the highlighted flexfield's edit icon to manage the descriptive or key flexfield
directly. Alternatively, note a highlighted flexfield's name to search for it in the
tasks for managing flexfields.
• Segments must be configured for range validation in pairs, one with the
low value and one with the high value.
• Both segments must be part of the same structure in a key flexfield or part
of the same context in a descriptive flexfield or extensible flexfield.
• The low value segment must have a lower sequence number than the high
value segment.
You can configure as many range validated pairs as you want within the same
flexfield. Your application automatically detects and applies range validation to
the segment pairs that you define, in sequence order. It must encounter a low
value segment first, and the next range validated segment it encounters must be
a high value segment. These two segments are assumed to be a matching pair.
The low value and the high value can be equal.
When entering codes such as segment code, enter a code consisting of the
characters A-Z, a-z, 0-9, with a non-numeric leading character.
The code is used in the flexfield's element in the XML schema for web services.
You can maximize the readability of the schema by naming codes with a leading
alphabetic character followed by alphanumeric characters. The use of spaces,
underscores, multi-byte characters, and leading numeric characters, which are
all encoded in XML schemas, make the codes in the schema element difficult to
read.
Value sets are specific to your enterprise. When gathering information using
flexfields, your enterprise's value sets validate the values your users enter based
on how you defined the value set.
You can assign a value set to any number of flexfield segments in the same or
different flexfields. Value set usage information indicates which flexfields use the
value set.
Caution
Be sure changes to a shared value set are compatible with all flexfield segments
using the value set.
Deployment
When you deploy a flexfield, the value sets assigned to the segments of the
flexfield provide end users with the valid values for the attributes represented by
the segments.
Usage affects various aspects of flexfields. The usage of the flexfield is set when
the flexfield is registered and specifies the application and table with which the
flexfield is associated.
A flexfield can have multiple usages. The first table registered for a flexfield is
the master usage. Segments are based on the master usage, and other usages of
the same table for the same flexfield use the same segment setup, though the
column names optionally may have a differentiating prefix.
Extensible Flexfields
You can configure different behavior for extensible flexfield contexts at the usage
level. The usage of an extensible flexfield context determines in which scenarios
or user interfaces the segments of a context appear to end users. For example, if a
Supplier page displays an extensible flexfield's supplier usage and a buyer page
displays that same extensible flexfield's buyer usage, a context that is associated
to the supplier usage but not the buyer usage displays only on the supplier page
and not the buyer page.
The usage of value sets specifies the segments where the value set is assigned.
Flexfield Deployment
To use a flexfield at runtime, the flexfield must have been deployed at least once.
Deployment generates or refreshes the Application Development Framework
(ADF) business component objects that render the flexfield in a user interface.
Flexfields are deployed for the first time during the application provisioning
process.
After you configure or change a flexfield, you must deploy it to make the latest
definition available to end users. You can deploy a flexfield to a sandbox for
testing or to the mainline for use. In the case of extensible flexfields, you can
deploy offline as a background process.
Deployment Status
Note
Whenever a value set definition changes, the deployment status of a flexfield
that uses that value set changes to edited. If the change results from a patch, the
deployment status of the flexfield changes to patched.
The Oracle Fusion Applications installation loads flexfield metadata into the
database. This initial load sets the flexfield status to Edited to indicate that the
flexfield has not been deployed yet. The application provisioning process during
installation deploys the predefined flexfields of the provisioned applications,
which sets their status to Deployed if no errors are encountered.
When accessing a provisioned application, deployed flexfields are ready to use.
In some cases, flexfield availability at runtime requires setup, such as defining
key flexfields.
Metadata Validation
Use the Validate Metadata command to view possible metadata errors before
attempting to deploy the flexfield. Metadata validation is the initial phase of all
flexfield deployment commands. By successfully validating metadata before
running the deployment commands, you can avoid failures in the metadata
validation phase of a deployment attempt. Errors in the metadata validation
phase of deployment cause the deployment attempt to abort. Metadata
validation results do not affect the deployment status of a flexfield.
Note
When an application is provisioned, the provisioning framework attempts to
deploy all flexfields in that application.
If you deploy the flexfield successfully, meaning to the mainline, the status
is Deployed. The latest flexfield metadata definition in the Oracle Fusion
application matches the metadata definition that generated ADF business
components in a mainline MDS repository. Change notifications are sent when a
flexfield is deployed successfully to the mainline.
If the flexfield definition has been modified by a patch, the status is Patched.
The latest flexfield metadata definition in the Oracle Fusion application diverges
from the latest deployed flexfield definition. If the flexfield definition was
Deployed before the patch and then a patch was applied, the status changes to
Patched. If the flexfield definition was Edited before the patch and then a patch
was applied, the status will remain at Edited to reflect that there are still changes
(outside of the patch) that are not yet in effect.
When a deployment attempt fails and you can access the Deployment Error
Message for details.
The figure shows the two types of deployment available in the Manage Flexfield
tasks of the Define Flexfields activity. Deploying a flexfield to a sandbox creates
a sandbox MDS repository for the sole purpose of testing flexfield behavior. The
sandbox is only accessible to the administrator who activates and accesses it,
not to users generally. Deploying a flexfield to the mainline applies the flexfield
definition to the mainline MDS repository where it is available to end users.
After deploying the flexfield to the mainline, customize the page where the
flexfield segments appear. Customization of the page in the sandbox MDS
repository cannot be published to the mainline MDS repository.
Warning
When you deploy a flexfield to sandbox, the process reads the metadata about
the segments from the database, generates flexfield Application Development
Framework (ADF) business component artifacts based on that definition, and
stores in the sandbox only the generated artifacts derived from the definition.
The sandbox data allows you to test the flexfield in isolation without first
deploying it in the mainline where it could be accessed by users.
Warning
You can only deploy a flexfield to a sandbox using the Define Flexfields task
flow pages.
You also can use the Manage Sandboxes feature in the Administration menu of
the Setup and Maintenance work area to activate, access, or delete a flexfield-
enabled sandbox.
Note
Whether you use the Define Flexfields or Manage Sandboxes task flows to access
a flexfield-enabled sandbox, you must sign out and sign back in before you can
see the changes you deployed in the runtime.
You cannot publish the flexfield from the sandbox to the mainline. You must use
the Define Flexfields task flow pages to deploy the flexfield for access by users
of the mainline because the flexfield configuration in the mainline is the single
source of truth.
You can use the Manage Key Flexfields, Manage Descriptive Flexfields, and
Manage Extensible Flexfields tasks to deploy flexfields. You can also use
WebLogic Server Tool (WLST) commands for priming the Metadata Services
(MDS) repository with predefined flexfield artifacts and for deploying flexfields.
Executing these commands outputs a report at the command line. The report
provides the following information for every flexfield that is processed.
• Flexfield code
In case of errors, the report lists the usages for which the errors were
encountered. If a runtime exception occurs, the output displays the traceback
information. For each WLST flexfield command, adding the reportFormat='xml'
argument returns the report as an XML string.
For more information on deploying the Applications Core Setup application, see
the Oracle Fusion Applications Developer's Guide.
Windows:
wlst.cmd
Connect to the server, replacing the user name and password arguments with
your WebLogic Server user name and password.
connect('wls_username', 'wls_password', 'wls_uri')
For more information on the WLST scripting tool, see the Oracle Fusion
Middleware Oracle WebLogic Scripting Tool.
Important
This command is run automatically when you provision applications. However,
after custom applications development, you must run the deployFlexForApp
command after you configure your application to read the flexfield artifacts from
the MDS repository and before you log into the application for the first time,
even if there is no predefined flexfield metadata.
This command does not deploy flexfields that have a status of Deployed unless
the force parameter is set to 'true' (the default setting is 'false').
For more information on priming the MDS partition with configured flexfield
artifacts, see the Oracle Fusion Applications Developer's Guide.
From the WLST tool, execute the following commands to deploy the artifacts
to the MDS partition, replacing product_application_shortname with the
application's short name wrapped in single-quotes.
deployFlexForApp('product_application_shortname'[, 'enterprise_id']
[,'force'])
Tip
The application's short name is the same as the application's module name.
For more information about working with application taxonomy, see the Oracle
Fusion Applications Developer's Guide.
From the WLST tool, execute the following command to deploy a flexfield,
replacing flex_code with the code that identifies the flexfield, and replacing
flex_type with the flexfield's type, which is either DFF, KFF, or EFF.
deployFlex('flex_code', 'flex_type')
Execute the following command to deploy all flexfields that have either a
READY status or an ERROR status.
deployPatchedFlex(mode='RETRY')
deleteFlexPatchingLabels(infoOnly='true')
Optionally, sign into the application, access user interface pages that contain
flexfields, and confirm the presence of flexfields for which configuration exists,
such as value sets, segments, context, or structures.
A value set is a set of valid values that you assign to a flexfield segment.
An end user enters a value into a flexfield segment while using the application.
The flexfield validates the segment against the set of valid values that you
configured as a value set and assigned to the segment.
For example, you can define a required format, such as a five digit number, or a
list of valid values, such as green, red, and blue.
Flexfield segments are usually validated, and typically each segment in a given
flexfield uses a different value set. You can assign a single value set to more than
one segment, and you can share value sets among different flexfields.
Caution
Be sure changes to a shared value set are compatible with all flexfields segments
using the value set.
Validation
The following types of validation are available for value sets.
• Format only, where end users enter data rather than selecting values from
a list
• Independent, a list of values consisting of valid values you specify
• Dependent, a list of values where a valid value derives from the
independent value of another segment
• Subset, where the list of values is a subset of the values in an existing
independent value set
• Table, where the values derive from a column in an application table and
the list of values is limited by a WHERE clause
A segment that uses a format only value set does not present a list of valid
values to users.
Note
Adding table validated value sets to the list of available value sets available for
configuration is considered a custom task.
For more information, see the Oracle Fusion Applications Extensibility Guide.
Security
Value set security only works in conjunction with usage within flexfield
segments. If a value set is used standalone, meaning outside a flexfield, value set
security is not applied, but Oracle Fusion data security is enforced.
You can specify that data security be applied to the values in flexfield segments
that use a value set. Based on the roles provisioned to users, data security
policies determine which values of the flexfield segment end users can view or
modify.
Value set security applies at the value set level. If a value set is secured, every
usage of it in any flexfield is secured. It is not possible to disable security for
individual usages of the same value set.
Value set security applies to independent, dependent, or table-validated value
sets.
Value set security applies mainly when data is being created or updated, and to
key flexfield combinations tables for query purposes. Value set security does not
determine which descriptive flexfield data is shown upon querying.
Security conditions defined on value sets always use table aliases. When filters
are used, table aliases are always used by default. When predicates are defined
for data security conditions, make sure that the predicates also use table aliases.
For key flexfields, the attributes in the view object that correspond to the code
combination ID (CCID), structure instance number (SIN), and data set number
(DSN) cannot be transient. They must exist in the database table. For key
flexfields, the SIN segment is the discriminator attribute, and the CCID segment
is the common attribute.
The usage of a value set is the flexfields where that value set is used. The
deployment status of flexfields in which the value set is used indicates the
deployment status of the value set instance.
The figure shows a value set used by a segment in a key flexfield and the context
segment of a descriptive flexfield.
Validation and usage of value sets determine where and how end users access
valid values for attributes represented by flexfield segments.
Tip
As a flexfield guideline, define value sets before configuring the flexfield,
because you assign value sets to each segment as you configure a flexfield.
When assigning a value set to a context segment, you can only use table-
validated or independent value sets. The data type must be character and the
maximum length of the values being stored must not be larger than column
length of the context.
The format only validation type enables end users to enter any value, as long
as it meets your specified formatting rules. That is, the value must not exceed
For example, if the value set allows only numeric characters, your user could
enter the value 456 (for a value set with maximum length of three or more),
but could not enter the value ABC. A format only value set does not otherwise
restrict the range of different values that users can enter. For numeric values,
you can also specify if a numeric value should be zero filled or how may digits
should follow the radix separator
You cannot specify a dependent value set for a given segment without having
first defined an independent value set that you apply to another segment in
the same flexfield. You use a dependent value set to limit the list of values for
a given segment based on the value that the end user has chosen for a related
independent segment. The available values in a dependent list and the meaning
of a given value depend on which value was selected for the independently
validated segment.
For example, you could define an independent value set of U.S. states with
values such as CA, NY, and so on. Then you define a dependent value set of U.S.
cities, with values such as San Francisco and Los Angeles that are valid for the
independent value CA, and New York City and Albany that are valid for the
independent value NY. In the UI, only the valid cities can be selected for a given
state.
Because you define a subset value set from an existing independent value set,
you must define the independent value set first. End users do not need to choose
a value for another segment first to have access to the subset value set.
Table Validation
Typically, you use a table-validated set when the values you want to use are
already maintained in an application table (for example, a table of vendor
names). Table validation allows you to enable a segment to depend upon
multiple prior segments in the same context or structure.
Table-validated value sets have unique values across the table, irrespective of
bind variables. The WHERE clause fragment of the value set is considered if it
does not have bind variables. If it has bind variables, the assumption is that the
values are unique in the value set.
Range
In the case of format, independent, or dependent value sets, you can specify a
range to further limit which values are valid. You can specify a range of values
that are valid within a value set. You can also specify a range validated pair of
segments where one segment represents the low end of the range and another
segment represents the high end of the range
For example, you might specify a range for a format-only value set with format
type Number where the user can enter only values between 0 and 100. If you use
a table value set, you cannot reference flexfield segments in the WHERE clause
Security
In the case of independent and dependent values, you can specify that data
security be applied to the values in segments that use a value set. Based on the
roles provisioned to users, data security policies determine which values of the
flexfield segment end users can view or modify.
When you enable security on a table-validated value sets, the security rule that is
defined is absolute and not contingent upon the bind variables (if any) that may
be used by the WHERE clause of the value set. For example, suppose a table-
validated value set has a bind variable to further filter the value list to x, y and z
from a list of x, y, z, xx, yy, zz. The data security rule or filter written against the
value set should not assume anything about the bind variables; it must assume
the whole list of values is available and write the rule, for example, to allow x, or
to allow y and z. By default in data security all values are denied, and show only
rows to which access has been provided.
Maintenance
For more information about defining value sets, see the Oracle Fusion
Applications Extensibility Guide.
A descriptive flexfield can have only one context segment to provide context
sensitivity.
In the figure, a descriptive flexfield has one context segment called Category for
which there are three values: Resistor, Battery, and Capacitor. In addition, the
descriptive flexfield consists of two global segments that appear in each of the
contexts, and three context-sensitive segments that only appear in the context in
which they are configured.
Value Sets
For each global and context-sensitive segment, you configure the values allowed
for the segment and how the values that end users enter are validated, including
interdependent validation among the segments.
Segments
You can assign sequence order numbers to global segments and to context-
sensitive segments in each context. Segment display is always in a fixed order.
You cannot enter a number for one segment that is already in use for a different
segment.
Value sets are optional for context segments. The value set that you specify for
a context segment consists of a set of context codes, each of which corresponds
to a context that is appropriate for the descriptive flexfield. If you do not specify
a value set for a context segment, the valid values for that context segment are
derived from the context codes. The definition of each context segment specifies
the set of context-sensitive segments that can be presented when that context
code is selected by the end user.
For reasons of data integrity, you cannot delete an existing context. Instead, you
can disable the associated context value in its own value set by setting its end
date to a date in the past.
You can configure the individual global segments and context-sensitive segments
in a descriptive flexfield. These segment types are differentiated by their
usage, but they are configured on application pages that use most of the same
properties.
Usages
Delimiters
Flattening
When you deploy a business intelligence-enabled descriptive flexfield,
the deployment process generates an additional set of flattened business
components for use in Oracle BI. The flattened business components include
attributes for business intelligence-enabled segments only.
Flattened components include one attribute for the BI-enabled context-segment,
and one attribute for each business intelligence-enabled global segment. For
BI-enabled context-sensitive segments, if you assigned a label to the segment,
the flattened components include an additionala single attribute representing
segments with that label. If you did not assign a label, the flattened components
include a discrete attribute for each BI-enabled context-sensitive segment in each
context.
Note
Note
Managing Labels
You may assign a predefined label (if available) to segments or create new labels
for assignment, as needed. Specify a code, name, and description to identify
each label. In the BI Object Name field, enter the name of the logical object in
Oracle Business Intelligence to which the segment label should map during
import. Specifying the BI logical object minimizes the steps for importing the
flexfield into Oracle Business Intelligence and helps to equalize context-sensitive
segments across contexts.
Extensible flexfields are like descriptive flexfields, with some additional features.
When you configure a context for multiple rows per entity, the segments are
displayed as a table.
Unlike descriptive flexfields, the extension columns corresponding to extensible
flexfields segments are part of extension tables, separate from the base
application table. Unlike descriptive flexfield contexts, the set of attributes in
an extensible flexfield context remains constant and does not differ by context
value.
An extensible flexfield describes an application entity, with the runtime ability to
expand the database that implementation consultants can use to define the data
structure that appears in the application.
Extensible flexfields support one-to-many relationships between the entity and
the extended attribute rows.
For lists of extensible flexfields, see assets with the Flexfield: Extensible type
in Oracle Enterprise Repository for Oracle Fusion Applications (http://
fusionappsoer.oracle.com)
Usages
As with descriptive flexfields, you can define multiple usages for an extensible
flexfield, which enables several application tables to share the same flexfield.
For example, a flexfield for shipping options can be used by both a Supplier table
and a Buyer table. In addition, you can associate a context with one, some, or
all of the flexfield's usages. Thus, with the shipping information example, you
can associate a warehouse context with the Supplier usage, a delivery location
context with the Buyer usage, and a ship-via context with all usages.
Categories
Extensible flexfields support multiple contexts, and the contexts can be grouped
into categories. Every extensible flexfields has at least one category, or root
You can define categories for extensible flexfields, and you can associate any
combination of contexts with a given category.
For example, the Electronics and Computers category hierarchy might include a
Home Entertainment category, which in turn might include an Audio category
and a TV category, and so on. The Home Entertainment product might have
contexts that specify voltage, dimensions, inputs and outputs. Contexts are
reusable within a given extensible flexfield. For example, the dimensions
context could be assigned to any category that needs to include dimensional
information.
Pages
Extensible flexfields allow you to combine contexts into groups known as pages,
which serve to connect the contexts so they will always be presented together in
the application user interface.
Contexts
A context can be defined as single row or multi row. Single row contexts are
the same as descriptive flexfields contexts. A single row context has only one
set of context-sensitive segments. A multi-row context enables you to associate
multiple sets of values with the same object instance.
For example, for a BOOK table, you could create a multi-row context named
chapters that contains a chapter segment and a number of pages segment.
Multiple chapters can then be associated with each book in the BOOK table.
Set the context to translatable so free-form text entered by end users is stored
in the language of the user's locale, and different translations of that text can
be stored in other languages. Segments in the translated contexts should utilize
format-only value sets for storing free-form, user-entered text.
Categories
For example, the Electronics and Computers category hierarchy might include
a Computer category and a Home Entertainment category, which in turn might
include an Audio category and a TV category, and so on.
Each category has associated contexts that store relevant information about a
data item in that category. For example, a Home Entertainment product has
contexts that specify Voltage, Dimensions, Inputs and Outputs. Contexts are
reusable within a given extensible flexfield; the Dimensions context could be
assigned to any category that needs to include dimensional information.
If a hierarchy includes child categories, each child category inherits the contexts
from its parent category; for example, the Home Entertainment category inherits
Voltage and Dimensions from the Electronics and Computers category.
Indexed Segments
For example, if you index the memory and processor attributes and ensure that
the corresponding columns in the database are indexed, an end user can search
an item catalog for computers by entering processor or memory or both as a
Offline Deployment
You can deploy extensible flexfields offline as a background process using the
Deploy Offline command in the Manage Extensible Flexfields task, and continue
working in the session without having to wait for the deployment to complete.
Deploy Offline enables adding one after another extensible flexfield to your
deployment queue. For extensible flexfields with more than 30 categories you
must use Deploy Offline.
You can remove an extensible flexfield from the deployment queue with the
Cancel Offline command.
When an extensible flexfield is deployed offline, its offline status indicates that
the flexfield is in an offline deployment process. The Offline Status column
refreshes when you perform a new search in the Manage Extensible Flexfields
task. A flexfield's offline status is cleared and its deployment status updated
when the offline deployment process has completed.
Key flexfields provide a means to capture a key such as a part number, a job
code, or an account code. A key flexfield consists of one or more segments,
where each segment can have a meaning.
For example, a part number 10-PEN-BLA-450 might correspond to a black pen
from vendor #450 sold by division #10 (office supplies). Behind the scenes, the
application uses a unique number, 13452, for this part, but the end user always
see the 10-PEN-BLA-450 part number.
The following aspects are important to understanding key flexfields.
• Architecture
• Segments and segment labels
• Structures
• Segment and structure instances
• Combinations
• Dynamic combination creation
• Security
Key flexfields are not optional. You must configure key flexfields to ensure that
your applications operate correctly. You configure and maintain key flexfield
definitions with the Manage Key Flexfields task.
For lists of key flexfields, see assets with the Flexfield: Key type in
Oracle Enterprise Repository for Oracle Fusion Applications (http://
fusionappsoer.oracle.com).
When you configure a key flexfield, you define metadata about the key flexfield
such as how many segments are in a structure, how many structures the flexfield
uses, what value sets each segment uses, and so on. This is flexfield metadata
stored in flexfield metadata tables.
Based on the flexfield metadata, actual part numbers are captured at runtime
as a combination of segment values and stored in a combinations table. A
combinations table contains all the segment columns for a flexfield, plus a
unique ID column and a structure instance number column that differentiates
multiple arrangements of the segment columns.
For example, a part number that can be comprised of multiple segments can be
represented by a key flexfield. A part number key flexfield has a corresponding
combinations table, where the flexfield stores a list of the complete codes, with
one column for each segment of the code, together with the corresponding
unique ID and structure instance number for the code. When users define a new
part number or maintain existing part numbers in the parts catalog, they directly
maintain rows in the combination table.
The foreign key table contains a different business entity than the combinations
table. For example, the business entity in the foreign key table is order lines or
invoice lines that contain foreign key references to parts for ordering and so on.
Any number of foreign key tables can reference a particular entity represented
by a key flexfield.
For example, Oracle Fusion General Ledger needs to identify which segment
in the Accounting Flexfield contains balancing information and which segment
contains natural account information. General Ledger uses a segment label to
determine which segment you are using for natural account information. When
you define your Accounting Flexfield, you must specify which segment label
apply to which segments.
Some labels must be unique, and cannot be applied to more than one segment
in each structure. Other labels are required, and must be applied to at least one
segment in each structure.
A segment label orients an end user's search of segments, such as the Cost Center
label for all segments across key flexfields that capture a value for cost center.
A key flexfield structure definition includes the number of segments and their
order.
In some applications, different users need to see different segment structures for
the same flexfield. A key flexfield can have multiple structures if registered to
support more than one structure.
The flexfield can display different fields for different end users based on a data
condition in your application data, such as the value of another field entered by
the end user or the user's role. For example, the correctly formatted local postal
address for customer service inquiries differs based on locale. A postal address
key flexfield could display different segments and prompts for different end
users based on a location condition in your application data, such as the user's
role or a value entered by the user.
Each structure can have one or more segments. Thus a segment is a child of a
structure. If you want to store a particular segment, such as Cost Center, in two
different structures, you must define the segment separately in each structures.
Each structure may have one or more structure instances. Each instance of a
structure shares the same number and order of segments, but differs in the
allowable values or value sets that validate the segments.
If a key flexfield has been registered with a tree structure, you can specify a
tree code for a segment instance, where the tree code defines a hierarchical
relationship between the segment values.
Combinations
Each key flexfield has one corresponding table, known as the combinations
table, where the flexfield stores a list of the complete codes, with one column for
each segment of the code, together with the corresponding unique ID number
(a code combination ID number or CCID) for that code. Then, other tables in
the application have a column that stores just the unique ID for the code. For
example, you may have a part number code, such as PAD-YEL-11x14. The Parts
combinations table stores that code along with its ID, 57494. If your application
allows you to take orders for parts, you might then have an Orders table that
stores orders for parts. That Orders table would contain a single column that
contains the part ID, 57494, instead of several columns for the complete code
PAD-YEL-11x14.
Typically one combinations page maintains the key flexfield, where the key
flexfield is the representation of an entity in your application. The combinations
page is where you maintain individual combinations, such as part numbers.
If your key flexfield or certain usages or references of the key flexfield do not
permit dynamic combination creation, you may control whether dynamic
combination creation is enabled for each structure instance. If enabled, a user
can enter a new combination of segment values using the flexfield window
from a foreign key page. For example, when entering a transaction, a GL user
can enter a new expense account code combination for an account that does
not yet exist. Your application creates the new account by inserting the new
combination into the combinations table behind the scenes. Assuming that the
new combination satisfies any existing cross-validation rules, the flexfield inserts
the new combination into the combinations table, even though the combinations
table is not the underlying table for the foreign key page.
Consider the plans for a key flexfield, security, and resulting runtime pages
when configuring key flexfields.
Caution
Do not change the number, order, and maximum length of segments once you
have acquired flexfield data.
Structure Delimiters
A delimiter separates the segments when they appear to end users. The delimiter
value of a structure specifies the character used to visually separate segment
values when the key flexfield is displayed as a string of concatenated segments
in the UI.
Tip
Choose the delimiter value of your key flexfield carefully so that it does not
conflict with the flexfield data. For example, if your data frequently contains
periods, such as in monetary or numeric values, do not use a period as your
segment separator. Any character you expect to appear frequently in your
segment values or descriptions is not a good choice for the delimiter.
If you change the configuration of a key flexfield, such as the delimiter, the
change affects the previously stored key flexfields with that structure.
Security
Oracle Fusion data security enforces value set security.
Within key flexfields, value set security applies to the selection of the individual
segment values in the segment list of values. When selecting a key flexfield
segment value from the combination table, data security allows display of
only the combinations whose segment values you have access to. Applications
development controls whether or not value set security rules propagate to the
foreign key table. By default they do.
Runtime Pages
Application development determines the user interface (UI) pages used to
render flexfields. The types of key flexfield UI pages are as follows.
• Combinations pages where underlying entity objects use the
combinations table itself
• Foreign key pages where the underlying entity objects contain a foreign
key reference to the combinations table
• Partial usage page where some or all of the key flexfield's segment
columns are in a product table
The same key flexfield can be used in different ways on different pages.
A page with a foreign key reference has a base table or view that contains a
foreign key reference to a combinations table with the actual flexfield segment
columns. This allows manipulating rows containing code combination IDs
(CCID).
For more information on key flexfield pages, see the Oracle Fusion Applications
Developer's Guide.
A key flexfield structure arranges the segments of a key so you can reuse a single
key flexfield in multiple combinations of the same or a subset of segments.
Multiple instances of a single structure can accommodate differences in the value
sets assigned to the structure's segments.
The structure determines the following aspects of a key flexfield.
• The segments to include
• The order of the segments
• Segment labels on the included segments
• Properties for each segment applied to the instances of the segments in an
instance of the structure
All the segments defined for a key flexfield are available to be included in a key
flexfield structure.
You can define as many segments as there are defined segment columns in your
key flexfield combinations table.
Enable segments to indicate that they are in use. A flexfield does not display
disabled segments in runtime.
Tip
To protect the integrity of your data, disable a segment if you have already used
it to enter data.
A key flexfield structure can have one or more alternate structure instances.
The instances of a key flexfield structure share the following aspects of the
structure.
• The same set of segments
• The same arrangement of segments
• The same properties at the segment and structure levels
Differences among structure instances at the structure level include whether
dynamic combination creation is allowed.
Differences among segment instances at the structure instance level include the
following.
• Value set
• Default type and default value
• Tree code
• Whether the segment is any of the following
• Required
• Displayed
• Enabled for business intelligence
• Optional or required as a query criterion
For example, you could use one group of value sets for the US and another for
France.
The figure shows two structures instances for a part number structure. The
structures differ in the number of segments and the segment separators used.
The structure instances of a structure share all properties that are defined for
the structure, but can vary in the properties defined at the structure instance or
segment instance level, such as the value set assigned to the segment instances.
You can designate a key flexfield segment instance as query required so that it
is one of the selectively required attributes an end user can use in a key flexfield
combination search. If you indicate in the Manage Key Flexfields UI page that
a segment instance should be indexed, the column representing the segment
must be added to the database index. This is commonly done by a database
administrator (DBA).
Following deployment, the combination picker of the key flexfield displays the
query required attributes as selectively required. An end user must specify at
least one of the query required attributes in the search criteria. This prevents
non-selective searches that could cause performance issues.
For example, if you mark the cost center and account attributes as query required
and ensure that the corresponding columns in the database are indexed, an end
user can search for combinations by entering cost center or account or both as a
search criterion. No search is performed if an end user does not enter at least one
query required attribute as search criteria.
Tip
Note
It may not be possible to equalize similarly labeled segments if they have
incompatible data types or value set types.
Note
Assigning a label to a segment serves to equalize the attribute across structures,
as well as map the equalized attribute to business intelligence.
Managing Labels
You may assign a predefined label (if available) to segments or create new labels
for assignment, as needed. Specify a code, name, and description to identify
each label. In the BI Object Name field, enter the name of the logical object in
Oracle Business Intelligence to which the segment label should map during
import. Specifying the BI logical object minimizes the steps for importing the
flexfield into Oracle Business Intelligence and helps to equalize context-sensitive
segments across structures.
If no labels are assigned to a BI-enabled segment, or the BI Object Name on the
assigned label does not exist in business intelligence, you must manually map
the segment to the desired logical object when importing into Oracle Business
Intelligence.
In addition, segments without labels cannot be equalized across structures. The
flattened components include a separate attribute for each non-labeled segment
in each structure.
Note
Segment labels serve other functions as well, as presented in Key Flexfields:
Explained.
The combinations page, which is the maintenance page for the key flexfield,
is for managing rows in the combination table. In this example, managing the
combinations means adding or editing account numbers that adhere to the key
flexfield metadata rules.
Value set security is a feature that enables you to secure access to value set values
based on the end user's role in the system.
As an example, suppose you have a value set of US state names. When this value
set is used to validate a flexfield segment, and users can select a value for the
segment, you can use value set security to restrict them to selecting only a certain
state or subset of states based on their assigned roles in the system.
When you define or edit a flexfield segment, you specify a default value from the
values provided by the value set assigned to that segment.
You can set the default value to be a parameter, which means the entity object
attribute to which the parameter you choose is mapped will provide the initial
default value for the segment.
You can set to be a constant, if appropriate to the data type of the value set
assigned to the segment.
In addition to an initial default value, you can set a derivation value for updating
the attribute's value every time the parameter value changes. The parameter you
choose identifies the entity object source attribute. Any changes in the value of
the source attribute during runtime are reflected in the value of the segment.
If the display type of the segment is a check box, you can set whether the default
value of the segment is checked or unchecked.
No. The context segment is predetermined for each page. Displaying it and
changing the value may result in capture of data that is not applicable for the
current transaction.
Define Attachments
Attachments: Explained
Attachments are pieces of supplementary information that users can associate
with specific business objects such as expense reports or purchase orders.
Attachments can be URLs, desktop files, text, or in cases where available,
repository folders. For any given business object, a user may be able to only view
attachments, or also create, delete, or edit attachments, depending on security.
For more information on an introduction to attachments, see the Oracle Fusion
Applications Developer's Guide.
Repository
Security
Data security that applies to a specific business object also applies to attachments
for that object, as determined by the attachment entity defined for the object. For
example, if a user has no access to a specific expense report, then the same user
cannot access attachments for the expense report. You can also use attachment
categories to control access and actions on attachments, based on roles associated
with the category. For more information on securing attachments, see the Oracle
Fusion Applications Developer's Guide.
Entity Names
An attachment entity name should match the name of the table or view
that represents the business object to attach to. The name is also used in the
repository folder that is automatically created to store attachments for the entity.
The attachment entity display name should be something that users know to
represent the business object.
Database Resource
The data security policies associated with the database resource defined for the
attachment entity would apply to attachments for that entity. For example, based
on the database resource for the expense reports attachment entity, the same
policies apply to attachments for expense reports. The database resource value
must match the value in the OBJ_NAME column in the FND_OBJECTS table for
the business object that the entity represents.
Enabling Security
Security based on the database resource associated with the attachment entity is
always in effect. What you can enable or disable is security based on attachment
categories. If any of the attachment categories associated with the attachment
entity has data security defined, then that security applies to this entity only if
enabled.
Managing Entities
You determine which attachment categories are relevant to a particular entity
on the Manage Attachment Entities page, and each entity must have at least one
category. Depending on configuration, any or all of the available categories for
that entity are used. For example, you assign three categories to the expense
Managing Categories
If you create an attachment category and need to assign it to multiple attachment
entities, use the Manage Attachment Categories page. The association means the
same as the association on the Manage Attachment Entities page.
Attachments UIs for users to add and manage attachments are fully functional as
is, and users usually would not encounter issues. If you customize attachments
in any way, for example by creating additional attachment categories and
implementing data security on them, then some issues might arise.
• Users can no longer see specific attachments that they were previously
able to see.
• Users get an error stating that they do not have permission to add
attachments.
Resolution
Use the Manage Attachment Entities page to ensure that attachment categories
are associated to the relevant attachment entity. For example, if users can no
longer see attachments for an expense report, then search for the expense report
attachment entity and assign all necessary categories to it. You might need to
check with your system administrator or help desk to determine the exact entity
used on the page with the expenses attachments or what categories to assign.
If data security is implemented on the categories for the attachment entity, then
verify that the Enable Security check box is selected in the Manage Attachment
Entities page for that entity. Make sure that users have a role with the privileges
shown in the following table, to view, add, update, or delete attachments with a
specific attachment category.
Action Privilege
View Read Application Attachment
(FND_READ_APPLICATION_ATTACHMENT_DATA)
Add or Update Update Application Attachment
(FND_UPDATE_APPLICATION_ATTACHMENT_DATA)
For example, if users have the Read Application Attachment privilege for all
categories associated with the expense report attachment entity, except the
Receipts attachment category, then they can view all expense report attachments
except those created with the Receipts category. Likewise, if users do not have
the Update Application Attachment privilege for any attachment categories tied
to the expense report attachment entity, then they cannot create any attachments
at all for expense reports.
For more information on attachment category data security, see the Oracle
Fusion Applications Developer's Guide.
Resolution
When the attachment was added, at least one category existed for the
corresponding attachment entity, as otherwise the attachment could not have
been added. Since then, the entity was edited so that it no longer has any
assigned categories, so the user cannot see the category associated with that
attachment.
You can also associate roles with categories to determine user access and actions
for attachments, based on the categories assigned to the attachment entity. For
example, security for expense report attachments can be based in part on the
categories assigned to the expense report attachment entity. You can define
multiple categories per module, and add and manage custom categories for your
own purposes. For more information on attachment category data security, see
the Oracle Fusion Applications Developer's Guide.
Use the Manage Attachment Categories page, which you can access by starting
in the Setup and Maintenance Overview page and searching for the Manage
Attachment Categories task.
Activity stream settings are described in the Oracle Fusion Middleware User's
Guide for Oracle WebCenter Portal: Spaces. When you read content from that
guide, note that:
• Your setup applies to all users, not just yourself or any individual user.
• You can disregard discussions about how to access the settings, because
you access the Set Activity Stream Options page by starting in the Setup
and Maintenance Overview page and searching for the Set Activity
Stream Options task.
Use audit policies to select specific business objects and attributes to be audited.
The decision to create policies usually depends on the type of information to be
audited and to the level of detail that is required to be reported.
To enable auditing for Oracle Fusion Middleware products, select one of the
levels at which auditing is required for that product. The audit levels are
predefined and contain the metadata and events to be audited. For more
information, refer to the Oracle Fusion Middleware documentation and also
the Oracle Enterprise Repository for Oracle Fusion Applications at http://
fusionappsoer.oracle.com.
If you do not want an application to be audited, you can stop the audit process
by setting the Audit Level option to None. While viewing the audit report for
that application, you can specify the period during which auditing remained
enabled.
Selecting an Application
To set up auditing, you must select a web application that contains the required
business objects that can be audited. From the list of business objects, select those
business object that you want to audit. Selecting a business object also displays
its attributes that are enabled for auditing.
Selecting Attributes
The business object is ready for audit after you select its attributes and save the
configuration changes. However, to start auditing, the audit level for Oracle
Fusion Applications must be set to Auditing on the Manage Audit Policies page.
To stop auditing an object, you can deselect the entire object and save the
configuration. As a result, all its selected attributes are automatically deselected
and are not audited. To continue to audit the business object with select
attributes, deselect those attributes that are not to be audited.
When end-users view the audit history for an application, they can specify the
period for which they want the results. Therefore, it is important to note when
you start and stop auditing an application. For example, today if end-users
intend to view the audit history of an object for the previous week, but auditing
for that object was stopped last month, they would not get any audit results for
that week because during the entire month that object was not audited. Even if
you enable audit for that object today, end-users cannot get the wanted results
because audit data until today is not available.
You can also create a configuration file and deploy it to audit a specific Oracle
Fusion Middleware product. The configuration details for Oracle Fusion
Middleware products are available in the form of audit-specific assets that can
be used to create the configuration file (config.xml). For more information, see
the Oracle Enterprise Repository for Oracle Fusion Applications at http://
fusionappsoer.oracle.com.
Use the Manage Oracle Social Network Objects page, which you can access by
starting in the Setup and Maintenance Overview page and searching for the task
Manage Oracle Social Network Objects.
Note
Note
You see only the business objects that are predefined as available to enable, not
the full list of business objects for products that you are permitted to view.
Enable Object
Access the Business Object section of the Manage Oracle Social Network Objects
page.
Click Enable Object to select from the available enablement options and define
how the object integrates with Oracle Social Network. Options include:
• Manual - Recommended; the object is enabled for manual sharing with
Oracle Social Network, where the social network user decides whether
or not to share each instance of the object with Oracle Social Network.
Once shared, all updates to enabled attributes of the object instance, and
deletes, are sent to Oracle Social Network. Updates to attributes that are
not enabled are not sent.
Note
After you enable an object, you must enable one or more attributes in the
Attributes section of the Manage Oracle Social Network Objects page. Updates to
enabled attributes are sent to Oracle Social Network.
Disable Object
Access the Business Object section of the Manage Oracle Social Network Objects
page.
Click Disable Object to disable the selected business object, then Save. This
shortcut disables the currently selected business object by changing the
enablement option to No.
Alternatively, you can click Enable Object to access the dialog box and
enablement options and select No, then click OK, and then click Save to disable a
selected business object.
Disabling the object through either mechanism does not affect any associated
attributes. Use the Attributes section of the page to manage the list of enabled
attributes.
Enable All
Access the Manage Oracle Social Network Objects page.
Click Enable All at the page level to perform a bulk update of the enablement
status from No to Manual of all business objects. After you click Enable All, then
you save.
The bulk update of the statuses does not affect the attributes selected as enabled
for each business object. Use the Attributes section of the page to manage the list
of enabled attributes.
Status Column
The Status column appears in the Business Objects table to provide a visual
indicator as to which enabled business objects do not yet have an enabled
attribute assigned.
When you enable a business object (automatic or manual), a check mark or a
warning sign appears in the Status column of the business object depending on
this criteria:
• A check mark indicates that you have configured attributes for an enabled
business object.
• A warning sign indicates that you have not configured any attributes for
the enabled business object.
It is important that you configure the attributes before you click Save.
When you enable a business object, but do not configure any attributes for
the enabled business object, unexpected results can occur as no attributes are
sent to Oracle Social Network during create and update except some internal
bookkeeping information. Deletes are sent as usual.
Attributes
Enable business object attributes in the Attributes section of the Manage Oracle
Social Objects page. To provide a visual indicator of the enabled business
objects that have no attributes added, a Status column appears at the end of
the Business Objects table. This column shows a warning when there are no
attributes defined for a business object that has had its enabled state changed
from No. This warning does not prevent you from saving the Oracle Social
Network enablement of the business object, but does provide a guide that you
should assign attributes for an enabled business object.
These are the attributes that, upon update, are sent to Oracle Social
Network. Disabled attributes are not sent.
• Click Add to launch the dialog where you can select attributes to add to
the table.
When you click Update Translations from the Manage Oracle Social Network
Objects page, you synchronize the newly translated text from Oracle Fusion
Applications so that it can be used within Oracle Social Network. This means
you can install and enable a new language or take a language patch at any time.
Update Translations sends attribute labels and business object names to Oracle
Social Network for use in its user interface. Users in Oracle Social Network
see the attribute or business object labels in the language of their locale. If the
user changes locale in Oracle Social Network, then the attribute or business
object labels appear in the updated language. The data, however, appears in the
language in which it was originally sent to Oracle Social Network. If a user has
previously sent a business object instance to Oracle Social Network, then the
business object instance data is not updated. When you save the business object
enablement to Oracle Social Network, it sends the translations as well. This
makes it unnecessary to click both Save and Update Translations. For subsequent
updates to labels and attributes, such as if a new Oracle Fusion Applications
language pack is installed, run Update Translations to send the updated labels
and their translations to Oracle Social Network. The Update Translations button
You can create custom common messages for use in multiple places within
a single product. Do not begin the message name with FND_CMN, but use
another suitable convention. The message number should be within the range
that is designated for the product.
Message Properties
• The message type identifies the type of information that the message
contains.
See: Understanding Message Types
Preferences
The related general preferences are Default Application Language, Territory,
Date Format, Time Format, Currency, and Time Zone. When the user changes
any of these preferences, the stored values in LDAP are updated accordingly.
Profile Options
The corresponding profile options are Default Language, Default Territory,
Default Date Format, Default Time Format, Default Currency, and Default User
Click-to-Dial: Explained
Use Click-to-Dial to place a call to a contact from a hyperlink on the phone
number or phone icon.
Here are a few topics that are important to know when using Click-to-Dial:
• Normal call flow
• Interaction Records and Notes
• Operational Notes
Note
Click-to-Dial must be enabled to make calls using the various contact
information pages and pop-up UIs. When enabled, phone numbers appear
as hyperlinks. Interaction logging is available if that feature is enabled. If
interaction logging is available, a note indicating that fact will be displayed in
the UI. See Click to Dial: Top Tasks for more information about enabling these
features.
Note
Click-to-Dial does not work on phone numbers that are marked with a Do Not
Call icon.
Editing interactions
Once the call is established, if Interactions is available, you can use the
Interactions icon on the UI to launch the interaction record list view. Select the
current interaction record to edit it.
Operational Notes
Because of the call-the-caller-then-call-the-callee format, there are some
conditions that may occur due to several calling situations. Some of these
conditions are described below:
• Why don't I hear a ring-back tone? As soon as you answer the system call-
back, the system immediately dials the contact. You won't hear a ring-
back tone as in a normal outbound phone call. However, you can tell that
the call attempt is progressing because:
• The phone indicates that the connection is active. If the call to the
contact reaches a busy tone or the call attempt times out, the connection
is dropped.
• The dialing window stays on the screen while the call attempt is
progressing. It disappears when the connection is either successfully
established or fails.
• What if your phone is busy and the call-back goes directly to voice mail?
Normally this would not happen because you would not initiate a new
call when you are already busy on another call. However, this situation
could occur due to a race condition, that is where another incoming call
reaches your phone before the Click-to-Dial call-back. When this happens,
two different scenarios could occur:
Enable Click-to-Dial
• After configuring the server and defining the SIP domain, perform the
Enable Click-to-Dial task. This task sets the value of the profile option
Enable Click-to-Dial to 'Yes.'
These steps configure the address of the SIP Public Switched Telephone Network
(PSTN) gateway or SIP soft switch serving the users within that domain. This
address is needed by Click-to-Dial to correctly form the SIP addresses required
by WebLogic Communication Services.
Field Value
Name HzCTDPstnGatewayApp
Server Protocol SIP
Setup tasks in the Define Common Project Configuration activity are grouped
into the following task lists and tasks:
Common Project Configuration: Define Units of Measure for Project Financial Management 14-1
You select the following usages in the inventory organization's properties:
• Item management
• Item and inventory management
Item Management
Inventory organizations used for item management, which are the same as item
organizations, store only definitions of items. Use inventory organizations for
item management when the storage or movement of inventory does not need to
be physically or financially tracked. For example, in a retail implementation you
can create an inventory organization for item management to store the names
of items that are listed by and sold through each retail outlet, while a different
system tracks physical inventory and transactions. If it is necessary in the future,
you can change an inventory organization's usage from item management to
item and inventory management in the inventory organization's properties.
Note
Common Project Configuration: Define Units of Measure for Project Financial Management 14-3
Facility Schedules Are Associated with Inventory Organizations
Common Project Configuration: Define Units of Measure for Project Financial Management 14-5
is rounded up. If you disable rounding the reorder quantity for the inventory
organization, and specify the fixed lot multiple for the item subinventory, the
reorder quantity is rounded down.
Note
You can create or edit an inventory organization in the Oracle Fusion Global
Human Resources application, on the Manage Inventory Organizations page.
An item master organization contains definitions of items that you can use across
one or more item and inventory organizations. An item master organization does
not contain subinventories, and is not used for inventory transactions.
The Quantity unit of measure class contains the units of measure Box of 8, Box of
4, and Each. The unit of measure Each is assigned as the base unit of measure.
Common Project Configuration: Define Units of Measure for Project Financial Management 14-7
Unit of Measure Classes
Unit of measure classes represent groups of units of measure with similar
characteristics such as area, weight, or volume.
Units of Measure
Units of measure are used by a variety of functions and transactions to express
the quantity of items. Each unit of measure you define must belong to a unit of
measure class.
Scenario
This table lists examples of unit of measure classes, the units of measure in
each unit of measure class, and the unit of measure assigned as the base unit of
measure for each unit of measure class. Note that each base unit of measure is
the smallest unit of measure in its unit of measure class.
box
each
Weight pound gram
kilogram
gram
Time hour second
minute
second
Volume cubic feet cubic inches
cubic centimeters
cubic inches
Scenario
This table lists examples of unit of measure classes, one unit of measure included
in each class, the base unit of measure for the unit of measure class, and the
conversion factor defined for the unit of measure.
Unit of Measure Class Unit of Measure Base Unit of Measure Conversion Factor
Quantity dozen each 12
(1 dozen = 12 each)
Weight pound gram 454
(1 minute = 60 seconds)
A UOM interclass conversion defines the conversion between the source base
unit of measure ("From Base UOM") in one unit of measure class ("From Class")
and the destination base unit of measure ("To Base UOM") in a different unit of
measure class ("To Class").
For example, the item is gasoline. The From Base UOM (of the From Class called
"volume") is liters. The To Base UOM (of the To Class called "quantity") is Barrels.
The conversion is 158.76 liters (volume) to 1 barrel of oil (quantity).
Common Project Configuration: Define Units of Measure for Project Financial Management 14-9
For example, the item is soda pop. The unit of measure class is Quantity. The
From UOM is Case (CS). The base unit of measure is Each (EA). The conversion
is 24, to specify that 1 CS = 24 EA.
The Create Accounting process uses the accounting method definition with
active journal entry rule set assignments to create subledger journal entries.
The accounting method must be completed, by activating its journal entry rule
set assignments, so that it can be used to create accounting.
The following definitions are utilized to define the journal entries, and are
applied as updates to the accounting method:
• Assignment of journal entry rule sets for an accounting event class and/or
accounting event type from the accounting methods page
Assignment of Journal Entry Rule Set for Accounting Event Class and
Accounting Event Type
You create the assignment of a journal entry rule set for an accounting event class
and accounting event type using the accounting method page.
The following should be considered for assigning rule sets:
• If the accounting method has an assigned chart of accounts, you can select
journal entry rule sets that use that same chart of accounts, or that are not
associated with any chart of accounts.
• Select an option to assign existing journal entry rule sets or define a new
one.
Subledger journal entry rule set assignments can be made at two levels, header
and line. The following are the subcomponents of a subledger journal entry rule
set:
• Description rules
• Journal line rules
• Account rules
• Supporting references
The following two rows of data are used in the accounting event, to which the
account rule and condition applies.
Account Rule Condition Example: Accounting Event Data
In the Accounting Event Data table above, assume the cost center segment is
the second segment. When the account rule with this condition is used to derive
the account for the transaction, the account rule is applied to derive the account
of Invoice 1 only. For Invoice 2, even though the assets tracking option is set to
Yes, the cost center for the Distribution account and Liability account are not the
same. Both conditions must be met in order for the rule to apply.
Note
When an account source is selected or entered, you must also select or enter
a specific segment. If an entire account is required to be used in the condition
instead of a specific segment, then select or enter All as the segment for the
account.
The condition uses the account source, Distribution Account, and a segment
must be provided. In this example, the Cost Center segment is provided.
• Advanced Options
• The condition for a Payables invoice tax journal line rule could be:
• When this condition is true, there is tax for a payables invoice line. A
journal entry line is created to record the accounting impact of the tax.
• Similarly, the condition for a Oracle Fusion Receivables invoice tax journal
line rule could be:
• In this case, if there is an account class of Tax, the journal line is used to
record the accounting impact of the tax.
Another example is a condition that creates a journal line for freight when there
are freight charges on an invoice.
Journal line rule conditions determine whether a journal line rule and its
associated account rules and description rules, are used to create the subledger
journal entry line.
Note
Constant values that are used in any Conditions region must not contain the
following characters:
• "
• ,
• &
• |
• (
• )
• '
For example, in the condition "Project Type" = ABC (123), the constant value
following the equal sign, ABC (123), contains restricted characters ( ) that enclose
123 and is invalid.
Note
If the returned account is end dated with a date that is the same or before the
subledger journal entry accounting date and an alternate account is defined in
Oracle Fusion General Ledger, an alternate account is used. The original account
is stored on the journal line for audit purposes.
If the alternate account is invalid, and the Post Invalid Accounts to Suspense
Account option is selected in the Create Accounting process, then a suspense
account is used. An error message is displayed if a valid suspense account is not
available.
Note
To share an account rule across applications, all sources used by the account rule
must be available for the event class.
If the sources are available, an account rule is assigned to a journal line rule in
the journal entry rule set, and verification occurs to confirm that all sources used
by the account rule are available for the journal line rule accounting event class.
Journal line rules are only available if the sources are shared; such as reference
objects.
Set up account combination rules based upon the following value types:
1. Source Value Type: Derive the account combination by specifying a
source. Sources that have been set up as accounts can be assigned to an
account combination rule. Oracle Fusion Subledger Accounting then
obtains the code combination identifier from the source.
2. Constant Value Type: Establish the account as a constant value.
For example, the constant could be a completed account combination
from the chart of accounts specified. An example is the account
combination, 01.000.2210.0000.000. This is the simplest way to derive an
account.
Note
A chart of accounts must be specified for rules using constants.
Segment Rules
Note
A chart of accounts must be specified for rules using constants.
Value set based rules can be created when a chart of accounts is not specified.
This enables you to share the same rule between more than one chart of accounts
if the segments in these charts of accounts share the same value set.
Set up value set based rules using the same methods discussed in the preceding
Account Combination Rules section.
Event Classes
You can assign a transaction view, system transaction identifiers, and optionally
user transaction identifiers and processing predecessors for an event class in the
Edit Event Class section. The transaction view should include all columns that
have been mapped to system transaction identifiers for the accounting event
class as well as the user transaction identifiers.
Processing Predecessors
Event Types
For accounting event types, specify whether their accounting events have
accounting or tax impact. When the Create Accounting process is submitted, it
only accounts business events that are enabled for accounting.
Subledger applications can support third party control account type and
calculate reporting currency amounts.
Additional Considerations
• If you run two Create Accounting requests at the same time for
different applications, they are much less likely to contend for
database resources. The requests will perform better, as the indexes
are tuned for running with different applications instead of running
for different process categories within the same application.
Transaction Objects
Transaction objects refer to the tables or views from which the Create Accounting
process takes the source values to create subledger journal entries. Source values,
along with accounting event identifiers, are stored in the transaction objects.
The Create Accounting process uses this information to create subledger journal
entries.
The transaction objects and or views must be accessible to the Create Accounting
process. Typically, an ETL (extract, transformation, and load) program is used
to take values from the source system and load them into the database used by
the Create Accounting process. The ETL process is done outside of the Create
Accounting process.
• Line transaction objects are relevant when there are details for the
accounting event that vary based upon transaction attributes. For
example, a mortgage transaction for loan origination may have
multiple amounts, each related to different components of the loan.
There may be a loan origination amount, closing cost amounts, and
escrow amounts. Each of these amounts could be captured as separate
lines, along with an indication of the amount type
Transaction details that are translated, and whose values do not vary
by transaction line or distribution, are normally stored in header
MLS transaction object columns. Examples include Loan Terms for a
commercial loan. Implementers can avoid having to store source values
in header MLS transaction objects by using value sets and lookup
types.
Reference Objects
Reference objects are useful for storing information that is used for creating
subledger journal entries. This information may not be directly from the
source system or may be used for many entries, thus making it redundant. Use
reference objects to share sources information across applications.
For example, store customer attributes, such as the customer class or credit rating
in a reference object, and then, use it to account for different journal entries in a
loan cycle, such as loan origination or interest accrual. Store information, such as
Sources
Source Values
Source values are stored in transaction objects. They are the actual transaction
attribute values from the source system and are used in creation of the journal
entries.
You may have values that are subject to special processing or values that are
stored in named columns in journal entry headers and lines.
Examples of accounting attributes are Entered Currency Code and Entered
Amount.
You may have values that control the behavior of the Create Accounting process
when processing a specific accounting event or transaction object line.
An example of accounting attributes of this type is Accounting Reversal
Indicator.
In order to create a valid journal entry you must, at a minimum, set up the
following accounting attribute assignments.
• Accounting Date
• Distribution Type
• Entered Amount
• Entered Currency Code
• First Distribution Identifier
The details and descriptions of these attributes are included in the Accounting
Attributes section.
Accounting Date
• The accounting date attribute is relevant to all applications. The Create
Accounting process uses it to derive the accounting date of journal entries.
Typically, the event date system source is assigned to the accounting date
attribute.
• The Accrual Reversal GL Date accounting attribute is relevant to
applications using the accrual reversal feature. Users can assign system
and standard date sources to the Accrual Reversal GL Date in the
Accounting Attribute Assignments page. When the Accrual Reversal GL
Date accounting attribute returns a value, the Create Accounting process
generates an entry that reverses the accrual entry.
Accounting Reversal
• Accounting reversal accounting attributes are relevant to applications
that wish to take advantage of the accounting reversal feature. The Create
Accounting process uses them to identify transaction (distributions)
whose accounting impact should be reversed. For the Create Accounting
process to successfully create a line accounting reversal, the accounting
reversal indicator, distribution type, and first distribution identifier
should always be assigned to sources. The definition of the accounting
reversal distribution type and distribution identifiers mirrors the
definition of the distribution identifiers.
N or Null - Not
a reversal
Transaction Alphanumeric Header Event Class No Y - Reversal
Accounting transaction
Reversal object header
Indicator
N or null
- Standard
transaction
object header
Business Flow
• The business flow accounting attributes are referred to as 'applied to'
accounting attributes. If a transaction is applied to a prior transaction in
the business flow, the transaction object must populate sources assigned
Note
When enabling business flow to link journal lines in the Journal Line Rule page,
certain accounting attribute values are unavailable for source assignment in the
Accounting Attributes Assignments window of the same page because they will
be copied from the related prior journal entry.
Distribution Identifier
• Distribution identifiers accounting attributes are relevant to all
applications. The distribution identifier information links subledger
transaction distributions to their corresponding journal entry lines. In
addition, many of the Oracle Fusion Subledger Accounting features,
including accounting reversals, rely on the correct definition and storing
of distribution identifiers in the line transaction objects. The distribution
type and first distribution identifiers are always assigned to sources.
If a transaction distribution is identified by a composite primary key,
additional distribution identifiers are assigned to standard sources, as
appropriate. Values for the distribution type and distribution identifiers
are always stored in accounting transaction objects. The combinations
of the values of the system transaction identifiers with the values of
the distribution identifiers uniquely identify a subledger transaction
distribution line.
Document Sequence
• The document sequence accounting attributes are relevant to applications
that use the document sequencing feature to assign sequence numbers
to subledger transactions. The Create Accounting process uses them
to provide a user link between subledger transactions and their
corresponding subledger journal entries. Assign all document sequence
accounting attributes to sources or do not assign any. In addition, the
Document Sequence Category Code is made available as an Accounting
Sequence Numbering control attribute.
Entered Currency
• Entered currency accounting attributes are relevant to all applications.
The Create Accounting process uses them to populate the journal entry
line entered currency code and amounts. The entered currency accounting
attributes must always be assigned to sources. The sources assigned to the
entered currency accounting attributes must always contain a value. For
event classes that support cross currency transactions and therefore, more
than one entered currency and entered currency amount, multiple event
class accounting attribute assignments are created.
Ledger Currency
Tax
Transfer to GL Indicator
The rules are evaluated in the order shown above. For example, you can define
a Primary Balancing Segment rule and a Legal Entity level rule. If both rules are
used to balance a particular journal, the Primary Balancing Segment rule is used,
as it has a higher precedence.
You have flexibility in defining your intercompany balancing rules. You can
have a simple setup in which you define one rule for your chart of accounts.
This rule is used for all intercompany balancing for all ledgers that use this
chart of accounts. Alternatively, you can have a more granular set of rules. For
example, you can define a different rule for each legal entity and one chart of
accounts rule to cover any gaps in your rule definitions. You can gain even more
granularity by defining rules for specific journal and/or category combinations
or intercompany transaction types.
Setup
• Journal Balancing
• Journal Balancing
Setup
• Journal Balancing
• Journal Balancing
Summarization Options
You can choose to summarize balancing lines generated for a primary balancing
segment out of balance scenario, where all the primary balancing segment
values are assigned to the same legal entity, by specifying the Summarization
option of Summary Net or Detail. You can choose to summarize by primary
balancing segment value or alternatively have individual balancing lines (that
have not been summarized) generated. Note that summarization always applies
to balancing lines generated in a cross legal entity scenario.
• Journal Balancing
• Journal Before Balancing
• Journal Balancing
• Journal after Balancing
The Ledger Balancing Options and Clearing Company Options appear as one
line on the page.
• Journal Balancing
• Journal Balancing
This table lists the options you can set for invoice entry and matching.
Option Description
Require invoice grouping Requires that you enter the name of a group when
creating an invoice.
Allow document category override Allows override of the document category that is
automatically assigned to an invoice if the Sequential
Numbering Enforced profile is set to Partially Used
or Always Used. If the profile is set to Not Used, the
application does not assign a document category to
an invoice, and you cannot set this option or enter a
document category for an invoice.
Allow adjustments to paid invoices Lets you cancel or add lines to paid invoices. In
addition, you can unmatch an invoice from a
purchase order that is not finally matched, and
match the invoice to a different purchase order. You
cannot modify distributions because it would affect
the accounting.
Recalculate invoice installments Recalculates installments during the invoice
validation process.
Hold unmatched invoices Applies a Matching required hold during invoice
validation on invoices that are not matched to a
purchase order or receipt. This option can be set on
a supplier to one of the following values: Yes, No, or
Default from Payables Options. The invoice option
is used only when the setting on a supplier site is
Default from Payables Options.
In addition to the options previously listed, you can specify default values
for the following attributes on both the Manage Invoice Options page and on
the supplier setup. Payables uses the default values from the Manage Invoice
Options page, unless you specify a different value for the supplier.
• Currency
• Pay group
• Payment priority
• Payment terms
• Quantity tolerances
• Amount tolerances
Discounts
This table lists the options you can set for discounts. You can also set these
options on the supplier setup, except for Discount Allocation Method. The
values for these options on the supplier setup are: Yes, No, Default from
Payables Options.
Prepayments
This table lists the options you can set for prepayments.
Option Description
Payment terms Represents default payment terms. For example, you
may want to have immediate payment terms for all
prepayment type invoices.
Settlement days Specifies the number of days to add to the system
date to calculate the default settlement date for a
prepayment. You cannot apply a prepayment to an
invoice until on or after the settlement date.
Approvals
You can use the invoice approval workflow to automate your invoice approval
process. The workflow determines if an invoice requires approval, and if so,
automatically routes the invoice to the applicable approvers who then approve
or reject the invoice.
This table lists the options you can set for the invoice approval process.
Option Description
Enable invoice approval Processes invoices through the approval workflow.
The approval workflow is automatically initiated
for payment requests and self-service invoices that
are created in Oracle Fusion Supplier Portal and not
matched to a purchase order.
Interest
This table lists the options you can set for interest on overdue invoices.
Option Description
Create interest invoices Calculates interest on overdue invoices and creates
interest invoices. You can also set this option on the
supplier setup. The values for this option on the
supplier setup are: Yes, No, Default from Payables
Options.
Minimum interest amount Minimum amount of calculated interest below
which an interest invoice is not created.
Interest allocation method Allocates interest across distributions.
Interest expense distribution Distribution combination used if allocating interest
expense to a single distribution.
Payment Requests
You can specify the following default values for a payment request:
• Payment terms
• Pay group
• Payment priority
Self-Service Invoices
This table lists the options you can set for invoices created in Supplier Portal.
Option Description
Limit invoice to single purchase order Limits an invoice to the schedules belonging to a
single purchase order.
Allow invoice backdating Allows a supplier to enter an invoice for a date in the
past.
Restriction
Installments are recalculated unless you have manually updated any of the
invoice installments or split the installment.
Installments are also recalculated if you set the Exclude tax from discount
calculation option on the Manage Common Options for Payables and
Procurement page and you manually change the tax amount. This re-creation
of invoice installments is not based on the Recalculate invoice installments
setting.
This table shows the start dates and payment terms that installment recalculation
uses for matched and unmatched invoices.
• Invoice date
• Terms date
Determine the method to use for distributing the discounts you take when
making payments. Select one of the following options:
• Single distribution
Note
If you exclude tax from the discount calculation and select this method ,
Payables allocates discounts only to expense lines and not to the tax lines.
You cannot select this method if you exclude tax from discount calculation.
Single Distribution
Payables credits all discounts to the Discount Taken distribution on the Manage
Common Options for Payables and Procurement page. If you enable automatic
offsets, and want to distribute discount taken amounts across balancing
segments, select the Single distribution method.
Oracle Fusion Payables automatically creates invoices to pay interest for overdue
invoices if you enable automatic interest calculation for a supplier, and if you
pay an overdue invoice in a payment process request or with a Quick payment.
The interest invoice is automatically paid along with the overdue invoice.
Note
Payables does not create interest invoices when you pay overdue invoices with a
Manual payment.
• Number
• Terms
• Amount
• Currency
Number
The interest invoice number is the same as the overdue invoice number, but
with the suffix -INTx, where x is the count of interest invoices that were created
for the overdue invoice. For example, the third interest invoice created for an
overdue invoice has the suffix -INT3.
Terms
The payment terms on an interest invoice are Immediate. If you do not have
Immediate terms defined, the interest invoice payment terms are the same as the
overdue invoice.
Amount
The amount of the interest invoice is the interest amount owed. Payables
calculates interest based on the rate you enter on the Manage Interest Rates page
in accordance with the United States Prompt Payment Act. The formula used
compounds monthly, up to a maximum of 365 days interest.
Currency
Interest invoices have the same invoice currency and payment currency as the
overdue invoice.
Oracle Fusion Payables creates and accounts for interest invoices based on one of
the following options:
• Single distribution
Single Distribution
Payables creates interest invoices with a single distribution using the Interest
Expense distribution on the Manage Invoice Options page.
Oracle Fusion Receivables and Oracle Fusion Expenses can submit requests to
Oracle Fusion Payables to disburse funds to a payee who is not defined as a
supplier. Payables records these requests as payment requests. You can disburse
the funds and manage the payment process using the payment management
functionality that is available in Payables.
Note
You can only submit a payment request from other applications; you cannot
enter a payment request for a payee directly in Payables.
There are no specific setup steps required to use payment requests however, the
following setups do affect the payment request process. Review these setups if
you plan to use payment requests.
You can use the following Oracle Fusion Payments setups to manage payment
requests separately from other payments:
Track progress of the payment request in the originating application. Once the
payment request is approved, you can report on and audit the payment request
in Payables using the following reports:
Use transaction types with these settings during your initial implementation,
where the transaction amount is included in the general ledger beginning
balance for the receivable account, but activity still needs to be aged and
payment collected against it. All related activities against the transaction, such
as credit memos, payments, and adjustments, are accounted as affecting the
customer balance. You can review these activities on the Review Customer
Account Details page.
Use transaction types with these settings when you want to adjust accounting
activity, such as when you rebill a customer in order to reclassify the general
ledger account. A credit memo and invoice with the Open Receivable option
set to No are created where the credit memo reverses the general ledger account
of the original invoice, and the invoice creates accounting with the new general
ledger account. This activity is transparent to the customer because the original
invoice is used for the cash application when payment is received.
This activity is not included on the Review Customer Account Details page since
the activity does not modify the customer balance.
The transaction type that you assign to a transaction defines the type of
application that is permitted against the transaction balance. This definition is
managed by the Natural Application Only and Allow Overapplication options.
Natural application lets you only apply a payment or credit to a transaction that
brings the transaction balance close to or equal to zero. For example, if an invoice
has a balance due of $400, you can make applications against this transaction up
to $400 only. With natural application, you can only bring the balance to zero.
Overapplication lets you apply more than the balance due on a transaction.
For example, if you apply a $500 receipt to a $400 invoice, this overapplies the
invoice by $100 and reverses the balance sign from positive to negative.
If you want to use AutoInvoice to import credit memos against paid invoices
and evaluate these credits for automatic receipt handling, then the transaction
type of the paid invoices must allow natural application only. However, if the
Receipt Handling for Credits option is not enabled on the transaction source
of the transaction, AutoInvoice leaves the related credit memo in the interface
tables until you unapply the invoice from the receipt.
Define the accounting for transaction types of class Invoice, Chargeback, Credit
Memo, and Debit Memo. Oracle Fusion Receivables uses this information along
with your AutoAccounting definition to determine the accounts to use for
transactions with the applicable transaction type.
There are points to consider for each reference account on a transaction type:
• Revenue
• Freight
• Receivable
• AutoInvoice Clearing
• Tax
• Unbilled Receivable
• Unearned Revenue
Revenue
Enter a revenue account, unless the transaction type does not allow freight.
If the Invoice Accounting Used for Credit Memos profile option is set to No,
then a revenue account is not required for Credit Memo transaction types.
Freight
Enter a freight account, unless the transaction type does not allow freight.
Receivable
If the Invoice Accounting Used for Credit Memos profile option is set to No,
then a receivable account is not required for Credit Memo transaction types.
AutoInvoice Clearing
Tax
If this is an Invoice, Credit Memo or Debit Memo transaction type, enter a tax
account.
Unbilled Receivable
Unearned Revenue
If applicable, define the transaction types that you want to add to your
transaction sources before defining transaction sources.
How can I use transaction types to review and update customer balances?
You can use the Open Receivable option on the transaction type to implement
an approval cycle for any temporary or preliminary transactions.
For example, if you have particularly sensitive debit memos, credit memos, on-
account credits, chargebacks, and invoices that you want to review after creation,
you can define a transaction type called Preliminary with Open Receivable set
to No and assign it to the applicable transactions. This transaction type does not
update your customer balances.
When you review and approve the transaction, you can define a transaction
type called Final with Open Receivable set to Yes and assign it to the same
transactions. This will now update your customer balances on these transactions.
There are these points to consider when defining transaction numbering for
transactions assigned to specific transaction sources:
Note
You can use automatic transaction numbering with both Imported and Manual
transaction sources.
If you are using document sequences and you want to use the same value for
both the document number and the transaction number for transactions assigned
to a transaction source, enable the Copy document number to transaction
number option.
If you are using Gapless document sequences, you should enable this option
if you require gapless transaction numbering. This ensures that transaction
numbers are generated sequentially and that there are no missing numbers.
• If the Require salesperson system option and the Allow sales credits
option on the transaction source are both enabled, you must provide sales
credit information.
• If the Require salesperson system option is enabled and the Allow sales
credits option on the transaction source is not enabled, you must provide
sales credit information.
• If neither the Require salesperson system option nor the Allow sales
credits option on the transaction source are enabled, you cannot provide
sales credit information. AutoInvoice ignores any values that you pass.
You do not have to pass values for all of the fields that are referenced in the
transaction source. If you do not want AutoInvoice to pass certain data, then
where available you can set the related option to None.
Note
Even if you set a transaction source data option to None in order not to import
this information into the interface tables, AutoInvoice can still validate and reject
transaction lines with invalid data.
• Select Number to import a record into the interface tables using its
assigned number.
• Select Value to import a record into the interface tables using its actual
name.
Note
Use Value if you intend to use the transaction source to import data from a non-
Oracle system.
AutoInvoice ensures that certain column values agree with each other. These
values can be within an interface table or multiple interface tables. For example,
if the transaction source indicates not to use a revenue scheduling rule,
AutoInvoice ignores any values passed for invoicing rule, revenue scheduling
rule, and revenue scheduling rule duration.
• Rejects lines, if all of the accounting periods do not exist for the duration
of the revenue scheduling rule.
You may want to create certain records before creating your transaction sources.
• Transaction types: Define the transaction types that you want to appear by
default on transactions assigned to your transaction sources.
You can optionally create these objects for Imported transaction sources:
Special conditions may apply to the creation of transaction sources for credit
memos.
• Define Manual transaction sources for credit memos created by the credit
memo request approval process.
If you do not use an AutoInvoice clearing account and enable the Create clearing
option on the transaction source, AutoInvoice requires that the revenue amount
be equal to the selling price times the quantity for all of the transactions it
processes. AutoInvoice rejects any transaction line that does not meet this
requirement.
• Manage Taxes
• Define tax
reporting types
and codes.
• Define features to
influence setup
task list.
Tax • Enable controls • Share tax content. • CA GST
to influence tax
behavior. • Define integration • CA HST
with partners.
• Specify defaults
that are commonly
applicable.
• Define
applicability tax
rules.
• Define customer
exemptions.
• Specify party
registrations.
Tax Jurisdictions • Define location- Specify tax rule defaults. • CA Alberta GST
based tax rates.
• CA BC HST
• Define customer
exemptions and
rate exceptions.
Tax Status • Define common • Specify tax rule • GST Standard
rules for tax rates. defaults.
• HST Standard
• Drive reporting • Define customer
needs. exemptions. • HST Reduced
The complexity of tax rule setup falls into three general categories: no tax rules
required, simple tax rule regimes, and complex tax regimes. This table presents
the scenarios and actions associated with each of these categories.
Country Information
Country is a required field in all of the tax-related address locations. The country
fields are supported by a predefined ISO 3166 country name and two-character
country code. For more information on country names and codes, see http://
www.iso.org/iso/english_country_names_and_code_elements.
You do not set up a country as a specific geography level in Trading Community
Model geography because country is an inherent part of all tax-related address
locations.
Tip
Use the highest level of geography, typically country, wherever possible.
Geography Elements
Tip
When address elements are needed for tax purposes, such as country and city
for US Sales and Use Tax, set these address levels as mandatory within Trading
Community Model geography. This ensures that these elements are always
present on all applicable addresses.
Setting address levels as mandatory ensures that amended or newly applicable
addresses are validated and that the level is either derived or entered. When you
are setting up migrated addresses ensure that they are also compliant with the
mandatory levels being present. This should be validated and any address levels
added as part of the migration process.
Tax Zones
Use the tax zone functionality when you need to identify a group of geography
elements while calculating tax. Tax zones are defined as part of Trading
Community Model geography.
For example, in the EC it is important to know whether goods and services are
being delivered within the EC. Use the tax zone functionality to create a tax zone,
which defines the membership to the EC as well as, the dates on which a country
became the member.
Tip
Create a generic tax zone so that you create a tax zone type that can be used
in multiple situations. For example, for a tax zone type needed to identify EC,
create a generic tax zone type for all economic communities, which can later be
used in other situations where economic communities or trade agreements affect
tax determination.
You can also use the tax zone functionality to group postal codes to provide
useful groupings that can identify some higher-level tax regions such as, cities or
counties.
Scenario
Use geography as the determining factor class, country as the class qualifier for
ship-from and ship-to locations, and country as the determining factor as shown
in the following table:
Create a condition set that refers to this geography determining factor as follows:
Use this combination of determining factors in any situation where you need to
identify exports from the United States.
The tax determining factors for locations are given generic names such as ship-
to and bill-from, depending on the transaction types. The transaction types
are Order-to-cash, for example, Oracle Fusion Order Management and Oracle
Fusion Receivables, and Procure-to-pay, for example Oracle Fusion Purchasing
and Oracle Fusion Payables.
These generic locations are mapped to the specific location, based on the
transaction as shown in the following table:
You can also use the geography level as a tax rule qualifier.
Scenario
Use geography as the determining factor class, ship-to as the class qualifier, and
state as the determining factor as shown in the following table:
You can use this combination of determining factors in any situation where you
need to identify specific deliveries to a specific state.
The following scenario describes the use of a partial condition set that you can
use within tax rules to define when a delivery is being made to an EC from the
United Kingdom.
Scenario
Use geography as the determining factor class, ship-to as the class qualifier, and
all economic communities and country as the determining factors of the tax zone
type as shown in the following table:
You can use this combination of determining factors in any situation where you
need to identify the deliveries that are made from the UK to other EU countries.
Features
The following table displays each feature and the impact of not selecting that
feature.
Warning
Once you select a feature for a tax regime, you cannot disable it. You can enable
the feature later if you do not enable it initially for a tax regime.
• Tax jurisdictions
• Tax statuses
• Tax rates
Tax Regimes
Set up tax regimes in each country and geographical region where you do
business and where a separate tax applies. A tax regime associates a common
set of default information, regulations, fiscal classifications, and optionally,
registrations, to one or more taxes. For example, in the United States create
a Sales and Use Tax tax regime to group taxes levied at the state, county, and
district levels.
• Applies as defaults the settings and values that you define for each tax in
the tax regime
• Defines for which taxes the configuration options apply and a specific
subscription option applies
• Provides a single registration for all taxes associated with the tax regime
The common tax regime setup is one tax regime per country per tax type,
with the tax requirements administered by a government tax authority for the
entire country. There are also cases where tax regimes are defined for standard
geographical types or subdivisions within a country, such as a state, province,
country, or city. In these cases, you base the tax regime on the Oracle Fusion
Trading Community Model standard geography.
There are more rare cases where a tax regime is based on disparate parts of a
country or more than one country. In these cases, you can create one or more
tax zones and set up tax regimes for these tax zones. You can also set up a tax
regime as a parent tax regime to group related tax regimes together for reporting
purposes.
You must set up a tax regime before you set up the taxes in the tax regime. Some
tax regime values appear as defaults on the taxes that belong to the tax regime in
order to help minimize tax setup.
You must associate a tax regime with all of the first party legal entities and
business units that are subject to the tax regulations of the tax regime. You can set
up tax configuration options when you create or edit a tax regime or when you
Taxes
Set up details for the taxes of a tax regime. Each separate tax in a tax regimes
includes records for the tax statuses, tax rates, and tax rules that are used
to calculate and report on the tax. Oracle Fusion Tax applies as defaults tax
information from the tax regime to each tax that you create under a tax regime.
You can modify this information at the tax level according to your needs, as
well as add additional defaults and overrides. For tax rule defaults, specify
values that apply to the majority of your transactions. Use tax rules to configure
exceptions to the tax rule defaults.
Identify what taxes you must define. Each tax appears as a single tax line on a
transaction. If you need to show or report more than one tax line per transaction
line on a transaction, then you should set up more than one tax. For example, for
US Sales and Use Tax you would define a tax for each state, county, and city.
You can create a new tax, or create a tax that is based on an existing tax within
the tax regime. You do this to minimize setup by sharing tax jurisdictions and tax
registrations. When you create a new tax based on an existing tax, the attributes
that remain constant for all taxes derived from the source tax are not available
for update. Attributes that are copied and are display only include:
• Tax regime
• Tax
• Geography information
Note
The enable tax settings are not selected, in the same way that they are not
selected when you access the Create Tax page.
You can enable a tax for simulation or for transactions only after you have
completed all of the required setup.
Tax Jurisdictions
Set up tax jurisdictions for geographic regions or tax zones where a specific tax
authority levies a tax. A tax jurisdiction specifies the association between a tax
and a geographic location. At transaction time, Oracle Fusion Tax derives the
jurisdiction or jurisdictions that apply to a transaction line based on the place
of supply. You must set up at least one tax jurisdiction for a tax before you can
make the tax available on transactions.
You also use tax jurisdictions to define jurisdiction-based tax rates. A tax
jurisdiction tax rate is a rate that is distinct to a specific geographic region or tax
zone for a specific tax. You can also create multiple jurisdictions at once using
the mass create functionality for taxes that relate to specific Trading Community
Model geographic hierarchies. For example, create a county jurisdiction for every
county in the parent geography type of State and in the parent geography name
of California.
Tax Statuses
Set up the tax statuses that you need for each tax that you create for a
combination of tax regime, tax, and configuration owner. A tax status is the
taxable nature of a product in the context of a transaction and specific tax on the
transaction. You define a tax status to group one or more tax rates that are the
same or similar in nature.
For example, one tax can have separate tax statuses for standard, zero,
exemptions, and reduced rates. A zero rate tax status may have multiple zero
rates associated with it, such as Intra-EU, zero-rated products, or zero-rated
exports.
You define a tax status under a tax and a configuration owner, and define all
applicable tax rates and their effective periods under the tax status. The tax
status controls the defaulting of values to its tax rates.
Tax Rates
Set up tax rates for your tax statuses and tax jurisdictions. For tax statuses, set
up a tax rate record for each applicable tax rate that a tax status identifies. For
tax jurisdictions, set up tax rate records to identify the tax rate variations for a
specific tax within different tax jurisdictions. For example, a city sales tax for a
state or province may contain separate city tax jurisdictions, each with a specific
tax rate for the same tax.
You can also define tax recovery rates to claim full or partial recovery of taxes
paid.
You can define tax jurisdiction and tax status rates as a percentage or as a value
per unit of measure. For example, a city may charge sales tax at a rate of 8
percent on most goods, but may levy a duty tax with a special rate of 0.55 USD
per US gallon on fuel. Values per unit of measure are in the tax currency defined
for the tax.
You define tax rate codes and rate detail information per rate period. Rate
periods account for changes in tax rates over time. A tax rate code can also
identify a corresponding General Ledger taxable journal entry.
The first step includes the tax regime definition and subscription by an
appropriate legal entity or business unit. While creating your tax regime, you
can minimize configuration and maintenance costs by creating content that can
be shared by more than one entity. For example, legal entities can subscribe
to the shared reference data instead of creating separate and repetitive data.
If the subscribing legal entities have some variations in their setup, you can
The second step includes basic tax definition, such as geographic information,
controls and defaults, direct and indirect tax rule defaults, and tax accounts.
The basic tax definition includes controls that you can set to provide the override
capability at transaction time. For example, if you want to allow users to make
manual updates on transaction tax lines, select the Allow override for calculated
tax lines and the Allow entry of manual tax lines options. However, if you want
to enforce automatic tax calculation on transaction tax lines, do not enable these
options.
Use the direct and indirect tax rule defaults to specify the values that apply to
the majority of your transactions. Create tax rules to address the exceptions or
variations to the defaults. For example, for the Goods and Services Tax (GST)
that applies to the supply of most goods and services in Canada, set the Tax
Applicability direct tax rule default to Applicable. A luxury tax, on the other
hand, is a tax on luxury goods or products not considered essential. As it would
not apply to most goods and services, set the Tax Applicability direct tax rule
default to Not Applicable, and create a tax rule to make the tax applicable when
the product in the transaction satisfies the luxury requirement.
Assign your default tax accounts for the taxes in a tax regime to post the tax
amounts derived from your transactions. The tax accounts you associate serve
as default accounting information for taxes, tax rates, tax jurisdictions, and tax
recovery rates. The tax accounts you define at the tax level, default to either the
tax rate accounts or tax jurisdiction accounts for the same tax and operating unit,
depending upon the tax accounts precedence level of the tax regime. You can
update these default tax accounts in the tax rate or tax jurisdiction setup.
The direct tax rule defaults are the default values for the direct tax rule types,
which include:
Place of Supply
Use the Place of Supply direct tax rule default to indicate the specific tax
jurisdiction where the supply of goods or services is deemed to have taken place.
For example, in Canada, the place of supply for GST is typically the ship-to
location. To handle the majority of Goods and Services Tax (GST) transactions,
select Ship to as your default place of supply.
Note
The corresponding place of supply differs based on the type of transaction. For
example, a place of supply of Ship to corresponds to the location of your first
party legal entity for Payables transactions. For Receivables transactions, Ship to
corresponds to the location of your customer site. For exceptions to this default,
create Determine Place of Supply rules.
Tax Applicability
Use the Tax Applicability direct tax rule default to indicate whether the tax is
typically applicable or not applicable on transactions. For example, the GST
in Canada is a tax that applies to the supply of most property and services in
Canada. When you create the GST tax, select Applicable as your default tax
applicability. For exceptions to this default, create Determine Tax Applicability
rules.
Tax Registration
Use the Tax Registration direct tax rule default to determine the party whose
tax registration status is considered for an applicable tax on the transaction. For
example, with a direct default of bill-to party, Oracle Fusion Tax considers the
tax registration of the bill-to party and stamps their tax registration number onto
the transaction, along with the tax registration number of the first party legal
reporting unit. For exceptions to this default, create Determine Tax Registration
rules.
Tax Jurisdiction
Use the Tax Jurisdiction indirect tax rule default to indicate the most common
geographic area where a tax is levied by a specific tax authority. For example,
value-added tax (VAT) is applicable to the supply of most goods and services in
Portugal. For the tax PT VAT, create the default tax jurisdiction as the country
of Portugal. To address specific tax regions such as Azores and Madeira, which
have lower VAT rates than Portugal, define jurisdiction rates with different VAT
rates.
Tax Status
Use the Tax Status indirect tax rule default to indicate the taxable nature of the
majority of your transactions. For example, if your operations primarily include
zero-rated transactions, select the default tax status as Zero instead of Standard.
This setting facilitates tax determination when multiple zero rates are defined
to handle different reporting requirements for zero rate usage, such as intra-EU,
zero-rated products, or zero-rated exports. For exceptions to this default, create
Determine Tax Status rules.
Tax Recovery
Use the Tax Recovery rate indirect tax rule default to indicate the recovery rate
to apply to each recovery type for each applicable tax on a purchase transaction.
For example, in Canada, both federal and provincial components of Harmonized
Sales Tax (HST) are 100% recoverable on goods bought for resale. In this case,
with two recovery types, you can set up two recovery rate defaults for the HST
tax. For exceptions to this default, such as when the recovery rate determination
is based on one or more transaction factors, create Determine Recovery Rate
rules.
Tax Rate
Use the Tax Rate indirect tax rule default to specify the default tax rate that is
applicable to the majority of your transactions associated with this tax. You can
Set up tax accounts at the tax level. The application automatically copies the tax
account combination to the tax rates that you subsequently create for the tax for
the same ledger and optionally, the same business unit.
Define tax accounts at any of the following levels. The defaulting option is only
available at the tax level.
• Tax
• Tax jurisdiction
• Tax rate
Note
• Ledger and Business Unit: The ledger and business unit for which you
are creating the tax accounts.
• Interim Tax: An account that records tax recovery or liability until the
event prescribed by the statute is complete. Generally, the payment of
the invoice is the event that triggers the generation of the tax recovery or
liability. You must set up an interim tax account for taxes and tax rates
that have a deferred recovery settlement. Once you set up an interim tax
account for this tax rate, you cannot change the recovery settlement to
Immediate.
• Finance Charge Tax Liability: An account that records the tax liability
associated with finance charges that is used as a deduction against overall
tax liability.
Note
2. Select the regime level to define the geographic area of the tax treatment.
The option selected must depict the need for the tax regime. It should be
set to Country for all federal taxes.
3. Specify Canada as the country for which this tax regime is being defined.
4. Enter a start date that will appear as a default to all related tax setup
within the tax regime.
Note
Consider your tax planning carefully before entering the start date. This
date must accommodate the oldest transaction that you want to process
within this tax regime. After you create the tax regime, you can only
update this date with an earlier date. If you enter an end date, you cannot
update this date after you save the record.
5. Enter tax currency. Enter CAD, which is the three-letter ISO code for the
Canadian dollar.
Tax currency is the currency required by the tax authority. Use the tax
currency to pay the tax authority and to report on all tax transactions.
6. Select the Allow cross regime compounding option to set taxes within the
tax regime to be based on the calculation of, or compounded on, taxes in
another tax regime.
For example, in Quebec, the provincial sales tax is applied to both the
selling price and GST. Enter a value as the compounding precedence
to indicate the order of cross regime compounding. A lower number
indicates that the tax regime will be processed first. Allowing gaps
between numbers provide flexibility in the event that another higher
priority tax regime is introduced in the future.
7. On the Configuration Options tab, select the party name that identifies
either the legal entity or the business unit or both for which you will
define the configuration options.
8. For the Configuration of Taxes and Rules, select the subscription that
defines the configuration owner setup that will be used for transactions of
the specific legal entity and business unit for this tax regime.
This selection also defines whether any shared content can be overridden
by the subscribing party to allow unique, separate setup for certain tax
content.
9. Enter the effective start date for this configuration option. Enter a date
range that is within the date range of both the party tax profile and the tax
regime.
Enable Tax
1. Click the Enable tax for simulation option. This allows you to verify the
tax configuration using the Tax Simulator.
2. Once you have verified your tax configuration with simulated
transactions, click the Enable tax for transactions option. This allows you
to use this tax in transaction processing.
3. Click Save and Close.
When you create a tax regime, you specify the options and defaults available
to the taxes associated with the tax regime. You also enable the features that are
applicable to the tax regime and its taxes.
The options appearing in the Associated Taxes Setup Information region on the
Edit Tax Regime page are a result of the features enabled and the options you
selected at the tax level. These options include:
For example, suppose you have a California county sales tax that applies to all
counties, so you need a tax with multiple jurisdictions. In this case, you must
enable the Multiple Jurisdictions feature at the tax regime level and then select
the Allow multiple jurisdictions option at the tax level. When you access the
Edit Tax Regime page, Associated Taxes Setup Information region for this tax
regime, the Allow multiple jurisdictions option appears as selected.
• Defining the controls and defaults that apply to taxes and associated
lower level information
The common tax regime setup is one tax regime per country per tax type, but
you can also have tax regimes based on parts of a country or more than one
country. Select the regime level as:
• Tax zone: The tax regime is applicable to parts of a country or more than
one country. Enter the tax geography type and tax geography name
associate with the group of countries or the tax zone that you want. The
tax geography type and tax geography name correspond to the tax zone
type and tax zone respectively.
Set tax-level controls to enable the options that you want to make available to
the taxes in this tax regime. If necessary, you can disable the options that you
enable here for individual taxes within the tax regime. Enter default values for
the taxes in this tax regime. You can update the default values at the tax level.
Important
Oracle Fusion Tax provides features at the tax regime level to streamline your
implementation by selecting the features that are applicable to the tax regime in
scope. You must enable the features to use that functionality for the tax regime
and related taxes.
Set up configuration options to associate tax regimes with the parties in your
company that have a tax requirement under these tax regimes. You can set up
tax configuration options when you create a tax regime or when you create a
party tax profile for a first party legal entity or business unit. Both tax regime
and party tax profile setup flows appear and maintain the same party and tax
regime association. Configuration options only apply to tax regimes directly
linked to taxes and not to tax regimes that are used to group other tax regimes.
Oracle Fusion Tax lets you use the tax services of external service providers for
tax calculation of US Sales and Use Tax on receivables transactions. The setup for
provider services is called a service subscription. A service subscription applies
to the transactions of one configuration option setup for a combination of tax
regime and legal entity or business unit.
Note
The level of detail of tax rounding definitions for the taxes in the tax regime
must equal or exceed the level of detail of the service provider tax rounding
definitions.
Manual Approach
In the manual approach, you access the calculated tax lines on a transaction and
select the Inclusive option. This action includes the calculated tax amount with
the item value.
However, this option is controlled through two factors:
• Privileges are assigned to the users for accessing and editing the
calculated tax lines.
• Setup restrictions are applied to edit the Inclusive option on the
calculated tax lines.
Automatic Approach
In the automatic approach, you can configure the tax setup and calculate the tax
on a transaction as inclusive of the item line amount. Since this requirement is
primarily driven by the tax legislation and the business relationship between the
transacting parties, the option for configuring the inclusiveness is made available
on the tax and tax rate definition and the third party and legal reporting unit
tax profiles on the tax registration and general data tabs. The tax determination
process uses a hierarchy approach to evaluate the defined setup and applies the
inclusiveness option on the transaction.
In tax setup there are options to choose for applying the inclusiveness on a
transaction. They are:
• Standard noninclusive handling: This option calculates the taxes as
exclusive of the given transaction line amount.
• Standard inclusive handling: This option calculates the taxes as inclusive
of the given transaction line amount.
• Special inclusive handling: This option calculates the taxes as inclusive
of the given transaction line amount, but the calculation methodology
differs from the standard inclusive process.
The following table illustrates the calculation methodology used with each of
these options when a transaction line amount is 1000 USD and the applicable tax
rate is 10% of the taxable basis amount, for example, line amount:
Note
If you plan to use a third party service provider then you must define tax
rounding information that is at least as detailed as the rounding information of
the service provider.
A similar concept is used to define where you use tax exceptions for a specific
tax configuration. The tax subscription option available for product exceptions is
dictated to some extent by the main tax content subscription as follows:
Set up tax configuration options when you create a tax regime or when you
create a party tax profile for a first party legal entity or business unit. Both
setup flows display and maintain the same party or regime definitions. Specify
effective start and end dates to identify which configuration should be used
based on the transaction date. You can enable the business unit so that Oracle
Fusion Tax automatically uses the configuration of the legal entity. Once you
set this option the application records the date it occurred as the start date. This
date is used and compared to the transaction dates to identify if the application
uses the legal entity subscription in preference to the subscription of the business
Use the tax services of external service providers where tax content is required
for Receivables transactions for a significant number of tax jurisdictions. You
should not use a service provider if their use is not needed to support US Sales
and Use Tax regimes or you need to create and maintain tax regimes outside of
the Unites States.
You can use the tax services of these external service providers:
• Taxware, LP: a First Data Company
If you decide not to use an external service provider or you need to create tax
content for tax regimes outside the US then create and maintain your tax content
in Oracle Fusion Tax.
Once the decision is made to use Oracle Fusion Tax you need to choose the level
of tax configuration options. Sharing tax content prevents the need for duplicate
maintenance with its inefficiencies and potential inconsistencies. Consider these
scenarios and options:
Scenario Option
You have a single central corporate tax center Use the common configuration with party override
responsible for maintenance of tax setup for all legal option. This allows a single tax setup to be created
entities and business units. and maintained by the corporate tax center.
You need to have strict control of who can maintain Use the common configuration option. By not
the tax content. allowing party override you restrict the access to the
global configuration owner to an authorized user
who can maintain all of the tax content.
You have regional centers responsible for tax Use the parent first party configuration with party
content. override option. This permits a regional setup with
an actual or logical parent legal entity to be created
and maintained by each regional center.
Even if there is no obvious need to share tax configuration, for example, there
is only a single first party legal entity operating in each tax regime, significant
business events such as takeovers or mergers may mean that there could be a
future need to share content. In this case the original first party legal entity can
act as the configuration owner and then any subsequent first party can subscribe
to the first party's content using the parent first party configuration with party
override. Alternatively, set up the original tax content using global configuration
owner in preparation for any future business event that requires tax content to be
shared.
Changing from Business Unit to Using Tax Configuration at the First Party
Legal Entity
If you can standardize your tax setup across all business units for a given legal
entity then consider moving to configuring and using tax setup at the legal entity
level. Set the Use subscription of the legal entity option on the business unit
tax profile. Oracle Fusion Tax records the date this occurs and compares it to
the transaction date to identify if the legal entity subscription should be used in
preference to the subscription to the business unit.
Create a tax from an existing tax when you have a need to share tax jurisdictions
and tax registrations. You maintain the tax jurisdictions and tax registrations
once for taxes with the same name within the same tax regime owned by
different configuration owners.
Note
If you are using product exceptions, those exceptions are applied to the
transactions as shown in the following table:
• US
COUNTY
SALES TAX
• US CITY
SALES TAX
NAM Canada CA HST & GST • CA HST
• CA GST
Field Value
Tax Regime Code GB VAT
Configuration for Taxes and Rules Party-specific configuration
Configuration for Product Exceptions Party-specific configuration
Parent First Party Organization Blank
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code GB VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization EMEA LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code FR VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization EMEA LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code DE VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Field Value
Tax Regime Code AU GST
Configuration for Taxes and Rules Party-specific configuration
Configuration for Product Exceptions Party-specific configuration
Field Value
Tax Regime Code AU GST
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization APAC LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code SI VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization APAC LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code US SALES TAX
Configuration for Taxes and Rules Party-specific configuration
Configuration for Product Exceptions Party-specific configuration
Parent First Party Organization Blank
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code US SALES TAX
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization NAM LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code CA GST & PST
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization NAM LE
Effective Start Date 01-Jan-01
The following product classifications for tax purposes can be used within Oracle
Fusion Tax and are summarized in the following table:
Tip
When available use the product fiscal classifications in preference to product
categories, because the application automatically derives product fiscal
classifications at transaction time based on the items defined on the transaction
line and their relationship to the applicable catalog classification.
You can use product category fiscal classifications in conjunction with product
fiscal classifications. This combination allows you to define two different
determining factors at transaction time.
Code Name
LUG01 Goods
LUG0100 Normal Rated Goods
LUG0101 Zero Rated Goods
LUG0102 Exempt Goods
LUG0103 Reduced Rate Goods
LUG0103-01 Reduced Rate 1 Goods
LUG0103-02 Reduced Rate 2 Goods
LUG0103-03 Reduced Rate 3 Goods
LUS01 Services
LUS0100 Normal Rated Services
LUS0101 Zero Rated Services
LUS0102 Exempt Services
LUS0103 Reduced Rate Services
LUS0103-01 Reduced Rate 1 Services
LUS0103-02 Reduced Rate 2 Services
LUS0103-03 Reduced Rate 3 Services
Use the level two codes to link the items that need to be classified using
Inventory catalog.
Use the product fiscal classification pages to define the tax regimes for which
specific product fiscal classification are to be used. Also, define if the product
fiscal classification is available to be used in the setup of tax product exceptions.
To set up tax product exceptions, enable the Use in Item Exceptions option. You
can only set up one product fiscal classification for a specific tax regime with the
Use in Item Exceptions option enabled.
Adjust the number of levels by increasing the number of levels. It is not possible
to decrease the number of levels once the record is stored. In addition, you need
to attach tax regimes to every level that is used in the tax rules.
Tip
While setting up the product fiscal classification, use different levels so that
all of the necessary tax rules can be defined at the highest level possible, thus
minimizing the needed number of tax rules.
In the previous example, the tax rule can use the level 1 product fiscal
classification to differentiate between goods and services.
Product Fiscal Classifications in Tax Rules
The product fiscal classification tax determination factors allow you to use
product fiscal classification in tax rules. A combination of determination factor
class and determining factor represents these determination factors.
Use Product inventory linked as the determining factor class and the product
fiscal classification type code or name as the determining factor. When creating
the tax rule, the value is the name or description associated with the relevant
level.
Product Fiscal Classifications at Transaction Time
When an item is defined on the transaction line, the application automatically
derives the default product fiscal classification on the transaction line using
the default primary Inventory category set, that is, the Inventory catalog. The
primary Inventory category set is defined in the country defaults of the taxation
country. You can override this default during transaction time. The overridden
default is used in the tax determination process.
The product fiscal classification is stored in the tax reporting ledger and is
available for reporting.
Code Name
LUG01 Goods
LUG0100 Normal Rated Goods
LUG0101 Zero Rated Goods
LUG0102 Exempt Goods
LUG0103 Reduced Rate Goods
LUG0103-01 Reduced Rate 1 Goods
LUG0103-02 Reduced Rate 2 Goods
LUG0103-03 Reduced Rate 3 Goods
LUS01 Services
LUS0100 Normal Rated Services
LUS0101 Zero Rated Services
LUS0102 Exempt Services
LUS0103 Reduced Rate Services
LUS0103-01 Reduced Rate 1 Services
LUS0103-02 Reduced Rate 2 Services
LUS0103-03 Reduced Rate 3 Services
Tip
While using the product fiscal classification, classify the nonstandard items of
your business as standard items. This can be modeled as a default tax rule and
therefore, does not require an explicit classification or an explicit rule. Classify
only exception items and define specific tax rules for them. For a standard item,
none of the explicit rules are applicable and the default rate applies.
Tip
3. Create a product fiscal classification and link it with the catalog using the
code LU VAT PRODUCT FISCAL CLASSIFICATION. In this scenario,
only a single level is needed, although other levels may be needed to
model nonstandard services or subclassifications of product types for
reporting purposes. The following table represents this multiple level
requirement:
Use Product inventory linked as the determining factor class, the level
to be defined in the rule as the class qualifier, and the specific LU product
fiscal classification level as the determining factor as shown in the
following table:
6. Create the condition set that refers to the product category fiscal
classification as shown in the following table:
7. Create the tax status rule based on the determining factor set and
condition set with zero tax rate status as the result as shown in the
following table:
Tip
While using the product category fiscal classification, only classify the
nonstandard items of your business. Handle standard items by using default tax
rules. Thus, for a standard item, none of the explicit tax rules are applicable and
the default rate applies.
The standard items are included in the table for completeness only. Modeling
these standard items using default tax rules may be sufficient.
Tip
Do not add the explicit percentage to the naming or coding convention used for
product category fiscal classification. When the rate changes, you change the
rate period on the specific rate and you do not have to change classifications or
associated tax rules.
2. Create the determining factor set which refers to this product category
fiscal classification.
3. Create the condition set that refers to this product category fiscal
classification as shown in the following table:
4. Create the tax status rule based on the determining factor set and
condition set with zero tax rate status as the result as shown in the
following table:
Tip
Note
If the code is applicable to multiple countries, leave the country field blank.
The intended use fiscal classification tax determination factors allow you to use
the intended use fiscal classification in tax rules. A combination of determination
factor class and determining factor represents these determination factors.
Use the Transaction input factor as the determining factor class and Intended
use as the determining factor.
During transaction time, when an item is defined on the transaction line, the
application automatically derives the default intended use fiscal classification.
Override this default intended use fiscal classification at the time of transaction,
if necessary.
The intended use fiscal classification is stored in the tax reporting ledger and is
available for reporting.
Scenario
In the United Kingdom the VAT received from purchase of goods associated
with VAT exempt sales cannot be recovered that is, the recovery rate is zero
percent (0%).
To calculate recoverability:
1. Configure Oracle Fusion Inventory catalog.
2. Create a catalog with a name of INTENDED USE for the intended use
fiscal classification.
3. Create class categories such as, Linked to Exempt Sales. The catalog is
used for other classifications such as business entertainment and company
cars. Link all items that are associated with exempt sales to the class
category as follows:
Code Name
EXEMPT SALES Linked to Exempt Sales
BUS ENTERTAINMENT Business Entertainment
COMPANY CARS Company Cars
Tip
While using the intended use fiscal classification, classify the nonstandard items
of your business as standard items. This can be modeled as a default tax rule and
therefore, does not require an explicit classification or an explicit rule. Classify
only exception items and define specific tax rules for them. For a standard item,
none of the explicit rules are applicable and the default rate applies.
Catalog
A catalog is a collection of categories that are organized to define a classification
of items. The top most level of a catalog is the catalog root. All categories for the
first level in the category hierarchy are associated with the catalog root through
the catalog category association component.
Category
A category is a component of a catalog that represents a portion of the
classification defined by the categories and category hierarchy in the catalog. You
can associate a category to a catalog through the catalog category association.
Both the shared category and the native category are associated thorough the
catalog category association.
Item
An item represents objects such as a product, service or template. An item is
assigned through the item category assignment component.
Attachment or Image
Information is associated to the catalog and/or category, or both, through
the attachment framework. Multiple attachments are supported but you can
associate only a single attachment or attachment type image with a catalog or
category.
Catalog Configuration
You can configure the catalog, and this affects how the content behaves.
The catalog configuration contains a set of attributes that define the catalog
configuration. These attributes interact to define the runtime behavior of the
catalog.
The configuration functions are:
• Catalog code: A unique identifier that is used.
• Catalog structure: The key flexfield structure used to define the catalog.
• Controlled at: Controls how items are assigned to categories and has
two values. The first value is master level, which enables the automatic
assignment of items to all child organizations associated with the
master organization, if the current context is a master organization. The
second value is organization level, which assigns the item only to the
organization in the current context.
• Default category: Applies any time a new item is created. The newly
created item is assigned to this category within the catalog automatically.
The automatic assigned is controlled by the functional area.
• Catalog content: Controls what content can be added to the catalog and
where the content can be added. This attribute has three values:
Category Sharing
The category sharing function enables sharing by reference to categories from a
designated source catalog.
The sharing function has these attributes:
• Source catalog: A catalog that does not have sharing enabled from which
categories, category hierarchies, and assigned items can be added to the
catalog.
• Sharing content: Controls what content can be added from the source
catalog. This attribute has three values:
• Categories only: Only categories without assigned items can be shared.
• Items only: Only categories with assigned items can be shared.
• Items and categories: All categories can be shared.
Automatic Assignments
The automatic assignment feature is enabled during catalog creation when you
select the Enable automatic assignment of category check box. When you open
a new catalog, any categories that have the same category structure value as the
catalog structure value for the catalog are automatically assigned to the catalog.
For example, Purchasing may maintain a master catalog containing all categories
that represent commodities. Each commodity team can create categories for their
commodity in their own catalog.
• The master catalog for Purchasing is named Purchasing and is configured
during creation to support the automatic assignment of categories.
Manage Catalogs
Default Category
You can edit this field to select another category as the default category for item
creation. You cannot remove the default category if the catalog is assigned to a
functional area that requires a default category to be specified.
This check box is editable only until you assign an item to a category in the
catalog.
Addition Information
The catalog category association is date enabled providing the control of when
the catalog category association is active in the catalog and when the catalog
category association is inactive. The catalog category association has two
attributes to support date enablement; the start date and the end date. The start
date is value is the first day that the catalog category association is available or
active for use and the end date is the last day the catalog category association
can be used, after this date the catalog category association is inactive. The date
enablement attribute values are also used to control the visibility of content and
the behavior of the category in the catalog. If a category association is inactive or
end dated, having the value of the end date attribute past the current date, then
the items cannot be assigned to the category.
A catalog category association will be set to inactive state when the category
referenced by the catalog category association is set to an inactive state
automatically, but the display will not be refreshed automatically.
The catalog, categories, and catalog category association use date enablement to
determine if the object specified is active or inactive based on the start date and
end date. The following are date enablement definitions:
• Active An object is active when the current date is later than or equal to
the value of the start date, but earlier than or equal to value of the end
date.
• Inactive An object is inactive when the current date is later than the value
of the end date.
• Future dated An object is future dated when the current date is earlier
than the value of the start date.
You set the date enablement attributes are used to determine when a catalog,
category, or catalog category association is used or visible.
• On the Manage Catalog page, a table filter determines which catalogs
appear. The default value for the choice list is Active, indicating that only
active catalogs will be displayed. You can select the value All to view both
active and inactive catalogs.
The following aspects are important regarding date enablement for catalogs and
categories:
• Start date
• End date
• Catalog and category objects
• Catalog category association
• Catalog and category rules
The start date is defined as the first date that the object can be active. The start
date can be future dated by setting the value to a date later than the current
date. The start date value defaults to the system date if no date is entered during
catalog or category creation.
End Date
The end date is defined as the last date that the object can be active. The object
is end dated one second after the date specified by the value of End Date, that
is the next day at 12:00:01 a.m. You cannot set the end date in the past. Also, you
can change the end date from a condition when the object is ended to a new
end date greater than or equal to the system date, causing the object to go from
inactive to active. The end date value is optional during catalog or category
creation.
The start and end dates have been added for the catalog and catalog category
association. The inactive date for categories has been renamed as the end date
and the start date has been added.
The catalog category association is used to specify the parent and child
relationships between catalogs and categories and for category to category
relationships. The catalog category association date enablement is independent
of the category data enablement, except for the case where the category is end
dated; the association is ended automatically as well. The catalog category
association dates represents the state of the category for the catalog in which the
category is associated.
• All the operations of the catalog are enabled and the catalog is editable.
• The catalog can be viewed only if the you set the filters on the Manage
Catalog page to value of All.
• Catalog root: The topmost node in category hierarchy that represents the
object called catalog.
• Item category assignment: The dotted line in the dialog represents the
relationship between a category and an item.
The category hierarchy does not have a limit on how many levels can be
represented. The category hierarchy can have multiple hierarchies within a
single category hierarchy.
Categories can be edited only from within an Edit Catalog page, the category
hierarchy tab. The category can be edited by selecting row for the category in the
category hierarchy table and editing the category information in the category
detail panel. The category can only be edited if the category is active and the
catalog is active or future dated.
The category information can be edited in both the details and items tabs.
• Category name
• Description
• Attachments
After changes are made the Save button will save the changes to the database
but will not close the Edit Catalog page. The Save and Close button will save the
changes to the database and close the Edit Catalog page.
The catalog category association can be edited only within the Edit Catalog page,
in the category hierarchy tab. The catalog category association start date and end
date attributes can be edited in the details region.
You select the category in the category hierarchy table for the catalog category
association that is being edited, the category details are displayed in the right
hand panel. The association start date and association end date are the only
editable fields.
After completing the edits, click on the Save button to save your changes to the
database, the Edit Catalog page will not close. The Save and Close button will
save the changes to the database and close the Edit Catalog page.
You can update category details when you select the row with the category in
the category hierarchy table, the category details are displayed in the right hand
panel in the user interface in an edit mode for all native categories. The category
detail region contains information about the category that is associated to the
catalog. It also contains the association start and end dates.
You can view and edit a catalog on the category details tab when you have
editing rights. For users that do not have rights to edit, the page is in read only
mode.
The following aspects are important regarding managing and editing category
details:
• Items tab
Items Tab
The item assignments are specific to the catalog where the category is associated.
Categories: Explained
You can create categories only in the context of a catalog, on the Edit Catalog
page, Category hierarchy tab. When you select the Create icon in the category
hierarchy table, it launches the Create Category dialog.
Consider the following important aspects when creating categories for catalogs:
• Configuration region
Enter a name and a meaningful description of the category in the create category
region. Optionally, you can add an image and an attachment to this category.
Configuration Region
The key flexfield is determined during creation based on the catalog structure of
the catalog. Enter the key flexfield segment values for the category. The number
of key flexfield segment values depends on how you define the key flexfield
at setup time. The category structure is the key flexfield structure instance that
you create as part of the setup. When you define the key flexfield structure
instance, you define the segments for the structure instance. For example, the
family group and class group are segments. The segments appear in the Create
Category dialog based on the key flexfield structure instance that you select.
The default value of the category content selection value is Items and
Categories, but you can change the value. The values in the category content
choice list vary based on the catalog content value.
The category content attribute value controls the content that you can add to this
category.
• Items and Categories: Select to add both items and categories to the
category
After you complete the required fields for the catalog, clicking OK creates
the category in the database, adds the category to the point of selection in the
category hierarchy, and closes the dialog.
You use the move category function in the category tree table region of the Edit
Catalog page. This is a table row action. The dialog is launched when you select
an active or future dated category within the catalog and select this action. The
move category function is disabled when the Enable hierarchies for categories
check box is not checked or left unchecked.
The dialog provides the current category parent and allows you to pick a new
category parent. Only the legal category parents are displayed in the choice list.
The category list within the New Parent choice list is filtered by based on a set of
rules:
• The new parent category must be an active or future dated category; the
end date value of the category must be later than the current system date.
• The value of the category content for the new parent category must
allow the selected category to be added; the legal values are items and
categories and categories only.
• The new parent category catalog category association must be active; the
end date value of the catalog category association must be later than the
current system date.
The following aspects are important regarding category hierarchy import used in
catalogs:
• Spreadsheet interface
Spreadsheet Interface
You can manage the catalog category hierarchy to use the spreadsheet interface
that is available in the Edit Catalog page by using the Export Hierarchy button
to download existing catalog content, modify this content in a spreadsheet, and
upload the content back into the Product Information Management application.
You can export the category hierarchy from our catalog and it can be used by
partners. If your partner has the Oracle Product Information Management
solution, they can directly import the category hierarchy into their catalog.
The attachment component displays a green plus sign icon indicating that no
attachments are available for the object. The Attachment dialog appears when
you click the green plus sign icon. You define the attachment by selecting the
attachment type, file name or Uniform Resource Locator (URL), title, description,
and by indicating whether the attachment can be shared with other objects.
Once you define the attachments and click the OK button, that attachment title
appears in the attachment component region of the page along with a red X icon
that you can click to delete the attachment.
• File
• Repository File/Folder
• Text
• URL
File
You must provide a title for the file and create a description for the attachment.
You select a file to upload from your desktop.
Repository File/Folder
You click the Browse button to attach a repository file/folder from the document
repository to a catalog. The attachment repository contains existing attachments
and is organized as a set of folders. The Browse button launches the Attachment
Repository dialog to enable you to select an attachment. You must provide a title
for the repository file/folder and create a description for the attachment.
Text
Enter the text string in the field that you want to appear as an attachment. You
must provide a title for the text and create a description for the text attachment.
URL
Enter the URL address to a web page that you want to attach to the catalog. You
must provide a title for the URL attachment and create a description for it.
The Share check box alerts users that you added an attachment and the date that
you performed the task.
You can assign items to categories on the Edit Catalog page, category hierarchy
tab, on the category detail item tab. You can assign items only to active
categories and categories where the Category Content field value is Items and
Categories or Items Only. In addition, you can configure catalogs to control item
assignment to categories within the catalog by selecting the Allow multiple item
category assignment check box, which allows items to be added to all levels of
the category hierarchy.
You select items from a choice list and add them to the category. The choice list is
filtered based on a set of rules:
• Item data level security: Displays only the items that the user has
permission to view and assign.
You also control item assignment by selecting the value of the Controlled at
check box. If you select the Master Level value and the organization context
is a master organization, the items are automatically assigned to all child
organizations that are associated with the master organization.
Other applications can use catalog data if you export the catalog content. For
example, you may want to export catalog content to use as a monthly report of
all items assigned to a specific catalog. You can use the default publish template
provided in hyper text markup language (HTML). You can specify the content
and layout of the catalog information. When the catalog is published, you select
the format and initiate the creation of the content in the file.
• Publish a catalog
Publish a Catalog
You initiate a search for a catalog from the Manage Catalogs page, select the row
corresponding to the catalog that you want to publish and select the Publish
action. The application generates the report based on the default template in
HTML format, and the locale prior to creation of the file. You can select a new
template or format from the report window. The content displayed for items,
categories, catalog categories, and catalog is based on the publish template.
The default catalog publish template allows the publication of the catalog header
details, category hierarchy, category details, and category item assignments.
The order of a published report begins with the catalog header and the catalog
category details. If the category has a child relationship then the catalog category
association details for the child category follows. If the child category has a
hierarchy, then the complete hierarchy under the category is published with the
catalog category association details and categories details.
The category hierarchy can be created using two methods: the first is manually
creating the hierarchy by adding referenced categories, duplicating categories or
creating category for the catalog.
The second method for creating the hierarchy is by importing the category
hierarchy through the spreadsheet interface. The category hierarchy can be
exported from other catalog or other sources, edited and imported into a new
catalog, additionally it can be added manually to the spreadsheet.
The category hierarchy can be edited using Move Category. The catalog category
association cannot be deleted, but can be end dated to make the catalog category
association inactive. The category hierarchy table provides a choice list filter that
controls what catalog category associations and categories area displayed based
on the date enablement. The category hierarchy can also be edited by exporting
the complete hierarchy, editing it and importing the category hierarchy back into
the catalog.
You can select and duplicate a category as a quick way to create a similar
category configuration. Selecting the Duplicate icon action launches a Create
Category dialog that has attribute fields populated based on the selected
category attribute values. The category name is prefixed with Copy_ followed by
the name of the selected category. You fill in the required field information in the
key flexfield segment values which are blank. Once the category attributes are
updated and the key flexfield segments values are entered, the OK button adds
Categories are catalog components that are associated to a catalog for purpose
of classification of items. You can add existing categories to the point of selection
which can be a category in the hierarchy or the root of the catalog. If no category
is selected, the default is the root of the catalog.
You can add categories by selecting the Add Category field and selecting the
value Add Category. You can then search for existing categories based on the
value of the catalog structure for the catalog. You can narrow the search for
existing categories by using the Advance Search region in the dialog. You can
add each selected category by selecting the Apply button and the add category
region remains open. The OK button adds a category if a category is selected and
then closes the dialog.
You can attach an image from your desktop or from a configured repository
to a catalog or a category, or both. The image is displayed in the catalog detail
and the category detail section of the catalog page. Only one image can be
associated with a catalog or category. To attach an image, select the green plus
icon to launch the Manage Attachment dialog. The image attachment type can
have values of File or Repository File/Folder and is selected in this dialog.
The title you provide for the image attachment will appear under the image
that is displayed in the catalog. The description you provide is not displayed.
Browse will allow you to select the file to be used as the image for the catalog
or category. After the information is entered in to the dialog, you click the OK
button to load the image and the image attachment title will be displayed under
the image. The image will not initially be displayed until the catalog is saved.
The image can be replaced with another image by selecting the red X to delete
the existing image and entering a new image.
You use Catalog Category mapping to map categories of different catalogs to the
reporting categories in other catalogs. This feature allows one or more categories
The following process classifications for tax purposes can be used within Oracle
Fusion Tax and are summarized in the following table:
Tip
• EXPENSE_REPORT
• INTERCOMPANY_TRANSACTION
• PAYMENT_REQUEST
• PURCHASE_PREPAYMENTTRANSACTION
• PURCHASE_TRANSACTION
• SALES_TRANSACTION
• SALES_TXN_ADJUSTMENT
When setting up transaction business categories, leave the Country field blank
or use the country name as defined on any parent level of the record that is being
added.
Tip
While setting up the transaction business categories, use different levels so that
you can define all of the necessary tax rules at the highest level possible. This
facilitates in minimizing the needed number of tax rules.
The transaction business category tax determination factors allow you to use
the transaction business category in tax rules. A combination of determination
factor class, class qualifier, and determining factor represent these determination
factors.
Use the transaction generic classification as the determining factor class, the level
of the transaction business category being used, level 1, level 2, level 3, level 4, or
level 5 as the class qualifier, and transaction business category as the determining
factor.
When a country name is specified on the condition set, the application selects
only those transaction business categories that match the country name or where
the country name is blank on the transaction business category.
The transaction business category is stored in the tax reporting ledger and is
available for reporting.
Scenario
In Brazil, you need to identify a transaction correctly to be able to report and
determine the correct applicable taxes. Create specific transaction business
categories as children of the sales transaction. The transaction business categories
include:
Tip
Specify the country name while creating transaction business categories. This
ensures that a limited applicable list is presented while entering the transaction
business category during transaction or tax rule creation.
Tip
While using the transaction business categories classification, classify the
nonstandard items of your business as standard items. This can be modeled as
a default tax rule and therefore, does not require an explicit classification or an
explicit tax rule. Classify only exception items and define specific tax rules for
them. For a standard item, none of the explicit tax rules are applicable and the
default rate applies.
Tip
Tip
Use the Associated Codes Details region to define the relationship between
transaction fiscal classification codes, the transaction business category codes,
and the tax reporting codes. Use the Transaction Business Category Codes and
the Tax Reporting Codes tab to define the relationship.
The transaction fiscal classification tax determination factors allow you to use
the transaction fiscal classifications in tax rules. A combination of determination
factor class and determining factor represent these determination factors.
Use the transaction fiscal classification as the determining factor class and the
specific transaction fiscal classification type as the determining factor.
During transaction time, use the transaction business category entered on the
transaction line to classify the transaction line. The application derives the
transaction fiscal classification using the defined relationship between the
transaction business category and the transaction fiscal classification.
Scenario
In Brazil, you need to identify a transaction correctly to be able to report and
determine the correct applicable taxes. Create specific transaction business
categories as children of the sales transaction. The transaction business categories
include:
Tip
Specify the country name while creating transaction business categories. This
ensures that a limited applicable list is presented while entering the transaction
fiscal classification during transaction or tax rule creation.
Tip
In this classification and many other tax classifications, classify the nonstandard
items of your business as standard items. This can be modeled as a default
tax rule and therefore, does not require an explicit classification or an explicit
rule. Classify only exception items and define specific tax rules for them. For a
standard item, none of the explicit tax rules are applicable, only the default rate
applies.
The tax rules that apply to sales transactions are also applicable to purchase
transactions. In this case, equivalent set rules are needed to represent the
In the above scenario, instead of creating tax rules based on the type of
transaction business category, that is, separate tax rules for sales and purchase
transactions, create a single transaction fiscal classification and both the
applicable sales and purchase transactions can be linked to it.
Create the following specific transaction fiscal classification with the relevant
tax regime and transaction business category associations. In addition, create
appropriate tax rules against this transaction fiscal classification.
At transaction time, the tax determination process derives this transaction fiscal
classification whenever the related transaction business categories are used on
the transaction.
During transaction time, the taxation country is used to restrict the list of
document fiscal classification on the transaction line to those that have been set
up with the same country or where the country is blank. When setting up the
document fiscal classification, leave the Country field blank or use the same
country that is defined on any parent level of the record that is being added.
Scenario
When the export documentation is not received in time, the customer is invoiced
with the VAT that is applicable in the country of the supplier. The transaction
is not zero-rated, which is the normal case for Intra-EU business-to-business
supplies.
To model this scenario, create a document fiscal classification and attach it to
a transaction only when the documentation is received. If the document fiscal
classification is not attached to a transaction, the Intra-EU goods business-to-
business supply rules are not triggered and the applicable VAT is charged.
The tax rule that defines the conditions under which the Intra-EU supply of
business-to-business goods are zero-rated includes a determining factor as
shown in the following table:
Tip
Specify the country name while creating transaction business categories. This
ensures that a limited applicable list is presented while entering the document
fiscal classification during transaction or tax rule creation.
Tip
In this classification and many other tax classifications, classify the nonstandard
items of your business as standard items. This can be modeled as a default
tax rule and therefore, does not require an explicit classification or an explicit
rule. Classify only exception items and define specific tax rules for them. For a
standard item none of the explicit tax rules are applicable, only the default rate
applies.
User-defined fiscal classifications provide only one level. When defining the
user-defined fiscal classification codes, use the Country field to specify the
The user-defined fiscal classification tax determination factors allow you to use
user-defined fiscal classification in tax rules. A combination of determination
factor class and determining factor represent these determination factors.
Use the transaction input factor as the determining factor class and user-defined
fiscal classification as the determining factor.
The value entered against the condition set is the specific user-defined fiscal
classification code or name and the same country or where the country on the
user-defined fiscal classification is blank.
The user-defined fiscal classification is stored in the tax reporting ledger and is
available for reporting.
Scenario
To model this scenario, create a user-defined fiscal classification that is added
to a transaction line only when the customer is a foreign diplomat and VAT is
exempted.
Set up the following determining factor for the tax rule that defines the condition
where the sales transaction is zero percent (0%) rated using the special exempt
rate, tax status and tax rate rule:
This tax rule, to apply a zero tax rate to a transaction, is applicable only when the
user-defined fiscal classification is associated with the transaction line.
Tip
Specify the country name while creating the user-defined fiscal classification.
This ensures that a limited applicable list is presented while entering the user-
defined fiscal classification during transaction or tax rule creation.
Party classification defines the different types of party. Use party classifications
to define party types for tax determination and tax reporting purposes.
Use party classifications to classify your customers, suppliers, first party legal
entities, and first party legal reporting units for tax determination and tax
reporting.
Note
You can only amend the number of levels by increasing the number of levels. It is
not possible to decrease the number of levels once the record has been stored.
Once you have defined your Trading Community Model party classification and
associated it with a party fiscal classification and tax regime, you can use it to
classify your parties and party sites. These parties and party sites are:
• Customers
• Customer sites
• Suppliers
• Supplier sites
• Legal entities
In the case of supplier and customer parties and party sites, you can associate the
specific party classification codes used for tax purposes using either:
Legal party classifications are similar to party fiscal classifications. Both use the
Trading Community Model party classification setup and allows you to classify
Use legal party classifications to classify first party legal entities within the Legal
Entity setup functionality. Use these classifications as determining factors within
tax rules. Association between the legal party classification and specific legal
parties is done within the Legal Entity Maintenance flow.
No specific setup is required as the legal party classifications are predefined and
can be directly used in tax rule setup.
Party Fiscal Classifications: How They Work in Tax Rules and Tax
Reporting
Party fiscal classification tax determination factors allow you to use party fiscal
classifications in tax rules. A combination of determination factor class, class
qualifier, and determining factor represent these determination factors. In the
tax rules setup, define the actual party to be used to determine the relevant party
fiscal classification by using a generic definition for class qualifier. You can also
use party fiscal classifications for tax reporting.
• Bill-to party
• Ship-to party
• Ship-from party
• Point-of-acceptance party
• Point-of-origin party
Oracle Fusion Tax translates the generic parties into specific transaction parties
as defined in the following table:
Tip
Always use the highest applicable level to define the party classification. For
example, if appropriate, define the party fiscal classification at the customer or
supplier level instead of defining the same classification on all the party sites for
the customer and suppliers.
Tip
The following example illustrates using party fiscal classifications in tax rules. It
is based on the following scenario:
• The widgets are sold to the Belgium Troops stationed in UK under a joint
NATO exercise.
To do this:
At transaction time the tax determination process considers this tax status rule
and derives a zero tax status when the customer ship-to party is associated with
the level 1 party fiscal classification of GB Special Tax Parties Level 1 and code of
Zero Rated Parties.
Tip
Use the levels in the Trading Community Model party classification categories
model and the party fiscal classification setup to group party classification
categories together.
Party fiscal classifications also are defined using the Trading Community
Architecture application. They determine, for example, when taxes apply to a
party, how much tax applies, and what percentage of the tax is recoverable.
You can use legal classifications for fiscal classification purposes. In effect, a legal
classification just becomes another party fiscal classification for tax purposes.
Define Taxes
Tax Regimes
Set up tax regimes in each country and geographical region where you do
business and where a separate tax applies. A tax regime associates a common
• Applies as defaults the settings and values that you define for each tax in
the tax regime
• Defines for which taxes the configuration options apply and a specific
subscription option applies
• Provides a single registration for all taxes associated with the tax regime
The common tax regime setup is one tax regime per country per tax type,
with the tax requirements administered by a government tax authority for the
entire country. There are also cases where tax regimes are defined for standard
geographical types or subdivisions within a country, such as a state, province,
country, or city. In these cases, you base the tax regime on the Oracle Fusion
Trading Community Model standard geography.
There are more rare cases where a tax regime is based on disparate parts of a
country or more than one country. In these cases, you can create one or more
tax zones and set up tax regimes for these tax zones. You can also set up a tax
regime as a parent tax regime to group related tax regimes together for reporting
purposes.
You must set up a tax regime before you set up the taxes in the tax regime. Some
tax regime values appear as defaults on the taxes that belong to the tax regime in
order to help minimize tax setup.
You must associate a tax regime with all of the first party legal entities and
business units that are subject to the tax regulations of the tax regime. You can set
up tax configuration options when you create or edit a tax regime or when you
create or edit a first party legal entity tax profile. Both setup flows appear and
maintain the same party and tax regime configuration options.
Taxes
Set up details for the taxes of a tax regime. Each separate tax in a tax regimes
includes records for the tax statuses, tax rates, and tax rules that are used
to calculate and report on the tax. Oracle Fusion Tax applies as defaults tax
information from the tax regime to each tax that you create under a tax regime.
You can modify this information at the tax level according to your needs, as
well as add additional defaults and overrides. For tax rule defaults, specify
Identify what taxes you must define. Each tax appears as a single tax line on a
transaction. If you need to show or report more than one tax line per transaction
line on a transaction, then you should set up more than one tax. For example, for
US Sales and Use Tax you would define a tax for each state, county, and city.
You can create a new tax, or create a tax that is based on an existing tax within
the tax regime. You do this to minimize setup by sharing tax jurisdictions and tax
registrations. When you create a new tax based on an existing tax, the attributes
that remain constant for all taxes derived from the source tax are not available
for update. Attributes that are copied and are display only include:
• Tax regime
• Tax
• Geography information
Note
The enable tax settings are not selected, in the same way that they are not
selected when you access the Create Tax page.
You can enable a tax for simulation or for transactions only after you have
completed all of the required setup.
Tax Jurisdictions
Set up tax jurisdictions for geographic regions or tax zones where a specific tax
authority levies a tax. A tax jurisdiction specifies the association between a tax
and a geographic location. At transaction time, Oracle Fusion Tax derives the
jurisdiction or jurisdictions that apply to a transaction line based on the place
of supply. You must set up at least one tax jurisdiction for a tax before you can
make the tax available on transactions.
You also use tax jurisdictions to define jurisdiction-based tax rates. A tax
jurisdiction tax rate is a rate that is distinct to a specific geographic region or tax
zone for a specific tax. You can also create multiple jurisdictions at once using
the mass create functionality for taxes that relate to specific Trading Community
Model geographic hierarchies. For example, create a county jurisdiction for every
county in the parent geography type of State and in the parent geography name
of California.
The tax within a tax jurisdiction can have different rates for the parent and child
geographies. For example, a city sales tax rate can override a county rate for the
same tax. In this case, you can set up an override geography type for the city
and apply a precedence level to the city and county tax jurisdictions to indicate
which tax jurisdiction takes precedence.
In addition, in some cities a different city rate applies to the incorporated area
of the city, called the inner city. In these cases, you can set up an inner city tax
jurisdiction with its own tax rate for the applicable customers and receivables
tax. Inner city tax jurisdictions are often based on postal code groupings.
For example, one tax can have separate tax statuses for standard, zero,
exemptions, and reduced rates. A zero rate tax status may have multiple zero
rates associated with it, such as Intra-EU, zero-rated products, or zero-rated
exports.
You define a tax status under a tax and a configuration owner, and define all
applicable tax rates and their effective periods under the tax status. The tax
status controls the defaulting of values to its tax rates.
Tax Rates
Set up tax rates for your tax statuses and tax jurisdictions. For tax statuses, set
up a tax rate record for each applicable tax rate that a tax status identifies. For
tax jurisdictions, set up tax rate records to identify the tax rate variations for a
specific tax within different tax jurisdictions. For example, a city sales tax for a
state or province may contain separate city tax jurisdictions, each with a specific
tax rate for the same tax.
You can also define tax recovery rates to claim full or partial recovery of taxes
paid.
You can define tax jurisdiction and tax status rates as a percentage or as a value
per unit of measure. For example, a city may charge sales tax at a rate of 8
percent on most goods, but may levy a duty tax with a special rate of 0.55 USD
per US gallon on fuel. Values per unit of measure are in the tax currency defined
for the tax.
You define tax rate codes and rate detail information per rate period. Rate
periods account for changes in tax rates over time. A tax rate code can also
identify a corresponding General Ledger taxable journal entry.
If you set the Allow tax recovery option for a tax within a tax regime, then
you must set up at least one recovery rate for the tax in order to make the tax
available on transactions. If the recovery rate can vary based on one or more
factors, including the parties, locations, product or product purpose, then
set up tax rules to determine the appropriate recovery rate to use on specific
transactions. At transaction time, Oracle Fusion Tax uses the recovery rate
derived from the recovery tax rules, or uses instead the default recovery rate that
The first step includes the tax regime definition and subscription by an
appropriate legal entity or business unit. While creating your tax regime, you
can minimize configuration and maintenance costs by creating content that can
be shared by more than one entity. For example, legal entities can subscribe
to the shared reference data instead of creating separate and repetitive data.
If the subscribing legal entities have some variations in their setup, you can
create override data to meet the specific exceptions that are applicable to these
organizations.
Use Oracle Fusion Tax features to enable only those features that are relevant to
taxes in the tax regime. Based on the features you select, the subsequent setup
pages and task lists for the tax regime are rendered or hidden.
The second step includes basic tax definition, such as geographic information,
controls and defaults, direct and indirect tax rule defaults, and tax accounts.
The basic tax definition includes controls that you can set to provide the override
capability at transaction time. For example, if you want to allow users to make
manual updates on transaction tax lines, select the Allow override for calculated
tax lines and the Allow entry of manual tax lines options. However, if you want
to enforce automatic tax calculation on transaction tax lines, do not enable these
options.
Use the direct and indirect tax rule defaults to specify the values that apply to
the majority of your transactions. Create tax rules to address the exceptions or
variations to the defaults. For example, for the Goods and Services Tax (GST)
that applies to the supply of most goods and services in Canada, set the Tax
Applicability direct tax rule default to Applicable. A luxury tax, on the other
hand, is a tax on luxury goods or products not considered essential. As it would
not apply to most goods and services, set the Tax Applicability direct tax rule
default to Not Applicable, and create a tax rule to make the tax applicable when
the product in the transaction satisfies the luxury requirement.
Assign your default tax accounts for the taxes in a tax regime to post the tax
amounts derived from your transactions. The tax accounts you associate serve
as default accounting information for taxes, tax rates, tax jurisdictions, and tax
recovery rates. The tax accounts you define at the tax level, default to either the
tax rate accounts or tax jurisdiction accounts for the same tax and operating unit,
depending upon the tax accounts precedence level of the tax regime. You can
update these default tax accounts in the tax rate or tax jurisdiction setup.
The minimum tax configuration setup must be designed to handle the majority
of tax requirements. As part of defining transaction taxes, decide the direct and
indirect tax rule defaults for the tax and set up the associated tax accounts.
For complex tax requirements, create tax rules that consider each tax requirement
related to a transaction before making the final tax calculation. During the
execution of the tax determination process, Oracle Fusion Tax evaluates, in
order of priority, the tax rules that are defined against the foundation tax
configuration setup and the details on the transactions. If the first rule is
successfully evaluated, the result associated with the rule is used. If not, the next
rule is evaluated until either a successful evaluation or default value is found.
The direct tax rule defaults are the default values for the direct tax rule types,
which include:
• Place of supply
• Tax registration
Place of Supply
Use the Place of Supply direct tax rule default to indicate the specific tax
jurisdiction where the supply of goods or services is deemed to have taken place.
For example, in Canada, the place of supply for GST is typically the ship-to
location. To handle the majority of Goods and Services Tax (GST) transactions,
select Ship to as your default place of supply.
Note
The corresponding place of supply differs based on the type of transaction. For
example, a place of supply of Ship to corresponds to the location of your first
party legal entity for Payables transactions. For Receivables transactions, Ship to
corresponds to the location of your customer site. For exceptions to this default,
create Determine Place of Supply rules.
Tax Applicability
Use the Tax Applicability direct tax rule default to indicate whether the tax is
typically applicable or not applicable on transactions. For example, the GST
in Canada is a tax that applies to the supply of most property and services in
Canada. When you create the GST tax, select Applicable as your default tax
applicability. For exceptions to this default, create Determine Tax Applicability
rules.
Tax Registration
Use the Tax Registration direct tax rule default to determine the party whose
tax registration status is considered for an applicable tax on the transaction. For
example, with a direct default of bill-to party, Oracle Fusion Tax considers the
tax registration of the bill-to party and stamps their tax registration number onto
the transaction, along with the tax registration number of the first party legal
reporting unit. For exceptions to this default, create Determine Tax Registration
rules.
Tax Jurisdiction
Use the Tax Jurisdiction indirect tax rule default to indicate the most common
geographic area where a tax is levied by a specific tax authority. For example,
value-added tax (VAT) is applicable to the supply of most goods and services in
Portugal. For the tax PT VAT, create the default tax jurisdiction as the country
of Portugal. To address specific tax regions such as Azores and Madeira, which
have lower VAT rates than Portugal, define jurisdiction rates with different VAT
rates.
Tax Status
Use the Tax Status indirect tax rule default to indicate the taxable nature of the
majority of your transactions. For example, if your operations primarily include
zero-rated transactions, select the default tax status as Zero instead of Standard.
This setting facilitates tax determination when multiple zero rates are defined
to handle different reporting requirements for zero rate usage, such as intra-EU,
zero-rated products, or zero-rated exports. For exceptions to this default, create
Determine Tax Status rules.
Tax Recovery
Use the Tax Recovery rate indirect tax rule default to indicate the recovery rate
to apply to each recovery type for each applicable tax on a purchase transaction.
For example, in Canada, both federal and provincial components of Harmonized
Sales Tax (HST) are 100% recoverable on goods bought for resale. In this case,
with two recovery types, you can set up two recovery rate defaults for the HST
tax. For exceptions to this default, such as when the recovery rate determination
is based on one or more transaction factors, create Determine Recovery Rate
rules.
Tax Rate
Use the Tax Rate indirect tax rule default to specify the default tax rate that is
applicable to the majority of your transactions associated with this tax. You can
Set up tax accounts at the tax level. The application automatically copies the tax
account combination to the tax rates that you subsequently create for the tax for
the same ledger and optionally, the same business unit.
Define tax accounts at any of the following levels. The defaulting option is only
available at the tax level.
• Tax
• Tax jurisdiction
• Tax rate
Note
• Ledger and Business Unit: The ledger and business unit for which you
are creating the tax accounts.
• Interim Tax: An account that records tax recovery or liability until the
event prescribed by the statute is complete. Generally, the payment of
the invoice is the event that triggers the generation of the tax recovery or
liability. You must set up an interim tax account for taxes and tax rates
that have a deferred recovery settlement. Once you set up an interim tax
account for this tax rate, you cannot change the recovery settlement to
Immediate.
• Finance Charge Tax Liability: An account that records the tax liability
associated with finance charges that is used as a deduction against overall
tax liability.
Note
2. Select the regime level to define the geographic area of the tax treatment.
The option selected must depict the need for the tax regime. It should be
set to Country for all federal taxes.
3. Specify Canada as the country for which this tax regime is being defined.
4. Enter a start date that will appear as a default to all related tax setup
within the tax regime.
Note
Consider your tax planning carefully before entering the start date. This
date must accommodate the oldest transaction that you want to process
within this tax regime. After you create the tax regime, you can only
update this date with an earlier date. If you enter an end date, you cannot
update this date after you save the record.
5. Enter tax currency. Enter CAD, which is the three-letter ISO code for the
Canadian dollar.
Tax currency is the currency required by the tax authority. Use the tax
currency to pay the tax authority and to report on all tax transactions.
6. Select the Allow cross regime compounding option to set taxes within the
tax regime to be based on the calculation of, or compounded on, taxes in
another tax regime.
For example, in Quebec, the provincial sales tax is applied to both the
selling price and GST. Enter a value as the compounding precedence
to indicate the order of cross regime compounding. A lower number
indicates that the tax regime will be processed first. Allowing gaps
between numbers provide flexibility in the event that another higher
priority tax regime is introduced in the future.
7. On the Configuration Options tab, select the party name that identifies
either the legal entity or the business unit or both for which you will
define the configuration options.
8. For the Configuration of Taxes and Rules, select the subscription that
defines the configuration owner setup that will be used for transactions of
the specific legal entity and business unit for this tax regime.
This selection also defines whether any shared content can be overridden
by the subscribing party to allow unique, separate setup for certain tax
content.
9. Enter the effective start date for this configuration option. Enter a date
range that is within the date range of both the party tax profile and the tax
regime.
Enable Tax
1. Click the Enable tax for simulation option. This allows you to verify the
tax configuration using the Tax Simulator.
2. Once you have verified your tax configuration with simulated
transactions, click the Enable tax for transactions option. This allows you
to use this tax in transaction processing.
3. Click Save and Close.
For ABC's transactions in the province of Alberta, the following is
determined by default:
• GST tax is applicable and will be calculated at a percentage rate of 5%.
• 100% of the GST can be recovered.
Tax Accounts
Define tax accounts for a tax, tax rate, and tax jurisdiction. Tax accounts are:
• Tax Expense: A Payables tax account that records tax amounts from
invoice distributions; or a Receivables tax account that record net changes
generated by adjustments, earned and unearned discounts, and finance
charges. Receivables activities such as discounts and adjustments reduce
the receivable amount, and are therefore considered an expense. This
occurs only if the adjustment type has tax handling.
• Tax Recoverable or Liability: An account that records tax recovery
amounts or relieves tax liability amounts. If you set up recovery rates
for a tax that you also intend to self-assess, then define a tax recovery
account for the associated recovery rates and a tax liability account for the
associated tax rates.
Note
If you intend to use different accounts for tax recovery and liability then set up
the recovery account for the tax recovery rate. This account is used to debit the
recoverable tax amount while the account on the tax rate is used to account for
tax liability.
Set up details for the taxes of a tax regime. Each separate tax in a tax regime
includes records for the statuses, rate, and rules that are used to calculate and
report on the tax. Oracle Fusion Tax derives defaults tax information from the
tax regime to each tax that you create under a regime. You can modify this
information at the tax level according to your needs, as well as add additional
defaults and overrides.
• Standard
inclusive
handling:
This option
calculates
the taxes as
inclusive of
the given
transaction
line amount
• Special
inclusive
handling:
This option
calculates
the taxes as
inclusive of
the given
transaction
line amount,
but the
calculation
methodology
differs from
the standard
inclusive
process
Tax Settings and Rules: How They Apply to Tax Line Operations
Enter and update detail and summary tax lines according to the requirements
of your transactions. Depending on your security settings and options specified
during tax setup, you can:
• Enter manual tax lines
• Enter tax only tax lines
• Change existing tax line information
• Cancel tax lines
Note
The Summary Tax Lines component is applicable only to Oracle Fusion Payables.
Entering Manual Tax Lines
These requirements apply to entering a manual detail or summary tax line:
1. Enable the Allow entry of manual tax lines option for the:
• Configuration owner and application event class
Note
On canceling the invoice or invoice lines, tax lines are automatically canceled.
When you cancel a tax line both the associated tax line and any distributions that
were previously accounted are reversed. If the distributions were not accounted,
then the amounts are set to zero.
Note
When you select or deselect the Cancel option on a tax line for the first time, the
update does not take effect. You must select the specific tax line, click the row
header or a noneditable area, and then select the Cancel option.
Note
Criteria for rounding the calculated tax amounts comes from various parties
involved in a transaction. For example, for a purchase transaction, the rounding
methodology is generally specified by the supplier. Specify rounding details
in your tax setup to ensure that your entered invoice amount, including the
calculated tax, is the same as the actual invoice amount. For a Receivables
invoice, you can specify rounding details based on your organization's policy,
but for most countries the rounding criterion is directed by tax legislation.
Rounding requirements can originate from:
• Third parties
• First parties
• Tax legislation
• If the rounding level is at the line level in the party tax profile, create
registration details for each tax and specify the rounding rule. Also, define
tax registration rules for each tax so that the tax determination process
uses the first party registration.
• If a registration record is not defined for the tax registration party, select
the Allow tax rounding override option on the Create or Edit Tax page.
The application then looks at the party tax profile details for deriving the
rounding rule.
The rounding criteria applied if configuration owner tax options are not defined
and the criteria in the predefined event class options are considered include:
• For a purchase transaction, the predefined event class options use the
ship-from party site and ship-from party within the rounding precedence
with the default rounding level as the header level. The supplier's
rounding preferences are considered first on the transaction. If there are
no specific supplier preferences, for example, the party tax profile record
does not exist, then the default rounding level of Header is considered
and the corresponding rounding rule from each tax setup detail is used.
• For a sale transaction, the predefined event class options do not include
any rounding precedence details. However, the default rounding
level is set to Line so the rounding level is always taken as Line and
the corresponding registration record for the tax registration party is
considered for the rounding rule. The tax registration party is identified
through the Determine Tax Registration tax rule or tax rule defaults.
If a registration record does not exist for the tax registration party, the
rounding rule defined within each tax is considered.
• If the configuration owner tax options are defined for the combination
of business unit and legal entity for which the transaction is registered
and for the event class, the default rounding level is used from the
configuration owner tax options. Select Blank as the rounding precedence
for the event class.
• If the rounding level is at the line level for the configuration tax options,
ensure that the registration record defined for the tax registration party
has the rounding rule based on the tax requirements. The tax registration
party is identified through the Determine Tax Registration tax rule or tax
rule defaults.
During the rounding process, the tax precision and minimum accountable
unit details are derived from the tax setup. The rounding process derives the
• City
tax:
7.5%
Example 2 represents the rounding details applied at the line level. Applying
these factors, the rounding process calculates the invoice amounts, all in USD
currency, as follows:
Document Amount Tax and Tax Tax Amount Step 1: Step 2: Line Tax Amount
Level Rate Not Rounding amounts Rounded
Rounded criteria is are added
applied at to obtain
the line level revised
header
amounts
Header 5579 • State • 395.8082 • 395.82 • 395.82
tax
• 418.425 • 418.44 • 418.44
• City tax
Line 1 1333 • State • 166.625 • 166.63 • 166.63
tax:
12.5% • 99.975 • 99.98 • 99.98
• City
tax:
7.5%
Line 2 1679 • State • 55.9107 • 55.92 • 55.92
tax
• 125.925 • 125.93 • 125.93
• City
tax:
7.5%
Line 3 2567 • State • 173.2725 • 173.27 • 173.27
tax
• 192.525 • 192.53 • 192.53
• City
tax:
7.5%
Taxes for purchase transactions are usually calculated by the supplier and
included in the invoice. The responsibility of collecting and remitting these taxes
to the authority lies with the supplier. However, in certain cases the supplier
does not have presence (nexus) or is not registered in the customer location.
Self-Assessment
Taxes need to be self-assessed by the purchasing organization when the supplier
is not registered in the ship-to or bill-to location of the transaction. This is the
recommended approach for defining and calculating self-assessed taxes. This is
driven based on the registration party used for the transaction.
Registration Party
In the context of a tax applicable to the transaction it is the party whose
registration needs to be considered. The tax registration party type default is
specified for the tax. As most of the taxes are assessed by the supplier, the default
is set to the ship-from or the bill-from location.
Supplier Tax Registration
You can define tax registration for the supplier, the supplier site, and for a
particular tax regime. If the tax registration varies by tax or tax jurisdiction,
define the registration at a granular level. If the supplier does not have presence
in a specific jurisdiction, there are two options for configuration. The first is to
create a tax registration record with the registration status as not registered. The
second option is not to define a registration record. If you follow the second
option, when you define the condition set, set the operator for the Registration
determining factor class to Is blank.
Registration Party of the First Party
Similar to the supplier registration, you can define the tax registration records for
a legal reporting unit tax profile. For the tax registration of the first party select
the Set as self-assessment (reverse charge) option. This option triggers self-
assessment of taxes when the registration party selected for the tax line is that of
the first party. Self-assessment is only applicable for Payables transactions. The
option on the first party registration does not impact Receivables transactions.
If the registration records are not created for the suppliers without registration,
create the condition set as follows:
Offset Taxes
Offset taxes is a backward compatible approach that is configured to self-assess
taxes. Configure offset taxes in addition to your regular taxes. Offset taxes carry
a negative rate and are calculated in the context of the regular tax. Where offset
taxes are applicable, the application creates two tax lines with one positive and
one negative amount. An offset tax record is a matching, duplicate record with
negative amounts that reduces or completely offsets the tax liability recorded in
the tax transaction. Use offset taxes when the tax requirement includes creating
an offset general ledger posting.
Reporting-Only Taxes
You can identify taxes for reporting purposes only. When these taxes are
applicable to the transactions, records are created in the tax repository entities.
However, invoice distributions are not created for these taxes. Therefore, there is
no impact to the payable amount, payment amount, and invoice accounting.
Use Taxes
Assigning use taxes to invoices, you create a record of the taxes you owe to tax
authorities. Oracle Fusion Payables does not create invoice distributions for these
taxes. Therefore, there is not any accounting impact due to these taxes. Payables
provides a Use Tax Liability Report to review and report use taxes.
Use the Use Tax Liability Report to review, report, and remit use taxes. The
report determines the use tax liability by each use tax code by taking the tax rate
you defined for each tax code and applying it to the sum of each invoice line
to which the tax applies. The report lists in summary or detail the total amount
of tax you owe for each tax code on invoices you enter between two dates you
specify when you submit the report. Oracle Fusion Payables displays the amount
of use tax you owe in the currency in which you entered an invoice.
Note
Use taxes are defined with the tax type of Use tax. The rest of the configuration
is the same as the other taxes. This feature is only supported for migrated taxes.
You cannot define a new tax with this tax type.
Offset taxes are a backward compatible approach that you can configure to
self-assess taxes. Configure offset taxes in addition to the regular taxes. Offset
taxes carry a negative rate and are calculated in the context of the regular tax.
Where offset taxes are applicable, two tax lines are created with one positive and
one negative amount. An offset tax record is a matching, duplicate record with
negative amounts that reduces or completely offsets the tax liability recorded in
the tax transaction. Use offset taxes when the tax requirement includes creating
an offset general ledger posting.
• Set up the offset tax, tax status, and tax rate. Define at least one recovery
type lookup to use with offset taxes.
• Set up the tax status for the offset tax. Do not select the Allow tax rate
override option.
• Set up a 100% tax recovery rate for the offset tax using the recovery type
that is defined for the offset tax.
You cannot update the recovery rate on an offset tax line. The recovery
rate is always 100% in order to create credit entries that match the original
tax amounts. When you create an offset tax, you enter a primary recovery
type with a recoverable rate of 100% and a 100% recovery rate.
• Set up the original tax with the required configuration to enable the tax.
For the tax rate of the original tax (nonoffset tax), assign the offset tax rate
code in the Offset Rate Code field.
• Select the Allow offset taxes option on the party tax profile if offset taxes
are to be calculated for the transactions created for the party. Select this
option for the party type chosen in the Offset Tax Basis field for the
configuration owner tax options.
The amount for the regular tax line is always debited to the tax expense or
recovery account or both, depending on the recoverability of the tax. The credit
is posted to a payables account which is offset by the negative amount credited
to the payables account due to the offset tax line. The debit of the offset tax line
is posted to the tax liability account and this indicates the liability that the first
party organization has towards the tax authority for the self-assessed tax.
You can identify taxes for reporting purposes only. When these taxes are
applicable to the transactions, records are created in the tax repository entities.
However, invoice distributions are not created for these taxes. Therefore, this
does not impact the payable amount, payment amount, and invoice accounting.
For Oracle Fusion Payables invoices, these lines are not displayed on the invoice
lines. The total of the reporting-only taxes are displayed in the tax totals region
of the invoice.
You can enable a tax for simulation or for transactions only after you have
completed all of the minimum setup.
Minimum setup for a country-level standard tax with no recovery and always
applicable includes:
• Entering the required fields in the Create Tax or Edit Tax pages.
• Entering direct tax rule defaults for Place of Supply, Tax Registration,
Tax Calculation Formula, and Taxable Basis Formula. Also, setting Tax
Applicability to Applicable.
• Entering indirect tax rule defaults for Tax Jurisdiction, Tax Status, and Tax
Rate.
• Entering tax accounts for Tax Expense and Tax Recoverable or Liability
Account. Accounts you specify at the tax level appear as defaults at the
tax rate and tax recovery rate level.
If you have tax recovery, minimum setup also includes:
• Defining a tax recovery rate.
• Entering an indirect tax rule default for Tax Recovery Rate.
If the direct tax rule default for Tax Applicability is set to Not Applicable, you
must define a determining factor set, condition set, and tax applicability rule.
The relationship between the determining factor and condition sets and
the party, product, process, and place is shown in the following table. The
relationship value is a concept to group tax drivers and not an element in the
tax rule definition. The determining factor, determining factor class, tax class
qualifier, determining factor name, condition set operator, and condition set
value are all components of tax rule setup.
• Bill
from
• Bill to
• Point of
acceptance
• Point of
origin
• Ship
from
• Ship to
The available
values do
not include
the tax class
qualifier
value.
• Point of
origin
party
• Ship-
from
party
• Ship-to
party
Product Product Product Name of • Equal Fiscal
Inventory inventory a specific to classification
Linked linked level of a codes of the
product fiscal • Not applicable
classification equal product fiscal
to classification
type
• Is
blank
• Is not
blank
• Ship-
from
party
• Ship-to
party
Process Transaction Transaction Transaction • Equal Specific
Fiscal fiscal fiscal to transaction
Classification classification classification fiscal
type • Not classification
equal code
to
• Is
blank
• Is not
blank
• Is
blank
• Is not
blank
Product Line Class Transaction Line Class • Equal Transaction
input factor to event classes
and activities
• Not
equal Code list
to of line
transaction
• Is types such as:
blank
• Procure-
• Is not to-pay
blank
• Credit
memo
order-
to-cash
• Miscellaneous
cash
• Is
blank
• Is not
blank
Process Tax Transaction Tax • Equal Tax
Classification input factor Classification to classification
Code Code codes
• Not
equal
to
• Is
blank
• Is not
blank
Process User-Defined Transaction User-Defined • Equal User-
Fiscal input factor Fiscal to defined fiscal
Classification Classification classification
• Not codes
equal
to
• Is
blank
• Is not
blank
Place User-Defined User-defined Location type Tax zone • Equal Tax zones
Geography geography which can types to of the tax
be one of the zone type
following: • Equal belonging to
to the location
• Bill determining
identified
from factor by the class
qualifier
• Bill to • Not
equal
• Point of to
acceptance
• Not
• Point of equal
origin to
determining
• Ship factor
from
• Is
• Ship to blank
• Is not
blank
• Process: Information on the type of tax services that are being requested
such as purchase invoice and debit memo.
How Tax Is Determined Using Party, Product, Place, and Process Transaction
Attributes
The following table describes how the party, product, place, and process
transaction attributes contribute to the outcome of the tax determination process:
Scenario
There is a tax requirement for a state tax, Intrastate A, to apply to any intrastate
transactions for a specific product category of items. When defining this tax the
typical transaction scenario is that this tax is not applicable. So when defining
this tax the tax applicability default value is Not Applicable. Create a tax rule
for the exception scenario when this particular product is sold in an intrastate
transaction.
Create the determining factor set as follows:
Define the set with the result of Applicable. If the conditions defined match
the respective transaction values the tax rule evaluates to true and the tax is
considered applicable. When the conditions are not met and if there are no other
condition sets or tax rules to evaluate the determination process looks to the
default value of Not Applicable as the result and the tax is not calculated.
Scenario
Determining factors represent the and part of the evaluation process. The
determination process evaluates every element of the determining factor class
unless it is set to ignore in the condition set definition. This feature allows for
reusability of determining factor sets with some flexibility not requiring the use
of all determining factors in each tax rule definition. The condition set is the or
condition of a tax rule when there are multiple condition sets defined.
For example, a tax law may indicate that a specific state tax is applicable
to certain products or specific services from specific vendor types that are
considered to have environmental impacts. Analysis determines there are two
separate supplier party classifications and one product category defined that
meet the requirement for applicability.
Create the determining factor set as follows:
The tax determination process evaluates all of the determining factors in the
determining factor set: party fiscal classification and product noninventory
linked. However, using multiple condition sets offer an or evaluation to the tax
rule. The tax determination process evaluates either of the following:
• Party fiscal classification type code is equal to category A and product
category is equal to product A
• Party fiscal classification type code is equal to category B and product
category is equal to product A
You define a result for each condition set that is applied if the condition
evaluates to true. Condition sets are numerically ordered to specify the sequence
in which they would need to be evaluated during rule processing. Optionally,
you can disable them for processing depending on a change in tax law.
Important
It is important to carefully evaluate condition set order as a change in order can
impact the result of a tax rule.
Also, numerically order tax rules defined for a rule type to specify the sequence
in which they are to be evaluated during the rule processing. The rule order,
along with the specific applicability criteria like event class, defines the rule
evaluation sequence for a rule type.
FAQs for Manage Tax Determining Factor Sets and Tax Condition Sets
The tax determination process evaluates, in order of priority, the tax rules that
are defined and the details on the transaction. If the first rule is successfully
evaluated, the result associated with the rule is used. If not, the next rule is
evaluated until either a successful evaluation or default value is found.
The tax determination process is organized into rule types. Each rule type
identifies a particular step in the determination and calculation of taxes
on transactions. The rule type and related process used for tax recovery
determination is Determine Recovery Rate. This is an optional setup that is
applicable to taxes that have tax recovery enabled.
This process determines the recovery rate to apply to each recovery type for each
applicable tax on the transaction that allows for full, partial, or no recovery of
the tax amount. In many cases, the tax determination process uses either the
recovery rate associated with the tax rate or the default recovery rate defined for
the tax. However, if the tax recovery rate varies according to determining factors,
such as intended use, then create a Determine Recovery Rate tax rule to derive
the recovery rate.
You can only set up a Determine Recovery Rate tax rule for taxes that have the
tax recovery option enabled. For countries with more than one type of recovery,
use primary and secondary recovery types to address this requirement. After the
recovery rate is determined for each recovery type, the tax determination process
determines the recoverable amounts against each recovery type for each tax line.
The remaining tax amount becomes the nonrecoverable tax amount for the tax
line.
The following outlines the process that results in a recoverable tax amount for
each recoverable tax distribution:
1. Allocate tax amount per item distributions. While taxes are determined at
the transaction line level, tax recovery is determined at the transaction line
distribution, or item distribution, level.
2. Determine recovery types. The tax determination process determines
for each tax and item distribution, whether the primary and, if defined,
secondary recovery types apply. The result of this process is a tax
distribution for each recovery type for each tax and item distribution. If
recovery types are not defined, go to step 5.
3. Determine recovery rates. For each tax distribution, the tax determination
process determines the recovery rate based on the following:
a. Consider the Determine Recovery Rate tax rule for the first recoverable
tax distribution.
b. Use the tax recovery rate derived from the tax rule.
c. If the tax determination process cannot derive a tax rule based on the
transaction values, use the tax recovery rate associated with the tax rate
for the tax line.
Use recovery rate rules to determine the applicable recovery rates when this
determination is based on one or more transaction factors, including the parties,
locations, product or product purpose.
At transaction time, the tax determination process uses the recovery rate derived
from the recovery tax rules. If no recovery rate rules are defined or if no existing
recovery rate rule applies to the transaction, the tax determination process uses
the default recovery rate that you define.
Commonly used factors that are used in tax recovery rules include:
• Intended use, such as resale or manufacturing
• Party fiscal classification, such as reseller or charitable organization
• Location, such as British Columbia or New Brunswick
Use the Tax Distributions window to review and update the tax recovery rate
on tax distributions. Oracle Fusion Tax creates recoverable distributions and
calculates tax recovery rates when you save the line distribution, according to the
Determine Recovery Rate tax rule process or the default recovery rate.
You can update the recovery rate code if the Allow tax recovery rate override
option is enabled for the tax.
You can update the recovery rate if the Allow ad hoc tax rate option is enabled
for the recovery rate. The update method differs according to the transaction
application:
• Oracle Fusion Purchasing: You can either enter a new recovery rate or
select another recovery rate that you previously defined from the list of
values.
• Oracle Fusion Payables: You can only select another rate that you
previously defined. If you update the recovery rate on a tax distribution,
Oracle Fusion Tax also updates the related nonrecoverable rate and
amount, and the distribution for the tax line.
If there are tax rules defined based on the Accounting determining factor class,
then changing or creating a distribution may affect tax calculation.
Tax authorities allow tax recovery at different stages of a transaction life cycle.
You can specify the settlement options to indicate when tax recovery is possible:
If the recovery settlement is Deferred, you must set up an interim tax account for
this tax to record the tax recoveries or liabilities that accrue prior to the payment.
Though this is an interim account the balance in this account represents a
contingent asset. As such, management and other reporting requirements need
to be duly considered while setting up or changing this account.
The following table describes the defaults and controls available at the tax
recovery rate level.
Recovery Rate Periods Region
One recoverable distribution for the primary recovery type and, if applicable,
the secondary recovery type is created, for each tax line for each of the item
distributions into which the item line or expense line is distributed. The tax
distributions are displayed in this way:
• If the tax is recoverable, two or three distribution lines are displayed, one
for the primary recoverable amount, one for the secondary recoverable
amount, if applicable, and another for the nonrecoverable amount.
If the tax is recoverable and the recovery rate is zero, then the
nonrecoverable distribution amount is equal to the tax amount and the
recoverable distribution amount is equal to zero.
• If the tax applied on the transaction is of the offset type, then the
application creates two distributions for the recovery and nonrecovery
Note
The authorized user can update the tax recovery rate on the distribution in
Oracle Fusion Payables. The component in Oracle Fusion Purchasing is view-
only.
Scenario
Your company is located in a Canadian province that has combined the
provincial sales tax with the federal goods and services tax (GST) into a
harmonized sales tax (HST). They recently purchased books to sell in their stores.
They also purchased some computers to use in kiosks within the stores for
customers to use to locate books.
Transaction Details
The transaction details are as follows:
• Total cost of books is 10,000 CAD
The invoice indicates the intended use as Resale.
• Total cost of computers is 5,000 CAD
The computers will be expensed as they do not meet the capitalization
threshold.
Analysis
In most tax regimes, a tax that is paid by a registered establishment can claim
back 100% of taxes due from the tax authority, except for specific designated
purchases. Depending upon the details of a company's business purchases and
tax authority regulations, a number of exception regulations may accompany the
details of tax recovery. Tax implications are:
• The HST associated with the cost of books to be sold in stores is 100%
recoverable. Therefore, 1,300 CAD is recoverable (10,000 CAD * 13%).
• The HST associated with the cost of the computers to be used in kiosks
within the stores is not recoverable. Therefore, 650 CAD is nonrecoverable
(5,000 CAD * 13%).
The HST tax configuration specifies that the recovery tax rate for zero 0%
recoverable is used as a default. A tax rule is defined to apply a 100% recoverable
rate for products with an intended use of Resale.
Based on the analysis, the following distributions are created for the transaction:
The following table describes the defaults and controls available at the tax status
level.
Header Region
Tax Statuses
A tax status is the taxable nature of a product in the context of a transaction and
a specific tax on the transaction. You define a tax status to group one or more tax
rates that are of the same or similar nature. Each tax must have at least one status
defined and one status assigned as a default. Create tax rules to set alternate
values as required.
For example, one tax can have separate tax statuses for standard and manually
entered tax rates.
Tax Jurisdictions
A tax jurisdiction is an incidence of a tax on a specific geographical area. A tax
jurisdiction is limited by a geographical boundary that encloses a contiguous
Tax Rates
You must set up at least one tax rate for each tax status. You may need to set up
additional tax rates at the tax jurisdiction level if the tax rate applicable for the
tax is unique for a particular tax jurisdiction.
For example, in Canada, HST is applied at a 13% rate in most provinces that
have adopted HST except for British Columbia where the tax rate is 12% and
Nova Scotia where the tax rate is 15%. To satisfy this requirement define a single
tax rate of 13% with no tax jurisdiction associated and define 12% and 15% tax
rates and associate them with the British Columbia and Nova Scotia jurisdictions
respectively. This minimizes setup by creating an exception-based setup and a
default option for the most commonly utilized tax rate percentage.
Tax Rate Types
You can express tax rates in terms of percentage or quantity. A quantity-based
tax rate is based upon the number of items purchased or events that occur. For
example, a taxing jurisdiction passes a law that each package of cigarettes sold
is subject to a tax of 0.87 USD. This tax is considered a quantity-based tax as it
is assessed based upon the number of packages purchased not the price of the
product.
Tax Classification Code Set Assignments
When defining a tax rate select the tax classification code set assignments of
Order to cash, Procure to pay, and Expenses. These assignments determine
if the tax rate code you define is applicable within a specific product and
set assignment at transaction time. In addition the set assignment of tax
classification codes is derived based on the configuration owner that is part of
the tax rate code definition.
When you create a tax rate code where the:
• Configuration owner is the global configuration owner: The tax
classification code is assigned to all sets that have the determinant type
of business unit and contain the determinant value of the business units
that have the subscription of the legal entity. The tax classification code is
also assigned to the business units that do not have the subscription of the
legal entity but subscribe to the global configuration owner data for this
tax regime.
• Configuration owner is the legal entity: The tax classification code is
assigned to all sets that have the determinant type of business unit
and contain the determinant value of the business units that use the
subscription of legal entity. The tax classification code is also assigned to
business units that subscribe to this specific legal entity as party first party
organization.
Note
The application does not assign the tax classification codes to the global set of
COMMON for any of these scenarios.
You can use the tax classification codes created as determining factors when
defining tax rules. When you use the regime determination method of standard
tax classification code, the tax classification based direct rate rules can be defined
with these codes as factors for direct rate determination. Maintain the tax
classification codes using the associated lookup types of Party Tax Profile Input
Tax Classification, Party Tax Profile Output Tax Classification, and Party Tax
Profile Web Expense Tax Classifications.
Rate Periods
You can define one or more rate periods for a tax rate as long as the date ranges
do not overlap. This allows for a change in tax rates over time without requiring
a new tax rate code definition. You can define default effective periods for tax
rate periods. This effectivity must be unique across tax regime, configuration
owner, tax, and tax status. This allows flexibility if there is a requirement to
define a new tax rate code and identify the new rate period as a default when
existing rate periods exist on another tax rate code. Define tax rules as exceptions
to default tax rates.
Tax Recovery
When the associated tax allows tax recovery you can define tax recovery or offset
tax rates. Associate the offset tax or the default tax recovery rate and tax rule
defined for tax recovery to the tax rate code. If the tax rule does not evaluate to
true at transaction time then the default tax recovery rate is applicable. Ensure
that the tax recovery rate and tax rate periods overlap or the application does not
calculate tax recovery.
Tax Accounts
Define tax accounting for the tax rate code either as a default from the tax setup
or an override of values at the tax rate level. Tax accounts are defined for the
legal entity and optionally for the business unit. The accounts you define are
tax expense accounts, tax revenue accounts, tax finance charge accounts, and
accounts specific to tax recovery.
You can define tax rates as a percentage or as a value per unit of measure. The
UOM field is optional in the tax setup. However, if you do enter the UOM there
is validation that must be passed in order for the tax rate to be applied. This
includes:
• If the UOM exists on the tax rate, the transaction must have a matching
UOM or a blank UOM.
• Only one active tax rate can exist for any given tax rate period. You cannot
create one tax rate for each UOM that might be used within a single tax
rate code.
You can define the quantity rate type for a tax rate code with the UOM field left
as blank. At transaction time, the application multiplies the quantity by the tax
rate and the UOM is not taken into account.
Part of the configuration options is to allow you to override the calculated tax
rate on a tax line. The following controls should be considered during setup:
• Allow override of calculated tax lines: This option exists on the Create
Configuration Owner Tax Options page for the configuration owner and
event class. In order for you to manually override tax lines this option
must selected for the combination of configuration owner and event
class. If a configuration owner tax option does not exist the value on the
predefined event class setting is used.
• Allow override of calculated tax lines: You must select this option on the
associated tax record to be able to override values on a calculated tax line.
• Allow tax rate override: You must select this option on the associated tax
status record to be able to override tax rates on a calculated tax line.
• Allow ad hoc tax rate: You must select this option on the tax rate record if
you want to allow the flexibility of not being restricted to predefined tax
rates and allow user entered rates on calculated tax lines.
If you allow ad hoc tax rates you must indicate if the adjustment to a tax
amount updates the taxable basis or the tax rate.
Note
You can set the Transaction Tax Line Override profile option to control which
users can make changes to the transaction line such as selecting a different tax
status or tax rate.
• Quantity:
The tax rate is
based on the
currency per
UOM such as
USD per kilo
Tax Classification Controls where tax None None If selected then the
Code Set classification codes tax classification
Assignments that are created code associated
in parallel to the with this tax rate
• Order to cash creation of the tax is available for
rate are available use in order to
• Procure to for use cash, procure to
pay pay, and expenses
transactions
• Expenses
• Standard
inclusive
handling:
This option
calculates
the taxes as
inclusive of
the given
transaction
line amount
• Special
inclusive
handling:
This option
calculates
the taxes as
inclusive of
the given
transaction
line amount,
but the
calculation
methodology
differs from
the standard
inclusive
process
Note
Tax exemptions are specific to the order-to-cash event class while tax exceptions
are applicable across event classes.
Tip
Always try to minimize tax rules and setup for tax regimes and taxes. Tax rules
are specific to a tax regime and tax, thus by minimizing the number of tax
regimes and taxes, the number and complexity of the tax rules can be minimized.
Tip
Move any complexity from the beginning to the end of the rule types and
supporting setup. For example, it is better to use tax recovery rate rules in
preference to setting up specific tax rates with individual defaults associated
with tax recovery rates.
Tax reporting requirements adds some level of complexity to the pure tax setup
needed to support the tax determination and calculation processes, make every
effort to minimize this additional level of complexity. Write tax reports wherever
possible to use tax reporting codes or use the determination factors that identify
your reporting requirements. These reporting determination factors should
replace the need to create specific taxes, tax statuses, and tax rates purely defined
to allow tax reporting.
For extreme cases you may need to create a more complex tax setup to meet your
tax reporting needs. For example, currently there are no determining factors
that can easily identify asset purchases. In many countries it is a requirement to
report the tax associated with asset purchases separately. In this case, create tax
status and tax rate rules based on asset account segments to uniquely allocate
a specific tax status and tax rate to these asset purchases. These asset purchases
can then be reported by searching for the specific tax status and tax rate or
specific tax reporting codes associated with the specific tax status or tax rate.
Tip
If tax applicability is not impacted by a tax law but the tax rate is you can set
up a tax status rule to point to a different tax status and utilize a default tax rate
• Identify tax
regimes.
• Identify taxes
using subscriber
configuration
option.
2 Determine Place • Identify location • Tax rule:
of Supply and Tax type. Determine Place
Jurisdiction of Supply, or the
• Identify tax default value for
jurisdiction. Place of Supply for
the tax.
• Tax jurisdictions
3 Determine Tax • Consider candidate Tax rule: Determine
Applicability taxes from the Tax Applicability and
previous process. the default value for
applicability for the tax.
• Eliminate taxes
based on tax
applicability rule
for each tax.
4 Determine Tax Determine the party • Tax rule:
Registration type to use to derive the Determine Tax
tax registration for each Registration, or the
applicable tax. default value for
the tax.
• Tax registration
5 Determine Tax Status • Consider tax Tax rule: Determine Tax
statuses of Status, or the default
applicable taxes. value defined for the tax.
• If a tax exception
applies, update the
tax rate for each
applicable tax.
• If a tax exemption
applies, update the
tax rate.
7 Determine Taxable Basis • Identify the taxable • Tax rule:
basis formula for Determine Taxable
each applicable tax. Basis, or the
default value for
• Determine the the tax.
taxable basis and
compounding • Taxable basis
details based on formula
the taxable basis
formula. • Tax inclusive
settings at the tax
• Consider the tax rate level
inclusive settings
of the applicable
taxes.
8 Calculate Taxes • Identify the • Tax rule: Calculate
tax calculation Tax Amounts
formula.
• Calculate tax
• Calculate taxes formula, if
using the tax applicable
calculation
formula. • Tax rounding
rule from tax
• Perform applicable registration, party
tax rounding. tax profile, or tax
• Configuration
owner tax options
• Determine the
tax recoverable
amounts.
• Determine the
nonrecoverable
amount.
Event Qualifiers
The event qualifier is of two types: normal event and tax event.
Normal events comprise of the following events:
The event class qualifiers have a direct affect on the evaluation order of tax rules.
The following list summarizes the affect:
1. When a normal event-based qualifier is used then it is used in preference
to tax rules qualified by tax event qualifiers or other nonevent-based
qualified tax rules regardless of the rule priority.
2. When multiple normal event-based qualified tax rules are applicable, the
application uses rule priority to define the rule processing order.
The following table considers five tax rules, namely, A, B, C, D, and E with or
without event qualifiers and rule order and the resulting evaluation sequence:
Rule B is evaluated first because it is the highest priority rule with a normal
event rule qualifier. Rule A is identified as second in evaluation sequence it
is the only other tax rule with a normal event rule qualifier. Rule D is third
in evaluation sequence as it is the highest priority rule with a tax event rule
qualifier followed by rule E as the only other tax rule with a tax event rule
qualifier. Finally, the application evaluates rule C as it does not have any event
rule qualifiers.
The use of normal event or tax event rule qualifiers alters the way in which the
tax determination process processes the tax rules. For an event class qualified tax
rule, normal event or tax event-based, the tax rule is evaluated first in preference
to tax rules qualified by tax event qualifiers or a nonevent class qualified tax rule
of higher priority.
Consider that you have two rules: rule A and rule C with rule priority 100 and
10 respectively. The rules are associated with condition sets that match against
the transaction line details. Rule A has a normal event class qualifier which is
satisfied while rule C does not have an event class qualifier, rule A is processed
and used first regardless of the rule priority order, even though rule A has a
lower priority than rule C.
Tax rules qualified by tax event qualifiers are processed after normal event
qualified tax rules but before tax rules with no event or tax event qualifiers.
When there are two or more rules with normal event class qualifiers that match
the transaction line details, the application uses rule priority to determine the
order in which the tax rules are processed.
Note
Geography qualifiers do not function in this way. When a tax rule has a
geography qualifier and no event class qualifier, the tax determination process
Geography Qualifiers
Enable the Set as geography specific rule option to use the geography qualifier.
Once you enable this option you can enter either a normal geography or a tax
zone geography.
When you use a normal geography, select the parent geography type and parent
geography to help restrict the list of geography type and subsequently, the
geography name fields. For example, when you want to select counties for a
specific state such as California, define the:
• Parent geography type as State
• Parent geography name as CA (California)
• Geography type as County
This limits the list of values for the geography name field to the counties that are
in the state of California instead of listing all of the counties.
Tip
When selecting the normal geography qualifiers, use the parent geography to
ensure that the correct geography element is selected, as there are many multiple
geography elements with the same name across the world. For example,
Richmond is a city in Canada's provinces of British Columbia, Ontario, and
Quebec. Richmond is also a city in the state of Virginia in the United States.
Rule Order Normal Event Geography- Condition Set Condition Set Result
Class Specific Rule Order
10 Blank Blank • CS-1 • 10 • VAT10%
• CS-2 • 20 • VAT12%
• CS-3 • 30 • VAT15%
20 Purchase • Location CS-4 10 VAT12.5%
invoice type: Bill
from
• Geography
name:
California
30 Purchase Blank CS-5 10 VAT13%
invoice
Scenario 1
If a Payables invoice is involved and Texas is the bill-from party state, the tax
rule processing sequence is as follows:
1. The tax rules are listed according to the sequencing logic. For example, the
tax determination process evaluates tax rules involving normal event class
qualifiers first regardless of having a lower rule order.
• Geography • Tax
name: rule:
California Fail,
because
the
bill-
from
party
state
is
Texas
30 Purchase Blank CS-5 10 VAT13% • Condition
Condition
invoice set: set result
Evaluated
considered
and and exit
passed rule
evaluation
• Tax
rule:
Passed,
because
the
condition
set
values
match
with
the
transaction
details
10 Blank Blank • CS-1 • 10 • VAT10%
• CS-2 • 20 • VAT12%
• CS-3 • 30 • VAT15%
Scenario 2
If a Receivables invoice is involved, the tax rule processing sequence is as
follows:
1. The tax rules are listed according to the sequencing logic. For example, the
tax determination process evaluates tax rules involving normal event class
qualifiers first regardless of having a lower rule order.
2. The tax determination process further evaluates condition sets listed
within each tax rule.
• Geography • Tax
name: rule:
California Fail,
because
the
event
class
criteria
does
not
match
30 Purchase Blank CS-5 10 VAT13% • Condition
Move to
invoice set: next tax
Not rule
evaluated
• Tax
rule:
Fail,
Passed,
because
the
event
class
criteria
does
not
match
For CS-2:
• Condition
set:
Pass
• Tax
rule:
Pass,
because
the
condition
set
values
match
with
transaction
details
Use these guidelines and examples to help plan your tax rules implementation:
• If the tax condition results and rule results always equal the default
values, then you do not need a tax rule. You only need to define a tax rule
for a result that is different from the default value. For example, if more
than one tax rate is possible for a given tax and tax status, then you need
to create at least one tax rule.
These qualifications apply to tax rules and default values:
The following figure shows these determining factors and rule types in detail
and how you can turn them into expressions that can be modeled in Oracle
Fusion Tax.
Legislation Phrase 1
Tax legislation phrase 1 indicates that the determining factor that defines this
specific tax rule is only applicable to purchase transactions. This equates to a
The following figure shows that the determining factor that defines this specific
tax rule is only applicable to purchase transactions.
This table describes the contents of the tax condition set as represented in the
previous figure:
Tip
Always look for the most generic approaches that cover more of the business
requirements in a single tax rule. For example, here the tax event class is used
instead of a specific event class for Payables transactions and another similar rule
for Purchasing transactions.
It is determining factors like this that allows you to define tax rules that are only
applicable to specific types of transactions. The previous approach allows you
a convenient way of splitting order-to-cash and procure-to-pay transactions.
By using event class you can make a more detailed refinement so that tax rules
are only applicable to specific product transactions. This flexibility drives the
simplification of combining procure-to-pay tax setup with order-to-cash tax
setup into a single model. In the majority of cases you do not need to distinguish
between procure-to-pay or order-to-cash transactions within the tax rules,
however, where there is a need create specific procure-to-pay or order-to-cash tax
rules using this key design concept.
Legislation Phrase 2
Tax legislation phrase 2 indicates that the determining factor that defines the
supplier is registered in another EU. There are several ways of modeling this
but the approach that is recommended for you to take is to use a registration
The following figure shows the determining factor that defines that the supplier
is registered in another EU country.
This table describes the contents of the tax condition set as represented in the
previous figure:
Tip
Always look for approaches which coupled with business procedures provide
the necessary controls. In this case it is recommended that you devise and
implement a business procedure to ensure that sufficient level of checking is
done before the supplier or supplier site tax registration record is created and
that the correct registration status entered. This business procedure ensures that
the supplier is a valid supplier and that their tax registration number is a valid
tax registration number.
Legislation Phrase 3
Tax legislation phrase 3 indicates that the determining factor that defines the
product type is goods. Another way of modeling this is to use a product fiscal
classification which can automatically be derived from the item defined on the
transaction. However, in this case if an item is not specified on the transaction,
The following figure shows the determining factor that defines that the product
type is goods.
This table describes the contents of the tax condition set as represented in the
previous figure:
Tip
Always look for an approach which provides an automated process that covers
as many transactions as possible. For example, by using product type of Goods
rather than a product fiscal classification then unmatched Purchase invoice tax
processing can also be covered by this one tax rule.
Legislation Phrase 4
Tax legislation phrase 4 indicates that the determining factors that define the
supply is from another EU country. This is modeled by:
You can take items 2 and 3 to ensure that the goods are being sent from another
EU country outside the UK.
The following figure shows the determining factor that defines the supply is
from another EU country.
Tip
Geography and tax zones are powerful features of Oracle Fusion Tax and you
should use them wherever possible to identify tax jurisdictions and geography
requirements in general. Use the geography or tax zone information for tax
reporting instead of trying to build geography information into concepts such as
tax rates. For example, use tax jurisdictions, such as over sea tax territories based
on tax zone, to identify specific territories needed for tax reporting rather than
creating specific tax regimes, taxes, tax statuses, and tax rates.
This table describes the contents of the tax condition set for the Tax Registration
and Place of Supply tax rules as represented in the previous figure:
Tip
From this example you can see that a simple Tax Registration tax rule and Place
of Supply tax rule is all that is needed to define what is a complex scenario for
What's the difference between using tax exemptions or tax rules to modify the
taxable nature of a transaction?
You can modify the taxable nature of a transaction using tax exemptions,
but you can also accomplish this through the use of tax rules. Use tax rules,
such as the Determine Tax Applicability rule, to exclude certain categories of
transactions from taxation. If you choose to implement tax rules to achieve your
tax exemption requirements, the impacted transactions do not appear on many
tax reports as they do not have any tax lines.
If you must report on a transaction then set up a tax exemption on the customer's
party tax profile which results in a tax line being created with the modified tax
rate. Use tax exemptions where certificates of exemption are issued for specific
customers, which is typical in tax regimes for US Sales and Use Tax.
You can create an exempt tax rate with a zero percentage rate as a method of
applying exemptions. This achieves many of the intended reporting objectives as
the application generates a tax line. Reports that specifically refer to an item as
exempt may exclude items with a zero percentage rate from that portion of the
report because the exempt indicator is blank.
If you define an exempt tax with a zero tax rate, the transaction shows as fully
taxable on all reports. If you want reports to show the full line amount as taxable
you cannot add any exemption details, such as exempt reason codes, as this
results in an exemption being created on the customer record and a zero taxable
amount on the reports.
In addition to location, there are other factors that can contribute to the
applicability of a tax. Some examples are:
The tax determination process is organized into rule types. Each rule type
identifies a particular step in the determination and calculation of taxes on
transactions. The rule types and related processes used for tax applicability
determination are:
A third rule type, Direct Tax Rate Determination, is a special tax rule type that
lets you specify the results of tax applicability, tax status, and tax rate for a
given tax. You use this rule type for specific tax determination requirements.
If available, the Direct Tax Rate Determination rules are processed first. If
it is found to be applicable, then the Determine Tax Applicability rules are
processed, followed by the Determine Place of Supply rules. If it is not found to
be applicable, the Determine Place of Supply rules are processed, followed by the
Determine Tax Applicability rules.
For example, the place of supply for UK VAT on goods is generally the ship-from
country. Thus, the place of supply of a sale or purchase within the UK is the UK
itself. However, if a UK legal entity supplies goods from its French warehouse to
a German customer, then the place of supply will not find a jurisdiction for UK
VAT in France, and therefore UK VAT does not apply.
The following outlines the process that results in a list of applicable taxes per
transaction line:
1. Consider the Determine Place of Supply tax rule of the first candidate tax
in order of rule priority.
2. Use the location type derived from the tax rule for the tax. The possible
location types are:
• Bill from
• Bill to
• Ship from
• Ship to
The tax determination process first attempts to derive the applicability of each
candidate tax based on the rule conditions of the Determine Tax Applicability
rules for the tax. If no rule applies, the process uses the default value of
Applicable or Not Applicable that was assigned to the rule type for the tax. If
the tax does not apply, it is removed from the list of candidate taxes.
The following outlines the process that results in a final tax of list of taxes that
apply to the transaction:
1. Consider the Determine Tax Applicability tax rules of the first candidate
tax in order of rule priority.
2. Use the Applicable or Not Applicable value derived from the tax rule for
the tax.
3. Use the default value for the rule if no applicability rule evaluates
successfully.
4. Repeat steps 1 to 3 for each candidate tax.
5. Identify the final tax or list of taxes by eliminating the taxes that have an
applicability value of Not Applicable.
The tax determination process uses your tax configuration setup and the details
on the transaction to determine which taxes are applicable to the transaction.
If the tax authority levies tax on all sales and purchase transactions at the same
rate, and neither tax applicability nor the tax rates and recovery rates vary by
any factors, you do not have to set up tax rules. Oracle Fusion Tax can simply
use the default tax status, tax rate, and tax recovery rate defined for the tax. If,
however, the applicability of tax is dependent upon certain criteria, you may
need to use default values in combination with one or many tax rules to define
the logic necessary to derive the values in the tax determination process.
At transaction time the application derives the place of supply from the
transaction as shown in the table below. It is important to consider how place of
supply translates for the event classes being considered for tax calculation in a
regime since this can include and exclude candidate taxes.
Note
For migrated data using the Standard Tax Classification Code approach, which
uses a tax code to derive tax, tax status, and tax rate, you can set the tax to be
applicable or not applicable by default or by using a tax applicability rule.
If a direct tax rate determination rule is evaluated successfully, then the tax
is applicable and the tax status and tax rate defined for the rule are used in
tax determination. If a direct tax rate determination rule is not evaluated
successfully, then the tax determination process resumes with the tax
applicability rules.
Use tax zones to group existing geographical regions that share the same
tax requirement. You can use tax zones with tax regimes, to identify tax
requirements for a special geographic area, and to create parent tax regimes that
represent a related grouping of geographic regions for tax reporting purposes.
You can also use tax zones with tax rules, to create tax rules that refer to a
specific geographic location. The use of tax zones is optional and depends on
your overall tax setup planning.
Use the Allow tax applicability option to determine if Oracle Fusion Tax
calculates tax on transactions for a specific event class. This option is available
on the Configuration Owner Tax Options page, which enables you to review
the default tax settings for each application event class. Oracle Fusion Tax uses
these settings as the basis for determining and calculating taxes on transactions
belonging to each event class.
Scenario
In Canada, the First Nations Goods and Services Tax (FNGST) is a tax that
is applied by participating Aboriginal governments on the consumption of
goods and services within their reserves or settlement lands. The 5% FNGST
is administered in exactly the same way as the federal Goods and Services Tax
(GST), however, where it applies, GST does not apply.
• Place of supply for FNGST tax is based on the place of delivery or ship-to
location
Transaction Details
A customer who resides on lands where FNGST applies buys supplies from ABC
Corporation located in the province of Ontario. This store is not located on lands
where FNGST applies. The sales invoice indicates that ABC Corporation delivers
the furniture to the customer's residence. The FNGST applies to the sale, and
GST does not apply.
As part of the setup, create a tax that is applicable to any party that qualifies as
First Nation. Due to the specificity of the tax, set the default applicability to Not
Applicable. In this example, you do not need to configure a place of supply rule
as a standard default of ship to would suffice.
There is more than one way to configure this rule and applicability. They include:
Analysis
For this scenario, the following setup is needed:
1. Create a tax regime for the tax that is applicable to any First Nation party.
The regime level is Country and the country of applicability is Canada.
2. Create a tax with a default applicability of Not Applicable since this tax is
only applicable in exception cases. Set the default Place of Supply as Ship
To. To make this tax applicable, you will need to create a tax rule.
3. Create a standard tax status and a standard tax rate. Create the default tax
rate with a rate percentage of 5%. You do not need to define a jurisdiction
rate since the rate is standard across Canada.
4. For FNGST, identify a driver to determine applicability, such as a party
fiscal classification. Create a party fiscal classification for First Nation,
and associate the tax regimes affected by this tax. Note that CA FNGST
is associated to trigger applicability, but CA GST AND HST is also
associated to avoid applicability when CA FNGST applies.
5. Once you create a party fiscal classification and associated the tax
regimes, associate the classification to the specific party. To do so, create or
edit an existing third party tax profile and associate it to the First Nation
party fiscal classification.
6. For FNGST, create a tax applicability rule that is Applicable when the
conditions for FNGST are met. Recall that by default, FNGST is Not
Applicable since in most cases it only applies as an exception. For this tax
rule, you need a tax determining factor set and associated tax condition
set whereby the party fiscal classification of the ship-to party corresponds
to the First Nation party fiscal classification you created.
7. For GST, create a tax applicability rule that is Not Applicable when the
conditions for FNGST are met. By default, GST is Applicable since in
most cases it applies and FNGST is the exception.
FNGST, a tax that is not applicable by default, becomes applicable on
transactions to First Nation parties. The first Determine Tax Applicability rule
makes FNGST applicable when the ship-to party on the transaction corresponds
to the party fiscal classification that identifies a First Nation party. Since
GST does not apply when FNGST is applicable, the second Determine Tax
Applicability rule has the opposite result, whereby GST becomes not applicable
when the ship-to party on the transaction is a First Nation party.
The taxable basis tax formula is used in the tax calculation process to determine
the amount or quantity that should be considered as the taxable basis of a
transaction line. The tax rate is applied on the taxable basis amount to derive the
basic tax amount on a transaction line.
The key factor that decides the characteristics of the taxable basis amount is
the taxable basis type that is defined in the taxable basis formula. The various
taxable basis types are:
• Assessable value
• Line amount
• Prior tax
• Quantity
The following standard predefined taxable basis tax formulas are available:
• STANDARD_QUANTITY
• STANDARD_TB
• STANDARD_TB_DISCOUNT
Assessable Value
Use Assessable value when the transaction line amount does not reflect the
correct taxable basis, from the tax calculation perspective. The assessable value
given on the transaction line is considered as the taxable basis amount for the
purpose of tax calculation.
Line Amount
Use Line amount when the transaction line amount is to be treated as the taxable
basis for tax calculation purposes.
The transaction line amount is considered as the taxable basis. This is done
after deducting the associated discounts, or after proportionately enhancing
or reducing it by a certain percentage, or after adding other applicable taxes
available on the transaction line. These adjustments on the line amount are
controlled through the following parameters that are defined on the tax formula:
• Subtract cash discount: The cash discount applicable on the transaction,
derived through the attached payment terms, is deducted from the
transaction line amount. This option is considered only for Receivable
transactions.
• Tax formula compounding: The tax details specified in the tax formula
compounding region are added to the transaction line amount to
determine the taxable basis amount. These tax details are also enforced
by selecting the Enforce Compounding option. If a compounded tax is
enforced and if it is not calculated on the transaction, the tax to which this
tax formula is associated with also does not become applicable.
Prior Tax
Use Prior tax if the taxable basis is one or more than the other taxes calculated on
the transaction line. The option to compound the prior taxes that are calculated
on the transaction line are also available.
Quantity
The tax calculation tax formula is used to determine the calculation methodology
that is applied to derive the basic tax amount on a transaction line. The tax
amount on a transaction is generally calculated by multiplying the derived tax
rate by the taxable basis. However, in some cases the tax amount is required to
be altered by adding other taxes that are applicable on the same transaction line.
Use a tax calculation formula defined with compounding criteria to address this
requirement.
The tax details specified in the tax formula compounding region are added to
the calculated tax that is associated with the tax formula. These compounded
tax details can also be enforced when you select the Enforce Compounding
option. When the compounded tax is enforced and when it is not calculated on
the transaction, the tax to which this tax formula is associated with also does not
become applicable.
Taxable basis type that is defined in the taxable basis formula is a key factor that
decides the characteristics of the taxable basis amount. The taxable basis types
are:
• Assessable value
• Line amount
The country tax is equal to the taxable basis multiplied by the county tax
rate (1680 USD * 10% = 168 USD).
Consider a situation when two taxes, state tax and county tax, are applicable on a
transaction. In such a situation, the transaction details and tax setup is as follows:
• The state tax is equal to the invoice line amount multiplied by the state tax
rate (1000 USD * 20% = 200 USD).
• The taxable basis for the county tax is the tax calculated for the state tax
(200 USD).
The country tax is equal to the taxable basis multiplied by the county tax
rate (200 USD * 10% = 20 USD).
• Quantity: 50 liters
• The taxable basis for the excise tax is the quantity given on the invoice
(50).
Scenario
Consider a situation when two taxes, state tax and county tax, are applicable on a
transaction. In such a situation, the transaction details and tax setup is as follows:
• Line amount: 1000 USD
• State tax rate: 20%
• County tax rate: 10%
• Compounding regime: Sale and use tax
• Compounding tax: State tax
The tax calculation is as follows:
• The state tax is equal to the invoice line amount multiplied by the state tax
rate (1000 USD * 20% = 200 USD).
• The county tax is equal to the invoice line amount multiplied by the
county tax rate plus the state tax ((1000 USD * 10%) + 200 USD = 300
USD).
First Parties
Set up tax profiles for your first party legal entities, legal reporting units, and
business units.
First party legal entities identify your organization to the relevant legal
authorities, for example, a national or international headquarters. Legal
entities let you more accurately model your external relationships to legal
authorities. The relationships between first party legal entities and the relevant
tax authorities normally control the setup of the transaction taxes required by
your business. Under most circumstances the tax setup is used and maintained
based on the configuration of the legal entity. Enter the default information,
party fiscal classifications, tax reporting codes, and configuration options for
your legal entities. You can also specify if you are using the tax services of an
external service provider for tax calculation.
First party legal reporting units identify each office, service center, warehouse
and any other location within the organization that has a tax requirement. A
legal reporting unit tax profile is automatically created for the headquarter
legal entity. Set up additional legal reporting unit tax profiles for those needed
for tax purposes. For legal reporting units, enter the default information, tax
registrations, party fiscal classifications, and tax reporting codes. Also, define
tax reporting details for your VAT and global tax reporting needs for tax
registrations of tax regimes that allow this setup.
• Indicate that business unit tax setup is used and maintained based on
the configuration of the associated legal entity at transaction time. The
tax setup of the associated legal entity setup is either specific to the legal
entity or shared across legal entities using the Global Configuration
Owner setup.
• Indicate that tax setup is used and maintained by a specific business unit.
Create configuration options for the business unit to indicate that the
subscribed tax content is used for the transactions created for the business
unit.
For business units that maintain their own setup, enter the default information,
tax reporting codes, configuration options, and service providers as required.
Third Parties
Set up third party tax profiles for parties with the usage of customer, supplier,
and their sites. Enter the default information, tax registrations, party fiscal
classifications, and reporting codes required for your third parties or third party
sites. You can set up tax exemptions for your customers and customer sites.
Banks are also considered third parties. When a bank is created, the tax
registration number specified on the bank record is added to the party tax profile
record in Oracle Fusion Tax. You can not modify the party tax profile for a bank
as it is view only. You can only modify the bank record itself.
Note
Setting up party tax profiles for third parties is not required. Taxes are still
calculated on transactions for third parties that do not have tax profiles
Tax Authorities
Set up a tax authority party tax profile using the Legal Authorities set up task.
The tax authority party tax profile identifies a tax authority party as a collecting
authority or a reporting authority or both. A collecting tax authority manages
the administration of tax remittances. A reporting tax authority receives and
processes all company transaction tax reports.
The collecting and reporting tax authorities appear in the corresponding list of
values on all applicable Oracle Fusion Tax pages. All tax authorities are available
in the list of values as an issuing tax authority.
• Tax reporting codes: Applicable to legal entities, legal reporting units, and
business units who do not use the tax setup of the legal entity.
The following table describes the defaults and controls available at the first party
tax profile level:
Option Description
Set as self-assessment (reverse charge) Automatically self-assess taxes on purchases.
Rounding Level Perform rounding operations on the:
Note
Set Invoice Values as Tax Inclusive This first party intends to send or receive invoices
with invoice line amount inclusive of the tax
amount.
Note
You must set up a separate tax registration to represent each distinct registration
requirement for a first party legal reporting unit. Oracle Fusion Tax uses tax
registrations in tax determination and tax reporting. If your first party has
more than one tax registration under the same tax regime, then the application
considers the tax registration in the order: tax jurisdiction; tax; tax regime.
You must enable the Use tax reporting configuration option on the first party
tax regime to allow entry of global tax reporting configuration details during tax
registration setup for legal reporting units for these tax regimes.
If applicable, associate first party fiscal classification codes with this party. The
party fiscal classification codes you enter become part of tax determination for
invoices associated with this party. Specify start and end dates to control when
these fiscal classifications are applicable for this party and transaction.
For legal entities, you can view the associated legal classifications that were
assigned to the tax regime defined for this first party. The legal classifications are
used in the tax determination process, similarly to the party fiscal classifications.
Configuration Options
The legal entities and business units in your organization are each subject to
specific sets of tax regulations as designated by the tax authorities where you do
business. Use configuration options to associate legal entities and business units
with their applicable tax regimes. You can set up tax configuration options when
you create a tax regime or when you create a party tax profile. Both setup flows
display and maintain the same party and tax regime definitions.
Service Subscriptions
Oracle Fusion Tax lets you use the tax services of external service providers for
tax calculation of US Sales and Use Tax on Receivables transactions. The setup
for provider services is called a service subscription. A service subscription
applies to the transactions of one configuration option setup for a combination
of tax regime and legal entity or business unit. Set up service subscriptions when
you create a tax regime or when you create a party tax profile for a first party
legal entity or business unit.
Manual Approach
In the manual approach, you access the calculated tax lines on a transaction and
select the Inclusive option. This action includes the calculated tax amount with
the item value.
However, this option is controlled through two factors:
• Privileges are assigned to the users for accessing and editing the
calculated tax lines.
• Setup restrictions are applied to edit the Inclusive option on the
calculated tax lines.
Automatic Approach
In the automatic approach, you can configure the tax setup and calculate the tax
on a transaction as inclusive of the item line amount. Since this requirement is
primarily driven by the tax legislation and the business relationship between the
transacting parties, the option for configuring the inclusiveness is made available
on the tax and tax rate definition and the third party and legal reporting unit
tax profiles on the tax registration and general data tabs. The tax determination
process uses a hierarchy approach to evaluate the defined setup and applies the
inclusiveness option on the transaction.
In tax setup there are options to choose for applying the inclusiveness on a
transaction. They are:
• Standard noninclusive handling: This option calculates the taxes as
exclusive of the given transaction line amount.
• Standard inclusive handling: This option calculates the taxes as inclusive
of the given transaction line amount.
• Special inclusive handling: This option calculates the taxes as inclusive
of the given transaction line amount, but the calculation methodology
differs from the standard inclusive process.
The following table illustrates the calculation methodology used with each of
these options when a transaction line amount is 1000 USD and the applicable tax
rate is 10% of the taxable basis amount, for example, line amount:
The requirement for calculating the taxes as inclusive of the item line amount
is primarily driven by the tax legislation and the business relationship between
the transacting parties. Configure your tax setup accordingly to capture the
inclusiveness as per the taxes and the parties involved within a transaction.
The following table provides some of the key inclusiveness requirements and the
corresponding setup that can honor them:
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
Key parameters that influence the rounding of calculated tax amount are:
• Tax precision: The number of decimal places to which to calculate the tax
amount.
• Minimum accountable unit: The smallest currency unit that a tax amount
can have.
• Rounding rule: The method that is used to round off the calculated taxes
to the minimum accountable unit. The available options are Up, Down,
and Nearest.
Define the key parameters at various places within Oracle Fusion Tax. The
rounding process derives the tax precision and minimum accountable unit
details from the tax setup. The rounding process derives the rounding rule and
rounding level details through the predefined processing hierarchy involving:
• Configuration owner tax options defined for the configuration owner and
event class
• Party tax profiles of the parties or party sites as given in the rounding
precedence of the configuration owner tax options or in the derived
registration party
• Tax
Note
If you plan to use a third party service provider then you must define tax
rounding information that is at least as detailed as the rounding information of
the service provider.
Criteria for rounding the calculated tax amounts comes from various parties
involved in a transaction. For example, for a purchase transaction, the rounding
methodology is generally specified by the supplier. Specify rounding details
in your tax setup to ensure that your entered invoice amount, including the
calculated tax, is the same as the actual invoice amount. For a Receivables
invoice, you can specify rounding details based on your organization's policy,
but for most countries the rounding criterion is directed by tax legislation.
• Third parties
• First parties
• Tax legislation
• Define the party tax profile for the third party and specify the rounding
level and rounding rule on the General tab as preferred by the third party.
• If the rounding level is at the line level in the party tax profile, create
registration details for each tax and specify the rounding rule. Also, define
tax registration rules for each tax so that the tax determination process
uses the third party registration.
• If a registration record is not defined for the tax registration party, select
the Allow tax rounding override option on the Create or Edit Tax page.
The application then looks at the party account site details and party tax
profile details for deriving the rounding rule.
• Ensure that the party tax profile details are available for the
corresponding legal reporting unit. Specify the rounding level and
• If the rounding level is at the line level in the party tax profile, create
registration details for each tax and specify the rounding rule. Also, define
tax registration rules for each tax so that the tax determination process
uses the first party registration.
• If a registration record is not defined for the tax registration party, select
the Allow tax rounding override option on the Create or Edit Tax page.
The application then looks at the party tax profile details for deriving the
rounding rule.
The rounding criteria applied if configuration owner tax options are not defined
and the criteria in the predefined event class options are considered include:
• For a purchase transaction, the predefined event class options use the
ship-from party site and ship-from party within the rounding precedence
with the default rounding level as the header level. The supplier's
rounding preferences are considered first on the transaction. If there are
no specific supplier preferences, for example, the party tax profile record
does not exist, then the default rounding level of Header is considered
and the corresponding rounding rule from each tax setup detail is used.
• For a sale transaction, the predefined event class options do not include
any rounding precedence details. However, the default rounding
level is set to Line so the rounding level is always taken as Line and
the corresponding registration record for the tax registration party is
considered for the rounding rule. The tax registration party is identified
through the Determine Tax Registration tax rule or tax rule defaults.
If a registration record does not exist for the tax registration party, the
rounding rule defined within each tax is considered.
• If the configuration owner tax options are defined for the combination
of business unit and legal entity for which the transaction is registered
and for the event class, the default rounding level is used from the
configuration owner tax options. Select Blank as the rounding precedence
for the event class.
• If the rounding level is at the line level for the configuration tax options,
ensure that the registration record defined for the tax registration party
has the rounding rule based on the tax requirements. The tax registration
party is identified through the Determine Tax Registration tax rule or tax
rule defaults.
During the rounding process, the tax precision and minimum accountable
unit details are derived from the tax setup. The rounding process derives the
rounding rule and rounding level details through the predefined processing
hierarchy involving:
• Party tax profiles of the parties or party sites as given in the rounding
precedence of the configuration owner tax options or in the derived
registration party
• Tax
• Tax precision: The number of decimal places to which to calculate the tax
amount.
• Minimum accountable unit: The smallest currency unit that a tax amount
can have.
• Rounding rule: The method that is used to round off the calculated taxes
to the minimum accountable unit.
• Header: Applies rounding to calculated tax amounts once for each tax rate
per invoice.
• Line: Applies rounding to the calculated tax amount on each invoice line.
• Up: the amount is rounded to the next highest minimum accountable unit.
1. Looks for rounding details in the party tax profiles of the parties and
party sites involved in the transaction, according to the rounding
precedence hierarchy.
2. If an applicable tax profile is found then uses the rounding level and
rounding rule of the tax profile.
• City
tax:
7.5%
Example 2 represents the rounding details applied at the line level. Applying
these factors, the rounding process calculates the invoice amounts, all in USD
currency, as follows:
Document Amount Tax and Tax Tax Amount Step 1: Step 2: Line Tax Amount
Level Rate Not Rounding amounts Rounded
Rounded criteria is are added
applied at to obtain
the line level revised
header
amounts
Header 5579 • State • 395.8082 • 395.82 • 395.82
tax
• 418.425 • 418.44 • 418.44
• City tax
Line 1 1333 • State • 166.625 • 166.63 • 166.63
tax:
12.5% • 99.975 • 99.98 • 99.98
• City
tax:
7.5%
Line 2 1679 • State • 55.9107 • 55.92 • 55.92
tax
• 125.925 • 125.93 • 125.93
• City
tax:
7.5%
Line 3 2567 • State • 173.2725 • 173.27 • 173.27
tax
• 192.525 • 192.53 • 192.53
• City
tax:
7.5%
Taxes for purchase transactions are usually calculated by the supplier and
included in the invoice. The responsibility of collecting and remitting these taxes
to the authority lies with the supplier. However, in certain cases the supplier
does not have presence (nexus) or is not registered in the customer location.
The key here is that these taxes are to be calculated on the same invoice, but
these should not impact the amount payable to the supplier, instead it should be
accounted for as a tax liability.
The core requirements remain the same, however, the terminology used for
self-assessed taxes vary by tax regime, such as reverse charges, use taxes, and
offset taxes. Reverse charge is the terminology primarily used in the European
Union, use taxes is the terminology used in the United States, and offset taxes
is a alternate solution to handle self-assessment of taxes and is not used by any
regime.
Oracle Fusion Tax provides the following options to configure and automate
calculation of self-assessed taxes:
• Self-assessment
• Offset taxes
• Reporting-only taxes
• Use taxes
Self-Assessment
Taxes need to be self-assessed by the purchasing organization when the supplier
is not registered in the ship-to or bill-to location of the transaction. This is the
recommended approach for defining and calculating self-assessed taxes. This is
driven based on the registration party used for the transaction.
Registration Party
You can define tax registration for the supplier, the supplier site, and for a
particular tax regime. If the tax registration varies by tax or tax jurisdiction,
define the registration at a granular level. If the supplier does not have presence
in a specific jurisdiction, there are two options for configuration. The first is to
create a tax registration record with the registration status as not registered. The
second option is not to define a registration record. If you follow the second
option, when you define the condition set, set the operator for the Registration
determining factor class to Is blank.
Similar to the supplier registration, you can define the tax registration records for
a legal reporting unit tax profile. For the tax registration of the first party select
the Set as self-assessment (reverse charge) option. This option triggers self-
If the registration records are not created for the suppliers without registration,
create the condition set as follows:
Offset Taxes
Offset taxes is a backward compatible approach that is configured to self-assess
taxes. Configure offset taxes in addition to your regular taxes. Offset taxes carry
a negative rate and are calculated in the context of the regular tax. Where offset
taxes are applicable, the application creates two tax lines with one positive and
one negative amount. An offset tax record is a matching, duplicate record with
negative amounts that reduces or completely offsets the tax liability recorded in
the tax transaction. Use offset taxes when the tax requirement includes creating
an offset general ledger posting.
Reporting-Only Taxes
You can identify taxes for reporting purposes only. When these taxes are
applicable to the transactions, records are created in the tax repository entities.
However, invoice distributions are not created for these taxes. Therefore, there is
no impact to the payable amount, payment amount, and invoice accounting.
Use Taxes
Assigning use taxes to invoices, you create a record of the taxes you owe to tax
authorities. Oracle Fusion Payables does not create invoice distributions for these
taxes. Therefore, there is not any accounting impact due to these taxes. Payables
provides a Use Tax Liability Report to review and report use taxes.
Use the Use Tax Liability Report to review, report, and remit use taxes. The
report determines the use tax liability by each use tax code by taking the tax rate
you defined for each tax code and applying it to the sum of each invoice line
to which the tax applies. The report lists in summary or detail the total amount
of tax you owe for each tax code on invoices you enter between two dates you
specify when you submit the report. Oracle Fusion Payables displays the amount
of use tax you owe in the currency in which you entered an invoice.
Note
You can let a first party self-assess the taxes calculated on the Payables invoices
it receives. A self-assessed tax is a tax calculated and remitted for a transaction,
where tax was not levied by the supplier but is deemed as due (and therefore
needs to be paid by the purchaser). Taxes need to be self-assessed by the
purchasing organization when the supplier is not registered in the ship-to or bill-
to location of the transaction.
• Default registration party: Set the default values for the direct rule type of
Tax Registration. For self-assessed taxes set the value to Ship from or Bill
from.
• If the supplier is not registered then either you can create a registration
record for the tax regime, tax, or tax jurisdiction, with the registration
status of not registered. Or skip the step of defining tax registration and
define the tax condition set with the operator of Is blank.
If the supplier is not registered then the registration of the first party legal
reporting unit needs to be considered. To trigger this, you need to define a
tax registration rule with the following conditions:
• If you choose the option of not defining a supplier registration then the
condition set is as follows:
Set the rule result to bill-to party so that the registration of the legal
reporting unit is considered.
Tip
Instead of including the condition for the transaction input factor, you can
specify the event class constraint at the tax rule header.
• Self-assessing tax: For the first party registration record you create for
the tax regime, tax, and tax jurisdiction, check the Set as self-assessment
(reverse charge) option. Once the application selects this registration
record for the tax, the tax line is stamped as self-assessed.
Self-assessed taxes are not included in the invoice totals. Instead, the total of self-
assessed taxes for the invoice is displayed as a separate line in the tax charges
region of the invoice.
Self-assessed taxes are created for imported payables invoices. This happens
when imported transactions have tax lines along with transaction lines and
if you enable the Perform additional applicability for imported documents
option for the event class. For these transactions, additional taxes that are found
applicable are treated as self-assessed taxes.
These taxes are accounted along with the rest of the invoice. The accounting
treatment for expense and recovery remain the same as any supplier-assessed
taxes. The only variation is be the liability account. The tax amount is credited to
the tax liability account instead of the payables account.
Self-assessed taxes are a part of the standard tax reports. Apart from this, Oracle
Fusion Subledger Accounting provides reports for accounting activity that can
Note
When you select or deselect the Self-Assessed option on a tax line for the first
time, the update does not take effect. You must select the specific tax line, click
the row header or a noneditable area, and then select the Self-Assessed option.
Offset taxes are a backward compatible approach that you can configure to
self-assess taxes. Configure offset taxes in addition to the regular taxes. Offset
taxes carry a negative rate and are calculated in the context of the regular tax.
Where offset taxes are applicable, two tax lines are created with one positive and
one negative amount. An offset tax record is a matching, duplicate record with
negative amounts that reduces or completely offsets the tax liability recorded in
the tax transaction. Use offset taxes when the tax requirement includes creating
an offset general ledger posting.
• Set up the offset tax, tax status, and tax rate. Define at least one recovery
type lookup to use with offset taxes.
• Set up the tax status for the offset tax. Do not select the Allow tax rate
override option.
• Set up a 100% tax recovery rate for the offset tax using the recovery type
that is defined for the offset tax.
• Set up the original tax with the required configuration to enable the tax.
For the tax rate of the original tax (nonoffset tax), assign the offset tax rate
code in the Offset Rate Code field.
• For the configuration owner tax options for the Payables event classes,
enable offset tax calculation by selecting the Allow offset tax calculation
option. Also, specify the offset tax basis.
• Select the Allow offset taxes option on the party tax profile if offset taxes
are to be calculated for the transactions created for the party. Select this
option for the party type chosen in the Offset Tax Basis field for the
configuration owner tax options.
The amount for the regular tax line is always debited to the tax expense or
recovery account or both, depending on the recoverability of the tax. The credit
is posted to a payables account which is offset by the negative amount credited
to the payables account due to the offset tax line. The debit of the offset tax line
is posted to the tax liability account and this indicates the liability that the first
party organization has towards the tax authority for the self-assessed tax.
You can identify taxes for reporting purposes only. When these taxes are
applicable to the transactions, records are created in the tax repository entities.
For Oracle Fusion Payables invoices, these lines are not displayed on the invoice
lines. The total of the reporting-only taxes are displayed in the tax totals region
of the invoice.
Set up configuration options to associate tax regimes with the parties in your
company that have a tax requirement under these tax regimes.
The following concepts control how this setup is managed, used, and shared:
Identify a specific first party legal entity as a parent first party organization
to allow the configuration to be owned by a specific first party and shared by
other parties. You can then share this setup with another first party legal entity
or business unit for their transactions. Use a parent first party organization tax
configuration to share among a group of first party organizations but you still
have the tax setup managed by a single first party organization.
In the case of global configuration owner, if you are assigned the Create
Tax Regime privilege, you have update rights to all tax configuration data
maintained by the global configuration owner.
• Tax
• Tax status
• Tax rate
• Tax rules
A similar concept is used to define where you use tax exceptions for a specific
tax configuration. The tax subscription option available for product exceptions is
dictated to some extent by the main tax content subscription as follows:
Set up tax configuration options when you create a tax regime or when you
create a party tax profile for a first party legal entity or business unit. Both
setup flows display and maintain the same party or regime definitions. Specify
effective start and end dates to identify which configuration should be used
based on the transaction date. You can enable the business unit so that Oracle
Fusion Tax automatically uses the configuration of the legal entity. Once you
set this option the application records the date it occurred as the start date. This
date is used and compared to the transaction dates to identify if the application
uses the legal entity subscription in preference to the subscription of the business
Use the tax services of external service providers where tax content is required
for Receivables transactions for a significant number of tax jurisdictions. You
should not use a service provider if their use is not needed to support US Sales
and Use Tax regimes or you need to create and maintain tax regimes outside of
the Unites States.
You can use the tax services of these external service providers:
• Taxware, LP: a First Data Company
If you decide not to use an external service provider or you need to create tax
content for tax regimes outside the US then create and maintain your tax content
in Oracle Fusion Tax.
Once the decision is made to use Oracle Fusion Tax you need to choose the level
of tax configuration options. Sharing tax content prevents the need for duplicate
maintenance with its inefficiencies and potential inconsistencies. Consider these
scenarios and options:
Scenario Option
You have a single central corporate tax center Use the common configuration with party override
responsible for maintenance of tax setup for all legal option. This allows a single tax setup to be created
entities and business units. and maintained by the corporate tax center.
You need to have strict control of who can maintain Use the common configuration option. By not
the tax content. allowing party override you restrict the access to the
global configuration owner to an authorized user
who can maintain all of the tax content.
You have regional centers responsible for tax Use the parent first party configuration with party
content. override option. This permits a regional setup with
an actual or logical parent legal entity to be created
and maintained by each regional center.
Even if there is no obvious need to share tax configuration, for example, there
is only a single first party legal entity operating in each tax regime, significant
business events such as takeovers or mergers may mean that there could be a
future need to share content. In this case the original first party legal entity can
act as the configuration owner and then any subsequent first party can subscribe
to the first party's content using the parent first party configuration with party
override. Alternatively, set up the original tax content using global configuration
owner in preparation for any future business event that requires tax content to be
shared.
Changing from Business Unit to Using Tax Configuration at the First Party
Legal Entity
If you can standardize your tax setup across all business units for a given legal
entity then consider moving to configuring and using tax setup at the legal entity
level. Set the Use subscription of the legal entity option on the business unit
tax profile. Oracle Fusion Tax records the date this occurs and compares it to
the transaction date to identify if the legal entity subscription should be used in
preference to the subscription to the business unit.
Create a tax from an existing tax when you have a need to share tax jurisdictions
and tax registrations. You maintain the tax jurisdictions and tax registrations
once for taxes with the same name within the same tax regime owned by
different configuration owners.
Note
If you are using product exceptions, those exceptions are applied to the
transactions as shown in the following table:
• US
COUNTY
SALES TAX
• US CITY
SALES TAX
NAM Canada CA HST & GST • CA HST
• CA GST
Field Value
Tax Regime Code GB VAT
Configuration for Taxes and Rules Party-specific configuration
Configuration for Product Exceptions Party-specific configuration
Parent First Party Organization Blank
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code GB VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization EMEA LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code FR VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization EMEA LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code DE VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Field Value
Tax Regime Code AU GST
Configuration for Taxes and Rules Party-specific configuration
Configuration for Product Exceptions Party-specific configuration
Field Value
Tax Regime Code AU GST
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization APAC LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code SI VAT
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization APAC LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code US SALES TAX
Configuration for Taxes and Rules Party-specific configuration
Configuration for Product Exceptions Party-specific configuration
Parent First Party Organization Blank
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code US SALES TAX
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization NAM LE
Effective Start Date 01-Jan-01
Field Value
Tax Regime Code CA GST & PST
Configuration for Taxes and Rules Parent first party with party overrides
Configuration for Product Exceptions Parent first party organization
Parent First Party Organization NAM LE
Effective Start Date 01-Jan-01
You can define tax registrations at three different levels of detail. At the:
• Tax regime level: The tax registration is used for all taxes and tax
jurisdictions within the tax regime.
• Tax level: The tax registration is used for all tax jurisdictions where the tax
regime and tax are applicable.
• Tax jurisdiction level: The tax registration is applicable for the locations
covered under the tax jurisdictions defined for the tax regime, tax, and tax
jurisdiction.
For each tax that you create, you must define either a default tax registration
or a tax rule for the rule type Determine Tax Registration. If a party has more
than one tax registration under the same tax regime, then the tax determination
process considers the tax registrations in the order: tax jurisdiction; tax; and tax
regime.
You can define tax registrations as implicit. For example, the party is not
formally registered with the tax authority, but the party is considered to meet
You can use the registration status to define various tax rules. For example, if the
tax is applicable only if the supplier is registered, define the tax applicability rule
as follows:
• Value = Registered
On the detail tax lines, the tax determination process stamps two registration
numbers. One is for the headquarters, the main legal reporting unit of the legal
entity of the document. The other is for the party or party site identified by the
tax registration rule. For example, if the registration rule has identified ship to as
a party, then the tax determination process stamps the registration number of the
ship-to party on the transaction.
The tax determination process also considers these details of the derived tax
registration for each tax:
• Tax inclusive handling: The inclusive option set at the tax registration
level for the party identified by the tax registration rule overrides the
inclusive option set at the tax or party tax profile level for the tax line.
• Rounding rule: The rounding rule set at the tax registration level for the
party identified by the tax registration rule overrides the rounding rule set
at the tax or party tax profile level for the tax line.
The global tax report processing feature provides a reporting solution for all
countries to manage their tax reporting requirements. For some Europe, Middle
East, and Africa (EMEA) countries, Oracle Fusion Financials for EMEA provides
predefined reports, such as Italian VAT registers and Spanish VAT journals. For
other countries, you can use the tax data models to create your required reports.
Use the global tax report processing feature to organize tax report data according
to the requirements of your company and the tax authority. The EMEA reports
make use of the Oracle Fusion tax data models to retrieve tax transaction
information based on your tax configuration setup.
Using the global tax report processing feature, you can meet the following
business needs of your EMEA countries:
• Report tax, such as VAT, based on the tax registration number associated
with the legal reporting unit.
• Report tax, such as VAT, based on tax periods with tax calendars that are
the same as or different from the accounting calendars.
• Close the tax period by running the final reports to prevent updating or
double reporting of transactions to the tax authorities.
• Set up tax configuration details such as tax reporting entity and tax
register.
• Enter report processing details for a transaction such as tax reporting date.
• Run the Tax Selection Process that selects all the transactions that are
accounted, unaccounted, or both to report within a tax period. You can
run tax reports, general and country-specific, for unaccounted, accounted,
and both unaccounted and accounted transactions. This helps you to run
trial reports and make any corrections before submitting the final report to
tax authorities. The selection is based on the tax registration number and
tax reporting date, if you have completed the tax setup in Oracle Fusion
Tax.
Note
You must set up the tax reporting configuration prior to running the Tax
Selection Process.
To process value-added tax (VAT) reports, you must set up the tax reporting
entities for the tax registration number associated with a legal entity and
tax regime. When you run the selection process, each selected transaction is
Note
Ensure that you define tax registrations for all legal reporting units that have the
applicable VAT tax requirement.
You can customize your VAT reporting process by specifying the tax calendar for
a tax reporting entity, threshold amounts, and VAT registers. The setup includes:
• Common Configuration: Associate the calendar defined for tax reporting
to the combination of tax registration number, tax regime, and legal entity.
Choose the tax registration numbers that you defined in Oracle Fusion
Tax against legal entities and VAT tax regimes.
• Tax Registers: Record register information and associate it with a tax
reporting entity to determine document sequences. Assign one or more
document sequence names for each VAT register. The Italian VAT register
reports use the VAT register information.
Name Description
Tax Calendar Select the calendar to be associated to the tax
reporting entity.
Threshold Amount Enter the threshold amount specified for the legal
entity or tax regime that have tax transactions. If you
leave this field blank, then the application reports all
tax transactions.
Define tax registers for a tax reporting entity and assign a document sequence
name to a combination of tax register and tax reporting entity. The application
selects transactions to be reported on a tax register based on the document
sequence name assignment once you define a tax register and assign a document
sequence name. Use this setup for Italy only.
This example demonstrates how you set up the appropriate tax registers for your
organization located in Italy so you can meet your tax reporting requirements.
Create a tax reporting entity for every unique combination of legal entity, tax
regime, and tax registration number.
Prerequisites
To process VAT reports, implementers and financials personnel perform the
following prerequisites:
1. Set up legal entities and legal reporting units using the Legal Entity
Configurator to represent your company and its offices. For example, set
up Vision Italy as a legal entity.
2. Set up and maintain the first party tax profiles and tax registrations in the
context of tax regime for the legal reporting units in your company using
Oracle Fusion Tax.
3. Set up the tax regimes for the taxes in each country and geographic region
where you do business and where a separate tax applies using Oracle
Fusion Tax. For example, set up IT VAT as a tax regime. Enable the Use
tax reporting configuration option on the first party tax regime to allow
entry of tax reporting configuration details during tax registration setup
for legal reporting units for these tax regimes.
4. Set up the tax and tax rates in Oracle Fusion Tax. You must define the tax
with the reporting code enabled. EMEA lookup tax reporting codes, such
as VAT and Exempt, are available as predefined tax reporting codes under
the EMEA VAT Reporting Type.
5. Define tax reporting periods as accounting periods in Oracle Fusion
General Ledger. For example, set up Accounting as an accounting period.
The final reporting process maintains the tax reporting periods. If you use
the same calendar for accounting and tax reporting, the application still
maintains accounting periods independently from tax periods.
Field Value
Tax Regime Code IT VAT
Registration Number 123456789
Field Value
Tax Calendar Accounting
Tax Reporting Date Select Accounting Date
Enable Tax Registers Select
Enable Reporting Sequence Select
8. Click the Tax Registers tab and click New to add a new row in the table.
9. In the Tax Registers table, complete the fields, as shown in this table:
Field Value
Register Type Purchase VAT
Name Purchase VAT
Start Date Current Date
End Date Blank
Predefined tax register types are provided for Italy. These include
deferred VAT, purchase VAT, sales (self invoice and EU VAT), and sales
VAT.
The business unit party tax profile is automatically created when a business unit
record is created. If a business unit party tax profile record is not created, for
example, when a business unit is created through a back-end process, a business
unit party tax profile is created upon saving a tax regime when a business unit
is subscribed to or upon saving the configuration owner tax options when they
are defined for the business unit. Otherwise, create a party tax profile using
the Create Business Unit Tax Profile page. You can edit the tax profile that was
automatically generated with the relevant tax information, but it is not required.
Under most circumstances your business unit uses the tax setup based on the
configuration of the legal entity. When you first access the Create Business
Unit Party Tax Profile page you can select the Use legal entity tax subscription
option. If you select this option, you cannot update the business unit tax profile
or maintain separate tax content for this business unit. If you do not select this
option you enter the relevant tax information for the business unit. This is an
irreversible setting.
When does a party tax profile get created for a legal entity?
The legal entity party tax profile is automatically created when a legal entity
record is created. If a legal entity party tax profile record is not created, for
example, when a legal entity is created through a back-end process, a legal entity
party tax profile is created upon saving the tax regime when a legal entity is
subscribed to or upon saving the configuration owner tax options when they are
defined for the legal entity. Otherwise, create a party tax profile using the Create
Legal Entity Tax Profile page. You can edit the tax profile that was automatically
generated with the relevant tax information, but it is not required.
When does a party tax profile get created for a legal reporting unit?
The legal reporting unit party tax profile is automatically created when a legal
reporting unit is created. Otherwise, create a party tax profile using the Create
Legal Reporting Unit Tax Profile page. You can edit the tax profile that was
automatically generated with the relevant tax information, but it is not required.
Note
• A purchase order or arrival record is generated in Italy for France with the
following information:
Note
Arrival
Consider if the Statistical procedure code details for the arrival transaction
should be provided in addition to the Nature of transaction code details in
the Intrastat report.
Note
You can provide either the Fiscal regime attribute or the Statistical procedure
attribute.
• Net Mass
Consider if the net mass of the transaction, which is the quantity of items
multiplied by the unit weight of the item, should be provided in the
Intrastat report.
• Invoice amount
Consider if the actual invoice amount that is already created for the
transaction should be provided in the Intrastat report.
Dispatch
• Freight terms
• Mode of transport
• Region of origin
Consider if the details of the region within the dispatching country from
where the goods are dispatched should be provided in the Intrastat
report.
• Country of origin
Consider if the details of the dispatch country from where the goods
originated should be provided in the Intrastat report.
• Fiscal regime
Note
You can provide either the Fiscal regime attribute or the Statistical procedure
attribute.
• Net Mass
Consider if the net mass of the transaction, which is the quantity of items
multiplied by the unit weight of the item, should be provided in the
Intrastat report.
• Invoice amount
Consider if the actual invoice amount that is already created for the
transaction should be provided in the Intrastat report.
Validation Rules
Validation rules enable you to define the criteria for validating the collected
and manually entered Intrastat transactions. Only those transactions that are
• the value set that should be used for validating the values of the specific
attributes
Note
Supplementary UOM
Supplementary UOM rules enable you to define the requirement for reporting
Intrastat transactions in a supplementary UOM other than the weight UOM.
The movement of goods or specific items is reported in an UOM other than the
weight UOM. For example, it specifies that movement of commodity, Oil, should
be reported in Barrels.
Supplementary UOM rules are defined for a category code under the Intrastat
catalog. And that category code in turn defines the UOM in which the Intrastat
transaction is reported. Whenever there is an item in an Intrastat transaction
that belongs to the specific category code, then the supplementary UOM rule
is applied. The quantity of the item is thereby derived in supplementary UOM
based on the UOM conversion factor.
The Nature of Transaction Code rules enable you to define the Nature
of Transaction Code applicable based on source transaction, inventory
organization, item, and trading partner attributes of the base transaction. The
rules defined at a specific or granular level are given priority over rules defined
at a higher level. For example, there are two rules; one for a Source Transaction
and other for a Source Transaction and Item. In this case, the rule for Source
Transaction and Item is given higher priority wherever applicable.
You can only define either a Fiscal Regime Code or a Statistical Procedure Code
for a particular transaction.
Note
You can only define either a Statistical Procedure Code or a Fiscal Regime Code
for a particular transaction.
Statistical value calculation rules enable you to specify the freight factor that
is included in the statistical value. Freight factor is defined in percentage
and indicates the component of freight charge that should be included in the
statistical value.
You can define this rule based on country, organization, item, freight terms, and
mode of transport of the base transaction. You can then specify the freight factor,
which is a percentage of the freight charge. This freight factor is included while
calculating the statistical value. For example, you need to only include the freight
charge up to the country's border for a dispatch transaction. You can specify
this by defining a freight factor that accounts for the freight charge up to the
country's border only.
Note
In cases where freight charges are applicable for shipments across two countries
within the European Union, you are required to only include the freight charge
for moving the goods from the establishment to the border of the country.
Exclusion
Exclusion rules enable you to define the criteria to exclude specific goods
movement transactions from collections. You can exclude a specific item that you
do not want to be reported in the Intrastat collections by defining the exclusion
criteria in the rule. For example, you don't require service items to be included in
the collection. You can define this rule based on source transaction, organization,
category code, item, and trading partner of the base transaction. You can specify
the exclusion criterion that includes the source transaction, category code, and
item details of the transaction containing the service items. This ensures that the
specified items are not included in the collections.
No, Intrastat parameters cannot be defined for every legal reporting unit.
They can be defined only for the legal reporting units where the country
characteristics are defined for the country of the legal reporting unit. If the
Intrastat parameters are to be defined for a secondary legal reporting unit,
then the secondary legal reporting unit must be associated with an inventory
organization.
Yes. Intrastat rules can be used to configure Intrastat reporting as per the
guidelines of an individual country of the European Union. You can specify the
validations that are applicable for creating the Intrastat Declaration.
Can I use the supplementary UOM reporting requirement for specific item
categories?
Yes. Supplementary UOM rules are used to define reporting requirements for
certain commodity codes or item categories in alternate UOMs other than the
weight UOM. For example, it may be required to report liquids in Liters.
Can I use the statistical value calculation for including freight values in the
statistical value?
Tax Settings and Rules: How They Apply to Tax Line Operations
Enter and update detail and summary tax lines according to the requirements
of your transactions. Depending on your security settings and options specified
during tax setup, you can:
Note
The Summary Tax Lines component is applicable only to Oracle Fusion Payables.
1. Enable the Allow entry of manual tax lines option for the:
• Tax
2. Ensure that the Manual Tax Line Entry profile option is enabled. It is
enabled by default.
3. Enter a unique combination for a tax regime and tax. You cannot enter a
manual tax line for a tax that already exists for the transaction line.
4. Enter a tax status to enter a tax rate.
5. Enter a tax regime, tax, tax status, and tax rate to enter a tax amount.
The tax calculation on a manual tax line is a standard formula of Tax Amount
= Taxable Basis * Tax Rate. The tax determination process does not evaluate tax
rules defined for the tax of any tax rule type.
1. Enable the Allow manual tax only lines option for the configuration
owner and application event class.
2. Select a tax regime from the tax regimes belonging to the configuration
option of the applicable legal entity or business unit.
3. Select a tax, tax status, and tax rate and enter a tax amount.
Note
When you select or deselect the Tax Only Line option on a tax line for the first
time, the update does not take effect. You must select the specific tax line, click
the row header or a noneditable area, and then select the Tax Only Line option.
The following table describes the defaults and controls available at the
configuration owner tax options level for the following applications and event
classes:
• Receivables: Credit Memo
• Receivables: Debit Memo
• Receivables: Invoice
Default Tax Options Region
Create a tax reporting type and codes for exemption letters and assign them to
the Exemption Limit Tax Tag for Italian Exemption Letters profile option. At
the distribution level of the invoice you associate appropriate invoice lines with
an exemption limit group. Enter a tax rate code of a tax reporting type according
to the value defined in your profile option. When you run the Italian exemption
reports, the report logic determines the value of the profile option, and selects all
invoices with the related tax reporting codes.
Use the Exemption Limit window to modify (add or subtract) either the current
month amount or adjust the current month and future periods. For example,
you want to reduce the current month and future periods limit by 25,000 EUR.
Enter -25,000 in the Monthly Adjustment field and select the Adjust selected
and subsequent months radio button. The application subtracts 25,000 from the
current month amount and from each of the remaining month amounts in the
calendar year.
If you want to assign exemption limits to the supplier, enter a letter type in the
Letter Type field.
Options include:
• Exempted Amount: Exemption letter with exemption limit printed.
• Exempted Period: Exemption letter with a date range.
• Specific Operation: Customs letter for a single transaction.
First Parties
Set up tax profiles for your first party legal entities, legal reporting units, and
business units.
First party legal entities identify your organization to the relevant legal
authorities, for example, a national or international headquarters. Legal
entities let you more accurately model your external relationships to legal
authorities. The relationships between first party legal entities and the relevant
tax authorities normally control the setup of the transaction taxes required by
your business. Under most circumstances the tax setup is used and maintained
based on the configuration of the legal entity. Enter the default information,
party fiscal classifications, tax reporting codes, and configuration options for
your legal entities. You can also specify if you are using the tax services of an
external service provider for tax calculation.
First party legal reporting units identify each office, service center, warehouse
and any other location within the organization that has a tax requirement. A
legal reporting unit tax profile is automatically created for the headquarter
legal entity. Set up additional legal reporting unit tax profiles for those needed
for tax purposes. For legal reporting units, enter the default information, tax
registrations, party fiscal classifications, and tax reporting codes. Also, define
tax reporting details for your VAT and global tax reporting needs for tax
registrations of tax regimes that allow this setup.
Business units organize your company data according to your internal
accounting, financial monitoring, and reporting requirements. To help you
manage the tax needs of your business units, you can use the business unit tax
profile in either of two ways:
• Indicate that business unit tax setup is used and maintained based on
the configuration of the associated legal entity at transaction time. The
Third Parties
Set up third party tax profiles for parties with the usage of customer, supplier,
and their sites. Enter the default information, tax registrations, party fiscal
classifications, and reporting codes required for your third parties or third party
sites. You can set up tax exemptions for your customers and customer sites.
Banks are also considered third parties. When a bank is created, the tax
registration number specified on the bank record is added to the party tax profile
record in Oracle Fusion Tax. You can not modify the party tax profile for a bank
as it is view only. You can only modify the bank record itself.
Note
Setting up party tax profiles for third parties is not required. Taxes are still
calculated on transactions for third parties that do not have tax profiles
Tax Authorities
Set up a tax authority party tax profile using the Legal Authorities set up task.
The tax authority party tax profile identifies a tax authority party as a collecting
authority or a reporting authority or both. A collecting tax authority manages
the administration of tax remittances. A reporting tax authority receives and
processes all company transaction tax reports.
The collecting and reporting tax authorities appear in the corresponding list of
values on all applicable Oracle Fusion Tax pages. All tax authorities are available
in the list of values as an issuing tax authority.
The following table describes the defaults and controls available at the third
party tax profile level:
Option Description
Allow tax applicability Automatically calculate taxes for this party
whenever the party acts as a supplier. You can set
this option, for example, for customers that also act
as suppliers on transactions.
Allow offset taxes Calculate and record third party Payables tax
liabilities for reverse charges, self-assessments, and
Consumer's Use tax (US).
Note
Set Invoice Values as Tax Inclusive This third party or third party site intends to send or
receive invoices with invoice line amount inclusive
of the tax amount.
Note
Country, Registration Number, and Tax Set defaults for all tax reporting for tax registrations
Registration Type of this third party or third party site. You must
complete the tax registration setup.
Tax Exemptions
Set up tax exemptions for your third party customers and customer sites. To
set up tax exemptions for a third party, you must complete the appropriate tax
exemption setup for the tax regimes and taxes concerned. You can have more
then one tax exemption for the same customer and tax regime combination. You
may need to do this, for example, if one tax exemption applies to a specific tax,
while other tax exemptions apply to specific products for specific tax rates and
tax jurisdictions. At transaction time, Oracle Fusion Tax applies the most specific
tax exemption to the transaction.
If applicable, associate third party fiscal classification codes with this party. The
party fiscal classification codes you enter become part of tax determination for
invoices associated with this party. Specify start and end dates to control when
these fiscal classifications are applicable for this party and transaction.
• Are used for specific products or available for all transactions for a legal
entity or business unit.
In Oracle Fusion Tax, you define tax exemptions for the combination of customer
and customer site and items for a period of time. Use rate modifiers, such
as discount or surcharge percentage or special rate percentage to map the
preferential or special tax rate applicability.
The tax exemption status influences the applicability of the tax exemption on
transactions. The possible values are: Primary, Manual, Rejected, Unapproved,
and Discontinued. The tax exemptions with the status of Primary are applicable
to all transactions. The tax determination process considers Manual or
Unapproved statuses only when the certificate number and the exempt reason
given on the transaction match with the registered tax exemption values.
The Discontinued or Rejected statuses are not considered for tax exemption
processing.
The tax handling option on a Receivable transaction also influences the tax
exemption processing. If you use the tax handling option of Standard, the tax
determination process considers only tax exemptions with a status of Primary.
If you use the tax handling option of Exempt, the tax determination process
considers all Primary, Manual, and Unapproved tax exemptions with reference
to the certificate number and exempt reason given on the transaction. If you
use the tax handling option of Exempt, manual, the tax determination process
creates a new tax exemption along with the given certificate number and exempt
reason, with 100% discount and with a status of Unapproved if the matching
condition does not result in filtering any existing tax exemptions.
To set up tax exemptions for a third party, you must complete the appropriate
tax exemption setup for the tax regimes and taxes concerned. Create a separate
record for each tax exemption that applies to the third party customer or
customer site. The tax determination process applies the tax exemption to the
transaction line based on the tax exemption setup and tax handling specified on
the transaction line.
Before you can create a tax exemption record, you must enable the tax exemption
options at the appropriate levels:
• Set the Tax Exemption Override Control profile option to control the
display of tax handling on the transaction line to apply and update
customer tax exemptions to transactions.
A tax exemption record identifies the nature of the tax exemption, the
configuration owner, and tax regime, and, where applicable, the related tax, tax
status, tax rate, and tax jurisdictions to which the tax exemption belongs.
During the life of a tax exemption, the tax exemption status can often change.
The possible statuses are: Primary, Manual, Unapproved, Discontinued, and
Rejected. Because the status of the tax exemption affects its applicability on the
transaction line, you must update the tax exemption record each time the status
changes. These rules apply to the status of the tax exemption:
• Tax exemptions with a status of Primary apply to all transactions of the
customer or customer site.
• Tax exemptions with a status of Manual or Unapproved apply to specific
transactions of the customer or customer site.
• Tax exemptions with a status of Discontinued or Rejected are not
considered during tax calculation.
You also specify the method of calculating the tax exemption percentage on the
tax exemption record:
• The Discount or surcharge type decreases or increases the original rate by
the percentage you enter.
If the discount is 15% off the standard rate and the standard rate is 10%,
enter 85 as the tax exemption percentage. This defines a discount rate that
is 85% of the original 10%, or 8.5%.
If the surcharge is 10%, enter 110 as the tax exemption percentage. This
defines a surcharge rate that is 110% of the original 10%, or 11%.
• The Special rate type replaces the original rate with the percentage you
enter.
Enter the special rate percentage that replaces the standard rate. If
the original rate is 10%, and the special rate is 5%, enter 5 as the tax
exemption percentage.
You use the Tax Handling field on the transaction line to select the applicable
tax exemption value. Tax exemptions are processed in different ways depending
upon the value you choose:
Note
The application first checks the customer site party tax profile for the exemption
records. If there is no exemption record defined within the site, then it checks the
customer party tax profile
After applying the tax exemption to the transaction line, the tax determination
process calculates the tax rate using the tax exemption type defined in the tax
exemption record. The sequence of the tax rate value determination is:
For example, the tax rate determined is 6%, the special rate for a tax exception is
5%, and the tax exemption defined is a 2% discount. The tax exemption discount
is applicable to the tax rate after the tax exception, so the 5% tax rate is modified
by a 2% discount (5% * (100%-2%) = 4.9%). If the tax exemption defined is of the
rate type of Special rate then the special rate is substituted and the applicable tax
exception has no impact.
For manual tax lines, no additional processing is performed and tax exemptions
are not considered. A manual tax lines suggests that you have specific business
requirements for a particular transaction to apply a manual tax. No additional
processing is performed for manual tax lines to avoid any applying conflicting
or inconsistent values to the user-entered tax line. The tax calculation on a
manual tax line is the standard formula of tax amount is equal to the taxable
basis multiplied by the tax rate.
Applying a Discount
Your company receives a discount of 20% because it sells educational materials.
You set the Exemption Rate Type option as Discount or surcharge and enter
20 in the Exemption Percentage field. As an example, the tax rate for your
transaction is 10%, but the application applies 8% due to the 20% discount (10% -
(10% * 20%)).
Applying a Surcharge
Your company is required to apply a surcharge to the tax rate of 10% to a specific
item it sells to a customer. For this customer and item, you set the Exemption
Rate Type option as Discount or surcharge and enter 110 in the Exemption
Percentage field. As an example, the tax rate for your transaction is 10%, but the
application applies 11% due to the 10% surcharge (10% + (10% * 10%)).
Manual Approach
In the manual approach, you access the calculated tax lines on a transaction and
select the Inclusive option. This action includes the calculated tax amount with
the item value.
However, this option is controlled through two factors:
• Privileges are assigned to the users for accessing and editing the
calculated tax lines.
• Setup restrictions are applied to edit the Inclusive option on the
calculated tax lines.
Automatic Approach
In the automatic approach, you can configure the tax setup and calculate the tax
on a transaction as inclusive of the item line amount. Since this requirement is
primarily driven by the tax legislation and the business relationship between the
transacting parties, the option for configuring the inclusiveness is made available
on the tax and tax rate definition and the third party and legal reporting unit
tax profiles on the tax registration and general data tabs. The tax determination
process uses a hierarchy approach to evaluate the defined setup and applies the
inclusiveness option on the transaction.
In tax setup there are options to choose for applying the inclusiveness on a
transaction. They are:
• Standard noninclusive handling: This option calculates the taxes as
exclusive of the given transaction line amount.
• Standard inclusive handling: This option calculates the taxes as inclusive
of the given transaction line amount.
• Special inclusive handling: This option calculates the taxes as inclusive
of the given transaction line amount, but the calculation methodology
differs from the standard inclusive process.
The following table illustrates the calculation methodology used with each of
these options when a transaction line amount is 1000 USD and the applicable tax
rate is 10% of the taxable basis amount, for example, line amount:
The requirement for calculating the taxes as inclusive of the item line amount
is primarily driven by the tax legislation and the business relationship between
the transacting parties. Configure your tax setup accordingly to capture the
inclusiveness as per the taxes and the parties involved within a transaction.
The following table provides some of the key inclusiveness requirements and the
corresponding setup that can honor them:
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
Process complete
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
• No: The referred tax gets calculated as exclusive of the transaction line
amount.
• Yes: The referred tax gets calculated as inclusive of the transaction line
amount.
Key parameters that influence the rounding of calculated tax amount are:
• Tax precision: The number of decimal places to which to calculate the tax
amount.
• Minimum accountable unit: The smallest currency unit that a tax amount
can have.
• Rounding rule: The method that is used to round off the calculated taxes
to the minimum accountable unit. The available options are Up, Down,
and Nearest.
Define the key parameters at various places within Oracle Fusion Tax. The
rounding process derives the tax precision and minimum accountable unit
details from the tax setup. The rounding process derives the rounding rule and
rounding level details through the predefined processing hierarchy involving:
• Configuration owner tax options defined for the configuration owner and
event class
• Party tax profiles of the parties or party sites as given in the rounding
precedence of the configuration owner tax options or in the derived
registration party
• Tax
Note
If you plan to use a third party service provider then you must define tax
rounding information that is at least as detailed as the rounding information of
the service provider.
Criteria for rounding the calculated tax amounts comes from various parties
involved in a transaction. For example, for a purchase transaction, the rounding
methodology is generally specified by the supplier. Specify rounding details
in your tax setup to ensure that your entered invoice amount, including the
calculated tax, is the same as the actual invoice amount. For a Receivables
invoice, you can specify rounding details based on your organization's policy,
but for most countries the rounding criterion is directed by tax legislation.
• Third parties
• First parties
• Tax legislation
• Define the party tax profile for the third party and specify the rounding
level and rounding rule on the General tab as preferred by the third party.
• If the rounding level is at the line level in the party tax profile, create
registration details for each tax and specify the rounding rule. Also, define
tax registration rules for each tax so that the tax determination process
uses the third party registration.
• If a registration record is not defined for the tax registration party, select
the Allow tax rounding override option on the Create or Edit Tax page.
The application then looks at the party account site details and party tax
profile details for deriving the rounding rule.
• Ensure that the party tax profile details are available for the
corresponding legal reporting unit. Specify the rounding level and
• If the rounding level is at the line level in the party tax profile, create
registration details for each tax and specify the rounding rule. Also, define
tax registration rules for each tax so that the tax determination process
uses the first party registration.
• If a registration record is not defined for the tax registration party, select
the Allow tax rounding override option on the Create or Edit Tax page.
The application then looks at the party tax profile details for deriving the
rounding rule.
The rounding criteria applied if configuration owner tax options are not defined
and the criteria in the predefined event class options are considered include:
• For a purchase transaction, the predefined event class options use the
ship-from party site and ship-from party within the rounding precedence
with the default rounding level as the header level. The supplier's
rounding preferences are considered first on the transaction. If there are
no specific supplier preferences, for example, the party tax profile record
does not exist, then the default rounding level of Header is considered
and the corresponding rounding rule from each tax setup detail is used.
• For a sale transaction, the predefined event class options do not include
any rounding precedence details. However, the default rounding
level is set to Line so the rounding level is always taken as Line and
the corresponding registration record for the tax registration party is
considered for the rounding rule. The tax registration party is identified
through the Determine Tax Registration tax rule or tax rule defaults.
If a registration record does not exist for the tax registration party, the
rounding rule defined within each tax is considered.
• If the configuration owner tax options are defined for the combination
of business unit and legal entity for which the transaction is registered
and for the event class, the default rounding level is used from the
configuration owner tax options. Select Blank as the rounding precedence
for the event class.
• If the rounding level is at the line level for the configuration tax options,
ensure that the registration record defined for the tax registration party
has the rounding rule based on the tax requirements. The tax registration
party is identified through the Determine Tax Registration tax rule or tax
rule defaults.
During the rounding process, the tax precision and minimum accountable
unit details are derived from the tax setup. The rounding process derives the
rounding rule and rounding level details through the predefined processing
hierarchy involving:
• Party tax profiles of the parties or party sites as given in the rounding
precedence of the configuration owner tax options or in the derived
registration party
• Tax
• Tax precision: The number of decimal places to which to calculate the tax
amount.
• Minimum accountable unit: The smallest currency unit that a tax amount
can have.
• Rounding rule: The method that is used to round off the calculated taxes
to the minimum accountable unit.
• Header: Applies rounding to calculated tax amounts once for each tax rate
per invoice.
• Line: Applies rounding to the calculated tax amount on each invoice line.
• Up: the amount is rounded to the next highest minimum accountable unit.
1. Looks for rounding details in the party tax profiles of the parties and
party sites involved in the transaction, according to the rounding
precedence hierarchy.
2. If an applicable tax profile is found then uses the rounding level and
rounding rule of the tax profile.
• City
tax:
7.5%
Example 2 represents the rounding details applied at the line level. Applying
these factors, the rounding process calculates the invoice amounts, all in USD
currency, as follows:
Document Amount Tax and Tax Tax Amount Step 1: Step 2: Line Tax Amount
Level Rate Not Rounding amounts Rounded
Rounded criteria is are added
applied at to obtain
the line level revised
header
amounts
Header 5579 • State • 395.8082 • 395.82 • 395.82
tax
• 418.425 • 418.44 • 418.44
• City tax
Line 1 1333 • State • 166.625 • 166.63 • 166.63
tax:
12.5% • 99.975 • 99.98 • 99.98
• City
tax:
7.5%
Line 2 1679 • State • 55.9107 • 55.92 • 55.92
tax
• 125.925 • 125.93 • 125.93
• City
tax:
7.5%
Line 3 2567 • State • 173.2725 • 173.27 • 173.27
tax
• 192.525 • 192.53 • 192.53
• City
tax:
7.5%
Taxes for purchase transactions are usually calculated by the supplier and
included in the invoice. The responsibility of collecting and remitting these taxes
to the authority lies with the supplier. However, in certain cases the supplier
does not have presence (nexus) or is not registered in the customer location.
Self-Assessment
Taxes need to be self-assessed by the purchasing organization when the supplier
is not registered in the ship-to or bill-to location of the transaction. This is the
recommended approach for defining and calculating self-assessed taxes. This is
driven based on the registration party used for the transaction.
Registration Party
In the context of a tax applicable to the transaction it is the party whose
registration needs to be considered. The tax registration party type default is
specified for the tax. As most of the taxes are assessed by the supplier, the default
is set to the ship-from or the bill-from location.
Supplier Tax Registration
You can define tax registration for the supplier, the supplier site, and for a
particular tax regime. If the tax registration varies by tax or tax jurisdiction,
define the registration at a granular level. If the supplier does not have presence
in a specific jurisdiction, there are two options for configuration. The first is to
create a tax registration record with the registration status as not registered. The
second option is not to define a registration record. If you follow the second
option, when you define the condition set, set the operator for the Registration
determining factor class to Is blank.
Registration Party of the First Party
Similar to the supplier registration, you can define the tax registration records for
a legal reporting unit tax profile. For the tax registration of the first party select
the Set as self-assessment (reverse charge) option. This option triggers self-
assessment of taxes when the registration party selected for the tax line is that of
the first party. Self-assessment is only applicable for Payables transactions. The
option on the first party registration does not impact Receivables transactions.
If the registration records are not created for the suppliers without registration,
create the condition set as follows:
Offset Taxes
Offset taxes is a backward compatible approach that is configured to self-assess
taxes. Configure offset taxes in addition to your regular taxes. Offset taxes carry
a negative rate and are calculated in the context of the regular tax. Where offset
taxes are applicable, the application creates two tax lines with one positive and
one negative amount. An offset tax record is a matching, duplicate record with
negative amounts that reduces or completely offsets the tax liability recorded in
the tax transaction. Use offset taxes when the tax requirement includes creating
an offset general ledger posting.
Reporting-Only Taxes
You can identify taxes for reporting purposes only. When these taxes are
applicable to the transactions, records are created in the tax repository entities.
However, invoice distributions are not created for these taxes. Therefore, there is
no impact to the payable amount, payment amount, and invoice accounting.
Use Taxes
Assigning use taxes to invoices, you create a record of the taxes you owe to tax
authorities. Oracle Fusion Payables does not create invoice distributions for these
taxes. Therefore, there is not any accounting impact due to these taxes. Payables
provides a Use Tax Liability Report to review and report use taxes.
Use the Use Tax Liability Report to review, report, and remit use taxes. The
report determines the use tax liability by each use tax code by taking the tax rate
you defined for each tax code and applying it to the sum of each invoice line
to which the tax applies. The report lists in summary or detail the total amount
of tax you owe for each tax code on invoices you enter between two dates you
specify when you submit the report. Oracle Fusion Payables displays the amount
of use tax you owe in the currency in which you entered an invoice.
Note
Use taxes are defined with the tax type of Use tax. The rest of the configuration
is the same as the other taxes. This feature is only supported for migrated taxes.
You cannot define a new tax with this tax type.
You can let a first party self-assess the taxes calculated on the Payables invoices
it receives. A self-assessed tax is a tax calculated and remitted for a transaction,
where tax was not levied by the supplier but is deemed as due (and therefore
needs to be paid by the purchaser). Taxes need to be self-assessed by the
purchasing organization when the supplier is not registered in the ship-to or bill-
to location of the transaction.
• Default registration party: Set the default values for the direct rule type of
Tax Registration. For self-assessed taxes set the value to Ship from or Bill
from.
• If the supplier is not registered then either you can create a registration
record for the tax regime, tax, or tax jurisdiction, with the registration
status of not registered. Or skip the step of defining tax registration and
define the tax condition set with the operator of Is blank.
If the supplier is not registered then the registration of the first party legal
reporting unit needs to be considered. To trigger this, you need to define a
tax registration rule with the following conditions:
• If you choose the option of not defining a supplier registration then the
condition set is as follows:
Set the rule result to bill-to party so that the registration of the legal
reporting unit is considered.
Tip
Instead of including the condition for the transaction input factor, you can
specify the event class constraint at the tax rule header.
• Self-assessing tax: For the first party registration record you create for
the tax regime, tax, and tax jurisdiction, check the Set as self-assessment
(reverse charge) option. Once the application selects this registration
record for the tax, the tax line is stamped as self-assessed.
Self-assessed taxes are not included in the invoice totals. Instead, the total of self-
assessed taxes for the invoice is displayed as a separate line in the tax charges
region of the invoice.
Self-assessed taxes are created for imported payables invoices. This happens
when imported transactions have tax lines along with transaction lines and
if you enable the Perform additional applicability for imported documents
option for the event class. For these transactions, additional taxes that are found
applicable are treated as self-assessed taxes.
These taxes are accounted along with the rest of the invoice. The accounting
treatment for expense and recovery remain the same as any supplier-assessed
taxes. The only variation is be the liability account. The tax amount is credited to
the tax liability account instead of the payables account.
Self-assessed taxes are a part of the standard tax reports. Apart from this, Oracle
Fusion Subledger Accounting provides reports for accounting activity that can
be used to track self-assessed tax liability. Use the Account Analysis Report and
the Open Account Balance Listing report to track this liability.
Note
When you select or deselect the Self-Assessed option on a tax line for the first
time, the update does not take effect. You must select the specific tax line, click
the row header or a noneditable area, and then select the Self-Assessed option.
Offset taxes are a backward compatible approach that you can configure to
self-assess taxes. Configure offset taxes in addition to the regular taxes. Offset
taxes carry a negative rate and are calculated in the context of the regular tax.
Where offset taxes are applicable, two tax lines are created with one positive and
one negative amount. An offset tax record is a matching, duplicate record with
negative amounts that reduces or completely offsets the tax liability recorded in
the tax transaction. Use offset taxes when the tax requirement includes creating
an offset general ledger posting.
You can identify taxes for reporting purposes only. When these taxes are
applicable to the transactions, records are created in the tax repository entities.
However, invoice distributions are not created for these taxes. Therefore, this
does not impact the payable amount, payment amount, and invoice accounting.
When does a party tax profile get created for a third party?
The third party tax profile is automatically created when a third party (customer
or supplier) with tax configuration is created. Edit the tax profile that was
automatically generated with the relevant tax information, but it is not required
for tax calculation. Otherwise, create a party tax profile using the Create Third
Party Tax Profile or Create Third Party Site Tax Profile pages.
What's the difference between using tax exemptions or tax rules to modify the
taxable nature of a transaction?
You can modify the taxable nature of a transaction using tax exemptions,
but you can also accomplish this through the use of tax rules. Use tax rules,
such as the Determine Tax Applicability rule, to exclude certain categories of
transactions from taxation. If you choose to implement tax rules to achieve your
tax exemption requirements, the impacted transactions do not appear on many
tax reports as they do not have any tax lines.
If you must report on a transaction then set up a tax exemption on the customer's
party tax profile which results in a tax line being created with the modified tax
rate. Use tax exemptions where certificates of exemption are issued for specific
customers, which is typical in tax regimes for US Sales and Use Tax.
You can create an exempt tax rate with a zero percentage rate as a method of
applying exemptions. This achieves many of the intended reporting objectives as
the application generates a tax line. Reports that specifically refer to an item as
exempt may exclude items with a zero percentage rate from that portion of the
report because the exempt indicator is blank.
If you define an exempt tax with a zero tax rate, the transaction shows as fully
taxable on all reports. If you want reports to show the full line amount as taxable
you cannot add any exemption details, such as exempt reason codes, as this
results in an exemption being created on the customer record and a zero taxable
amount on the reports.
• Define tax reporting types at a generic level, tax regime level, or tax level.
• Define the validation for the tax reporting type for tax reporting codes
to be added in terms of data type and a minimum and maximum length.
Data types include Date, Numeric value, Text, and Yes or no indicator.
• Use tax reporting codes you create under one tax reporting type across
various entities, such as tax, tax status, tax rate, party tax profiles, and
fiscal classifications. To use a tax reporting type for a particular entity,
associate that entity to the tax reporting type in the Reporting Type Uses
region on the Create Tax Reporting Type page.
There is no impact of the tax reporting type on tax calculation. The tax reporting
codes are used in the tax reports.
Tax configuration facilitates the association between various entities and tax
reporting codes. The entity details are stored as part of the tax repository. During
tax report generation necessary tax reporting codes are derived based on the
entities associated with the tax line. The functionality to include the reporting
type code is handled by the Tax Reporting Ledger.
The Fiscal Classification tax reporting type use defines tax reporting type codes
for association to the following classifications:
The Party Tax Profile tax reporting type use defines reporting type codes for
association to the following party tax profiles:
The Process Result tax reporting type use defines reporting type codes for
association to the following rule types:
Tax Reporting Types and Codes and Their Use in Tax Reporting
The following table describes key predefined tax reporting types and codes and
their association and use in tax reporting:
• Services
Legal Messages
A legal message specifying that the customer of such services must self-assess
the relevant tax, should be printed on Receivables (intra-EU services) invoices.
Create a Bill Presentment Architecture template to print the legal justification
message on the Receivables invoice. The exact text of the message is defined by
the country-specific legislation. The reporting code is also a selection parameter
to display the intra-EU services invoice lines on the European Union Sales
Listing report.
Configure these messages using the Create Tax Reporting Types page. Associate
these messages to invoices through the association to a tax rate definition and
a tax rule result. When defining these tax reporting codes the tax reporting
purpose is the Legal justification message type and the applicable reporting
type uses are Process Result and Tax Rate. Enter the legal justification text which
should be as defined by legislation.
The following table describes the defaults and controls available at the tax profile
options level.
The Tax Simulator is a tool for simulating the tax determination process in
your tax setup. The Tax Simulator lets you preview the workings of your
tax configuration before you perform tax calculations on live transactions in
a subledger application. The Tax Simulator also allows you to test new tax
configuration in conjunction with existing tax configuration to preview the
resulting tax calculation. The Tax Simulator is a useful tool to identify the root
cause when tax calculation is not what is expected on live data.
Run taxes from all applicable tax regimes against a sample transaction to verify
that your tax configuration and tax rules were created and applied according
If you want to test multiple variations of the same transaction you can query
the transaction with a source of Tax Simulator in the Manage Tax Simulator
Transactions page. Select the transaction in the search results and click the
Duplicate action to duplicate the transaction details into a new document
leaving the previous transaction details intact.
At the header level the Taxation Country is visible for entry and update. At
the line level you can enter and update attributes such as Line Class, Line
Type, Item, and Product Type. Additional tax attributes, such as Tax Inclusive,
Transaction Business Category, Assessable Value, Tax Classification, Product
Category, Intended Use, Product Fiscal Classification, User-Defined Fiscal
Classification, and Account, are organized in a tabbed region. All of these
attributes can drive tax determination or tax calculation directly based on
tax rules and tax formulas. Almost every additional tax attribute on the Tax
Simulator interface directly impacts tax determination and tax calculation in
a format that resembles the work areas so it is easy for you to understand and
navigate.
The following is a list of the available event classes and associations that can be
made in the Tax Simulator:
When you define a tax there are two different statuses the tax can have when the
setup is complete. When you select Enable tax for simulation the tax is available
only for processing on Tax Simulator transactions and is not calculated on live
transactions. When you select Enable tax for simulation and Enable tax for
transactions then the tax is considered active and is available for processing on
both live transactions and Tax Simulator transactions.
When you create a Tax simulator transaction and the evaluate taxes status is set
to:
• Enabled for simulation: Only taxes with the status Enable tax for
simulation are selected for processing.
• Enabled for transactions: Only taxes that are live or have both Enable tax
for simulation and Enable tax for transactions selected on the tax record
are considered for processing.
This mimics the behavior of the processing for active taxes in the
subledgers and is the default value when simulating or copying subledger
transactions in the Tax Simulator.
• Enabled for transactions and simulation: Both taxes that have a status of
Enable tax for simulation and taxes that have a status of Enable tax for
simulation and Enable tax for transactions selected are processed.
This allows you to see behavior of both active and not active taxes on the
same transaction. This is a useful tool when the calculation of one tax can
impact another such as in the case of compounding tax formulas for tax
calculation.
The first tax, FUS_CA, is defined for the sales tax for the state of California. The
tax status is set to Enable tax for simulation and Enable tax for transactions.
The second tax, FUS_ENV, is defined for an environmental tax. The tax status is
set to Enable tax for simulation.
Simulate a live transaction in the Tax Simulator with the Evaluate Taxes option
set to Enabled for transactions. In this case only taxes enabled for transactions
are processed so the FUS_CA is the only tax calculated.
Next, update the Evaluate Taxes option set to Enabled for simulation. In this
scenario only taxes that are enabled for simulation are processed so FUS_ENV is
the only tax calculated.
Finally, update the Evaluate Taxes option set to Enabled for transactions and
simulation. In this scenario both taxes enabled for simulation and enabled for
both simulation and transactions are selected so both FUS_CA and FUS_ENV are
calculated.
From the transaction tax details it might not be clearly evident as to which tax
rule from your defined tax setup got processed or if the calculated tax is the
result of the relevant rule condition. Using the Tax Simulator you can verify
the tax determination process breakdown, the details of the tax rules that are
evaluated for each rule type, and other key factors that are analyzed and applied
during the tax determination process. The Tax Simulator is a tool that allows
you to replicate the transaction details directly or as a copy from the source
transaction. The Tax Simulator provides a detailed analysis of the decision
criteria applied in the tax determination process, with reference to the defined
tax configuration and displays the corresponding results for each rule type.
The Tax Line Details page within the Tax Simulator captures and lists out the
following key process results that the tax determination process considers for
each tax applied on the transaction:
• The rule evaluation details for each rule type, such as:
• Rule result
This abstract gives you a snapshot of the key results returned from each tax
determination process step and provides pointers to validate it against the
available tax setup. You can modify the tax setup if the key result areas are not as
per the requirements.
The source attribute can have a value of Event class or Configuration owner
tax options. This indicates if the application derives the event class-specific
tax options from a configuration owner tax option that is defined for the
combination of configuration owner, event class, and date range or if the
application derives the options from the default predefined values for the
event class. These tax options include the option to calculate tax, the regime
determination set, options to allow manual entry and override, rounding
defaults, and details regarding tax calculation on referencing documents. If the
value is Event class then there are no configuration owner tax options defined
for this combination of configuration owner, event class, and date and the
• When the regime determination set is a value other than STCC (standard
tax classification code) it is a determining factor set of type regime
determination that includes transaction input factors of location types
to derive the owning country on the transaction for tax purposes. Tax
regimes that you defined for the derived country have taxes evaluated
for calculation. The predefined regime determination set is TAXREGIME
and this value always populates if the source is Event class. Use the drill
down to the regime determination set details to identify the precedence of
locations to determine the tax regime country.
• When the regime determination set is set to STCC, the additional tax
attribute of Tax Classification set at the Line Level Tax Attributes tab
drives tax calculation either directly or based on the Tax Classification
Based Direct Rate Rules.
For example, if your simulated transaction does not have any tax lines, check the
regime determination set value. If it is set to STCC and the Tax Classification
field on the Line Level Tax Attributes tab is blank, tax is not calculated. Review
your application tax options to verify that the defaulting hierarchy that specifies
both the sources to use for tax classification codes and the order in which the
application searches these sources to find a valid tax classification code at
transaction time.
For example, on the Rounding Level dialog box for a purchase invoice you see
the following:
The lowest level of 1 takes precedence over all other levels. The application uses,
the default precedence only if none of the other levels are populated. If the value
is blank then there is no attribute set at this level. If the you determine that in
this example the bill-from party tax profile rounding level of Header is incorrect
you can identify the bill-from party from the Tax Line Details header information
and query the appropriate party tax profile to modify the setup. This example
is simple in that the header level is the level used for rounding. If the value was
Line there is more derivation logic starting with the party type derived for the
Determine Tax Registration rule.
Use the Tax Line Details page to review the calculated tax lines with the
corresponding tax configuration details for each transaction line. Open the
Tax Line Details page by clicking the View Tax Lines button on the Simulator
Transaction pages from the Manage Simulator Transactions task.
Details include:
• Tax regime, tax, tax jurisdiction, tax status, tax rate code, and tax rate
• Indicators such as: inclusive, self-assessed, manually entered, and tax only
line
• Place of supply
For the tax lines associated with each transaction line, you can review the
attributes that are specific to each tax line, such as:
• Rounding rule
• Inclusive
Rounding Rule
The Rounding Rule dialog box shows the rounding details for the transaction
line. The rounding rule is the method used to round off taxes to the minimum
accountable unit. The rounding rule is derived based on the rounding level
specified in the hierarchy visible in the dialog box with level one taking
precedence over level 2 and so on. If the rounding level is at the header level
then rounding is applied to calculated tax amounts once for each tax rate per
invoice. If the rounding level is at the line level then rounding is applied to
calculated tax amounts on each invoice line.
Inclusive
The Inclusive dialog box shows the setup related to enforcing inclusiveness or
exclusiveness of tax on a transaction line by order of precedence. The level 0
precedence is the highest overriding all other values with the level 5 precedence
being the lowest or the default if none others are populated. The values are Yes
or blank with blank meaning an option was not selected for inclusive handling.
In the following table the original tax rate was 5 percent with an exemption
applied that reduced the tax rate to 2 percent.
Attribute Value
Tax Rate Name VAT 5%
Tax Rate Before Modification 5%
Exception Applied No
Tax Rate after Exception 5%
Exemption Applied Yes
Tax Rate after Exemption 2%
For the tax lines associated with each transaction line, you can review the tax
rule details that are specific to each tax line, such as:
Rule Results
Use the Rule Results table to view the tax rules that are applied to each tax line
for each tax calculation process. For each rule type, you can view the processed
result and verify whether the result was determined by a tax rule or the default
value.
For example, the following table shows the attributes displayed in the Rule
Results table:
Where a tax rule is applied, you can determine the associated tax rule from the
Rule Results table. In the previous example, the tax determination process uses
defaults to determine the place of supply and tax applicability. However, the tax
determination process determines the tax registration based on a tax rule. The
applicable tax rule code is REGRULE2.
Rule Conditions
By selecting the Determine Tax Registration row, you can review the rule
conditions that are successfully evaluated in the Determine Tax Registration:
Rule Conditions table. The following table shows the attributes displayed:
For example, if your transaction is calculating tax lines for a tax that should
not be applicable, review the Determine Tax Applicability rule values in the
Rule Results table for that tax line. If the Result Type is Default with a result
of Applicable, verify that you have a Determine Tax Applicability tax rule that
evaluates your transaction as not applicable.
• Not evaluated
For example, the Determine Tax Registration rule type may have 3 associated tax
rules as represented in the following table:
In this example, the tax rule with the highest rule order priority failed, while
the rule with the next highest rule order priority is successful. In this case of
3 associated tax rules, the tax determination process does not evaluate the
remaining tax rule.
For each rule in the Tax Rules Process Results table, you can also review the
following:
For each tax rule listed in the Tax Rules Process Results table, you can drill down
to the associated rule conditions to review the condition details.
For example, if your transaction is correctly using tax rules to calculate taxes
but is applying an incorrect tax rule, use the Tax Rules Process Results table to
review the rule order and the associated rule conditions for each tax rule.
The following scenario illustrates when you might want to use the Tax Simulator
to evaluate a Payables invoice where you expect tax to be calculated and it is not.
Scenario
If there is a transaction in the subledger work area that is not calculating tax you
can simulate this transaction in the Tax Simulator.
The transaction date in the Tax Simulator is updated to the system date so
modify the transaction date to the expected date of tax calculation.
• Document Date: Ensure that the document date is correct and that the
regime to rate setup and applicable tax rules are effective as of this date?
• Allow Tax Applicability: Ensure that this option is set to Yes for tax to
calculate. This is the value defined on the source value in the previous
attribute. There is another Allow Tax Applicability attribute in this region
that checks the value from the applicable party.
• Default Rounding Level: This does not impact tax calculation but
identifies the rounding derivation.
• Third party location: Determine if the third party locations are accurately
reflected. These attributes help identify locations on this transaction
that may influence regime determination and tax calculation based on
location. There may be other locations set at a line level that may impact
tax calculation as well.
• Allow Tax Applicability: Ensure that this option is set to Yes for tax to
calculate. This option is derived from the supplier, supplier site, third
party, and third party site tax profile depending on the event class. Tax
applicability must be set to Yes for all relevant party tax profiles in order
• Evaluate Taxes: Ensure the status of the tax you are expecting to calculate.
Is it Enabled for transactions, Enabled for simulation, or Enabled for
transactions and simulation? This identifies what status of taxes is
evaluated for calculating tax.
Create a simulated transaction when you want to control the testing of specific
transaction attributes or when you do not have transaction data available, such
as for a new tax regime.
What's the difference between taxes enabled for transactions and taxes enabled
for simulation?
On a tax record, you specify whether the tax is enabled for transactions,
simulation, or both. During testing, enable a tax for simulation to ensure the
setup is correct. When setup is complete and tested, enable the tax for actual
transaction tax processing.
When you create a simulator transaction, you can select which types of taxes to
evaluate for applicability: taxes enabled for simulation only, taxes enabled for
transactions only, or both.
Oracle Fusion Tax enables the integration with third party order-to-cash
transaction tax calculation applications.
Note
Oracle Fusion Tax provides a set of tax interfaces to enable tax service provider
agnostic integration. Tax service providers' application programming interfaces
(APIs) must conform to Oracle Fusion Tax interfaces.
Oracle Fusion Tax captures all transaction events into three API calls to the tax
service providers:
• Tax calculation: This API is used to calculate and recalculate transaction
taxes for manually entered and imported transactions.
• Tax synchronization: This API is used to update information in the tax
service provider repository for the transaction line attributes that do not
influence tax calculation, but are used in tax reports. Another use of this
API is to synchronize the tax service provider repository with the tax
amount overrides made in Oracle Fusion applications.
• Global document update: This API is used to handle certain transaction
level actions such as Delete, physically delete transaction lines and tax
lines, and Freeze for Tax, mark the transaction as ready to report.
The following graphic describes a typical tax calculation and recalculation and
the tax amount update flow for an Oracle Fusion Receivables transaction. This
graphic explains the interaction between Oracle Fusion Receivables, Oracle
Fusion Tax, and a tax service provider.
Complete the following configuration in Oracle Fusion Tax if you are using a tax
service provider to calculate taxes on order-to-cash transactions:
Component Action
Tax regime Create a tax regime for tax service provider services
to use for tax calculation.
• Tax exemptions
• Tax recovery
• Offset taxes
Important
Do not configure offset taxes, tax rate exceptions, and tax recovery when using a
tax service provider. You can optionally configure tax exemptions if using Vertex
Inc. Q-Series or ADP-Taxware SUT applications.
If your tax service provider leverages any other feature refer to your tax service
provider's documentation for explanation on its usage.
There are impacts to your business processes if you integrate with a tax service
provider. These impacts include:
• Monthly procedures
• Support procedures
Monthly Procedures
Each month tax service providers send an updated version of their data file. You
need to upload the data file into both the tax service provider system and Oracle
Fusion Tax. This ensures that Oracle Fusion Tax has the latest information for
address validation and tax jurisdiction code retrieval during tax calculation.
Exemption Handling
You can define your customer and product exemptions using a tax service
provider, Oracle Fusion Tax, or both. For exemptions set up in Oracle Fusion
Tax you can only use the exemption rate type of Discount or surcharge. The
exemption rate type of Special rate is not considered. At transaction time, if an
applicable Oracle Fusion Tax exemption or nonjurisdiction-based tax exception is
found, it is passed to the tax service provider application programming interface
and applied to the tax calculation. The tax service provider tax repository
includes the exempt tax line for complete audit and reconciliation. You can also
build your own logic to pass exemptions to the tax service provider.
Before completing your tax returns using the tax service provider reports,
you should reconcile the total tax amounts held in Oracle Fusion Tax, Oracle
Fusion General Ledger, and a tax service provider repository. All Receivables
transactions are stored in the tax service provider repository at the time of
tax calculation. Thus, the tax details in Oracle Fusion Tax and in a tax service
provider repository are always the same. The Receivables transactions are posted
to General Ledger only when they are completed and posted to General Ledger
from Oracle Fusion Subledger Accounting. Therefore, before reconciliation with
General Ledger, all transactions must be completed and posted to the General
Ledger.
Support Procedures
Begin with Oracle Fusion Tax error messages to review issues that arise with
tax calculation by tax service providers. The debug file contains details of the
transaction in error together with the error message.
Note
What happens if a value of a required attribute of a tax line is invalid for tax
service provider calculated tax lines?
Tax service provider calculated tax lines are validated before storing them in
the Oracle Fusion Tax repository. If the value of a required attribute of a tax line
is invalid but can be replaced by a default value, Oracle Fusion Tax inserts a
message in the debug log file. If a default value cannot be determined, Oracle
Fusion Tax raises an error along with inserting the cause of the error in the debug
log file.
• TAX_RATE_CODE: The application populates the record with the tax rate
code for the tax status code with no associated tax jurisdiction code.
Oracle Fusion Tax takes the default accounting code combinations for the tax
liability account in the following order:
You can ignore default accounting code combination values by defining the
subledger accounting rules to derive the accounting code combinations.
If you want to report project information with the same frequency as the
accounting periods, you can use the accounting period as both the accounting
and project accounting period.
When you maintain common accounting and project accounting periods, period
maintenance is simplified, calendar periods are not copied to Oracle Fusion
Projects, and period information is maintained in one physical location. Use
Oracle Fusion General Ledger to maintain accounting period statuses and run
the processes to open and close accounting periods.
Defining Project Accounting Periods that are Different from Accounting Periods
If you want to account for project transactions and report project information
more frequently than the accounting periods allow, you can define project
Use Oracle Fusion General Ledger to maintain accounting period statuses and
run the processes to open and close accounting periods, and Oracle Fusion
Projects to maintain project accounting period statuses and run the processes to
open and close project accounting periods.
Project accounting periods are used to track budgets and forecasts, summarize
project amounts for reporting, and track project status. Project accounting
periods are maintained by business unit. You can set up project accounting
periods to track project periods on a more frequent basis than accounting
periods. For example, you can define weekly project accounting periods and
monthly accounting periods. If you use the same calendar as your accounting
periods, the project accounting periods and accounting periods will be the same,
although the statuses are maintained independently.
Accounting periods, which are used to derive accounting dates, are maintained
by ledger and use the same calendar as the general ledger periods. Period
statuses for the accounting period and general ledger period are maintained
independently.
Note
You can select an option on the business unit definition to maintain common
accounting and project accounting periods. This option allows the accounting
period to be used as the project accounting period so you need to maintain only
one period status.
Complete these tasks to set up project accounting periods that are different from
accounting periods.
• Copy the accounting calendar into the project accounting period table,
which copies the period start and end dates.
No. You cannot change a project accounting period date range if the following
conditions exist:
You cannot enter any transactions in the period you have closed and you can
adjust transactions in subsequent periods.
Following are the expenditure categories, units of measure, and expenditure type
classes for each expenditure type shown in the diagram.
• Administrative
• Expenditure Category: Labor
• Unit of Measure: Hours
• Expenditure Type Class: Straight Time
• Clerical
• Expenditure Category: Labor
• Unit of Measure: Hours
• Expenditure Type Classes: Straight Time and Overtime
• Consulting
• Expenditure Category: Outside Services
• Unit of Measure: Currency
• Expenditure Type Classes: Supplier Invoices, Expense Reports, and
Usages
• Photo Processing
Miscellaneous Transactions
The miscellaneous transaction expenditure type class is used to allocate the
source amount as raw cost on the expenditure item.
Burden Transactions
The burden transactions expenditure type class is used to allocate the source
amount as the burden cost for the expenditure item, while expenditure item
quantity and raw cost remain zero.
Following are examples of other ways that you can use expenditure types:
• Specify default expenditure types for each resource class for different
project units. The application uses the default expenditure type for
planning purposes. For example, when determining the raw and
burdened cost rates for a planning resource, if the resource format does
not contain an expenditure type or nonlabor resource, then the application
uses the default expenditure type for the resource class of the resource to
determine the rates.
• Labor cost multipliers are used to calculate costs for overtime expenditure
items. Associate a labor cost multiplier to an expenditure type with the
Overtime expenditure type class. The costing process multiplies the
standard labor cost rate by the multiplier and the hours to calculate the
cost for overtime expenditure items.
• Unit of measure
• Rate required
• Proceeds of sale
• Assigned sets
Important
If you create and save an expenditure type, you cannot subsequently update the
following attributes for the expenditure type.
• Unit of measure
Instead, you must enter an end date for the expenditure type and create a new
one. The end date for an expenditure type has no effect on existing transactions.
Oracle Fusion Projects uses the old expenditure type to report on and process
existing transactions.
Unit Of Measure
The expenditure type unit of measure is used as the default value on costing or
planning transactions.
For inventory transactions, the primary unit of measure is from the inventory
item, and not from the expenditure type on the transaction.
You must use Hours as the unit of measure for labor expenditure types.
Enable the Rate Required option for an expenditure type that requires a cost
rate.
Note
For supplier invoice expenditure types, if you specify that a rate is required,
Oracle Fusion Projects requires you to enter a quantity in Oracle Fusion Payables
for invoice distributions using that expenditure type. When you interface the
invoice distribution to Oracle Fusion Projects, the application copies the quantity
and amount to the expenditure item and calculates the rate. If you define a
supplier invoice expenditure type with the Rate Required option disabled, then
the quantity of the expenditure item is set to the amount you enter in Oracle
Fusion Payables.
Enable the Proceeds of Sale option for expenditure types that are used to track
the proceeds of sale for a capital project.
Assigned Sets
You must assign at least one project transaction type set to each expenditure
type. You can add and delete set assignments for an expenditure type at any
time, except that you cannot delete the last set assignment for an expenditure
type.
You can update expenditure category names and descriptions at any time.
You cannot delete an expenditure category if it is used in transaction controls,
expenditure types, resource transaction attributes, or cost distribution
organization overrides. You can, however, stop usage of an expenditure category
by setting an end date for it.
Yes. For example, an expenditure with the expenditure type Materials can have
the expenditure type class Supplier Invoice if it originated in Oracle Fusion
Payables, and the expenditure type class Inventory if it originated in Oracle
Fusion Inventory. This allows you to use a single expenditure type to classify as
many costs as you need. You can use the same expenditure type for expenditures
with different origins, and therefore different accounting, that should otherwise
be grouped together for costing, budgeting, or summarization purposes.
Yes. When capturing retirement costs in a capital project, enter proceeds of sale
amounts using expenditure types specifically created for that purpose. Oracle
Fusion Projects automatically classifies amounts for all other expenditure types
associated with the retirement cost task as cost of removal.
You can update expenditure type names, descriptions, and dates at any time.
However, you cannot update the following attributes for the expenditure type:
You cannot delete an expenditure type and the associated expenditure type class.
To stop usage of an expenditure type you can set an end date for it.
• Class codes
• Project types
Enable this option if all projects must have a code assigned to this class category.
Do not enable if this class category is optional.
Enable this option if you want this class category to be required for projects of all
project types.
Note
Specify whether you want to allow entry of only one class code with this class
category for a project.
Note
Defining multiple class codes for one category for a project may affect reporting
by class category. For example, defining multiple class codes may cause a code to
be reported more than once.
Enter Class Codes Percent and Total Percent Must Equal 100
Enable this option if you want to associate percentages with the class codes
associated with this category. When you have multiple classification codes
associated with a single class category, you can report the relative values of your
projects in terms of sales or a similar metric. When you enable this option, the
application requires class code percentages for the category regardless of the
project type.
Enable the Total Percent Must Equal 100 option if you want the application to
require that the sum of all class code percentages to be 100% for the selected class
category. You can clear this option at any time.
Class Codes
You can define class codes for the category to create more specific groups of
projects for reporting. Assign each class code to a reference data set so that only
codes that are relevant to the project unit are available for the project.
Project Types
Class categories and class codes enable you to classify projects. The following
example illustrates how you can use project classifications.
Scenario
InFusion Corporation designs and implements heavy engineering projects for
government and private customers. Because InFusion Corporation maintains
a diverse portfolio of contracts, the ability to track sector and funding is very
important to corporate management.
Class Category Assign to All One Class Code Enter Percentage Description
Projects per Project for Class Codes
Market Sector Yes Yes No Market sector in
which project work
takes place.
The following table describes the class codes available for the categories
specified above.
InFusion management can easily assess projects based on the above class
categories and codes.
For example, assume you specify a class category Funding Source on your
project. With this category, you select two class codes: Private and Federal. If
you assign 30 percent to Private and 70 percent to Federal, then you indicate the
proportion of funding received for your project from the two sources.
On the other hand, because you must select a single market sector, you indicate
whether project work involves utilities, waste, mechanical, or structural
activities.
Tip
To use work types to determine whether an expenditure item is billable you
must set the profile option Work Type Derived for Expenditure Item to Yes.
• On track
• At risk
• In trouble
You can define additional project and progress statuses based on the available
system statuses to meet your business needs.
Status Attributes
Each status is associated with a status type and a system status. Optionally you
can specify status attributes for initial project status and workflow.
• System Status: Determines which actions are allowed for the project or
progress status. Every status must map to a predefined system status.
• Initial Project Status: If this option is enabled for a project status, and
if the project status belongs to a reference set that is associated with the
project unit of the project, then the status is eligible for use as the starting
status for the project.
• Status After Change Accepted: The status that the application assigns
to the project when a project status change is approved.
• Status After Change Rejected: The status that the application assigns
to the project when a project status change is rejected.
The project status after workflow is rejected can be the same as the
current status.
Assigned Sets
You assign project statuses to reference data sets so that only statuses that are
relevant to the project unit are available for the project.
Important
Before you can select a status for a project, the status must belong to a reference
data set that is associated with the project unit of the project.
For each project status with workflow enabled, you can also specify the
following parameters:
• The status that the application assigns to the project when a project status
change is accepted.
• The status that the application assigns to the project when a project status
change is rejected.
For example, assume that during implementation, you enable workflow for the
Submitted status, and configure the following workflow attributes:
• In the Status After Change Accepted field for the Submitted project
status, you specify the Approved status as the status that the application
assigns to the project when the status change is accepted.
• In the Status After Change Rejected field for the Submitted project status,
you specify the Rejected status as the status that the application assigns to
the project when the status change is rejected.
In this example, when a requester changes the project status to Submitted, the
workflow process routes the status change request to the project manager's
worklist. If the project manager accepts the status change, the workflow process
assigns the Approved status to the project. If the project manager rejects the
status change, the workflow process assigns the Rejected status to the project.
The following diagram shows an example project status flow when Project Status
Change workflow is used for status changes during the lifecycle of a project. In
this example, a requester changes the project status to Submitted. A workflow
notification is sent to the project manager, who accepts the status change.
Workflow is configured to change the project status to Approved after a request
to change the status to Submitted is accepted. After project completion, the
requester changes the project status to Pending Close. A workflow notification
is sent to the project manager, who accepts the status change. Workflow is
configured to change the project status to Close after a request to change the
status to Pending Close is accepted.
Use this client extension to specifying a status change approver other than
the project manager. By default, the project status change approver is the
active project manager.
Use this extension to add and modify the conditions that enable workflow
for project status changes.
Use this extension to build additional rules for changing a project status.
For example, you can enforce a rule that certain class categories and class
codes must be assigned to a project before you can change the project to
an Approved status.
Project managers
and accountants
can view planning
options at the
version level.
Create versions No Yes Yes None
Generate versions No Yes Yes Applies to budgets
generated when
setting a baseline
for the project plan.
Project
administrators
cannot generate
forecasts from
progress (they do
not have access to
publish progress.)
Edit versions in No Yes Yes None
Excel
Note
If workflow is
enabled, then
approval takes
place through a
notification. Menu
actions are not
available on the
budgeting and
forecasting pages.
Review versions No Yes Yes None
You associate an enterprise role with each project role. When you assign a project
role to a project team member, the associated enterprise role determines the
type of access the team member has to project information. For example, project
managers can manage project progress or create budgets and forecasts. Project
team members may only have access to view progress or financial plans.
When you create a project role, you assign it to one or more reference data sets so
that only project roles that are relevant to the project unit are available to assign
to project team members.
Important
Persons who are directly assigned enterprise roles such as Project Manager
or Project Application Administrator may have access to certain project
information even if they are not project team members or do not have a specific
project role assignment.
Job titles represent the function persons fulfill within an organization and their
position within a reporting hierarchy. For example, your organization may have
designations or job titles such as software developer, sales representative, or
accounts manager.
Each project team member is automatically assigned a project space role on the
associated project space. The project manager is assigned the role of project space
moderator. All other team members are project space participants.
How can I perform other space tasks, such as unsubscribe or view members?
You must navigate to the space and log on to Oracle WebCenter Spaces to access
the tasks. For more information, see Oracle Fusion Middleware User's Guide for
Oracle WebCenter.
Mapping Jobs
You map jobs from two job sets through an intermediate job set. That is, you
must map jobs in your human resource jobs sets to jobs from an intermediate set
of jobs. You then map the jobs in the intermediate job set to jobs in your project
job sets.
For each combination of From Job Set, Intermediate Job Set, and To Job
Set, you manually associate the intermediate job to the to job only once. For
subsequent mappings, the to job is displayed automatically when you select the
intermediate job and cannot be modified.
For example, and as illustrated in the following diagram, assume you want
to map jobs from Human Resources Job Set to Projects Job Set through an
intermediate job set called Master Job Set. Within the Human Resources Job Set,
you want to map jobs Construction Worker and Forklift Operator to a single job
called Laborer in the Projects Job set.
You first select Construction Worker as the from job, Master Laborer as the
intermediate job, and Laborer as the to job. The intermediate job Master Laborer
After you map the jobs, you can use the single job Laborer for project
management purposes.
Scenario
InFusion Corporation is a global enterprise with business units in the United
States and France. The following table lists sample job titles in those two
countries.
Staff Consultant
Senior Consultant
Design Engineer
Electrical Engineer
Construction Worker
France Job Set Chef de Projet
Ingenieur Formateur
Architecte
Ouvrier
Job in From Job Set Job in Intermediate Job Set Job in To Job Set
Manager Master Project Manager Project Manager
Staff Consultant Master Consultant Consultant
Senior Consultant Master Consultant Consultant
Design Engineer Master Architect Architect
Electrical Engineer Master Architect Architect
Construction Worker Master Laborer Laborer
Job in From Job Set Job in Intermediate Job Set Job in To Job Set
Chef de Projet Master Project Manager Project Manager
Engenieur Formateur Master Consultant Consultant
Architecte Master Architect Architect
Ouvrier Master Laborer Laborer
InFusion Corporation associates the Global job set to its planning resource
breakdown structures. Therefore, jobs such as Project Manager and Laborer
are available for creating planning resources. In addition, the Global job set is
used to define rates that can are then used for costing, invoicing, and financial
planning.
You map jobs from two job sets through an intermediate job set. That is, you
must map jobs in your human resource jobs sets to jobs from an intermediate set
An organizational partition of jobs. Use job sets to define how you create and
use jobs in your business. You can define a single set of jobs and use them across
your business. Alternatively, you can create separate job sets for each country or
line of business.
For example, assume that the set of jobs your business uses for project
management is less granular than that used to define human resource jobs for
employees. You can define generic jobs for your project job set and map it to the
human resource job sets. Associating the project job set with planning, reporting,
and billing resource breakdown structures then ensures appropriate project
reporting, costing, invoicing, and revenue generation.
Resource Classes
Resource classes influence the creation of planning and billing resources in the
following ways:
• Resource class as a resource format: As mentioned earlier, Resource
Class is a resource type that is available for use within resource format
hierarchies on planning and billing resource breakdown structures.
• Predefined association with resource formats: For each resource format,
you can create planning or billing resources based on certain resource
classes. For example, if the resource format contains Job, then the only
available resource class is Labor. However, if the resource format is
Expenditure Category, then you can select any of the resource classes
(Labor, Material, Equipment, and Financial Resources) when you create a
resource.
Attribute Description
Spread curve Determines how planned amounts for a planning
resource are spread across the duration of the project
or financial plan.
You can change the spread curve that you select for a
resource class at the planning resource level and for
any corresponding task assignments, or budget or
forecast lines.
Item master and category set Determine the material item and item category lists
used in planned transactions and planning, billing,
and reporting resource breakdown structures.
Expenditure types Determine default raw and burdened rates for a
planning resource. For example, if the resource
format does not contain an expenditure type or
nonlabor resource, then the application uses the
default expenditure type for the resource class of the
resource to determine the rates.
Note
Markup percentage takes precedence for amount-based transactions where the
unit of measure is Currency.
You specify a resource class rate schedule in the planning options for a financial
or project plan type, project plan, or financial plan version as the source for
rates or markup percentages, unless they are available elsewhere. For example,
assume you are using actual rates on your financial plan version. If one of the
planning resources is an expenditure category, then resource class rate schedules
are used to derive rates for that resource because actual rates are not maintained
for expenditure categories.
Note
This rule applies to cost transactions only. For billing and planning transactions,
you can either not use a nonlabor resource organization, or map the nonlabor
resource organization to the organization that maintains the rate schedule.
4. If a cost rate does not exist for the combination of expenditure type and
nonlabor resource, then the application uses then the applications uses the
cost rate defined for the expenditure type.
Scenario
You are asked to set up nonlabor resources and assign them to the appropriate
organizations for the InFusion Corporation.
Analysis
To define a nonlabor resource, you specify a name and description of each asset,
such as a piece of equipment or pool of assets, and a date range during which the
resource can be used.
For each nonlabor resource, you must choose an expenditure type with the
Usage expenditure type class. Every usage item that you charge to a project must
specify the nonlabor resource utilized and the nonlabor resource organization
that owns the resource. You can select organizations that are classified as project
and task owning organizations or project expenditure organizations.
A nonlabor resource may be a piece of equipment with capacity that is
consumed, such as a training room, or equipment with physical output that is
consumed, such as a copier. Enable the Equipment resource class to plan and
report nonlabor resources as equipment with capacity that is consumed.
The following table shows the nonlabor resources for InFusion Corporation.
Information
Services
Risk Analysis
HQ SPARC T3-1 Headquarters Computer Not enabled January 1, 2011 Information
Server Sparc Enterprise Services Services
Server
Oracle Exadata Data Systems Computer Not enabled January 1, 2011 Data Systems
Storage Server Oracle Storage Services
Server
West
Midwest
East
South
International
Minivan Site Visit Vehicle Not enabled August 1, 2011 InFusion
Minivan Construction
West
Midwest
East
South
International
Pickup Truck Heavy Duty Vehicle Not enabled January 1, 2011 West
Pickup Truck
Midwest
East
Other Asset Other Asset Other Assets Not enabled January 1, 2011 Administration
InFusion
Construction
InFusion
Engineering
InFusion
Services
Note
• To define nonlabor resources, you can choose only expenditure types that
belong to the Usages expenditure type class.
Note
• Every usage item that you charge to a project must specify the nonlabor
resource utilized and the nonlabor resource organization to which the
resource is assigned.
Schedule types determine usage for rates within rate schedules. You specify
a schedule type for rate schedules created for costing, billing, or planning
purposes in Oracle Fusion Projects.
• Job
• Person
• Nonlabor
• Resource class
Job
Job rate schedules contain rates used to calculate amounts for the following
types of labor transactions:
• Costing
• Planning
• Budgeting
• Forecasting
• Transfer price
The rate is based on the standard hourly rate assigned to a job title in Oracle
Fusion Human Capital Management.
If you are using planning rates for financial or project planning, you can select
a specific job rate schedule when configuring rate settings at the plan type or
Project Foundation Configuration: Define Rate Schedules and Costing Rules 23-1
project level. Job rate schedules are used if rates cannot be derived from the
person labor rate schedule.
When creating a job schedule type, you must select a job set from Oracle Fusion
Human Capital Management. The job set is the source of jobs in your rate
schedule. Assign rates or markup percentages to jobs in the rate schedule.
Person
Person schedules contain raw cost rates and billing rates or markup percentages
for labor transactions and transfer price amounts. The rate that calculates the cost
or billing amount for a project transaction is based on the standard hourly rate
or markup percentage assigned to a person, or the job or organization assigned
to the person in the schedule. The job or organization is based on the person's
assignment in Oracle Fusion Human Capital Management.
• Person
If you assign a rate to a person and job combination, that rate has precedence
over the person rate. If you assign a rate to a person, job and organization
combination, that rate has precedence over the person rate or person and job
combination.
If you are using planning rates for financial or project planning, you can select a
specific person rate schedule when configuring rate settings at the plan type or
project level. Person rate schedules are used if rates cannot be derived from the
labor rate schedule.
Nonlabor
Enter a rate or markup percentage for expenditure types with the Rate Required
option enabled. Otherwise, assign it only a markup percentage. Assign rates
to nonlabor resources and optionally define rates for nonlabor resource
organizations.
If you are using planning rates for financial or project planning, you can select a
specific nonlabor rate schedule when configuring rate settings at the plan type or
project level.
Resource Class
Enter a rate or markup percentage for each resource class in the rate schedule.
Optionally, assign the rate or markup percentage to a specific organization for a
resource class.
Oracle Fusion Projects uses cost rates to calculate the raw cost for expenditure
items. The application determines a cost rate for each expenditure item and
calculates the raw cost during cost distribution processing, unless you import the
raw cost for expenditure items.
Project Foundation Configuration: Define Rate Schedules and Costing Rules 23-3
organization of the expenditure organization, and continues up the
project expenditure organization hierarchy until a rule is found.
Oracle Fusion Projects applies the costing rule to determine the cost rate for the
expenditure item. You can associate either a rate schedule, or a Labor Costing
extension with an organization labor costing rule, to determine the cost rate.
A labor costing rule determines how an employee is paid. For example, you
can define a labor costing rule for pay types such as exempt, nonexempt,
uncompensated, compensated, and hourly.
• Costing method
Costing Method
For labor costing rules with the Rates costing method, labor costs are calculated
for entered hours using hourly cost rates.
For labor costing rules with the Extension costing method, labor costs are
calculated by the Labor Costing extension. When you use the Extension costing
method, you are not required to maintain hourly cost rates in Oracle Fusion
Projects.
If overtime hours are calculated using the Overtime Calculation extension, you
can specify the default expenditure types for the overtime expenditure items
generated by the extension.
This example illustrates setting up labor costing rules to calculate overtime labor
costs.
Scenario
You are asked to set up labor costing rules to calculate overtime labor costs for
nonexempt and hourly employees for the InFusion Corporation.
Overtime Costs
InFusion Corporation uses the Overtime Calculation extension to calculate
overtime hours for nonexempt employees. All overtime premium costs for
nonexempt employees are charged to an indirect project.
Hourly employees are required to enter overtime hours manually. All labor costs,
including overtime premiums, are charged to the project and task indicated on
the timecard.
Analysis
For nonexempt employees, the expenditure types for overtime transactions
created using the Overtime Calculation extension are derived from the overtime
labor cost multipliers that are assigned to the labor costing rule.
Project Foundation Configuration: Define Rate Schedules and Costing Rules 23-5
The following table shows the overtime labor cost multipliers that are associated
with the labor costing rules:
Oracle Fusion Projects then multiplies the overtime premium labor cost rate by
the number of overtime hours that an employee works to calculate the overtime
premium for the employee. This is represented by the formula: overtime
premium labor cost rate * overtime hours = overtime premium.
The following table shows examples of labor cost multipliers for double time,
time and a half, and uncompensated overtime. The negative multiplier for
uncompensated overtime reverses the cost of any overtime hours for the
individuals who do not get paid overtime.
Following are the key implementation concepts for setting up labor costing
overrides:
You specify the labor costing override for a person, or for a more granular
override, specify a combination of person and job, or person, job, and
organization.
The job and organization represent the human resources job and organization of
the person. The jobs that you can select to associate with a labor costing override
are based on the person value. The organizations that you can select are based on
the job value. When you select a job, an organization is automatically selected by
default. The default organization value is based on the selected job assignment.
You can accept the default organization for the labor costing override, select a
different organization that is associated with the job and person, or remove the
organization so the labor costing override is for person and job combination.
In the example shown in the following table, a person is assigned the Nurse
job in two different organizations. When you select Nurse to create a labor
costing override, the application automatically selects the default organization
General Hospital. You can accept the General Hospital default organization,
or change the selection to the University Hospital organization, to create an
override for the person, job, and organization combination. Alternatively, you
can remove the organization value to create an override for the person, job, and
any organization.
When you use a labor costing override, an override rate, rate schedule, or
extension takes precedence over a standard rate schedule for the business unit.
When you select a labor costing rule for the override, if the costing method of the
rule is Extension, then the override type is Extension by default. If you do not
select a labor costing rule, you cannot select an override type of Extension.
You can set up labor costing overrides for people with a start date in the future
if you enable the People with Future Effective Start Dates as Project Members
Project Foundation Configuration: Define Rate Schedules and Costing Rules 23-7
Allowed profile option. You can set up labor costing overrides for people with
terminated assignments if you enable the Number of Days to Display People
with Terminated Assignments profile option.
Use organization costing rules to assign labor costing rules, labor cost rate
schedules, and nonlabor cost rate schedules, to business units or specific
expenditure organizations. The schedule type on the organization costing
rule determines if a labor cost rate schedule or nonlabor cost rate schedule is
assigned.
• Schedule type
Schedule Type
Use the Labor schedule type to use labor cost rate schedules to calculate costs for
labor transactions such as timecards. If you select a schedule type of Labor, you
must enter a labor costing rule.
Use the Nonlabor schedule type to use nonlabor cost rate schedules to calculate
costs for nonlabor transactions such as miscellaneous or usage transactions.
If the plan type is configured to use actual rates, the pricing engine also uses
these rates for planning, budgeting, and forecasting transactions.
The labor costing rules and cost rate schedules that you assign to an organization
apply to all employees in the organization.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Parameters
Project Foundation Configuration: Define Rate Schedules and Costing Rules 23-9
In the following table is information about parameters for this extension:
You can use Labor Costing Extensions to implement unique costing methods
other than the standard method, which calculates raw cost using the number of
hours multiplied by the employee's hourly cost rate. For example, you may want
to calculate the raw cost using a capped labor rate for specific employees.
The sample business rules in the extension calculate overtime costs and charge
them to an indirect project other than the project where the labor is charged.
Note
If you want to charge overtime to the project where the labor is charged, consider
creating items using the Related Transaction Extension.
The sample business rules in the Overtime Calculation Extension follows these
steps to process overtime:
• Creates overtime expenditure items for each type of overtime for which
the employee is eligible. The overtime item is charged to the overtime
Project Foundation Configuration: Define Rate Schedules and Costing Rules 23-11
project and appropriate overtime task that is specified in the Overtime
Calculation Extension using the overtime expenditure type defined for the
employee's labor costing rule. The expenditure item date is set to the week
ending date.
The extension uses the same batch name as the source straight time
expenditure items to create the new overtime expenditure items.
The new overtime items are costed after the Overtime Calculation Extension
completes, within the Costing stage in the Import and Process Cost Transactions
process.
If you charge overtime costs to a project, you can use Oracle Fusion Projects
to record the cost premium that you pay for overtime. Your business can then
recover overtime costs with higher bill rates or higher overhead rates.
You can set up Oracle Fusion Projects to calculate overtime hours and charge the
hours to your overtime project using one of the following methods:
• Costing Method
When you charge overtime to the project on which overtime was worked, you
can track all overtime costs on one expenditure item. Oracle Fusion Projects
Project Foundation Configuration: Define Labor Costing Business Unit Options 24-1
uses the following formula to calculate the overtime premium cost: (Overtime
Hours * Hourly Cost Rate) + (Overtime Hours * Hourly Cost Rate * Labor
Cost Multiplier).
Note
To charge overtime to the project where the labor is charged, consider creating
overtime expenditure items using the Related Transaction Extension.
If you use both the Overtime Calculation Extension and Related Transaction
Extension, then you must define conditions in both extensions so that each
transaction is processed by only one of the extensions.
Important
Oracle Fusion Projects uses the following formula to calculate the overtime
premium cost rate: Labor Cost Rate * Labor Cost Multiplier = Overtime
Premium Labor Cost Rate. The application then multiplies the overtime premium
labor cost rate by the number of overtime hours a person works to calculate the
overtime premium for that person, as shown in this formula: Overtime Premium
Labor Cost Rate * Overtime Hours = Overtime Premium Cost.
A person's total labor cost is the overtime premium cost plus the total number
of hours that the person worked multiplied by the person's labor cost rate, as
shown in this formula: Overtime Premium Cost + (Total Hours * Labor Cost
Rate) = Total Labor Cost.
For example, assume that a person worked 10 hours of overtime at a rate of time
and a half. The labor cost multiplier is 0.5, and the person's labor cost rate is
$40.00. Oracle Fusion Projects calculates the person's total labor cost as follows:
• $40.00 * 0.5 = $20.00 per hour Overtime Premium Labor Cost Rate
You specify the default overtime project and overtime task in the labor costing
rule to be used for the overtime expenditure items that are generated by the
Overtime Calculation Extension.
For each overtime project, you must define a task for each type of overtime your
business uses. Examples of task names are Time and Half, Double Time, and
Uncompensated Overtime.
If you use more than one project to hold overtime costs and you use the
Overtime Calculation Extension to create overtime transactions automatically,
you must include the logic in the extension to charge the overtime hours to
the appropriate overtime project. You must also include logic in the Overtime
Calculation Extension to charge overtime hours to the appropriate overtime task.
Project Foundation Configuration: Define Labor Costing Business Unit Options 24-3
24-4 Oracle Fusion Applications Project Financial Management Implementation Guide
25
Project Foundation Configuration: Define
Project Resource Breakdown Structures
Before you can set up resource breakdown structures, you must set up the
following:
Important
If resource changes are not allowed at the project level, then all projects
with the same planning resource breakdown structure share the same set of
resources, and it is not possible to define additional resources in the context of
an individual project. For example, new resources and resource formats that are
Resource Formats
You select resource formats to add to the planning resource breakdown structure.
Planning resource breakdown structures can have resource formats with up to
three hierarchical levels of resource types, as shown in the following example:
• Organization
• Expenditure category
• Named person
If you select a child resource format, the application automatically selects
the parent. For example, if you select the resource format of organization-
expenditure category-named person, the application automatically selects the
organization-expenditure category format and expenditure category format.
The resource breakdown structure consists of one or more hierarchies of
resource elements. An element is a resource type, such as an organization or
job, or a combination of resource type and specified resource, such as the job of
consultant or a person named Amy Marlin.
The following diagram shows examples of hierarchical levels of resource
elements:
For example, assume that your resource breakdown structure has a resource
format with three hierarchical levels. The top level is organization, the second
level is expenditure category, and the third level is named person. You can add
an organization resource to the first level, an expenditure category resource to
the second level, and a named person to the third level. Alternatively, you may
add a named person to the third level only, and not add planning resources to
the first two levels.
After you add planning resources to the resource breakdown structure, you
can preview actual transaction associations to find out where actual transaction
amounts would be mapped in the project plan, budget, or forecast.
You update the resource mappings with these planning resources for the
planning resource breakdown structures that are used on the project plan and
in project forecasts. When you update the mappings, the project performance
reporting data are synchronized with the planning resource breakdown
structure.
You need only a single level billing resource breakdown structures to create
billing controls.
You cannot create or delete these billing resource breakdown structures. You can
edit the resource formats and specify the associated billing resources to meet the
needs of your enterprise.
The resources you can create for planning and billing resource breakdown
structures are determined by a combination of predefined resource classes and
the resource format hierarchies you select for use.
For example, for planning resource breakdown structures used for high-level
or preliminary planning, you may decide to enable only the Resource Class
resource format. You can then create and use planning resources representing
the four resource classes: Labor, Equipment, Material Items, and Financial
Resources.
To plan in greater detail, you may decide to use a two-level resource format
hierarchy, such as Resource Class: Job or a three-level hierarchy such as
Resource Class: Job: Named Person. You can then create a resource such as
Labor: Electrical Engineer or Labor: Electrical Engineer: Chris Black.
Note
Resource Classes
Resource classes influence the creation of planning and billing resources in the
following ways:
Resource Types
Resource formats are created based on the following predefined resource types.
Name Description
Named Person Employee or a contingent worker who performs
services for the deploying enterprise.
Event Type Implementation-defined classification of events
that determines the revenue and invoice effect of an
event.
Expenditure Category Implementation-defined grouping of expenditure
types by type of cost.
Expenditure Type Classification of cost assigned to each expenditure
item. Expenditure types are grouped into cost
groups (expenditure categories) and revenue groups
(revenue categories).
Item Category Categorization of inventory items that is used to
track the aggregate consumption of material.
Inventory Item An item that can be purchased or produced, and for
which you can budget and track the costs associated
with the consumption of the item.
Job A set of duties to which an employee can be
assigned.
Organization Divisions, groups, cost centers, or other
organizational units within a company.
System Person Type Distinguishes employees and contingent workers.
For example, assume that a project requires 100
hours of labor effort and you have resources only
for 80 hours. You can plan 80 hours of employee
time and 20 hours of contingent worker time on the
project.
Project Nonlabor Resource Implementation-defined asset or pool of assets.
An asset may represent actual pieces of equipment
whose time is consumed, or an asset whose output is
consumed.
Resource Class Higher-level grouping of planning resources, into
labor, equipment, material items, and financial
resources, that drives how resources are used.
Revenue Category Implementation-defined grouping of expenditure
types by type of revenue.
The resource formats and resource format hierarchy determine how planning
amounts roll up and are displayed when you view financial and project plans by
resource structure. Thus, each resource format hierarchy represents a separate
structure. For example, the resource format hierarchies Job: Expenditure Type:
Organization and Organization: Expenditure Type: Job are distinct.
• You can update resource mappings after you change resource formats or
add resources, and save the resource breakdown structure.
• Baseline project plan values are not affected by the Update Mapping
process.
• The Update Mapping process applies only if you do not allow resource
changes at the project level.
Tip
If you allow resource changes at the project level, use the Update Actual
Amounts action on the project plan to update the actual amounts for all tasks
on the project plan. Use the process monitor to start the process to summarize
project performance data for reporting.
Oracle Fusion Projects uses the following rules to associate cost amounts with
resources:
• If there is only one level to which the transaction maps, the cost
amounts are mapped to that level.
• If the transaction maps to more than one level, Oracle Fusion Projects
sums the precedence numbers for all resource types in the branch, and
gives precedence to the resource element in the branch with the lowest
sum.
• If more than one branch has the lowest precedence number at the lower
level, the application uses the precedence number of the next level up.
• If the sum of precedence numbers is the same for more than one branch,
precedence is given to the branch with the lowest number at the lowest
level.
Note
Oracle Fusion Projects gives more precedence to a lower precedence number. For
example, a resource element with a precedence number of 1 is given precedence
over a resource element with a precedence number of 10.
In this example, a time card transaction for a principle consultant who incurs
travel expenses maps to two branches.
• The first branch consists of two levels (1-Person Type: Employee and 1.1-
Job: Principle Consultant). The highest level has a precedence number of
14, and the lowest level has a precedence number of 6, for a sum of 20 for
the branch
The transaction cost amount is mapped to the Job: Principle Consultant resource
element because it has the lowest number (6) at the lowest level.
No. Oracle Fusion Projects provides a set of predefined resource formats. You
select resource formats as the basis for adding resources to planning and billing
resource breakdown structures.
No. You cannot create billing resource breakdown structures. However, you
can add billing resources to the two predefined billing resource breakdown
structures, Control Billing and Control Intercompany Billing, as required.
If you change the value of a resource type used in a resource combination, you
must run the Refresh Resource Breakdown Structure Element Names process
Versions
Cost Allocations
Enable the Use For Allocations option if you want to allocate costs with this
reporting resource breakdown structure.
Burdening provides a buildup of raw and burden costs to represent the total
cost of doing business accurately. You can calculate burdened costs as a buildup
of costs using a precedence of multipliers. Taking the raw cost, Oracle Fusion
Project Costing performs a buildup of burden costs on raw costs to provide a
true representation of costs. Using burdening, you can perform internal costing,
revenue accrual, and billing for any type of burdened costs that your company
applies to raw costs.
The following is a diagram of the burden cost calculation process and its
explanation:
Note
The order of the burden cost codes has no effect on the total burdened cost with
either additive or precedence burden structures.
Note
Oracle Fusion Projects predefines the cost base types Burden Cost and Other.
Note
Ensure that the expenditure types that you assign to burden cost codes are
assigned to the reference data sets for each project unit that will own projects
receiving summarized burden transactions.
The following table shows burden cost codes that represent distinct types of
burden to apply to raw costs.
FAQs for Manage Burden Cost Base Types, Bases, and Codes
What's a cost base type?
Identifies whether the burden cost base is used for burden cost calculations
or grouping expenditure items for different purposes. Oracle Fusion Projects
provides two predefined cost base types: Burden Cost and Other. Cost bases
with the type Burden Cost are used in burden calculations. Cost bases with a
type other than Burden Cost are not included in burden calculations; these cost
bases are used for grouping expenditure types for different purposes, such as for
billing extension calculations.
When do I create burden cost codes?
Before you create burden cost codes, you define an expenditure type for burden
cost codes that will be processed as separate, summarized burden transactions.
The expenditure type assigned to a burden cost code must be classified as a
burden transaction and belong to the reference data set for the project unit.
After you create burden cost codes, you can add it to a burden structure and
specify what cost base it is applied to, the expenditure types it is associated with,
and the order in which it is applied to raw costs within the cost base.
Manage Burden Structures
The following table shows the multipliers that are used to calculate burden
costs for raw costs in the Labor, Material, and Expense cost bases. This is an
additive burden structure that applies each burden cost code to the raw costs in
the appropriate cost base.
Note
Multipliers are defined on the burden schedule.
The following diagram shows the resulting burdened costs for labor, material,
and expenses.
Note
Important
Run this process after you create the organization and before you charge
transactions using this organization as the expenditure organization.
Run this process for the parent organization before you run it for the child
organization.
If the new organization requires multipliers that are different than the
multipliers assigned to the parent organization, you can manually add
multipliers for each burden cost code on the burden schedule versions, and then
rebuild the versions.
Note
A burden schedule can have multiple versions. The Burden Cost Calculation
Required button is available for selection on the burden schedule if at least one
version requires recalculation.
After the impacted transactions are marked for burden cost recalculation, the
Recalculate Burden Cost Amounts process starts the Import and Process Cost
Transactions process to create expenditure items and cost distribution lines for
the transactions.
If burden cost recalculation is still required after the Recalculate Burden Cost
Amounts process completes, then review the process execution report to
determine why the process did not mark eligible transactions for recalculation.
Burden Cost Recalculation is Not Required
Burden cost recalculation is not required in the following situations:
• All burden schedule versions for the build are in a new status.
• Changes are made to burden schedule versions prior to the build.
• The Recalculate Burden Cost Amounts process is complete and
all impacted transactions are successfully marked for burden cost
recalculation.
If burden cost recalculation is not required, the Recalculate Burden Cost
Amounts button is not available for selection on the burden schedule.
Note
What's the difference between a firm burden schedule and a provisional burden
schedule?
Use firm burden schedules if you do not expect your burden multipliers to
change. Firm schedules are typically used for internal costing or commercial
billing schedules. Firm burden schedules can have multiple versions, but never
more than one version for an effective date range.
Use provisional multipliers if you do not know the burden multipliers at the
time that you are calculating total burdened costs. Provisional multipliers are
typically estimates based on the annual forecast budget. When you determine
the actual multipliers to apply to raw costs, then you replace the provisional
multipliers with the actual multipliers. Oracle Fusion Project Costing processes
the adjustments from provisional to actual changes for costing, revenue, and
billing.
Note
The actual burden schedule version, when created, is automatically placed
on hold. You must remove the hold prior to building the actual rates and
recalculating costs.
You specify the following options when setting up burdening options for project
types.
• Default Cost Burden Schedule
• Allow Cost Burden Schedule Change for Projects and Tasks
• Include Burden Cost on Same Expenditure Item
• Create Expenditure Items for Burden Cost Components
• Create Separate Expenditure Item for Burden Cost
• Create Burden Cost Accounting Journal Entries
• Create Burdened Cost Accounting Journal Entries
Default Cost Burden Schedule
If you enable burdening for the project type, you must select the burden
schedule to use as the default cost burden schedule for projects that are defined
with this project type.
Allow Cost Burden Schedule Change for Projects and Tasks
Enable this option to allow a change of the default cost burden schedule when
entering and maintaining projects and tasks. Do not enable this option if you
want all projects of a project type to use the same schedule for internal costing.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Note
The extension is not called when calculating revenue and invoice amounts or
when calculating rates for the Oracle Fusion Project Integration Gateway or
Oracle Fusion Projects Integration for Microsoft Project.
The API details for the extension component, Function, are as follows:
• API Name: Is_client_extn_implemented
• API Type: Function
• API Purpose: Indicates whether Burden Cost Calculation Override
Extension is enabled or not.
• Parameters: None
• Return Values:
• Y indicates that the client extension is enabled.
• N indicates that the client extension is not enabled. This is the default
value hard coded in the function.
The API details for the extension component, Procedure, are as follows:
• API Name: Override_burden_cost
• API Type: Procedure
• API Purpose: Allow you to override the calculated burden cost amounts
in PJF_BURDEN_RATE_EXTN table.
• Parameters
• TEST-EXP: The
extension is called
for an expenditure
item in View
Burden Cost
Details window.
• TEST-STANDARD:
The extension
is called from
Test Burden Cost
Calculations Page.
• TEST-BUDGET:
The extension is
called for project
plan, budget
and forecast in
View Burden Cost
Details window.
• BUDGET-
PROCESS: The
extension is called
during burdened
cost calculation
in project plan,
budget and
forecast.
• IMPORT-
PROCESS: The
extension is called
during burdened
cost calculation
for expenditure
items that have
burdening on the
same line.
• BURDEN-
PROCESS: The
extension is called
when Generate
Summarized
Burden
Transactions
process is
run to create
separate burden
expenditure item
lines.
Note
To implement the extension, modify the function to enable the extension and
modify the procedure to override the burden amounts. Do not change the name
of the extension procedures or parameters. Also, do not change the parameter
types or parameter order in your procedure. After you write or implement a
written procedure, compile it and store it in the database.
You specify the following options when setting up burdening options for project
types.
If you enable burdening for the project type, you must select the burden
schedule to use as the default cost burden schedule for projects that are defined
with this project type.
Enable this option to allow a change of the default cost burden schedule when
entering and maintaining projects and tasks. Do not enable this option if you
want all projects of a project type to use the same schedule for internal costing.
Enable this option to include the burden cost amount in the same expenditure
item. You can store the total burdened cost amount as a value with the raw cost
on each expenditure item. Oracle Fusion Projects displays the raw and burdened
costs of the expenditure items on windows and reports.
If you include burden cost amounts on the same expenditure item, but wish to
see the burden cost details, enable the option to create expenditure items for each
burden cost amount on an indirect project and task.
Enable this option to account for burden cost amounts as separate expenditure
items on the same project and task as the raw expenditures. The expenditure
items storing the burden cost components are identified with a different
expenditure type that is classified by the expenditure type class Burden
Transaction. Oracle Fusion Projects summarizes the cost distributions to create
burden transactions for each applicable burden cost code. The most important
summarization attributes are project, lowest task, expenditure organization,
expenditure classification, supplier, project accounting period, and burden cost
code. You can use the Burden Summarization Grouping Extension to further
refine the grouping.
Indicate whether to account for the total burdened cost amount of the items. You
typically use this option to track the total burdened cost amount in a cost asset or
cost work-in-progress account.
The burdened cost is the sum of raw and burden costs. Therefore, selecting this
option may result in accounting for raw cost twice. For example, assume that the
raw cost of an item is 100 USD, the burden cost is 50 USD, and the burdened cost
is 150 USD. When the application creates a journal entry for 150 USD, it accounts
for the 100 USD that was already accounted for as raw cost, plus the 50 USD
burden cost.
Cost Type
Indicate whether to capitalize costs at the burdened or raw cost amount for
projects with this project type.
• Expenditure Category
• Expenditure Type
Override Asset Assignment Asset Lines Assigned to Assets System Uses Asset Assignment
Extension
Do Not Override (option not Not Assigned Yes
selected)
Do Not Override Assigned No
Override Not Assigned Yes
Override Assigned Yes
• Actual Units
• Current Cost
• Client Extension
• Estimated Cost
• Spread Evenly
If you choose not to group supplier invoices, then select one of the following
supplier invoice export options.
Note
After the addition lines are sent to Oracle Fusion Assets, you can split, merge, or
unmerge the lines manually in Oracle Fusion Assets.
Use this field to specify a default interest rate schedule for capitalized interest.
Project classifications group your projects according to categories and codes that
you define. When you associate project classifications with project types, the
classification is available for selection on projects with that project type.
Use any of the following methods to associate class categories with project types:
• Enable the Assign to all Project Types option on the class category
definition
For each classification that you associate with the project type, you can enable
the Assign to All Projects option for the application to automatically add the
classification to the project definition for all new projects with the project type.
When this option is enabled, all projects with this project type must be assigned a
class code for the class category.
The asset cost allocation method determines how indirect or common costs
incurred on a project are allocated to multiple assets.
You can specify an asset cost allocation method to enable Oracle Fusion Projects
to automatically allocate unassigned asset lines and common costs across
multiple assets. Unassigned asset lines typically occur when more than one asset
is assigned to an asset grouping level.
Project templates and projects inherit a default asset cost allocation method from
the associated project type. You can override the default at the project level. If
you use capital events to allocate costs, then you can also override the asset cost
allocation method at the event level.
You must set up the contract business unit to use the Intercompany Billing
processing method.
This section describes the project business unit options for setting up cross-
charge transactions for sharing costs and revenue within and between business
units in the same legal entity.
Select the date type, either transaction date or project accounting date, and rate
type that the system uses by default to determine the conversion rate to convert
the transfer price amount from the transaction currency to the ledger currency.
You can override the default values by using the Transfer Price Currency
Conversion Override extension.
The processing method that you specify for cross-charge transactions between
business units is the default method used between the provider business unit
and any other receiver business unit. You can override the default processing
method for specific receiver business units.
Note
If you delete the override of the default processing method for a specific receiver
business unit, you must manually adjust transactions to reflect the deleted
controls.
Note
The application uses the project expenditure organization hierarchy, and the
project and task owning organization hierarchy, to determine the transfer price
defined for the provider organization and receiver organization combination.
• Either a rate schedule or burden schedule, based on the transfer price rule
Interproject billing creates internal invoices for costs incurred between a provider
project and a receiver project defined on an interproject billing contract. The
provider project generates an Oracle Fusion Receivables invoice, which the
receiver project receives as an Oracle Payables invoice.
By default, the receiver project is also the associated project for the contract line,
and you cannot add another associated project or change the associated project
for that contract line. However, the associated task and receiver task can be
different, so you can select another associated task for the project if necessary.
The receiver project must have the same legal entity as the internal customer.
Note
Only one receiver project can be linked to a contract line. The intercompany
invoice generation process automatically groups invoice lines by the contract
lines. Interproject invoices have a fixed format.
Invoice Formats
Define internal invoice formats for invoices generated by intercompany or
interproject billing contracts. The invoice formats control the grouping of
If you want the invoice format to be used for both customer and internal
invoices, enable the invoice format for customer invoices and internal invoices.
Restriction
All internal invoices must have a fixed format. Enable the fixed format feature
to prevent the rearranging or regrouping invoice line details on intercompany
invoices.
Select from the following labor and nonlabor schedule types that are available
for rate-based intercompany invoice generation and revenue recognition:
• Bill rate
• Burden rate
• Transfer price
Receiver Project
Create a receiver project in the receiver business unit.The receiver project can
be a project that is linked to both and external contract (for external billing) and
intercompany contract (for creating internal cross-charge transactions). The
receiver business unit receives the supplier invoices.
Each receiver project can receive invoices from multiple internal contracts or
from multiple contract lines of the same contract.
Enable the tasks on the receiver project that can be used for interproject billing
and to allow cross-charge transactions.
Provider Project
Create a provider project to use during interproject billing. Each receiver project
can have one or more provider projects. The provider project can be in the same
business unit or a different business unit as the receiver project.
Can I create a contract for intercompany billing with transfer price rules?
Yes, but only if you must derive rates for an intercompany contract based on an
organization hierarchy structure instead of the bill rates defined on a bill plan.
The contract line and bill plan architecture enables you to can specify a different
bill plan for each provider and receiver organization. Select a bill rate or
burden rate schedule for each of your contract's bill plans. However, if your
rates are defined at a very granular level, you may need to derive rates for an
organization hierarchy structure using transfer price rules.
If you do not see the internal billing features on a contract, check the attributes
on the contract type. The internal billing options of a contract are only visible if
the contract type is designated as either intercompany or interproject.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
Note
Use this extension only on cross-charged transactions.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
The system validates the value returned for the cross-charge code to ensure that
it meets the following rules:
Intercompany Billing
Between legal entities Intercompany Billing
Note
Use this extension only if you want to override the receiver expenditure
organization and receiver expenditure type on the Oracle Fusion Payables
invoice. The source of the receiver expenditure organization and expenditure
type is the intercompany or interproject contract.
This billing extension can derive the receiver expenditure type and receiver
expenditure organization based on the parameters you enter.
Parameters
Information about parameters for this billing extension are in the table below.
To create a transfer price rule, you specify the rule name and description, and
define these attributes:
• Type: Valid transfer price rule types are Labor or Nonlabor.
• Transfer Price Basis: The basis for transfer price calculation. Transfer price
basis options are:
• Raw cost
• Burdened cost
• External recognized revenue
• Calculation Method: Transfer price calculation methods are:
• Basis only: Use the transfer price with no further adjustments
• Apply burden schedule: Specify the name of an existing burden
schedule to apply to the basis
• Rate Schedule: The rate schedule to apply to the transfer price basis if
the transfer price calculation method is to apply a rate schedule. You can
select any rate schedule from any set.
The following table lists the valid combinations of transfer price basis and
calculation methods, and the calculation logic used to determine transfer price
amounts based on transfer price rules.
Note
Only one receiver project can be linked to a contract line. The intercompany
invoice generation process automatically groups invoice lines by the contract
lines. Interproject invoices have a fixed format.
Invoice Formats
Define internal invoice formats for invoices generated by intercompany or
interproject billing contracts. The invoice formats control the grouping of
transactions on invoice lines for intercompany contracts. Specify the grouping
options to summarize expenditure items and events, and the fields that
should be displayed on the invoice line. Create different invoice formats for
intercompany labor, nonlabor, and event billing.
If you want the invoice format to be used for both customer and internal
invoices, enable the invoice format for customer invoices and internal invoices.
Restriction
All internal invoices must have a fixed format. Enable the fixed format feature
to prevent the rearranging or regrouping invoice line details on intercompany
invoices.
Receiver Project
Create a receiver project in the receiver business unit.The receiver project can
be a project that is linked to both and external contract (for external billing) and
intercompany contract (for creating internal cross-charge transactions). The
receiver business unit receives the supplier invoices.
Each receiver project can receive invoices from multiple internal contracts or
from multiple contract lines of the same contract.
Enable the tasks on the receiver project that can be used for interproject billing
and to allow cross-charge transactions.
Provider Project
Create a provider project to use during interproject billing. Each receiver project
can have one or more provider projects. The provider project can be in the same
business unit or a different business unit as the receiver project.
Expenditures are charged to the provider project during interproject billing
scenarios.
One Cross-charge Rule or Rate, One Provider Business Unit, Any Receiver
Business Unit, All Projects
To share one cross-charge rule or rate between one provider business unit
and any receiver business unit, and all projects associated with the contract,
configure your contract billing information as follows:
You must set up the contract business unit to use the Intercompany Billing
processing method.
This section describes the project business unit options for setting up cross-
charge transactions for sharing costs and revenue within and between business
units in the same legal entity.
Select the date type, either transaction date or project accounting date, and rate
type that the system uses by default to determine the conversion rate to convert
the transfer price amount from the transaction currency to the ledger currency.
You can override the default values by using the Transfer Price Currency
Conversion Override extension.
The processing method that you specify for cross-charge transactions between
business units is the default method used between the provider business unit
and any other receiver business unit. You can override the default processing
method for specific receiver business units.
Note
Determines how Oracle Fusion Projects calculates the transfer price for cross-
charge transactions. Each rule contains the following attributes that you define.
• Basis for the cross-charge transaction: raw cost, burdened cost, or revenue
amount
Can I select any burden schedule or bill rate schedule for a transfer price rule?
Yes. You can assign any rate schedule to a transfer price rule, regardless of the
project rates set assigned to the bill rate schedule.
Can I select any burden schedule or bill rate schedule for a transfer price rule?
Yes. You can assign any rate schedule to a transfer price rule, regardless of the
project rates set assigned to the bill rate schedule.
Before you set up transfer price schedules, you must set up organizations and
transfer price rules.
Transfer price schedule lines contain details about the provider and receiver
organization, labor transfer price rule and markup or discount percentage,
nonlabor transfer price rule and markup or discount percentage, and amount
type.
A labor rule is valid transfer price rule with a type of labor. A nonlabor rule
is a valid transfer price rule with a type of nonlabor. A transfer price schedule
must contain either a labor or nonlabor rule, or both. You can assign a markup
or discount percentage to each transfer price rule to apply to the transfer price
amount that the rule calculates.
You assign cost transfer or revenue transfer as the amount type for the transfer
price calculation.
Note
The interproject billing method does not use transfer price calculation logic.
Only the billing methods based on bill rate schedule or burden rate schedule are
allowed for interproject billing.
You can define a transfer price schedule at any organization level and legal entity
level. Oracle Fusion Projects uses the following logic to identify the appropriate
schedule line:
1. If a transfer price schedule line exists for the provider organization (the
project expenditure organization) and the receiver organization (the
project and task owning organization), then the corresponding rule is
used to calculate the transfer price.
Note
Note
4. If a schedule line is not found in the previous step, the application checks
for the default line for the transfer price schedule.
5. If a schedule line is not found in the previous step, the process results in
an error.
One Cross-charge Rule or Rate, One Provider Business Unit, Any Receiver
Business Unit, All Projects
To share one cross-charge rule or rate between one provider business unit
and any receiver business unit, and all projects associated with the contract,
configure your contract billing information as follows:
Changes to transfer price rules and schedules affect only future transactions.
To change a previously processed transaction, you must manually adjust the
transaction.
The Distribute Borrowed and Lent Amounts process and Generate Invoices
process call the extension before calling the standard transfer price
determination process.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
The system validates that you provided a value for only one of the following
output audit parameters:
• x_bill_rate
• x_bill_markup_percentage
The Distribute Borrowed and Lent Amounts process and Generate Invoices
process call the extension after calculating the transfer price based on the transfer
price rules and schedules.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
The system validates that you provided a value for only one of the following
output audit parameters:
• x_bill_rate
• x_bill_markup_percentage
The Distribute Borrowed and Lent Amounts process and Generate Invoices
process call the extension after the processes calculate the transfer price. The
cross-charge transaction implementation options for the business unit determine
the default conversion attributes.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
Oracle Fusion Projects validates that the values returned by the extension meet
all conversion requirements.
Action controls control data that is imported to Oracle Fusion Projects from
Microsoft Project. An action control prevents you from performing an action in
Oracle Fusion Projects on a record that originated in Microsoft Project.
• Add Task
• Delete Task
• To ensure data integrity, you want to prevent projects and tasks that
originate in Microsoft Project from being deleted in Oracle Fusion
Projects.
To enforce this rule, you enter the following action controls for the source
Microsoft Project:
• Delete Task
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
Oracle Fusion Projects calls the Project Status Change Workflow Enabled
Extension when a change of status is requested for a project.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
Oracle Fusion Projects calls the Project Status Change Rules Extension when a
change of status is requested for a project.
When designing Project Status Change Rules Extensions, you determine what
business rules to apply when a project status change is selected for a project.
Oracle Fusion Projects calls the Organization Change Rules Extension during
the Change Project and Task Organizations process, and in the project definition
when you change the project and task owning organization.
Important
Do not change the name of the extension procedure or parameters. Also, do not
change the parameter types or parameter order in the procedure. After you write
a procedure, compile it and store it in the database.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Collect and import all types of project costs from Oracle Fusion and third-
party applications. During this process you can validate transactions to reduce
corrections and rework. Before you import the transactions to Oracle Fusion
Projects, you can review the exceptions for third-party transactions and correct
the errors.
Note
You
can
load
data
to
interface
tables
using
predefined
templates
and
the
Load
Interface
File
for
Import
scheduled
process,
which
are
both
part
of the
External
Data
Integration
Services
for
Oracle
Cloud
feature.
For
other
implementations,
optionally
use
this
feature
only
if you
have
SFTP
configured
for Options
Project Foundation Configuration: Define System Administration and Maintenance it. 33-3
• Use Oracle
Fusion Project
Costs from Other Fusion Source applications Validation is compulsory. Use the Import
applications and Process Cost
As transactions are Transactions process.
validated in their source
applications, they are not
validated again during
the Import and Process
Costs Transactions
process.
All transactions are validated but at various points, transaction entry or transfer,
or processing. If you are exporting transactions from desktop Excel integration
spreadsheets, you can release the transactions directly from the spreadsheet
itself by selecting the Process Costs option. Costs are submitted for Import
and Process Cost Transactions process avoiding the need to do it from the
application.
Restriction
The Process Costs option is not available in the Excel template, when you have
separate duties for entering and releasing Oracle Fusion Projects expenditure
batches. You can review the expenditure batches in the Manage Unreleased
Expenditure Batches page and submit them for processing.
After the transactions are imported to Oracle Fusion Projects, the application
tracks transactions with errors including the details for the cause of the error and
the action to be taken to fix the error. While the successful transactions are ready
for cost processing.
Note
For third-party application source transactions, the following table details
whether the options are editable after you have created and imported
transactions for the source.
Note
Can I change the source and document for transactions after exporting them to
Oracle Fusion Projects?
No. You cannot change the source, document, and document entry after creating
a transaction.
What's the difference between export and Oracle ADF Desktop Integration for
Excel?
Use the Export button or menu option to download data to view or analyze. You
get a Microsoft Excel file, of any type that Excel supports, containing selected or
Project Foundation Configuration: Define System Administration and Maintenance Options 33-5
all records from the corresponding table. If row selection is disabled, then the
export would include all rows. When all rows are exported, that includes all the
rows that are not visible on the page. However, any search criteria, filters, and
Query By Example values applied to the table can exclude rows from the export.
Data from hidden columns are also not included in the export.
Use Oracle ADF Desktop Integration for Excel to create or edit records in a
Microsoft Excel workbook and upload the records back into Oracle Fusion
Applications. This feature is helpful for mass updates or working outside of
Oracle Fusion Applications. In most cases, you download the desktop integrated
workbook from a link in the regional area, for example the Create Expense
Items in Spreadsheet link, or from a table, for example using the Prepare in
Spreadsheet button. The workbooks downloaded from a link can include rows
of data, or empty rows except for default values in some columns. From a table,
what is included in the workbook is determined the same way as for the export
option. If no rows are selected, however, the workbook does not include any
records from the table.
Note
If you are using a feature integrated with Oracle Fusion Applications that
presents a set number of rows per page or view, then exporting or downloading
all rows might not include all the data you want. You might need to navigate to
subsequent sets of rows to export or download.
Why can't I find the business unit in the downloaded desktop Excel integration
spreadsheets?
If your access is revised, then you have to download the desktop Excel
integration spreadsheets again. For example, if you initially have access to Vision
Operations business unit, then you view only this business unit listed in the
Excel spreadsheets. If new business units are assigned or removed, you must
download the templates again to view the business units according to your
access in the Excel spreadsheets.
Sources
At the transaction source level, you define the source, the processing set size,
preprocessing, and postprocessing extensions. The extensions record the internal
identifiers of imported expenditure items in the source application or perform
other user-defined processing before and at the end of the Import and Process
Cost Transactions process. Review and update the transaction sources to call the
transaction preprocessing and postprocessing extensions during the import and
process cost transactions process.
• Processing set size: When transferring large number of transactions, you
can reduce the impact of unexpected errors by processing transactions in
sets. Define the set size by providing the set size.
• Preprocessing extension: Used for transaction validation before importing,
uploading the transactions to Transaction Import Interface, or for other
processing tasks before importing.
• Postprocessing extension: Used to record the transaction number of the
imported expenditure items in the source application.
Option Description
Processing Set Size The number of records to be processed in each
set. When processing a large amount of data, you
can reduce the impact of unexpected errors by
processing transactions in sets. The import process
saves to the database after each set is complete. If
an error occurs and a rollback is issued, only the
transactions in the current set are affected.
Document Options
You specify the following options when setting up transaction source
documents.
Option Description
Commitment Source Identifies if this document is used for importing
commitment transactions.
Commitment Type Identifies type of the commitment transaction that
can be imported using this document. Possible
values are purchase order, purchase requisition,
supplier invoice, or any other commitment
transaction.
Import Raw Cost Amounts Imports transactions with the raw cost amount of
the transaction already calculated. The amount is
not modified after the transaction is imported into
Oracle Fusion Projects. Designating an imported
transaction as costed does not affect burdening or
accounting.
Note
Note
Option Description
Allow Override of Person Organization Allows the external application to provide an
expenditure organization that is different from the
owning organization of the person. If no expenditure
organization is provided, the import process
populates the expenditure organization with the
owning organization of the person.
Reconcile with Source Ties transactions from this document back to the
transaction source application.
Archive After Import Automatically archives successful imported
transactions when the import process completes.
Accounted in Source Application Controls the accounts that are imported and the
fields that are required from the transaction source
application.
Create Raw Cost Accounting Journal Entries Interfaces cost accounting journals for the raw cost to
the general ledger.
Note
Create Adjustment Accounting Journal Entries Interfaces adjustments to the general ledger.
You specify the following option when setting up transaction source document
entries.
Option Description
Expenditure Type Class Expenditure type class used for this document entry.
If the document is a commitment document, then the
expenditure type class is set to Supplier Invoice and
cannot be edited.
Option Description
Allow Adjustments Allow adjustments to imported transactions in
Oracle Fusion Projects after the import process.
Note
Note
Note
Restriction
Create raw cost accounting journal entries Select this option to create raw cost accounting
journal entries on transactions.
Create adjustment accounting journal entries Select this option to create adjustment accounting
journals entries on transactions.
You can have a document with the same name in multiple sources but you
cannot share documents across sources. For example, a corporation with
No.You can create documents and document entries only for third-party
transaction sources.
Can I allow adjustments and reversals for all transactions in the document
entry?
No. You decide whether to allow transaction adjustments and reversals for each
document entry that you create during implementation. However, you cannot
define document entries to allow adjustments and reversals for transactions that
are generated by the application such as allocation transactions, capital interest
expenditure transactions, summarized burden transactions.
Can I change the source and document for transactions after exporting them to
Oracle Fusion Projects?
No. You cannot change the source, document, and document entry after creating
a transaction.
Spread Evenly
The allocation rule divides the source pool amount equally among all the
chargeable target tasks included in the rule. This is the most simple and direct
basis method.
Specify the percentage of the source pool that is required to allocate to each
target line. The total specified target percentage must always equal 100 percent.
The allocation rule calculates the amount to allocate to the target line, and then
spreads the results evenly among the chargeable tasks.
Prorate
The allocation generation uses the attributes defined in the allocation rule to
derive the rate at which the source pool amount is apportioned among the
target projects and tasks. For this basis method, the allocation rule uses the basis
attributes to apportion the source amount among all the tasks defined by the
rule.
The allocation rule first uses the target percentage to calculate the amount to
allocate to the line, and then apportions the results among all the tasks.
Note
Both the Prorate and Target Percentage and Prorate basis methods provide
precise control over how the rule distributes the source pool.
Another way to define percentages and a basis is to use the Allocation Basis
extension. This extension enables you to define your own allocation basis to
determine the basis amount for each target project and task.
• Full Allocation
• Incremental Allocation
Full Allocation
The full allocation method always distributes the entire source pool amount
to target projects and tasks and generates allocation transactions for the entire
amount each time in a period. This method is suitable to process an allocation
rule only once within the same accounting or project accounting period.
Warning
Allocation Number Source Pool Total Allocated Previous Allocated Current Allocated
Amount Amount to Targets Amount to Targets Amount to Targets
1 1050.00 1050.00 0.00 1050.00
Incremental Allocation
Incremental allocations create expenditure items based on the difference between
the transactions processed in the previous and current allocation generation. This
method is suitable if you want to use the allocation rule to generate allocations
several times in a single period. The application keeps track of the results of
previous incremental allocation generations. Therefore, you can process an
incremental allocation multiple times within the same period creating additional
transactions to incrementally increase or decrease the amount allocated to each
target project and task based on changes to the available source pool amount and
basis logic from the previous incremental generation. You can review and delete
draft allocations until you are satisfied with the results.
Note
Allocation Number Source Pool Total Allocated Previous Allocated Current Allocated
Amount Amount to Targets Amount to Targets Amount to Targets
1 1000.00 1000.00 0 1000.00
2 1100.00 1100.00 1000.00 100.00
3 1050.00 1050.00 1100.00 <50.00>
At the end of the period, the total amount allocated to targets is 1050.00. This is
made up of sets of incremental allocation transactions. Incremental transactions
can be positive or negative, based on changes to the source pool, eligible targets,
and basis calculations.
• Allocation method
• Basis method
Each allocation rule is associated with a business unit. Source projects and ledger
accounts of an allocation must be from the same business unit as the one that is
assigned to the allocation rule. During processing, based on the target selection,
if the project cross-charge is enabled, costs can be allocated costs to projects
across business units. However, offset transactions are charged to projects owned
by the same business unit that owns the allocation rule.
The draft failure allocations are processed only after reviewing and fixing the
issues. For example, you can edit the associated allocation rule or ensure that the
actual amounts are summarized for source projects. After fixing the errors, delete
the draft allocation and generate the allocation again.
You can use offsets to balance the allocation transactions with the source or other
projects. When you define an allocation rule, you select the offset method to
determine how offset transactions are created.
Note
All offset projects and tasks must be open and chargeable, and in the same
business unit that owns the allocation rule. The allocation rule can have an offset
method although it may not have source projects.
The allocation rule creates the offset transactions for the offset projects and tasks
when you generate the allocation. Offset transactions offset the total amount
allocated to target projects, although the total number of offset transactions
does not usually equal the total number of allocation transactions. For example
with an offset method of Specific Project and Task, if the rule allocates 10,000.00
USD from the allocation sources to 1000 target projects and tasks, then the
result is 1000 allocation transactions for a total of 10,000.00 USD and one offset
transaction to the specified project and task for a negative amount of 10,000.00
USD.
You can select one of the following offset methods in an allocation rule:
Use this offset method in the allocation rule to create reversing transactions for
the specified source projects and tasks in the allocation rule.
Note
If the allocation rule uses ledger sources or a fixed amount source, then the
allocation rule cannot use Source Project and Task offset method because a
source project does not exist in such cases. Only project sources use this offset
method.
Use this offset method to create reversing transactions in projects and tasks as
specified in the Allocation Offset Projects and Tasks client extension. You can use
this method with any one of the sources or a combination of project, ledger, or
fixed amount source.
Use this offset method to create reversing transactions in one project and one of
its tasks per the specified project and task in the offset method. You can use this
method with any one of the sources or a combination of project, ledger, or fixed
amount source.
• Prorate
The two prorate basis methods provide precise control over how the rule
distributes the source pool. The rule uses the basis attributes defined in the
allocation rule to derive the rate at which the source pool amount is apportioned
among the target projects and tasks.
Using the Prorate basis method, for a source of $1000.00, consider the following
target details:
The basis percentage for each target task is equal to the target task basis amount
divided by the total basis amount, multiplied by 100. For example, for task 1 on
project ABC the application determines the allocation amount by multiplying the
basis percentage for each target task by the source pool amount.
For the Prorate basis method, the allocation rule prorates the amount specified
by the source pool to the targets based on the basis attributes in the allocation
rule.
Using Target Percentage and Prorate basis method, for a source of $1000.00
allocated to the target line, consider the following details:
Basis percentage for each target task is equal to the target task basis amount
divided by the total basis amount the target line from the allocation rule,
multiplied by 100. For example, for task 1 on project ABC the application
determines the allocation amount by multiplying the basis percentage for each
target task by the source pool amount for the target line.
For the Target Percentage and Prorate basis method, the rule first uses the target
percentage to calculate the amount to allocate to the line, and then apportions
the results among all the tasks for that line. In the application, an effective
percentage column is also available when reviewing the basis details for an
allocation. The effective percentage represents the following:
• percentage of the total source pool amount that the target task receives
• consolidated percentage of the target percentage and basis percentage
calculations.
Note
For simplicity in the above examples, each target line in the allocation rule
specifies a project. In real life, the target line can be defined more broadly. For
example, a target line could specify a project-owning organization of Services
East, so the eligible targets would be all projects owned by Services East.
You define the allocation rule in this scenario to distribute labor cost amounts
from shared services project. This allocation rule defines the following:
• Method to divide the source amount among the target projects and tasks
Field Value
Business Unit InVision Services
Name Shared Contract Services Allocation
Description Rule to allocate shared contract service
costs
Allocation Method Incremental
Allocation Period Type Accounting Period
Targets Selection Within business unit
Basis Method Prorate
Expenditure Organization San Diego
Expenditure Type Class Miscellaneous Transactions
Expenditure Type Contract Services Allocation
Field Value
Allocation Pool Percentage 100
Fixed Source Amount 0
Amount Class Fiscal year-to-date
Amount Type Burdened Cost
Project Organization San Diego
Project Contract Shared Service Center
Field Value
Line Number 1
Project Organization San Diego
Project Type Time and Materials
Exclude Leave unchecked
Line Number 2
Project Organization San Diego
Project Rudycorp Software Install
Exclude Select the check box.
Field Value
Offset Method Source project and task
Expenditure Organization San Diego
Expenditure Type Class Miscellaneous Transactions
Expenditure Type Service Offset
Field Value
Basis Category Actual Amounts
Amount Type Total Billable Burdened Costs
Amount Class Fiscal year-to-date
Relative Period 0
You are implementing allocation rules for the organization. You want to allocate
100 percent of the rental cost collected in the general ledger account for the
organization to all eligible tasks once a month. You also want to prorate the
allocation based on the previous month's total raw cost for each task. The
following table summarizes key decisions for this scenario:
You define the allocation rule in this scenario to distribute amounts between
and within projects and tasks in a business unit. This allocation rule defines the
following:
• Method to divide the source amount among the target projects and tasks
Field Value
Business Unit InVision Services
Name San Diego Rent Allocation
Field Value
Allocation Pool Percentage 100
Source Amount Class Period-to-date
Ledger Sources Account 01-420-7580-000
Percentage 100
Subtract Leave unchecked
Field Value
Line Number 1
Project Organization San Diego
Line Number 2
Project Rudycorp Software Install
Exclude Select the check box.
Field Value
Offset Method Specific project and task
Project Allocation Offset Project
Task 1.0
Field Value
Basis Category Actual Amounts
Amount Type Total Raw Cost
Amount Class Period-to-date
Relative Period -1
When defining an allocation rule, you must specify the expenditure type class
for the allocation transaction attributes. Choosing the expenditure type class
determines how the allocated amount is created as costs on the expenditure item.
Miscellaneous Transactions
The miscellaneous transaction expenditure type class is used to allocate the
source amount as raw cost on the expenditure item.
Burden Transactions
The burden transactions expenditure type class is used to allocate the source
amount as the burden cost for the expenditure item, while expenditure item
quantity and raw cost remain zero.
Yes, if the projects are enabled for cross-charge processing and when the target
selection in allocation rule is across business units. Allocation transactions are
owned by the business unit to which the allocation rule belongs. However, you
The allocation either results in an error or spreads the amount evenly to all the
eligible target projects or tasks based on the Allocation Method for Zero-Basis
Amounts profile option settings during implementation.
Both allocation and burdening are related to expenditure item costs. Allocation
uses actual amounts from sources such as project sources, ledger sources, and
fixed amount source to provide the source pool amount. Allocation generation
apportions these source pool amount to target projects and tasks. When you
release the allocation, expenditure items are created against each target project.
Burdening uses a set of estimated burden multipliers to increase the total cost
amount of expenditure items. This fixed percentage is an estimate of the indirect
or burden costs associated with the raw costs for each expenditure item.
Allocations and burdening are not mutually exclusive; you can use both.
Whether your company uses allocations, burdening, or both in a particular
situation depends on how your company works and how you have implemented
Oracle Fusion Project Costing.
Standard unit cost method is one of the asset cost allocation methods that is
used to allocate common and indirect costs to different assets. For example, you
can allocate amounts such as salaries, administrative overhead, and equipment
charges across several assets.
A standard unit cost is defined for an asset book and asset category combination.
When you use this method, Oracle Fusion Projects multiplies the standard unit
cost times the actual units based on the asset book and asset category of each
asset and it determines the proration basis for allocating costs. Optionally, you
can override the asset cost allocation method when defining capital events.
Yes. When capturing retirement costs in a capital project, enter proceeds of sale
amounts using expenditure types specifically created for that purpose. Oracle
Fusion Projects automatically classifies amounts for all other expenditure types
associated with the retirement cost task as cost of removal.
Note
To delete an interest rate schedule, you must build the schedule and then delete
it.
Indicate whether the project is eligible for capitalized interest. By default, this
option is enabled for all capital projects. However, you can update the option as
required.
Capitalized interest rate schedules to define rates of interest calculation for each
organization. The default interest schedule is inherited from the project type. You
can override it if the project type allows schedule changes at the project level.
For example, assume the stop date for your project is December 27, 2010 and
your accounting periods are weekly. That is, the stop date falls in the fourth
period of December. In such a case, capital interest is calculated only up to the
third period in December 2010.
When you define a document entry, select the Create related items option.
You can create related items for any type of transactions from third-party
applications. The Import and Process Cost Transactions process creates related
items based on the user-defined specifications in the client extension. All related
items are associated with a source transaction. Use related items to process raw
cost amount separately from the source transaction raw cost amount.
However, you cannot create related items, if the document entry is associated
with allocation, capital interest, and application-generated summarized burden
expenditure transactions.
You can optionally create account rules with your specifications. If you define an
account rule for an account combination, then the rule determines each segment
of the Accounting flexfield. If you define an account rule for a segment, then the
rule determines the value for a single Accounting flexfield segment. You can use
both segment and account combination rules to derive a single account. If you
assign both types of account rules to a single journal line definition, then Oracle
Fusion Subledger Accounting uses the account segment rules first and then takes
the remaining values from the account combination rule.
You must update the account rules to derive project-specific accounting. Create
project-specific rules by evaluating the Project Identifier. Derive a project-specific
account combination or override a single account segment with a project-specific
value. Use more than 100 project-specific sources to create mapping sets and
account rule conditions. Examples of these sources include:
• Billable Indicator
• Capitalizable Indicator
• Retirement Indicator
• Project Type
• Expenditure Type
Transaction Sources
Costs are created in internal and external applications before being processed.
The following table lists cost types and the corresponding source applications.
Note
• Purchase Requisitions
Note
• Movement Requests
Oracle Fusion Cost Management • Expense-Based Receipts
• Adjustment Transactions
• Unprocessed Transactions
Third-Party Applications External Costs imported using desktop Excel
integration, Web services, or Oracle Cloud interface.
Capture of Costs
Capture various types of costs from internal and external applications, and then
transfer them to Oracle Fusion Project Costing.
• Web services
Note
Create individual third-party transactions in the You can create individual transactions with third-
application party application source directly from the Manage
Unprocessed Transactions page in Oracle Fusion
Project Costing.
You enter project information at the distribution line level for project-related
requisitions and purchase orders in Oracle Fusion Purchasing, and for project-
related supplier invoices in Oracle Fusion Payables. For requisitions, the
requisition distribution attributes default from what is specified during the
implementation. For purchase orders, the purchase order attributes default from
the purchase order line and the purchase order line attributes default from the
purchase order header. The distribution level values are used for validation and
import.
Distribution sets are typically used on recurring transactions, and the associated
project does not have transaction controls. When you create a distribution set
in Oracle Fusion Payables, the distribution set line is not validated against the
project transaction controls in Oracle Fusion Projects because you do not enter an
expenditure item date, which is required for transaction control validation. The
expenditure item date is not provided because you use the distribution sets for
an indefinite period of time.
You can enter cost markups in the nonlabor rate schedule instead of rates for
expenditure types that are related to inventory items.
Alternatively, if you enter a bill rate for an expenditure type that relates to
inventory items, then the base unit of measure for inventory transactions
reported under the expenditure type must be the same as the unit of measure
for the expenditure type. If the base unit of measure for an inventory transaction
differs from the unit of measure for the expenditure type, the Generate Revenue
process reports an error and does not process the transaction.
Note
Note
Project managers
and accountants
can view planning
options at the
version level.
Create versions No Yes Yes None
Generate versions No Yes Yes Applies to budgets
generated when
setting a baseline
for the project plan.
Project
administrators
cannot generate
forecasts from
progress (they do
not have access to
publish progress.)
Edit versions in No Yes Yes None
Excel
Submit versions No Yes Yes None
Approve versions No Yes No A team member
with project
manager security
role access must
be manually
designated as the
project manager for
the project.
Note
If workflow is
enabled, then
approval takes
place through a
notification. Menu
actions are not
available on the
budgeting and
forecasting pages.
Review versions No Yes Yes None
When you submit a current working version of a budget or forecast for approval,
the version status changes to Submitted. If the project manager approves
the version, then the version status changes to Current Baseline or Current
Approved, as appropriate. Simultaneously, a current working version is also
created. If you use Business Process Engineering Language (BPEL) workflow for
status changes, then submitting a budget or forecast triggers a notification to the
project manager and the requester. Requesters must manually specify approver
details.
Important
Period profiles do not affect the periods for which you enter amounts. That is
determined by the start and end dates of the financial or project plan line.
You select a period profile when specifying plan settings for a financial plan
type or a project plan type. With the appropriate access, you can override this
selection when creating budget or forecast versions for a project. Similarly, you
can override the period profile associated with the project plan type at the project
template or project level.
Period profiles are based on groups of periods from either an accounting
calendar or a project accounting calendar. You can define an unlimited number
of period groupings of varying duration in a period profile.
Scenario
The following table describes a period profile set up to accommodate detailed
and summary-level planning for long-term projects. This period profile enables
entry of amounts for a mix of monthly, quarterly, semiannual, and annual
periods for a span of five years.
Assume that the period profile is associated with a project with the following
details:
• Duration: 10 years
You can create spread curves, use predefined spread curves, or edit them as
required. The following is a description of spread curve components (spread
points and distribution factors) and predefined spread curves.
Spread curves, other than Daily Spread Basis contain 10 spread points. Specify
distribution factors for any combination of the spread points.
Note
When using a daily spread basis, amounts are allocated to each period based on
the ratio of the days in the period to the duration of the task assignment.
Distribution factors are prorated according to the spread points allocated to each
period. For example, if $100 is to be spread across four months for a planning
resource that uses an even spread curve (where amounts are distributed evenly),
then each period is assigned $25. The amount assigned to each period is the total
amount multiplied by the spread points for the period (2.5 * 10).
Important
The following table lists predefined spread curves provided by Oracle Fusion
Projects.
Note
Assignment start and finish dates are included in the number of days in the
period.
The following table shows how the task assignment days are determined, and
the resulting allocation factors.
For example, if $100 is to be spread across four months for a planning resource
that uses an even spread curve (where amounts are distributed evenly), then
each period is assigned $25 each. That is, 10 spread points spread over 4 months
equals 2.5 spread points per period. Each spread point has a distribution factor
of 10.
The following is a description of how distribution factors are calculated for full
or partial periods.
Note
The following table describes how distribution factors are determined and
amount allocated over the four planning periods.
Deriving Spread Point Values and Prorating Distribution Factors for Partial
Periods
Transaction start dates associated with a planning resource or task frequently
do not coincide with the start or end dates of a period. In such a case, the actual
number of planning resource or task transaction days determines how spread
points and constituent distribution factors are allocated to full and partial
periods.
Assume that the dates for a task assignment cover only 15 days of the first month
(a 30-day month) of a four-month planning period. That first month represents
the value of 0.5 spread points.
In such a case, the spread point value for each full period is calculated by
dividing the total number of spread points (10) by the number of periods
corresponding to the transaction (3.5). In other words, spread point values are as
follows:
• Cost amounts
• Revenue amounts
Define Project Control Configuration: Manage Financial and Project Plan Types 43-1
Default financial plan type Financial plan type Determines whether the financial
plan type is the default selection
when you create budget or
forecast versions.
Workflows Financial plan type Enables the use of a workflow
for managing budget or forecast
status changes.
Third-party scheduling software Project plan type Indicates whether project
planning is performed in
Microsoft Project.
If third-party scheduling is
disabled in the project plan type,
you can use the associated project
or project template to create
a project in Microsoft Project.
However, you cannot export
the new project or link it to one
created in Oracle Fusion Projects.
Note
Multiple transaction currencies Financial and project plan type Enables entry of plan amounts in
currencies other than the project
currency.
Restriction
You can plan for revenue only if you are licensed to use Oracle Fusion Project
Billing.
If you select to plan only for cost or revenue, then all budget or forecast versions
created for the financial plan type contain only those amounts.
When you review versions created for cost-only financial plan types, margin
values and other comparisons dependent on revenue amounts are not available.
If you select to plan for cost and revenue separately, then each budget or forecast
version created for the financial plan type can contain either cost or revenue
amounts. When you review cost versions, select any revenue version created for
the same financial plan type as the source for revenue amount for use in plan
comparison.
Important
A budget or forecast financial plan type may support both cost and revenue in
one version.
Tip
You can include a financial plan type before it is used on a project for creating a
version.
You can replace a user-selected financial plan type until project performance data
is summarized for reporting. After that, you can only disable the financial plan
type to exclude it from further summarization.
Define Project Control Configuration: Manage Financial and Project Plan Types 43-3
Associating Sets with Financial Plan Types: Example
You associate sets with financial or project plan types so that project managers
can use them to create financial plans (budget or forecast versions) or project
plans for projects or project templates. Financial or project plan types are
available for selection only when projects or project templates are created for
project units linked to selected sets.
The following example illustrates the relationship between financial plan types,
sets, and project units. Project plan types share an identical relationship with sets
and project units.
Scenario
An organization has two designated project units for project creation: Project
Unit 1 and Project Unit 2. Project Unit 1 is associated with Set 1 and Project Unit
2 is associated with Set 2.
During implementation, two financial plan types were created: Financial Plan
Type A and Financial Plan Type B. Financial Plan Type A is associated with Set 1.
However, Financial Plan Type B is associated with both Set 1 and Set 2.
In such a case, project managers working on projects for Project Unit 1 can use
only Financial Plan Type A to create financial plan versions. Project managers
working on projects for Project Unit 2 can use both Financial Plan Type A and
Financial Plan Type B.
The following diagram further illustrates the relationship between financial plan
types, sets, and projects. Project plan types share the same relationship with sets.
• Project planning extends into the future, beyond dates for which actual
rates are available. Using planning rates enables you to plan for future
periods by making assumptions about potential rate increases or
decreases.
• Planning is at a more summary level than when using actual rates. For
example, use job-based rate schedules to plan, but actually track labor
costs using cost rates defined at the employee level.
When using actual rates for project plan types and financial plan types that
support cost amounts, you select cost rate schedules at the resource class level.
Similarly, for financial plan types that support revenue amounts, you select bill
rate schedules at the resource class level. If the application is unable to determine
cost or bill rates for a planning resource, then it uses the resource class rates
schedules you specify here.
When using planning rates, you select rate schedules at the resource, job, and
resource class levels. The following table summarizes the precedence order for
determining cost or bill rates for a planning resource when deriving raw costs or
revenue for rate-based planning resources.
Define Project Control Configuration: Manage Financial and Project Plan Types 43-5
Specifying a Burden Schedule when Using Planning Rates
If an expenditure type is not associated with the planning resource, then Oracle
Fusion Projects uses the expenditure type defined for the associated resource
class to determine the burden multiplier, and ultimately, the burdened cost.
Forecast approval options determine the approval process for forecast versions
created for a particular financial plan type. Approval options determine whether
you can do the following:
For example, disable this option for primary forecast financial plan types to
ensure that only entitled users approve corresponding versions. On the other
hand, enable this option for other financial plan types that do not require explicit
approval, for example, those whose versions are used for what-if analysis.
Important
The automatic approval option applies only when manually approving forecasts.
To approve forecasts versions that are generated automatically when publishing
progress, you must be entitled to approve forecasts.
Important
The option to automatically submit forecasts for approval does not apply when
manually creating forecasts.
Task and task assignment date options are selected when specifying project
planning options. Task and assignment date settings interact to determine how
planned and transaction dates are set for tasks and how dates are set for task
assignments.
Conversely, if you select not to roll up planned dates, lowest-level subtask dates
are editable but must be within the planned date range for summary tasks and
the project. You can also edit project or summary task dates as required.
Tip
Specify a positive buffer value to indicate the number of days before the planned
start date and the number of days after the planned finish date that a transaction
can be charged to a task. Conversely, specify a negative buffer value to indicate
the number of days after the planned start date and the number of days before
the planned finish date that a transaction can be charged to a task. In other
Define Project Control Configuration: Manage Financial and Project Plan Types 43-7
words, when specifying a negative buffer, transaction dates are within the range
of the planned dates.
If you select not to synchronize transaction dates with planned dates, then
transaction dates are blank by default and can be edited as required. Transaction
dates entered at the summary-task level are used as the default transaction dates
for tasks at lower levels. Transaction dates specified for subtasks must be within
the transaction dates for the summary task. If none of the summary tasks in the
hierarchy have transaction dates, then the new transaction date must be within
the project date range.
You can modify the date synchronization option until you charge transactions to
a task. Implications of changing between options are as follows:
Note
Use cascade options to determine whether your changes to project dates cascade
to tasks.
• Do not cascade date changes: Both start and finish dates are editable.
However, you must ensure the following:
• The project start date is not later than the earliest task date.
• The project finish date is not earlier than the latest task date.
• Cascade change to the start date: You can edit only the project start date.
• Cascade change to the finish date: You can edit only the project finish
date.
Restriction
Note
If transactions are already charged to a task, then you must ensure that your new
summary dates are before or after the transaction date (depending on whether
you are cascading start or finish dates.)
Once you associate a project plan type with a project or project template, or
create budget or forecast versions using a financial plan type, you cannot edit
certain financial or project plan setup options. These options include the primary
forecast and approved budget designations, use of workflow, and the use of
multiple transaction currencies.
Also, changes made to a financial plan type apply only to new financial plan
versions. Similarly, there is no impact on existing project associations when you
modify a project plan type.
Why can't I select some financial plan types when generating a budget version
while setting a baseline for the project plan?
For generating a budget when setting a baseline project plan, you can select
any active budget financial plan type otherwise available for budget creation.
However, some financial plan types (including the default financial plan
type selected in the budget generation options of the project plan type) are
unavailable for selection in the following circumstances:
Define Project Control Configuration: Manage Financial and Project Plan Types 43-9
Can I select a financial plan type for summarization before creating a version of
it on a project?
Yes.
FAQs for Manage Financial Plan Types: Set Financial Plan Options
For each project, you can use only one financial plan type that is designated as
an approved cost budget or an approved revenue budget. Either select separate
financial plan types (one approved cost budget and one approved revenue
budget) or a single financial plan type with both designations.
For each project, you can use only one financial plan type that is designated
as a primary cost forecast or a primary revenue forecast. Either select separate
financial plan types (one primary cost forecast and one primary revenue
forecast) or a single financial plan type with both designations.
FAQs for Manage Project Plan Types: Set Project Plan Options
Using Microsoft Project for scheduling limits your ability to modify project and
task dates in Oracle Fusion Projects. Start and finish dates for the project and
existing tasks cannot be modified. You can enter start and finish dates for new
tasks. However, these dates must be within the planned dates for the summary
task. You can modify transaction dates. However, these must be within both the
task planned dates and transaction dates for the summary task or project.
Key planned information for tasks and task assignments, including dates, costs,
quantity, effort, and rates, that you can save from current project plan values.
You must set a baseline for your project plan before capturing progress. Baseline
amounts determine earned value for lowest-level tasks, which in turn is used to
roll up physical percent complete to summary tasks.
Baseline data cannot be deleted, and does not change until it is overwritten when
you next set a baseline for the project plan.
Tip
By generating a budget version when you set a baseline for your project plan,
you can maintain an historical record of past baseline data.
Define Project Control Configuration: Manage Financial and Project Plan Types 43-11
43-12 Oracle Fusion Applications Project Financial Management Implementation Guide
44
Project Billing Configuration: Define
Business Unit Project Billing Options
The setup options available for the Contract Terms Library are applicable
to both customer and supplier contracts, and are described in the business
unit setup topic for the Contract Terms Library. That topic is available as a
related link to this topic.
Project Billing Configuration: Define Business Unit Project Billing Options 44-1
In the Bill Transaction Currency to Contract Currency region, enter currency
conversion details that will normally be used, by all contracts owned by this
business unit, to convert transaction amounts in the bill transaction currency
to the contract currency. Newly created contracts contain the default currency
conversion values, but you can override the values on any contract, if needed.
Project billing can behave differently for external contracts (customer billing) or
intercompany and interproject contracts (internal billing).
There are two sets of the following options, one for customer billing and a
second for internal billing:
Access to invoices is secured by the business unit. You only have access to
invoices that belong to contracts in the business unit assigned to your role. You
can see all invoices for projects that are linked to the contracts which you can
access.
Project Billing Configuration: Define Business Unit Project Billing Options 44-3
44-4 Oracle Fusion Applications Project Financial Management Implementation Guide
45
Project Billing Configuration: Define
Project Invoicing Options
Invoice and Revenue Method Components: How They Work
Together
Invoice methods and revenue methods control the way you create invoices and
recognize revenue for contracts. During implementation you create the methods
and assign them to bill plans and revenue plans. Any contract or contract line
that uses the bill or revenue plan calculates the invoice or revenue amount
according to the instructions in the invoice or revenue method.
Method Classification
Invoice method classifications and revenue method classifications are predefined
by Oracle Fusion Projects. Select an invoice or revenue method classification to
set the approach for calculating invoice or revenue amounts.
This table lists the invoice method classifications and their descriptions.
This table lists the revenue method classifications and their descriptions.
Tip
Rate Definition
Select schedules for labor and nonlabor if your invoice or revenue method uses a
rate-based classification method.
Tip
Note
Expenditure items and events are the transactions for projects and contracts.
Invoice method classifications determine how transactions are invoiced.
The invoice method determines how invoice amounts are derived and which
billing extensions, if applicable, calculate invoice amounts. Enter an invoice
Invoice Method
Create invoice methods for bill plans to use for determining the approach for
generating invoice amounts. The invoice methods contain invoice generation
instructions in the form of the invoice method classification and rate definition
schedule types. Rate definition schedule types determines whether the rate
source for invoicing comes from rate schedules, burden schedules, or transfer
price schedules.
You must assign an invoice method to a bill plan, which contains the invoice
generation instructions for a specific contract or contract line. An invoice method
can be used by more than one bill plan.
Caution
Enable the invoice method for intercompany billing if it will be used for
intercompany billing only.
Bill Plan
Create a bill plan within a contract that uses the invoice method you require.
Assign the bill plan to one or more contract lines.
If the invoice method classification for the bill plan uses a billing extension, that
billing extension is automatically added to the bill plan.
Important
Oracle Fusion Project Billing does not create invoice amounts for contract lines
that have a bill plan on hold.
Billing Control
A billing control defines the types of permitted transactions (using billing
resources), transaction date range, and maximum invoice (and revenue) amounts
for a contract or contract line. Create a billing control within a contract at either
the contract or contract line level. The inception-to-date (ITD) invoice amount
cannot exceed the hard limit amount of a billing control. If the ITD invoice
amount exceeds the soft limit, invoice generation will still occur, but you will
receive a warning the first time this occurs.
Expenditure Item
The project and task for an expenditure item are matched to the associated
contract line during invoice generation. Invoicing can occur r if the transaction
date, billing resource, and amount for the expenditure item pass the contract
billing controls.
If the expenditure item is mapped to more than one eligible contract line, the
processing order is determined as follows:
Event
Invoice events are automatically created during invoice generation if the bill
plan for a contract line plan contains a billing extension. The billing extension
calculates the invoice event amount, and creates an invoice event.
Manual events are also processed during invoice generation. Oracle Fusion
Project Billing creates a billing transaction for each automatic or manual event.
The billing transaction is the source for creating invoice distributions.
Note
The internal name for this profile option is PJB_AR_INVOICE_UOM.
Unit of Measure
The default unit of measure value is Each. Define a unit of measure of Each in
Oracle Fusion Receivables to use with this profile option.
• Amount based
• As incurred
• As invoiced
• Percent complete
• Percent spent
• Rate based
• Amount based
• Rate based
• Percent complete
• Percent spent
Note
After the contract is approved, any changes to the bill plan including the revenue
or invoice method classification must go through the change management
process.
You can use customer invoice formats only for regular contract invoices, and
internal invoice formats only for invoices generated by intercompany and
interproject contracts. You can also use an invoice format for both customer and
internal invoices.
• Format type
• Grouping option
• Fixed format
• Text column
Format Type
The format type controls the invoice formats you see for labor, nonlabor and
events when you enter invoice formats using the Projects window.
Grouping Option
A grouping option specifies the way invoice distribution lines are grouped
together to form an invoice line.
If you create an internal invoice format, you must select contract line as an
attribute. This is to ensure that no two contract lines can be combined into a
single invoice line, as they could be tied to different receiver projects or tasks,
and would need to be created as separate invoice lines in order to post to the
correct receiver project or task.
Although one invoice format can support both customer and internal invoices,
the list of values for the Field Name only includes those values that are shared by
the two formats.
A fixed format prohibits distributions from being moved to other invoice lines.
Intercompany and interproject invoices must have a fixed format.
The start and end positions are values between 1 and 240 that specify where the
text in the Field Name appears on the invoice line.
Text Column
Enter the text in this column that you want to display on the invoice.
The event amounts are calculated at the calculation level selected on the bill plan
or revenue plan.
Important
You must enter the funding amount for either the contract line or the project and
contract association, depending on the calculation level selected in the bill plan
or revenue plan.
Expenditure items and events are the transactions for projects and contracts.
Revenue method classifications determine how transactions recognize revenue.
The revenue method determines how revenue rates are derived and which
billing extensions are called to calculate revenue. Enter a revenue method on
a revenue plan, which you create for a contract and assign to contract lines to
provide a set of instructions for recognizing revenue.
Create billing controls for a contract or contract line to define the valid
transaction dates, billing resources, and amount limits for transactions associated
with the contract.
The following diagram illustrates the components of a project and a contract that
determine revenue amounts, and the relationships between the components.
Revenue Method
Create revenue methods for revenue plans to use for recognizing revenue. The
revenue methods contain revenue recognition instructions in the form of the
revenue method classification, rate definition schedule types and any applicable
billing extensions. If you assign a billing extension to the revenue method, the
extension calculates the revenue amount and creates an automatic revenue event.
The billing extension assignment must be active to calculate revenue and create
an event.
You must assign a revenue method to a revenue plan, which will give the
revenue recognition instructions to a specific contract or contract line. A revenue
method can be used by more than one revenue plan.
Caution
Enable the revenue method for intercompany billing if it will be used for
intercompany billing only.
If the revenue method classification for the revenue plan uses a billing extension,
that billing extension is automatically added to the revenue plan.
Important
Billing Control
A billing control defines the type of permitted transactions (using billing
resources), transaction date range, and maximum invoice and revenue amounts
for a contract or contract line. Create a billing control within a contract at either
the contract or contract line level. The revenue amount cannot exceed the hard
limit amount of a billing control. If the revenue amount exceeds the soft limit,
revenue recognition will still occur, but you will receive a warning.
Expenditure Item
The project and task for an expenditure item are matched to the associated
contract line during revenue generation. Revenue recognition can occur if the
transaction date and billing resource for the expenditure item pass the contract
billing controls.
If the expenditure item is mapped to more than one eligible contract line, the
processing order is determined as follows:
Oracle Fusion Project Billing creates a billing transaction for each unique
combination of expenditure item and contract line. The billing transaction is the
source for creating revenue distributions.
Event
Revenue events are automatically created during revenue generation if
the revenue plan for a contract line plan contains a billing extension. The
billing extension calculates the revenue event amount, and creates a revenue
distribution.
Manual events are also processed during revenue generation. Oracle Fusion
Project Billing creates a billing transaction for each event. The billing transaction
is the source for creating revenue distributions.
The event amounts are calculated at the calculation level selected on the bill plan
or revenue plan.
Important
You must enter the funding amount for either the contract line or the project and
contract association, depending on the calculation level selected in the bill plan
or revenue plan.
If you do not see the internal billing features on a contract, check the attributes
on the contract type. The internal billing options of a contract are only visible if
the contract type is designated as either intercompany or interproject.
Project Billing Configuration: FAQs for Define Additional Intercompany and Interproject Billing Options 47-1
47-2 Oracle Fusion Applications Project Financial Management Implementation Guide
48
Project Billing Configuration: Define
Project Billing Extensions
General Information
• Order
• If multiple billing extensions are assigned to a bill or revenue plan,
enter a numeric value to determine when this extension is called.
Oracle Fusion Project Billing calls billing extensions in ascending order.
• Procedure
• To implement a company specific rule for creating automatic invoice
and revenue events, you must first write a PL/SQL procedure that
calculates the event amount. Enter the name of the PL/SQL procedure
on the billing extension page.
• Transaction Independent
• Transaction independent billing extensions are called once for each
contract line or associated project, depending on the extension
calculation level defined in the bill or revenue plan. They are usually
defined to import transactions from external applications. If the
billing extension is for invoices, the extension is called during the
Generate Invoice process before the invoice preprocessor, which
creates billing transactions. If the billing extension is for revenue,
the extension is called during the Generate Revenue process before
revenue transactions are processed.
Note
If you do not enable the transaction independent feature of a billing extension,
it will be transaction dependent. Transaction dependent billing extensions
Call Process
The call process determines whether to call the PL/SQL procedure that
calculates the amount during invoice generation or revenue generation.
Note
If you require a procedure to create both automatic invoice and revenue events,
you must create two separate billing extensions.
Call Location
Select a location (time) within the invoice or revenue generation program where
the billing extension is called. The predefined locations are:
• Before billing transaction creation
• Select this location if you want to call the billing extension before any
recognizing revenue or calculating invoice amounts for the contract
line or project and contract line combination.
• An example of a requirement for which you may want to use this call
location is if you want to place all unbilled, unpaid supplier invoice
items on hold so they are not billed; and to release the billing hold on
any unbilled, paid supplier invoice transactions that are on hold. You
can then bill the paid supplier invoice items during standard invoice
processing.
• After invoice and revenue distribution lines are created
• Select this option to call the billing extension after the revenue and
invoice processing is complete.
• Examples of requirements for which you may want to use this call
location are if you want to notify a project manager when an invoice
of a certain amount is created, or if you want to create a fixed fee event
that is dependent on the total transaction amount billed on the invoice.
• Before invoice deletion
• Select this option if you want to call the billing extension before
deleting invoice distribution lines. This call location is only valid for
invoice billing extensions.
Required Input
Specify whether an amount or percentage is required for entry when you
assign the billing extension to a bill or revenue plan. When you define a bill or
revenue plan that uses the billing extension, you must enter a specific amount or
percentage that is used when calculating the automatic invoice or revenue event.
After you write your procedures, store them in the database and test them to
ensure that your billing extension logic works as expected.
You use the Create Billing Extensions page to define billing extensions.
Note
This step assumes that an event type has already been defined for the default
event type.
Billing Extension
Use the Billing Extension to implement company-specific business rules to
automatically create invoice or revenue events. Billing extensions automatically
calculate summary invoice or revenue amounts during invoice or revenue
generation.
• LINE
• PROJECT_CONTRACT_LINKAGE
p_bill_frm_date Invoice or revenue from date.
p_bill_to_date Invoice or revenue to date.
p_amt Invoice amount or revenue amount. This is
generally used when the extension calling place is
AFTER_DRAFT.
p_percent Percentage
p_assignment_detail_id Assignment detail identifier pjb_assignment_details.
p_extension_id Billing extension identifier obtained from table
pjb_billing_extensions.
p_assignment_id Assignment identifier
p_event_type_id Event type identifier from pjb_event_types_b.
p_default_event_type_description Event type description identifier from
pjf_event_types_tl.
p_cost_fin_plan_type Cost financial plan type identifier. This is generally
used when the invoice or revenue method is Percent
Spent.
p_invoice_id Invoice identifier
• S (for success)
This billing extension can derive the receiver expenditure type and receiver
expenditure organization based on the parameters you enter.
Parameters
Information about parameters for this billing extension are in the table below.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Parameters
Information about parameters for this billing extension are in the table below.
• FORECAST
p_contract_id Number
p_expenditure_item_id Number
x_amount Number
Oracle Fusion Projects uses the labor billing extension for rate-based invoice
method classifications or rate-based and as-incurred revenue method
classifications during the invoice or revenue generation process. During
processing, if Oracle Fusion Projects encounters a transaction that has a derived
bill amount from a labor billing extension, it skips the standard bill amount and
rate calculation section of the revenue generation process for that transaction.
Design Issues
• What are the conditions and circumstances in which you cannot use
the standard, rate-based invoice and revenue method classifications
supported by Oracle Fusion Projects?
• How are the invoice and revenue amounts calculated in these cases?
• How do you store rates and other information that your calculations may
require? How are the rates and other information maintained?
• What are the exception conditions for your labor billing extension? What
is the exception handling if you cannot find a rate that should exist?
You can use the Nonlabor Billing Extension to implement unique nonlabor
invoice methods or revenue methods. Some examples of how you can use the
Nonlabor Billing Extension are for:
The Nonlabor billing extension procedure Oracle provides can be called during
either the invoice or revenue generation process to determine the nonlabor
invoice or revenue amounts.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Parameters
Information about parameters for this client extension are below.
Bill Rate
If you specify that your amount is based on a bill rate, Oracle Fusion Projects
populates the bill rate of the expenditure item by dividing the bill amount by the
number of hours. If you specify that your amount is a markup, Oracle Fusion
Projects does not set the bill rate.
Status
Use the x_status parameter to handle error conditions for your procedure. This
parameter indicates the processing status of your extension as described in the
following table.
Status Description
x_status = 0 The extension executed successfully.
x_status < 0 An Oracle error occurred and the process
did not complete. Oracle Fusion Projects
writes an error message to the process
log file and rolls back the transactions
processed for the entire project.
x_status > 0 An application error occurred. Oracle
Fusion Projects writes a rejection reason to
PA_EXPENDITURE_ITEMS.REV_DIST_
REJECTION_CODE and does not mark
items as revenue distributed. You can
review the rejection reason in the revenue
generation exception report.
Important
Do not change the name of the extension procedures or parameters. Also, do not
change the parameter types or parameter order in your procedure. After you
write a procedure, compile it and store it in the database.
Information about parameters for this billing extension are in the table below.
• S (Successful)
• E (Error)
Varchar2
x_msg_count Message count. Valid values are:
Number
x_msg_data Actual message in case of any errors. Default value
is Null.
Varchar2
Oracle Fusion Projects calls the Receivables Transaction Type Extension during
the Transfer Invoices to Oracle Fusion Receivables process.
Important
Parameters
Information about parameters for this billing extension are in the table below.
Corresponds to column
CONTRACT_CURR_INV_AMT in the
PJB_INVOICE_LINES table.
p_Contract_Curr_Code Contract currency code, Varchar2
• S (Successful)
• E (Error)
Transaction independent billing extensions are executed for each contract with
an active billing assignment, even if there are no transactions to process. This
type of billing extension relies on input other than billable transactions on a
contract.
Note
Project Performance Reporting Configuration: Manage Project Units: Performance Reporting Options 49-1
• Resource breakdown structure, for migrating all summary data from
one resource breakdown structure version to the next. If you select this
option you must also specify the resource breakdown structure header.
• Specify whether to summarize budget and forecast, commitment, actual
cost, revenue and invoice, and client extension transactions.
• Daily proration
Note
You cannot change the planning amount allocation basis if summarized data
exists.
Assume that a project includes a task for team members to undergo some
product and soft skills training. A budget of $5900 is allocated to this task
between 1 January 2011 and 28 February 2011. While summarizing using a
monthly accounting calendar, the application can allocate the planned amount in
three ways.
Allocate the entire budget of $5900 to the first period of January 2011 regardless
of when the training takes place. This allocation method could impact period to
date cost variance measures for January and February if the actual training costs
occur in February. The period start date basis method is the default option.
Allocate the entire budget of $5900 to the last period of February 2011 regardless
of when the training takes place. This allocation method could impact period to
date cost variance measures for January and February if the actual training costs
occur in January.
Distribute the budget of $5900 equally over the entire period so that $3100 is
spent in January 2011 and $2800 is spent in February 2011. The following shows
how the budget is distributed:
• Allocate the total amount of $5900 and dividing it by the total number of
days to arrive at the daily amount.
Total Number of Days = 31 + 28 = 59
Project Performance Reporting Configuration: Manage Project Units: Performance Reporting Options 49-3
start or end date basis. To distribute plan amounts evenly across plan duration,
the application creates a summarized record for each day for the affected projects
and tasks in the project unit.
Using the daily proration basis method reduces the chances of impacting period
to date cost variance measures for January and February.
Certain financial plan types are included in summarization by default, while you
must manually select others. Approved forecast and baseline budget versions of
the following financial plan types are automatically included in summarization
of project performance data:
Apart from the default financial plan types, you can include up to four others in
summarization of project performance data.
How can I update project performance data and generate KPI values?
The project manager must run summarization for the selected project using the
Actions menu in the Project List region on the Project Performance Reporting
dashboard. The project manager must use the Important Dates or the Data
Updates window to update project performance data if the data is not current or
if there are unprocessed transactions.
To update performance data for all projects in a project unit, the projects
application administrator must run the Update Project Performance Data
process. After you update project performance data you must generate key
performance indicator (KPI) values again. If you have not chosen to generate
KPI values automatically after updating project performance data, you should
generate KPI values manually.
You must generate KPI values manually when you enable a new KPI for use and
want to view it in the KPI watchlist. You may update data manually if you need
to look at the data less frequently, such as, at the end of a period.
• Run the Update Project Performance Data process for a project from the
Project Performance Dashboard or Projects Overview area.
• Enable the reporting option on the project unit to summarize project data
before generating key performance indicators.
Important
What happens when I select a planning amount allocation basis for the project
unit?
The Period Start Date option allocates amounts based on the period start
date. The Period End Date option allocates amounts based on the period end
date. The Daily Proration option spreads plan amounts evenly across the plan
duration.
Project Performance Reporting Configuration: Manage Project Units: Performance Reporting Options 49-5
49-6 Oracle Fusion Applications Project Financial Management Implementation Guide
50
Project Performance Reporting
Configuration: Define Key Performance
Indicators
Performance Measure
Oracle Fusion Project Performance Reporting provides both fundamental and
derived measures that present an objective insight into the performance of the
project. In addition, you can create custom measures to meet the unique needs of
your organization. Use any delivered or custom performance measure to create a
KPI.
Performance measures are available in the areas of budgets and forecasts, billing
and revenue, costs, effort, margin, capitalization, and more. Following are
examples of predefined performance measures:
Threshold Level
During KPI definition, you define threshold levels to cover all possible values for
a KPI. If a KPI value exceeds the range of values defined for the KPI threshold
A status indicator can be associated with more than one threshold level. For
example, both underutilization and overutilization of resources can indicate a
critical performance status.
Trend Indicator
Performance trend indicators give an immediate picture of improving or
worsening KPI value trends on the project. Icons with unique colors and shapes
indicate whether an increasing performance trend has a positive or negative
impact. For example, an increase in nonbillable costs is considered unfavorable
to organizations that are able to bill costs to their clients. In this example, the
performance trend indicator will show a negative impact.
Tolerance Percentage
A tolerance percentage is used to compare the previous KPI value to the current
value to show if the performance trend is increasing, decreasing, or staying
the same. For example, if the tolerance percentage is 10 percent for a KPI, and
the difference between the previous KPI value and current value is greater
than 10 percent, then the trend is increasing. If the difference is greater than -10
percent, then the trend is decreasing. If the difference is between -10 percent
and 10 percent, then the trend shows no change. A single tolerance percentage
value, such as 10 percent in this example, represents both negative and positive
tolerances.
When you generate KPI values, the period for which KPI values are being
generated is determined by the KPI Period Determination Date. The data during
that period is used to generate project performance data that will be populated
on the project performance dashboard.
Note
KPIs that are enabled for use in the KPI definition are included when KPI values
are generated.
Project Unit
KPIs are created for specific project units. During project unit implementation
you specify whether KPIs are tracked for the project unit.
Settings Description
KPI Period Determination Date Set the date used to derive the project calendar
and accounting calendar periods for performance
measure calculations when KPI values are
generated.
Replace Current KPI Values Replace the current KPI values with the values that
are generated now.
Delete Previous KPI Values Delete the KPI values that were generated the
previous time the generate KPI values process was
run.
Number of Days to Retain KPI Values Retain KPI values for the specified number of
days starting from the current date before deleting
previous KPI values.
For example, assume KPI values were generated on the following dates:
If you generate KPI values on November 18, 2010 and select to replace the
current KPI values, the KPI values generated on November 12, 2010 are deleted
and replaced with KPI values generated on November 18, 2010. You must select
to replace the current KPI values for a given period if you want to retain one set
of KPI values and review KPI values during the period.
You can also delete KPI values that are not required for reporting. The options,
Delete Previous KPI Values and Number of Days to Retain KPI Values, enable
you to delete KPI values that were generated prior to a specific number of days.
For example, if today is November 18, and you want to remove all KPI values
generated in the previous year, you must select to delete previous KPI values,
and set Number of Days to Retain KPI Values to 322. All KPI values created
since January 1, 2010 are retained and KPI values generated before that period
are deleted.
Important
• When you are generating KPI values for the first time in a period.
When you generate KPI values, you can select to receive a notification by e-mail
by enabling workflow notifications, once KPI values are generated.
For example, KPI values are generated for a KPI period determination date of
August 24 at 8:15 a.m. for Projects A and B. Then KPI values are generated for a
KPI period determination date of August 24 at 10:45 a.m. just for Project B. The
KPI values for Project B generated at 8:15 a.m. are deleted, but KPIs belonging to
Project A are retained.
Note
The application calculates performance status for individual tasks and resources
for percentage-based key performance indicator (KPI) values.
Note
You can track performance by task and resource only for KPI values that are
expressed as a percentage.
The ITD Nonbillable Cost as a Percentage of Total Cost KPI value for the
Definition task is 10.53% (6,000/57,000). Based on the threshold levels defined
for this KPI, the Definition task shows the At Risk status indicator.
If you track tasks and resources for a project, each task and resource with a
KPI value that is not on track is designated as an exception. The KPI value for
the project does not impact the exception designation for individual tasks and
resources. For example, if a task has a Critical status indicator based on the KPI
value and threshold definition, it is designated as an exception even if the project
has an On Track status indicator.
Important
Task and resource performance status is based on the latest summarized data,
which may not be the same as the summarized data used to generate the latest
KPI values.
Scenario
A company is in the business of selling and installing human resource software.
One of the standard KPIs used for the installation projects is Period-to-Date
(PTD) Invoice Amount. Installation projects are performed in different countries
having different project and ledger currencies, such as, United States dollars,
Japanese yen, Mexican pesos, and Indian rupees. Projects performed using
currency in United States dollars have a higher threshold for criticality with
respect to PTD invoice amounts. This is reflected with unique currency threshold
definitions.
What's the difference between key performance indicator and KPI category?
Date used to determine the accounting calendar and project accounting calendar
periods for performance measure calculations during key performance indicator
(KPI) value generation.
For example, assume that your project uses a monthly accounting calendar and
a weekly project accounting calendar. You generate KPI values on December 8,
2010 with a KPI period determination date of November 30, 2010. The current
period for KPI generation is determined based on the type of calendar used. In
the accounting calendar, the date November 30, 2010 falls into the November
2010 period. In the project accounting calendar, November 30, 2010 falls in the
first week of December 2010.
Note
The KPI period determination date must be a date in the past.
Why can't I create or edit a key performance indicator for a project unit?
Since the project unit is not enabled to track key performance indicators.
What happens if I attach different KPIs to a project for the same measure?
Overall project health is based on the most severe KPI status even if you have
more than one KPI that uses the same performance measure.
For example, assume the Financial category contains three KPIs, and two of
those KPIs use the same performance measure with two different threshold
definitions. If the KPI status falls in the critical and on track ranges for the two
KPIs that use the same performance measure, and the KPI status is on track for
the third KPI, then the overall project health is critical. If the KPI status is on
track for the two KPIs that use the same performance measure, and is critical for
the third KPI, the overall project health is still critical.
Yes. You can track key performance indicators (KPIs) that have a percentage
measure format. Tracking by task and resource for a project enables you to
identify problem areas on the task structure and resource structure during KPI
analysis.
What happens if a KPI value exceeds the threshold limits defined for the KPI?
Where do the currency type options for a key performance indicator come
from?
The currency type appears for a selection only if the currency type is enabled for
summarization for the project unit.
Where do the calendar type options for a key performance indicator come
from?
The calendar type appears for a selection only if the calendar type is enabled for
summarization for the project unit.
You must use the Review Project Performance page to perform more detailed
financial performance analysis for a project than is possible on the Project
Performance Dashboard. You can review amounts at the task or resource level,
and drill down to individual expenditure items.
Note
KPI trends may not be useful if KPI values are generated often. The reason is, if
the tolerance percentage is 10 percent and KPI values are generated every day,
the values decrease by 1 percent each day. In this scenario, no change is observed
in the trend as the decrease is well within the tolerance. However, if you generate
Note
All values in the following tables are percentages unless specified otherwise.
After generating KPI values on January 15, 2011, the most critical KPI is PTD
Actual Invoice Amount. The overall project health status is Warning, because the
most critical KPI, PTD Actual Invoice Amount, has a status of Warning.
This table shows how the trend indicator is calculated based on the previous
period. Although the KPI values for the current period are different from the
previous period, the difference in the values is not significant enough to change
the trend indicator, based on the tolerance percentage defined for each KPI. For
example, the PTD Actual Spent Labor Effort Percentage is 71 percent, compared
to the previous period KPI value of 70 percent. If the current period KPI value is
more than 73.5 percent, which is more than 5 percent higher than the previous
period, then the trend indicator is Up, Favorable. If the current period KPI value
is less than 66.5 percent, which is more than 5 percent lower than the previous
period, then the trend indicator is Down, Unfavorable.
The overall project health status is Warning, based on the most critical of all KPI
statuses. After generating KPI values on February 15, 2011, the most critical KPI
is PTD Actual Invoice Amount.
This table shows how the trend indicator is calculated based on the previous
quarter. The current KPI values are compared to the latest generation date of
KPIs for the previous quarter.
Note
It is possible that the previous period trend and the previous quarter trend are
calculated based on KPI values from the same generation date. This occurs when
the previous period generation date is the same as the latest generation date in
the previous quarter.
The first three KPI values changed enough since the previous quarter to change
the trend calculator. For example, the current quarter value of PTD Actual
Invoice Amount is $3,500, which exceeds the threshold tolerance of 5 percent
from the previous quarter KPI value of $4,800. Therefore the KPI is in a Critical
status, and the trend indicator is Down, Unfavorable. If the current quarter value
is greater than $5,040, which is more than 5 percent higher than the previous
quarter, then the trend indicator is Up, Favorable.
A project manager might review the KPI values, statuses, and trends shown in
this table and determine that a transaction was not billed, because the KPIs that
are based on revenue and invoice amounts have both dropped.
The overall project health is critical because of the status of the PTD Actual
Invoice Amount.
Why did the trend indicator show a downward trend when KPI performance is
improving?
Performance measures that are based on effort hours are effort-based. Examples
are, actual spent labor effort and actual spent equipment effort.
Note
KPIs that are percentage-based can be tracked at the task, resource, and project
levels.
Period-to-date amount-based measures use the same threshold values for all
phases of the project. This may result in a spike in the key performance indicator
(KPI) values if the amounts used to calculate the KPI values vary widely
throughout the project. To avoid this problem, consider using different sets of
threshold values for amount-based KPIs defined in small and large projects.
Project Performance Reporting Configuration: FAQs for Manage Performance Measures 51-1
51-2 Oracle Fusion Applications Project Financial Management Implementation Guide
52
Project Performance Reporting
Configuration: FAQs for Define Region
Personalization
Yes. Using the Personalization option you can select the Edit Current Page
option in the Personalization list to show or hide regions. You can also modify
the arrangement of the region layouts using the Change Layout option.
Project Performance Reporting Configuration: FAQs for Define Region Personalization 52-1
52-2 Oracle Fusion Applications Project Financial Management Implementation Guide
53
Project Integration Gateway
Configuration: Overview
Oracle Fusion Project Integration Gateway ensures data security, integrity, and
efficiency by:
The business unit you select determines the currency used to display amounts
in Oracle Fusion Project Management after you transfer project and task
information. This currency is the primary ledger currency of the business unit.
The project unit you select determines which resource breakdown structure you
can select as the integration planning resource breakdown structure that is the
source of resources exported to Oracle Fusion Project Management.
Restriction
All projects exported from Oracle Fusion Project Foundation must use the
integration planning resource breakdown structure as their primary planning
resource breakdown structure.
Note
If you delete a planning resource after exporting it, the linked project enterprise
resource is not deleted in Oracle Fusion Project Management.
Restriction
You cannot export projects if you previously exported them to another
scheduling application using Oracle Fusion Project Integration Gateway.
The initial export links project and task information in the two applications,
and enables you to incrementally export project and task data to Oracle Fusion
Project Management. In Oracle Fusion Project Management, you can add
subtasks under the exported tasks. You can also assign resources to the subtasks
to complete detailed planning.
Restriction
After you export a project, you cannot delete the exported tasks, increase or
decrease indent, or move the exported tasks within the project plan in either
application.
Tip
Restriction
Default period profile Default period profile to use if Oracle Fusion Project
Portfolio Management must change the calendar
type for a project when importing the project plan.
(The calendar type selected on the planning options
of the associated project plan type must match the
calendar type specified in the integration options.)
Note
Note
If you delete a previously exported resource in Oracle Fusion Projects, then
mapping information is deleted. The corresponding resource is not deleted in
Primavera P6 Enterprise Project Portfolio Management but is then treated as a
nonintegrated resource when you subsequently import project plan information.
During export, Oracle Fusion Projects transfers information for each resource as
appropriate. Exported information includes:
• Resource name
• Resource ID
• Resource class and format
• Resource enabled indicator
Warning
Resource and role names are limited to 100 characters and expense category
names to 36 characters in Primavera P6 Enterprise Project Portfolio Management.
Therefore, resource, role, and expense category names are truncated if their
length is over the limit.
The following table describes how changes in the task structure in Oracle Fusion
Projects affect the WBS of a linked project during a subsequent export.
Note
Warning
Primavera P6 Enterprise Project Portfolio Management restricts the length of
project names and project IDs to100 and 20 characters respectively. Therefore,
project names and numbers from Oracle Fusion Projects are truncated if their
length is over the limit.
System Status in Oracle Fusion Projects Status in Primavera P6 Enterprise Project Portfolio
Management
Unapproved Planned
Submitted Planned
Approved Active
Pending Close Active
Closed Inactive
Note
Note
Important
Yes. You can change the project or task owning organization at any time, unless
unprocessed transactions exist for the project. You can also simultaneously
reprocess transactions for the affected tasks. Note that the project or task owning
organization has no effective as-of date. Therefore, the new organization applies
for the duration of the project.
Project executives, project accountants, and billing specialists can use the
information exported to Oracle Fusion Projects for financial planning, project
costing, billing and revenue accrual, and performance reporting.
• Import actual quantities and costs into Microsoft Project for progress
collection.
Importing Projects
You can import a template or an existing project from Oracle Fusion Projects
to create a new project file in Microsoft Project. During import, select to import
all project information or only planning resources. If you want to subsequently
export new task assignments for the project to Oracle Fusion Projects, you must
import resources from the primary planning resource breakdown structure.
While importing from Oracle Fusion Projects, you cannot select templates whose
primary planning resource breakdown structure allows changes at the project
level. This restriction does not apply when importing projects.
When importing an existing project, retain the link if you intend to synchronize
the project. If you only want to view project details, or intend to export the
project to Oracle Fusion Projects as a different project later, then do not retain the
project link.
Restriction
You cannot retain the project link if third-party scheduling is disabled for the
project.
Exporting Projects
You can export a project from Microsoft Project to create a new project in Oracle
Fusion Projects. Exporting links the projects in the two applications. Optionally,
set a baseline for the project plan, and simultaneously generate a budget version
and create a baseline.
When exporting a project, you must select a source project or template unless
you had originally imported a project or template from Oracle Fusion Projects.
The source project or template must allow for third-party scheduling and the
associated primary planning resource breakdown structure must not allow
changes at the project level.
The following table describes the default direction in which attributes are
transferred.
Before import, rates are derived for each resource based on the actual or
planning rate schedules specified on the associated project plan type. Any
override rates you specify on the project plan in Oracle Fusion Projects are not
imported.
Restriction
If burdening is not enabled on the project type, then you can export progress
with raw cost. If burdening is enabled, then you must use burdened cost to
export progress. That is, set the Cost Type synchronization option to Burdened
cost.
Oracle Fusion Projects checks all levels of chargeable controls when you try to
charge a transaction to a project. The check is performed when you save the
record.
Oracle Fusion Projects checks the chargeable status when you enter a new cost
transaction or transfer expenditure items to another project or task.
Inclusive transaction controls prevent all charges to a project or task except the
charges you specifically allow. Specify the types of expenditures that you want to
be chargeable and enable the Chargeable option.
• Classification
• Team Member
Note
• Legal Entity
• Organization
• Project Name
• Project Number
Note
After creating the project, you can add further values to the fields in the project.
Chargeable Status
You can further control charges for each transaction control record by specifying
whether to allow charges. The default value is to allow charges.
You usually select Chargeable when you are using inclusive transaction controls.
For example, if you wanted to allow people to charge only labor to your project,
you would define a transaction control with the Labor expenditure category, and
allow charges to the project or task.
You usually do not select Chargeable when you are using exclusive transaction
controls because exclusive transaction controls list the exceptions to chargeable
transactions.
Note
The billable or capitalizable status of an individual transaction takes precedence
over the billable or capitalizable status of a task.
Each project team member is automatically assigned a project space role on the
associated project space. The project manager is assigned the role of project space
moderator. All other team members are project space participants.
The security profiles that HCM roles need to access Transactional Business
Intelligence are assigned during the setup of HCM data security: no additional
setup is required for Transactional Business Intelligence purposes.
This example shows how to assign a security profile to a job or abstract role to
enable users with that role to access person data. This task is required for users
of Oracle Fusion Transactional Business Intelligence (Transactional Business
The following table summarizes key decisions for this scenario. When
performing this task, use the job or abstract role for your product and the name
of the relevant predefined person security profile in place of those shown here.
Field Value
Search Tasks
Name Manage Data Role and Security
Profiles
3. Click Search.
4. In the search results, click Go to Task for the Manage Data Role and
Security Profiles task.
• For example, the Oracle Fusion Payables Java EE application contains the
Oracle Fusion Expenses product view objects. To create or maintain a job
definition for use in Expenses, you select the Manage Custom Enterprise
Scheduler Jobs for Payables and Related Applications task.
• In another example, the Oracle Fusion Payments product view objects are
contained in both Oracle Fusion Payables and Oracle Fusion Receivables
Java EE applications. You need to select the task appropriate to the job
definition for Payments. Use the Manage Custom Enterprise Scheduler
Jobs for Receivables and Related Applications task if the job is for
receivables functionality, or the Manage Custom Enterprise Scheduler
Jobs for Payables and Related Applications task if the job is for payables
functionality.
• Use the task description to see the products that correspond to the Java
EE application specified in the task name. For example, the description
for the Payables task lists Oracle Fusion Payables, Assets, Expenses, and
Payments.
• You can view task descriptions in the help window for the task, if any,
or in the generated setup task lists and tasks report from the Getting
Started page.
• If you have access to the Manage Task Lists and Tasks page, you can
also open the details for specific tasks to see the description.
A list of values source for Oracle Enterprise Scheduler job definitions determines
where a list of values comes from and what the specific values are. These lists
of values are used in parameters and user properties of job definitions. For
example, you can use a source of country values for a Country job parameter.
Editing Pages
• Customizations that you can make to existing pages include adding
content and changing layout.
See: Editing a Page in Page Composer
• You can also update display and other options for specific components
within the page.
See: Editing Component Properties in Page Composer
Managing Customizations
• Use the Manage Customizations dialog box to analyze and diagnose
customization metadata, and to perform customization related tasks that
cannot be done in the user interface, for example to revert customizations
to a previous version. You can also do direct customization by
manipulating the metadata and uploading it back.
See: Viewing and Diagnosing Runtime Customizations
Sandboxes
• Create or select an appropriate sandbox, and set it as active to capture
your customizations using Page Composer. When you are ready, you
publish the sandbox to make your changes available to users.
Sandboxes: Highlights
Use a sandbox to commit customizations to a runtime use session for validation
before deploying changes to the mainline. Administrators create and manage
sandboxes. An active sandbox isolates changes from the mainline and other
users.
Sandboxes can contain the following types of customization changes.
• Metadata, such as non-flexfield UI page customizations
• Data security
• Generated flexfields business components
Metadata changes are captured in a metadata sandbox. Data security changes are
additionally captured in a data security enabled sandbox. Changes to a flexfield
are captured in a flexfield that is deployed as a single flexfield sandbox. Once
you are ready to make sandbox changes available in the mainline, you either
publish the metadata or data security sandbox, or deploy the flexfield. Only
metadata and data security sandboxes can be downloaded as a sandbox file for
import to another Oracle Fusion Applications instance.
The following table lists the differences among the types of sandboxes.
Only one sandbox can be active at a time. Changes made while a sandbox is
active are captured in that sandbox.
For more information on using the Sandbox Manager, and customizing and
securing pages, business objects, data, and custom objects in a sandbox, see the
Oracle Fusion Applications Extensibility Guide.
Edit the Mapping Service for Contextual Addresses profile option value. A
contextual address is marked with an orange square icon that can be clicked
• ProjectStatusChangeApproval.process -
a service that accepts the change in project
status.
• ScheduleOrchestrationOrderFulfillmentLineService.scheduleOrd
- a service that schedules resources used to
fulfill an order.
You can import data into or export data out of Oracle Fusion Applications using
repositories of content and processes for import and export.
Aspects of managing files for import and export involve the following.
• File size
The File Import and Export page lets you upload content to, or download
content from the document repository of Oracle WebCenter Content
Management.
Search criteria on the page are limited to the minimum metadata of content
management records needed for file import and export.
Everyone who uses the File Import and Export page is assigned to one or more
accounts in content management.
When you create a record, you must specify an account as well as the file. When
you create a record, you must specify an account as well as the file. The account
you specify determines which import process picks up that file to import it.
You can upload any file formats that can be parsed by the content repository
being used, such as any MIME or content types. However, the format uploaded
should conform to the requirements of the import process being used, such as a
comma-separated values (CSV) file for the Load Interface File for Import process.
Processes you run to export data result in files in content management. Records
in the search results table of the File Import and Export page provide links to the
files for download.
Note
File Size
Upload and download does not intentionally apply the following:
• Data compression
Interaction between the File Import and Export page and Oracle WebCenter
Content Management requires securing content in an account. Oracle provides
predefined accounts in Oracle WebCenter Content.
• Security
• Searching records
• Account names
Security
The duty role needed for accessing the File Import and Export page is File
Import and Export Management Duty. This duty role is included in the
predefined role hierarchy for integration specialist roles and product family
administrator roles.
Files in Oracle WebCenter are associated with an account so that only users who
have permission to a particular account can work with content items that belong
to that account. You can only upload and download files to and from content
management that are associated with accounts that you are entitled to access.
Oracle WebCenter Content does not support trailing slashes (/). Account names
are appended with a $ to ensure each account is unique. Account names are
dynamic so that if they overlap (one name is completely contained in another,
longer name, such as US and USSales), each account is treated as discrete by
access grants.
Searching Records
A record in Oracle WebCenter content management contains metadata used for
accessing the file.
When a scheduled process has run to completion on a file, the ecord for the file
includes a process ID.
Account Names
If you create custom accounts for importing or exporting data, use the following
conventions for naming the account: Do not include a slash "/" at the beginning
or end End with "$" to avoid partial string matching Use "$/" as a separator in
the hierarchical structure.
For example: fin$/journal$/import$ The File Import and Export page transforms
account names by removing the $s. For example fin$/journal$/import$ displays
as fin/journal/import. The Remote Introdoc Client (RIDC) HTTP command-line
interface (CLI) transforms the account name you specify without $ symbols to
one that includes them. For example, fin/journal/import becomes fin$/journal
$/import$ in WebCenter Content.
Deleting Files
In the File Import and Export page, you can delete one file at a time. To delete
multiple files at a time from content management, use the content management
server's standard service user interface.
Use External Data Integration Services for Oracle Cloud to load data into Oracle
Fusion Applications from external sources, such as legacy systems and third-
party applications.
• Templates and control files for formatting, structuring, and generating the
data file.
• A general file load process for loading values from the data file into
interface tables.
To use External Data Integration Services for Oracle Cloud to load data into
Oracle Fusion Applications tables:
1. Prepare your data and generate a data file by using the product-specific
templates and control files.
2. Transfer the data file to the integrated content management server.
3. Run the Load Interface File for Import process.
4. Correct data load errors, if necessary.
5. Run the appropriate application-specific process for validating and
inserting the data into application tables.
6. Correct data import errors, if necessary.
For templates and control files, see assets with the File-Based Data Import
type in Oracle Enterprise Repository for Oracle Fusion Applications (http://
fusionappsoer.oracle.com). For more information, see the Documentation tab for
the Load Interface File for Import process in Oracle Enterprise Repository.
External data that you integrate into your Oracle Fusion Applications must be
structured and formatted according to the properties of the fields and tables
that store the data. To prepare external data so that data types, structural
relationships, and other properties of the data correctly align to the data types,
structural relationships, and properties of the target tables, use the product-
specific templates and control files in Oracle Enterprise Repository for Oracle
Fusion Applications.
Field Value
Search String FBDI
Type FusionApps: Scheduled Process
Note
You can further narrow the search by logical business area.
4. Click Search.
The search displays a Load Interface File for Import job.
1. Open the XLS template. The first worksheet in each template provides
instructions for using the template.
Important
If you omit or fail to complete the instructions, data load errors and data import
failure are likely.
The package generates the CSV file and compresses it into a ZIP file.
Note
In Oracle Cloud implementations, you must upload the ZIP file to the content
management server in Oracle Cloud. In non-Cloud implementations, you can
streamline the data integration process by installing the content management
document transfer utility so ODI performs the ZIP file transfer.
Templates
This list details the characteristics of the templates:
• The worksheet columns appear in the order that the control file processes
the data file.
• The columns that you do not intend to use can be hidden, but not
reordered or deleted.
Important
Deleting or reordering columns will cause the load process to fail and result in
an unsuccessful data load.
• The external data must conform to the data type that the control file and
process for the associated database column accepts.
• For columns that require internal ID values, refer to the bubble text for
additional guidance about finding these values.
To use the XML templates and generate the import files, you must:
Note
In Oracle Cloud implementations, you must upload the ZIP file to the content
management server in Oracle Cloud. In non-Cloud implementations, you can
streamline the data integration process by installing the content management
document transfer utility so ODI performs the ZIP file transfer.
Oracle Data Integrator provides a solution for integrating complex data from
a variety of sources into your Oracle Fusion applications. The Oracle Fusion
Middleware Installation Guide for Oracle Data Integrator and the Oracle Fusion
Middleware Developer's Guide for Oracle Data Integrator provide complete
details pertaining to the installation and set up of this product.
• Family-level
• Product-level
• Product
Consider the following points when you use family-level XML files:
• The family-level XML file supports all of the Oracle Enterprise Repository
assets in the family, for example Oracle Fusion Financials or Human
Capital Management.
• You import the family-level XML file into your Oracle Data Integrator
repository prior to importing the other XML files.
• You import one family-level XML file as a model folder for each family of
products.
• You import the family-level XML file one time; it supports all subsumed
product-level model folders.
• You import one product-level XML file as a model folder for each line of
products.
• You import the product-level XML file as a model folder into your Oracle
Data Integrator repository after you import the family-level XML file, but
before you import product XML files.
• You import each product-level XML file as a midlevel model folder within
the appropriate family-level model folder.
• You import the product-level XML file one time; it supports all subsumed
product models.
Consider the following points when you use product XML files:
• You import one product XML file as a model for each interface table or set
of tables, for example Mass Additions.
• You import the product XML file as a model into your Oracle Data
Integrator repository after you import the product-level XML file.
• You import each product XML file as a model within the appropriate
product-level model folder.
• After you import the product model, you connect the model to the correct
logical schema.
After you generate the comma-separated values (CSV) file, transfer it to the
content management server.
For details about programmatic file transfer using the Oracle WebCenter Content
Document Transfer Utility, refer to documentation resources in Oracle Enterprise
Repository for Oracle Fusion Applications (http://fusionappsoer.oracle.com).
• Target accounts
Target Accounts
You must transfer files to the predefined account in content management that
corresponds to the interface table or assets.
• Customer Import
You can create subaccounts for further file organization. However you need
to create the subaccount under the predefined account for the asset you are
integrating.
To access your transferred data you must access the account that corresponds to
the interface table or asset appropriate for the data.
Available data integration processes move the content into and out of Oracle
Fusion Applications tables. Running an import or export process creates a
process ID in content management that you can use to identify the content you
wish to overwrite or extract.
Oracle Enterprise Scheduler import process jobs result in the following hierarchy
of items in Oracle WebCenter Content Management:
• A root import job is a list of all unprocessed files in an account. This job
submits the child jobs that process each unprocessed file.
• A parent import job is a single file ID, account name, and the import steps
(download, extract, import) for a single job, job set, or subrequests. This
type of job tags the file with its request ID, provided the file is not deleted
immediately after successful import.
• A child import job is a direct data load from a prepared file, typically a
SQLLoader. Typically, the parent import job submits this job.
Parameters
Import Process
Data file
Enter the relative path and the file name of the ZIP data file on the content
management server.
The final destination for your external data is the application data tables of your
Oracle Fusion Applications product.
Interface tables are intermediary tables that store your data temporarily while
the system validates format and structure. Run the Load Interface File for Import
scheduled process to load data from the data file into the interface table that
corresponds to the template that you use to prepare the data.
To load your data into interface tables, submit the Load Interface File for Import
scheduled process:
Note
c. The data file is retained on the content management server when the
process is complete.
6. Submit the process.
If no errors exist in the data file, then the process populates the interface
tables.
Run the import process appropriate to your data to import the data into
application data tables into the application tables of your Oracle Fusion
Applications product.
If you prepared your data using the spreadsheet template, select the
process named in the Overview section of the spreadsheet.
6. Submit the process.
Note
For more detailed information on the process used for data prepared using
the spreadsheet template, see the Instructions and CSV Generation tab of the
spreadsheet template
The Load Interface File for Import process ends in error if the load of the data file
fails on any row.
• The Load File to Interface child process ends in either warning or error.
• All rows that were loaded by the process are deleted, even those rows that
loaded successfully.
Import
In the target application instance, the setup import process will insert all new
data from the source configuration package that does not already exist and
update any existing data with changes from the source. Setup data that exists in
the target instance but not in source will remain unchanged.
Parameters
The common reference objects are represented as business objects. A single
object can be referenced in multiple setup tasks with different parameters. In the
configuration package that is created for the implementation project, parameters
passed to a setup task are also passed to the business objects being moved. As a
result, the scope of the setup tasks is maintained intact during the movement.
Dependencies
Common reference objects may have internal references or dependencies
among other common reference objects. Therefore, it is necessary that all the
dependencies are noted before the movement of objects so that there are no
broken references among the objects.
Business Object Name Moved Functional Item Effect on the Scope of Movement
Application Message Messages and associated tokens No parameters: all messages are
moved.
moduleType/moduleKey:
only messages belonging to
the specified module and its
descendant modules in the
taxonomy hierarchy are moved.
messageName/applicationId:
only the specified message is
moved.
Application Taxonomy Application taxonomy modules No parameters: all taxonomy
and components modules and components are
moved.
Application Attachment Entity Attachment entities No parameters: all attachment
entities are moved.
moduleType/moduleKey: only
attachment entities belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved.
Application Attachment Category Attachment categories and No parameters: all attachment
category-to-entity mappings categories and category-to-entity
mappings are moved.
moduleType/moduleKey: only
attachment categories belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy along with
the respective category-to-entity
mappings are moved.
moduleType/moduleKey:
only categories belonging to
the specified module and its
descendant modules in the
taxonomy hierarchy are moved.
moduleType/moduleKey: only
document sequences belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved
moduleType/moduleKey: only
descriptive flexfields belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved.
descriptiveFlexfieldCode/
applicationId: only the specified
descriptive flexfield is moved.
Note
Note
extensibleFlexfieldCode/
applicationId: only the specified
extensible flexfield is moved.
Note
Note
Application Key Flexfield Key flexfield registration data and No parameters: all key flexfields
setup data are moved.
moduleType/moduleKey: only
key flexfields belonging to
the specified module and its
descendant modules in the
taxonomy hierarchy are moved.
keyFlexfieldCode/
applicationId: only the specified
key flexfield is moved.
Note
Note
moduleType/moduleKey:
only value sets belonging to
the specified module and its
descendant modules in the
taxonomy hierarchy are moved.
Note
moduleType/moduleKey: only
standard lookups belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved.
moduleType/moduleKey - only
common lookups belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved.
moduleType/moduleKey: only
set-enabled lookups belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved.
moduleType/moduleKey:
only categories belonging to
the specified module and its
descendant modules in the
taxonomy hierarchy are moved.
moduleType/moduleKey: only
profile options and their values
belonging to the specified module
are moved.
moduleType/moduleKey: only
profiles and their values belonging
to the specified module are
moved.
categoryName/
categoryApplicationId: only
profiles and their values belonging
to the specified category are
moved.
determinantType/
referenceGroupName: only
assignments for the specified
determinant type and reference
group are moved.
Application Tree Structure Tree structures and any labels No parameters: all tree structures
assigned to the tree structure (and their labels) are moved.
moduleType/moduleKey: only
tree structures (and their labels)
belonging to the specified module
are moved.
moduleType/moduleKey: only
trees belonging to the specified
module are moved.
TreeStructureCode/TreeCode:
only trees belonging to the
specified tree structure and tree
code are moved.
moduleType/moduleKey: only
tree structures (and their labels)
belonging to the specified module
and its descendant modules in the
taxonomy hierarchy are moved.
moduleType/moduleKey: only
database resources/actions/
conditions/policies belonging
to the specified module and
its descendant modules in the
taxonomy hierarchy are moved.
Note
Application Activity Stream Activity stream options No parameters: all activity stream
Configuration options are moved.
Dependencies
The dependencies among the common reference objects may be caused by any of
the following conditions.
• Key flexfields may have an associated tree structure and key flexfield
segments may have an associated tree code
• Tree codes and versions may be defined over values of a value set
• Data security policies may be defined for value sets that have been
enabled for data security
You may choose to move one, some, or all of the business objects by including
the ones you want to move in your configuration package. For example, you
may choose to move only value sets and not lookups, or you may choose to
move both value sets and their lookups as part of the same package. Whatever
be the combination, it is recommended that during the movement of objects, you
follow an order that maintains the dependencies among the objects.
While moving the business objects, adhere to the guidelines and exactly follow
the order as listed below.
1. Move created taxonomy modules before moving any objects that reference
them, such as flexfields, lookups, profiles, attachments, reference data
sets, document sequences, messages, and data security.
2. Move created currencies before moving any objects that reference them,
such as territories.
3. Move created territories before moving any objects that reference them,
such as languages and natural languages.
4. Move created ISO languages before moving any objects that reference
them, such as languages, natural languages, and industries.
5. Move created tree structures before moving any objects that reference
them, such as trees or tree labels.
6. Move created profile options before moving any objects that reference
them, such as profile categories or profile values.
7. Move created attachment entities before moving any objects that reference
them, such as attachment categories that reference them.
Note
In scenarios where there may be dependencies on other objects, you must move
the dependencies before moving the referencing object. For example, if data
security policies being moved have dependencies on newly created security
roles, you must move the security roles before moving the security policies.
To move the common reference objects, you can use the Seed Data Framework
(SDF). You can also use the command line interface of SDF to move the object
Movement Dependencies
The seed data interface moves only the setup metadata. For example, if you use
SDF to import flexfield metadata, the flexfield setup metadata is imported into
your database. However, you must invoke the flexfield deployment process
separately after seed data import to regenerate the runtime flexfield artifacts
in the target environment. Similarly, if you use SDF to import data security
metadata, you must first move any new referenced roles and then manually run
the GUID reconciliation where required.
To ensure that the reference data is not lost during the movement, certain
guidelines are prescribed. It is recommended that you perform the movement of
object data exactly in the order given below.
Note
1. Move created taxonomy modules before moving any objects that reference
them, such as flexfields, lookups, profiles, attachments, reference data
sets, document sequences, messages, and data security.
2. Move created currencies before moving any objects that reference them,
such as territories.
3. Move created territories before moving any objects that reference them,
such as languages and natural languages.
4. Move created ISO languages before moving any objects that reference
them, such as languages, natural languages, and industries.
5. Move created tree structures before moving any objects that reference
them, such as trees or tree labels.
6. Move created profile options before moving any objects that reference
them, such as profile categories or profile values.
7. Move created attachment entities before moving any objects that reference
them, such as attachment categories that reference them.
8. Move created reference data sets before moving any objects that reference
them, such as reference data set assignments and set-enabled lookups.
9. Move created document sequence categories before moving any objects
that reference them, such as document sequences.
10. Move created tree labels before moving any objects that reference them,
such as trees.
11. Move created data security objects and policies before moving any objects
that reference them, such as value sets.
12. Move created value sets before moving any objects that reference them,
such as flexfields.
13. Move created trees before moving any objects that reference them, such as
key flexfields.
account rule
The rule that builds the account on a subledger journal entry. It can be used
to derive complete accounts or a segment value. Conditions can be defined
within a rule so that a different account is used based on particular attributes of a
transaction.
accounting attribute
Categories that classify transaction types and group event types for accounting
rules.
accounting flexfield
The chart of accounts that determines the structure, such as the number and
order of individual segments, as well as the corresponding values per segment.
accounting method
A set of journal entry rules which determine how a subledger journal entry is to
be created for each event class or event type.
accounting period
The fiscal period used to report financial results, such as a calendar month or
fiscal period.
action
activity
Glossary-1
element in the work breakdown structure of a project. Activities contain all the
information necessary to perform the required work.
ADF
Acronym for Application Developer Framework. A set of programming
principles and rules for developing software applications.
ADFdi
Abbreviation for Application Development Framework Fusion Desktop
Integration. A tool that allows you to export data from spreadsheet application
into Oracle Fusion applications.
allocation
An allocation is distribution of existing amounts between and within projects
and tasks.
allocation offsets
Reversing transactions that are used to balance allocation transactions with the
source or other project.
allocation rule
A set of attributes that describes how to allocate amounts in the source pool to
target projects and tasks.
application feature
A standardized functionality that is available to implemented.
application identity
Predefined application level user with elevated privileges. An application
identity authorizes jobs and transactions for which other users are not
authorized, such as a payroll run authorized to access a taxpayer ID while the
user who initiated the job is not authorized to access such personally identifiable
information.
application role
A role specific to applications and stored in the policy store.
Applications Core
Abbreviation for Oracle Fusion Middleware Extensions for Applications. The
technical product code is FND.
approved budget
A financial plan type designated as an approved cost budget, approved revenue
budget, or both, whose versions are used for specific purposes (for example, as
default budget versions for project performance reporting).
Glossary-2
ASN
assignment
automatic offset
A method for balancing invoice and payment journal entries that cross primary
balancing segment values.
balancing segment
A chart of accounts segment used to automatically balance all journal entries for
each value of this segment.
Key planned information for tasks and task assignments, including dates, costs,
quantity, effort, and rates, that you can save from current project plan values.
Setting a baseline for a project plan does not create a new plan version. Rather,
current plan information is saved in baseline columns of the current project plan.
beneficiary
bill plan
Glossary-3
billing control
A contract feature that controls the types of transactions, dates, and amounts a
customer may be invoiced for and revenue can be recognized for a contract or
contract line. Define billing controls at the contract or contract line level.
billing extension
BPEL
browsing category
burden cost
Burden costs are legitimate costs of doing business that support raw costs and
cannot be directly attributed to work performed.
burden structure
Determines how expenditure types are grouped into burden cost bases and what
types of burden costs are applied to the cost bases. A burden structure defines
relationships between burden cost bases and burden cost codes, and between
burden cost bases and expenditure types.
Glossary-4
burdened cost
Cost of an expenditure item, including the raw cost and burden costs.
business function
business object
business unit
A unit of an enterprise that performs one or many business functions that can be
rolled up in a management hierarchy.
calendar event
catalog
category
chart of accounts
class category
Method of classifying projects. For example, use class categories to define project
funding sources, investment strategies, or industry sectors. Class categories are
associated with a set of values called class codes.
class code
clause adoption
Reusing a clause from the global business unit in local business units either by
adopting the clause without change or by localizing it.
Glossary-5
clause localization
A type of clause adoption where the adopted clause is edited to suit the local
business unit needs.
clearing company
condition
An XML filter or SQL predicate WHERE clause in a data security policy that
specifies what portions of a database resource are secured.
constant
Holds the numeric value used to evaluate numeric conditions in Contract Expert
rules. A constant permits you to reset the conditions of many rules with just one
edit.
context
context segment
The flexfield segment used to store the context value. Each context value can
have a different set of context-sensitive segments.
context-sensitive segment
A flexfield segment that may or may not appear depending upon a context such
as other information that has been captured. Context-sensitive segments are
custom attributes that apply to certain entity rows based on the value of the
context segment.
contingent worker
contract deviations
Differences between the contract terms in a contract and those in the contract
terms template applied to that contract and any deviations from company
policies as determined by Contract Expert feature rules.
Contract Expert
A feature of the application that permits you to create business rules in the
Contract Terms Library to enforce corporate policies and standards for contracts.
Glossary-6
Contract Terms Library
cost center
cost organization
A legal entity that acts on behalf of several divisions within an enterprise, and is
the legal employer in a country.
data dimension
A stripe of data accessed by a data role, such as the data controlled by a business
unit.
The set of human capital management (HCM) data, such as one or more persons,
organizations, or payrolls, identified by an HCM security profile.
data role
A role for a defined set of data describing the job a user does within that defined
set of data. A data role inherits job or abstract roles and grants entitlement to
access data within a specific dimension of data based on data security policies. A
type of enterprise role.
A template used to generate data roles by specifying which base roles to combine
with which dimension values for a set of data security policies.
Glossary-7
data security
The control of access to data. Data security controls what action a user can taken
against which data.
database resource
An applications data object at the instance, instance set, or global level, which is
secured by data security policies.
department
description rule
The rule that defines the description content that appears on the subledger
journal header and line.
descriptive flexfield
determinant
A value that determines which reference data set will be used in a specific
business context.
determinant type
Designates the field within transactional columns that controls how data is
shared across organizations such as business unit, asset book, cost organization
or project unit. The type determines the reference data sets that would be used in
a transaction.
determinant type
determinant value
Glossary-8
document sequence has a determinant type. If Ledger is the determinant type for
a document sequence, the determinant value is the specific ledger number whose
documents are numbered by the document sequence.
distribution factor
A numerical value that determines the budget, forecast, or project plan amounts
distributed to financial periods corresponding to each of the ten spread points
that make up a spread curve.
division
document
Business objects for which you import transactions from source applications.
Examples of documents are time cards, expense reports, usages, or miscellaneous
transactions.
document category
A high level grouping of person documents such as visas, licences, and medical
certificates. Document subcategories provide further grouping of document
categories.
document entry
document sequence
document type
Glossary-9
expiry. A document type exists for a combination of document category and
subcategory.
duty role
A group of function and data privileges representing one duty of a job. Duty
roles are specific to applications, stored in the policy store, and shared within an
Oracle Fusion Applications instance.
employment terms
enterprise
enterprise role
Abstract, job, and data roles are shared across the enterprise. An enterprise role
is an LDAP group. An enterprise role is propagated and synchronized across
Oracle Fusion Middleware, where it is considered to be an external role or role
not specifically defined within applications.
entitlement
Grants of access to functions and data. Oracle Fusion Middleware term for
privilege.
expenditure item
The smallest logical unit of expenditure you can charge to a project and task. For
example, a time card item or an expense report item.
expenditure type
Classification of cost that you assign to each expenditure item in Oracle Fusion
Projects.
extensible flexfield
Glossary-10
appear in a named region of a user interface page. Some extensible flexfields
allow grouping contexts into categories.
feature choice
A selection you make when configuring offerings that modifies a setup task list,
or a setup page, or both.
financial resource
A resource that uses currency as its unit of measure.
flexfield
Grouping of extensible data fields called segments, where each segment is an
attribute added to an entity for capturing additional information.
flexfield segment
An extensible data field that represents an attribute on an entity and captures a
single atomic value corresponding to a predefined, single extension column in
the Oracle Fusion Applications database. A segment appears globally or based
on a context of other captured information.
function security
The control of access to a page or a specific widget or functionality within a page.
Function security controls what a user can do.
gallery
A searchable collection of portraits that combines the functions of the person
directory with corporate social networking and self-service applications for both
workers and managers.
global area
The region across the top of the user interface. It provides access to features and
tools that are relevant to any page you are on.
Glossary-11
grade
HCM
An HCM object that secures access to both its own data and data in other, related
objects. For example, access to a specified set of person records can allow access
to data secured by person records, such as goal plans and evaluations.
identity
Incoterms
intercompany billing
A feature that enables you to bill an internal customer for work done on a
receiver project and formalizes an internal revenue or cost transfer between
provider and receiver organizations.
interface table
interproject billing
A feature that enables you to bill an internal customer for work done on a
provider project. Cost of work performed is not reflected on the receiver project
until the project receives an invoice for the work.
Glossary-12
inventory organization
inventory organization
invoice distribution
invoice method
item categories
item master
item subinventory
job
Glossary-13
job role
A role for a specific job consisting of duties, such as an accounts payable
manager or application implementation consultant. A type of enterprise role.
journal
An element of a journal entry consisting of the name, accounting date, category,
ledger, and currency for single currency journal entries. Used to group journal
lines.
journal category
A name used to group journal entries with similar characteristics, such as
adjustments, accruals, or reclassifications.
journal entry
Point of entry of business transactions into the accounting system. Chronological
record, with an explanation of each transaction, the accounts affected, and the
amounts to increase or decrease each account.
journal line
An element of journal entries consisting of account combinations and credit or
debit amounts. Optionally, contains statistical quantities, currency information
for multicurrency journals, and additional information.
journal source
A name that indicates the origin of journal entries, such as payables, receivables,
or manual. Used as an attribute in automatic posting and journal import
processes.
key flexfield
Configurable key consisting of multiple parts or segments, each of which may
be meaningful individually or in combination with the others. Key flexfields are
commonly implemented to represent part numbers and account numbers.
Glossary-14
key flexfield structure instance
A single occurrence of a key flexfield structure that shares the same order of
segments as every other instance of the key flexfield structure, but uses different
value sets to validate the segments.
KPI
Abbreviation for key performance indicator. Key performance indicators (KPIs)
measure how well an organization or individual project meets an operational,
tactical, or strategic objective that is critical for the current and future success of
the organization. Examples are: Period-to-Date (PTD) Actual Spent Labor Effort
Percentage, PTD Actual Spent Equipment Effort Percentage, and PTD Actual
Margin Percentage.
KPI category
A group of key performance indicators that belong to a specific performance
area. Examples are: cost, profitability, financial, and schedule.
legal authority
A government or legal body that is charged with powers such as make laws,
levy and collect fees and taxes, and remit financial appropriations for a given
jurisdiction.
legal classification
A classification associated with a legal entity that represents its legal status
within a country and which also guides the tax determination process.
legal employer
A legal entity that employs people.
legal entity
An entity is identified and given rights and responsibilities under commercial
law, through the registration with the country's appropriate authority.
legal jurisdiction
A physical territory, such as a group of countries, single country, state, county,
parish, or city, which comes under the purview of a legal authority.
Glossary-15
legal reporting unit
A means of partitioning payroll and related data. At least one legislative data
group is required for each country where the enterprise operates. Each legislative
data group is associated with one or more payroll statutory units.
line of business
Set of one or more highly related products which service a particular customer
transaction or business need. Refers to an internal corporate business unit.
lookup code
A value available for lookup within a lookup type such as the code BLUE within
the lookup type COLORS.
lookup type
A set of lookup codes to be used together as a list of values on a field in the user
interface.
mainline
managed person
In Oracle Fusion Human Capital Management security, a person for whom the
user can maintain some information. For example, line managers can maintain
information about their direct and indirect reports, and workers can maintain
information about themselves, their dependents, and their beneficiaries.
manual payment
manufacturing facilities
Glossary-16
mapping set
model profile
native catalog
natural account
nonlabor resource
An asset or pool of assets. For example, you can define a nonlabor resource with
a name PC to represent multiple personal computers that your business owns.
offering
organization
organization classification
Organization classifications control the information that you can set up at the
organization level. You can assign multiple classifications to one organization,
or define separate organizations to represent different types of entities.
For example, you can classify an organization as both a legal entity and a
department.
Glossary-17
organization costing rule
Maps labor costing rules and rate schedules to organizations for labor costing,
and maps rate schedules to organizations for costing nonlabor items.
organization hierarchy
A tree structure that determines the relationships between organizations, such as
which organizations are subordinate to other organizations.
OWLCS
Abbreviation for Oracle WebLogic Communication Services. Offers the TPCC
service to Fusion applications and sets up the calls via SIP integration with the
telephony network.
party
A physical entity, such as a person, organization or group, that the deploying
company has an interest in tracking.
pending worker
A person who will be hired or start a contingent worker placement and for
whom you create a person record that is effective before the hire or start date.
performance measure
Performance measures are system-defined criterion for performance or schedule
that are used to determine if a project is on track.
person number
A person ID that is unique in the enterprise, allocated automatically or manually,
and valid throughout the enterprise for all of a person's work and person-to-
person relationships.
person type
A subcategory of a system person type, which the enterprise can define. Person
type is specified for a person at the employment-terms or assignment level.
Glossary-18
data can be considered public, such as a person's name and work phone number,
while other PII data is confidential, such as national identifier or passport
number.
PL/SQL
planning options
portrait
position
A specific occurrence of one job, fixed within one department, also often one
location. For example, the position Finance Manager is an instance of the job
Manager in the Finance Department.
A segment value used to represent a legal entity in the chart of accounts and
automatically balance all intercompany and intracompany transactions and
journal entries.
primary forecast
primary ledger
privilege
Glossary-19
process category
Group of one or more logically related event classes. Can be used to restrict
which events are processed by the Create Accounting process.
profile option
User preferences and system configuration options consisting of a name and a
value, that can be set at hierarchical levels of an enterprise. Also called a profile
or user option.
project type
Controls basic project configuration options, such as burdening, billing, and
capitalization options, and class categories, that are inherited by each project
associated with the project type.
Glossary-20
project unit
The business unit whose resources provide services to another project (provider
project) or business unit. For cross-charge transactions, the provider business
unit is the expenditure business unit; the project business unit owns the
intercompany billing project.
provider organization
provider project
The contract project that performs work on behalf of another (receiver) project.
In interproject billing, the provider project bills the receiver project through an
Oracle Fusion Payables invoice generated by the Update Invoices from Oracle
Fusion Receivables process.
PSTN
Abbreviation for public switched telephone network which is the network of the
world's public circuit-switched telephone networks.
public person
In Oracle Fusion Human Capital Management security, a person for whom some
basic information is publicly available. For example, users typically access the
contact details of public persons, such as phone numbers and locations, using the
person gallery.
Query By Example
The fields directly above table column headers in which you can enter values for
filtering the data in the table.
quick payment
A single payment that you create for one more invoices without submitting a
payment process request.
Glossary-21
rate-based planning resource
Resource for which cost and revenue are calculated based on a rate applied to
the quantity that is entered in a unit of measure other than currency.
raw cost
Costs that are directly attributable to work performed. Examples of raw costs are
salaries and travel expenses.
receiver organization
Organization that receives services provided by the provider organization.
receiver project
A project for which work is performed by another (provider) project. In
interproject billing, the receiver project incurs costs from an Oracle Fusion
Payables invoice generated by the Update Invoice from Oracle Fusion
Receivables process performed for the provider project.
recognized revenue
The sum of all revenue distributions created for a billing transaction.
reference data
Data in application tables that is not transactional and not high-volume such as
sales methods, transaction types, or payment terms, and can be shared and used
across organizational boundaries.
Glossary-22
reference group
A logical grouping of tables that correspond to logical entities such as payment
terms defined across multiple tables or views. Grouping establishes common
partitioning requirements across the entities causing them to share the same set
assignments.
reference object
Standardized data model containing reference information owned by other
subledger applications and used by the Create Accounting process to create
subledger journal entries from accounting events.
referenced category
A category within the native catalog that is shared from a designated source
catalog. A reference category is not editable.
regional area
The collapsible region on the left side of the work area, containing controls that
refresh, manipulate, or otherwise update the local area.
registration
The record of a party's identity related details with the appropriate government
or legal authorities for the purpose of claiming and ensuring legal and or
commercial rights and responsibilities.
resource
People designated as able to be assigned to work objects, for example, service
agents, sales managers, or partner contacts. A sales manager and partner
contact can be assigned to work on a lead or opportunity. A service agent can be
assigned to a service request.
revenue category
The source of revenue for an organization. Revenue categories group
expenditure types and event types for revenue and invoices, and are also used to
define accounting rules.
revenue method
A rule defined by the implementation team that determines the calculation
method of revenue amounts for contracts during revenue generation.
Glossary-23
revenue method classification
A predefined classification for an revenue method that determines the basis
for calculating revenue amounts. Assign a revenue method classification to a
revenue method. The predefined revenue method classifications are as-billed, as-
incurred, amount based, percent complete, percent spent, and rate based. When
you select the percent spent or percent complete revenue method classification,
the percent spent or percent complete billing extension is automatically assigned
to the revenue method.
revenue plan
A common set of instructions for recognizing revenue within a contract. Multiple
contract lines on a contract can use the same or different revenue plans.
reversal method
The method used to reverse an existing journal by switching debit and credit
amount or by changing the sign on the amounts.
role
Controls access to application functions and data.
role hierarchy
Structure of roles to reflect an organization's lines of authority and responsibility.
In a role hierarchy, a parent role inherits all the entitlement of one or more child
roles.
role mapping
A relationship between one or more job roles, abstract roles, and data roles
and one or more conditions. Depending on role-mapping options, the role can
be provisioned to or by users with at least one assignment that matches the
conditions in the role mapping.
role provisioning
The automatic or manual allocation of an abstract role, a job role, or a data role to
a user.
sandbox
A runtime session that commits changes out of reach of mainline users.
security profile
A set of criteria that identifies one or more human capital management (HCM)
objects of a single type for the purposes of securing access to those objects.
Glossary-24
Security profiles can be defined for persons, organizations, positions, countries,
LDGs, document types, payrolls, payroll flows, and workforce business
processes.
segregation of duties
set
set enabled
shared category
A category within a source catalog that has been added to a native catalog as a
referenced category. The category can be shared with one or more catalogs.
SOA
source
source
source pool
Glossary-25
source system
Rate you enter to perform conversion based on this rate as of a specific date. This
rate applies to the immediate delivery of a currency.
SQL predicate
A type of condition using SQL to constrain the data secured by a data security
policy.
storage facilities
subledger
A low-level ledger that stores and manages the details that substantiate the
monetary value stored in the general ledger. Oracle Fusion Receivables and
Oracle Fusion Payables are examples of subledgers.
summarization
supporting reference
Glossary-26
targets
The identified projects and tasks to receive allocation amounts. Allocation rules
specify the targets.
tax
An input that affects the outcome of a tax calculation process. Tax determining
factors are grouped into tax determining factor sets and used to define tax
condition sets and tax rules.
tax exception
tax exemption
tax formula
A tax formula is used to define the taxable basis and tax calculation for a given
tax.
tax jurisdiction
tax rate
The rate specified for a tax status for an effective time period. A tax rate can be
expressed as a percentage or a value per unit quantity.
tax recovery
tax regime
The set of tax rules that determines the treatment of one or more taxes
administered by a tax authority.
tax registration
The registration of a party with a tax authority that confers tax rights and
imposes certain tax obligations.
Glossary-27
tax rule
A user-defined rule that looks for a result for a specific tax determination
process, such as determining place of supply or tax registration, in relation to a
tax on a transaction.
tax status
territory
trading partner
An external party, such as a supplier, in the Oracle B2B application for which
electronic documents are sent or from which documents are received. A trading
partner in Oracle B2B corresponds to a supplier site.
transaction object
tree
Information or data organized into a hierarchy with one or more root nodes
connected to branches of nodes. A tree must have a structure where each node
corresponds to data from one or more data sources.
tree structure
Characteristics applied to trees, such as what data to include or how the tree is
versioned and accessed.
Glossary-28
tree version
An instance of a tree. If a tree is associated with a reference data set, all versions
belong to one set. Includes life cycle elements such as start and end date and a
status indicator whether the tree is active or not.
Rate you enter at journal entry time to convert foreign currency transactions to
your functional currency.
value set
A set of valid values against which values entered by an end user are validated.
The set may be tree structured (hierarchical).
WBS
work relationship
An association between a person and a legal employer, where the worker type
determines whether the relationship is a nonworker, contingent worker, or
employee work relationship.
worker type
workflow
An automated process in which tasks are passed from a user, a group of users, or
the application to another for consideration or action. The tasks are routed in a
logical sequence to achieve an end result.
A defined sequence of tasks, registered for the enterprise, that delivers a major
business goal. The tasks may be allocated to multiple roles across multiple
products.
Glossary-29
XML
XML filter
A type of condition using XML to constrain the data secured by a data security
policy.
Glossary-30