PUT api/Deduction/{employeeNo}
Add a deduction to an Employee
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| employeeNo |
Employee Number |
string |
Required |
Body Parameters
In request Body: Employee deduction detail
DeductionDetail| Name | Description | Type | Additional information |
|---|---|---|---|
| RecordID | integer |
None. |
|
| PayElement |
Must not be archived |
string |
Required |
| StartDate | date |
Required |
|
| EndDate |
Must be before StartDate if present |
date |
None. |
| AnnualAmount |
AnnualAmount OR PeriodAmount is required |
decimal number |
None. |
| PeriodAmount |
AnnualAmount OR PeriodAmount is required |
decimal number |
None. |
| Balance |
The balance of the loan. |
decimal number |
None. |
| Applied |
Retrieve only. Indicates whether the deduction record has been stamped with a period. |
boolean |
None. |
Request Formats
application/json, text/json
Sample:
{
"RecordID": 1,
"PayElement": "sample string 2",
"StartDate": "2025-10-26T01:55:25.7093658+01:00",
"EndDate": "2025-10-26T01:55:25.7093658+01:00",
"AnnualAmount": 1.0,
"PeriodAmount": 1.0,
"Balance": 1.0,
"Applied": true
}
application/xml, text/xml
Sample:
<DeductionDetail xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/WebServicesRESTful.Models"> <AnnualAmount>1</AnnualAmount> <Applied>true</Applied> <Balance>1</Balance> <EndDate>2025-10-26T01:55:25.7093658+01:00</EndDate> <PayElement>sample string 2</PayElement> <PeriodAmount>1</PeriodAmount> <RecordID>1</RecordID> <StartDate>2025-10-26T01:55:25.7093658+01:00</StartDate> </DeductionDetail>
application/x-www-form-urlencoded
Sample:
Sample not available.
Response Information
Resource Description
Result
ResultWithMessage| Name | Description | Type | Additional information |
|---|---|---|---|
| result |
'OK', 'Error' |
string |
None. |
| message |
Returns if result is Error |
string |
None. |
| returnValue | string |
None. |
Response Formats
application/json, text/json
Sample:
{
"result": "OK"
}
{
"result": "Error",
"message": "Unable to save: the..."
}
application/xml, text/xml
Sample:
<ResultWithMessage>
<result>OK</result>
</ResultWithMessage>
<ResultWithMessage>
<result>Error</result>
<message>Unable to save: the...</message>
</ResultWithMessage>