Creates a new recurring deduction for the employee.



Path parameters

Parameter name Value Description Additional
businessId string Required
employeeId string Required

Request body

The request body takes a complete EmployeeRecurringDeductionModel resource, containing the following writable properties:

    "additionalData": "int32",
    "amount": "double",
    "carryForwardAmount": "double",
    "carryForwardUnpaidDeductions": "boolean",
    "deductionCategoryId": "int32",
    "deductionType": "string",
    "employeeId": "int32",
    "expiryDate": "date-time",
    "externalReferenceId": "string",
    "fromDate": "date-time",
    "id": "int32",
    "isActive": "boolean",
    "maximumAmountPaid": "double",
    "name": "string",
    "notes": "string",
    "paidTo": "string",
    "paidToAccountId": "int32",
    "paymentReference": "string",
    "preservedEarnings": "string",
    "preservedEarningsAmount": "double",
    "preservedEarningsAmountNotReachedAction": "string",
    "totalAmountPaid": "double"


Name Type Description
additionalData int32 Nullable
amount double Decimal
carryForwardAmount double Decimal
carryForwardUnpaidDeductions boolean Boolean
deductionCategoryId int32 Int32
deductionType string DeductionTypeEnum

Possible values are:

  • NotSet
  • Fixed
  • PercentageGross
  • PercentageOTE
  • PercentageStudentLoan
employeeId int32 Int32
expiryDate date-time Nullable
externalReferenceId string String
fromDate date-time DateTime
id int32 Nullable
isActive boolean Boolean
maximumAmountPaid double Nullable
name string String
notes string String
paidTo string EmployeeRecurringDeductionPaidToEnum

Possible values are:

  • Manual
  • BankAccount
  • SuperFund
  • Bpay
paidToAccountId int32 Int32
paymentReference string String
preservedEarnings string PreservedEarningsCalculationTypeEnum

Possible values are:

  • Never
  • Amount
  • Percentage
preservedEarningsAmount double Decimal
preservedEarningsAmountNotReachedAction string DeductionAmountNotReachedEnum

Possible values are:

  • DoNotPay
  • PayToLimit
totalAmountPaid double Decimal


The following HTTP status codes may be returned, optionally with a response resource.

Status code Description Resource
200 OK