FATCA File Preparation Guide
This section identifies some primary online resources provided by IRS for FATCA file preparation, provides some xml document guidelines and describes the validation done during the file submission process.
IDES Resources
The primary resource for guidance on the preparation of FATCA XML documents is the International Data Exchange Service (IDES) website.
IDES website URL | Description |
---|---|
https://www.irs.gov/businesses/corporations/fatca-xml-schemas-and-business-rules-for-form-8966 |
Resources
|
https://www.irs.gov/businesses/corporations/fatca-xml-schema-best-practices-for-form-8966 |
FATCA XML Schema Best practices |
How to Correct, Void, and Amend Records |
|
https://www.irs.gov/businesses/corporations/fatca-xml-schemas-best-practices-for-form-8966-docrefid |
Guidelines for creating DocRefId values. |
https://www.irs.gov/businesses/corporations/fatca-xml-schemas-and-business-rules-for-form-8966 |
FATCA IDES Technical FAQ
|
FATCA Document Guidelines
When preparing the FATCA XML document, the following should be considered.
-
Use XML version 1.0 - The current version of the FATCA XML schemas is written using v1.0. Higher versions of XML will fail schema validation.
-
All schema namespaces should be declared at the beginning of the XML document, i.e. within the <FATCA_OECD> root element. This approach is used in the IDES sample files.
This enhances the readability of the document and reduces the likelihood of namespace reference errors.
-
All elements should be prefixed with the namespace alias. This approach is used in the IDES sample files.
This helps with identifying errors caused by incorrect schema references.
-
The XML document should be formatted on different lines with indentation. This will assist with easily identifying and resolving any schema validation errors.
-
The SendingCompanyIN must be 000000.00000.TA.780 this is IRD's Host Country Tax Authority (HCTA) ID.
-
The ReportingFI TIN must be the Reporting GIIN, i.e. your company's GIIN.
-
Filer Category is required for 2016 submission onwards.
-
MessageRefId should begin with the Reporting GIIN followed by some unique FI generated value.
Example: For GIIN 2IW3WK.00001.ME.780, a possible MessageRefId is
2IW3WK.00001.ME.780.328d0447-36a5-4467-a954-123605d30999
or
2IW3WK.00001.ME.780SEQ000001 -
DocRefId should begin with the Reporting GIIN followed by a period, must contain between 21 and 200 characters, and must not include any non-alphanumeric characters - excluding periods and dashes.
Example: 2IW3WK.00000.LE.152.d38z421f-7a8p-4e01-7ju1-3hu165f6fe8a
-
Files should be named using the following format
GIIN_FileType_YYYYMMDD.xml
Where
GIIN - Reporting GIIN
FileType - Either FATCA1, FATCA2, FATCA3 or FATCA4 (or FATCA11, FATCA12, FATCA13, FATCA14 for testing)
Date - Date CreatedExample: 7L6ZDL00001ME780_FATCA11_20170504.xml
FATCA File Validation
During the file submission process, only files which pass validation will be accepted. Two levels of validation are done
- Schema Validation – This ensures that the file conforms to the FATCA XML schemas.
- Data Validation – Additional validation done to help minimize the likelihood of file errors and corrections from IRS/IDES.
Data Validation
The following describes the different types of validation done during the Test Validation and File Submission processes.
Validation Type | Description |
---|---|
Reporting GIIN |
|
Reporting Period |
|
Submission Type |
|
Transmitting Country |
|
Receiving Country |
|
Sending Company |
|
Filer Category |
|
DocRefId |
|
Accounts |
|
The following validation is performed during the file submission process only.
Validation Type | Description |
---|---|
SSN |
|
CorrMessageRefId |
|
Amended Submission Type |
|
Corrected Submission Type |
|