ZenotiHelp

Tax filings in the ZIP Dashboard

ZTZenoti Docs Team Updated October 17, 2026 8 min readGuide

Monitor the lifecycle of every tax filing Zenoti Integrated Payroll (ZIP) submits on your behalf — from queueing for the agency deadline through final acceptance — in the Filings and Documents section of the ZIP Dashboard. Tax filings cover all 50 U.S. states plus the District of Columbia.

Audience: Payroll administrators and business owners who monitor tax compliance for their organization.


On this page


Before you begin

  • ZIP must be enabled for your organization by Zenoti's implementation team after enrollment and go-live.
  • You need the Configure Payroll Payouts permission (under Administrator > Payments in your security role).
  • At least one payroll must have been processed before tax filings appear in the dashboard.

Permission: Configure Payroll Payouts — Required to view and manage tax filings, deposits, and authorization documents in the ZIP Dashboard. Admin path: Configuration > Security > Security roles > [your role] > Administrator > Payments > Configure Payroll Payouts

How this view differs from Tax Deposits, Filings and Documents

This article covers the Filings and Documents section at Employee > Zenoti Integrated Payroll — the per-filing list view where you drill into a single tax form's status and any blocking reason codes. The umbrella surface at ZIP dashboard > Tax Deposits (Manage tax deposits, filings, and documents) aggregates this filings view with a parallel deposits sub-tab and the documents sub-tab. Use the umbrella when you need to track the dollars (deposits) and the form copies (documents) alongside the filings; use the Filings and Documents section when you need filing-level detail.

Tax filing statuses

Each filing carries one of six lifecycle statuses sourced from the Check Technologies engine, plus a UI-derived Not Applicable state for filings your business is not liable for in the period.

The following table lists all supported statuses. No other statuses exist.

Status Meaning Corrective action
Pending Filing is queued for the upcoming agency deadline. None — the system files automatically on schedule.
Submitted Filing has been transmitted to the tax agency; awaiting agency confirmation. None — wait for agency confirmation.
Filed Filing has been accepted by the tax agency. None.
Rejected Filing was declined by the tax agency. Review the rejection details, correct the underlying issue, and resubmit per agency guidance.
Amendment required Filing was accepted but requires correction — for example, an off-cycle reclass or retroactive change. Run the corrective adjustment in ZIP; the system re-files automatically.
Blocked A pre-filing prerequisite is missing; the agency was not contacted. Resolve the underlying reason code (see Resolve blocked filings below); the system retries automatically once the block clears.
Not Applicable Your business is not liable for this filing in this period — for example, no regular employees in a given state. None.

Email notifications are sent to signatories and the company email address whenever a filing status changes.

Resolve blocked filings

When a filing is blocked, the dashboard displays one of 17 reason codes. Resolve the underlying issue and the system automatically reattempts the filing. The following table lists all supported reason codes. No other reason codes exist.

Reason code What it means How to resolve
already_filed Agency already received this filing from a prior provider. No action required.
applied_for_tax_id Tax ID application is in flight; the agency has not yet issued the ID. Wait for the agency to issue the ID; the filing retries automatically.
company_bad_standing Business is in bad standing with the agency. Resolve standing directly with the agency.
held_by_customer Filing is held at customer request. Release the hold from the dashboard.
inactive_account Agency account is inactive. Reactivate with the agency.
incorrect_account_setup Account configuration mismatch. Verify setup by contacting support@zenoti.com (include your business name and FEIN in the subject line).
invalid_ssn One or more employee SSNs failed validation. Correct the SSN in the affected employee records.
invalid_tax_id Tax ID failed validation. Correct the tax ID in business setup.
invalid_tax_rate SUTA rate is invalid for the jurisdiction. Update the rate via state tax-rate settings (see Update your unemployment tax rate).
late_company_reactivation Company reactivated after the filing deadline. Contact support@zenoti.com (include your business name and FEIN in the subject line).
missing_historical_data Prior-period data is missing for migrated companies. Complete Historical Tax Liability setup.
missing_prior_quarter Prior-quarter filing has not yet been completed. Complete the prior-quarter filing first; the blocked filing retries automatically.
not_liable Business is not liable for this filing. No action required; the system marks the filing as Not Applicable on the next processing sweep.
poa_failure Power-of-attorney form is not on file or was rejected by the agency. Re-sign the authorization form via the Authorization Documents tab (see Manage tax filing authorization documents).
previous_filing_in_progress An earlier filing for the same jurisdiction has not yet completed. Wait for the earlier filing to finish; the blocked filing retries automatically.
tpa_failure Third-party administrator authorization failed. Resolve the TPA authorization with the agency.
missing_tax_funds Insufficient funds were debited to cover the deposit. Resolve via funding settings or contact support@zenoti.com (include your business name and FEIN in the subject line).

