Ceridian Dayforce

Pre-Requisite

In order to access the Ceridian API and extract changes from the platform, you will need the following information handy:

  • Company Id: The Company ID registered with Ceridian Dayforce
  • Service User Id: The userId used for accessing the REST API
  • Service Password: The password used for accessing the REST API

Connection String

Once you have configured your Ceridian Dayforce platform to access REST calls using a service User ID and Password, you can create a Central Connection String in DataZen. DataZen can help you obtain an initial OAuth Bearer Token that will work with Ceridian Dayforce; this token will automatically be refreshed whenever necessary.

  • In DataZen, choose Configuration -> New Connection -> HTTP/S Endpoint -> Ceridian Dayforce Connection
  • Enter a friendly name for the connection, and specify this HTTP Endpoint URI: https://www.dayforcehcm.com
  • Replace the {server_name} and {company_id} from the HTTP Endpoint URL
  • Click on the Obtain OAuth Token... link
  • Enter your Company ID in the "Client ID" field, then click Next
  • Enter your service userId and password in the corresponding fields
  • Click on Get Bearer Token; the Token will be automatically filled out
  • Click OK
  • Back in the Connection String screen, specify a Call Rate Limit if desired; this is important to avoid throttling by the service. Keep in mind that the {CeridianDayforce} rate limit defined here may compete with other services in your company. You can start with a lower number, such as 10 calls per minute.
  • Click OK to create/update the Connection String

Get Employee IDs

You can create a Job Reader that returns all available Employee IDs (XRefCode) from {CeridianDayforce}. If you would like to implement a Change Data Capture job to just fetch the XRefCode IDs for employee records that were modified, please contact Enzo support as this may require creating multiple jobs due to the API specification of Ceridian Dayforce.

  • In DataZen, select an Agent, and choose New -> Data Sync...
  • Select the connection previously created for your Source Connection
  • Choose a Quick Setup option to assist with configuration (for example, select Ceridian Dayforce Get All Employees XRefs)
  • Modify the URL as needed (the URL may contain a {CompanyId} parameter that should be replaced with your Company Id) Selecting Ceridian Dayforce Get Employees XRefs With Data Changes From Last Call requires additional setup not discussed here
  • Modify the Max Rows value if desired
  • Click the preview link