Escolar Documentos
Profissional Documentos
Cultura Documentos
E C E M B E R
1999
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
1996 by PeopleSoft, Inc. All rights reserved. Published 1996. Printed on Recycled Paper..
Restricted Rights The information contained in this document is proprietary and confidential to PeopleSoft, Inc. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose without the express written permission of PeopleSoft, Inc. This document is subject to change without notice, and PeopleSoft does not warrant that the material contained in this document is error-free. If you find any problems with this document, please report them to PeopleSoft in writing. PeopleSoft, the PeopleSoft logo, PeopleTools, PS/nVision, PeopleCode, PeopleBooks, and Red Pepper are registered trademarks, and PeopleTalk and "Applications for eBusiness" are trademarks of PeopleSoft, Inc. All other company and product names may be trademarks of their respective owners. The information contained herein is subject to change without notice. Copyright 1999 PeopleSoft, Inc. All rights reserved.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Table of Contents
............................................................................................................................................................1 Troubleshooting Errors in the Payroll Process..................................................................................1 .....................................................................................................................................................2 ...........................................................................................................................................................2 Table of Contents...............................................................................................................................3 Introduction........................................................................................................................................4 SQR Audit Programs for Payroll.......................................................................................................5 PAY034: Database Audit Prior to Paysheet...............................................................................5 PAY035: Paysheet Records Audit Prior to Calcpay...................................................................5 PAY036: Paysheet Records Audit Prior to Confirm..................................................................6 Common Errors..................................................................................................................................7 PAY_LINE_STATUS Values....................................................................................................8 Common Errors: Error 20..................................................................................................................9 Causes.........................................................................................................................................9 Locate and Resolve Problem.....................................................................................................11 Points to Remember..................................................................................................................13 Common Errors: Error 64................................................................................................................14 Causes.......................................................................................................................................14 Locate the Problem...................................................................................................................15 Resolve Problem.......................................................................................................................15 Common Errors: INSERT_BALANCE ..........................................................................................17 Causes.......................................................................................................................................17 Locate the Problem...................................................................................................................17 Resolve the Problem.................................................................................................................18 Common Errors: Out of Sequence Errors........................................................................................19 Cause.........................................................................................................................................19 Understanding the Error Message.............................................................................................19 Locate the Problem...................................................................................................................19 Resolve the Problem.................................................................................................................21 Workaround for Priority Situations .................................................................................................22 Unconfirm Process - Addressing Last-Minute Changes..................................................................23 Summary..........................................................................................................................................23
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
Introduction
This paper covers four errors that are commonly encountered in the Payroll process, including the causes of each error and suggestions for resolving them. The Payroll process consists of three main processes, as shown below:
This paper will discuss the following errors, many of which occur in the first two steps of the payroll process. They all prevent the confirm process from completing successfully: Payroll Error 20: All Checks Not Calculated Payroll Error 64: Prior Run Not Confirmed INSERT_BALANCE Error Out of Sequence Error
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
successfully. It is important to address those orphaned records early in the process so they don't cause a delay during Pay Confirmation.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Common Errors
This paper discusses four specific Payroll errors. In many cases, we provide different options for finding and/or fixing the errors. We provide an SQR Audit program and one or more queries for most errors. Many of these errors appear during the Pay Confirmation process, but actually occur earlier in the cycleduring Pay Calculation, for example. The system notifies you about some of these errors by providing a DOS box that reports an error. The DOS box displays the following text: "CHECK MESSAGES!!". But it doesnt give any information about the error and it doesn't force you to fix it immediately. The error details can be viewed on the Payroll Error Messages panel. Note: If you are running this process on the server, you will not see the CHECK MESSAGES!! DOS box. You will have to view the Payroll Error Messages panel directly to view the errors. We recommend that you prevent errors whenever possible by running SQR audit programs to identify problems before they occur.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
PAY_LINE_STATUS Values
PAY_LINE_STATUS tracks the status of an employee record throughout the Payroll process. Any record marked "OK to Pay" will have its Status value changed to either "C" (successful calculation) or "E" (errors found during calculation) when the pay calculation process is run. After Pay Confirmation completes successfully, it will be set to F. Employee records that have not been calculated successfully will have a status of I, P, U, or E. See Table 1 for a description of each value. Table 1 Stat us Valu e I Meaning Description
Initial load
The pay earnings have been entered but not calculated. A record marked Not OK to Pay" will remain with an 'I' status until it is eventually deleted during the Pay Confirmation process. To address employee records with an "I" status, recalculate the pay run, then move on to Pay Confirmation The Pay Calculation process sets the status to 'P' when the record is selected for the calculation processing. When processing for this record is completed normally (either successfully calculated or errors identified and reported), then the Status after Pay Calculation ends will always be either "C" or "E." However, if something happens during Pay Calculation that prevents the program from completing normally (i.e., something went significantly wrong that normal error routines couldn't handle), then occasionally some rows may remain in "P" status until they are recalculated. To address employee records with a "P" status, recalculate the pay run, then move on to Pay Confirmation The record has been updated online by a user since it was originally entered, or since it was calculated during a previous Pay Calculation run. This status is set by PeopleCode in the online panels. It may also be set by an interface that loads data from a time and attendance into the Payroll tables. To address employee records with a "U" status, recalculate the pay run, then move on to Pay Confirmation An error occurred during processing for these Earnings. If pay calculation identified a problem in the data for which there is a defined standard payroll error message, then the error message will appear on the Payroll Error Messages panel. Otherwise, the error will be displayed on the screen where the process was executed, or in the Log file created during this Pay calculation run. All PAY_EARNINGS records for this pay run that have a
Updated by operator
Error
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
status of "E" must either be corrected or else marked "Not OK To Pay" before the calculation process will complete successfully. Recalculate until all the employees with "E" status turn to C status, then move on to Pay Confirmation. V Reversed check Calculated successfully Confirmed This status tells the system not to recalculate the adjustment check. This prevents different deductions from being taken in the Pay Calculation process. Pay Calculation processing for this record was completed normally and no errors were found. Set by the Confirmation process to indicate successful completion of Pay Confirmation processing
C F
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
The system will allow you to begin the Pay Confirmation process even if you have outstanding errors from Pay Calculation. However, the system will not allow Pay Confirmation to complete successfully until you resolve the problems revealed in Pay Calculation. You can prevent this error by running PAY034 before Pay Calculation.
10
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Locate and Resolve Problem: Option 1Proactive We recommend running PAY034 before creating the paysheets to resolve high-level and employee-level errors. If you don't run it before creating the paysheets, run it prior to Pay Calculation The PAY034 SQR audit program will list exactly what is wrong with each problem row. Fix the data as directed in the report, then run Pay Calculation again to calculate the rows that were in error. Choose "Calculate Where Needed" if you encounter employee-level errors. If you encounter high-level errors, choose "Recalculate All." Pay Confirmation should run successfully once the problems described in PAY034 are fixed. If you run PAY034 and fix the errors before the Pay Calculation process, you will prevent having employees with a PAY_LINE_STATUS of E and you wont see CHECK MESSAGES!! DOS boxes. If you choose note to run PAY034, you may or may not see CHECK MESSAGES!! error prompts. However, the problem rows on PAY_LINE_STATUS will still be set to E..
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
11
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
Locate and Resolve Problem: Option 2Reactive If you choose not to run PAY 034, you can run the query below to query PS_PAY_EARNINGS directly to look for errors. It returns all employees with a PAY_LINE_STATUS of I, U, P, or E.":
SELECT * FROM PS_PAY_EARNINGS WHERE COMPANY = (company) AND PAYGROUP = (paygroup) AND PAY_END_DT = (pay end date) AND OK_TO_PAY = Y AND PAY_LINE_STATUS IN ( I , U, P, E)
The query above locates employee-level errors. It doesnt spell out exactly why the employees have a problem or how to fix the problems, as PAY034 does. You must figure out how to fix each problem on your own. Once the problems are fixed, continue by the running Pay Calculation and Confirmation processes again.
Locate and Resolve Problem: Option 3 -Reactive Use this option to reveal errors that were generated during Pay Calculation but were not taken care of. You should always check the Inquire Payroll Error Messages panel after Pay Calculation. If you do so, and fix the problems revealed by the error right away, you wont have to force the error. If you have employees with a PAY_LINE_STATUS of "E," and dont find an error in the Inquire Payroll Error Messages panel, you can force an error by using SQL to change the PAY_LINE_STATUS from E to U," then running the Pay Calculation process again with the "Where Needed" option selected. A "U" value in PAY_LINE_STATUS tells Pay Calculation that this PAY_EARNINGS record has been manually updated so it should be selected for (re)calculation when Pay Calculation is run next. Because the problem causing the error has not been fixed, the problem employees will produce a "CHECK MESSAGES!!" DOS box along with messages in the Error Messages panel. Once the problem employees have been revealed by forcing the error, you'll need to do some research to figure out why those employees are in "E" status. You can do this in three ways: 1. 2. 3. Review the Inquire Payroll Error Messages panel Run PAY011 to show errors that normally appear on the Inquire Payroll Messages panel Query the PAY_MESSAGES table directly
After you fix the problem data, recalculate where needed, check again for error messages, then run Pay Confirmation once more.
12
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Points to Remember
When this error occurs, it means that something went wrong in the Calculate Pay process that prevented the records from being set to the correct PAY_LINE status. The system will allow you to begin the Pay Confirmation process even if you have outstanding errors from Pay Calculation. However, the system will not allow Pay Confirmation to complete successfully until you resolve the problems revealed in Pay Calculation. Remember, if an employee received a high level error and you choose not fix it before running the next Pay Calculation for this cycle, the high level error may not be reflected in the Inquire Payroll Error Messages panel.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
13
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
On-cycle Adjustment Calendars If an on-cycle calendar has been set up to process adjustments, you will receive an error 64 when you run Pay Confirmation for the following payroll. This is because when off-cycle adjustments are processed, the on-cycle confirm flags (Confirmation Start and Confirmation Run) will not be checked on the calendar. They will never be checked because you are not running an on-cycle payroll against this calendar. For example, let's say that an on-cycle adjustment calendar has been set up to process adjustments to the December payroll. Then you run an adjustment against the December on-cycle calendar to correct employee balances. When trying to confirm the January payroll, you'll receive error 64 because the adjustments from December were not flagged as confirmed on the pay calendar.
Off-cycle and Online Checks Timing is critical when processing off-cycle and online checks. If an Off-cycle payroll has not been completed before processing the on-cycle payroll for that pay period, you will receive an error 64. For example, suppose the November on-cycle payroll has been calculated and confirmed. Then you add an off-cycle paysheet, which has been calculated but not confirmed, on the November calendar. When running the December on-cycle payroll, you will receive error 64 because the November off-cycle run has not completed. If you fully complete each Off-cycle payroll (including calculation and confirmation) in a timely manner, you can prevent error 64. As a rule of thumb, don't allow any further Offcycle paysheets to be started until the on-cycle payroll run has fully completed. When the Pay Period on-cycle payroll run is ready to complete processing, run a FINAL "Re-Calculate All" and then run Pay Confirmation. You cannot start any other pay run processing until this on-cycle payroll run has completely finished. Following these guidelines for processing offcycle payroll runs will prevent virtually all of the Pay Confirmation errors, such as error 64.
14
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Rows where the field Pay_Confirm_Run = "N" (No) indicate an on-cycle run that must be confirmed before proceeding. Rows where the field Pay_Off_Cycle = "Y" (Yes) indicate an offcycle run that must be Confirmed before proceeding. You can also remove other criteria, such as paygroup, pay end date, and Run ID, to do a more global search for the calendar with the criteria.
Resolve Problem
We recommend several options to resolve error 64, depending on whether or not your Payroll system is in production. For further detail about resolving this error, refer to resolution 11652 on Customer Connection (www4.peoplesoft.com).
Resolve Problem in Production On-cycle Adjustment Calendar Not Confirmed If you are receiving error 64 because an on-cycle adjustment calendar has not been confirmed, delete the Run ID from the adjustment calendar. This will remove the link between the on-cycle pay calendar and the adjustment paysheet. The system will ignore the empty Confirmation Start and Confirmation Run flags on the calendar and will allow the payroll to continue processing. The fields are not updated for adjustments, so the system would never recognize the adjustment as being confirmed without removing the Run ID.
Outstanding Off-cycle and Online Checks If outstanding off-cycle or online checks are causing the error, choose the appropriate option below to resolve the problem.
Option 1 Calculate and Confirm outstanding paysheets. Finish processing the off-cycle payroll by running a FINAL "Re-Calculate All" and then run Pay Confirmation before continuing with the on-cycle run. Remember, other on-cycle pay run processing can only start after an earlier off-cycle run has completely finished.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
15
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
Option 2 Remove off-cycle outstanding flag if paysheet no longer exists. If you have unsheeted or deleted a paysheet, the flag is not removed on the calendar, so the system still thinks there are outstanding off-cycle checks.
Resolve the Problem Outside of Production If you are not in a Production environment (you may be testing before implementation, for example), you may choose one of the options below. These options may have drastic effects on data, so we dont recommend that you do these in a Production environment. If an on-cycle adjustment calendar has not been confirmed, we suggest using SQL to turn on the confirm flags. You should do this outside of production because its risky to update flags via SQL. If outstanding off-cycle and online checks are causing the error, we recommend that you unsheet the paysheets. This will delete all of the information on the paysheet, including any data brought over from an interface.
16
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
We suggest two choices for locating the problem paysheets: Run SQR audit PAY036 (recommended) Query PS_CHECK_YTD table
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
17
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
Option 1 - Proactive (Recommended) We recommend that you run the PAY036 audit SQR before running the Pay Confirmation process to locate the future-dated balances (duplicate keys). PAY036 provides the information needed to fix the problem paysheets.
Option 2 - Reactive (PeopleSoft 7.5) If you choose not to run the recommended SQR audit program, you can query PS_CHECK_YTD to determine if future-dated balance records exist. First, review the pay calendar you are trying to confirm and note the BALANCE_RECORD. Then run this query:
SELECT * FROM PS_CHECK_YTD WHERE EMPLID = '(employee's ID)' AND COMPANY = (employees company) ORDER BY BALANCE_YEAR, BALANCE_QTR, BALANCE_PERIOD
Review output from the above SQL query, and determine if there is a balance record for a BALANCE_PERIOD greater than the BALANCE_PERIOD in the pay calendar you are processing. If so, you are trying to post to a previous month. The query varies slightly, depending on which version of PeopleSoft the you are using. The example above is for PeopleSoft 7.5x.
Recalculate where needed, then run Pay Confirmation again. For further detail about resolving this error, refer to resolution 5110 on Customer Connection (www4.peoplesoft.com).
18 PEOPLESOFT PROPRIETARY CONFIDENTIAL
AND
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Interpretation:
Check = page#0019, l i ne#02, separate check#0 S- chk = page#0019, l i ne#01, separate check#0
Be sure to note these numbers whenever you receive this error so you can use them to locate the problem paysheet with the upcoming query. The employee causing the problem is often not the actual employee printed on error messages. Check the paysheet listed in the error message. Also check the paysheet that came before the one listed in the error.
We suggest two options for locating the problem paysheets: Run SQR audit program PAY035 (recommended) Query PS_PAY_EARNINGS, PS_PAY_LINE and PS_PAY_OTH_EARNS tables.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
19
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
Option 1 - Proactive Run PAY035 prior to the Pay Calculation process to identify orphaned records and mark them Not OK to Pay."
Option 2 - Reactive For each paysheet noted in the error message, query the tables below using the values contained in both check and s-chk notes. The error can return multiple lines for one employee. Make sure to run the three queries below for each line. Query 1
SELECT * FROM PS_PAY_EARNINGS WHERE PAGE # = ? AND LINE # = ?
Query 2
SELECT * FROM PS_PAY_LINE WHERE PAGE # = ?' AND LINE # = ?
Query 3
SELECT * FROM PS_PAY_OTH_EARNS WHERE PAGE # = ? AND LINE # = ?
The queries should produce 0 results. Note that PS_PAY_EARNINGS is a parent to both PS_PAY_LINE and PS_PAY_OTH_EARNS. If only the PS_PAY_LINE or PS_PAY_OTH_EARNS query returns rows, delete the rows (they are orphaned records). If PS_PAY_EARNINGS returns data, then you are facing a different issue.
20
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Run PAY035 (PreCalc) again to make sure there arent any other problems. Then recalculate where needed. Continue by removing the Confirmation Start flag from the pay calendar, and running the Pay Confirmation process again. Remember to process off-cycle checks for employees who were affected by the orphaned records. For further detail about this error, refer to resolution 11020 on Customer Connection (www4.peoplesoft.com).
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
21
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
NOVEMBER 1999
22
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
NOVEMBER 1999
TROUBLESHOOTING ERRORS
IN THE
PAYROLL PROCESS
Restore BackupRecommended We recommend that you back up your database prior to running Pay Confirmation for each pay cycle. That way, you can just restore it if you need to make major changes to the pay run.
Run Unconfirm If you choose not to restore a backup copy of the database, you can run the Unconfirm process. This process should only be run when you encounter a huge problem that affects the majority of a pay group. Test the process in your DEMO environment first so you know how it behaves. For more information on running the Unconfirm process, see resolution 23255 on Customer Connection.
Completing the Process After starting fresh with either a restored backup or running unconfirm, make necessary changes to the data, review the check numbers on the PS_FORMS table, then run Pay Calculation in "Calculate All' mode before running Pay Confirmation once more.
Summary
The main purpose of this paper is to help prevent errors during the Pay Confirmation process so you can process your payrolls smoothly. We hope that the tips provided here will enable you to understand what causes common payroll errors, and give you some techniques for resolving those errors. If you do need to contact GSC, you will have a clear understanding of the problem to help expedite the resolution.
PEOPLESOFT PROPRIETARY
AND
CONFIDENTIAL
23