NMnmbr
Earning Line Items

Create an earning line item

Changed on
post/earning_line_items

Request

  • Base URL
    https://sandbox.nmbr.co/services/payroll
  • Auth
    HTTP bearer

Request body

pay_stub_idstring required
business_preset_idstring
earning_type'bonus_discretionary' | 'bonus_non_discretionary' | 'bonus_non_taxable' | 'commission' | 'commission_periodic' | 'commission_self_employed' | 'death_benefit' | 'gift_cash' | 'gratuity' | 'in_lieu_wages' | 'income_replacement_indemnity_non_taxable' | 'income_replacement_indemnity_taxable' | 'invoice_payment' | 'invoice_sales_tax' | 'leave_bereavement' | 'leave_citizenship' | 'leave_domestic_and_sexual_violence' | 'leave_general' | 'leave_jury_duty' | 'leave_maternity' | 'leave_organ_donor' | 'leave_parental' | 'leave_paternity' | 'leave_personal' | 'leave_sick' | 'leave_sick_discretionary' | 'leave_unpaid' | 'leave_voting' | 'leave_wedding' | 'overtime' | 'parental_top_up_insurable' | 'parental_top_up_non_insurable' | 'pension' | 'retiring_allowance' | 'retiring_allowance_eligible' | 'retroactive_pay' | 'retroactive_pay_increase' | 'salary' | 'salary_continuance' | 'severance_pay' | 'statutory_holiday_pay' | 'supplemental_unemployment' | 'time_off_in_lieu' | 'time_off_in_lieu_overtime' | 'tips_allocated' | 'tips_controlled' | 'tips_direct' | 'vacation_accrual_adjustment' | 'vacation_pay' | 'vacation_pay_employee_terminated' | 'vacation_pay_no_time_taken' | 'vacation_pay_time_taken' | 'wage'

The type of earning for this line item.

Must be present when business_preset_id is either empty or not set.

pay_rate_idstring

On line items of type wage and overtime you may pass a pay_rate_id and hours to automatically calculate the amount.

overtime_rate_idstring

On line items of type overtime you may pass a overtime_rate_id and hours to automatically calculate the amount.

custom_amountnumber

An override for managed_amount. When set, amount reflects this value instead of managed_amount.

Up to 2 decimal places.

custom_hoursnumber

An override for managed_hours. When set, hours reflects this value instead of managed_hours. Can be used to prorate the dollar amount on salary line items.

Up to 2 decimal places.

custom_ratenumber

The hourly rate this line item is paid at when it isn't paid under a Pay Rate. managed_amount is calculated as hours x custom_rate, or with custom_rate_multiplier, hours x (custom_rate x custom_rate_multiplier, rounded to the cent), the same way a Pay Rate and Overtime Rate calculate it. The pay stub shows this rate (with its multiplier applied) in the rate column. A line item has either a Pay Rate (and optionally an Overtime Rate) or a custom_rate, not both.

Accepted on the earning types that accept a pay_rate_id and have an amount. Can't be sent with pay_rate_id or overtime_rate_id.

Up to 2 decimal places.

custom_rate_multipliernumber

A multiplier applied to custom_rate on overtime line items, such as 1.5. The pay stub shows it alongside the rate.

Accepted on overtime and time_off_in_lieu_overtime line items with a custom_rate.

Up to 3 decimal places.

accrued_vacation_paynumber

The vacation pay accrued on this line item, calculated based on the Work Assignment's Vacation Pay Settings.

Up to 2 decimal places.

titlestring nullable
expense_accounting_code_idstring
custom_expense_accounting_code_idstring
liability_accounting_code_idstring
custom_liability_accounting_code_idstring
custom_earned_onstring date
external_refstring

Response

Created

idstring

The unique identifier of the object in Nmbr.

objectstring

The type of the object in Nmbr ("earning_line_item").

Changes

  • 394112d11e70Revision changes
    • info

      added the new optional request property /

    • info

      added the new optional request property /

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 80c1694d9e87Revision changes
    • info

      added the new tips_allocated enum value to the request property /