Tax Year 2017 Affordable Care Act Information Returns (AIR) Known Issues, Crosswalks, Schemas and Business Rules

The links below provide information and technical guidance for software developers and transmitters who are interested in developing software for AIR for Tax Year 2017. Included are links to Known Issues, Form to Schema Crosswalks, XML Schemas, and Business Rules.

Tax Year 2017 Documents:

Known Issues

During production, the Known Issues and Solutions document provides notifications of problems identified, workarounds and date of resolution.

Known Issues and Solutions (PDF) (Updated: 05/07/2018)

Form to Schema Crosswalks

The Crosswalks provide a line by line reference of the schema elements, patterns and descriptions. They should be used only as a guide when developing software. Always refer to the actual schema files in the link below when developing software.

Updated 10/10/2017

Form 1094-B Form to Schema Crosswalk (PDF)

Form 1094-C Form to Schema Crosswalk (PDF)

Form 1095-B Form to Schema Crosswalk (PDF)

Form 1095-C Form to Schema Crosswalk (PDF)

XML Schemas, Business Rules and Release Memo

Special attention should be paid to the projected start and end dates for AIR Assurance Testing System (AATS) and Production.

Throughout the year updated versions of these files may be posted. Each version will show the start date and end date for both AATS and Production when that file version should be used. Multiple versions of these documents may be in use at the same time. Included within the schema file is a DIFF File showing differences from the previous version.

Tax Year 2017 Forms 1094-B, 1094-C, 1095-B, and 1095-C

Version Date Posted AATS Dates Production Dates

TY2017v1.0

Updates: 05/25/2018 - New posting of revised Release Memo and business rule v1.1, v1.2, v1.3, and v1.4

07/02/2017

Start Date: 10/30/2017  Note: Schemas v1.0 and Business Rules v1.1, v1.2, v1.3, and v1.4 are valid for AATS.
End Date: TBD

Start Date:
1/22/2018  Note: Schemas v1.0 and Business Rules v1.1, v1.2, v1.3, and v1.4 are valid for Production.
End Date: TBD