{"audience":"Compensation and benefits specialists, payroll teams and HR operations managers.","authorization_objects":[{"note":"Write authorization for infotype 0008 (personnel area, employee group)","object":"P_ORGIN"},{"note":"Prevents users from changing their own personnel record","object":"P_PERNR"}],"components":[],"countries":[],"effort_days_max":9,"effort_days_min":6,"effort_size":"M","faq":[{"a":"Yes. The start date can be in the past; payroll recalculates back to the earliest retroactive date in the control record. The program stops dates before this limit with a warning.","q":"Can a retroactive raise be uploaded?"},{"a":"Yes. A column pair per wage type is added to the file; the program updates the matching wage type lines in the 0008 record and carries the others over unchanged.","q":"Can several wage types (e.g. basic pay and a fixed allowance) be increased at once?"},{"a":"The program reads the file only during the run and does not store its content. In the log, amounts are shown only to users with write authorization for infotype 0008.","q":"Is the pay data in the raise file safe?"}],"features":[{"code":"test_run","label":"Test mode (check without posting)","note":""},{"code":"log","label":"Line-by-line result and error log","note":""},{"code":"error_file","label":"Download failed lines as a separate file","note":"Failed and held rows are downloaded as a separate file."},{"code":"excel","label":"Export to Excel","note":"An empty raise template can be downloaded as Excel."},{"code":"background","label":"Runs as a background job","note":""}],"functions":[{"name":"BAPI_EMPLOYEE_ENQUEUE","role":"Locks the personnel number before the update"},{"name":"HR_INFOTYPE_OPERATION","role":"Creates the new infotype 0008 record"},{"name":"BAPI_EMPLOYEE_DEQUEUE","role":"Releases the personnel number lock"}],"gap":"PA30 changes basic pay one employee at a time; PA70 fast entry has a limited field layout, does not calculate an increase percentage and does not compare old and new pay. The standard pay scale increase changes pay scale amounts but does not apply to individual (non-scale) pay. For individual raises done once or twice a year, keying hundreds of records takes time and carries an error risk.","id":"hcm-salary-increase-upload","industries":[],"input_columns":[{"derived":false,"label":"Personnel no.","required":true,"rule":"","target_field":"PERNR","target_table":"PA0008"},{"derived":false,"label":"Valid from","required":true,"rule":"","target_field":"BEGDA","target_table":"PA0008"},{"derived":false,"label":"Change reason","required":true,"rule":"","target_field":"PREAS","target_table":"PA0008"},{"derived":false,"label":"Pay scale group","required":false,"rule":"","target_field":"TRFGR","target_table":"PA0008"},{"derived":false,"label":"Pay scale level","required":false,"rule":"","target_field":"TRFST","target_table":"PA0008"},{"derived":false,"label":"Wage type","required":true,"rule":"","target_field":"LGA01","target_table":"PA0008"},{"derived":false,"label":"New amount","required":false,"rule":"","target_field":"BET01","target_table":"PA0008"},{"derived":true,"label":"Increase %","required":false,"rule":"Used when new amount is blank: new amount = old PA0008-BET01 × (1 + percentage ÷ 100)","target_field":null,"target_table":null},{"derived":false,"label":"Currency","required":false,"rule":"","target_field":"WAERS","target_table":"PA0008"}],"kind":"program","language":"en","lastmod":"2026-11-17","logic":"1. The file (XLSX or CSV) is read; each row is expected to hold personnel number, start date, change reason, wage type and either a new amount or an increase percentage.\n2. The employee's organizational assignment on the key date is read from PA0001 and the current basic pay record from PA0008; T511 is checked to confirm the wage type is allowed for the country grouping.\n3. When a percentage is given, new amount = old amount × (1 + percentage ÷ 100), rounded as selected. For pay scale employees the new pay scale group and level are checked in T510.\n4. When the increase percentage is outside the minimum and maximum limits on the selection screen, the row is held for approval and not written.\n5. The employee is locked with BAPI_EMPLOYEE_ENQUEUE; the new 0008 record is created with HR_INFOTYPE_OPERATION and the previous record is delimited automatically by the time constraint; then the lock is released with BAPI_EMPLOYEE_DEQUEUE.\n6. In test mode nothing is saved; old and new amount, percentage and check results are listed. Failed rows can be downloaded as a separate file.","module":"HCM","object_type":"upload","output_columns":[{"calculated":true,"formula":"Row number in the file","label":"Row","source_field":null,"source_table":null},{"calculated":false,"formula":"","label":"Personnel no.","source_field":"PERNR","source_table":"PA0008"},{"calculated":false,"formula":"","label":"Name","source_field":"ENAME","source_table":"PA0001"},{"calculated":false,"formula":"","label":"Valid from","source_field":"BEGDA","source_table":"PA0008"},{"calculated":true,"formula":"PA0008-BET01 valid before the increase date","label":"Old amount","source_field":null,"source_table":null},{"calculated":false,"formula":"","label":"New amount","source_field":"BET01","source_table":"PA0008"},{"calculated":true,"formula":"(New amount − old amount) ÷ old amount × 100","label":"Increase %","source_field":null,"source_table":null},{"calculated":true,"formula":"Saved, held for approval or error","label":"Status","source_field":null,"source_table":null},{"calculated":true,"formula":"Limit check result or return message from HR_INFOTYPE_OPERATION","label":"Message","source_field":null,"source_table":null}],"parameters":[{"example":"C:\\temp\\zam_2027_01.xlsx","kind":"parameter","label":"Raise file (XLSX or CSV)","name":"P_FILE","ref_field":"","required":true},{"example":"0","kind":"parameter","label":"Minimum increase percentage","name":"P_MINPCT","ref_field":"","required":false},{"example":"60","kind":"parameter","label":"Maximum increase percentage (above is held for approval)","name":"P_MAXPCT","ref_field":"","required":false},{"example":"10","kind":"parameter","label":"Rounding unit","name":"P_ROUND","ref_field":"","required":false},{"example":"X","kind":"checkbox","label":"Test mode (check without saving)","name":"P_TEST","ref_field":"","required":false}],"part_of":["hcm-salary-review-pay-equity-pack"],"performance":"Read PA0001 and PA0008 for all personnel numbers in the file in one query; call HR_INFOTYPE_OPERATION per row and always release the lock. A raise file with a few thousand rows is processed in minutes in the background.","quote_url":"https://nekuhub.com/en/request-a-quote/?report=hcm-salary-increase-upload","related":["hcm-additional-payment-upload","hcm-payroll-wage-type-period-variance"],"releases":[],"source":"custom","standard_alternatives":[{"note":"Changes basic pay employee by employee; no bulk upload and no increase check.","tcode":"PA30"},{"note":"Offers fast entry; does not calculate an increase percentage or compare old and new pay.","tcode":"PA70"}],"summary":"A custom upload program that loads periodic salary increases from an Excel file into infotype 0008 in bulk, accepts either a new amount or an increase percentage, compares old and new pay and stops increases outside limits. The existing record is delimited one day before the increase date and the new record is created with a change reason.","tables":[{"access":"write","join_on":"","role":"Basic pay: the old record is delimited, the new record is created","table":"PA0008","variant":"both"},{"access":"read","join_on":"PA0001-PERNR = PA0008-PERNR","role":"Organizational assignment and personnel area check","table":"PA0001","variant":"both"},{"access":"read","join_on":"T511-LGART = PA0008-LGA01","role":"Wage type allowed for the country grouping","table":"T511","variant":"both"},{"access":"read","join_on":"T510-TRFAR = PA0008-TRFAR AND T510-TRFGB = PA0008-TRFGB AND T510-TRFGR = PA0008-TRFGR AND T510-TRFST = PA0008-TRFST","role":"Pay scale group and level check","table":"T510","variant":"both"}],"title":"Mass Salary Increase Upload Program (Basic Pay, Infotype 0008)","url":"https://nekuhub.com/en/programs/mass-salary-increase-upload-basic-pay-infotype-0008/","vendor_id":"nekudos"}