This document describes the most common integration tasks between WorkforceHub (WFH) and an external Payroll system. This document does not cover the full capabilities of the WFH API. The full WFH API reference can be found here: https://api.workforcehub.com/swagger
- Introduction
- Overview
- Integration Ideas
- Sample Integration
- System of Record
- Vendor Roles Versus Partner Roles
- API Endpoint Call Requirements
- Example Code
- Authentication
- Authentication Using a JWT Token
- Generating a JWT Token
- Creating a JWT Header & Signature
- Calling the JWT Authorization API
- Calling the Authentication Service
- Companies
- Setting Up a Company for an Integration
- Working with Companies
- Working with Punch Categories
- Working with Roles
- Employees
- Working With Employees
- Creating Employees
- Retrieving Employee Data from WFH
- Working with Employee Date-effective Historical Information
- Employee Self-Service (ESS) Updates
- Processing ESS Updates
- Acknowledging Pending Changes
- Getting ESS Change Request Data
- Handling New Hire Round-Tripping
- Marital Status Codes and Names for State Tax Information in New Hire Shape
- Payroll
- Sending Time Data to Payroll
- Working with Payroll Formats
- Uploading Payroll Documents
- Reprocessing and Deleting Payroll Documents
- Deleting Payroll Document Batches
- Accruals
- Accruals Overview
- Retrieving Accrual Data from WFH
- Sending Accrual Data from the Payroll System to WFH
- Single Sign-on
- Overview
- SSO for Employees
- Embedded WFH Employee Components
- Web Clock
- Time-off Request
- Schedule
- Timecard
- Embedded WFH Manager Components
- Time-off Request
- Schedule
- Timecard