Integrating With Vertex O Series

This chapter provides an overview of configuration tasks required to integrate PeopleSoft with the Vertex O Series tax solution and discusses how to:

Click to jump to parent topicUnderstanding PeopleSoft Integration With Vertex O Series

PeopleSoft communicates with the Vertex O Series web service through the PeopleSoft Integration Broker and the Vertex PGC (PeopleSoft Generic Connector). To integrate with the Vertex O Series tax solution, you must perform the following configuration steps:

  1. Set up your local integration gateway and load the gateway connectors.

    The Integration Broker uses the HTTPTARGET connector to communicate with the Vertex web service.

    See Enterprise PeopleTools PeopleBook: Integration Broker, "Managing Integration Gateways"

  2. Activate the TAX_INTEGRATION service operation queue.

  3. Activate the service operations and routings.

    See Managing Service Operations, Enterprise PeopleTools PeopleBook: Integration Broker

    See Managing Routing Definitions, Enterprise PeopleTools PeopleBook: Integration Broker

  4. Activate the PSFT_TAX node.

  5. Set Vertex as the Tax Vendor on the PeopleSoft Financials/Supply Chain Installation Options page and set the appropriate Vertex options on the Tax Provider Installation page.

    See Setting Up PeopleSoft Installation Options for Vertex O Series.

    Note. When you switch from one Tax Vendor Application to another, such as switching from Vertex Q Series to O Series, any geocodes associated with address records in the PeopleSoft database must be upgraded before tax calculations can be sent to the tax vendor software. The Tax Provider Installation page will display the geocode upgrade process status. You should run the process, allow it to complete successfully, or fix any errors that occur, before proceeding.

  6. Configure Billing, Order Management, and Purchasing business units to calculate sales and use taxes through the installed tax vendor and set business-unit level tax vendor options.

    See Setting Up Third-Party Tax Solutions.

See Also

Updating Geo Codes for Locations and Addresses

Click to jump to parent topicConfiguring Vertex O Series Integration

This section discusses how to:

Click to jump to top of pageClick to jump to parent topicPages Used to Configure Vertex O Series Integration

Page Name

Definition Name

Navigation

Usage

Queue Definitions

IB_QUEUEDEFN

PeopleTools, Integration Broker, Integration Setup, Queues

Activate the TAX_INTEGRATION service operation queue.

Service Operation - General

IB_SERVICE

PeopleTools, Integration Broker, Integration Setup, Service Operations

Activate the service operations.

Service Operations - Routings

IB_SERVICETRNGS

PeopleTools, Integration Broker, Integration Setup, Service Operations

Click the Routings tab.

Activate the routings.

Node Definitions

IB_NODE

PeopleTools, Integration Broker, Integration Setup, Nodes

Activate tax node.

Click to jump to top of pageClick to jump to parent topicActivating the TAX_INTEGRATION Service Operation Queue

Access the Queue Definitions page (PeopleTools, Integration Broker, Integration Setup, Queues).

For the TAX_INTEGRATION queue, verify that the Queue Status is Run.

Click to jump to top of pageClick to jump to parent topicActivating the Service Operations

Access the Service Operations - General page (PeopleTools, Integration Broker, Integration Setup, Service Operations, General).

PeopleSoft delivers service operations in PeopleSoft Integration Broker with a default status of Inactive. You must activate each service operation before attempting to send or receive data from a third-party source, such as Vertex. To setup a service operation use the information in the table below and refer to the setup instruction in the PeopleSoft Supply Chain Management Integrations 9.1 PeopleBook, "Implementing Integrations" chapter, Setting Up Service Operations section.

Service Operation

Direction and Type

Handlers

Chunking Available?

Integrates With

DO_TAXCALC_REQ

Outbound

Synchronous

not applicable

No

Vertex O Series or another third-party tax vendor

GET_GEOCODES_REQ

Outbound

Synchronous

not applicable

No

Vertex O Series

See Setting Up Service Operations.

See Enterprise PeopleTools PeopleBook: Integration Broker

Click to jump to top of pageClick to jump to parent topicActivating the Routings

Access the Service Operations - Routings page (PeopleTools, Integration Broker, Integration Setup, Service Operations, Routings).

Activate the DO_TAXCALC_REQ_V2 and the GET_GEOCODE_REQ_TAX routings for the PSFT_TAX node.

See Manage Routing Definitions, Enterprise PeopleTools PeopleBook: Integration Broker

Click to jump to top of pageClick to jump to parent topicActivating the PSFT_TAX Node

Access the Node Definitions page (PeopleTools, Integration Broker, Integration Setup, Nodes, Node Definitions).

Verify that the PSFT_TAX node is active.

See Adding and Configuring Nodes, Enterprise PeopleTools PeopleBook: Integration Broker

Click to jump to parent topicSetting Up PeopleSoft Installation Options for Vertex O Series

The Set Up Financials/Supply Chain, Install, Tax Provider Installation page provides the following options for Vertex O Series:

Note. To display options for Vertex O Series, Vertex must be chosen as the Tax Vendor on the Overall Installation Options page and Vertex O Series as the Vertex Tax Application on the Tax Provider Installation page.

Tax Vendor Call Options

Determines whether tax calculation transactions are sent to Vertex line by line or as an entire document. The options are:

  • Doc Level: an entire invoice or document is sent to Vertex for tax calculation.

  • Line Level: tax calculation transactions are sent to Vertex line by line.

The Doc Level option allows you to take advantage of invoice and multiline maximum tax rules in some jurisdictions, but when you choose the Doc Level option, returns and credits must be carried out by issuing a full credit and rebill. Choosing the document level option will also provide faster tax transaction processing in most situations since fewer messages are exchanged with the Vertex tax software.

The Line Level option allows more flexibility when issuing credits and returns, but prevents you from taking advantage of maximum tax rules at the invoice or multiline level. This option should be chosen when it is not an acceptable practice to issue a full invoice credit and rebill when an individual line must be credited.

Tax Vendor Call – Payables

Select how tax calculation transactions from the Accounts Payable application are sent to Vertex. Transactions from Purchasing are always sent line by line, regardless of the value in this field.

Tax Vendor Call – Sales

Select how tax calculation transactions from the Billing application are sent to Vertex. Transactions from Order Management that are fully paid at sales order entry time also use this value; otherwise, they will always be sent line by line.

Tax Vendor Upgrade Status

Displays the status of the process run when the tax vendor application is changed. The process updates the geocodes associated with addresses in PeopleSoft.

Message Node Name

Set to the node setup for the exchange of messages between the PeopleSoft Integration Broker and the Vertex O Series web service. By default, the node to use is PSFT_TAX.

Tax Exemption Override Allowed

Select to allow tax exempt transactions to be sent from PeopleSoft to Vertex. If tax exemption overrides are not allowed, exemptions must be maintained within the Vertex application.

Click to jump to parent topicTesting the Vertex O Series Integration

To test the Vertex O Series integration, click the Test Tax Install button on the Tax Provider Installation page. The system will send a test transaction to Vertex and should report a Geocode and nonzero tax amount. If an error message appears or the tax amount is zero, then there is a problem with the tax installation that must be corrected.