---
title: "Dayforce Schema Structure and Field Management"
description: "Dayforce Schema Structure and Field Management"
keywords: "Dayforce Schema Structure and Field Management"
url: "https://myrapidi.com/wiki/dayforce_schema_structure_and_field_management"
locale: "en"
published: "2026-09-04T11:32:12Z"
modified: "2026-09-04T11:32:12Z"
---

## Overview

The Dayforce integration uses a single hosted JSON schema (Dayforce\_full\_schema\_rapidi.json), shared across all REST WebService connections for the tenant. Each top-level definition matches a Dayforce API endpoint name exactly.

The schema currently defines eight objects:  

| Object | Description |
| --- | --- |
| Employees | Employee master data. |
| EmployeePayAdjustments | Employee pay adjustment transactions. |
| LaborMetrics | Labor Metrics item for a Pay Adjustment or Punch. |
| EmployeePunches | Clock-in/clock-out time entries. |
| MealBreaks | Meal break records nested within an Employee Punch. |
| Transfers | Mid-shift department/job/project transfer, nested within an Employee Punch. |
| PunchLaborMetrics | Labor Metrics items attached to an Employee Punch. |
| TransferLaborMetrics | Labor Metrics items attached to a Transfer within an Employee Punch. |

### LaborMetrics

| Field | Type | Description | Example |
| --- | --- | --- | --- |
| LaborMetricsTypeXRefCode | string | External reference code for the Labor Metric type. | JobCode |
| LaborMetricsCodeXRefCode | string | External reference code for the Labor Metric code. | 25-910 |
Each entry in `EmployeePayAdjustments.LaborMetrics` (below) must reference a Labor Metric that already exists in Dayforce, which is why this sync has to run first.

### EmployeePayAdjustments

| Field | Type | Description | Example |
| --- | --- | --- | --- |
| EmployeePayAdjustXRefCode | string | Unique identifier for the record. | EPA123456 |
| EmployeeXRefCode | string | External reference code for the employee. | E0066 |
| OrgUnitXRefCode | string | External reference code for the organizational unit. | NORTHERN\_MAT\_AND\_BRIDGE\_EAST\_LIMITED\_PARTNERSHIP\_TORONTO\_OPERATIONS\_UNION |
| PayAdjustmentCodeXRefCode | string | External reference code for the pay adjustment code. | REG\_ICI |
| PayAdjustmentDate | string (date-time) | Date of the pay adjustment. | 2025-12-10T03:30:00Z |
| Hours | number | Number of hours for the pay adjustment. | 9.0 |
| Amount | number | Amount of the pay adjustment. | 150.5 |
| JobXRefCode | string | External reference code for the job. | JOB001 |
| DepartmentXRefCode | string | External reference code for the department. | DEPT001 |
| PayCategoryXRefCode | string | External reference code for the pay category. | REGULAR |
| ProjectXRefCode | string | External reference code for the project. | PROJ001 |
| DocketXRefCode | string | External reference code for the docket. | NIGHT\_SHIFT |
| Rate | number | Rate associated with the pay adjustment. | 25.5 |
| PayDate | string (date-time) | Pay date for the adjustment. | 2025-12-15T00:00:00Z |
| ManagerAuthorized / EmployeeAuthorized | boolean | Whether the manager/employee has authorized the adjustment. | true |
| AdjustPeriodStartDate / AdjustPeriodEndDate | string (date-time) | Adjustment period bounds. | 2025-12-01T00:00:00Z |
| LaborMetrics | array | Array of LaborMetrics items attached to the adjustment. | array of LaborMetrics objects |
(A few lower-relevance fields, `PieceQuantity`, `IsPremium`, `IsDeleted`, `ReferenceDate`, `EmployeeComment`, `ManagerComment`, exist on this object but aren't central to the current mapping.)

### Employees

| Field | Type | Description | Example |
| --- | --- | --- | --- |
| EmployeeXRefCode | string | External reference code for the employee (unique identifier). | E0066 |
| EmployeeNumber | string | Employment identification number. | 12345 |
| DisplayName / FirstName / LastName | string | Employee name fields. | John Doe |
| HireDate / OriginalHireDate / TerminationDate | string (date-time) | Employment date fields. | 2020-01-15T00:00:00Z |
| EmploymentStatusXRefCode | string | Employment status (Active, Terminated, Leave of Absence, etc.). | ACTIVE |
| OrgUnitXRefCode / DepartmentXRefCode / JobXRefCode / PositionXRefCode | string | Organizational placement. | DEPT001 |
| Email / Phone | string | Contact details. | john.doe@company.com |
| ManagerXRefCode | string | External reference code for the employee's manager. | E0001 |
| IsActive | boolean | Whether the employee is currently active. | true |
(Additional fields covering pay class/group/type, salary/rate, and address are also present, standard employee master-data attributes not called out individually here.)

### Managing the Schema

One schema file covers every endpoint for the tenant. To add or change a field: update the field's definition (name, type, description, example) in the hosted JSON schema, then click **Read Design** on the WebService in Rapidi. No connection changes needed.

### Content

![](/api/4efaf06a-3e45-47b3-aeea-8b14e5fb3960/files/5038ce33-3506-4a06-9460-0e348a6a88c2/preview)

### Dayforce\_full\_schema\_rapidi.json

json

### Dayforce\_Full\_Schema\_Updated.json

json

![](/api/4efaf06a-3e45-47b3-aeea-8b14e5fb3960/files/87a95423-5f12-4c68-ad0e-5b76c374a7e9/preview)