View tax filings

  1. Navigate to Employee > Zenoti Integrated Payroll.
  2. In the right-side menu, select Filings and Documents.
  3. Review filing statuses by form type and jurisdiction.
  4. For a blocked filing, select the reason code to see resolution details.

Note: Federal forms filed automatically include Forms 940, 941, 943, and 944. State forms are filed automatically for all applicable jurisdictions across all 50 U.S. states and the District of Columbia. Tax documents for filed forms become available within two weeks after quarter or year end. Only ZIP-filed documents are shown; documents filed by prior providers are not displayed.

Update your unemployment tax rate

ZIP uses your state unemployment tax (SUTA) rate when calculating employer tax obligations. If the rate changes — for example, at the start of a new calendar year — update it before the next payroll run. Changes apply to future pay runs only; they do not retroactively affect processed payroll.

  1. Navigate to Employee > Zenoti Integrated Payroll.
  2. In the right-side menu, select Settings, then select Review setup.
  3. Under Tax Settings, select the applicable state tax type.
  4. In the Unemployment Tax Rate field, enter the new rate for the applicable year.
  5. Select Input additional value if you need to record a rate for an additional year.
  6. Save your changes.

Note: The updated rate applies to future pay runs only. Previously processed payroll is not affected.

Worked example: Your organization operates in California. The state issues a new SUTA rate of 3.4% effective January 1. Before running the first payroll of the new year, navigate to Employee > Zenoti Integrated Payroll > Settings > Review setup > Tax Settings, select the California unemployment tax type, enter 3.4 in the Unemployment Tax Rate field for the new year, and save. The updated rate is applied starting with the next payroll run.

Manage tax filing authorization documents

ZIP files federal and state taxes on your behalf under a power-of-attorney (POA) arrangement. The primary federal authorization document is Form 8655. If an authorization expires, is rejected by the agency, or needs to be updated for a new signatory, the signatory must regenerate and re-sign the relevant form.

  1. Navigate to Employee > Zenoti Integrated Payroll.
  2. In the right-side menu, select Settings.
  3. Select View Details, then select the Authorization Documents tab.
  4. Locate the federal or state-specific POA form that requires action.
  5. Select the option to regenerate the form, then sign and submit it.

Note: If a filing is blocked with the reason code poa_failure, re-signing the authorization form for the affected jurisdiction resolves the block. The system reattempts the filing automatically after the form is accepted.

Tips

  • Check filing status after every payroll approval. Tax deposits are created within 24 hours of payroll approval. Review the Filings and Documents section shortly after approval to confirm filings move to Pending or Submitted status.
  • Update your SUTA rate before January payroll. States commonly issue updated unemployment tax rates at the start of each calendar year. Entering the new rate before your first pay run of the year prevents an invalid_tax_rate block.
  • Keep authorization documents current. If your signatory changes or a POA form expires, re-sign through the Authorization Documents tab before your next filing deadline. Outdated authorization is one of the most common causes of poa_failure blocks.
  • Include your business name and FEIN in support emails. When contacting support@zenoti.com for issues such as incorrect_account_setup or late_company_reactivation, including these details in the subject line speeds resolution.
  • Blocked filings retry automatically. You do not need to manually resubmit after resolving a blocked reason code. Once the condition is cleared, the system reattempts the filing on the next processing sweep.

Troubleshooting

A filing has shown Blocked status for several days after I resolved the issue.

The system retries blocked filings automatically after the blocking condition is resolved. If the filing has not moved out of Blocked status within two business days of your correction, contact support@zenoti.com with your business name and FEIN to request a manual retry review.

A filing shows Rejected and I am not sure what to correct.

Select the filing in the Filings and Documents view to review rejection details. The rejection reason from the tax agency is displayed alongside the status. Correct the specific issue described — for example, a mismatched tax ID or an invalid rate — then save the correction. The system re-files automatically. If the rejection reason is unclear, contact support@zenoti.com (include your business name and FEIN in the subject line).

A filing shows Amendment required but I have not made any changes.

An Amendment required status can result from retroactive payroll corrections, off-cycle reclassifications, or agency-initiated adjustments. Run any corrective adjustment in ZIP and the system re-files the amended form automatically. If no correction appears to be needed and the status persists, contact support@zenoti.com for assistance.

The Filings and Documents section shows no filings.

Filings appear only after at least one payroll has been processed and the filing period has opened. If payroll has been processed and filings are still absent, verify that your business onboarding status shows Ready to run and that your tax setup is complete under Settings > Review setup > Tax Settings. Contact support@zenoti.com if the issue persists.

A state filing shows Not Applicable but I believe the business has employees in that state.

Not Applicable indicates that, based on the information in ZIP, your business has no liability for that filing in the period. Verify that all employees working in the state have the correct work-location assignment in their employee records. If the assignment is correct and the status persists, contact support@zenoti.com (include your business name and FEIN in the subject line).

Was this article helpful?
Your feedback helps us improve our documentation.