Purpose
UZIO has no accounting module, but it produces the general ledger entries your accounting platform needs after each payroll: a real-time sync to QuickBooks Online, an .IIF file for QuickBooks Desktop or Enterprise, a .CSV file for Xero, and an Excel General Ledger report for any other platform. This article covers the one-time setup (file structure and chart-of-accounts mapping), how to get the entries after each payroll, what the file leaves out, and how to fix an unbalanced ledger.
Who can do this: Any user whose role includes the Payroll permission. This is usually the Employer Admin, but other admin roles can be granted the same access. Most companies do the mapping together with their bookkeeper.
Prerequisites
- Your chart of accounts from your accounting platform. Account numbers must match exactly.
- A working knowledge of debits and credits. See Understanding Payroll Accounting.
- If you use QuickBooks Online, connect it first; the connection and its own mapping screens are covered in Connecting QuickBooks Online and QuickBooks Online: Mapping Your Chart of Accounts. This article covers the file-based General Ledger used for QuickBooks Desktop, Xero, and other platforms.
Setup: two steps
Open the General Ledger page in the Payroll module.
Step 1: File Setup
| Field | What it controls |
|---|---|
| File Group | Whether the file carries groups (Classes in QuickBooks, Tracking Categories in Xero). Group by Department, Division, Work Location State, or Work Location to track balances by that dimension. None means no groups. |
| Account Code Group | Whether your chart of accounts differs by group. Choose Department, Division, Work Location State, or Work Location if you keep separate expense accounts per group. None uses one account code per pay type for everyone. |
Warning: If you group by Department or Division, the screen warns: "Please ensure your employees are assigned to a Department, else they will be excluded from the GL file." Assign every employee before generating a file.
Step 2: Chart of Accounts mapping
Click Add Account once per account and map it to payroll components.
| Field | Notes |
|---|---|
| Account Type | Debit (Expense) or Credit (Liability or Cash). See the classification table in Understanding Payroll Accounting. |
| Account Number | Must match your accounting platform exactly (for example, 24001). Up to 12 characters; cannot contain \, ", <, or >. For sub-accounts, enter the full sub-account number (for example, 50000-01 for Regular Wage under Payroll Wages 50000). |
| Account Name | For your reference only; not written to the file. Up to 20 characters, same character rules. Keep it identical to the name in your accounting software. |
| Account Group / File Group | Appear only if you chose a grouping in Step 1. Pick one or more departments, divisions, or locations, or ALL. Mapping an account to ALL prompts: "You have mapped this account to all File Groups. Do you want a separate entry of this account for each file group?" Yes writes one line per group; No writes one consolidated line. |
| Pay Type | The payroll component: Earnings, Deductions, Contributions, Taxes, Workers' Comp, Employee or Contractor Direct Deposit Net Pay, Employee or Contractor Check Net Pay, or Contractor 1099 Earnings. Map every component your company uses. |
Pay type specifics:
- Earnings, Deductions, Contributions show a grid of your company items. Select one or more to map to the account. Mapping ALL items means items you add later are picked up automatically. Mapping items individually means every new item must be mapped by hand or it is missing from the file.
- Taxes asks for a Tax Type: Federal or State. Federal shows a grid of federal taxes. State shows a multi-select of your states, then that state's tax categories (for example, EIT and LST in Pennsylvania). Mapping a category maps all taxes in it. Only taxes actually processed in payroll land in the file, so mapping unused categories is harmless.
- Contractor pay types (Contractor 1099 Earnings, Contractor Check Net Pay, Contractor Direct Deposit Net Pay) ignore grouping. The form explains: "This pay type is specific to contractors, hence grouping is not applicable on this account as system does not allow grouping of contractors."
- The same account number can be used more than once as long as the combination of account type, number, pay type (and tax type and state) is unique. You cannot create two accounts for the same pay type; map several items to one account instead.
- Federal and state taxes cannot be mapped to the same account. Two separate accounts may share a number.
Deleting an account. The confirmation reads: "If you proceed further, the account will be deleted permanently and will not be considered in future general ledger files." Files already downloaded are unaffected.
Getting the entries after each payroll
File-based platforms. After a payroll is approved, generate the General Ledger report from Payroll Reports as an .IIF (QuickBooks Desktop or Enterprise), a .CSV (Xero), or the Excel report, which has a General Ledger - Summary sheet and a General Ledger - Details sheet. One file can cover several payrolls, including contractor payrolls if you mapped the contractor pay types.
Note: The .IIF imports only into QuickBooks Desktop or Enterprise, not QuickBooks Online. The .CSV imports only into Xero. For any other platform, use the Excel report to create the journal entries manually.
QuickBooks Online. No file is needed. Approving a payroll creates a journal entry in QBO automatically (or on demand, depending on the sync mode you chose). A Resync to QuickBooks Online button on the payroll's summary screen re-sends the entry, for example after fixing a mapping error. Every resync creates a new journal entry, so reverse the superseded one in QBO. Details, error messages, and the sync-status column in Payroll History: QuickBooks Online: Syncing Payrolls and Troubleshooting.
What the file does not contain
- Workers' compensation premiums. UZIO does not calculate them in payroll. Record them from the Workers' Compensation Wages Report. See Setting Up Workers' Compensation Codes.
- Cash payments made outside UZIO Payroll.
- Contractor payments unless you mapped the three contractor pay types.
Keeping the ledger in step with payroll changes
- A new earning, deduction, or contribution. Unless you mapped ALL items for that pay type, come back here and map the new item before the next file. Otherwise the file is short and out of balance. See Setting Up Company Level Earnings and Setting Up Company Level Deductions.
- A new state. Map the new state's tax categories under the Taxes pay type.
- A voided payroll. UZIO creates a reversing Void payroll. With QuickBooks Online connected, a reversing journal entry syncs automatically. For file-based platforms, include the Void payroll when you generate the file for that period, and correct the expense side manually as the void confirmation instructs. See Reviewing Past Payrolls and Requesting a Void (Payroll History).
Troubleshooting: unbalanced GL
An unbalanced file almost always means a mapping problem:
- A component processed in payroll is not mapped to any account.
- A component is mapped to a debit account but has no matching credit, or the reverse.
- A component is mapped to two debit or two credit accounts and double-counted.
- You group by Department or Division and some employees have no department or division assigned.
Common mistake: Adding a new earning, deduction, or contribution and forgetting the General Ledger. Unless you mapped ALL items in the grid, the new item is missing from the next file.
Related articles
- Understanding Payroll Accounting
- Connecting QuickBooks Online
- QuickBooks Online: Mapping Your Chart of Accounts
- QuickBooks Online: Syncing Payrolls and Troubleshooting
- Understanding the UZIO Tax Payment Process
- Reviewing Past Payrolls and Requesting a Void (Payroll History): QBO sync status column, and what a void does to the ledger
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article