Integrating with PeopleSoft EnterpriseOne General Ledger

This chapter provides an overview of the General Ledger interface and discusses how to:

Click to jump to parent topicUnderstanding the General Ledger Interface

The major tasks involved in the integration of Global Payroll with General Ledger are:

This chapter covers only the tasks performed in the Enterprise database. The EnterpriseOne documentation discusses setting up the integration on the EnterpriseOne side and loading EnterpriseOne data into the Enterprise database.

See Also

JD Edwards EnterpriseOne 8.12 Application Integrations with Oracle PeopleSoft Applications Implementation Guide, Setting Up the JD Edwards EnterpriseOne to PeopleSoft General Ledger Integration

Click to jump to parent topicSetting Up the Integration in the Enterprise Database

The Enterprise database must be set up to receive the data transferred from the EnterpriseOne database and to send the payroll accounting data. Scripts that you run as part of the integration installation accomplish most of these steps. Use the instructions in this section to verify and complete the setup.

This section discusses how to:

Click to jump to top of pageClick to jump to parent topicPages Used to Set Up the Integration in the Enterprise Database

Page Name

Definition Name

Navigation

Usage

Service Operations - General

IB_SERVICE

PeopleTools, Integration Broker, Integration Setup, Service Operations, General

Activate service operations.

Service Operations - Handlers

IB_SERVICEHDLR

PeopleTools, Integration Broker, Integration Setup, Service Operations, Handlers

Verify that handlers for service operations are active.

Node Definitions

IB_NODE

PeopleTools, Integration Broker, Integration Setup, Nodes, Nodes Definitions

Verify the Integration Broker node definition for integration with EnterpriseOne.

Nodes - Connectors

IB_NODECONN

PeopleTools, Integration Broker, Integration Setup, Nodes, Connectors

Verify connector properties

Nodes - Routings

IB_NODEROUTINGS

PeopleTools, Integration Broker, Integration Setup, Nodes, Routings

Verify activation of the routings used in this integration.

Queue Status

IB_MONITOR_QUEUES

PeopleTools, Integration Broker, Service Operations Monitor, Administration, Queue Status

Verify the status of queues.

Click to jump to top of pageClick to jump to parent topicVerifying Service Operation Version and Handler Activity

The integration between Global Payroll and General Ledger uses service operations, along with their associated handlers and routings to perform message and subscription integration. Before you continue with the integration setup, you must ensure that these objects are active.

To activate a service operation version:

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

  2. Select the Active check box in the Default Service Operation Version group box.

To verify that a handler is active for a given service operation:

  1. Access the Service Operation - Handlers page (PeopleTools, Integration Broker, Integration Setup, Service Operations, Handlers).

  2. Verify that the value of the Status field is Active for the handlers associated with the service operation.

Verify the service operation and handler activity for the following service operations:

Note. It is not necessary to activate routings using the Routings page in the Service Operation component. You can activate all the routings for a specific node at once using the Routings page of the Nodes component.

See Verifying Routing Configuration.

Click to jump to top of pageClick to jump to parent topicVerifying Node Definition

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

The PSFT_E1 node is delivered as an example for the integration from HR to EnterpriseOne.

It is recommended that you copy the PSFT_E1 node to one that matches your naming convention and system configuration.

Activate the node and verify the following settings:

Node Type

External

Authentication Option

None

Click to jump to top of pageClick to jump to parent topicSetting Up the Connector Properties

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

Verify and complete the properties setup as defined in the table below.

Property ID

Property Name

Required

Value

HEADER

Content-Type

 

text/xml

HEADER

sendUncompressed

select

Y

HTTPPROPERTY

Method

select

POST

PRIMARYURL

URL

select

The URL points to the EnterpriseOne Integration Server. Enter it in the following format:

http://<XPI IS MachineName>:<IS port>/invoke/PSFT_Dispatcher.Inbound:InboundServiceDispatcher

Note. The Properties group box is available on this page only if you configure your gateway properly.

See Also

PeopleTools: Integration Broker PeopleBook

Click to jump to top of pageClick to jump to parent topicVerifying Routing Configuration

Access the Nodes - Routing page (PeopleTools, Integration Broker, Integration Setup, Nodes, Routings).

For each service operation listed in the table below, verify that the routing type, sender node, and receiver node are set to the values listed in the following table, and that the Status is Active. If necessary, click the Details link next to a service operation to access the Service Operations page.

Service Operation

Operation Type

Sender Node

Receiver Node

ACCOUNT_CHARTFIELD_FULLSYNC

Asynch

PSFT_E1

PSFT_HR

ACCOUNT_CHARTFIELD_SYNC

Asynch

PSFT_E1

PSFT_HR

BUS_UNIT_FS_SYNC

Asynch

PSFT_HR

PSFT_E1

BUS_UNIT_GL_FULLSYNC

Asynch

PSFT_E1

PSFT_HR

BUS_UNIT_GL_SYNC

