EmployeePayrollAdvice

Return a pay advice report showing employee paycheque details

Date Released: June 2014 Date Updated: Jan 2022
URLSupports
/{cf_uri}/Report/Payroll/EmployeePayrollAdvice/ GET |  PUT |  POST |  DELETE
Please note: While accessibility via the API is available to both AccountRight and new Essentials files. Not all features will be displayed in Product for new Essentials

The elements list below details information for EmployeePayrollAdvice. To view the descriptions for the elements you can either hover any attribute to reveal details or click here to show all details inline.

Items shown with are required when posting or puting data
Items shown with are read-only elements

Attribute Details

  • Employer
  • The following set of information pulls through details for the employer
    • CompanyNameString (40)
    • Company name as entered within the Company Information window or Company endpoint.
    • ABNOrTFNString (14)
    • ABN or TFN as entered within the Company Information window or Company endpoint.
    • URIString
    • Uniform resource identifier associated with the company file.
  • Employee
  • The following set of information pulls through details for the employee contact
    • UIDGuid (36)
    • Foreign Key: Unique guid identifier belonging to the employee contact.
    • NameString (30)
    • Name of the employee.
    • DisplayIDString (15)
    • Employee contact Card ID, can also be used as a unique employee contact identifier.
    • URIString
    • Uniform resource identifier associated with the employee object.
  • PayPeriodStartDateDateTime
  • Starting date of the pay period, format YYYY-MM-DD HH:MM:SS { 'PayPeriodStartDate': '2014-06-21 00:00:00' }
  • PayPeriodEndDateDateTime
  • Finishing date of the pay period,, format YYYY-MM-DD HH:MM:SS { 'PayPeriodEndDate': '2014-06-28 00:00:00' }
  • PaymentDateDateTime
  • Date when the paycheque was processed and paid, format YYYY-MM-DD HH:MM:SS { 'PaymentDate': '2014-06-28 00:00:00' }
  • PayFrequencyString
  • Pay frequency can consist of the following:
    Weekly
    Fortnightly
    TwiceAMonth
    Monthly
  • AnnualSalaryDecimal (13.3)
  • Annual salary amount for the employee (at the time of the API call).
  • GrossPayDecimal (13.6)
  • Gross Wages for pay period (total amount of money before deductions) for the employee.
  • NetPayDecimal (13.6)
  • Net Wages for pay period (total amount of money after deductions) for the employee.
  • HourlyRateDecimal (13.4)
  • Employee's hourly rate.
  • ChequeNumberString (8)
  • Cheque number or reference type.
  • DateOfBirthDateTime
  • Employees date of birth, format YYYY-MM-DD HH:MM:SS { 'DateOfBirth': '1978-06-28 00:00:00' }
  • SuperannuationFund
  • The following set of information pulls through details for the superannuation fund
    • UIDGuid (36)
    • Foreign Key: Unique guid identifier belonging to the superannuation fund.
    • NameString (76)
    • Name of the superannuation fund.
    • URIString
    • Uniform resource identifier associated with the superannuation fund.
  • EmploymentClassification
  • The following set of information pulls through details for the employment classification
    • UIDGuid (36)
    • Foreign Key: Unique guid identifier belonging to the employment classification.
    • NameString (255)
    • Name of the employment classification.
    • URIString
    • Uniform resource identifier associated with the employment classification.
  • Lines []
  • An array of pay advice line information
    • PayrollCategory
    • The following set of information pulls through details for the payroll category
      • UIDGuid (36)
      • Foreign Key: Unique payroll category identifier in the form of a guid.
      • NameString (31)
      • Name of the payroll category.
      • TypeString
      • Indicates the type of payroll category i.e. Wage, Deduction, Expense, Tax.
      • URI String
      • Uniform resource identifier associated with the payroll category object.
    • HoursInteger
    • Number of hours paid on hourly payroll category or accrued for entitlements
      Note: If payroll category is of type salary then null is returned.
    • CalculationRateDecimal (13.6)
    • The rate an hourly wage category is calculated,
      Note: If wage is of type salary then null is returned.
    • AmountDecimal (13.6)
    • Amount processed for payroll category i.e. $ amounts for Wages, Superannuation, Deductions and Hours for entitlements.
    • YearToDateDecimal (13.2)
    • YTD amounts accrued this payroll year based upon pays recorded.


