Access setup documents in Zenoti integrated payroll
The Setup Documents area under Employee > Zenoti Integrated Payroll > Documents > Setup Documents is a download library for Zenoti-generated migration templates and historical liability reports. This article walks through what you can download, the format of each file, when it becomes available, and where to upload onboarding documents (which is not this surface).
Audience: Payroll administrators downloading CSV templates for bulk imports, or retrieving the Historical Liability Debit Report after migration.
On this page
- Scope: this is a download surface, not an upload surface
- Before you begin
- What you can download
- Steps: download a setup document
- Where to upload documents during onboarding
- Document formats and limits
- Timeline: when each document becomes available
- Frequently asked questions
- Related articles
Scope: this is a download surface, not an upload surface
The Setup Documents area is download-only. It hosts Zenoti-generated CSV templates and the Historical Liability Debit Report for migrations. It does NOT accept uploads of incorporation certificates, tax forms, signed authorizations, or other onboarding artifacts — those are uploaded or signed during the business-onboarding flow through the embedded Check Technologies components and are not retained as user-accessible downloads here. See Where to upload documents during onboarding below for the upload paths.
Before you begin
- You need the Configure Payroll Payouts permission. The Manage Documents or View Documents permission alone does not grant access to the Setup Documents sub-section.
- Business onboarding must have started; some documents (such as the Historical Liability Debit Report) only appear after the Check Technologies preliminary review completes for migrating businesses.
What you can download
| Document | Format | Purpose | When available |
|---|---|---|---|
| Historical Liability Debit Report | CSV | Previous payroll liability data carried over from your prior provider | After Check Technologies completes the preliminary review (typically 2 business days after migration data upload). The matching Historical Liability Debit is collected by Zenoti 10 days after your first payday with ZIP. |
| Employee setup CSV | CSV (template) | Bulk-import template for adding W-2 employees | Any time after business onboarding starts |
| Contractor setup CSV | CSV (template) | Bulk-import template for adding 1099 contractors | Any time after business onboarding starts |
| Bank account setup CSV | CSV (template) | Bulk-import template for setting employee bank accounts (for direct deposit) | Any time after business onboarding starts |
Each CSV template contains the column headers and a sample row showing the expected format. Edit the file in any spreadsheet application (Excel, Google Sheets, Numbers) and re-import through the corresponding bulk-upload screen during employee onboarding.
Steps: download a setup document
- Sign in to Zenoti and go to Employee > Zenoti Integrated Payroll.
- From the right-side menu, select Filings and Documents.
- Open the Setup Documents sub-section.
- Locate the document in the list.
- Select Download. The file downloads to your browser's default download location.
The download is the file as Zenoti generated it; there are no in-browser previews or edits.
Where to upload documents during onboarding
Onboarding documents (incorporation certificate, tax forms, employee I-9s, bank verification credentials, etc.) are uploaded or signed through the appropriate onboarding step, not under Setup Documents. Each upload destination is specific to its purpose:
| Onboarding artifact | Where you provide it | Notes |
|---|---|---|
| FEIN, legal name, DBA | Business onboarding > Enter business details | Free-text entry |
| Certificate of incorporation | Through the Check Technologies signatory verification step | Embedded upload component |
| Form 8655 (Reporting Agent Authorization) | Settings > Tax setup | Signed in-line through the Check Technologies component |
| State tax IDs and SUI rates | Settings > Tax setup | Per-state entry |
| Bank routing / account number | Settings > Bank account or Business onboarding > Connect bank account | Plaid (instant) or manual micro-deposit |
| Employee Form I-9 / W-4 | Through MyZen self-service onboarding (employee side) or admin-side employee onboarding | See Employee onboarding and tracking |
| Employee bank account for direct deposit | Through MyZen self-service or admin-side bulk upload | See Net pay split |
For the full onboarding workflow, see Business onboarding.
Document formats and limits
CSV templates use UTF-8 encoding with comma delimiters and standard double-quote escaping. Headers in row 1 must not be modified — adding, removing, or renaming columns will cause the import to fail with a header-mismatch error.
Each CSV upload supports up to 2,000 employees per file (matching the per-FEIN worker limit). For larger imports, split into multiple files of 2,000 rows or fewer.
Tax-document downloads (W-2s, 1099s) under the Tax Documents sub-section are PDF format. Authorization-form downloads under the Authorization Forms sub-section are PDF format. Setup Documents are CSV-only.
Timeline: when each document becomes available
| Document | Available after |
|---|---|
| Employee setup CSV (template) | Business onboarding initiated |
| Contractor setup CSV (template) | Business onboarding initiated |
| Bank account setup CSV (template) | Business onboarding initiated |
| Historical Liability Debit Report | Preliminary review completes (typically 2 business days after migration data upload, per Preliminary review for Zenoti integrated payroll setup) |
| W-2 / 1099 (Tax Documents sub-section) | Generated annually after the close of the tax year; specific availability follows the IRS filing calendar |
| Form 8655 signed copy (Authorization Forms sub-section) | Available immediately after signatory completes signing |
If a document you expect is not present, confirm:
- The triggering event has occurred (e.g., preliminary review completed for the Historical Liability Debit Report).
- Your user has the
Configure Payroll Payoutspermission. - The business filter is set to the correct business entity if your organization has multiple FEINs.
If the document is still missing after the expected time, contact support@zenoti.com with your business name, FEIN, and the document name.
Tips
- Bookmark the Setup Documents sub-section URL after first access so you can jump there directly when you need a CSV template.
- Keep the original CSV templates as a reference; download them once and re-use them, only modifying the data rows.
- For bulk imports, do a small test (10–20 rows) first to confirm the format is accepted before uploading 1,000+ rows.
- Treat populated CSVs (after you add employee or bank data) as sensitive — they contain PII. Delete them from your local machine after import.
- Note the difference between Setup Documents (downloads only), Tax Documents (W-2 / 1099 PDFs), and Authorization Forms (Form 8655 + state authorizations) — three sub-sections with different content types.
Troubleshooting
Quick reference for common Setup Documents issues:
- Sub-section is not visible. Confirm
Configure Payroll Payoutspermission. - Historical Liability Debit Report is missing. Available only after preliminary review completes (2 business days).
- CSV import header-mismatch error. Re-download the original template; row 1 must match exactly.
- Empty CSV template. That's correct — templates are header-only; add data starting on row 2.
- Looking for an upload destination. Setup Documents is download-only; uploads happen during onboarding.
| Problem | Resolution |
|---|---|
| Setup Documents sub-section is not visible | Confirm you have Configure Payroll Payouts. The Manage Documents permission alone is not enough. |
| Historical Liability Debit Report is missing | Available only after Check Technologies completes the preliminary review (typically 2 business days after migration data upload). If past 2 business days, contact support@zenoti.com. |
| CSV import fails with "header mismatch" | Re-download the original template; the headers in row 1 must match exactly. Do not rename, add, or remove columns. |
| CSV template downloads as 0 rows | That's correct — the template is header-only. Add your data starting on row 2. |
| Bulk import larger than 2,000 rows fails | The per-FEIN worker limit is 2,000. Split into multiple files. |
| Can't find an upload destination for incorporation documents | Setup Documents is download-only. See Where to upload documents during onboarding for the upload paths. |
Frequently asked questions
Can I upload my incorporation certificate here? No. Incorporation documents are uploaded during the Check Technologies signatory verification step in business onboarding, not under Setup Documents. See Business onboarding.
The CSV template I downloaded has 0 rows. Is that correct? Yes — the template is a header-only file. Add your employee or bank-account data starting on row 2 and re-import through the corresponding bulk-upload screen.
Can I rename the columns in the CSV before importing? No. The header row in row 1 must match the original template exactly. Header drift causes the import to fail with a header-mismatch error.
The Historical Liability Debit Report isn't there.
The report only appears after the Check Technologies preliminary review completes. If it has been more than 2 business days since you uploaded migration data and the report still hasn't appeared, contact support@zenoti.com.
What's the file size limit? Templates and individual download files are typically under 1 MB. The largest typical file is the Historical Liability Debit Report, which scales with the number of historical pay periods uploaded. There is no per-download size cap from Zenoti's side.
Are downloads encrypted? Files transit over HTTPS. Tax documents (W-2, 1099) and authorization forms contain personally identifiable information and tax data; treat them as sensitive on your local machine. The Setup Documents CSV templates contain no PII (they are blank templates) and are not sensitive at download time, though the populated versions you re-upload during bulk import will contain employee PII and should be handled accordingly.