Asynch

PSFT_E1

PSFT_HR

COST_CENTER_FULLSYNC

Asynch

PSFT_E1

PSFT_HR

COST_CENTER_SYNC

Asynch

PSFT_E1

PSFT_HR

GP_POST_GL

Asynch

PSFT_HR

PSFT_E1

GP_POST_GL_REPLY

Asynch

PSFT_E1

PSFT_HR

MARKET_RATE_REQ

Asy to Syn

PSFT_HR

PSFT_E1

MARKET_RATE_SYNC

Asynch

PSFT_E1

PSFT_HR

See Also

PeopleTools: Integration Broker PeopleBook

Click to jump to top of pageClick to jump to parent topicVerifying Queue Setup

Access the Queue Status page (PeopleTools, Integration Broker, Service Operations Monitor, Administration, Queue Status).

Verify that the status is Running for each of the following queues:

If the status is Paused for any of the listed channels, click Run to change the status.

See Also

PeopleTools: Integration Broker PeopleBook

Click to jump to parent topicViewing the Data in the PeopleSoft HCM Database

The EnterpriseOne data is automatically imported into the HCM database tables through subscription to the XML messages that are sent by the EnterpriseOne Integration Server.

This section lists the pages used to review message status and view imported data and discusses how to:

Click to jump to top of pageClick to jump to parent topicPages Used to Review Service Operations Status and View Imported Data

Page Name

Definition Name

Navigation

Usage

Monitor Overview

IB_MONITOR_OVRVIEW

PeopleTools, Integration Broker, Service Operations Monitor, Monitoring, Asynchronous Services, Monitor Overview

View high-level information sorted by service operation or queue.

Asynchronous Details

IB_MONITOR_DET

PeopleTools, Integration Broker, Service Operations Monitor, Monitoring, Asynchronous Details, Asynchronous Details

View asynchronous service operation properties.

GL Business Unit

BUS_UNIT_TBL_GL

Set Up HRMS, Foundation Tables, Organization, GL Business Unit, GL Business Unit

View the identifier and description of business units imported into the GL Business Units table.

GL Account Table

GL_ACCOUNT

Set Up HRMS, Common Definitions, ChartField Configuration, Chartfield Values

Then select Account.

View the identifier and description of accounts imported into the GL Account table.

View Cost Centers

HPYP_CC_TBL

Set Up HRMS, Common Definitions, GL Integrations, Common GL Objects, View Cost Centers

View cost centers imported into the Cost Center table.

See Also

PeopleTools: Integration Broker PeopleBook

Click to jump to top of pageClick to jump to parent topicCreating a Query to View Data Imported Into the GL Business Units Table

The GL Business Unit page only provides the IDs and descriptions of the GL business units imported into the GL business units table. To view additional information about the GL business units, such as the As of Date and Base Currency, you must create a query using Query Manager.

To create a query to view information from the GL business units table using Query Manager, you must:

  1. Select Reporting Tools, Query, Query Manager.

  2. Select Create a New Query.

  3. Search for the record BUS_UNIT_TBL_FS.

  4. Click the Add Record link.

    This takes you to the Query page.

  5. On the Query page, click the Check All Fields button.

  6. Click on the Records page and search for the record BUS_UNIT_TBL_GL.

  7. Click the Join Record link.

  8. Use the default join type, Join to filter and get additional fields (Standard Join).

  9. Click on the A= BUS_UNIT_TBL_FS link.

  10. Click the Add Criteria button.

  11. Select the fields to include in the query.

  12. Save the query.

  13. Run the query.

    The query returns a list of all GL business units.

Click to jump to top of pageClick to jump to parent topicCreating a Query to View Data Imported Into the GL Accounts Table

The GL Accounts page only provides the IDs and descriptions of the GL accounts imported into the GL accounts table. To view additional information about the GL accounts, such as currency and account type, you must create a query using Query Manager.

To create a query to view information from the GL accounts table using Query Manager, you must:

  1. Select Reporting Tools, Query, Query Manager.

  2. Select Create a New Query.

  3. Search for the record GL_ACCOUNT_TBL.

  4. Click the Add Record link.

    This takes you to the Query page.

  5. On the Query page, select the fields to include in the query.

  6. Save the query.

  7. Run the query.

Click to jump to parent topicConfiguring the Target Product and System

To configure the target product and system, use the Configure Target Product (HPIP_CONFIG_PRD) and Configure Target System (HPIP_TGT_SYS_GL) components.

This section provides overviews of target product and system configuration and account balancing defaults, lists common elements, and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Target Product and System Configuration

This table defines the terminology used in this section:

Target system

A specific GL installation that is represented by a message node. It indicates to what target system the payroll accounting lines are to be sent, which is the database that runs the general ledger application.

Target product

The target general ledger product to which payroll data is to be posted on the specified target system.

