Sets the opening balances for this employee.

Request

POST https://apisg.yourpayroll.io/api/v2/business/{businessId}/employee/{employeeId}/openingbalances

Path parameters

Parameter name Value Description Additional
businessId string Required
employeeId string Required

Request body

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

{
    "clearanceTaxAmount": "double",
    "cpf": {
        "cpfEmployeeContributionAmount": "double",
        "cpfEmployerContributionAmount": "double",
        "employerVoluntaryCpfAmount": "double",
        "employerVoluntaryMediSaveAmount": "double"
    },
    "deductions": [
        {
            "amount": "double",
            "deductionCategoryId": "int32",
            "name": "string"
        }
    ],
    "earningsLines": [
        {
            "amount": "double",
            "isStandardPayCategory": "boolean",
            "name": "string",
            "payCategoryId": "int32",
            "payCategoryType": "string"
        }
    ],
    "employeeId": "int32",
    "employerLiabilities": [
        {
            "amount": "double",
            "employerLiabilityCategoryId": "int32",
            "name": "string"
        }
    ],
    "financialYearStartingYear": "int32",
    "grossEarnings": "double",
    "leaveBalances": [
        {
            "amount": "double",
            "leaveCategoryId": "int32",
            "name": "string",
            "unitType": "string"
        }
    ],
    "locationName": "string",
    "lumpSum": {
        "lumpSumPaymentModels": [
            {
                "name": "string",
                "payCategoryType": "string",
                "taxFreeComponent": "double",
                "taxWithheld": "double",
                "taxableComponent": "double"
            }
        ],
        "paymentBasis": "string",
        "paymentReason": "string",
        "serviceLength": "string"
    },
    "totalHours": "double",
    "withholdingTaxAmount": "double"
}

Properties

Name Type Description
clearanceTaxAmount double Nullable
cpf object OpeningBalanceCpfModel
cpf.cpfEmployeeContributionAmount double Nullable
cpf.cpfEmployerContributionAmount double Nullable
cpf.employerVoluntaryCpfAmount double Nullable
cpf.employerVoluntaryMediSaveAmount double Nullable
deductions[] array
deductions[].amount double Decimal
deductions[].deductionCategoryId int32 Int32
deductions[].name string String
earningsLines[] array
earningsLines[].amount double Decimal
earningsLines[].isStandardPayCategory boolean Boolean
earningsLines[].name string String
earningsLines[].payCategoryId int32 Int32
earningsLines[].payCategoryType string PayCategoryType

Possible values are:

  • Standard
  • LeaveLoading
  • GenuineRedundancyLeavePayment
  • OpeningBalanceAllowances
  • EtpTypeRTaxable
  • EtpTypeRTaxFree
  • EtpTypeOTaxable
  • EtpTypeOTaxFree
  • EtpLumpSumD
  • MethodB2AdditionalPaymentsOpeningBalance
  • StatutorySickPay
  • StatutoryMaternityPay
  • StatutoryAdoptionPay
  • StatutoryPaternityPay
  • StatutorySharedParentalPay
  • ExtraPay
  • RedundancyPayRetirementAllowance
  • GenuineRedundancyLeaveLoading
  • HolidayPay
  • TerminationHolidayPay
  • AccLevy
  • AverageEarnings
  • TerminationAverageEarnings
  • RelevantDailyPay
  • TerminationRelevantDailyPay
  • TerminationPublicHolidayPay
  • GST
  • KeepingInTouchDay
  • LumpSumGratuity
  • LumpSumNoticePay
  • LumpSumExGratiaPayment
  • LumpSumOther
  • CompensationForLossOfOffice
  • Pre93RetirementBenefits
  • Post93RetirementBenefits
  • RestDayEmployerRequested
  • RestDayEmployeeRequested
  • PublicHoliday
  • EtpSuperableTypeOTaxable
  • EtpSuperableTypeOTaxFree
  • EtpTypeOUnusedLeavePayment
  • StatutoryParentalBereavementPay
  • UKPensionDeathBenefit
  • JobKeeperStart
  • JobKeeperFinish
  • JobKeeperTopUp
  • RestDay
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
lumpSum object OpeningBalancesLumpSumModel
lumpSum.lumpSumPaymentModels[] array
lumpSum.lumpSumPaymentModels[].name string String
lumpSum.lumpSumPaymentModels[].payCategoryType string PayCategoryType

Possible values are:

  • Standard
  • LeaveLoading
  • GenuineRedundancyLeavePayment
  • OpeningBalanceAllowances
  • EtpTypeRTaxable
  • EtpTypeRTaxFree
  • EtpTypeOTaxable
  • EtpTypeOTaxFree
  • EtpLumpSumD
  • MethodB2AdditionalPaymentsOpeningBalance
  • StatutorySickPay
  • StatutoryMaternityPay
  • StatutoryAdoptionPay
  • StatutoryPaternityPay
  • StatutorySharedParentalPay
  • ExtraPay
  • RedundancyPayRetirementAllowance
  • GenuineRedundancyLeaveLoading
  • HolidayPay
  • TerminationHolidayPay
  • AccLevy
  • AverageEarnings
  • TerminationAverageEarnings
  • RelevantDailyPay
  • TerminationRelevantDailyPay
  • TerminationPublicHolidayPay
  • GST
  • KeepingInTouchDay
  • LumpSumGratuity
  • LumpSumNoticePay
  • LumpSumExGratiaPayment
  • LumpSumOther
  • CompensationForLossOfOffice
  • Pre93RetirementBenefits
  • Post93RetirementBenefits
  • RestDayEmployerRequested
  • RestDayEmployeeRequested
  • PublicHoliday
  • EtpSuperableTypeOTaxable
  • EtpSuperableTypeOTaxFree
  • EtpTypeOUnusedLeavePayment
  • StatutoryParentalBereavementPay
  • UKPensionDeathBenefit
  • JobKeeperStart
  • JobKeeperFinish
  • JobKeeperTopUp
  • RestDay
lumpSum.lumpSumPaymentModels[].taxFreeComponent double Nullable
lumpSum.lumpSumPaymentModels[].taxWithheld double Nullable
lumpSum.lumpSumPaymentModels[].taxableComponent double Nullable
lumpSum.paymentBasis string String
lumpSum.paymentReason string String
lumpSum.serviceLength string String
totalHours double Nullable
withholdingTaxAmount double Nullable

Response

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

Status code Description Resource
200 OK

OK