Connection Info for POST

URL = https://<SPECTRUM-SERVER>:8482/employee/payrolltaximports

Authentication: Basic Authentication, Enhanced Authentication

Supported methods: POST

Supported formats: JSON

Sample JSON Body

{
	"employeePayrollTaxImports": [{
		"Company_Code": "2ND",
		"Employee_Code": "VS123",
		"Auto_Deposit_Allocation":"",
		"Bank_Account_Number":"",
		"Bank_Account_Type":"",
		"ABA_Number":"",
		"Auto_Deposit_Flag":"",
		"Auto_Deposit_Rate1":"",
		"Bank_Account_Number_2":"",
		"Bank_Account_Type_2":"",
		"ABA_Number_2":"",
		"Auto_Deposit_Flag_2":"",
		"Auto_Deposit_Rate2":"",
		"Bank_Account_Number_3":"",
		"Bank_Account_Type_3":"",
		"ABA_Number_3":"",
		"Auto_Deposit_Flag_3":"",
		"Auto_Deposit_Rate3":"",
		"Bank_Account_Number_4":"",
		"Bank_Account_Type_4":"",
		"ABA_Number_4":"",
		"Auto_Deposit_Flag_4":"",
		"Auto_Deposit_Rate4":"",
		"Bank_Account_Number_5":"",
		"Bank_Account_Type_5":"",
		"ABA_Number_5":"",
		"Auto_Deposit_Flag_5":"",
		"Auto_Deposit_Rate5":"",
		"Part_time_Casual_Flag":"",
		"Billing_Code":"A",
		"Special_Pay_Rate":"",
		"Special_Pay_Amount":"",
		"Misc_Allowance_Rate":"",
		"Prevail_Wage_Fringe_Rate":"",
		"Perm_wk_State_Tax_Code":"",
		"Subject_to_Perm_wk_State_Tax":"",
		"Subject_to_SDI_Perm_wk":"",
		"Subject_to_SUTA_Perm_wk":"",
		"Perm_wk_State_Filing_Status":"",
		"Perm_wk_State_Exemptions":"",
		"Perm_wk_State_Tax_Override":"10",
		"Perm_wk_State_Tax_Override_Cont":"P",
		"Res_County_Tax_Code":"BO",
		"Subject_to_Res_County_Tax":"",
		"Subject_to_FICA_Res_County":"",
		"Subject_to_FUTA_Res_County":"",
		"Res_County_Filing_Status":"",
		"Res_County_Exemptions":"",
		"Res_County_Tax_Override":"",
		"Res_County_Tax_Override_Cont":"",
		"Res_Local_Tax_Code":"WA",
		"Subject_to_Res_Local_Tax":"E",
		"Subject_to_FICA_Res_Local":"E",
		"Subject_to_FUTA_Res_Local":"E",
		"Res_Local_Filing_Status":"SINGLE",
		"Res_Local_Exemptions":"",
		"Res_Local_Tax_Override":"",
		"Res_Local_Tax_Override_Cont":"",
		"Permanent_Unemployment_State":"",
		"Permanent_SDI_State":"",
		"Apprentice_ID":"225",
		"Apprentice_Wage_Percent":"",
		"Summary_Post_Flag":"Y",
		"Suppress_Post_Flag":"Y",
		"Fed_Two_Jobs_Total": "Y",
		"Fed_Dep_Claimed_Annually": "",
		"Fed_Other_Annual_Income": "",
		"Fed_Other_Annual_Deductions": "",
		"Fed_Income_Tax_Override": "",
		"Fed_Income_Tax_Override_Cont": ""
	}]
}

Assumptions and Dependencies

• The Payroll module must be set up.
• The Employee code must exist in the defined Company code.
• The Change Employee - Payroll Tax Web Service updates an existing employee's information for the defined fields only.
• Any field that is left blank will not be updated in Spectrum.
• The service does not delete values that exist in Spectrum; it only changes data defined in the layout.
• The Auto deposit rates must equal 100% if the Auto Deposit Allocation Method is defined as Percent. Therefore if any changes are made, all accounts must be defined in the Employee-Payroll Tax Information Web Service.
• The Primary Account must be active (Y) if any other accounts have an active status. Therefore the Auto_Deposit_Flag field must be defined as Y in order for the other accounts to be updated.
• The Tax code must be unique between the Resident state, Perm work state, Resident county, and Resident local.
• The Permanent_Unemployment_State defined tax code is the permanent override for the Resident and Work State unemployment calculation.
  • The defined tax code can be the same as the Resident state, Perm work state, Resident county, or Resident local.
  • If it is defined, then the Permanently override resident and work state unemployment checkbox will be selected.
• The Permanent_SDI_State defined tax code is the permanent override for the Resident and Work State disability calculation.
  • If it is defined, then the Permanently override resident and work state disability insurance (SDI) checkbox will be selected.

Field Descriptions

Use the table below for reference when using this service.