Here is a summary of the configuration steps:

  1. Assign processing defaults for a target product on the Configure Target Product page.

  2. Associate the target product with a target system by selecting the target product on the Configure Target System page.

    You can enter processing options for the target product on this page. The processing options you enter here override the options you have entered for the target product.

  3. Associate the target system with the general ledger business unit by selecting the message node (target system) on the Configure GL Business Unit page.

    This step associates accounting lines with the target system because each accounting line has the general ledger business unit as a required field.

Click to jump to top of pageClick to jump to parent topicUnderstanding Account Balancing Defaults

You specify two default configuration options related to account balancing:

Click to jump to top of pageClick to jump to parent topicCommon Elements Used in this Section

Balance Accounting Lines

Select this check box if you want the system to calculate whether the debits equal the credits for each general ledger business unit.

Book to Suspense Account

This field is available for entry if you select Balance Accounting Lines.

Select Book to Suspense Account to post unbalanced amounts to a suspense account when the credits do not equal debits. If selected, you must specify a suspense account number on the Configure GL Business Unit page.

Consolidate Accounting Lines

Accounting lines are automatically consolidated for Global Payroll.

Click to jump to top of pageClick to jump to parent topicPages Used to Configure the Target Product and System

Page Name

Definition Name

Navigation

Usage

Configure Target Product

HPIP_CONFIG_PRD

Set Up HRMS, Common Definitions, GL Integrations, Common GL Objects, Configure Target Product, Configure Target Product

Assign processing defaults for the target product.

Configure Target System

HPIP_TGT_SYS_GL

Set Up HRMS, Common Definitions, GL Integrations, Common GL Objects, Configure Target System, Configure Target System

Select the target product for the target and update the processing options for the target product.

Click to jump to top of pageClick to jump to parent topicConfiguring the Target Product

Access the Configure Target Product page (Set Up HRMS, Common Definitions, GL Integrations, Common GL Objects, Configure Target Product, Configure Target Product).

Note. The data on this page is delivered as system data; generally, you should not modify this data.

Maximum Lines Chunking Limit

Set Chunking Limit

Select if you want the system to chunk the data when the number of accounting lines exceeds the maximum of the target product.

Max Number of Accounting Lines (maximum number of accounting lines)

This field is available for entry if you select Set Chunking Limit. Enter the maximum number of accounting lines that the target product can accept.

Click to jump to top of pageClick to jump to parent topicConfiguring the Target System

Access the Configure Target System page (Set Up HRMS, Common Definitions, GL Integrations, Common GL Objects, Configure Target System, Configure Target System).

When you access the page, select the PeopleSoft Integration Broker node that you defined for the integration with EnterpriseOne. The node represents the target system.

Target System Details

The default processing options that you selected on the Configure Target Product page are the default values on this page. You can update the processing options here. You can also override the processing options on the process run control page when you post the accounting lines.

Product

Select EnterpriseOne as the target general ledger product to which payroll data is to be posted on this target system.

Product Release

Select the release number of the product.

Click to jump to parent topicMapping Cost Centers and Accounts

To map cost centers and accounts, use the Chartfields (GP_GL_CHARTFLD), Element Groupings (GP_GL_GROUP), Account Mapping (GP_GL_MAP), and Chartfields for Cost Center (GP_CC_SETUP) components.

This section provides an overview of cost center mapping for Global Payroll integration with General Ledger and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Cost Center Mapping for Global Payroll Integration with General Ledger

General Ledger requires the cost center identity, which is not part of the standard accounting line data generated by Global Payroll. Therefore, you must map cost centers to the chartfields so that the cost center can be derived and transmitted to EnterpriseOne.

In Global Payroll, chartfields are keyed by pay entity, business unit, and effective date. To derive the cost center, the mapping definition of chartfields to cost centers must also be keyed in the same way. These values are determined by:

Mapping Process Diagram

This diagram identifies the pages on which the account and cost center mapping tasks are accomplished and indicates the sources of the data used on the pages. Shaded steps are specific to cost center mapping.

Cost center and account mapping for Global Payroll

Mapping Process Steps

Here are more details about the steps for mapping accounts and cost centers to Global Payroll data:

  1. Indicate which system and variable elements can be used as chartfields.

    1. For system elements, select the Use As Chart Field check box on the Source and Use page and select a prompt view. For variable elements, select the Use As Chart Field check box on the Variables - Definition page and select a prompt view.

    2. On the Element Name page, select the Store check box.

    3. Include the chartfield elements in the payroll process list.

      Note. The pay entity must be set up as a chartfield. For example, if companies correspond to pay entities in your organization, then the COMPANY element must be set up as a chartfield. Define a new variable for pay entity and configure it as a chartfield if necessary.

  2. On the Chartfields page (GP_GL_CHARTFLD), select up to six chartfield elements that apply to a specific business unit and pay entity.

    Note. There are eight chartfields on this page. However, chartfields 7 and 8 are used for cost center mapping during the posting process. Chartfield 7 is overwritten with the controlling area, while chartfield 8 is overwritten with the cost center. No matter what elements you select here for chartfields 7 and 8, the posting that is sent to General Ledger always has the controlling area and cost center in chartfields 7 and 8.

  3. On the Element Groupings page (GP_GL_GROUP), place earning, deduction, and accumulator elements into groups.

  4. On the Mapping page (GP_GL_MAP), map the element groups and chartfield values to their corresponding general ledger accounts.

  5. On the GP Chartfield for Pay Entity page (GP_PE_CF_SEC), identify which chartfield number contains the pay entity element.

  6. On the Chartfields for Cost Center page (GP_CC_SETUP), select chartfields for cost center mapping.

  7. On the Chartfield Mappings page (GP_CC_MAP), map chartfield values to cost centers.

