SPECIFICATION EXTERNAL UNCLASSIFIED FORMAT AUDIENCE DATE CLASSIFICATION FILE REF: PREFILL TAX 2.0 Pre-filling report 2017 Specification to import pre-filling data into tax agent software. Date created: 26/04/2017 Date updated: 02/05/2017 Version: 0.2 UNCLASSIFIED For further information or questions, contact the Software Industry Partnership Office Visit www.softwaredevelopers.ato.g ov.au/
98
Embed
Insert Document Title - ...Software developers …softwaredevelopers.ato.gov.au/sites/default/files/... · Web viewspecification external UNCLASSIFIED format Audience Date Classification
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
SPECIFICATION EXTERNAL UNCLASSIFIEDFORMAT AUDIENCE DATE CLASSIFICATION
FILE REF:PREFILL TAX 2.0
Pre-filling report 2017
Specification to import pre-filling data into tax agent software.
Date created: 26/04/2017Date updated: 02/05/2017Version: 0.2
UNCLASSIFIED For further information or questions, contact the Software Industry Partnership Office Visit www.softwaredevelopers.ato.gov.au/Phone 1300 139 052
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE V0.1
ENDORSEMENT / VERSION CONTROL
CURRENT VERSION NUMBER 0.1 DATE 22/02/2017
CURRENT AUTHOR
Alex Hanna Graduate Business Analyst 07 321 35489
APPROVALCassie Dransfield Assistant Director, Pre-filling project manager 07 321 33021Trevor Fernando Team Leader, Channels & Online BAU Support 07 390 72727Mark Hendy Director, Channels & Online, BAU Support 07 311 99520
VERSION CONTROL
Version Revision date Revision description Author/Modifier
V0.1.V0.2.V1.0.
22/02/201727/03/201702/05/2017
Initial draft for Pre-filling project 2016Updated to include payment type HUpdate based on feedback from product owner
Alex HannaAlex HannaAlex Hanna
CHANGES FOR 2017
This document has been updated for the 2016-17 financial year. Changes specific to 2017 are highlighted in green. Cyclical changes, such as updating the financial year, are not highlighted.
UNCLASSIFIED PAGE 2 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE V0.1
Table of Contents
Endorsement / Version Control.....................................................................................................21. Introduction............................................................................................................................4
2. Downloading the report.........................................................................................................53. Requirements for Importing data into tax agent software......................................................64. Examples of download formats.............................................................................................7
4.1. XML tag format with ELS tag attributes..........................................................................75. Data dictionary.......................................................................................................................8
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE V0.1
1. INTRODUCTION
1.1.PURPOSE
The Pre-filling report 2017 will focus on simplifying and consolidation of the existing 2016 product. This will include removing extraneous sections and re-ordering data
This report is a tool tax agents use to assist them in completing a taxpayer’s income tax return. The report does not list all sources of income and therefore, it should not be relied upon exclusively.
The benefits of displaying or importing pre-filling information are:- making it easier to prepare returns by providing income, deduction and tax withheld details - more certainty about the income and deduction details thereby reducing the chance of mistakes, and- saving time since tax agents can verify details with the client.
1.2.SCOPE
Tax agents can request the Pre-filling report in the Tax Agent Portal. The report is to be displayed on the portal for multiple years (for 2017 there will be (9) financial years displayed).
Medicare data is only available for one (1) financial year at a time as it is a single year service.
The Pre-filling report can be viewed online or downloaded to their personal computer in the following formats:- ASCII (comma delimited)- ASCII zipped- HTML- HTML zipped - XMLThis document provides information on how the Pre-filling report is generated and formatted.
1.3. REFERENCES
This document should be read in conjunction with the EI specification.
An XML Schema Definition (XSD) is used to guarantee to the end user that the XML provided by the application is in a valid and consistent format. It defines what format the XML will be in so that the end application knows what to expect. An XSD has been provided for assistance in building an application based on the XSD’s definition.
1.4. AUDIENCE
This document has been developed for any persons wanting to implement a software solution to import the Pre-filling report data into an individual’s income tax return.
UNCLASSIFIED PAGE 4 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE V0.1
2. DOWNLOADING THE REPORT
Tax agents download the Pre-filling report to their personal computer by logging into the Tax Agent Portal. (The ‘Homepage’ is displayed).selecting Reports link in the left navigation. (The ‘Reports’ page is displayed).selecting the Pre-filling report link. (The ‘Enter report criteria’ page is displayed).
The tax agent can request up to 5 clients’ Pre-filling reports. The tax agent enters the TFN, Medicare card number (optional) including the relevant Individual Reference Number and any additional dependant Individual Reference Numbers.
Select a report format and select the Generate report button. (The ‘Report download page’ is displayed).Downloading the Pre-filling report for HTML formatted pages, ASCII text and XML
The download page will display up to 5 separate linksDownloading the Pre-filling report for zipped HTML formatted pages or ASCII
The download page will display a single zipped download link that will contain up to 5 separate files within it.
UNCLASSIFIED PAGE 5 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE V0.1
Alternatively, tax agents can request the report from Client reports under the Your client function. They can download the report by - Selecting the Pre-filling report link. (The ‘Enter report criteria’ page is displayed).- Entering a Medicare card number (optional) including the relevant Individual Reference
Number and any additional dependant Individual reference numbers. Select a report format and select the Generate report button. (The ‘Report download page’ is
displayed).
When the Download file link is selected, a ‘Save As’ window is displayed. The Portal will default to the ‘My documents’ folder and provide a report name.
The tax agent can choose- to change the directory where the file is saved, and- over-write the default file name with a new name.After selecting the Save button, the file is now saved on the tax agent’s personal computer.
3. REQUIREMENTS FOR IMPORTING DATA INTO TAX AGENT SOFTWARE
Tax agents were consulted regarding how they would like their client’s tax return pre-filled with the report’s data.
The tax agent must be able to choose whether to pre-fill their client’s tax return on an individual basis.The data may be imported into the worksheets or schedules used to complete the tax return. The pre-filled data must be distinguishable from other data.All pre-filled data must be editable except for the number of investors and the gross amounts for joint investments (interest, dividends and managed funds).Pre-filled data may be deleted.Pre-filled data may be reviewed by the tax agent prior to lodging the tax return.
The tax agent software may alert the tax agent which data has not yet been reviewed.
UNCLASSIFIED PAGE 6 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE V0.1
4. EXAMPLES OF DOWNLOAD FORMATS
4.1.XML TAG FORMAT WITH ELS TAG ATTRIBUTES
UNCLASSIFIED PAGE 7 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
5. DATA DICTIONARY
5.1.REPORT HEADER
PRE-FILLING REPORT 2017 Text Valid Values Format Description XML Tag
‘Pre-filling report <year>.‘
String: 10 Pre-filling report <year> = requested year
<Version > = version number. This is only displayed in downloadable formats such as,- XML tag – displayed in the
<Version> - XML: <Version>1.0</Version>- ASCII/CVS: Pre-filling report 2017 – version
1.0- HTML:
<metaname=”Version”content=”1.0”>
‘Report created:’ <date>
Date: 10 DD/MM/YYYY
Date report was generated <ReportCreationDate></ReportCreationDate>
Static text. ‘You should not rely exclusively on this report but use it to assist you in preparing your client’s income tax return. For more information refer to portal help or www.ato.gov.au/taprefilling.’
Assumption: All VOL, LAB and PSA will be converted to one of the following- PSI <PaymentType001> = Business and personal services income payment summary, payment type - Labour hire
UNCLASSIFIED PAGE 10 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
- PSI <PaymentType002> = Business and personal services income payment summary, payment type - Other specified payments- PSI <PaymentType003> = Business and personal services income payment summary, payment type – Voluntary agreement - PSI <PaymentType004> = Business and personal services income payment summary, payment type – Personal services income.
PRE-FILLING REPORT 2017Row Name Valid Values Format Description Label XML tag
‘2016-17 PAYG PAYMENT SUMMARIES as at <LastUpdatedDate>’ Section title –Section only displayed if data exists. - 3 columns - bold print.Tax withheld (right align)Income (right align)Label (right align)
Row Name Valid Values Format Description Label XML tag‘Type of payment summary:’
INB payment summary String: 250 Type of payment summary being displayed - <IndividualNonBusinessPaymentSummary> -<IndividualNonBusinessPaymentSummaryType>
<IncomeType> </IncomeType> ‘Available for pre-filling:’ DD/MM/YYYY Date10 Date information received. <LastUpdatedTimestamp>
</LastUpdatedTimestamp>‘ABN:’ ABN and CAC
1, 2, …9, 0Integer: 20 The payer ABN / CAC number on the payment
- Total tax withheld or paid for (INB = S) - always displayed
- Display $0.00 if amount unknown- Multiple income amounts on one payment
summary, tax withheld map to:NB: Different rule to be applied for ‘Income summary’ section
Label 1 – if gross payment (label 1)>$0 AND Lump A/B (label 3) >$0Label 3 – if NO gross amount (label 1) BUT there is an amount at (label 3 lump sum A or B) AND >$0 at other labelsNo label – if NO gross amount (label 1) and NO lump A/B (label 3) AND >$0 at other labels
123524No label
<TotalAmtTaxPaid> </TotalAmtTaxPaid>
‘Allowances’ 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Amount of allowances, earnings, tips, director’s fees, etc - displayed if data exists
2 <TotalAllowancesAmt> </TotalAllowancesAmt>
‘Lump sum A’ 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Lump sum A = lump sum for unused leave after 15/08/78 – displayed if data exists
3R <LumpSumA> </LumpSumA>
‘Lump sum A type’ ‘R’, ‘T’ or blank String: 1 - Lump sum A type on the INB payment summary – always displayed if <LumpSumA> data exists
- Fields other than R or T – leave as blank
3 <LumpSumAType> </LumpSumAType>
‘Lump sum B’ 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Lump sum B = lump sum for unused leave before 16/08/78 – displayed if data exists
3H <LumpSumB> </LumpSumB>
‘Lump sum D’ 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Lump sum D = Tax exempt – displayed if data exists
No label <LumpSumD> </LumpSumD>
UNCLASSIFIED PAGE 12 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘CDEP’ 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Community development employment project (CDEP) payment – displayed if data exists
5 <CDEPPaymentAmt> </CDEPPaymentAmt>
‘Exempt foreign employment income’
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Exempt foreign employment income from INB payment summary – displayed if data exists
Grossed up reportable fringe benefits amount from INB payment summary – displayed if data existsIf reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is YES then map to IT1N
If reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is NO then map to IT1W
5.3.2. INB – Individual and non-business payment summaries (Annuity)
Row Name Valid Values Format Description Label XML tag‘Type of payment summary: ‘
INB payment summary String: 250 Type of payment summary being displayed - <IndividualNonBusinessPaymentSummary> -<IndividualNonBusinessPaymentSummaryType>
<IncomeType> </IncomeType>‘Available for pre-filling:’ DD/MM/YYYY Date10 Date information received. <LastUpdatedTimestamp>
</LastUpdatedTimestamp>‘ABN:’ ABN and CAC
1, 2, …9, 0Integer: 20 The payer ABN / CAC number on the payment
Row Name Valid Values Format Description Label XML tag‘Type of payment summary:’
INB payment summary String: 250 Type of payment summary being displayed - <IndividualNonBusinessPaymentSummary> -<IndividualNonBusinessPaymentSummaryType>
<IncomeType> </IncomeType> ‘Available for pre-filling:’ DD/MM/YYYY Date10 Date information received. <LastUpdatedTimestamp>
</LastUpdatedTimestamp>‘ABN:’ ABN and CAC
1, 2, …9, 0Integer: 20 The payer ABN / CAC number on the payment
- Total tax withheld or paid for (INB = S) - always displayed
- Display $0.00 if amount unknown- Multiple income amounts on one payment
summary, tax withheld map to:NB: Different rule to be applied for ‘Income summary’ section
Label 1 – if gross payment (label 1)>$0 AND Lump A/B (label 3) >$0Label 3 – if NO gross amount (label 1) BUT there is an amount at (label 3 lump sum A or B) AND >$0 at other labelsNo label – if NO gross amount (label 1) and NO lump A/B (label 3) AND >$0 at other labels
123524No label
<TotalAmtTaxPaid> </TotalAmtTaxPaid>
‘Allowances’ 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Amount of allowances, earnings, tips, director’s fees, etc - displayed if data exists
Grossed up reportable fringe benefits amount from INB payment summary – displayed if data existsIf reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is YES then map to IT1N
If reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is NO then map to IT1W
5.3.8. SPN – Superannuation income stream payment summaries
- Where the <AgeStatusInd>= A. The taxpayer is 60+ (DOB is on or before 01/07/1956) and has an
UNCLASSIFIED PAGE 22 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
SPN type code, and taxed and untaxed element amounts including lump sum in arrears amounts a message will be displayed; “Your client is aged 60 years or over. The taxed element amounts are non-assessable, non-exempt income. Your client does not have to declare this income in their tax return.”
Row Name Valid Values Format Description Label XML tag‘Type of payment summary: ‘
Superannuation income stream payment summary
String: 250 Type of payment summary being displayed - <NonGovtSuperPensionPaymentSummary> -<NonGovtSuperPensionPaymentSummaryType>
‘Available for pre-filling:’ DD/MM/YYYY Date10 Date Information Received <LastUpdatedTimestamp> </LastUpdatedTimestamp>
‘ABN:’ ABN and CAC1, 2, …9, 0
Integer: 20 The payer ABN / CAC number on the payment summary
<PayerABN> </PayerABN> <PayerCAC> </PayerCAC>
‘Payer’s name:’ String: 76 The payer’s name the SPN payment summary <PayerName> </PayerName>
‘Period from:’ DD/MM/YYYY Date10 The start date for the period which covers payments made to the payee.
Tax offset amount for SPN T2 <TaxableOffsetAmt> </TaxableOffsetAmt>
‘(Original)’ or ‘(Amended)’ String: 1 Code type O or A - Type of payment summaryO = original
<AmendmentIndicator> </AmendmentIndicator>
UNCLASSIFIED PAGE 23 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
A = amended <AgeStatusMessage> </AgeStatusMessage> </NonGovtSuperPensionPaymentSummaryType></NonGovtSuperPensionPaymentSummary></PAYGPaymentSummaries>
5.3.9. SPN – Superannuation lump sum payment summaries
- Where the <AgeStatusInd>= A. The taxpayer is 60+ (DOB is on or before 01/07/1956) and has an SPN type code, and taxed and untaxed element amounts including lump sum in arrears amounts a message will be displayed; “Your client is aged 60 years or over. The taxed element amounts are non-assessable, non-exempt income. Your client does not have to declare this income in their tax return.”
Row Name Valid Values Format Description Label XML tag‘Type of payment summary: ‘
Superannuation lump sum payment summary
String: 250 Type of payment summary being displayed - <NonGovtSuperLumpSumPaymentSummary> -<NonGovtSuperLumpSumPaymentSummaryType>
‘Available for pre-filling:’ DD/MM/YYYY Date10 Date Information Received <LastUpdatedTimestamp> </LastUpdatedTimestamp>
‘ABN:’ ABN and CAC1, 2, …9, 0
Integer: 20 The payer ABN / CAC number on the payment summary
<PayerABN> </PayerABN> <PayerCAC> </PayerCAC>
‘Payer’s name:’ String: 76 The payer’s name the SLS payment summary <PayerName> </PayerName>
‘Date of payment:’ DD/MM/YYYY Date10 The date an SLS payment was made. <PaymentDate> </PaymentDate>
Is the employer exempt from FBT under section 57A of the FBTAA 1986?
<Y> or <N> String: 3 Yes” or “No” to be displayed in the Type column. If reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is YES then map Reportable fringe benefits to IT1N
If reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section
Is the employer exempt from FBT under section 57A of the FBTAA 1986?
<Y> or <N> String: 3 Yes” or “No” to be displayed in the Type column.
If reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is YES then map Reportable fringe benefits to IT1N
If reportable fringe benefit amount > 0 and “Is the employer exempt from FBT under section 57A of the FBTAA 1986? is NO then map reportable fringe benefits to IT1W
PRE-FILLING REPORT 2017Row Name Valid Values Format Description Label XML tag
‘2016-17 GOVERNMENT PAYMENTS as at <LastUpdatedDate>’
Date: 10 DD/MM/YYYY
Section title – section only displayed if data exists. - 7 columns - bold print.Payment type (left align)Paid from (right align)Paid to (right align)Tax exempt (right align)Tax withheld (right align)Taxable income (right align)Label (right align)
The amount of taxable income to be declared on the income tax return.
1 <TaxableIncomeAmt> </TaxableIncomeAmt>5
624V24Y
‘Label’ 1, 2, …9, 0 Integer: 2 The labelWelfare data that can be mapped to a label will be pre-filled. The exception to this rule is the Remote Area Allowance which is not mapped to a label but is provided for calculation of the zone or overseas forces tax offset.
‘BSWAT lump sum in arrears – your client may be eligible to claim the lump sum tax offset. Refer to http://www.ato.gov.au/bswat for further information’
Text String:250 Message will be triggered by BSW (Business Services Wage Assessment Tool) payment type. Message displayed once only. This is triggered if label 24Y is displayed in <TaxableIncomeAmt>
Hyperlinks: http://www.ato.gov.au/bswat
‘For the period your client received Dad and partner pay from ABN 29 468 422 437, they may not be eligible for:superannuation co-contributions’
Text String:250 Message will be triggered by DAP (Dad and partner pay) payment type. Message displayed once only. This is triggered if label 1 is displayed in <TaxableIncomeAmt>
“For the period your client Text String: 250 Message will be triggered by PPL or DAP <PPLMessage>
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
received Parental Leave Pay, they may not be eligible for:- Invalid and invalid
carer tax offset - superannuation co-
contributions.
payment types for parental leave pay. A bulleted text message will be displayed when there is data for Paid parental leave (message displayed once only)
</PPLMessage></GovtPaymentSummary>
5.5.2016-17 ATO INTEREST
PRE-FILLING REPORT 2017Row Name Valid Values Format Description Label XML tag ELS
‘2016-17 ATO INTEREST as at <lastupdateddate>’ Section title – displayed only if data exists- 2 columns - bold print.Description (left align)Amount (right align)
A message is to trigger when either 24Y or D10 field displays an amount or an asterisk *. The following bulleted text message is to be displayed as the first message above the data:
From 1 July 2015, we simplified the reporting of GIC, SIC and LPI. You can either rely on the pre-fill information or manually calculate the interest deductions and income. Refer to
<ATOInterestMessage></ATOInterestMessage> TBC
</ATOInterest>
UNCLASSIFIED PAGE 33 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
Calculating ATO Interest for further information.
Hyperlink to Calculating ATO Interest points to: www.ato.gov.au/prefillingcalculatingatointerest
Second trigger and message
A message is to trigger when either 24Y or D10 field displays an asterisk *. The following bulleted text message is to display beneath the first message:
* We have not pre-filled interest for this client. Refer to the above link for information on how to calculate interest deductions and income.”
5.6.2016-17 INTEREST INCOME
PRE-FILLING REPORT 2017Row Name Valid Values Format Description Label XML tag
‘2016-17 INTEREST INCOME as at <last updated date>’
Date: 10 DD/MM/YYYY
Section title – only displays if data is available- 3 columns - bold print.Gross (right align)Apportioned (right align)Label (right align)
PRE-FILLING REPORT 2017Row or Column Name Valid Values Format Description Label XML Tag
UNCLASSIFIED PAGE 35 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘2016-17 DIVIDEND AND INTEREST SCHEDULE INCOME as at <LastUpdatedDate>’
Gross Apportioned Label
Date: 10 DD/MM/YYYY
Section title
- Section - conditional, displayed only if data exists.- <LastUpdatedDate> = most recent date a record
for the data section was updated.- Header – centred, upper case, bold white print- 4 columns - bold print.~blank~Gross (right align)Apportioned (right align)Label (right align)- Account summary - alphabetical order.- Only if data exists will it be displayed - Data - block colour. - Apportioned column displays the same value as
Sum of all Unfranked dividends to be displayed as ‘Total unfranked Divdends’ at label 11S
11S Not included in XML
TOTAL FRANKED DIVIDENDS
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Sum of all Franked dividends to be displayed as ‘Total franked dividends’ at label 11T
11T Not included in XML
TOTAL FRANKING CREDITS
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Sum of all Franking credit to be displayed as ‘Total franking credit’ at label 11U
11U Not included in XML
TOTAL LISTED INVESTMENT COMPANY CAPITAL GAIN DEDUCTION
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Sum of all Investment Capital Gain Deduction at label D8
D8 Not included in XML
TOTAL TFN AMOUNTS WITHHELD
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Sum of all TFN amounts withheld from dividends to be displayed as “Total TFN amounts withheld’ at label 11V
11V Not included in XML
‘Company:’ String: 76 Name of financial institution - <DividendIncomeType> <FinancialInstitutionName> </FinancialInstitutionName>
UNCLASSIFIED PAGE 39 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘Available for pre-filling:’ DD/MM/YYYY Date10 Date Information Received <LastUpdatedTimestamp> </LastUpdatedTimestamp>
‘SRN or HIN:’ 1, 2, ...9, 0 Integer: 25 Investment reference numberThis field and heading SRN or HIN will not be displayed for Dividend and interest schedule (DIS) data.
<AccountNumber> </AccountNumber>
‘Name:’ String: 76 Name of account <AccountName> </AccountName>
‘Investment owners:’ 1,2, …9, 0 Integer: 2 Number of investors in the account. Must be >0
Column displays the gross amounts reported by external agency.
<TotalFranking> </TotalFranking>
1, 2, …9, 0 - Column displays the apportioned amount. Apportioned column displays the same value as the gross column when there is only 1 investor.
<ApportFranking> </ApportFranking>
‘TFN amounts withheld from dividends’
1, 2, …9, 0Monetary: 15, 2
Column displays the gross amounts reported by external agency.
<TFNWithheldCreditAmt> </TFNWithheldCreditAmt>
UNCLASSIFIED PAGE 40 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
($ / ¢)1, 2, …9, 0 Column displays the apportioned amount. Apportioned column displays the same value as the gross column when there is only 1 investor.
Where Employee share schemes data exists, text message to be displayed.
Your client may be entitled to reduce the amount of the discounts received under ‘taxed upfront schemes’. For more information, go to https://www.ato.gov.au/General/Employee-share-schemes.
‘These amounts have been adjusted to exclude foreign service period.’
< Display this message when the ‘Discount amounts are assessable or gross’ indicator is ‘A’To be displayed directly underneath the heading: Description/Amount/Label in a light grey row
< DiscountAmountsAssessableOrGrossIndicator>
‘These amounts have not been adjusted to exclude foreign service period.’
Display this message when the ‘Discount amounts are assessable or gross’ indicator is ‘G’To be displayed directly underneath the heading: Description/Amount/Label in a light grey row
< DiscountAmountsAssessableOrGrossIndicator>
‘Employer’s name:’ String:76 Name of the employer / reporting party < ReportingPartyName ></ ReportingPartyName >
‘Employer’s ABN 1, 2, …9, 0 String: 11 The ABN of the Employer / reporting party.Can contain a blank value.
< ReportingPartyABN></ ReportingPartyABN>
‘Available for pre-filling:’ DD/MM/YYYY Date10 Date Information Received <LastUpdatedTimestamp> </LastUpdatedTimestamp>
‘SRN or HIN:’ 1, 2, …9, 0 String: 2011 The SRN or HIN of the Employee <SRNHINReference></ SRNHINReference>
‘Plan reference number:’ String: 30 The plan reference number from the employer / reporting party
<PlanReferenceNumber> </PlanReferenceNumber>
‘Discount from taxed upfront schemes - eligible for reduction’
1, 2, …9, 0 Monetary: 11, 0 ($ / ¢)
Total amount of shares of discount from taxed upfront schemes - eligible for reduction
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
Capital gains discounted method
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
- Information only-
Display rule – Where 18A Net capital gains or 18H Total current year capital gains is displayed, also display immediately 18H – Capital gains discounted methodCapital gains indexation methodCapital gains other method
- If no 18A or 18H, don’t display the three capital gain fields.
Capital gains other method 1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
- Information only
Display rule – Where 18A Net capital gains or 18H Total current year capital gains is displayed, also display immediately 18H – Capital gains discounted methodCapital gains indexation methodCapital gains other method
- If no 18A or 18H, don’t display the three capital gain fields.
‘Name:’ String: 76 The name of the account is not returned for partnerships, so the name displayed will be the name associated with the TFN, i.e. the name on the report.
<Name> </Name>
‘PP – distribution from partnerships’
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Only displayed if data exists. 13N <TotalPrimaryProductionFromPartnershipAmt> </TotalPrimaryProductionFromPartnershipAmt>
Apportioned column displays the same value as the gross column, as there is only 1 investor.
‘Distribution from partnerships, less foreign income’
1, 2, …9, 0 Monetary: 15, 2 ($ / ¢)
Only displayed if data exists. 13O <TotalNonPrimaryProductionFromPartnershipAmt> </TotalNonPrimaryProductionFromPartnershipAmt>
Apportioned column displays the same value as the gross column, as there is only 1 investor.
PRE-FILLING REPORT 2017 Row Name Valid Values Format Description Label XML Tag
UNCLASSIFIED PAGE 54 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘2016-17 FOREIGN SOURCE INVESTMENT INCOME as at <LastUpdatedDate>’
Date: 10 DD/MM/YYYY
- Section – conditional, displayed only if data exists- <LastUpdatedDate> = most recent date a record
for the data section was updated.- Header – purple banner with centred, upper case
and bold white print- 4 columns - bold print.~blank~Gross (right align)Apportioned (right align)Label (right align)- Each record to be in alternating dark and light grey
shading. Shading to apply to entire record.- Apportioned column displays the same value as
the gross column when there is only 1 investor.- We are able to display a maximum of 20
transactions only.’- Maximum of 20 transactions can be displayed.
- If more than 20 records exist, the first 20 records are displayed.
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
5.13. 2016-17 SHARE DISPOSAL
PRE-FILLING REPORT 2017 Row Name Valid Values Format Description Label XML tag
‘2016-17 SHARE DISPOSALS as at <LastUpdatedDate>’
Section title – displayed only if data exists.- 6 columns - bold print.Company name (left align)ASX code (right align)HIN or SRN (right align)Date of sale (right align)Number of shares sold (right align)Number of investors (right align)
Bullet Point message – Your client disposed of share holdings that may have resulted in a capital gains event. We are able to display a maximum of 20 transactions only.
‘Company name’ String: 50 The company name of the shares - <CGTSecuritiesType> <IssuerName> < /IssuerName>
‘ASX code’ String: 10 The ASX code of the shares <ASXCode> </ASXCode>‘SRN or HIN’ 1, 2, …9, 0 String: 19 The SRN or HIN of the shares <AccountHoldingTypeOrNumber>
</AccountHoldingTypeOrNumber> ‘Date of sale’ DD/MM/YYYY Date: 10 The date of sale of the shares <DateSharesDisposed>
</DateSharesDisposed>‘Number of shares sold’ 1, 2, ...9, 0 String: 11 The number of shares sold at that date <QuantityOfSharesDisposed>
</QuantityOfSharesDisposed>‘Number of investors’ 1, 2, ...9, 0 Integer: 2 The number of investors of the shares <NumberOfInvestors>
UNCLASSIFIED PAGE 57 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
</NumberOfInvestors>
- ‘Your client participated in a share buy-back event which may have resulted in a capital gains event. <IssuerName>
String: 250 Hyperlink
Where the client has shares where a CHESS reason code and Registry reason code has a value of buyback transaction. Only one bulleted text message will be displayed.
PRE-FILLING REPORT 2017 Row Name Valid Values Format Description Label XML tag
‘2016-17 SHARE DISPOSALS as at <LastUpdatedDate>’
Section title – displayed only if data exists.- 5 columns - bold print.Property address (left align)Contact Date (right align)Settlement Date (right align)Sale Price (right align)
Bullet Point message – Your client may have transferred properties resulting in a capital gains tax event. For more information go to https://www.ato.gov.au/General/Capital-gains-tax/ for current information on your tax obligations. We are able to display a maximum of 5 transactions only.
Bullet Point message – The sale price is for a disposal event which may be for more than one property address.
PRE-FILLING REPORT 2017 Row Name Valid Values Format Description Label XML tag
‘2016-17 TAXABLE PAYMENTS as at <LastUpdatedDate>’
Date: 10 DD/MM/YYYY
- Section – displayed only if data exists- <LastUpdatedDate> = most recent date a
record for the data section was updated.- Header – centred and bold print- 7 columns - bold print.Payer name (left align)Payer ABN (right align)Available for pre-filling (right align)Type (right align)Tax withheld (right align)GST (right align)
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
Health insurer name (right align)Membership number (right align)Start date (right align)End date (right align)Policy type (right align)
‘Health insurer ID’ String: 3 The health insurance funds’ ID (3 digit alpha). - <MLSPolicyType> - <MLSPolicyDetails> <FundCode> </FundCode>
^BWU
‘Health insurer name’ String: 30 Name of the health insurance fund. <HealthInsurerName> </HealthInsurerName>
‘Membership number’ 1, 2, …9, 0 Integer: 15 The taxpayer’s membership number for of the health insurance fund.
<MembershipNumber> </MembershipNumber> -
^BWV
‘Start date’ Date10: DD/MM/YYYY
The date the membership started in the financial year.
<MLSStartDate> </MLSStartDate>
‘End date’ Date10: DD/MM/YYYY
The date the membership ceased in the financial year.
<MLSEndDate> </MLSEndDate>
‘Type of Policy’ String: 1 The type of membership for the health insurance fund. Policy type indicator is displayed, not description. S = SingleC = CoupleF = FamilyP = Single parent
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
Row Name Valid Values Format Description Label XML tag ELS‘2016-17 PRIVATE HEALTH INSURANCE POLICY DETAILS as at <LastUpdatedDate>
Section title –displayed only when data is available.- 6 columns - bold print.Health insurer ID (left align)Health insurer name (right align)Membership number (right align)Your share of premiums paid in the financial year (right align)Your share of Australian Government rebate received (right align)Benefit code (right align)
PRE-FILLING REPORT 2017 Row Name Valid Values Format Description XML Tag
‘2016-17 ATO-HELD INFORMATION Section title – displayed only if data is available. All ‘ATO-held information’ messages will be presented and grouped in the following format. There is only one format for all ‘Other information’ messages types.
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
- <HELP> or <SFSS>or <TSL - displayed
</ABSTUDYSSLBalance>
‘Pay as you go (PAYG) instalments for 2014-15 as at <PAYGLastInstalmentDate> The total amount displayed represents the calculated liability, regardless of payment.’
<PAYGLastInstalmentDate>:Qtr 1 <amount> or <text>Qtr 2 <amount> or <text>Qtr 3 <amount> or <text>Qtr 4 <amount> or <text>Total <amount>
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘Income averaging for special professionals’ Average taxable professional income is $<AverageTaxableIncome>
Year Taxable professional income<Year> <TaxableIncomeAmt>
String : 250Monetary: 15, 2 ($ / ¢)
The taxable income for the last four immediate prior years for special professionals.RULE: <AverageTaxableIncome> = The sum of taxable professional income as per rules1 row of data, then the average income = 1/3 (third) of the taxable professional income2 or more rows, then the average income = ¼ (quarter) of the sum of the taxable professional income<Year> = year of the taxable income<TaxableIncomeAmt> = taxable income amount for that year
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘Sources of supplementary income reported in 2015-16
- partnership and trust income
- personal services income
- net income or loss from business
- foreign entities- foreign source
income- forestry managed
investment scheme income
String : 250
Taxpayer had income from these sources in the previous tax return.
No label - <IncomeSource> <MessageTextPlain> </MessageTextPlain> </IncomeSource>
‘Rent reported in 2015-16’
<address> The property first earned rental income from <date>.’
String: 250Date: 10DD/MM/YYYY
Taxpayer had rental income reported in Rental schedule for 2015-16- <address> = address of rental property (Line1;
Line2; Suburb; State; Postcode)- <date> = date the property first earned rental
incomeAddress and date the property first earned rental income will be sourced from rental schedules in the immediate prior year tax return.
No label - <RentalIncome> - <RentalIncomeType> <MessageTextPlain> </MessageTextPlain> </RentalIncomeType> </RentalIncome>
‘At least one 2015-16 rental property schedule contained incomplete address details and has been excluded from pre-filling. A separate schedule with full details is required for each rental property.’
String: 250 Taxpayer had an invalid or incomplete address in the rental schedule/s in the immediate prior year tax return.
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
Business income and expenses reported in 2015-16 Subsection heading - <BusinessIncomeAndExpenses>
‘Closing stock type’ String: 15 The closing stock for business income and expenses reported in 2015-16 return. The type (method used to value the stock), The primary production amount, non-primary production amount and total amount are displayed.
‘Deductions reported in 2015-16’ Sub-section header - <Deductions>
Work-related expense risk
Your client's work-related expenses for 2015-16 are high compared with taxpayers in similar occupations and income range (as at June 2017). We recognise that larger claims can be legitimate, however we
String:250 To be displayed with TFN’s aReminderFlag = Y SWEAdvisoryReminderFlag
UNCLASSIFIED PAGE 71 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
may reviewdeductions for this client if they remain high in 2016-17.
‘Work related car expenses’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for work related car expenses reported in prior year return.
No label <WorkRelatedCarExpenses> </WorkRelatedCarExpenses>
^AMV
‘Claim type’ String: 15 Claim type code. No label <WorkRelatedCarExpenseActionCode> </WorkRelatedCarExpenseActionCode>
^ANI
‘Work related travel expenses’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for work related travel expenses reported in prior year return.
No label <WorkRelatedTravelExpenses> </WorkRelatedTravelExpenses>
^AMA
‘Work related uniform expenses‘
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for work related uniform expenses reported in prior year return.
No label <WorkRelatedClothingCleaningExpenses> </WorkRelatedClothingCleaningExpenses>
^AMB
‘Claim type’ String: 15 Claim type code. No label <WorkRelatedClothingCleaningExpenseActionCode></WorkRelatedClothingCleaningExpenseActionCode>
^ANJ
‘Work related self-education expenses’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for work related self-education expenses reported in prior year return.
No label <WorkRelatedSelfEducationExpenses> </WorkRelatedSelfEducationExpenses>
^AMC
‘Claim type’ String: 15 Claim type code No label <WorkRelatedSelfEducationExpensesActionCode></WorkRelatedSelfEducationExpensesActionCode>
^BOO
‘Other work related expenses’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for other work related expenses reported in prior year return.
No label <OtherWorkRelatedExpenses> </OtherWorkRelatedExpenses>
^AMD
‘Low value pool deduction’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for low value pool deduction reported in prior year return.
No label <LowValuePoolDeduction> </LowValuePoolDeduction>
Total amount for interest deductions reported in prior year return.
No label <InterestDeduction> </InterestDeduction>
^JEE
‘Dividend 1,2, …9, 0 Monetary: Total amount for dividend deductions reported in No label <DividendDeduction> ^JEF
UNCLASSIFIED PAGE 72 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
deductions’ 15,2 ($ / ¢) prior year return. </DividendDeduction>‘Gifts or donations’ 1, 2, …9, 0 Monetary:
15,2 ($ / ¢)Total amount of gifts and donations reported in prior year return.
No label <GiftOrDonations> </GiftOrDonations>
^AGI
‘Cost of managing tax affairs’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount for cost of managing tax affairs reported in prior year return.
No label <TaxAffairManagementCost> </TaxAffairManagementCost>
^BMA
‘Deductible amount of UPP for a foreign pension or annuity’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total deductible amount of undeducted purchase price of a foreign pension or annuity reported in prior year return.
No label <ForeignPensionUPPDeductibleAmt> </ForeignPensionUPPDeductibleAmt>
^BWW
‘Personal superannuation contributions’
1, 2, …9, 0 Monetary: 15,2 ($ / ¢)
Total amount of personal superannuation contributions reported in prior year return.
No label <NonEmployerSponsoredSuper> </NonEmployerSponsoredSuper>
^AMP
‘Full name of fund:’ ‘ABN:’
Text:500 - Full name of fund/ABN displayed as bullet text and on the same row.
- ABN displayed in 2nd column right aligned.
RULE:Where superannuation name and ABN exist and only one superannuation fund exists display: SuperName, SuperABN and Amount
Where Y indicator exists for name/ABN – display bulleted text message and amount- ‘Your client contributed to multiple
superannuation funds.’
Where blank name or ABN exists - display bulleted text message and the total amount‘Unable to display personal superannuation contributions – incomplete details.’
Total amount of other deductions reported in prior year return.
No label <OtherDeductions> </OtherDeductions>
^BMK
UNCLASSIFIED PAGE 73 OF 74
UNCLASSIFIED 2017 PRE-FILLING REPORT IMPORTING DATA INTO TAX AGENT SOFTWARE 0.1
‘Other deductions election expenses’
1, 2, ...9, 0 Monetary: 15,2 ($ / ¢)
Total amount of other deductions election expenses reported in prior year return.
No label <OtherDeductionsElectionExpenses> </OtherDeductionsElectionExpenses> </Deductions>
^BYE
‘Dependent children reported in 2015-16’ Sub-section header - <Medicare>
‘Number of dependent children for M1’
1, 2, …9, 0 Integer: 2 Number of dependants as per last financial year. No label <DependantsMedicareExempt> </DependantsMedicareExempt>
^ASS
‘Number of dependent children for IT8’
1, 2, …9, 0 Integer: 2 Number of dependants as per last financial year. No label <DependantsMedicareSurcharge> </DependantsMedicareSurcharge> </Medicare>
^BXA
‘Spouse details - married or de facto reported in 2015-16’ Sub-section header - <SpouseDetail>
‘Spouse’s name’ Given name String: 30 The spouse’s first name. No label
<GivenName> </GivenName>
Middle name String: 30 The spouse’s middle name. <MiddleName> </MiddleName>
Family name String: 30 The spouse’s surname. <FamilyName> </FamilyName>‘Spouse’s date of birth’
Date: 10DD/MM/YYYY
Spouse’s date of birth. No label <DateOfBirth> </DateOfBirth>
Error messages which are to be displayed in a number of sections on the report will appear in the following format in the downloadable XML format: An example
<ErrorMessages> <ErrorMessage>No bank details are recorded. Check with your client before lodging their return. </Error Message></ErrorMessages>