Updates an existing employee benefit

Request

PUT https://api.yourpayroll.co.uk/api/v2/business/{businessId}/employee/{employeeId}/benefit

Path parameters

Parameter name Value Description Additional
businessId string Required
employeeId string Required

Request body

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

{
    "additionalAmountPayrolledToDateInPayRuns": "double",
    "additionalHasFinalisedPayRuns": "boolean",
    "additionalHasLinkedPayRuns": "boolean",
    "amountForegone": "double",
    "amountMadeGood": "double",
    "amountPayrolledToDate": "double",
    "amountPayrolledToDateInPayRuns": "double",
    "amountToBePayrolledPerPeriod": "double",
    "benefitCategoryId": "int32",
    "benefitCategoryName": "string",
    "benefitCategorySubType": "string",
    "benefitCategoryType": "string",
    "calculationLogs": [
        "string"
    ],
    "car": {
        "accessories": "double",
        "amountPaidByEmployeeForPrivateUse": "double",
        "availableFromDate": "date-time",
        "availableToDate": "date-time",
        "capitalContributions": "double",
        "employerProvidesFuelForPrivateUse": "boolean",
        "fuel": {
            "amountPayrolledToDate": "double",
            "amountToBePayrolledPerPeriod": "double",
            "availableFromDate": "date-time",
            "availableToDate": "date-time",
            "cashEquivalent": "double",
            "opraAmountForegone": "double",
            "proRataInFirstPayRun": "boolean",
            "reinstated": "boolean",
            "startFromPeriod": "int32"
        },
        "isShared": "boolean",
        "numberOfDaysUnavailable": "int32",
        "opraAmountForegone": "double",
        "sharedPercentage": "double"
    },
    "carryBenefitForward": "boolean",
    "cashEquivalent": "double",
    "dateCreatedUtc": "date-time",
    "employeeId": "int32",
    "employeeName": "string",
    "hasBeenSubmitted": "boolean",
    "hasFinalisedPayRuns": "boolean",
    "hasLinkedPayRuns": "boolean",
    "id": "int32",
    "loan": {
        "amountForegoneUserEntered": "double",
        "amountOutstandingAtEndOfYearOrLoan": "double",
        "amountOutstandingAtStartOfYearOrLoan": "double",
        "dateLoanWasDischargedIfThisYear": "date-time",
        "dateLoanWasMadeIfThisYear": "date-time",
        "interestDue": "double",
        "interestRate": "double",
        "maximumAmountOutstandingDuringTheYear": "double",
        "numberOfJointBorrowers": "int32"
    },
    "payrollingBenefit": "boolean",
    "proRataCalculation": {
        "endDate": "date-time",
        "fullYearAmount": "double",
        "proRataInFirstPayRun": "boolean",
        "startDate": "date-time",
        "useCalculatedValue": "boolean"
    },
    "startFromPeriod": "int32",
    "van": {
        "amountPaidByEmployeeForPrivateUse": "double",
        "availableFromDate": "date-time",
        "availableToDate": "date-time",
        "employerProvidesFuelForPrivateUse": "boolean",
        "fuel": {
            "amountForegone": "double",
            "amountPayrolledToDate": "double",
            "amountToBePayrolledPerPeriod": "double",
            "availableToDate": "date-time",
            "cashEquivalent": "double",
            "opraAmountForegone": "double",
            "proRataInFirstPayRun": "boolean",
            "startFromPeriod": "int32"
        },
        "isShared": "boolean",
        "numberOfDaysUnavailable": "int32",
        "opraAmountForegone": "double",
        "sharedPercentage": "double"
    },
    "year": "int32"
}

Properties

Name Type Description
additionalAmountPayrolledToDateInPayRuns double Nullable
additionalHasFinalisedPayRuns boolean Boolean
additionalHasLinkedPayRuns boolean Boolean
amountForegone double Decimal
amountMadeGood double Decimal
amountPayrolledToDate double Decimal
amountPayrolledToDateInPayRuns double Nullable
amountToBePayrolledPerPeriod double Decimal
benefitCategoryId int32 Nullable
benefitCategoryName string String
benefitCategorySubType string String
benefitCategoryType string String
calculationLogs[] array of string
car object UkEmployeeBenefitCategoryExtCarEditModel
car.accessories double Decimal
car.amountPaidByEmployeeForPrivateUse double Decimal
car.availableFromDate date-time DateTime
car.availableToDate date-time Nullable
car.capitalContributions double Decimal
car.employerProvidesFuelForPrivateUse boolean Boolean
car.fuel object UkEmployeeBenefitCategoryExtFuelEditModel
car.fuel.amountPayrolledToDate double Decimal
car.fuel.amountToBePayrolledPerPeriod double Decimal
car.fuel.availableFromDate date-time Nullable
car.fuel.availableToDate date-time Nullable
car.fuel.cashEquivalent double Decimal
car.fuel.opraAmountForegone double Nullable
car.fuel.proRataInFirstPayRun boolean Boolean
car.fuel.reinstated boolean Nullable
car.fuel.startFromPeriod int32 Int32
car.isShared boolean Boolean
car.numberOfDaysUnavailable int32 Nullable
car.opraAmountForegone double Nullable
car.sharedPercentage double Nullable
carryBenefitForward boolean Boolean
cashEquivalent double Decimal
dateCreatedUtc date-time DateTime
employeeId int32 Int32
employeeName string String
hasBeenSubmitted boolean Boolean
hasFinalisedPayRuns boolean Boolean
hasLinkedPayRuns boolean Boolean
id int32 Int32
loan object UkEmployeeBenefitCategoryExtLoanEditModel
loan.amountForegoneUserEntered double Nullable
loan.amountOutstandingAtEndOfYearOrLoan double Decimal
loan.amountOutstandingAtStartOfYearOrLoan double Decimal
loan.dateLoanWasDischargedIfThisYear date-time Nullable
loan.dateLoanWasMadeIfThisYear date-time Nullable
loan.interestDue double Decimal
loan.interestRate double Decimal
loan.maximumAmountOutstandingDuringTheYear double Decimal
loan.numberOfJointBorrowers int32 Nullable
payrollingBenefit boolean Boolean
proRataCalculation object UkEmployeeBenefitProRataCalculationModel
proRataCalculation.endDate date-time Nullable
proRataCalculation.fullYearAmount double Nullable
proRataCalculation.proRataInFirstPayRun boolean Boolean
proRataCalculation.startDate date-time DateTime
proRataCalculation.useCalculatedValue boolean Nullable
startFromPeriod int32 Int32
van object UkEmployeeBenefitCategoryExtVanEditModel
van.amountPaidByEmployeeForPrivateUse double Decimal
van.availableFromDate date-time DateTime
van.availableToDate date-time Nullable
van.employerProvidesFuelForPrivateUse boolean Boolean
van.fuel object UkEmployeeBenefitCategoryExtVanFuelEditModel
van.fuel.amountForegone double Decimal
van.fuel.amountPayrolledToDate double Decimal
van.fuel.amountToBePayrolledPerPeriod double Decimal
van.fuel.availableToDate date-time Nullable
van.fuel.cashEquivalent double Decimal
van.fuel.opraAmountForegone double Nullable
van.fuel.proRataInFirstPayRun boolean Boolean
van.fuel.startFromPeriod int32 Int32
van.isShared boolean Boolean
van.numberOfDaysUnavailable int32 Nullable
van.opraAmountForegone double Nullable
van.sharedPercentage double Nullable
year int32 Int32

Response

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

Status code Description Resource
200 OK

OK

UkEmployeeBenefitCategoryModel