See Also

Defining Calculation Elements

Integrating with PeopleSoft General Ledger

Click to jump to top of pageClick to jump to parent topicPages Used to Map Cost Centers and Accounts to the Global Payroll System

Page Name

Definition Name

Navigation

Usage

Chartfields

GP_GL_CHARTFLD

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Chartfields, Chartfields

Select Chartfields for account and cost center mapping.

Element Groupings

GP_GL_GROUP

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Element Groupings, Element Groupings

For a pay entity and business unit, group similar earnings, deductions, or accumulators so that they can be mapped to general ledger accounts.

Mapping

GP_GL_MAP

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Account Mapping, Mapping

Map General Ledger accounts to a combination of chartfield values associated with a grouping of earnings, deductions, or accumulators.

Chartfields For Cost Center

GP_CC_SETUP

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Chartfields for Cost Center, Chartfields For Cost Center

Select Chartfields for cost center mapping.

GP Chartfield for Pay Entity

GP_PE_CF_SEC

Click the Pay Entity Chartfield link on the Chartfields for Cost Center page.

Specify the sequence number of the pay entity Chartfield for the business unit.

Chartfield Mappings

GP_CC_MAP

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Chartfields for Cost Center, Chartfield Mappings

Map Chartfield values to cost centers.

Click to jump to top of pageClick to jump to parent topicSelecting Chartfields for Allocating Costs to General Ledger

Access the Chartfields page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Chartfields, Chartfields).

To successfully map cost centers, you must select Pay Entity as one of the chartfields on this page. Furthermore, you must set up the Pay Entity element with the same field number for all pay entities within a given business unit.

See Selecting ChartFields for Allocating Costs to General Ledger.

Click to jump to top of pageClick to jump to parent topicGrouping Earnings, Deductions, or Accumulators for General Ledger Processing

Access the Element Groupings page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Element Groupings, Element Groupings).

See Grouping Earnings, Deductions, or Accumulators for General Ledger Processing.

Click to jump to top of pageClick to jump to parent topicMapping General Ledger Accounts to Chartfield Values and Element Groupings

Access the Mapping page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Account Mapping, Mapping).

See Mapping ChartFields and Grouping Codes to General Ledger Accounts.

Click to jump to top of pageClick to jump to parent topicSelecting Chartfields for Cost Center Mapping

Access the Chartfields For Cost Center page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Chartfields for Cost Center, Chartfields For Cost Center).

Pay Entity Chartfield

Click this link to access the GP Chartfield for Pay Entity page.

Freeze Fields

Select this when you have finished configuring the chartfield setup.

When this check box is selected, all fields on the page become unavailable for data entry. If you later deselect this check box, the fields are again available for entry.

Chartfields for Cost Center

Add rows as necessary in this grid to list all of the chartfields that you want to use for mapping cost centers for this pay entity and business unit.

Chartfield

Select the field number that you populated with the element name on the Chartfields page.

Element Name

The system populates the name of the system element for the chartfield. This is used as a label on the Chartfield Mappings page.

Edit Table

Select the record that contains the values for the chartfield.

Click to jump to top of pageClick to jump to parent topicIdentifying the Pay Entity Chartfield

Access the GP Chartfield for Pay Entity page (click the Pay Entity Chartfield link on the Chartfields for Cost Center page).

Chartfield

Referring to the Chartfields page, select the field number that corresponds to the pay entity chartfield element.

Note. This value must be the same for all pay entities in the business unit.

Click to jump to top of pageClick to jump to parent topicMapping Chartfield Values to Cost Centers

Access the Chartfield Mappings page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Integration, Chartfields for Cost Center, Chartfield Mappings).

The fields on this page are available for entry only if the Freeze Fields check box is selected on the Chartfields for Cost Center page.

Effective Date

This field cannot be modified on this page.

Controlling Area

Select the controlling area to which you want to map the chartfield combinations.

The available values are the company codes entered into the Enterprise Controlling Area table when EnterpriseOne companies were imported into the Enterprise Business Unit GL table.

Cost Center ID

Select the cost center to which you want to map the chartfield combinations. The available values are the EnterpriseOne business units that you imported into the Enterprise Cost Center table.

Chartfield Values

