Acumatica API - Endpoint Default 24 200 001 icon

Acumatica API - Endpoint Default 24 200 001

Interact with Acumatica Endpoint Default/24.200.001

Actions478

Employee Payroll Settings → Insert/Update

AI-generated

Summary

Insert or update employee payroll settings in Acumatica by providing detailed payroll-related information for an employee, including address, compensation, deductions, benefits, direct deposit, employment records, tax settings, and other payroll attributes.

Inputs

  • Address Info — Provide the employee's address details including lines 1 and 2, city, state, country, postal code, and whether the address is validated.
  • Compensation — Specify one or more compensation items with details like earning code, description, pay rate, pay unit, active status, and applicable dates.
  • Deductions And Benefits — Define deductions and benefits configuration, such as using class defaults, detailed items for deductions and benefits including amounts, percentages, active status, and garnishment details.
  • Deduction Split Method — Set the method used to split deductions.
  • Max Perc Of Net Pay For All Garnishm — Set the maximum percentage of net pay allowed for all garnishments.
  • Direct Deposit Details — List one or more direct deposit accounts with account number, type, bank details, deposit sequence, amounts, and remainder flag.
  • Employment Dates — Specify hire date and termination date of the employee's employment.
  • Employment Records — Provide one or more employment records including position, start/end dates, active status, termination details, rehire eligibility, and final payment info.
  • General Info — Set general payroll-related info such as calendars, unions, exemptions, net pay minimums, working hours and weeks per year, and pay groups with options to use class defaults.
  • GL Accounts — Configure general ledger accounts related to benefits, deductions, earnings, PTO, and taxes with account and sub-account identifiers.
  • Paid Time Off — Define paid time off details including accrual methods, balances, limits, descriptions, and settings to use custom configurations.
  • Taxes — Specify multiple tax entries with active status, tax codes, descriptions, last modified dates, and detailed tax code settings.
  • Tax Settings — Provide tax-related settings with names, required flags, state-specific information, usage flags for government reporting or tax calculation, and other metadata.
  • Work Locations — Set work location details including use of class defaults, payroll project work locations, and multiple work location entries with IDs and names.
  • Additional Fields — Include other optional payroll fields such as active status, cash account, class ID, employee ID and name, employee type, payment method, and related class defaults.

Output shape

The updated or inserted Employee Payroll Settings record as a JSON object.

The operation either creates a new employee payroll settings entry or updates an existing one based on provided parameters. All fields are optional inputs; only specified fields are updated. The output reflects the current saved state after completion. No internal pagination or error envelope details are provided here.

Links

Discussion