SAP ABAP IMG Activity HRPAYUS_TCRT_NEGCHK (BAdI: Control Processing of Negative YTD Amounts in Table TCRT)
Hierarchy
☛ EA-HRCUS (Software Component) Sub component EA-HRCUS of EA-HR
   ⤷ PY-US (Application Component) USA
     ⤷ PAOC_PAY_US (Package) Add-On Development payroll USA
IMG Activity
ID HRPAYUS_TCRT_NEGCHK BAdI: Control Processing of Negative YTD Amounts in Table TCRT  
Transaction Code S_P7H_77000136   (empty) 
Created on 20070503    
Customizing Attributes HRPAYUS_TCRT_NEGCHK   BAdI: Control Processing of Negative YTD Amounts in Table TCRT 
Customizing Activity HRPAYUS_TCRT_NEGCHK   BAdI: Control Processing of Negative YTD Amounts in Table TCRT 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name HRPAYUS_TCRT_NEGCHK    

Use

Business Add-In HRPAYUS_TCRT_NEGCHK enables customers to control the manner in which the system logs - and ultimately processes - negative year-to-date (YTD) amounts in table TCRT. By implementing this optional BAdI, customers can define, for any wage type, whether and how the system will perform the default check in table TCRT for negative YTD amounts, which takes place in payroll function UTXCE of standard Concurrent Employment payroll schema U00C.

By extension, this Business Add-In also enables customers to suppress the system, at the wage type level, from issuing warnings or errors related to the standard negative YTD check. Customers therefore can ignore the negative YTD check completely, where desired, provided that the corresponding wage types are defined in method CHECK_TCRT_WAGETYPES.

Based on the business processes of your organization, you can implement this BAdI to permit the existence of negative YTD values in table TCRT for certain wage types. By implementing method CHECK_TCRT_WAGETYPES, you can determine whether or not the standard check of negative YTD amounts for wage types in table TCRT will result in a warning or error.

Requirements

Standard settings

The information explained below applies to all methods of interface IF_EX_HRPAYUS_TCRT_NEGCHK.

Activities

  1. Execute this step. On the subsequent screen, enter a name for the implementation you wish to create. (Alternatively, if you have already used this BAdI to create other implementations, a dialog box appears, displaying the implementations that have already been created.)
  2. Choose Create. (Or, alternatively, Edit. The remainder of the documentation for this activity describes the steps to be performed when you create a new implementation.)
  3. Enter a short text for the implementation in the Implementation name field, then choose Continue.
  4. On the subsequent screen, specify an Implementation short text, then choose the Interface tabstrip. The name of the implemented class fields are already found in this tabstrip.
  5. Save your entries and assign the implementation to a development class.
  6. Place the cursor on the method, then double-click to initiate method processing.
  7. Enter the code for the implementation between the statements method <Interface name> ~ <Name of method> and endmethod.
  8. Save and implement your code.
  9. Return to the Edit Implementation screen, then save your entries there.
  10. If you wish to activate the implementation you have created at a later date, then exit the Edit Implementation screen without activating the implementation. Otherwise, choose Activate from this screen to activate the implementation for immediate use.
  11. Once you have completed these activities, the source code that you stored in the method will be run when the associated application is executed.

Example

Suppose you erroneously overpaid an employee last December by means of a wage type that is configured to be taxable but not taxed. Upon discovering your error, you modify this payment and run a retroactive payroll run this January. The subsequent reduction in this payment causes a negative amount to be created this January in technical wage type /Q01 (TNTD Withholding Tax) of the results table (RT). This also causes a negative YTD amount to arise in table TCRT for technical wage type /Q01. Because of this negative YTD amount, the payroll run results in errors, and the system issues the following error message:

  • Negative YTD value for wage type /Q01, tax authority xxxx, tax company xxxx.

If you wish to prevent the system from issuing error messages in the future under comparable circumstances, implement method CHECK_TCRT_WAGETYPES in this BAdI to modify the system check for technical wage type /Q01. Using this method, you can instruct the system to issue a warning, rather than an error, when negative YTD amounts are identified for this wage type in table TCRT. Alternatively, you can suppress the check entirely for this wage type, meaning that the system will no longer issue errors or warnings when it encounters negative YTD amounts for technical wage type /Q01 in table TCRT.

Business Attributes
ASAP Roadmap ID 105   Define functions and processes 
Mandatory / Optional 2   Optional activity 
Critical / Non-Critical 2   Non-critical 
Country-Dependency I   Valid for countries specified 
Customizing Attributes Country Key Country Name
HRPAYUS_TCRT_NEGCHK US USA
Assigned Application Components
Documentation Object Class Documentation Object Name Current line number Application Component Application Component Name
SIMG HRPAYUS_TCRT_NEGCHK 0 HLA0003743 USA 
Maintenance Objects
Maintenance object type E   Business Add-In - Definition 
History
Last changed by/on SAP  20070503 
SAP Release Created in