Select chartfield values for each chartfield listed on the page. The chartfields are displayed in the order that you specified on the Chartfields for Cost Center page.

The available values for each chartfield are the values in the edit table that you specified for the chartfield on the Chartfields for Cost Center page.

Click to jump to parent topicRetrieving Currency Exchange Rates

To retrieve currency exchange rates, use the Request Market Rates (HIE1_MKT_RT_RNCTL) component.

This section provides overviews of the currency market rates integration and currency rounding, and discusses how to request market rates.

Click to jump to top of pageClick to jump to parent topicUnderstanding the Currency Market Rates Integration

Currency market rates must be synchronized between the Enterprise payroll systems and the EnterpriseOne financial system, which is the master for market rates. Use the same run control page to either schedule the synchronization or manually request it.

Note. Currency cross referencing must be set up in PeopleSoft EnterpriseOne's XPI Cross-Reference database before you use this process to synchronize market rates.

Here is a brief description of the processing:

  1. A Global Payroll user requests market rates, specifying a currency or range of currencies and a date on the run control page.

    The Market Rate Import Application Engine process (HI_MKT_RT) creates the MARKET_RATE_REQ message, converts it to a synchronous message, and sends it.

  2. The Integration Server sends back the MARKET_RATE_SYNC response message containing the market rates available for the specified currency pairs and date.

    Either the multiplier or divisor is populated in the message, based on the calculation method and currency conversion method in the record. The other rate is initialized to 1.0.

  3. The Integration Broker subscription to the MARKET_RATE_SYNC message updates the Enterprise Market Rate Data table (RT_RATE_TBL).

    Note. You must set all market rates that you will use in EnterpriseOne and sync up those rates with Enterprise. Processing payroll transactions with currencies for which market rates are set up in Enterprise and not in EnterpriseOne will produce invalid data in EnterpriseOne.

    If a query is made to a currency exchange rate that does not exist in EnterpriseOne for the date specified, no data is returned in the reply.

Click to jump to top of pageClick to jump to parent topicUnderstanding Currency Rounding

If you are keeping amounts in different currencies on both the detail and sum (balance) level, there is a potential rounding issue. The problem arises from the fact that the system converts single amounts, sums them up for balancing, and then converts the sum. As a result, the converted amount of the sum does not equal the sum of the single conversions. To prevent this problem, you must select the Balance Accounting Lines check box on the Configure Target Product and Configure Target System pages.

When the Balance Accounting Lines check box is selected:

See Also

Understanding Account Balancing Defaults

Click to jump to top of pageClick to jump to parent topicPages Used to Retrieve Currency Exchange Rates

Page Name

Definition Name

Navigation

Usage

Request Market Rates

HIE1_MKT_RT_RNCTL

Set Up HRMS, Common Definitions, GL Integrations, Payroll to E1 General Ledger, Request Market Rates, Request Market Rates

Query market exchange rates from the PeopleSoft EnterpriseOne Financials system. Either schedule the request or enter an ad hoc request.

Monitor Overview

IB_MONITOR_OVRVIEW

PeopleTools, Integration Broker, Service Operations Monitor, Monitoring, Asynchronous Services, Monitor Overview

View the message status of the MARKET_RATE_SYNC message.

Click to jump to top of pageClick to jump to parent topicRequesting Market Rates

Access the Request Market Rates page (Set Up HRMS, Common Definitions, GL Integrations, Payroll to E1 General Ledger, Request Market Rates, Request Market Rates).

Request Date

Enter the current date.

To accommodate requests scheduled through PeopleSoft Process Scheduler, the system overrides the entered request date with the current system date when the request date is in the past. If the request date is the current date or a future date, the system uses the request date.

Rate Type

Select the rate type under which the imported values are to be stored in the Enterprise table. Values are established on the Market Rate Data table (RT_TYPE_TBL).

Market Rate Index

Select the market rate index under which the imported values are to be stored in the Enterprise table. Values are established on the Market Rate Index table (RT_INDEX_TBL). The default value is MODEL.

Target System

Select the node that you established for the integration with EnterpriseOne.

From Currency Range

Define the alphabetical range of currencies from which you're requesting the exchange rate.

For example, from GBP − RUR.

For a single from currency, select the same currency in both fields.

To Currency Range

Define the alphabetical range of currencies to which you're requesting the exchange rate.

For a single to currency, select the same currency in both fields.

For example, to EUR - EUR.

The system retrieves the market rate for each currency code pair that falls alphabetically in the from and to currency ranges that you specify.

See Also

PeopleSoft 9.1 PeopleBook: Enterprise Components

Click to jump to parent topicPreparing and Posting Accounting Lines from Global Payroll to General Ledger

This section provides overviews of the posting of accounting lines and the Global Payroll posting process and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding the Posting of Accounting Lines

After you process payroll in Global Payroll, you can create the accounting lines and post them as journal entries to General Ledger. A journal entry typically consists of header and line data.

