> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toku.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workday Payroll Sync

> How Toku tracks pay runs and payroll results in Workday

Toku tracks your Workday payroll calendar so the Toku deduction is always applied to the right pay period — and so on-chain delivery lines up with your pay date. Payroll sync uses the **Workday Web Services (WWS)** `Payroll` service, a payroll RaaS report, or both.

## Workday Web Services

The SOAP `Payroll` service is described by a versioned WSDL on your tenant:

```text theme={null}
https://<host>/ccx/service/<tenant>/Payroll/v44.0?wsdl
```

Toku calls the **Get\_Payroll\_Results** operation, which returns payroll results filtered by worker, company, and date range. Requests authenticate with the WS-Security UsernameToken header described in [Authentication](/integrations/workday/authentication). The current WWS directory version is v46.1 — pin the version your tenant supports.

See the [Workday Web Services directory](https://community.workday.com/sites/default/files/file-hosting/productionapi/index.html) and its Payroll service page to validate the operations referenced here.

## Payroll RaaS Report

As an alternative (or supplement), Toku can read a payroll custom report enabled as a web service, using the same URL format as [worker sync](/integrations/workday/employee-sync). A trimmed example response:

```json theme={null}
{
  "Report_Entry": [
    {
      "Employee_ID": "10023",
      "Pay_Group": "US Semi-Monthly",
      "Period_Start_Date": "2026-07-01",
      "Period_End_Date": "2026-07-15",
      "Payment_Date": "2026-07-20",
      "Gross_Amount": "7500.00",
      "Net_Amount": "5480.25",
      "Payroll_Status": "Complete"
    }
  ]
}
```

## What Toku Reads

| Field                        | Purpose                                           |
| ---------------------------- | ------------------------------------------------- |
| `Pay_Group` / period dates   | Determines which elections apply to the run       |
| `Payment_Date`               | Schedules on-chain stablecoin delivery            |
| `Gross_Amount`, `Net_Amount` | Validates the deduction against the worker's pay  |
| `Payroll_Status`             | Confirms the run is finalized before Toku settles |

## Sync Behavior

* Upcoming pay periods appear in the Toku dashboard as soon as they exist in Workday.
* When a run's status flips to complete, Toku reconciles the applied deductions against the results and releases the corresponding stablecoin payments.
* Off-cycle runs are detected and skipped by default (configurable during onboarding).

<Note>
  Payroll sync is read-only. Toku never creates, calculates, or completes pay runs in Workday — your team keeps full control of running payroll.
</Note>

## Next

<CardGroup cols={2}>
  <Card title="The Toku Deduction" icon="money-bill-transfer" href="/integrations/workday/deduction">
    How the deduction is applied as payroll input
  </Card>

  <Card title="Authentication" icon="lock" href="/integrations/workday/authentication">
    ISU credentials and the three auth mechanisms
  </Card>
</CardGroup>