Send Approved Hours to Gusto
Send approved hours, time off, and holiday pay to Gusto, fix what blocks a send, and track its progress.
Send the approved hours, time off, and holiday pay for one pay period to Gusto payroll from the Payroll page. The send needs a connected Gusto account and full access to time tracking (src/routes/dashboard/[id]/time/payroll/+page.server.ts:27-37; src/lib/functions/gusto-payroll.remote.ts:176-177). Gusto processes the payroll itself (src/lib/server/integrations/gusto/handoff.ts:3-5).
Choose a pay period
Each Gusto pay period is sent on its own, so pick the period first.
- On the Payroll page, open the pay period dropdown in the page header.
- Select a pay period.
Each option shows the schedule, the dates, the payroll deadline, and Processed once Gusto has processed it (src/lib/components/time/GustoPayrollPanel.svelte:17-27). The page opens on the nearest unprocessed period whose deadline has not passed (src/routes/dashboard/[id]/time/payroll/+page.server.ts:52-58). The custom range option hides the Gusto panel (src/routes/dashboard/[id]/time/payroll/+page.svelte:22).
Fix blockers before sending
Send to Gusto stays disabled while the panel lists anything that blocks the send (src/lib/components/time/GustoPayrollPanel.svelte:532-556). Each row carries its own fix:
- An open or submitted entry: Approve it in the row, or in Review timesheets (src/lib/server/integrations/gusto/handoff.ts:344; src/lib/components/time/GustoPayrollPanel.svelte:368-383).
- A member with time who is not linked to Gusto: Link opens the people section of Gusto setup (src/lib/components/time/GustoPayrollPanel.svelte:384-397).
- A shift Gusto rejected: the row shows Gusto's reason, and Retry sends that shift again (src/lib/components/time/GustoPayrollPanel.svelte:398-418).
- A time off policy not linked to Gusto: Link policy opens the time off section (src/lib/components/time/GustoPayrollPanel.svelte:419-426).
- Members missing from the Gusto policy their time off uses: Add to policy (src/lib/components/time/GustoPayrollPanel.svelte:427-437).
- A payroll with no holiday pay: Turn on holiday pay in Gusto opens Gusto (src/lib/components/time/GustoPayrollPanel.svelte:438-447).
- A workweek that starts on a different day than in Gusto: Use Gusto's workweek (src/lib/components/time/GustoPayrollPanel.svelte:448-458).
- An employee with time off who is not on this Gusto payroll: Open payroll in Gusto (src/lib/components/time/GustoPayrollPanel.svelte:459-469).
How members ask for time off is covered in Request time off.
Send to Gusto
The send moves the period's approved time into the Gusto payroll. Each workday with paid hours becomes one Gusto time sheet, split into regular and overtime hours (src/lib/time-tracking/gusto-sheet.ts:1-2, 54-56).
- Clear every blocker.
- Select Send to Gusto.
- Follow the steps: Syncing shifts, Syncing payroll, then Writing time off (src/lib/components/time/GustoPayrollPanel.svelte:71-75).
The panel then shows Ready in Gusto. A send keeps running after you leave the page and resumes where it stopped (src/lib/server/integrations/gusto/handoff-runner.ts:1-10). At ready, the period's approved entries for that payroll's employees are locked (src/lib/server/integrations/gusto/handoff-runner.ts:425-430).
Locked time is corrected with an adjustment, which sends that shift to Gusto again (src/lib/functions/time-tracking.remote.ts:613-673). Select Send again to update a ready payroll with the change (src/lib/components/time/GustoPayrollPanel.svelte:532-556).
Note
Sending again replaces the time off JobWise Pro wrote before instead of adding to it (src/lib/server/integrations/gusto/handoff.ts:638-641).
Process the payroll in Gusto
Gusto runs the payroll, so the last step happens there.
- Select Open payroll in Gusto in the Ready in Gusto banner (src/lib/components/time/GustoPayrollPanel.svelte:314-321).
- Review and process the payroll in Gusto.
Once Gusto processes it, the period shows Processed and cannot be sent again (src/lib/server/integrations/gusto/webhooks.ts:380-381; src/lib/server/integrations/gusto/handoff.ts:675-676).
Warning
Time changed after Gusto processes a payroll needs an off-cycle payroll in Gusto. The period then shows Off-cycle needed (src/lib/server/integrations/gusto/push-runner.ts:978-982).
Send automatically before each deadline
Automatic sending sends approved hours for you before each payroll deadline. Turn it on with Send approved hours to Gusto before each payroll deadline in Gusto setup (src/lib/components/gusto/GustoSendingSection.svelte:44-51).
- It sends the next unprocessed payroll of each pay schedule once its deadline is within 24 hours (src/lib/server/integrations/gusto/handoff-runner.ts:13-14, 533).
- A ready payroll is sent again when its time, time off, or holidays changed since the last send (src/lib/server/integrations/gusto/handoff-runner.ts:552-567).
- It does not wait for blockers. Unapproved entries are left out, and a notice about them goes out by email and push (src/lib/server/integrations/gusto/handoff-runner.ts:565-588; src/lib/server/notifications/events.ts:518-536).
- Time before the Sync start date is never sent (src/lib/components/gusto/GustoSendingSection.svelte:53-77).
Entry badges
With Gusto connected, each entry on the timesheets page shows its Gusto state (src/lib/functions/gusto-payroll.remote.ts:220-221).
- Synced: the shift is in Gusto.
- Pending: the entry still needs approval, or it is approved and waiting to sync (src/lib/functions/gusto-payroll.remote.ts:286-289).
- Failed: Gusto rejected the shift, and the reason shows under the entry (src/lib/components/time/TimesheetsBody.svelte:401-403).
- Not linked: the member is not linked to a Gusto person (src/lib/components/time/TimesheetsBody.svelte:120).
Entries before the sync start date, and originals replaced by an adjustment, show no Gusto badge (src/lib/functions/gusto-payroll.remote.ts:267-276).
Send statuses
- Syncing shifts, Syncing payroll, Writing time off: a send is running (src/lib/components/time/GustoPayrollPanel.svelte:332-345).
- Ready in Gusto: hours, time off, and holiday pay are in the payroll and wait for processing in Gusto (src/lib/components/time/GustoPayrollPanel.svelte:314-321).
- Failed: the send stopped on Gusto's error, shown in the banner, and approved time is unchanged. Select Retry (src/lib/components/time/GustoPayrollPanel.svelte:322-328).
- Processed: Gusto processed the payroll (src/lib/components/time/GustoPayrollPanel.svelte:291-292).
- Off-cycle needed: time changed after processing (src/lib/components/time/GustoPayrollPanel.svelte:289-305).
Related Guides
- Configure Time Tracking Settings Set pay, overtime, breaks, time off, and holidays so tracked hours pay out correctly.
- Introduction to Time Tracking Find where clocking, timesheets, time off, availability, and payroll live, and which of them your role can open.
- Clock In and Out Clock in with one tap, change the job the clock picked, switch activities, and submit your day.
Still Need Help?
If an article did not cover it, send us a message and a real person will get back to you.