You must first synchronize the market exchange rates between the financials system and the payroll system if your data involves multiple currencies.

The posting framework posts summary GL transactions grouped by GL business unit (Business_Unit_GL). As part of the posting, an Application Engine process prepares the data, creates the message, and sends to the node that is specified for the GL business unit.

The Integration Server loads the data into the EnterpriseOne Journal Entry Transactions − Batch File table (F0911Z1). The Integration Server sends a reply message stating whether the transactions sent by Global Payroll were successfully posted and loaded into table F0911Z1.

After the data has been loaded into table F0911Z1, you run a batch process to validate the data and to insert the records into the Account Ledger table (F0911). You then post the transactions from table F0911 to the Account Balances table (F0902) just as you would post any other transactions.

If the payroll transactions contain errors in the data, you can:

Click to jump to top of pageClick to jump to parent topicUnderstanding the Global Payroll Posting Process

This section discusses:

Steps for Creating and Sending Global Payroll Accounting Lines

These are the steps for creating accounting lines in Global Payroll and sending them to General Ledger:

  1. Calculate and finalize payroll.

  2. Run the GL Transaction Creation Application Engine process (GP_GL_PREP) with the Calculate option selected to generate the payroll accounting lines on the GP Accounting Line table (GP_ACC_LINE).

    Note. Do not run the process using the Finalize option. When you select a calendar group ID that integrates with EnterpriseOne, the page does not display the Finalize option.

  3. View the Transactions w/o Account (transactions without account) page to check for amounts not associated with accounts and make corrections as necessary.

  4. If corrections were made, rerun the GL Transaction Creation process with the Calculate option selected.

  5. Run the Finalize Costs for GL Application Engine process (HI_GP_POST) to post the journal entries to General Ledger.

  6. Check the status of the posting process in the Process Scheduler process monitor.

  7. Check the status of the transaction on the View GL Transaction Status page.

  8. If for any reason it is necessary to correct account data after it has been posted:

    1. Run the GL Reset Process Application Engine process (GP_GL_RESET).

    2. Make data corrections.

    3. Repeat steps two through five.

Posting Process Description

When you run the Finalize Costs for GL process, the system performs the following processing steps:

  1. Determines the cost center:

  2. Checks debit and credit balances if the balancing option is selected:

    If they do not match, creates a suspense entry if a suspense account is defined for the GL business unit or generates an error without posting accounting lines if the suspense account option is not selected or the account is not defined.

    If the foreign total amount nets to zero and domestic total amount does not, it assumes rounding differences due to currency conversion and forces the domestic amount to net to zero.

  3. Creates a separate posting for each GL business unit.

    Each posting is divided into segments according to the chunking limit that is configured on the Target Products page. The segmentation requires definition of the clearing accounts for the GL business unit. If no chunking limit is set for the target product, the program does not segment the postings; in this case it does not check for clearing accounts. Each segment is sent with the GP_POST_GL XML message.

Reset Process Description

If the transactions sent to General Ledger are later found to have errors, you might have to run the GL Reset process and repost the transactions.

The GL Reset process:

See Also

Understanding Account Balancing Defaults

Click to jump to top of pageClick to jump to parent topicPages Used to Prepare and Post Global Payroll Accounting Lines

Page Name

Definition Name

Navigation

Usage

Send Costs to GL

GP_GL_PREPARE

Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Send Costs to GL, Send Costs to GL

Create payroll accounting lines in the GP Accounting Line table.

Transactions without Account

GP_GL_NO_ACCT

Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Review GL Costing w/o account, Transactions without Account

View transactions that were not assigned a General Ledger account by the calculate phase of the GL Transaction Creation Application Engine process.

See Viewing Transactions without General Ledger Accounts.

Finalize Costs for GL

HPIP_GP_FINALIZE

Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Finalize Costs for GL, Finalize Costs for GL

Prepare the accounting lines for posting and post them to General Ledger.

View GL Transaction Status

HPIP_PRCS_STAT

Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Review GL Transaction Status, View GL Transaction Status

View the transaction status of the posting process.

View Process Parameters

HPIP_PRCS_PAR_SEC

Click the Process Parameters link on the View GL Transaction Status - Transaction Details tab.

View a summary of the process instance information and view the parameters used to run the process that generated the process instance.

View Detail Transactions

HPIP_PRCS_SEG_SEC

Click the Detail Transactions link on the View GL Transaction Status - Transaction Details tab.

View log information generated for each segment.

View Transaction Parameters

HPIP_SEG_PAR_SEC

Click the Transaction Parameters link on the View Transaction Details page.

View a summary of the segment information and view the GL business unit for which the segment was posted.

View Accounting Line Data

HPIP_PRCS_DATA_SEC

Click the Accounting Line Data link on the View GL Transaction Status - Transaction Details tab.

View a summary of the accounting line data that was posted by the process.

Process Message Log

HPIP_PRCS_MSG_SEC

