Professional Documents
Culture Documents
Perspective
An Oracle White Paper
Oct 2007
E-business Tax – A Purchasing Perspective
Purpose ................................................................................................. 3
Overview ............................................................................................... 3
Prior Tax Structure ................................................................................ 4
Key Concepts ........................................................................................ 6
Integration With Purchasing ................................................................. 8
Tax Events ......................................................................................... 8
Configuration Owner Tax Options .................................................... 8
Party Tax Profile ................................................................................ 9
Implementation Considerations ................................................. 10
Country Defaults ............................................................................. 11
Tax Defaulting ................................................................................. 12
Displaying Tax Information ............................................................. 13
Modifying Tax Information ............................................................. 14
Overriding Tax............................................................................. 14
Application Tax Options - Tax Hierarchy ........................................ 15
Supplier ....................................................................................... 16
Supplier Site ................................................................................ 16
Item ............................................................................................. 16
Tax Rules ......................................................................................... 17
Expert Rule .................................................................................. 18
Guided Rule ................................................................................ 18
Fiscal Classification ......................................................................... 20
Party Fiscal Classification ............................................................ 20
Product Fiscal Classification........................................................ 23
Transaction Fiscal Classification ................................................. 31
Tax in Interface ............................................................................... 32
Requisition Import ...................................................................... 32
PDOI ............................................................................................ 32
Tax During AutoCreate ................................................................... 32
Quantity Based Tax ......................................................................... 32
Tax Setup ............................................................................................ 34
Upgrade considerations...................................................................... 39
Data Flow ............................................................................................ 41
Troubleshooting.................................................................................. 43
Tax Simulator .............................................................................. 43
Troubleshooting Tips .................................................................. 43
Tax Log and File Versions ............................................................ 44
Appendix ............................................................................................. 46
E-business Tax – A Purchasing Perspective Page 2
References ...................................................................................... 46
Oracle Internal References ............................................................. 47
Tax Determination Attributes ......................................................... 47
Ebusiness Tax provides a repository to store Tax to create/update/display tax information for its transactions. The tax
tax information and record tax events.
services that can be availed from Ebusiness Tax are listed below.
Individual applications (for e.g.
Purchasing) avails the tax services provided by
Ebusiness Tax to create/update/display tax
information for its transactions. a. Define Tax Content
Architecture has been built considering country specific tax requirements and
applicability of rules for determining taxes. Based on the tax laws of a specific
country, the transaction tax rates may vary by jurisdictions, products or product
PURPOSE category, how the product will be used, type of transacting parties, type of
transactions, the place of supply etc. Various rules are applicable for
Purpose of creating this
determining the appropriate tax on a specific transaction.
document is to review impact
of Ebusiness Tax introduced in
R12 to Oracle Purchasing. This
document will help you in
implementing tax solution in
Purchasing using R12 Ebusiness
Tax solutions. This document
will also help you in
understanding the integration
and troubleshooting your tax
setups in Oracle Purchasing.
OVERVIEW
In release 12 EBusiness Tax has
been introduced to provide an
improved Tax solution to
customers.
Ebusiness Tax provides a
repository to store tax
information and record tax
events.
Individual applications (for e.g.
Purchasing) avails the tax
services provided by Ebusiness
The Tax Setups including rules are based on requirements used by the Tax Rules
Engine, which will create/update Tax Lines. These lines are later reported using
EBusiness Tax Reporting features. Figure below shows the e-business structure.
Prior to release 12, tax was defined in module. A tax component on the document total could be associated with the
Accounts Payables module. Taxes were
purchasing documents for portion of the tax which was non recoverable.
associated with rates, non-recoverable ratio
and recovery rules. Country Specific tax
Purchasing would default taxes based on hierarchy defined either in Oracle
requirements could not be incorporated
Payables (Setup > Options > Payables > Tax code defaults) or in Oracle
seamlessly into the application. Purchasing (Setup > Organization > Purchasing Options > Tax Default Alternate
Figure 1: E-Business Tax Region) if "Enforce Tax From Purchase Order" box in Payable Options (Setup >
Architecture Options > Payables > Tax code defaults) was checked.
Taxes were associated with rates, non-recoverable ratio and recovery rules.
Taxes were then defined in at least one of the levels (also called the tax source)
for e.g. Item, Supplier, Supplier Site, and Location etc. The order of defaulting
PRIOR TAX STRUCTURE
was decided by the hierarchy defined in the Payables/Purchasing options
Prior to release 12, tax was discussed previously. Tax calculation was called on a Requisition/ Standard
defined in Accounts Payables Purchase order or a Blanket release based on the hierarchy, recovery rules and
KEY CONCEPTS
Following are some of the key concepts in eBusiness tax as provided by this
product. This will be used further in this discussion.
Tax Regime: A Tax Regime contains the set of tax rules that determine the
treatment of one or more taxes that have been grouped together for
administration or other purposes.
For e.g. VAT Regime in Argentina that sets the rules for Standard VAT,
Additional
VAT, and Perception VAT and US Sales Tax Regime in US with State, County and
City/District taxes.
Tax Status: Tax Status is the taxable nature of a product or service in the
context of a transaction for a tax.
For e.g. Zero Rated, Standard Rated etc.
Party Tax Profile: Holds all party tax related information. For e.g. Party Profile
for Establishments, Party Profile for Suppliers and Sites or Party Profile for
Customers and Sites.
Registrations: The registration of a party with a tax authority that confers tax
rights and imposes certain obligations. For e.g. ESA78211646 (VAT - Spain),
SE123456789012 (VAT - Sweden) etc.
Intended Use Fiscal Classifications: The purpose for which a product may be
used. For e.g. Brazil Intended Use (e.g. Commercialization, Consumption,
Industrialization)
INTEGRATION WITH PURCHASING In Purchase Orders/Releases, tax is calculated at the PO shipment level and
distributed to recoverable and non-recoverable components that determine tax
There are a few fields on
amount at the PO distribution level. In requisitions, tax will be defaulted based
purchasing documents, which
on the tax setups in eTax and cannot be overridden. The requisition line and
determine application of a tax.
These 'Tax determination distribution will have the summary tax amount(total, recoverable and
nonrecoverable). The tax is calculated in e-business tax by calling e-business Tax
attributes' on purchasing
documents are used to calculate services and stored in e-business tax repository as mentioned in the 'Overview
of EBusiness Tax Architecture in R12' section in this article.
the applicable taxes on the
transaction. These attributes,
Tax Events
along with ‘Additional Tax
Attributes’ for e.g. Intended Use, Tax events are classified in purchasing based on the purchasing document
Product Fiscal Classification types. Following are the event classes in purchasing.
(Seen on the ‘Additional Tax Purchase and Internal Requisition (REQUISITION)
Information’ Page) and other
internal factors determine the Purchase Orders and Agreements (PO_PA)
calculation of tax. Tax calculation Blanket and Scheduled Release (RELEASE)
is initiated on creation
(saving/importing) of the The above event classes are based on the consideration of whether any tax
purchasing document. Tax is determination is necessary and the similarity in the handling of the tax
recalculated if there are any information.
changes that affect the tax
Configuration Owner Tax Options
calculation. Tax will be calculated
by calling tax services available The event class is associated with a first party legal entity/operating unit owning
through ebusiness tax at the tax content. Tax configurations can subscribe to the event class and additional
following events: options available based on each application using the ‘Configuration Owner Tax
Options’. At transaction time, e-business Tax uses the tax option settings of the
1. Document creation and
configuration owner and application event class instead of the default settings.
update (Requisitions, POs,
Therefore it is necessary that the available options (for update) through
Releases)
configuration owner tax options and defaulting rule should both be set with the
2. Receipt transactions (Charges) same value for the option to
take effect. For purchasing application only the following option is available for
updating.
Other options are not updatable for purchasing application and will not
available.
This will be the standard behavior in release 12.
By default the ‘Regime Determination Set’ is ‘Determine Applicable Regimes’
which uses the location based taxes. For migrated tax, using ‘Direct Tax Rate
Determination’ with tax classification codes, configuration owner tax options
must be setup to use STCC as the regime determination set.
Implementation Considerations
1. It is necessary to associate a first party legal entity and its main legal
establishment in party tax profiles. In case they have not been
associated a tax calculation error will result while saving the
transaction. To create a new first party legal entity / legal
establishment, query the legal entity and choose the party type as first
party legal entity or first party legal establishment for legal entity and
legal establish respectively. Click on the icon under the label titled
‘Create Tax Profile’. Now follow the instructions under chapter
‘Managing Tax Profiles and Registrations’ in Oracle E-Business Tax User
Guide to create a new tax profile for both the legal entity and its main
legal establishment.
Country Defaults
Country default controls let you default the transaction tax-related values in
the countries that you do business. You can also setup the default ‘Tax
Authority’ for the country. You can default tax regime and tax for tax
registrations belonging to the legal establishment in the applicable country by
choosing the option against the tax regime or tax you entered as the default
tax. For more details about this option, please refer to the Oracle E-Business
Tax User Guide.
Tax information will be displayed only after the purchase document is saved. The ‘Manage Tax’ link is enabled, which
navigates to a web page where the tax details can be viewed.
The tax will be recalculated on submission for approval. If the tax calculation is
still erroring the document cannot be submitted for approval. The following
Figure 3: Country Defaults error message will be display on clicking the 'Approve' button.
Tax Defaulting
Error Messages: Unexpected error occurred during Tax
Regardless of the availability of Calculation Exception: xxx - An unexpected error has occurred.
tax definitions in e-business tax, Please contact your system administrator.
Purchase documents call the Please correct the problem or contact your System
eTax services for tax calculation Administrator.
on saving the purchase
documents For troubleshooting the tax setups, please refer the troubleshooting section of
(Requisition/PO/Releases). If this article.
calculation results in applicable
tax lines, then these tax lines are
defaulted on the purchase Steps:
document. Tax calculation is
based on the values of the 'Tax 1. Setup Ebusiness tax.
determination attributes' along 2. Enter the purchase document details.(PO/Release/Requisition)
with the ‘Additional Tax
3. Save the purchase document (PO/Release/Requisition)
Attributes’ on purchasing
documents. The 'Tax
determination attributes', and
‘Additional Tax Attribute’
available on both purchase
order and requisitions are
available in the ‘Appendix’
section below. The purchase
documents makes a call to eTax
services for tax calculation even
The above tabs will display the tax line details for each shipment in the
Schedules tab and non-recoverable and recoverable tax distributions for each
distribution in the distributions tab.
The Tax page will have the following tabs for requisition.
1. Lines
2. Distributions
If there are no taxes applicable for the purchase document the Manage Tax
menu will still be enabled. There will be no tax lines seen on expanding the
'Details' in the 'Schedules Tab' of this 'Tax' page.
Defaulted Tax information can be overridden in Figure 5: Purchase Order Tax Page Steps:
purchase orders and releases. Tax line can be
manually added to the purchase 1. Query the purchase document or save the purchase document (Enter
orders/releases even if they have not been Purchase Order (POXPOEPO)/Enter Releases (POXPOERL))
defaulted.
2. Click on Actions > Manage Tax from the toolbar from Enter Purchase
Order (POXPOEPO)/Enter Releases (POXPOERL) forms and Tools > Manage Tax
for Requisition Entry (POXRQERQ) form.
Overriding Tax
Steps:
1. Query the purchase document (Purchase Order Summary/Requisition
Summary form) or save the purchase document (Enter Purchase Order
(POXPOEPO)/Enter Releases (POXPOERL))
2. Click on Actions > Manage Tax (Tools > Manage Tax for Requisition) from
the toolbar from Purchase Order Summary/Requisition Summary/Enter
Purchase Order (POXPOEPO)/Enter Releases (POXPOERL) forms.
3. The tax page will appear with details of tax lines. Click on the 'Additional
Tax Information' button.
4. Locate the tax classification field. This field will have the existing tax
classification for each tax line. Choose the new tax from the LOV.
5. Click on Apply and this will navigate you back to the manage tax page.
This page will have the new tax calculation based on the new tax
classification rate.
The tax hierarchy is now available in ebusiness tax either in payable options or in purchasing options, which would determine the
through ‘Application Tax Options’ available by
source and the order of defaulting on purchase orders. The tax hierarchy is
each operating unit for Purchasing application.
now available in ebusiness tax through ‘Application Tax Options’ available by
This is similar to defining the tax hierarchy in
‘Purchasing Options’ prior to release 12.
each operating unit for Purchasing application. This is similar to defining the tax
Application Tax Options is available only for hierarchy in ‘Purchasing Options’ prior to release 12. The tax will be defaulted
backward compatibility of the former Tax based on the defaulting order and the source option specified. Application Tax
Defaulting Hierarchy. Options is available only for backward compatibility of the former Tax
Application Tax Options - Tax Defaulting Hierarchy. If you are using complex tax rules you may choose to
Hierarchy disable the application tax options. This is a one-time option. Once the
Prior to ebusiness tax, a tax application tax option has been disabled, it would not possible to re-enable this
hierarchy would be defined option again for that operating unit.
Supplier
You can attach tax to the supplier using the following steps.
1. In the tax page navigate to Parties > Party Tax Profiles.
2. Choose ‘Party Type’ as “Third Party” and query the Supplier in the
‘Party Name’ for whom you like to define the tax.
3. Click on update icon (Pencil icon).
4. In the Main Tab check on ‘Allow Tax Applicability’.
5. Check ‘Set for Self Assessment / Reverse Charge’ if this is a self-
assessed tax*.
6. Navigate to Tax Registrations tab and click on ‘Create’ button and add
the tax regimes/taxes applicable to the supplier.
* A self-assessed tax is a tax calculated and remitted for a transaction,
where tax was not levied but it is deemed as due.
Supplier Site
You can attach tax to the supplier site using the following steps.
1. In the tax page navigate to Parties > Party Tax Profiles.
2. Choose ‘Party Type’ as “Third Party Site” and query the Supplier (using
the ‘Party Name’ field) for whom you like to define the tax.
3. Choose the site for which you want to define the tax and click on
update icon (Pencil icon).
4. In the Main Tab check on ‘Allow Tax Applicability’.
6. Navigate to Tax Registrations tab and click on ‘Create’ button and add
the tax regimes/taxes applicable to the supplier site.
* A self-assessed tax is a tax calculated and remitted for a transaction,
where tax was not levied but it is deemed as due.
Item
You can attach tax to the item using the following steps.
1. Navigate to Inventory/Purchasing Responsibility.
2. Navigate to Items > Master Items
3. Query the item for which you want to define the tax.
4. Navigate to the ‘Purchasing’ tab.
5. Choose ‘Yes’ from drop down for the ‘Taxable’ field.
6. Now choose the tax from ‘Input Tax Classification Code’ field LOV*.
Tax rules provide flexibility to use the tax as Tax Rules
required by the business / tax authority. The
User-friendly interface makes it easier for the
E-business tax provides flexibility to define all kinds of taxation rules that you
implementation team to configure rules based normally encounter in your business scenario. Tax engine requires some of the
on their requirements. mandatory tax rule types to be defined either by definining defaults available
* The tax will only be for these rule types, or by defining tax rules that will determine the value for
available in ‘Input Tax these mandatory tax rule types. If both are defined, the tax engine will first use
Classification Code’ field LOV the rule. In case the rule does not evaluate a value, the default for the tax rule
if the tax has been associated will be used. Rules can be defined even after the tax is live. Following are
with a ‘Tax Type’ in the tax mandatory tax rule types required before enabling the tax for transactions.
configuration for this tax prior Determine Place of Supply - The specific jurisdiction where the supply of goods
to enabling the tax. or services is deemed to have taken place for tax purposes, for a given tax; it is
The place of supply rule the result of the place of supply derivation.
determines the tax on the Determine Tax Applicability - The process and the data that identifies all the
ship-to location based on the taxes that need to be determined/levied for a given transaction; the result will
tax jurisdiction for the tax. be an ordered list of applicable taxes.
This is available though the
subscription owner profile in Determine Tax Registration - The registration of a party with a tax authority to
ebusiness tax. Tax for the ensure tax rights; responsibilities and rights are upheld.
Payables Financial Option can Determine Taxable Basis - The arrived at value, quantity or action, on which tax
be applied through the is calculated, after the tax rules which would affect it have been taken into
‘Application Tax Options’ consideration for a specific tax. These rules may include deductions,
where tax to be applied can modifications, exemptions and discounts.
be selected for this option.
Calculate Tax Amounts - The calculation of tax amount and formula to be used
for calculating this amount.
The below steps will guide you through a step-by-step process to create a tax
rule using the expert rule. You can alternatively use the ‘Guided Rule Entry’
option to define tax rules.
For e.g. define applicability of tax only for ship to location as New York City
1. Go to responsibility 'Tax Managers'
2. Navigate to Advanced Setup Options > Tax Determining Factor Sets
3. Click on 'Create' button
4. Enter the following values
a. Tax Determining Factor Set: <Enter a code for your
Tax
Determining Factor Set>
b. Name: <Enter a name for your Tax Determining
Factor Set> 5. Set Usage: Tax Rules 6. Optionally Enter:
a. Regime Code: <Regime code where the rule will be applicable>
7. Scroll down to the 'Associate Tax Determining Factors' region.
8. Enter the following values
a. Determining Factor Class: <In our case it is
'Geography'>
b. Class Qualifier: <In our case it is 'Ship To'>
You can also use the Guided Rule entry to define the rules for each tax. This
step guides you through a step-by-step process to create a tax rule. You can
alternatively use the ‘Expert Rule Entry’ option to define tax rules.
For e.g. define applicability of tax only for ship to location as New York City
1. Query the tax in the Tax Configuration > Tax Rules page
6. In the ‘Transactions’ tab As already defined ‘Key Concepts’ section, Fiscal Classification is a way that tax
enter the details for the authority classifies each part of a transaction. It is not necessary to define fiscal
location. In our case it classification to setup taxes in e-business tax. It only allows you to classify each
will be New York. part of a transaction so that you may create rules based on them for specific
tax requirements. We can model three types of fiscal classification in e-
7. Also choose the business tax.
operations. For e.g.
equal to/not equal to. In 1. Parties involved in the transaction - Party Fiscal Classification
our case choose not 2. Products involved in the transaction - Product Fiscal Classification
equal to. 3. Nature of the transaction - Transaction Fiscal Classification
3. Attach the Party Fiscal Classification to the party in PTP (Party Tax
Profile)
a. Go to responsibility ‘Tax Managers’
b. Navigate to Parties > Party Tax Profiles
c. Select the party type and party from the LOV and click on
‘Go’. In our case choose Party Type as ‘Third Party’ and
Party as the supplier that needs to be defined as a
‘Research and Development’ type organization.
d. Click on Update pencil icon.
e. Navigate to the ‘Classifications’ tab.
4. Create a new tax status and tax rate. (Follow steps 3, 5 and optionally
6 in-case recovery is required in the section ‘TAX SETUP’ below)
5. Create an Expert / Guided Rule as shown in the ‘Tax Rules’ section
above. Please use the following specification to create the rule.
a. Tax Determining Factor Set
i. Determining Factor Class: Party Fiscal
Classification
ii. Class Qualifier: Ship From Party
iii. Determining Factor Name: <'Fiscal
Classification
Type Code' defined in step 3 above>
b. Tax Condition Sets
i. Operator: Equal To
ii. Value/From Range: <In our case 'Research
and
Development'>
c. Tax Status: <Defined in step 4>
d. Tax Rate: < Defined in step 4>
When Ship From Party has a Party Fiscal Classification Value of ‘Research and
Development’ then apply the tax rate defined in step 4 above.
This is used to classify categories defined in Oracle Inventory. This can only be
used if Oracle Inventory is in installed status. For example, all domestically
purchased items that are used as office supplies, will be sold at a lower rate.
5. Create a new tax status and tax rate. (Follow steps 3, 5 and optionally 6
incase recovery is required in the section ‘TAX SETUP’ below)
6. Create an Expert / Guided Rule as shown in the ‘Tax Rules’ section
above. Please use the following specification to create the rule.
e. Tax Determining Factor Set
i. Determining Factor Class: Product – Inventory
Linked ii. Determining Factor Name: <'Fiscal
Classification
Type Code' defined in step 4 above >
f. Tax Condition Sets
i. Operator: Equal To
ii. Value/From Range: <In our case 'Office
Supplies'> (Please note the value of the
category segments are concatenated
without delimiters therefore query this
LOV with value of one of the segments
and use the category description to
choose the correct segment)
g. Tax Status: <Defined in step 5>
h. Tax Rate: < Defined in step 5>
If the category used in purchase order is ‘Office Supplies’ then apply the rate
used in step 5 above.
Non-Inventory Based
This is used to classify categories that are not defined in Oracle Inventory. The
advantage of such a classification is that, it can also be used if Oracle Inventory
is not in installed status. We will continue to use the above example we without
using Oracle inventory example, all purchased items that are used as stationary
materials for your office supplies, will be sold at a lower rate.
Steps:
1. Define a ‘Product Fiscal Classification’ for the non-inventory
category in e-business tax.
a. Go to ‘Tax Managers’ responsibility.
b. Navigate to Products > Product Classifications
c. Product Classification Source: From the drop down ensure to
choose Oracle E-Business Tax.
d. Click on ‘Go’ button.
e. This would retrieve the seeded fiscal classification type code:
PRODUCT_CATEGORY.
f. Click on the pencil icon below the ‘Update’ field of
PRODUCT_CATEGORY fiscal classification code, to update the
information in this category.
g. Click on ‘Create’ button to create a new category.
h. Enter the following details
i. Fiscal Classification Code: <Enter a code for the fiscal
classification which will be used as the category>. In our
example we will define it as ‘OFFICE_SUPPLIES’
ii. Name: <Enter a name for the fiscal classification
which will be used as the category>. In our example
we will
define it as ‘Office Supplies’
iii. Effective From: <Enter an effective date>
i. Click on ‘Apply’
j. You will now be able to view the ‘OFFICE_SUPPLIES’ under
‘PRODUCT_CATEGORY’. (If you are not able to view it. Click
the Next 5 arrow to check the entire list under
‘PRODUCT_CATEGORY’).
2. Create a new tax status and tax rate. (Follow steps 3, 5 and
optionally 6 incase recovery is required in the section ‘TAX
SETUP’ below)
3. Create an Expert / Guided Rule as shown in the ‘Tax Rules’
section above. Please use the following specification to create
the rule.
Intended Use
1. Inventory Based
2. Non-Inventory Based
For upgraded instances intended use is always inventory based. For non-
upgrade customers this choice can be made only once.
Example of Intended Use can be recovery tax on alcohol is based on its use. If it
is used for ‘Industrial Manufacturing’, the recovery rate will be higher than
when it is used for direct ‘Retail Sale’. In this whitepaper we will discuss
example of inventory based ‘Intended Use’. The difference is that for inventory
based defaulting automatically occurs when we choose the inventory-based
items. While for noninventory based intended use, the Intended use must be
explicitly specified from the ‘Intended Use’ field seen from the ‘Additional Tax
Information’ page after navigating to the tax page though the ‘Manage Tax’
Steps:
1. In Oracle Inventory define categories for intended use. For e.g. in our
case we will define a category called ‘Industrial Use’ and ‘Retail Sales’.
(Please refer to the page 4-66 of Oracle Inventory User's Guide for
steps to create an inventory category)
2. Create a new category set and associate the category set with the
category created in step 1 above or use the default INTENDED_USE
category set. In our example associate the categories defined in step 1
above to the INTENDED_USE Category Set (This is a seeded category
set available by default i.e. we will associate the category ‘Industrial
Use’ and ‘Retail Sales’ in the INTENDED_USE Category Set. (Please refer
to the page 468 of Oracle Inventory User's Guide for steps to update an
inventory category to a category set)
If the ‘Intended Use’ of the item in purchase order is ‘Industrial Use’ then apply
the recovery rate used in step 4 above.
Transaction Fiscal Classification
. Tax information provided through the interface classification and recovery rate. Tax information provided through the interface
will be considered as an override and not
will be considered as an override and not defaulting information. Therefore it
defaulting information. If tax details are not
specified in the interface, then ebusiness tax will
should fulfill all the criteria for overriding a tax as mentioned in above under the
determine the appropriate tax classification and
heading ‘Modifying Tax Information’ (Overriding Tax). A new field TAX_NAME is
recovery rate. introduced in release 12. Tax classification can be provided for overriding the
tax line information. TAX_CODE_ID field is supported on the data import for
backward compatibility. If TAX_CODE_ID field based on the old AP tax codes is
specified, then the tax classification will be derived and passed on to ebusiness
tax.
PDOI
Requisition Import
Quantity Based Tax
If the requisition lines interface One of the features of e-business tax for purchasing is the capability to define
(PO_REQUISITIONS_INTERFACE_A tax on the basis of quantity instead of the Line amount. In order to define tax
LL) does not specify any tax based on quantity we can follow the steps mentioned in the ‘TAX SETUP’
details, then ebusiness tax will section below. Please follow the below mentioned changes in the
determine the appropriate tax
2. Tax Rule: In tax rules of for the tax, use the following as default value (Step 7 in ‘TAX SETUP’
section):
a) Determine Taxable Basis: STANDARD_QUANTITY
TAX SETUP
Following are the brief setup steps for defaulting basic tax in purchasing. Based
on the business requirement the setups can be complex involving multiple tax
rules. These steps can be used for performing quick tests for using tax in
purchasing.
1. Set up Tax Regime (Responsibility: Tax Managers, Navigation:
Tax
Configuration > Tax Regime)
a. Regime Level - A Tax Regime is usually defined for a country
b. Controls and defaults – Following options can be checked.
Instead of replicating choices for different OUs, define which
regimes need to support recovery / Exemptions / Exceptions /
Overrides
i. Allow Tax Recovery
ii. Allow Tax Exemptions
iii. Allow Tax Exceptions
c. Click on ‘Next’ to choose the subscriptions for the regime.
d. Party Subscription Options
i. Define the parties (legal Entity / operating unit) that
subscribe to this tax.
ii. Configuration for Taxes and Rules: Choose if the
regime will be available as ‘Common Configuration’
i.e. Tax setups will be available for tax across legal
entities / operating units (use ‘Global Configuration
You could also view a demonstration of the tax setups for purchasing
though the viewlets attached with this white paper.
UPGRADE CONSIDERATIONS
Following are some of the important impacts upon upgrade. Since the upgrade
path for release 12 is only though 11i, we will only be considering this release in
our considerations for upgrade. Also, this article would discuss only impacts on
purchasing perspective.
1. In release 11i, tax was maintained separately for payables, receivables
etc. The tax used in purchasing was stored in payables and tax calculation
API’s from payables were called for determining tax amount. The tax was
operating unit based. In release 12 a centralized repository will be used
to store taxes from across applications. The tax setup will be upgraded as
partyspecific configuration owners, with the operating unit owning the
tax setup. This means that the tax regimes for migrated taxes will
subscribe to party with ‘Operating Unit Owning the Tax Setup’ i.e. the
operating unit will still continue to own the tax.
2. Each tax code, including the tax codes within a tax group, migrates to
EBusiness Tax as a tax classification code. Payables and Purchasing tax
codes migrate as input tax classification codes. Each tax code will be
migrated with each tax code having its regime to rate flow. The tax group
will also be migrated as a tax classification, but will not have an
associated regime to rate flow in e-business tax. To group all related
taxes classifications under its related tax group, a direct rate
determination rule is created during migration that will be based on the
tax classification code that has the same name as tax group code. If tax
DATA FLOW
Following is the mechanism of calls to the ebusiness tax to calculate tax.
1. Purchasing will populate tax-determining attributes to global temporary
tables.
2. It will then call ebusiness tax API's to calculate tax.
3. Once the tax lines are calculated, appropriate tables in ebusiness tax is
populated with tax details and the purchasing tables are updated to indicate
taxable line.
4. The data from the global temporary tables will be deleted.
Following are the main ebusiness tax tables that will contain the setup
information that will help support in troubleshooting ebusiness tax
information.
To get a dump of the eTax setups, you can use the following set of queries.
Please provide the tax regime code when prompted. If the issue is limited to a
tax then provide the tax name when prompted else please leave it blank.
SELECT *
FROM zx_regimes_b
WHERE tax_regime_code = '&tax_regime_code';
SELECT *
FROM zx_taxes_b
WHERE DECODE('&tax_name',null,'xxx',tax) = nvl('&tax_name','xxx')
AND tax_regime_code = '&tax_regime_code';
SELECT *
FROM zx_rates_b
WHERE tax = '&tax_name'
AND tax_regime_code = '&tax_regime_code';
SELECT *
FROM zx_jurisdictions_b
WHERE DECODE('&tax_name',null,'xxx',tax) = nvl('&tax_name','xxx')
AND tax_regime_code = '&tax_regime_code';
SELECT *
FROM zx_rules_b
WHERE tax = '&tax_name'
AND tax_regime_code = '&tax_regime_code';
Following are the main ebusiness tax tables that will contain the transaction
information that will have the tax details after tax is calculated.
a. ZX_LINES: This table will have the tax lines for associated with
PO/Release schedules.
TRX_ID: Transaction ID. This is linked to the
PO_HEADERS_ALL.PO_HEADER_ID
TRX_LINE_ID: Transaction Line ID. This is linked to the
PO_LINE_LOCATIONS_ALL.LINE_LOCATION_ID
TROUBLESHOOTING
Tax Simulator
Simulator is a powerful user interface too that can be used to simulate Tax
Calculation based on what-if scenarios. It gives flexibility to test new and/or
changed tax rules. Tax Simulator helps on audit trail with respect to which Tax
Rules were satisfied in calculating a particular tax. You can start using the
Oracle
Tax Simulator by attaching this responsibility to your user. Navigate to the
Oracle
Tax Simulator and enter the Header and Line information as appropriate. Click
on ‘Tax Lines’ to display the tax lines for your tax. For detailed steps please
review the tax simulator viewlet attached to metalink Document ID (Note) for
this whitepaper.
Useful Tips:
1. Ship from Ship to and Bill From Bill to LOVs change depending upon the
application selected. Ship To/Bill To information is required for calculation
of location-based tax.
2. First Party locations need to be associated with the legal establishment for
the tax simulator to calculate tax.
Troubleshooting Tips
5. Tax Rules: Check the default place of supply or the rule for the tax. There
should be at least one valid jurisdiction for the place of supply determined.
Check whether the tax is by default Applicable. If not then at least one rule
must be satisfied.
If there is an error while calculation please use the Note 417238.1 to obtain the
tax debug log. Below are the information that will be sufficient for Oracle
Support to progress the service request for any ebusiness tax calculation issues.
1. Set the following profile options on at user level for the user saving the
purchase order.
FND: Debug Log Enabled = 'Y'
FND: Debug Log Level = 'Statement'
FND: Debug Log Module = %
8. You will get a message showing the location of the trace file.
9. Please retrieve trace with tkprof. Run the trace file through tkprof as
follows:
tkprof <filename>.trc <filename>.out explain=<found
username/password>
example: tkprof file1234.trc file1234.out explain=<apps/apps>
10. Please get the debug log using the following query.
SQL> select * from fnd_log_messages
where log_sequence > <output from
step1> and (module like 'ZX%' or module
like 'zx%) and audsid = <audsid from step 3
above> order by log_sequence;
* If the AUDSID is not available please use the following query to retrieve the
tax log.
SQL> select * from fnd_log_messages
where log_sequence > <output from
step1> and (module like 'ZX%' or module
like 'zx%)
and user_id = (SELECT user_id FROM fnd_user where user_name =
‘&Username’) order
by log_sequence;
Submit the Request and upload the output of the program for validating the file
version information.
APPENDIX
References
Note 406376.1 Oracle E-Business Tax Release 12 Known Issues
Note 417238.1 How to obtain tax debug logfile when using application version 12 or
higher
Note 398841.1 FAQ: Purchasing Integration With E-Business Tax
Note 415698.1 Oracle E-Business Tax key benefits, some new features and resource
material
Note 437693.1 R12 Unexpected Error Occurred During Tax Calculation
Note 458218.1 Defaulted Tax Rate From E-Business Tax Cannot Be Overriden
Note 458320.1 E-Business Tax Calculation Issues After Entering The Next Line/ Deleting
Shipments/ Adding New Shipments in Purchase Order
Note 458218.1 Defaulted Tax Rate From E-Business Tax Cannot Be Overriden
Note 461844.1 E-Business Tax Calculation Error Occurs. Tax Log Shows 'Error Unable To
Get The HQ_ESTB_PARTY_TAX_PROF_ID For Legal_Entity xx'
Line
-------
Item
Unit of Measure
Quantity
Unit Price
Amount Need-
by Date
Tax Classification
Ship-to Organization
Ship-to Location
Supplier
Supplier Site
Distribution
--------------- Quantity
Amount Charge
Account
Tax Recovery Rate
Project
Task
Award
Expenditure Type
Expenditure Organization
Expenditure Date
Additional Tax Attributes (Navigation: Tools > Manage Tax > Additional Tax Information)
--------------------------------
Intended Use
POs/Releases
=========
Header
-----------
PO Document Type
Transaction Currency
Rate Type
Rate Date
Rate
FOB
Supplier
Supplier Site
Bill-to Location
Provisional Tax Determination Date (for Consumption Advice Orders)
Shipment
-------------
Quantity
Amount Need-
by Date
Tax Classification
Ship-to Organization
Ship-to Location
Source Document (for Scheduled Releases of Planned PO)
Source Shipment (for Scheduled Releases of Planned PO)
Additional Tax Attributes (Navigation: Tools > Manage Tax > Additional Tax Information)
-------------------------------- Business
Category
Intended Use
User-defined Fiscal Classification
Product Fiscal Classification
Product Category
Assessable Value
Distribution
----------------
Quantity
Amount
Account CCID
Tax Recovery Rate
Project
Task
Award
Expenditure Type
Expenditure Organization
Expenditure Date
Source Distribution (for Scheduled Releases of Planned PO)
Additional Tax Attributes (Navigation: Tools > Manage Tax > Additional Tax Information)
--------------------------------
Intended Use (defaults from shipment level)
Oracle Corporation
World Headquarters
500 Oracle Parkway Redwood
Shores, CA 94065 U.S.A.
Worldwide Inquiries:
Phone: +1.650.506.7000 Fax:
+1.650.506.7200 oracle.com