Paging: default page size is set to 400 with a maximum of 1000 results.

Example json GET response

  • {
  • "Employer" : {
    • "CompanyName" : "Clearwater Pty Ltd",
    • "ABNOrTFN" : "80 000 000 001",
    • "URI" : "{cf_uri}"
    • },
  • "Employee" : {
    • "UID" : "83f639d3-188f-4a76-a862-953f1c3b6a9e",
    • "Name" : "Peter Parker",
    • "DisplayID" : "EMP00003",
    • "URI" : "{cf_uri}/Contact/Employee/83f639d3-188f-4a76-a862-953f1c3b6a9e"
    • },
  • "PayPeriodStartDate" : "2014-06-21T00:00:00",
  • "PayPeriodEndDate" : "2014-06-28T00:00:00",
  • "PaymentDate" : "2014-06-07T00:00:00",
  • "PayFrequency" : "Weekly",
  • "AnnualSalary" : 40000.000,
  • "GrossPay" : 3076.920000,
  • "NetPay" : 2652.920000,
  • "HourlyRate" : 19.230800,
  • "ChequeNumber" : "29",
  • "DateOfBirth" : "1978-05-02T00:00:00",
  • "SuperannuationFund" : {
    • "UID" : "fb5a5df1-f0ab-4fcf-9a8f-a118424b1bec",
    • "Name" : "C+BUS - Construction and Building Union Superannuation",
    • "URI" : "{cf_uri}/Payroll/SuperannuationFund/fb5a5df1-f0ab-4fcf-9a8f-a118424b1bec"
    • },
  • "EmploymentClassification" : null,
  • "Lines" : [
    • {
    • "PayrollCategory" : {
      • "UID" : "e4c2d4bd-76f9-4655-9b0b-ae29a3a3093b",
      • "Name" : "Base Salary",
      • "Type" : "Wage",
      • "URI" : "{cf_uri}/Payroll/PayrollCategory/Wage/e4c2d4bd-76f9-4655-9b0b-ae29a3a3093b"
      • },
    • "Hours" : null,
    • "CalculationRate" : null,
    • "Amount" : 3076.920000,
    • "YearToDate" : 40307.65
    • },
  • {
  • "PayrollCategory" : {
    • "UID" : "3b53454f-0db9-422b-b9c3-71b5420307ac",
    • "Name" : "PAYG Withholding",
    • "Type" : "Tax",
    • "URI" : "{cf_uri}/Payroll/PayrollCategory/Tax/3b53454f-0db9-422b-b9c3-71b5420307ac"
    • },
  • "Hours" : null,
  • "CalculationRate" : null,
  • "Amount" : -424.000000,
  • "YearToDate" : -5749.00
  • },
  • {
  • "PayrollCategory" : {
    • "UID" : "470d9b21-b730-410d-b6f2-411a34a63bbc",
    • "Name" : "Holiday Leave Accrual",
    • "Type" : "Entitlement",
    • "URI" : "{cf_uri}/Payroll/PayrollCategory/Entitlement/470d9b21-b730-410d-b6f2-411a34a63bbc"
    • },
  • "Hours" : 12.308000,
  • "CalculationRate" : null,
  • "Amount" : null,
  • "YearToDate" : 147.08
  • },
  • {
  • "PayrollCategory" : {
    • "UID" : "da0b6499-fc03-44ae-b6e0-87106a4ea1cf",
    • "Name" : "Superannuation Guarantee",
    • "Type" : "Superannuation",
    • "URI" : "{cf_uri}/Payroll/PayrollCategory/Superannuation/da0b6499-fc03-44ae-b6e0-87106a4ea1cf"
    • },
  • "Hours" : null,
  • "CalculationRate" : null,
  • "Amount" : 276.920000,
  • "YearToDate" : 3714.81
  • }
  • ]
  • }
  • Hypermedia in the MYOB Business API

    The {cf_uri} is provided by the Company File endpoint.

    Read more about Hypermedia in the MYOB Business API in our best practice guide.