1099-NEC IRIS XML file for Rhode Island
Chapters
Read the transcript
Intro 0:00
In this video, you'll create your Rhode Island 1099-NEC IRIS XML file with the Export Wizard in W2 Mate. Rhode Island takes 1099s in the IRS IRIS XML format, and the wizard builds that file in four short steps. Rhode Island wants a 1099-NEC for Rhode Island-source income, even when no Rhode Island tax is withheld.
What goes into the 1099-NEC IRIS XML file 0:27
Here's the 1099-NEC, and the IRIS XML that W2 Mate writes for it. Box 1a, nonemployee compensation, becomes NonemployeeCompensationAmt. Boxes 5, 6 and 7 become the state group: RI, your Rhode Island state ID number, the state tax withheld and the state income. The recipient's tax ID goes in with its type. So in W2 Mate, type each one with its dashes: SSN as xxx-xx-xxxx, EIN as xx-xxxxxxx. That's how the file gets the right TIN type and goes through.
Before you start: set Box 6 to RI 1:09
Before you start, make sure Box 6 on every 1099-NEC you're filing with Rhode Island is set to RI. To be safe, open Tools > Other Recipient / 1099 Tools > Update Box 6 (State, Payer's state #) for multiple 1099-NEC recipients. Pick RI, and enter your Rhode Island withholding account number, if you have one.
Open the IRIS XML Export Wizard 1:35
Then start the wizard from the E-Filing menu. Point to 1099 IRIS XML Format (For State Upload), then click Export 1099-NEC Data as IRIS XML File.
Step 1: Payer 1:49
Step 1 shows the payer — the business that issues the forms. Check the name, tax ID and address. To fix something, click Review / Edit Payer. Here you can update the payer's TIN type and number, the name and the address. Click OK when you're done. Then tick the box to confirm, and click Next.
Step 2: Transmitter 2:12
Step 2 shows the transmitter, who sends the file, and the contact person Rhode Island will reach if there's a problem. To change any of it, click Edit Transmitter. This screen has who's sending the file, the company address for letters from the state, and the contact person. Click OK. Then click Next.
Step 3: Recipients (select Rhode Island) 2:34
Step 3 lists everyone who gets a 1099-NEC. Checked recipients go into the file. With Box 6 filled in, choose RI in the Box 6 state list, and click Select Only This State. That picks every form that reports Rhode Island. You can also choose RI in the Address state list, to select every recipient with a Rhode Island address. If a recipient shows in red, the Problem column tells you what to fix before you upload. Click Next.
Step 4: Output file 3:07
Step 4 is where the file is saved. Click Browse to pick a different folder. Leave the testing box unchecked for your real filing, and click Finish.
File created: check the totals 3:18
W2 Mate creates the file and shows the totals inside it. Compare them with your records: 5 Rhode Island forms and the Rhode Island tax withheld. Click Copy Path, so you can find the file on the upload page.
Upload to RI Tax Portal 3:34
Now log in to Rhode Island's Tax Portal. At the top right, choose Informational Documents, then File Informational Documents. Pick the IRIS XML file type, add your file, click Start Upload and Submit. To test the file first, choose Validate Only. If the portal lists errors, fix them in W2 Mate and upload again. When it's accepted, write down the Transmission ID. The file is due January 31, and your filing isn't complete until Rhode Island accepts it. For help with Tax Portal, call the Rhode Island Division of Taxation at (401) 574-8484. That's it. Your Rhode Island 1099-NEC IRIS XML file is ready. If you have questions about W2 Mate, email sales@realtaxtools.com or call 1-800-507-1992.
The steps at a glance
- Before you start: set the state box to RI on every form you file with Rhode Island (Tools › Other Recipient / 1099 Tools › Update … for multiple recipients), and enter your Rhode Island withholding ID. Type your Rhode Island withholding account number, like 012345678.
- Type tax IDs with dashes: SSN as xxx-xx-xxxx, EIN as xx-xxxxxxx, so the file gets the right TIN type.
- Open the wizard: E-Filing › 1099 IRIS XML Format (For State Upload) › Export … Data as IRIS XML File.
- Step 1 and 2: confirm the payer and the transmitter (use Review / Edit to fix anything).
- Step 3: Choose RI in the state-box list and click Select Only This State. Fix anything the Problem column shows.
- Step 4: pick where to save, leave Testing unchecked, and click Finish. Check the totals, then Copy Path.
- Upload the file to Tax Portal with Informational Documents › File Informational Documents. Choose Validate Only to test first, then write down the Transmission ID; your filing isn't complete until Rhode Island accepts it.
What W2 Mate writes for Rhode Island
This is the state part of each 1099 in the IRIS XML file W2 Mate creates for Rhode Island. Open your file in Notepad to compare it with yours. The element names come from the IRS IRIS XML schema; see the IRS page IRIS schemas and business rules.
1<StateLocalTaxGrp> 2 <StateAbbreviationCd>RI</StateAbbreviationCd> 3 <StateTaxGrp> 4 <StateIdNum>012345678</StateIdNum> 5 <StateTaxWithheldAmt>466.88</StateTaxWithheldAmt> 6 <StateIncomeAmt>12450.00</StateIncomeAmt> 7 </StateTaxGrp> 8</StateLocalTaxGrp>
| XML element | Where W2 Mate gets it |
|---|---|
StateAbbreviationCd | The state in the state box (Box 6 on the 1099-NEC): RI |
StateIdNum | Your Rhode Island withholding ID, exactly as you typed it |
StateTaxWithheldAmt | State tax withheld (Box 5 on the 1099-NEC) |
StateIncomeAmt | State income (Box 7 on the 1099-NEC) |
Sample values from the Rhode Island 1099-NEC video.
Common problems
Issues our support team sees most when customers file state 1099s:
The file has fewer recipients than I expected.
Either those recipients aren't in W2 Mate yet, or the state box on their forms isn't set to RI (Box 6 on the 1099-NEC). Use Tools › Other Recipient / 1099 Tools › Update … for multiple recipients to set RI on all of them, then export again. In Step 3 of the wizard, compare the number of checked recipients with your records before you click Next.
The state rejects a recipient because of the TIN type.
Type the recipient's tax ID with its dashes: an SSN as xxx-xx-xxxx and an EIN as xx-xxxxxxx. W2 Mate reads the dashes to tell an SSN from an EIN and writes the right TIN type into the file. Fix the TIN in W2 Mate, then export again.
The state says the file is in the wrong format.
Make sure you uploaded the IRIS XML file you saved in Step 4 of the wizard, not another file (for example an older Pub 1220 file or your federal IRIS file). Click Copy Path at the end of the wizard and paste it into the upload page's file box so you pick the right one.
The state doesn't accept my Rhode Island withholding number.
W2 Mate puts the number in the file exactly as you type it, so enter it in the format Rhode Island gave you (see "What should the Rhode Island withholding ID look like?" under Questions). Type it in the Employer State ID field on the Company General Information tab, and use the Update tool for multiple recipients so every form has it, then export again. If you're not sure of the number, contact the Rhode Island Division of Taxation.
Questions
Does Rhode Island accept 1099s in the IRS IRIS XML format?
Yes. The Rhode Island Division of Taxation accepts 1099 information returns as IRIS XML files through the Rhode Island Tax Portal, using Informational Documents › File Informational Documents (taxportal.ri.gov).
When are Rhode Island 1099 files due?
Rhode Island 1099s are due January 31. They are required for Rhode Island-source income at the federal thresholds, even when no Rhode Island tax is withheld.
Which 1099s does Rhode Island require?
1099s with Rhode Island-source income at the federal thresholds, even when no Rhode Island tax is withheld.
What should the Rhode Island withholding ID look like?
Type your Rhode Island withholding account number, like 012345678.
Who do I call about Tax Portal?
The Rhode Island Division of Taxation at (401) 574-8484, or email Tax.Portal@tax.ri.gov.
Does Rhode Island take IRIS XML files?
Yes. For tax year 2026, Rhode Island accepts 1099s in IRS IRIS XML format (and still the FIRE / Pub 1220 format). Form 1099-DA must be IRIS XML.
Does the IRS Combined Federal/State program cover Rhode Island?
No. Rhode Island does not participate in combined federal/state filing, so send your file to the Division of Taxation yourself.
I don't have a Rhode Island withholding account. How do I file?
Email Tax.VendorForms@tax.ri.gov to request a secure link for uploading your file. Payroll providers and bulk filers register through the Payroll Letter of Intent process at the same address.
Official Rhode Island links
- Rhode Island Division of Taxationtax.ri.gov
- RI Tax Portal (upload)taxportal.ri.gov
- Withholding taxtax.ri.gov
What you need to order
To create Rhode Island 1099 IRIS XML files in W2 Mate, order these items:
- RequiredW2 Mate Software [PC Download]The W2 Mate program for Windows.
- RequiredW2 Mate 1099 Export for States Supporting Retired FIRE or New IRIS XML FormatAdds the 1099 IRIS XML Export Wizard used in these Rhode Island videos.
- For other 1099sW2 Mate Option #5 (Additional 1099 Forms)Needed only if you also file 1099-R, 1099-K, 1099-B, 1099-INT or 1099-DIV. Not needed for 1099-NEC and 1099-MISC.
- For importingW2 Mate Option #3 (Import W2 / 1099 Data)Needed only if you import your data into W2 Mate from Excel spreadsheets, Retired FIRE format (IRS Pub 1220), QuickBooks Desktop, QuickBooks Online, Sage 50 or Microsoft Dynamics.
No import needed: you can type your 1099 data directly in W2 Mate. W2 Mate Option #3 (Import W2 / 1099 Data) is only for bringing in data you already have somewhere else.
Paylocity, Infor, Zoho Books, SAP, MRI Software, Oracle, AvidXchange, Procore, Paycom, Epicor, FreshBooks and other systems: you can use W2 Mate to create your IRIS XML files too. Export your 1099 data to an Excel spreadsheet, import it into W2 Mate with W2 Mate Option #3 (Import W2 / 1099 Data), then run the IRIS XML Export Wizard.
Other states
3 videos · 1099-NEC, 1099-MISC, 1099-RDelaware
1 video · 1099-NECGeorgia
4 videos · 1099-NEC, 1099-MISC, 1099-R, 1099-KIndiana
2 videos · 1099-NEC, 1099-RMaine
1 video · 1099-NECMinnesota
1 video · 1099-NECMontana
1 video · 1099-NECNorth Carolina
7 videos · 1099-NEC, 1099-MISC, 1099-INT, 1099-DIV, 1099-R, 1099-B, 1099-KOregon
4 videos · 1099-NEC, 1099-MISC, 1099-R, 1099-KVermont
1 video · 1099-NECWisconsin
1 video · 1099-NEC
Questions about W2 Mate?
We're happy to help with your 1099 and W-2 filing.
State rules can change. Check RI Division of Taxation's current instructions before you file.