Vertex O2C Tax Link For Oracle R12 Integration Guide
Vertex O2C Tax Link For Oracle R12 Integration Guide
February 2015
May 2014
Copyright and legal notices
Copyright © 2014 Vertex Global Tax Solutions Ireland Holdings. All rights reserved.
This documentation may not be reproduced, displayed, distributed, modified, posted, republished, or
transmitted in any form or by any means, without the prior written consent of Vertex Global Tax
Solutions Ireland Holdings or its affiliates (collectively, “Vertex”), except as otherwise specified in a valid,
current Vertex license agreement or allowed by law.
Disclaimers
The information contained in this documentation is designed to help users in regard to the subject
matter covered. Some of it may be based upon interpretations of federal, state, foreign and other tax
laws and regulations. Each entity is responsible for making its own determination of how such laws and
regulations apply to its own circumstances and for evaluating the capabilities of, and all data and results
generated by, any product that is described in this documentation. Vertex is not engaged in providing
legal, tax or accounting advice or services and the information contained in this documentation or in any
product cannot replace the advice of competent legal counsel. Further, the information in this
documentation 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.
Overview........................................................................................................................................... 1
Vertex Tax Links for R12 ................................................................................................................... 1
The data flow between Oracle R12 and O Series ............................................................................. 2
Chapter 2................................................................................................................................................. 4
Feb 2015 iv
Vertex Tax Links for Oracle R12 O2C Integration Guide
Preface
This preface contains the following information:
• Contacting Vertex®, which includes how to contact us about services and products
• About this guide, which includes its purpose, scope, and audience
Feb 2015 v
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 vi
Vertex Tax Links for Oracle R12 O2C Integration Guide
Tax References
Vertex offers a variety of references for tax compliance information as well as
jurisdiction and postal code information. To learn more, see the Reference Products
section of the Web site at www.vertexinc.com/Products/reference_solutions.asp.
Vertex Consulting
Vertex Consulting provides specialized knowledge and experience to help you configure
your Vertex software and ensure that it's integrated correctly with your host system. We
tailor the consulting service to complement your company's internal resources and skills
to address your unique needs.
For more information about the service options available, see the Services/Vertex
Consulting section of our Web site at www.vertexinc.com/Services/onsite.asp.
Purpose
This guide applies to Vertex users who also use Oracle R12 Application. This document is
for those Oracle R12 users who want to install and use the Vertex Tax Links with their
Oracle R12 Application.
Scope
This guide describes what you need to know to:
• Understand how the Vertex Tax Links work with Oracle R12 and Vertex O Series®.
• Install and configure the Vertex Tax Links
Audience
Organization
This guide contains the following chapters:
Chapter 1. Overview
Provides an overview of the Vertex Tax Links, including its functions and the Vertex O
Series and Oracle R12 with which it interfaces.
Chapter 1
Overview
This chapter provides an overview of the Vertex Tax Link for R12 and how it acts to
facilitate communication between Oracle R12 business applications and Vertex O Series
software.
In this chapter
Vertex Tax Links for R12 Overview ........................................................... 1
Vertex Tax Link is a PL/SQL-based implementation. To begin, register and plug in the tax
service for integration. The Vertex Tax Link takes the information passed from R12 and:
1. Translates it to XML.
2. Maps it to the appropriate O Series parameters for processing by the O Series
tax calculation.
The result is returned in a format that Oracle R12 can use. Vertex Tax Link allows Oracle
R12 software to use O Series software to:
• Retrieve and apply proper tax to sales transactions.
• Retrieve tax quotations for a transaction before the transaction is complete.
• Adjust existing transactions and recalculate correct sales tax.
Feb 2015 2
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 3
Vertex Tax Links for Oracle R12 O2C Integration Guide
Chapter 2
Configuration and Installation
This chapter provides an overview of the Vertex Tax Link for Oracle R12 and how it
facilitates communication between Oracle Financials R12 business applications and
Vertex O Series tax software.
In this chapter
Configuring R12 Tax Regime. ………………………………….….... 5
Prerequisites
To install this product, you must meet the following prerequisites:
• The database in which you are installing the product must be Oracle version 10.2 or
higher.
• You must have installed Vertex O Series TPS 5.0 or 6.0 in a database that is accessible
from the instance in which you are installing the Tax Link.
• You must have write access to the server directory where the custom files reside and
SQL*Plus access to the destination databases, with the proper users and passwords
for the designated database users.
• You must set up the Tax Regime Code in EBtax before installing Vertex Tax Link.
Steps are on following page.
• A tablespace will need to be created prior to the install. We provide a script to create
a user and grant required permissions.
• The Linux/Unix user performing the Vertex Tax Link install will need permission for
the java home directory.
• Create CUSTOM_TOP/reports/US directory for Vertex reports
Feb 2015 5
Vertex Tax Links for Oracle R12 O2C Integration Guide
Oracle Patches
Oracle patches that are required to be applied in order for a successful integration with
Vertex O Series. We recommend you search Metalink site for any new patches. These
patches also could be superseded by a new patch.
12.0 / 12.1
12.2
Oracle Patch Description
18347471 E-Business US Sales and Use tax Import program –
Oramast upload (password required)
Feb 2015 6
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 7
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 8
Vertex Tax Links for Oracle R12 O2C Integration Guide
After the Vertex Tax Link installation is complete, each record is recreated with the
Vertex database package and procedure. The Tax Regime Code also displays.
Feb 2015 9
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: If you previously installed Vertex P2P you can skip the above step
as you have already Registered the Custom Application.
Feb 2015 10
Vertex Tax Links for Oracle R12 O2C Integration Guide
Instances
The Vertex Tax Link should always be installed in the same instance as the ERP system
that it is being used by. However, it does support both one-tier and two-tier
implementation. A two-tier implementation is where the Vertex server is installed in a
different database than the Vertex Tax Link. A single-tier implementation is where they
both reside in the same instance.
Architecture
The installation scripts are designed using general Oracle Application standards because
they are used by all products in the Vertex Tax Links that integrate with the Oracle
Applications. These standards recommend that you create the tables, indexes, and
sequences under a custom schema, and create synonyms to these objects with all views
and packages under the APPS schema.
Feb 2015 11
Vertex Tax Links for Oracle R12 O2C Integration Guide
The following steps for creating user, installing OIC and installing Tax Link must be
performed in the database tier. The steps for fndload must be performed in the app
server tier.
Note: If you previously installed Vertex P2P you can skip the above step
as you have already created the Custom User.
Feb 2015 13
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: If you previously installed Vertex P2P you can skip the above step
as you have already configured the Access Control List (ACL).
Feb 2015 14
Vertex Tax Links for Oracle R12 O2C Integration Guide
XXVERTEX
XXVERTEX
Example:
PROMPT Enter the apps user name (apps)
APPS
Feb 2015 15
Vertex Tax Links for Oracle R12 O2C Integration Guide
Service Subscription
To subscribe your Tax Regime and create the correct service mappings perform the
following steps:
apps
apps password
5. The script prompts you for the Vertex Tax Regime code you set up in Oracle R12.
Include single quotes before and after the regime code.
Example:
‘VERTEX REGIME’
6. Review install_service_subscr.lst file
Feb 2015 16
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: This step applies if you are not using Vertex QSeries after the Vertex O2C Tax Link
installation. If you will continue to use Vertex Q Series for any Operating Units, then do
not run the delete scripts noted below. Contact vertex Product Support.
Oracle has provided the following delete scripts to run to clear records for customized
procedures from the subscription setup.
Log in as apps user and run following scripts:
DELETE FROM ZX_API_CODE_COMBINATIONS
WHERE CODE_COMBINATION_ID IN (SELECT DISTINCT CONTEXT_CCID
FROM ZX_API_REGISTRATIONS
WHERE PACKAGE_NAME LIKE 'ZX%');
COMMIT;
Feb 2015 17
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: If you previously installed Vertex P2P you can skip the Create
Database Link step as you have already configured the database link
during the P2P installation.
4. If your db link is connected to the OSeries Journal schema you need to grant
select for the Journal schema user to the OSeries appuser table. If your db link is
connected to the OSeries schema where the appuser table resides, then you
need to grant select for that schema user to the vtx_rec view in the Oseries
Journal schema.
6. In the EBS database server create a tnsnames.ora entry for the Vertex O Series
schema you created the db link to access.
Feb 2015 18
Vertex Tax Links for Oracle R12 O2C Integration Guide
Enter the Vertex Tax Link custom schema user: - i.e. xxvertex
Feb 2015 19
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 20
Vertex Tax Links for Oracle R12 O2C Integration Guide
If you have multiple application servers and they have a shared library then you only
need to install the tax link on one app server, if they do not have a shared library then
you need to install the tax link on each app server.
To create Vertex Tax Link file system perform the following steps:
1. Create a directory (for example, vertex) and copy the
vertex_o2c_apps_5.1.10.15.02.tar file to that directory.
Application Setup
After installing the database objects, you need to set up the Oracle Application objects.
This equates to installing numerous FND objects.
1. Make sure that all *.sh scripts in the /vertex_o2c_apps/fndload directory are
executable – chmod 755 *.sh
Feb 2015 21
Vertex Tax Links for Oracle R12 O2C Integration Guide
The script will generate the necessary text files to load the FND objects for your system.
4. Review the resulting .txt files to verify they were generated successfully.
Feb 2015 22
Vertex Tax Links for Oracle R12 O2C Integration Guide
2. Review the resulting .log files to verify the objects were imported successfully.
2. Set the base path for the CUSTOM_TOP directory in the environment variable file.
Note: If you previously installed Vertex P2P you can skip the above step
as you have already Assigned the Vertex Custom Application to the
Standard Data Group.
Feb 2015 23
Vertex Tax Links for Oracle R12 O2C Integration Guide
This patch will upgrade to the latest Tax Link code and upgrade to process 7.0 XML
schemas.
Note: If you are integrating to Vertex O Series in our hosted Vertex OnDemand environment
then you would not apply the Vertex AR Recon patch.
Feb 2015 24
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: If you previously installed Vertex P2P you can skip the above step
as you have already imported the Oramast file.
Feb 2015 25
Vertex Tax Links for Oracle R12 O2C Integration Guide
Configuring EBTAX
Configuration overview
The following section provides steps necessary to enable and use O Series with Oracle
R12. O Series returns multiple jurisdictional tax levels per line item. These tax levels must
be defined and configured in EBtax in order for the tax results to be correctly processed
by Oracle R12.
When importing the oramast.dat file, the CITY, COUNTY, and STATE tax levels are
automatically created and configured. The steps provided in this guide are repeated for
each jurisdictional tax level and only illustrated for DISTRICT and LOCATION. The
additional tax levels that are required to be set up must be entered in the order they are
shown below. You set them up in the Tax field, located in the Tax Manager > Tax
Configuration >Taxes window. They include the following:
DISTRICT
LOCATION
PARISH
TERRITORY
APO
FPO
TRANSIT_DISTRICT
SPECIAL_PURPOSE_DISTRICT
LOCAL_IMPROVEMENT_DISTRICT
COUNTRY
There are several concurrent requests that must be submitted to enable Oracle R12 to
process transactions to O Series. Oracle provides the Tax Service Plug-in request. Vertex
provides a request to set the Web Service endpoint and another request to set the
username and password for the calculation and Tax Area ID calls to be correctly directed
to O Series.
Feb 2015 26
Vertex Tax Links for Oracle R12 O2C Integration Guide
Configuration steps
Note: For the following configuration steps, you use the Tax Configuration, Defaults
and Controls, and Provider Services tabs.
To configure EBTAX, complete the following steps:
1. Log into your Oracle R12 application.
2. Navigate to Tax Managers > Home > Defaults and Controls.
3. Search for the configuration owner, which is your operating unit.
4. Select the correct party name with the party type of Operating Unit owning Tax
Content.
5. Click Go.
The following figure illustrates this using a Vision Operations operating unit:
Feb 2015 27
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 28
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 29
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 30
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 31
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 32
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 33
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: Depending on patch levels, the Oracle program that loads the Oramast data
may create the zero rate Tax Rate setup outlined below. Query the Tax Rates to
confirm this. If the zero rate is not present, then create it. If it is already set up,
then do not complete the following steps.
Configuring Tax Rates - City
To configure CITY tax, complete the following steps:
1. Navigate to Tax Manager > Tax Configuration > Tax Rates.
2. Click Create.
3. In the Tax Regime Code field, select your Tax Regime Code.
4. In the Configuration Owner field, select your Configuration Owner.
5. In the Tax field, select CITY.
6. In the Tax Status Code field, select STANDARD.
7. In the Tax Rate Code field, enter CITYRATE.
Feb 2015 34
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 35
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 36
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 37
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 38
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 39
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 40
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 41
Vertex Tax Links for Oracle R12 O2C Integration Guide
2. Click Apply.
Feb 2015 42
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 43
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 44
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 45
Vertex Tax Links for Oracle R12 O2C Integration Guide
9. Click Yes.
Feb 2015 46
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 47
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 48
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 49
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 50
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 51
Vertex Tax Links for Oracle R12 O2C Integration Guide
Click on the Set Default icon, for each of the following Rule Types and perform the setup
illustrated on the following page.
Feb 2015 52
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 53
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: If you would like to view windows for the preceding setup steps, please review
the windows for DISTRICT setup.
The following Tax Rule window displays:
Feb 2015 54
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 55
Vertex Tax Links for Oracle R12 O2C Integration Guide
3. Click Yes.
The repeated setup steps for LOCATION and DISTRICT are completed. Follow these same steps for the
additional tax levels listed here and at the beginning of the EBTax Configuration section. Begin at
Configuring District taxes.
PARISH
TERRITORY
APO
FPO
TRANSIT_DISTRICT
SPECIAL_PURPOSE_DISTRICT
LOCAL_IMPROVEMENT_DISTRICT
COUNTRY
Feb 2015 56
Vertex Tax Links for Oracle R12 O2C Integration Guide
Country Defaults
1. Click Country Defaults from the Defaults and Controls tab.
2. Click Create.
3. Select United States in the Country Name field.
4. Select your Tax Regime Code in the Tax Regime Code field.
5. Select LOCATION in the Tax field.
6. Select the Set as Default for Imported Invoices check box under both Tax Regime
Code and Tax.
7. Click Apply.
Feb 2015 57
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 58
Vertex Tax Links for Oracle R12 O2C Integration Guide
Concurrent Requests
There are several concurrent requests that must be submitted to enable Oracle R12 to process
transactions to O Series. Oracle provides the Tax Service Plug-in request. Vertex provides a
request to set the Web Service endpoint, another request to set the username and password for
the calculation and Tax Area ID calls to be correctly directed to O Series, and the Vertex AP
Supplier Tax Area ID Assignment program to pre-assign Tax Area IDs to existing supplier records.
Feb 2015 59
Vertex Tax Links for Oracle R12 O2C Integration Guide
Submit the following single request to set the username and password that will be used for all of
the XML calls to Vertex O Series:
1. For Name select Vertex Create application user for Regime Code
2. For Oracle Regime Code enter the Tax Regime subscribed to call Vertex
3. For Vertex User Name enter valid username that is setup in Vertex Central for this
instance
4. For Vertex User password enter the valid password for the user name
5. Click OK button and submit the request.
Note: The username and password are assigned to a partition in Vertex O Series. The transactions
processed with this user account will utilize the Vertex O Series setup specific to that partition.
Feb 2015 60
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: If you previously installed Vertex P2P you can skip the above step
as you have already set the Vertex Web Service endpoint.
The hostname is the server where Vertex O Series resides and the port is what is setup for Vertex O
Series web services to use in your application server (i.e. OC4J ,Tomcat).
This web service end point url will be stored in the tax link tables to direct the XML calls to the correct
Vertex O Series instance.
Oracle Instance name – the instance_name from v$instance table in apps schema. This is case sensitive.
Make sure what you enter matches exactly to what is in the table.
Vertex Service end point – web service url to direct the xml calls to the correct Vertex O Series instance.
For RAC environments you will need to run this concurrent program for each instance name using the
same service end point. You can query the list of instance names from gv$instance in apps schema.
Feb 2015 61
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 62
Vertex Tax Links for Oracle R12 O2C Integration Guide
Log into Vertex Central with the correct username and password. This should be the same username and
password as used with ‘Vertex Create application user for Regime Code’ concurrent program.
From the Vertex Central / Tax Setup page click on the Flexible Fields menu.
Feb 2015 63
Vertex Tax Links for Oracle R12 O2C Integration Guide
Enter a value in the Short Name field. This value will then be selected to assign the actual code.
Feb 2015 64
Vertex Tax Links for Oracle R12 O2C Integration Guide
• The tax posted in Oracle R12 has a different amount than the tax recorded in the Vertex
Tax Journal.
• The Vertex Tax Journal has tax but the corresponding transaction in Oracle R12 does not
exist.
• The Oracle R12 transaction has tax but the transaction does not exist in Vertex.
• The transaction in Oracle R12 is Unposted, but exists in Vertex Tax Journal.
As a result, Vertex created a custom program to identify these variances and provide a
mechanism to synchronize and correct the differences.
Important Note: The comparison does not take into account excluded Receivables transactions.
• Excluded transactions will vary depending on what Event Types have been enabled for
tax calculation by your business or any other Vertex Tax Link setups that would exclude
certain transactions from calling Vertex. Since these transactions do not call Vertex for
tax calculation, the program does not consider them for evaluation.
Feb 2015 65
Vertex Tax Links for Oracle R12 O2C Integration Guide
Overview
Vertex AR Tax Reconciliation compares data stored within Oracle R12, the Vertex Tax
Link tables and the Vertex O Series Tax Journal for determining which transactions are
eligible for adjustment. The program can be run in 2 modes – Preview and Sync.
Preview Mode:- Displays output of all tax variances between Oracle AR and Vertex Tax Journal
for the specified parameters. No updates are made to when run in this mode.
The program output is a report that will group the variances into 3 groups:
• Transactions present in both Oracle R12 and Vertex but with differing tax amounts.
Sync Mode:- Vertex Tax Journal is updated to true up to Oracle AR tax data. No changes will be
made to Oracle Receivables tax data.
• For Transactions present in both Oracle R12 and Vertex but with differing tax amounts.
- Transactions are rolled back and recreated in the Vertex Tax Journal with the Oracle
R12 tax amount.
Feb 2015 66
Vertex Tax Links for Oracle R12 O2C Integration Guide
During the transaction process a failure could occur in Vertex O Series, Vertex Tax Link or
Oracle that resulted in:
• Transactions present in both Oracle R12 and Vertex but with differing tax
amounts.
• Transactions present in Vertex but not in Oracle R12.
• Transactions present in Oracle R12 but not in Vertex.
Inconsistencies between Oracle R12 and Vertex may result in the tax liability account(s)
within the Oracle General Ledger not supporting the amounts filed on the tax returns
exported from Vertex.
Any variance between these 2 systems could lead to potential audit issues.
It is for these reasons that Vertex strongly recommends this reconciliation process be
run at least once a month.
When to Run
Vertex recommends running this program at least once a month, first in Preview mode
and then again in Sync mode. The ideal time to submit this program would be on the day
the Receivables period is closed. o Best practice is to always run in Preview mode before
submitting Sync, to know which transactions will be updated.
• After the Sync mode completes successfully, it is optional to rerun the program
again in Preview mode to ensure there are no remaining transactions.
Warning: You should not purge your Vertex O series Tax Journal database. We
recommend you keep at least a full 4 to 6 months in the Vertex Tax Journal for the
reconciliation program to correctly process the transactions between Oracle R12 and
Vertex O Series.
Feb 2015 67
Vertex Tax Links for Oracle R12 O2C Integration Guide
Program Parameters
The Vertex AR Tax Reconciliation process has required parameters and additional optional fields.
Tax Regime Code: This is a required field, providing a lookup to all available tax regimes. The regime is
necessary to ensure that the reconciliation process uses the correct partition within Vertex O Series.
GL Start Date: The earliest GL date on a Receivables invoice that will be viewed during the reconciliation
process. Entered in the format of DD-MMM-YYYY (example: 01-NOV-2012).
GL End Date: The latest GL date on a Receivables invoice that will be viewed during the reconciliation
process. Entered in the format of DD-MMM-YYYY (example: 30-NOV-2012).
Transaction Start Date: The earliest transaction date on a Receivables invoice that will be viewed during
the reconciliation process. Entered in the format of DD-MMM-YYYY (example: 01-NOV-2013).
Transaction End Date: The latest transaction date on a Receivables invoice that will be viewed during the
reconciliation process. Entered in the format of DD-MMM-YYYY (example: 30-NOV-2013), this is an
optional field.
Starting Invoice Number: The first transaction number in a range for the program to process. This is an
optional user entered field.
Ending Invoice Number: The first transaction number in a range for the program to process. This is an
optional user entered field.
Mode: This is a required field, with drop down options of Preview or Sync. In PREVIEW mode, the program
will provide a report of any discrepancies between Oracle and Vertex. To view the report, click on the View
Output button in the Request form. In SYNC mode the program will perform the comparison between
Oracle and Vertex, and make any necessary corrections.
Debug: This is a required field, with drop down options of Yes or No. Setting to Yes will enable debug
logging.
Note: You must enter either a GL Start and End Date or a Transaction Start and End Date.
Feb 2015 68
Vertex Tax Links for Oracle R12 O2C Integration Guide
• However, the Oracle date your business mapped to the Posting date could vary from the GL date.
It is possible that the document date or creation date could have been used. It is important to
know how your business has enabled this date mapping.
• The impact is transactions could be listed as only existing in Oracle or only existing in Vertex,
when in fact they do exist in both systems. Examples below.
If the GL date is mapped as the posting date in Vertex, then the reconciliation program would be
comparing like data. Example:
st th
• A Receivables invoice is entered on February 1 and it has an invoice date of January 15 and a
st
GL date of January 31 .
st
The posting date in the Vertex Journal will be January 31 .
th
The tax date in Vertex used for calculating the tax rate will be January 15 .
st
The transaction processing date will be listed as February 1 .
st st
• When the reconciliation program is run with a GL date range of January 1 to January 31 , this
invoice would be found in both Oracle R12 and the Vertex Journal and the tax amounts would be
processed to look for tax variances.
If another date in Oracle (such as the invoice creation date) has been mapped as the Vertex posting date,
then the possibility exists that transactions could be picked up as having a variance when in fact they do
not. Example:
st th
• A Receivables invoice is entered on February 1 and it has an invoice date of January 15 and a
st
GL date of January 31 .
st
The posting date in the Vertex Journal will be February 1 .
th
The tax date in Vertex used for calculating the tax rate will be January 15 .
st
The transaction processing date will be listed as February 1 .
Feb 2015 69
Vertex Tax Links for Oracle R12 O2C Integration Guide
st st
• When the reconciliation program is run with a GL date range of January 1 to January 31 , this
invoice would be found to only exist in Oracle R12 and not the Vertex Journal. If the program is
then run in Sync mode for this date range, an attempt will be made to insert this invoice into the
Vertex Journal. This could result in invoice duplication within Vertex.
• In this same invoice example, had the reconciliation program be submitted with a GL date range
th
of February 1 to February 28 , this invoice would be found to only exist in the Vertex Journal and
not Oracle R12. If the program is then run in Sync mode for this date range, the invoice would be
rolled back (inactivated) in the Vertex Journal.
For businesses that have mapped something besides the GL date as the Vertex posting date, the
reconciliation program is still a valuable tool. However, considerations need to be made when reviewing
the output from the Preview mode before running the Sync.
• If the Preview mode lists invoices as either existing in one system but not the other, whether it be
transactions present in Vertex but not in Oracle R12 or transactions present in Oracle R12 but not
in Vertex, further research should be done by the user before submitting in Sync mode.
• One option would be to run the program in Preview mode with no date range but enter
the invoice number in both the starting and ending Invoice Number parameter. This
removes any date constraints.
If the Preview mode still returns the invoice, this will confirm it as a true
variance.
However, if the invoice is not returned it would indicate the transaction does
exist in both systems with like tax.
• Another option would be to examine the other applicable dates for those transactions.
If creation date or document date is what is mapped as the posting date,
confirm that this date also falls within the parameter date range.
If this date falls outside of the parameter date range, further analysis should be
done to determine if a tax variance exists.
In Sync mode, this program updates the transaction data in the Vertex Tax Journal and the output will
reflect if the updates were successful or if errors were encountered.
• For transactions that are present in both Oracle R12 and Vertex but with differing tax amounts,
corrections are processed in the Vertex O Series Tax Journal using a combination of Vertex O
Series Rollback and Distribute Tax messages. The end result is the Vertex transactions are
updated to reflect the amounts found in Oracle R12.
• For those transactions in Vertex but not in Oracle R12, the transaction is inactivated in Vertex
Journal using the Vertex O Series Rollback message. The end result is the transactions would be
excluded from the Vertex Tax Journal.
• For transactions in Oracle R12 but not in Vertex, the transactions are reprocessed into the Vertex
Journal using the Vertex O Series Distribute Tax message. The end result is the missing
transactions now exists in Vertex and have amounts that correspond to Oracle R12.
Feb 2015 70
Vertex Tax Links for Oracle R12 O2C Integration Guide
Transaction Number Transaction Date Oracle Tax Amt Vertex Tax Amt
------------------ ---------------- -------------- --------------
502563 10-OCT-2013 800.00 700.00
Transaction Number Transaction Date Oracle Tax Amt Vertex Tax Amt
------------------ ---------------- -------------- --------------
18673 02-OCT-2013 200.00
18674 03-OCT-2013 5000.00
18680 03-OCT-2013 -8.00
212 02-OCT-2013 300.00
502544 13-SEP-2013 80.00
502545 04-OCT-2013 -80.00
502563 10-OCT-2013 800.00
This program will contain the following information in the header section of the report output
• Run date
• Parameter values entered
Transaction Date, Number, Oracle Tax Amount and Vertex Tax Amount are common for all sections in
Preview mode.
In addition to the sections and fields mentioned in the Preview Mode, the Sync mode has two additional
fields: Processed – Yes / No and Error- Displays an error message only if the Processed status is No.
Feb 2015 71
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 72
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 73
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 74
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 75
Vertex Tax Links for Oracle R12 O2C Integration Guide
line_char3 For tax partner use only FLEX_CODE_3 *Reserved by Vertex FlexibleCodeField3
Feb 2015 76
Vertex Tax Links for Oracle R12 O2C Integration Guide
Feb 2015 77
Vertex Tax Links for Oracle R12 O2C Integration Guide
Use the script file vertex_oic_set_wallet.sql to set the configuration values for the Oracle Wallet Path and
Oracle Wallet Password. Setting these values enables SSL. Setting them to NULL disables SSL.
• Setup the application hosting O Series Web Services for SSL support
• Setup an Oracle Wallet with the proper certificates using Oracle Wallet Manager
• Sign on to SQL*Plus as the user with access to the proper schema and the permissions that
were listed above.
• Once in SQL*Plus execute the vertex_oic_set_wallet.sql script located in the
/vertex_p2p_db/vertex_o_series_integration/oic/utils directory to enable SSL.
1. On EBS DB tier run following query to determine where the two wallet files need to be copied.
3. Log into sqlplus as tax link custom schema user (i.e. XXVERTEX) and run following sql
SQL> @ vertex_oic_set_wallet.sql
Parameters:
1. Wallet Path - The path to the Oracle Wallet Folder in the form ‘file:<directory path>’
Example:
UNIX: file:/home/oracle/1203/appsutil/wallet
Note: To Disable SSL, set both values to NULL (hit return at each prompt)
Feb 2015 78
Vertex Tax Links for Oracle R12 O2C Integration Guide
First you will need to update the Vertex_OIC_Configuration table with the following entries:
SERVICE_END_POINT: This is the URL for the Vertex OnDemand web service
(https://yourcompanyname.ondemand.vertexinc.com/vertex-ws/services/
USERNAME: This is one a USERNAME that is active and valid in Vertex Central UI
PASSWORD: This is the PASSWORD which corresponds to the USERNAME entered above
DEBUG_MESSAGES: This should be set to T in order to capture XML requests and Responses in test
environments.
https://company.ondemand.vertexinc.com/vertex-
ws/services/ Username {Password} T
Update script
UPDATE VERTEX_OIC_CONFIGURATION
Commit;
Feb 2015 79
Vertex Tax Links for Oracle R12 O2C Integration Guide
Note: Do not Use the Vertex default sysadmin/vertex username and password. These values are not
usually available for Vertex OnDemand customers.
O2C Customers
Log into SQLPLUS as tax link custom schema user (i.e. XXVERTEX)
Expected Output
********************************************************************************
********************************************************************************
Document Number:
Feb 2015 80
Vertex Tax Links for Oracle R12 O2C Integration Guide
Common Errors:
Issue: Error during sending of XML request document.:ORA-29273: HTTP request failed
Process exited.
Possible Solutions:
Issue: Error during sending of XML request document.:ORA-29273: HTTP request failed
Feb 2015 81
Vertex Tax Links for Oracle R12 O2C Integration Guide
Encrypting Passwords
It is possible for the Vertex O Series passwords to be encrypted for use in the Vertex Tax Link
Regime User table using the encryption utility provided by Vertex as part of the Vertex O Series
installation. The utility can be found in the VertexRoot / lib directory. You can also refer to the Vertex O
Series Administration Guide section: Security-related components outside Vertex O Series available from
the https://My.Vertexinc.com.
If you want to pass encrypted user names and/or passwords to any Command line utilities, or for use
with Vertex Web services, use the encryption Command line utility to perform your encryption. This
utility is contained within the vertex_util.jar file, which can be found in the Vertex Home/lib directory.
You can encrypt multiple pairs of user names and passwords each time you use the encryption utility.
User names and passwords must be separated by a single space.
Complete the following steps to run the Command line encryption utility:
where:
Feb 2015 82