Click the Message Log link on the View GL Transaction Status - Transaction Details tab.

View messages generated during the Application Engine process. The information on this page matches that provided by the View Messages functionality in Process Monitor.

Reset GL

GP_GL_RESET

Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Reset GL

Run the GL Reset process before rerunning the GL Transaction Creation process when reposting is necessary due to errors.

Click to jump to top of pageClick to jump to parent topicGenerating Global Payroll Accounting Lines

Access the Send Costs to GL page (Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Send Costs to GL, Send Costs to GL).

Note. Do not run the process using the Finalize option for the integration with General Ledger; the Finalize option is not available if the selected calendar group ID integrates with EnterpriseOne. Use the GL Finalize for E1 page to finalize the GL processing.

See Sending Payroll Data to General Ledger.

Click to jump to top of pageClick to jump to parent topicPosting Global Payroll Accounting Lines

Access the Finalize Costs for GL page (Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Finalize Costs for GL, Finalize Costs for GL).

Override Indicator

Select to override the default balance options set for the target product on the Configure Target System page. The other fields in this group box are available for entry only if Override Indicator is selected.

Balance Accounting Lines

Select this check box if you want the system to calculate whether the debits equal the credits for each general ledger business unit.

Book to Suspense Account

This field is available for entry if you select Balance Accounting Lines.

Select Book to Suspense Account to post unbalanced amounts to a suspense account when the credits do not equal debits. If selected, you must specify a suspense account number on the Configure GL Business Unit page.

Checking the Process Status and Message Log

Even if the process runs successfully, there might be functional problems with validation, balancing, or chunking. To determine whether there are problems:

  1. Access Process Monitor.

  2. Enter criteria to filter the data displayed and click Refresh.

  3. Verify that the HI_GP_POST Application Engine process status is Success.

  4. Click Details for the process instance.

  5. Click Message Log.

Resolving Process Service Operations Monitor Log Errors for the Posting Process

Problem

Solution

Validation failure caused no accounting lines to be posted to general ledger even though the posting status is Success.

Correct the issue reported in the error message and rerun the posting process.

Balancing failure caused no accounting lines to be posted to general ledger even though the posting status is Success.

Verify that both of the following are true:

  • Book to Suspense Account is selected on the posting process run control page.

  • The suspense account is assigned on the Configure GL Business Unit page.

    Rerun the posting process after correcting the settings.

Chunking failure caused no accounting lines to be posted to general ledger even though the posting status is Success.

Verify that the clearing account is specified on the Configure GL Business Unit page.

Rerun the posting process after entering the clearing account.

See Also

Understanding Account Balancing Defaults

Click to jump to top of pageClick to jump to parent topicViewing the Transaction Status

Access the View GL Transaction Status page (Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Review GL Transaction Status, View GL Transaction Status).

Note. As you continue to post accounting lines, the Transaction Status tables can grow significantly, since each posting process writes data to these tables. These tables are not automatically purged. To purge data from these tables, you can click the Delete button to delete one or more rows. After you delete a row on this page, the data displayed in the Process Parameters, Detail Transactions, and Accounting Line Data pages is also purged when you save the View GL Transaction Status page.

View Process Instance

Use the fields in this group box to select the process instances to view. The page automatically displays the process instances from the last day.

User ID

Enter a user ID to view only process instances associated with that ID.

Process Instance

If you know the process instance numbers for the process instances you want to view, enter the numbers.

Last

Enter a quantity and then select the associated duration (days, hours, or minutes). If you want to see all results, select None.

Refresh

After you have entered criteria, click this button to refresh the information that appears Process List group box.

Process Instance Tab

The fields on this tab display the same information as the Process Monitor.

Transaction Status Tab

Select the Transaction Status tab.

Transaction Status

Displays the status of the overall posting transaction. A posting transaction can include multiple segments (or chunks). Each of these segments has a separate status value, which can be viewed on the View Detail Transactions page. The status of the overall transaction is Success if all segments have a status of Success. The status of the overall transaction is Error if one or more segments have a status of Error.

Values include:

Success

Error

Processing

Staged

Error Code

Displays the source of the error on the process level, if the posting transaction encountered an error. Values include:

Account Number Mismatch: The account number of one of the lines of the payroll transaction does not match an account number previously assigned and cross-referenced during the Account initial or incremental load. No insert into the Z1 staging table was attempted.

Inserting Error: The insert of the lines of the payroll transaction into the Z1 staging tables failed due to some problem, such as a primary key was omitted. No lines were inserted into the Z1 staging table.

Processing Error: An error occurred during the posting process or the subsequent message processing in Integration Broker. See the Process Monitor or the Service Operations Monitor for more information.

No Information Available: No information is available on the source of the error.

Validation Failed: One of the validations performed by the posting process has failed. See the Process Message Log page for more information.

Integration Broker Error: The message could not be sent by Integration Broker. Review the setup described in the Setting Up the Integration in the Enterprise Database section to verify that it is complete and correct.

