This guide covers: reading the filings list, filtering by period or form, opening one filing, downloading the filed copy, and the differences between portals.
Every return Payrollix prepares and transmits — Form 941, 940, W-2/W-3, 1099-NEC, 1099-MISC, plus state withholding and SUTA returns — lands in a single tax-filings list per client. The list is your read-only record of what has been (or is being) filed, what the agency status is, and where to download the filed copy. The Dashboard portal and the Client/SMB portals show the same underlying filings but with different controls.
Read the filings list
What it does: Shows every tax filing on record for the selected client with its form, period, status, and amount.
Where: Dashboard → Clients → [client] → Tax Filings. Client portal users see the same list at /client-portal/tax-filings. SMB portal users see it at /smb-portal/tax-filings.
Steps:
- Open the client (or, in Client/SMB portal, just open Tax Filings).
- The table shows: Form · Period · Due Date · Amount · Status · Actions.
- State filings are prefixed with the two-letter state code in the Period column (e.g. CA Q2 2025).
- Status badges are color-coded — submitted (blue) means transmitted and awaiting acknowledgment, accepted (green) means the agency took the return, rejected (red) means it bounced and is queued for fix-and-retransmit.
- A separate payment-status badge tells you whether the tax behind the form is handled: Paid (green), Scheduled (blue — the deposit is queued), or Pending · $400.00 (amber, showing the balance still owed). That badge tracks the money; the status above tracks the return. Payrollix is the Reporting Agent — we file and deposit on your behalf, so you view both here rather than paying anything yourself.
Who: Accountant + SUPPORT see all client filings via the dashboard. Client / SMB users see only their own.
Notes: Recently transmitted filings sit in submitted until the IRS or state returns an acknowledgment — usually within 24 hours for federal MeF, longer for state.
Filter by period or form
What it does: Narrows the list to a single tax year or to a single form type.
Where: Same Tax Filings page.
Steps:
- In the client portal, the All Years dropdown at the top right filters by tax year. Pick a year to scope the list.
- In the dashboard view, the dashboard-level Tax Filings page (
/tax-filings) has a Select Client dropdown at the top — pick a client to load their filings; otherwise no list is shown. - To narrow by form, sort the table by the Form column and skim.
Notes: There is no column-level filter chip yet. If you need a strict "show only 941s" view, use the bulk-export preview on the dashboard /tax-filings page, which is scoped to a single form + quarter.
Open one filing
What it does: Drills into a single filing to see its calculated totals, transmission history, and archived documents.
Where: Dashboard → Clients → [client] → Tax Filings → click View on any row.
Steps:
- From the table, find the row for the form + period you need.
- Click View. The detail page lays out the calculated amounts, depositor schedule, and transmission record.
- Use the Recalculate button (circular arrow icon) on draft filings to pick up any new payroll data since the filing was created. Recalculate is only offered while the filing is in draft status.
- Use Delete (trash icon) on a draft to discard it. Once submitted, the filing record stays for audit.
Who: Accountant + SUPPORT. The Client/SMB portals show a read-only list; there is no detail page in the SMB portal yet.
Download the filed copy
What it does: Pulls the actual filed artifact for state filings — the file we transmitted to the state, ready for a manual portal upload or your records.
Where: Dashboard → Clients → [client] → Tax Filings, download icon on the row.
Steps:
- Locate a state filing in the list (the Period column will show a two-letter state code).
- Click the green download icon in the Actions column. The browser downloads the file (CSV / TXT / XML, depending on the state's spec).
- For federal filings (941, 940, W-2, 1099-NEC), the filed XML and PDF live in the S3 archive and are linked from the filing detail page rather than the list. On a W-2 filing's detail page you can download a single employee's W-2 package, Download all W-2s as one ZIP, or pull the W-3 transmittal PDF. On a 941 or 940 filing you can download the draft IRS PDF before it transmits — useful for a client review or your own records. The dashboard's
/tax-filingspage also offers a Bulk Export for Tax1099 button if you're routing federal forms through a third-party transmitter.
Notes: The download icon only appears on state filings where a registered builder exists. If a state's quarterly format isn't wired yet, the icon is hidden and the backend returns 501 if forced.
Cross-portal views — what differs
What it does: Same data, different controls per portal.
Where: Dashboard (/tax-filings and /clients/{clientId}/tax-filings), client portal, SMB portal.
Steps:
- On the dashboard
/clients/{clientId}/tax-filingspage, Payrollix is the Reporting Agent — we file and deposit on your behalf, so you view returns rather than file them. The Preview Draft button builds a draft of any form ahead of the deadline (941, 940, W-2 batch, 1099-NEC batch, 1099-MISC batch, state withholding, SUTA) so you can check the numbers. This is rarely needed — the auto-filing pipeline creates and transmits returns on cadence — but it's there for catch-up filings and odd cases. - On the client portal, users see filings only after they've been submitted or accepted. There's no create or delete control.
- On the SMB portal, the page is summary-first: it shows the next federal filing deadline (Form 941, current quarter) and a list of form types with descriptions. Recent Filings shows the most recent transmissions.
Who: Dashboard = accountant + SUPPORT (full control). Client portal = client read-only. SMB portal = SMB read-only.
Notes: Previewing a draft from the dashboard does not transmit the return — it only builds a draft. Transmission still goes through the scheduled MeF / FSET / state pipelines.
Related: How Payrollix files your taxes · Forms we file automatically · What happens if a return rejects · Amended returns.