The MyDevPortal process allows direct file through a webservices based gateway and is the starting point for all electronic transmitters, software developers, and taxpayers who intend to participate in our direct file program. All participants must register by navigating to the portal and selecting the “Register for electronic filing” link. New registration is required, even if you were previously setup for direct file.
The method will require transmission of the return and schedules using a new schema formatted in XML. Taxpayers utilizing this method will be required to select a vendor for file creation and transmission purposes, or to write their own programs and register as a transmitter. See additional requirements below under “Electronic Transmitters/Software Developers” for more details.
All instructions and guides for filing through the MyDevPortal process can be found on the Tobacco Uniformity webpage.
Electronic Transmitters/Software Developers
Beginning with the January 2025 reporting period, new file layouts were created by IDOR to utilize FTA’s XML schema for Tobacco Uniformity. These new layouts incorporate the uniform transactions schedule and an associated return. The Illinois-specific layouts are below.
Tobacco Uniformity Schema
The Illinois schema posted below incorporates the new additions in Version 2.0 of the FTA to the schema. The new additions are to include an optional cover page, developed using the sample contained in the FTA Tobacco Uniformity Guide.
Tobacco Uniformity Schema ZIP file
Tobacco Uniformity Developer and Transmission Guides for Other Tobacco Products (OTP)
Beginning with the January 2025 reporting period, the Developer Guide below has incorporated Illinois-specific business rules, as they apply to the schema provided above.
In addition to the Developer Guide, a new transmission guide detailing our new webservices-based gateway has been developed. This Illinois Webservices Gateway Transmission Guide includes the information necessary for sending submissions and retrieving acknowledgements.
TUP-750, Implementation Guide for Direct Filing of Tobacco Products Tax Returns for Tax Periods Beginning 1/1/2025 and After
TUP-750 Table 1 Spreadsheet - Tobacco Uniformity Schema Implementation for Illinois
TUP-750 Table 2 Spreadsheet - Illinois Business Rules and Error Messaging
Illinois Webservices Gateway Transmission Guide Updated 7/14/25