IRS Logo
Print - Click this link to Print this page

FATCA XML Schemas and Business Rules for Form 8966

The FATCA XML Schema is based on business requirements collected by a multilateral working group. The schema uses elements from existing reporting schemas used by the OECD and the European Union (EU) to reduce burden on reporting entities. The links below provide guidance on how to validate schemas.

XML resources

The .xsd and sample .xml files can be viewed with a web browser, such as Internet Explorer or Chrome and a text editor such as Microsoft Notepad, or an XML tool such as XMLSpy or XML Notepad.

Data Preparation Sample Packet

Review the sample FATCA data packet that includes all data files used to create a test transmission to the IRS.

Important: Beginning January 2017, the FATCA XML Schema v2.0 will replace v1.1 and the FATCA Notification XML Schema v2.3 will replace v2.2.  All International Data Exchange Service (IDES) users will be required to submit FATCA Reports using version 2.0 because version 1.1 will no longer be supported.

Resources Description

FATCA XMLv1.1

 

Publication 5124, FATCA XML v1.1 User Guide

FATCAXML-v1.1 (12KB) - Main schema for FATCA reporting.

 

ISOFATCATypes-v1.0 (72 KB) - Two-letter country codes defined in ISO 3166-1 standard and the three-letter currency codes defined in ISO 4217 standard. Referenced by main schema.

 

OECDTypes-v4.1 (4KB) - Defines different types for a name and legal character of an address. Referenced by STF FATCA schema.

 

STFFATCATypes-v1.1 (20KB) - Common data types specific for FATCA based on the Standard Transmission Format (STF) from the OECD. Referenced by main schema.

 

NilFIReport.xml (2KB) – Sample Nil FFI Report. Updated 04-07-15

 

NilHCTAReport.xml (3KB) – Sample Nil HCTA Report. Updated 04-07-15

FATCA XML v2.0 - Updated 08-31-2016
Effective 01-2017

 

Publication 5124, FATCA XML Schema v2.0 User Guide
Draft 08-2016

FATCAXML_v2.0 (25KB) - Main schema for FATCA reporting. Updated 08-30-2016


ISOFATCATypes-v1.1 (72 KB) - Two-letter country codes defined in ISO 3166-1 standard and the three-letter currency codes defined in ISO 4217 standard. Referenced by main schema.

OECDTypes-v4.1 (37KB) - Defines different types for a name and legal character of an address. Referenced by STF FATCA schema.


STFFATCATypes-v2.0 (24KB) - Common data types specific for FATCA based on the Standard Transmission Format (STF) from the OECD. Referenced by main schema.
Updated 08-31-2016

 

AmendedNilFIReport (2KB) – Sample amended Nil FI Report Updated 08-31-2016

 

NewNilFIReport  (2KB) – Sample Nil FI Report
Schema v2.0 Updated 08-31-2016

 

VoidNilFIReport  (2KB) – Sample void Nil FI Report
Schema v2.0 Updated 08-31-2016

Sender Metadata XML v1.1
Effective 11-24-2015

 

Publication 5188, FATCA Metadata XML Schema v1.1 User Guide

FATCA-IDES-SenderFileMetadata-1.1 (12 KB)- Main schema used to generate sender metadata file

FATCA Sender File Metadata XML Samples_1.1. :

  • FATCA Report (RPT)
  • FATCA Report Notifications (NTF)
  • Competent Authority Request (CAR)

FATCA Notification XML v2.2
Effective 7-11-2016

For Current Production

 

Publication 5189, ICMM Notifications User Guide
 

Publication 5216, ICMM Notification XML Schema User Guide

BASE-FATCA-NOTIFICATION-2.2 (100 KB) - Base schema for common data elements and data types related to FATCA notifications. Referenced by all main notifications schemas.
Includes the “NKS” notification code.

 

FATCA-FILE-ERROR-NOTIFICATION-2.2 (4 KB) -Main schema that describes various types of file level error notifications.

FATCA-VALID-FILE-NOTIFICATION-2.2 (8 KB) - Main schema for the valid file notifications.

FATCA Report Notification XML Samples_2.2.xml :

  • FileErrorNotificationSample_2.2.xml (illustrates the use of the new “NKS” notification code)
  • FieldLevelErrorNotification_2.2.xml
  • RecordLevelErrorNotification_2.2.xml
  • ValidFileNotification_2.2.xml

FATCA Notification XML v2.3 *DRAFT*

**Effective January 2017**

Publication 5189, ICMM Notifications User Guide (Draft)

Publication 5216, ICMM Notification XML Schema User Guide (Draft)

BASE-FATCA-NOTIFICATION-2.3 (102 KB) - Base schema for common data elements and data types related to FATCA notifications. Referenced by all main notifications schemas.

 

Updates:
- New enumeration code "NIL_REPORT"
- New record level error codes (8013-8018) for
 nil report  errors
- Updated enumerations in ISO3166Alpha2
 CountryCodeType for FATCA XML v2.0

 

FATCA-FILE-ERROR-NOTIFICATION-2.3 (4 KB) -Main schema that describes various types of file level error notifications.

 

FATCA-VALID-FILE-NOTIFICATION-2.3 (8 KB) - Main schema for the valid file notifications.

FATCA Report Notification XML Samples_2.3.xml :
• FileErrorNotificationSample_2.3.xml
• FieldLevelErrorNotification_2.3.xml
• RecordLevelErrorNotification_2.3.xml
• ValidFileNotification_2.3.xml

FATCA Wrapper for Non-XML v1.1
Effective 8-21-2015

FATCA-IDES-FileWrapper-1.1 (135 KB) - Base schema for common data elements and data types for converting non-XML formatted files into an XML format. The only allowable non-XML file types are TXT, PDF, RTF and JPG.

 

FATCA IDES File Wrapper Non-XML Samples:

  • Unsigned
  • Signed

 

To Convert to XML:

  • Convert the TXT file by using the  <Wrapper> element tag directly around the text.  
  • Files of PDF, RTF, or JPG types must use Base64 encoding scheme to convert the binary based content into text, and then apply <Wrapper> element tag around the text.
Page Last Reviewed or Updated: 02-Dec-2016