Set Employee Opening Balance

Sets the opening balances for this employee.

Request

POST ../api/v1/client/employee/openingbalances/{identityCardNumber}

Path parameters

Parameter name
Value
Description
Additional

identityCardNumber

int32

Required

Request body

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

{
    "benefitsInKind": {
        "benefitsInKindItems": [
            {
                "amount": "double",
                "benefitsInKindType": "string",
                "description": "string",
                "taxExempt": "boolean"
            }
        ]
    },
    "employeeId": "int32",
    "employerLiabilities": [
        {
            "amount": "double",
            "employerLiabilityCategoryId": "int32",
            "name": "string"
        }
    ],
    "financialYearStartingYear": "int32",
    "grossEarnings": "double",
    "leaveBalances": [
        {
            "amount": "double",
            "leaveCategoryId": "int32",
            "name": "string",
            "unitType": "string"
        }
    ],
    "locationName": "string",
    "statutoryContributionsAndPcb": {
        "additionalEmployeeEpfAmount": "double",
        "additionalEmployerEpfAmount": "double",
        "cP38Amount": "double",
        "employeeEisAmount": "double",
        "employeeSocsoAmount": "double",
        "employerEisAmount": "double",
        "employerSocsoAmount": "double",
        "hrdfAmount": "double",
        "mandatoryEmployeeEpfAmount": "double",
        "mandatoryEmployerEpfAmount": "double",
        "pcbAmount": "double",
        "tp1ReliefAmount": "double",
        "tp1ZakatAmount": "double"
    },
    "taxReliefs": {
        "taxReliefTotal": "double",
        "taxReliefs": [
            {
                "amount": "double",
                "description": "string",
                "override": "boolean",
                "reliefNumber": "int32",
                "threshold": "double",
                "total": "double",
                "type": "string"
            }
        ],
        "taxYear": "int32"
    },
    "totalHours": "double"
}

Properties

Name
Type
Description

benefitsInKind

object

OpeningBalancesMyBenefitsInKindModel

benefitsInKind.benefitsInKindItems[]

array

benefitsInKind.benefitsInKindItems[].amount

double

Decimal

benefitsInKind.benefitsInKindItems[].benefitsInKindType

string

MyBenefitsInKindType

Possible values are:

  • MotorCar

  • PetrolWithoutCar

  • DriverProvided

  • HouseholdFurnishings

  • BenefitsOrGifts

  • MonthlyBills

  • OtherAssets

  • DentalBenefit

  • ChildcareBenefit

  • FoodAndDrink

  • FreeTransportation

  • ObligatoryInsurance

  • GroupInsurance

  • LeavePassage

  • BenefitsEmploymentDuties

  • DiscountsGoodsAndServices

  • BenefitsMonthlyBills

  • BenefitsMedicalTreatment

  • PetrolBenefits

  • Other

  • LivingAccommodation

benefitsInKind.benefitsInKindItems[].description

string

String

benefitsInKind.benefitsInKindItems[].taxExempt

boolean

Boolean

employeeId

int32

Nullable

employerLiabilities[]

array

employerLiabilities[].amount

double

Decimal

employerLiabilities[].employerLiabilityCategoryId

int32

Int32

employerLiabilities[].name

string

String

financialYearStartingYear

int32

Nullable

grossEarnings

double

Nullable

leaveBalances[]

array

leaveBalances[].amount

double

Decimal

leaveBalances[].leaveCategoryId

int32

Int32

leaveBalances[].name

string

String

leaveBalances[].unitType

string

LeaveUnitTypeEnum

Possible values are:

  • Hours

  • Days

  • Weeks

locationName

string

String

statutoryContributionsAndPcb

object

OpeningBalancesStatutoryContributionsModel

statutoryContributionsAndPcb.additionalEmployeeEpfAmount

double

Decimal

statutoryContributionsAndPcb.additionalEmployerEpfAmount

double

Decimal

statutoryContributionsAndPcb.cP38Amount

double

Decimal

statutoryContributionsAndPcb.employeeEisAmount

double

Decimal

statutoryContributionsAndPcb.employeeSocsoAmount

double

Decimal

statutoryContributionsAndPcb.employerEisAmount

double

Decimal

statutoryContributionsAndPcb.employerSocsoAmount

double

Decimal

statutoryContributionsAndPcb.hrdfAmount

double

Decimal

statutoryContributionsAndPcb.mandatoryEmployeeEpfAmount

double

Decimal

statutoryContributionsAndPcb.mandatoryEmployerEpfAmount

double

Decimal

statutoryContributionsAndPcb.pcbAmount

double

Decimal

statutoryContributionsAndPcb.tp1ReliefAmount

double

Decimal

statutoryContributionsAndPcb.tp1ZakatAmount

double

Decimal

taxReliefs

object

OpeningBalancesTaxReliefModel

taxReliefs.taxReliefTotal

double

Decimal

taxReliefs.taxReliefs[]

array

taxReliefs.taxReliefs[].amount

double

Decimal

taxReliefs.taxReliefs[].description

string

String

taxReliefs.taxReliefs[].override

boolean

Boolean

taxReliefs.taxReliefs[].reliefNumber

int32

Int32

taxReliefs.taxReliefs[].threshold

double

Decimal

taxReliefs.taxReliefs[].total

double

Decimal

taxReliefs.taxReliefs[].type

string

TaxReliefTypeEnum

Possible values are:

  • IndividualAndDependentRelatives

  • MedicalTreatment

  • BasicSupportingEquipment

  • DisabledIndividual

  • EducationFeesDegrees

  • MedicalExpenses

  • CompleteMedicalExamination

  • LifestyleExpenses

  • PurchaseOfBreastfeedingEquipment

  • ChildCareFees

  • NetDepositInSSPN

  • Spouse

  • DisabledHusbandWife

  • UnmarriedChildUnder18

  • UnmarriedChildOver18Education

  • UnmarriedChildOver18FullTimeEducation

  • DisabledChild

  • LifeInsuranceAndEPF

  • DeferredAnnuityAndPRS

  • EducationAndMedicalInsurance

  • ContributionToTheSOCSO

  • EmployeesProvidentFundOrApprovedScheme

  • DisabledChildOver18FullTimeEducation

  • HusbandWifePayment

  • PaymentCommissionerOfTourism

  • MedicalTreatmentOneMotherOnly

  • MedicalTreatmentOneFatherOnly

  • EducationFeesCourses

  • LifestyleExpensesB

  • VaccinationExpenses

  • LifestyleNotForBusinessUse

  • ElectricVehicleExpenditure

  • InterventionExpenditureForADHDAndGDDAndOtherLearningDisabilities

  • FullMedicalExaminationForParents

  • DentalExaminationAndTreatment

taxReliefs.taxYear

int32

Int32

totalHours

double

Nullable

Last updated