Workday Payroll Config

You are a Workday payroll administrator. The user wants to configure pay components, earning codes, deduction codes, and payroll calendars in Workday to establish the foundation for accurate payroll processing.

What to check first

• Verify you have Payroll Administrator or System Administrator role in Workday
• Run a report on existing pay components via Report Center > Payroll > Pay Component Report to see current setup
• Check Configure Payroll System task to confirm which payroll entities (companies, cost centers) require configuration

Steps

1. Navigate to Payroll > Setup and verify your payroll country version matches your organization (e.g., USA, Canada, Australia)
2. Create earning codes in Payroll > Earnings > Earnings Codes — set the Earnings Code, Description, Earnings Type (Regular, Bonus, Commission), and Pay Component reference
3. Define deduction codes in Payroll > Deductions > Deduction Codes — assign Deduction Code, Description, Deduction Type (Tax, Benefit, Garnishment), and link to the appropriate Earning Code for proration rules
4. Create or modify pay components in Payroll > Pay Components > Maintain Pay Component — define the component name, category (Earnings, Deduction, Tax), calculation method (Fixed Amount, Percentage of Earnings), and priority order for stacking rules
5. Set up Pay Calculation Rules for each component by navigating to Payroll > Pay Calculation Rules — configure conditions (e.g., "if salary > $50,000, apply premium deduction") and sequence order
6. Configure payroll calendar in Time and Payroll > Calendar Setup > Payroll Calendars — select calendar type (Weekly, Bi-weekly, Monthly, Semi-monthly), set pay periods, and define pay date offsets from period end date
7. Attach the payroll calendar to companies in Payroll > Payroll Definition > Company Assignment — link each company to its corresponding payroll calendar and pay group
8. Create or update pay groups in Payroll > Pay Groups — assign pay frequency, tax setup, garnishment rules, and associate with the payroll calendar

Code

<!-- Workday Integration: Payroll Config via API -->
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:pay="urn:com.workday/bsvc">
    <soap:Body>
        <!-- Create Earning Code -->
        <pay:Put_Earning_Code_Request>
            <pay:Earning_Code_Data>
                <pay:Earning_Code>BONUS_CODE</pay:Earning_Code>
                <pay:Earnings_Code_Name>Annual Bonus</pay:

Note: this example was truncated in the source. See the GitHub repo for the latest full version.

Common Pitfalls

• Treating this skill as a one-shot solution — most workflows need iteration and verification
• Skipping the verification steps — you don't know it worked until you measure
• Applying this skill without understanding the underlying problem — read the related docs first

When NOT to Use This Skill

• When a simpler manual approach would take less than 10 minutes
• On critical production systems without testing in staging first
• When you don't have permission or authorization to make these changes

How to Verify It Worked

• Run the verification steps documented above
• Compare the output against your expected baseline
• Check logs for any warnings or errors — silent failures are the worst kind

Production Considerations

• Test in staging before deploying to production
• Have a rollback plan — every change should be reversible
• Monitor the affected systems for at least 24 hours after the change