Segment Error: One of the segments of this posting has an error. See the View Detail Transactions page for more information.

Unknown Return Code: The return code sent by General Ledger could not be interpreted. See the Service Operation Monitor for more information on the return message.

Message Set, Number and Details

Displays a message that explains the status of the posting transaction. If there is a message set and number, click the Details link to view the associated message.

Transaction Details Tab

Select the Transaction Details tab.

Each posting that exceeds the maximum number of accounting lines, as specified for the target product, is separated into multiple segments. Each segment is sent as an individual message by the Integration Broker. Use this page to view the status and information related to the individual segments.

Process Parameters

Click to access the View Process Parameters page.

Message Log

Click to access the Process Message Log page.

Detail Transactions

Click to access the View Detail Transactions page.

Return Code Errors

If the return code on the View GL Transaction Status page is Account Number Mismatch or Inserting Error and no accounting lines were inserted into the Z1 staging table, follow this procedure:

  1. The finance office administrator locates and sends to the payroll office administrator the Enterprise process instance ID from the Transaction Number field on the Work With Store & Forward Journal Entries page.

  2. The payroll office administrator accesses the View GL Transaction Status page and searches for the affected process instance using the fields in the View Process Instance group box.

    Once the payroll office administrator locates the affected process instance, he or she should:

    1. Click the Transaction Details tab.

    2. Click Process Parameters.

    3. Note the affected calendar group ID from the View Process Parameters page.

  3. The payroll office administrator resets and reruns the general ledger processing for the calendar group ID.

Click to jump to top of pageClick to jump to parent topicViewing Log Information Generated for Each Segment

Access the View Detail Transactions page (click the Detail Transactions link on the View GL Transaction Status - Transaction Details tab).

Segment and Status

Displays the segment number and status for each segment.

Error Code

If an error occurred at the segment level, this field displays an error code identifying the problem.

Channel

Displays the queue on which the posting or rate request message was sent.

Pub ID (publication identifier)

Displays the publication identifier for the posting or rate request message.

Transaction Parameters

Click to view a summary of the segment information. You can also view the target system to which the posting was placed or from which the rates were retrieved.

IB Message Details

Click to open a new window displaying the Message Details page for the message instance of this segment.

Click to jump to top of pageClick to jump to parent topicResetting the Global Payroll Accounting Transactions

Access the Reset GL page (Global Payroll & Absence Mgmt, Time and Labor / GL Costs, Reset GL).

Note. Use this process only if it is necessary to repost the transactions because they were originally sent with errors. After resetting, correct the data errors and repeat GL processing.

Calendar Group ID

Select the calendar group for which you want to reset the GP GL interface processing. Resetting applies to the entire calendar group.

The remaining fields on the page are for information only; you cannot enter or alter the data.

Click to jump to parent topicHandling Data Errors in Batch Posting

This section provides an overview of data error handling and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Data Error Handling

This section discusses:

Data Error Possibilities

The following are some reasons that data error handling would be required:

Data Error Correction Procedures

When errors are discovered:

Errors in the payroll data that has been posted to general ledger can be handled in one of two ways:

Click to jump to top of pageClick to jump to parent topicIdentifying Data to be Purged and Reprocessed

If reprocessing of payroll data is required, the finance office administrators and payroll office administrators must communicate to identify the data to be reprocessed. This section discusses how to locate data to be purged or reprocessed:

Finance Office Initiates

If the data correction requirement is initiated in the finance office:

  1. The finance office administrator:

    1. Locates the Enterprise process instance ID from the Transaction Number field on the Work With Store & Forward Journal Entries page.

      The transaction number on this page is the Enterprise process instance ID.

      See PeopleSoft EnterpriseOne 8.11 Application Integrations with PeopleSoft Applications, "Using the PeopleSoft Payroll to PeopleSoft EnterpriseOne General Ledger Integration," Processing PeopleSoft Payroll Data in PeopleSoft EnterpriseOne General Ledger , Locating Payroll Batch Transactions in PeopleSoft EnterpriseOne

    2. Communicates the process instance ID number to the payroll office administrator.

  2. The payroll office administrator views the View GL Transaction Status page for the process instance to determine the affected calendar group ID.

Payroll Office Initiates

If the data correction requirement is initiated in the payroll office:

  1. The payroll office administrator:

    1. Views the View GL Transaction Status page to determine the process instance ID associated with the calendar group ID that requires reprocessing.

    2. Communicates the process instance ID number to the finance office administrator.

  2. The finance office administrator uses the process instance ID number to locate the payroll batch process transaction on the Work With Store & Forward Journal Entries page.

    The payroll process instance ID is the same as the transaction number in this page.

Click to jump to top of pageClick to jump to parent topicResetting and Reposting the Payroll Accounting Lines

If EnterpriseOne purges the batch of F0911Z1 records, the Enterprise payroll application administrator must be notified to reset the general ledger processing and repost the accounting lines.