Академический Документы
Профессиональный Документы
Культура Документы
DEVELOPERS
APRIL 2019
UNCLASSIFIED
FORMAT AUDIENCE DATE CLASSIFICATION
JobKeeper Payment
Coronavirus economic response package – JobKeeper Payment
version 1.0.2
This report is in a Comma separated values (CSV) format and will allow reporters to receive
and lodge JobKeeper payment files.
UNCLASSIFIED PAGE 2 OF 19
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
VERSION CONTROL
ACRONYMS
Acronym Expanded
ABN Australian Business Number
ATO Australian Taxation Office
BMS Business Management Software
TFN Tax File Number
DEFINITIONS
Term Description
BMS ID A unique identifier within the business that acts like a serial number to
identify which instance of the business payroll software created the data in
the pay event.
Payer / For the purposes of this document, an employer is the employer who will
Employer receiving the payment for each eligible employee (Payee)
Payee / For the purposes of this document, a payee is defined as a person who
Employee receives or is to receive a payment.
UNCLASSIFIED III
GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
TABLE OF CONTENTS
1 Introduction.............................................................................................................................. 1
1.1 Who should use this Guide...........................................................................................1
1.2 Receiving Via the internet.............................................................................................2
1.3 Using the Business Portal.............................................................................................3
1.4 Privacy.......................................................................................................................... 4
1.5 Registration with the Tax Practitioners Board...............................................................4
2 Physical specifications............................................................................................................. 5
2.1 Online file naming conventions.....................................................................................5
3 Data file format......................................................................................................................... 6
3.1 File content................................................................................................................... 6
3.2 Example File content....................................................................................................6
4 Record specifications............................................................................................................... 7
4.1 JobKeeper data record.................................................................................................7
4.2 Field definitions............................................................................................................. 8
5 Lodging - JobKeeper Report..................................................................................................13
5.1 Check list.................................................................................................................... 13
5.2 File naming.................................................................................................................14
5.2 Test facility.................................................................................................................. 14
5.3 Accessing the test facility............................................................................................14
6 More information.................................................................................................................... 15
6.1 Guide.......................................................................................................................... 15
6.2 Other enquiries........................................................................................................... 15
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
1 INTRODUCTION
ABOUT CORONAVIRUS ECONOMIC RESPONSE PACKAGE – JOBKEEPER
PAYMENT
The Government is introducing a wage subsidy program to support employees and businesses.
The JobKeeper Payment is designed to help businesses affected by the Coronavirus to cover
the costs of their employees wages, so that more employees can retain their job and continue
to earn an income.
Under the JobKeeper Payment, businesses and not-for-profit entities significantly impacted by
the Coronavirus outbreak will be able to access a wage subsidy from the Government to
continue paying their employees. This assistance will help businesses to keep people in their
jobs and re-start when the crisis is over. For employees, this means they can keep their job and
earn an income.
This will assist employers or their intermediaries receive, process and then lodge a
response file to the ATO.
Employers or their intermediaries complete the template and then lodge a file to the
ATO.
This report will be lodged only once with a complete list of employees, and then
subsequent reports will only be required when an employee’s eligibility status changes.
This guide is not intended to, nor does it, provide a guide to the relevant legislation.
The ATO preference for STP enabled employers is to report their JobKeeper codes through
their payevent reporting.
UNCLASSIFIED 1
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
Payers who are STP enabled with over 200 payees and have enrolled for JobKeeper and
have not started to report through their payevent, will be contacted where they can express a
preference to receive a pre-filled JobKeeper report via the Business Portal File Transfer status
or Online services for agents in .CSV format.
Payers who are STP enabled with less than 200 payees and have enrolled for JobKeeper
and would prefer not to or are unable to report through their payevent should lodge their
JobKeeper application via the online submission and confirm all eligible employees during the
online application process.
Payers who are not STP enabled with less than 40 payees and have enrolled for JobKeeper
must lodge their JobKeeper application via the online submission and confirm all eligible
employees during the online application process.
Payers who are not STP enabled with more than 40 payees and have enrolled for
JobKeeper must use the blank template attached to this guide to populate the eligible payees
and lodge via the Business Portal File Transfer status or Online services for agents in .CSV
format.
The JobKeeper online submission must be completed by payers. For more information go
to Enrol and apply for the JobKeeper payment
The security features of the Business Portal addresses the most commonly held concerns over
internet based electronic commerce, namely:
authentication (the sender is who they say they are)
confidentiality (the communication can only be read by the intended recipient)
integrity (the transmission cannot be altered without detection while in transit), and
non-repudiation (the sender cannot later deny the transmission and content).
UNCLASSIFIED 2
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
For more information to assist with lodging or receiving files via the Business portal see the
below links:
Accessing files sent by ATO
How to access a file
Notification emails
UNCLASSIFIED 3
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
1.4 PRIVACY
The Privacy Act 1988 limits the collection, storage, use and disclosure of personal information
about individuals by the ATO, other Commonwealth Government departments and agencies.
New private sector provisions in the Privacy Act also regulate the way many private sector
organisations collect, use, secure and disclose personal information. The private sector
provisions aim to give people greater control over the way information about them is handled in
the private sector by requiring organisations to comply with ten national privacy principles.
These principles give individuals the right to know what information an organisation holds about
them and a right to correct that information if it is wrong.
The Privacy Commissioner’s Guidelines to the Australian Privacy Principles and other relevant
information sheets are available at www.oaic.gov.au.
It is the responsibility of private sector organisations to obtain their own advice on the effect of
privacy law, including the Australian Privacy Principles on their operations.
Therefore it is important for all software providers to be aware of the requirements of the TASA
and, if appropriate, comply with the obligations that exist within it.
UNCLASSIFIED 4
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
2 PHYSICAL SPECIFICATIONS
The ATO will send out the Coronavirus JobKeeper files electronically via the Business Portal or
Online services for agents.
The file format for this report is comma separated values (CSV) file. This is a delimited text file
that uses a comma to separate values. A CSV file stores tabular data (numbers and text) in
plain text. Each line of the file is a data record. Each record consists of one or more fields,
separated by commas.
<OBET>_COVID19JobKeeper_<EmployerABN>_YYYYMMDDHHMMSS>.CSV
UNCLASSIFIED 5
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
The file format for this report is comma separated values (CSV) file. This is a delimited text file
that uses a comma to separate values. A CSV file stores tabular data (numbers and text) in
plain text. Each line of the file is a data record. Each record consists of one or more fields,
separated by commas. All text and date columns will be double quoted.
When compiling a return file if a value contains a comma, a newline character or a double
quote, then the string must be enclosed in double quotes.
Sample payload
84111122223_COVI
D19JobKeeper_20200414.csv
COVID19JobKeeper_
Blank.csv
UNCLASSIFIED 6
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
4 RECORD SPECIFICATIONS
The first row of the file will contain the column headers
Each subsequent row of the file will contain the data elements listed in the table below
Each data element will follow in order and be separated by a comma
Each employees data will be on its own row.
UNCLASSIFIED 7
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
O Optional field that must be made available by the software developer for the payer to
complete. Payers must complete the field if the data is available.
A is alphabetic (A-Z) - both upper and lower case are acceptable in all non-specific fields -
one byte per character. Alphabetic fields must be left justified and characters not used
must be blank filled.
For example, SMITH in a ten character field would be reported as SMITHbbbbb (the
character b is used to indicate blanks).
AN is alphanumeric - both upper and lower case alphabetic characters are acceptable in
non-specific fields only, for example, name and address fields – one byte per character.
Alphanumeric fields must be left justified and characters not used must be blank filled.
In addition, unless stated elsewhere in this specification, all other standard keyboard
characters are accepted in alphanumeric fields.
N is numeric (0-9) - one byte per digit. Numeric fields must be right justified and zero filled.
All amount fields are to be reported as dollar fields and must not contain decimal points,
commas or other non-numeric characters (for example $+-). The amount must be
reported in whole dollars. If an amount includes cents, the cents must be truncated (or
disregarded).
4.1 ATO Use Only – will contain the ATO generated tracking number for the file, this will be
prepopulated for the prefilled outbound .csv files received from the ATO, for payers using the
ATO none-pre-filled template, this field must be left blank. This field must also be left blank if
inserting payees.
UNCLASSIFIED 8
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
Where the payer is using the ATO none-pre-filled template, this field must be left blank.
4.2 Registered tax agent number – the registered tax agent number of the tax agent who
is authorised to receive and lodge the JobKeeper file on behalf of a payer.
4.3 Payer Australian business number – the payer’s current ABN must be reported in this
field. This must be a valid ABN.
Only one payer ABN must be used for all payee records contained within the file
4.4 Branch number – used to identify the correct branch of the payer that the payee
belongs to. If the payee belongs to multiple branches then just supply one branch number for
the payee. If the payer has not registered for branching, supply 001.
4.5 BMS ID – a unique identifier within the business that acts like a serial number to identify
which instance of the business payroll software created the data for the employee in the pay
event. This accommodates those businesses that have more than one simultaneous payroll
system and those businesses that change from one payroll system to another. Only supply one
BMS ID for the payee.
4.6 Payer contact person – the name of an individual who can be contacted if the ATO
needs to discuss matters relating to the information provided in the JobKeeper report.
Where the employer is using a tax agent or a 3rd party intermediary to interact with the ATO
it would be their details provided at 4.6, 4.7 and 4.8.
4.7 Payer contact person phone number – the number for the nominated contact person
must be provided. Wherever possible please provide a mobile number
Where the employer is using a tax agent or a 3rd party intermediary to interact with the ATO
it would be their details provided at 4.6, 4.7 and 4.8.
4.8 Payer contact person email address – the ATO can communicate with clients using
email and it is expected that some correspondence to payers (certain processing enquiries and
general correspondence) may be issued this way. This must be a valid email address (@ must
be positioned after the first character and before the last character).
Where the employer is using a tax agent or a 3rd party intermediary to interact with the ATO
it would be their details provided at 4.6, 4.7 and 4.8.
4.9 Payee tax file number – the TFN of the payee or an appropriate TFN code must be
reported.
This is a numeric field and can only contain values from 000000000 to 999999999.
UNCLASSIFIED 9
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
111111111 If a payment summary is prepared for a payee who does not provide a
TFN, but they indicate on the TFN declaration that they have applied or
enquired about a TFN with the ATO, an interim code of 111111111 can
be used by the payer.
333333333 Where the payee is under the age of eighteen and:
earns $350 or less weekly, or
earns $700 or less fortnightly, or
earns $1517 or less monthly.
987654321 Where a payee has quoted a TFN with alpha characters the code
987654321 must be used in place of the quoted TFN. This code must also
be used where the TFN quoted cannot be contained in the TFN field.
UNCLASSIFIED 10
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
4.10 Payee payroll ID – the payers identification number for the payee within their payroll
system. If you do not use a BMS system that allocates each employee a payroll ID this field
may be blank.
4.11 Payee surname or family name –the payee’s surname or family name. Where the
payee has a legal single name only, this field must be completed.
4.12 Payee first given name – must contain the payee’s first given name.
Where the payee has a legal single name only, this field must be blank. The legal single
name must be provided in the individual Payee surname or family name field.
4.13 Payee second given name – the payee’s second given name must be provided in this
field. If second given name is unknown, then the payee’s second initial should be provided in
this field. If the payee has no second given name this field must be blank.
Where a payee has more than two given names, the third and subsequent given names or
initials are not to be provided.
4.14 Payee date of birth – the date of birth of the payee in the format YYYY-MM-DD.
For example, if the payee’s date of birth is 29 June 1946, it would be reported as 1946-06-29.
This field must be provided for all payees unless the data is unavailable or the date is
only partially known. Only full valid dates are accepted.
4.15 JobKeeper fortnight code eligibility start – the fortnight code that the payee became
eligible for JobKeeper payments. Refer to table in 4.16
The payer should not pre-empt a payees eligibility for the Jobkeeper Payment. The payees
start fortnight must not begin after the current month
4.16 JobKeeper fortnight code eligibility end – the fortnight code for the first fortnight to
which the Jobkeeper payment no longer applies. Refer to table below; if blank it is assumed
the payee is eligible from the start fortnight code up to the final JobKeeper fortnight code.
See page 12 for further information on the 98 and 99 JobKeeper fortnight code
UNCLASSIFIED 11
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
The 98 JobKeeper fortnight code would only be used when the payer is unsure if the
payee is eligible or the appropriate forms applications have not been completed.
The 99 JobKeeper fortnight code would only be used when a payee is ineligible to
receive JobKeeper through their payer for example: the payee was first employed by the
payer after 1 March 2020 or left the payers employment before 1 March 2020. For more
information on payee eligibility go to Your eligible employees
Do not delete payees from the pre-filled .csv file if a payee is ineligible to receive JobKeeper
or no longer employed by the payer. The 99 JobKeeper fortnight code must be provided.
If the start or end fortnight eligibility of a payee changes then another file must be submitted
for those employees with these start/end fortnights codes updated.
4.17 Data source indicator – for each employee record contained within the report one of
the following indicators must be provided:
O – Original pre-filled data has not been updated or modified from the data provided by
the ATO
U – Pre-fill data has been updated. Only used if pre-filled data in columns 1-14 has
been updated.
I – Always supply I (Inserted) for any additional employee that was not pre-filled by the
ATO
Pre-filled reports will contain data in columns 1-14, only eligibility data will be required in
these reports and all records must be marked as original when only completing eligibility fields.
For employers using the none pre-filled template all employee records will be I (inserted)
UNCLASSIFIED 12
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
Intermediaries or reporters are able to lodge the JobKeeper report electronically via the
Business Portal or Online services for agents. Where the data file has been prepared and
stored locally. On screen confirmation will be provided once the file has been sent. The ATO
will perform data quality and format compatibility checks after the data file is sent.
If the user selects the email acknowledgement option in the Lodge file process, an email will be
provided confirming that the files have been successfully lodged with the ATO. A validation
report will be available in the portal to advise if the report was successfully validated or if there
are any problems.
Only one payer ABN and Registered tax agent number has been used for all records of
the file,
All mandatory data elements within the file are present,
Payees have not been deleted from pre-filled file,
Each payee is only included once even if they belong to multiple branches, BMS IDs, or
payee payroll ID,
All JobKeeper fortnight eligibility start codes are for fortnights beginning during or before
the current month. The exception is ineligibility codes (98 or 99) which can be entered at
any time,
All optional data elements within the file are present where the data is available,
If lodging an updated payee report, all known JobKeeper fortnight number eligibility data
elements are present,
If completing the none pre-filled template, the Data source indicator is set to I for each
payee,
For any values reported that contain a comma, a newline character or a double quote,
then the string must be enclosed in double quotes,
File naming convention used as described in section 5.2,
File must always be saved as a .csv to maintain file format.
UNCLASSIFIED 13
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
Example: 01234567892_COVID19JobKeeper_20200921.CSV
For support in the use of the test facility, including password reset:
UNCLASSIFIED 14
UNCLASSIFIED GUIDE FOR RECIEVING – CORONAVIRUS ECONOMIC RESPONSE
PACKAGE – JOBKEEPER PAYMENT
email ATOBulkDataTransfer@ato.gov.au, or
phone (02) 6216 4004 between 8.30am and 4.30pm, Monday to Friday AEST.
6 MORE INFORMATION
6.1 GUIDE
If anything in this guide needs clarification, direct your enquiries to:
ATO-eReporting@ato.gov.au
http://ato.gov.au/jobkeeper
https://treasury.gov.au/coronavirus/jobkeeper
UNCLASSIFIED 15