> 持续流程改进 > 薪资处理 > Ceridian Dayforce > 数据模板

您的工资处理数据模板

Ceridian Dayforce

← 返回改进指南

薪资处理属性 (17) 薪资处理活动 (15) 数据提取指南 (2)

您的工资处理数据模板

此模板为您在Ceridian Dayforce中梳理工资处理生命周期提供完整框架，列出构建高质量事件日志所需的关键数据字段和流程里程碑。遵循这些指南，您可以全面了解工资发放工作流，并精准定位运营改进机会。

建议收集的属性
需要跟踪的关键活动
系统专属提取指南

刚接触事件日志？了解如何创建流程挖掘事件日志.

下载模板

薪资处理属性

以下推荐数据字段可从Ceridian Dayforce中提取关键业务背景和系统详情，为流程分析奠定坚实基础。

5 必需 5 建议 7 可选

	名称	说明
	时间戳 EventDateTime	活动发生的具体日期和时间。
说明标记Dayforce系统中事件发生时刻的精确时间戳。它用于按时间顺序排列活动，并计算步骤之间的时长。准确的时间戳对于识别瓶颈至关重要，例如“工时表已批准”或“银行转账文件已生成”环节的延迟。理想精度应达到秒或分钟。为什么重要它提供流程挖掘所需的时间维度，从而支持绩效分析和瓶颈识别。获取位置审计表中的交易时间戳列，例如CreatedDateTime、LastModifiedDateTime。示例 2023-10-12T08:30:00Z2023-10-12T14:15:22Z2023-10-15T09:00:00Z
	活动 ActivityName	所执行流程步骤或事件的名称。
说明此属性表示薪资周期中发生的具体事件。Dayforce中的标准活动包括“工时表已提交”“应发工资已计算”“薪资已提交”“支付已执行”和“税务申报已完成”。这些值通常提取自工作流审计日志、系统交易日志，例如Payroll Status变更，或与Pay Run、Time Sheet等业务对象关联的时间戳。为什么重要它定义流程步骤，对于重建流程顺序和分析流程变体至关重要。获取位置工作流日志、Audit Trail或状态变更历史表。示例工时表已提交总工资已计算付款已执行已执行数据更正审计例外已标记
	薪资记录 PayrollRecordId	薪资案例的唯一标识符，由员工和薪资周期组合而成。
说明此属性是流程的唯一Case ID。在Ceridian Dayforce中，薪资记录在概念上是特定员工与特定薪资周期的交集，通常定义在Pay Group中。它记录该员工在该周期内的薪酬处理生命周期。从技术上看，该标识通常由Pay Period ID与Employee XRefCode或System ID拼接而成，关联从初始工时表提交到最终税务申报和工资单生成的所有活动。为什么重要它标识流程挖掘分析的核心对象，使所有事件能够归入一条端到端执行路径。获取位置由Payroll Result或Time Entry表中的PayPeriodID和EmployeeID组合生成。示例 PG01-2023-10-EMP10234US_SAL-2023-22-EMP88421UK_HRLY-2023-44-EMP00231
	最近数据更新时间 LastDataUpdate	从源系统提取数据时的时间戳。
说明表示用于分析的数据新鲜度。通常指从Dayforce提取数据的ETL运行时间戳。它帮助分析人员判断当前查看的是实时数据，还是前一天的快照。为什么重要它确定数据集的时效性，并帮助根据源系统报告验证数据完整性。获取位置脚本执行时的系统时间。示例 2023-11-01T00:00:00Z2023-11-02T12:00:00Z
	源系统 SourceSystem	数据来源系统的名称。
说明标识提取薪资数据的软件或数据库。在此场景中，该值通常为“Ceridian Dayforce”或“Dayforce”。当合并多个系统的数据时，例如外部考勤系统向Dayforce提供数据，该属性有助于追踪数据血缘。为什么重要它确保数据可追溯，并支持多系统流程挖掘场景中的筛选。获取位置在提取过程中硬编码，或根据连接元数据生成。示例 Ceridian DayforceDayforce生产环境Dayforce欧盟
	SLA处理截止时间 SlaProcessingDeadline	银行文件生成必须完成的时间戳。
说明为确保员工按时收到薪资，“银行转账文件已生成”活动必须完成的内部或外部截止时间。该属性用于“银行转账截止时间合规”仪表板。此属性可以是基于发薪日的固定规则，例如发薪日前2天，也可以是Pay Group设置中的配置字段。为什么重要它是计算按时完成率和合规风险的基准。获取位置根据发薪日和银行处理规则配置生成。示例 2023-10-25T14:00:00Z2023-10-26T10:00:00Z
	应发工资金额 GrossPayAmount	该记录计算出的应发工资。
说明扣除项和税费之前的总薪酬金额。该值在“应发工资已计算”活动期间生成。分析应发工资处理时长的差异，有助于识别拖慢“计算引擎流程速度”仪表板的复杂计算。为什么重要它为流程提供财务背景，并支持比较高价值与低价值记录的处理情况。获取位置 Payroll Result或Pay Run Details表。示例 2500.004150.501200.00
	操作用户 ActionUser	执行特定活动的用户。
说明标识事件负责人，例如批准工时表的经理或提交薪资批次的薪资专员。这些数据对于“薪资专员生产力”视图以及识别经理培训需求非常重要。为什么重要它支持流程中的资源分析和责任追踪。获取位置审计日志、交易表中的User ID列。示例 jsmith系统管理员mgarcia_mgr
	薪资组 PayGroupName	用于薪资处理的员工分组。
说明将按相同计划一起发薪的员工归为一组，例如“美国双周薪”和“英国月薪”。在Dayforce中，Pay Group是薪资批次的主要组织单元。此属性对于“端到端薪资周期时长”仪表板至关重要，因为不同薪资组的周期时长和截止时间通常不同。为什么重要它是衡量薪资绩效和识别特定群组问题的主要分组维度。获取位置 PayGroup表或PayRun定义。示例美国企业 salaried员工加拿大零售小时工英国高管月薪
	部门 DepartmentName	员工所属的组织单元。
说明表示与薪资记录关联的职能部门，例如销售、IT、人力资源。在Dayforce中，它通常关联“Org Unit”或“Department”层级。此字段驱动“工时表审批绩效”仪表板，支持下钻到经理可能延迟审批的具体业务领域。为什么重要它支持组织级基准比较和审批延迟的根因分析。获取位置员工记录或组织单元层级。示例财务供应链物流北美销售
	成本中心 CostCenterCode	计入薪资费用的财务代码。
说明与员工收入关联的总账成本中心。该属性用于“成本中心处理基准”视图，比较不同财务单元的处理效率。在Dayforce中，它属于总账（GL）分摊明细。为什么重要它将流程绩效与财务报告结构关联起来。获取位置员工GL设置或Labor Distribution表。示例 CC-1020CC-5500-USCC-IT-OPS
	是否存在审计异常 IsAuditExceptionFlagged	表示该记录是否触发审计警告的布尔标志。
说明用于表示该案例是否发生“审计异常已标记”活动的计算或直接标志。它驱动“审计异常标记率”KPI。异常率较高通常表明数据质量存在问题，或Dayforce合规引擎的配置过于严格。为什么重要它简化错误率和返工循环的计算。获取位置根据是否存在“审计异常已标记”活动生成。示例 truefalse
	更正原因 CorrectionReason	数据更正所使用的原因代码。
说明如果发生“已执行数据更正”活动，此属性记录登记的原因，例如“漏打卡”“追溯性薪资调整”。它为“手动更正与返工率”仪表板提供详细信息，帮助团队解决手动工作的具体根因。为什么重要它是返工根因分析的基础。获取位置审计日志明细或更正交易中的备注字段。示例漏打卡费率错误追溯调整
	税务管辖区 TaxJurisdiction	负责税务申报的地区或机构。
说明标识与薪资记录相关的具体税务机关，例如州、省或国家。支持“税务申报与合规监控”仪表板。它支持对薪资后合规流程进行分组，突出显示经常出现申报延迟的管辖区。为什么重要它支持合规监控和流程绩效的地理分析。获取位置员工税务设置或Payroll Result Tax明细。示例加利福尼亚州安大略省纽约州英国
	薪资周期 PayPeriodDescription	薪资周期的描述性名称。
说明薪资周期的易读标签，例如“2023年第42周”“2023年10月半月薪”。它有助于在仪表板中进行筛选和可视化。它为“薪资记录”提供背景信息，通常显示在“流程变体路径分析”中，用于筛选特定批次。为什么重要它让业务用户更容易理解数据。获取位置 PayPeriod表的描述列。示例 2023-W422023-Oct-SM12023-M11
	银行转账是否延迟 IsBankTransferLate	表示银行文件是否错过截止时间的标志。
说明通过比较“银行转账文件已生成”的时间戳与“SLA处理截止时间”计算得出的布尔值。它驱动“银行转账按时完成率”KPI。识别延迟转账对于避免员工延迟收款至关重要。为什么重要它是衡量合规性和可靠性的关键指标。获取位置计算方式：BankTransferTime > SlaProcessingDeadline。示例 truefalse
	雇佣类型 EmploymentType	员工分类，包括全职、兼职和合同工。
说明对员工的工作关系进行分类。用于基准比较，判断合同工或兼职员工是否具有不同的薪资处理特征或错误率。在Dayforce中，该属性通常位于Employee记录中。为什么重要它支持分组分析和处理统计数据的公平比较。获取位置 Employee表。示例全职兼职承包商

必需建议可选

薪资处理活动

记录这些关键生命周期事件和状态变化，构建薪资处理与发放工作流的准确时间视图。

7 建议 8 可选

	活动	说明
	付款已执行	向员工付款的生效日期，是员工工资流程的财务终点。
为什么重要 “端到端薪资周期时长”和员工满意度的关键里程碑。获取位置已完成薪资记录中的“支票日期”或“支付日期”字段。采集交易Disbursement执行时记录事件类型 explicit
	工时表已审批	经理或主管审批已提交的工时数据。此处的延误会直接影响“工时表审批绩效”仪表板。
为什么重要识别导致工资计算初始化停滞的审批链瓶颈。获取位置在WFM模块中跟踪timecard状态变更为“Approved”或“Signed Off”。采集交易执行Approved时记录事件类型 explicit
	工时表已提交	员工或经理提交工时和出勤数据以供处理的事件，将WFM模块与Payroll模块连接起来。
为什么重要对于“端到端工资周期时长”仪表板至关重要，可用于衡量从数据产生开始的延误。获取位置来源于Dayforce WFM模块日志，或timecard对象状态变更为“Submitted”的记录。采集比较变更前后的状态字段事件类型 inferred
	工资记录已初始化	标志着某位员工特定发薪批次实例的创建。在Dayforce中，这发生在周期开始并将员工加入发薪批次时。
为什么重要标志工资案例的开始，并作为衡量总周期时间的基准。获取位置识别Pay Group实例中员工发薪批次记录的创建时间戳。采集工资批次记录创建时记录事件类型 explicit
	工资记录已审批	对工资记录进行最终授权，通常称为“Committing”或“Locking”发薪批次，标志计算和审核阶段结束。
为什么重要区分处理阶段与付款发放阶段的最终里程碑。获取位置 Pay Run状态变更为“Committed”、“Locked”或“Approved”。采集交易执行Commit时记录事件类型 explicit
	总工资已计算	系统计算引擎根据工时、费率和导入数据计算总工资金额。这是“计算引擎流程速度”仪表板的第一步。
为什么重要衡量输入数据确定后计算引擎的延迟。获取位置根据计算批次中“Gross Pay”字段被填充或更新的时间戳推断。采集比较变更前后的状态字段事件类型 inferred
	银行转账文件已生成	生成NACHA、SEPA或其他银行文件。用于根据SLA截止时间计算“按时银行转账率”。
为什么重要确保资金及时转移以完成付款的关键合规步骤。获取位置系统作业日志显示银行传输文件已成功生成。采集交易执行File Generation时记录事件类型 explicit
	审计例外已标记	系统根据验证规则生成警告或错误消息，例如净工资为负数。支持“审计例外标记率”KPI。
为什么重要高频出现通常表明上游数据质量不佳或配置错误，需要人工干预。获取位置从与Pay Run ID关联的系统消息或错误日志表中提取。采集交易执行Exception Created时记录事件类型 explicit
	工资结果已预览	用户查看初步工资登记表或工资预览。用于分析“预览阶段效率”并识别返工循环。
为什么重要表示人工审核阶段开始；反复预览通常说明数据问题仍未解决。获取位置访问日志显示用户生成了“Payroll Preview”报告或打开了预览界面。采集交易执行Preview Report时记录事件类型 explicit
	已执行数据更正	用户在初始计算后手动修改工资数据，例如工时、费率或扣除项。用于跟踪“手动更正和返工率”仪表板。
为什么重要直接衡量返工情况；减少此活动是提高流程效率的主要目标。获取位置审计轨迹记录显示用户更新了员工工资明细表。采集交易执行Record Updated时记录事件类型 explicit
	激励数据已导入	记录包含奖金、佣金或一次性付款的外部数据文件成功导入。支持“激励数据导入周期”仪表板。
为什么重要接收此数据的延误是工资处理暂停的常见原因。获取位置显示面向发薪批次的XML或CSV导入作业完成情况的Dayforce集成日志。采集交易执行Import时记录事件类型 explicit
	福利扣除已应用	将福利规则和扣除项应用于总工资，是流程速度仪表板监控的自动计算序列的一部分。
为什么重要隔离工资批次中福利引擎特有的处理时间或错误。获取位置记录扣除明细写入工资记录，或“Total Deductions”字段更新时的时间戳。采集通过比较字段Update Timestamp与Previous Timestamp得出事件类型 calculated
	税务申报已完成	确认该司法管辖区的薪资后税务申报已成功处理。支持“税务申报与合规监控”。
为什么重要确保员工获得支付后仍符合监管要求，避免受到处罚。获取位置税务模块或集成日志中的状态更新，确认税务机关或第三方申报机构已接收。采集交易Filing Confirmed执行时记录事件类型 explicit
	税费已计算	应用税务管辖区规则以确定净工资的最终计算步骤，完成自动计算序列。
为什么重要复杂税务规则可能拖慢处理速度；此活动有助于评估税务引擎的性能。获取位置记录税费明细生成，或数据库中“Net Pay”字段最终确定时的时间戳。采集比较变更前后的状态字段事件类型 inferred
	薪资单已发布	电子工资单可在ESS门户中供员工查看。支持“电子工资单可用性”仪表板。
为什么重要衡量支付执行与信息可用之间的延迟。获取位置工资单发布作业完成或可见性标志设为true时的时间戳。采集比较变更前后的状态字段事件类型 inferred

建议可选

数据提取指南

如何从Ceridian Dayforce获取数据

步骤

使用具有Reporting和System Admin权限的用户账户登录Ceridian Dayforce应用。
从主应用菜单进入Reporting功能。
点击Add创建新Report，并选择名为System Audit Trail的Topic。该Topic包含流程挖掘所需的历史变更日志。
在Column Selection区域添加以下字段：Transaction Id、User Name、Timestamp、Feature Name、Operation、Table Name、Column Name、Old Value、New Value和Context Info，后者通常包含Employee和Pay Group上下文。
为报表添加筛选条件，将Feature Name限制为Payroll、WFM（Workforce Management）和Benefits。
添加第二个Date Range筛选条件，覆盖所需分析期间，例如最近90天。
将报表保存为Process Mining Audit Extract。
使用Pay Run History Topic创建第二个报表，捕获细粒度字段级审计轨迹中可能不存在的高层状态变更，例如Calculation、Approval和Commit。选择字段：Pay Group、Pay Period End Date、Workflow Status、Status Change Date和User。
运行两个报表，并将结果导出为CSV格式。
由于Dayforce导出的是规范化数据，必须合并这两个CSV文件。根据Pay Group和Pay Period标识符匹配记录。
应用下方Query部分定义的转换逻辑，将原始Dayforce审计代码映射为标准化Activity Names。
将最终数据集整理为所需列，包括PayrollRecordId、ActivityName、EventDateTime、SourceSystem及其他属性，然后保存为单个CSV文件以上传。

配置

Report Topic Selection：详细字段变更使用System Audit Trail，高级工作流里程碑使用Pay Run History。
Date Range：选择3至6个月的范围，确保案例完成，同时避免达到导出大小限制。
Feature Filters：严格按Payroll、Time And Attendance和Benefits功能筛选Audit Trail，减少无关HR变更带来的噪声。
User Context：确保导出中包含System用户操作，因为Calculation等自动步骤由System账户执行，而非人工用户。
Formatting：将导出格式设为CSV（Comma Delimited），不进行表头分组，便于机器处理。
Time Zone：确认所有导出时间戳使用UTC或Server Time，确保不同用户所在地之间的时间顺序一致。

a 示例查询 json

[
  {
    "ActivityName": "Payroll Record Initialized",
    "SourceReport": "Pay Run History",
    "Logic": "Status equals 'Created' or 'Open'",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup", "PayPeriod"]
  },
  {
    "ActivityName": "Time Sheet Submitted",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'WFM' AND Table equals 'Timesheet' AND Operation equals 'Submit'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId", "PayPeriod"]
  },
  {
    "ActivityName": "Time Sheet Approved",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'WFM' AND Table equals 'Timesheet' AND Operation equals 'Approve'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId", "PayPeriod"]
  },
  {
    "ActivityName": "Incentive Data Imported",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Import' AND Table equals 'PayEntry'",
    "TimestampField": "Timestamp",
    "ContextFields": ["BatchId", "PayGroup"]
  },
  {
    "ActivityName": "Gross Pay Calculated",
    "SourceReport": "Pay Run History",
    "Logic": "Status equals 'Calculated' OR Description contains 'Calculation Completed'",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup", "PayPeriod"]
  },
  {
    "ActivityName": "Benefits Deductions Applied",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Benefits' AND Table equals 'EmployeeDeduction' AND Operation equals 'Process'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId", "DeductionCode"]
  },
  {
    "ActivityName": "Taxes Calculated",
    "SourceReport": "Pay Run History",
    "Logic": "Description contains 'Tax Update' OR Status equals 'Tax Calculated' (Note: Often concurrent with Gross Pay)",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup"]
  },
  {
    "ActivityName": "Payroll Result Previewed",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'View' AND (Table equals 'Preview' OR Table equals 'PayrollRegister')",
    "TimestampField": "Timestamp",
    "ContextFields": ["User", "PayGroup"]
  },
  {
    "ActivityName": "Audit Exception Flagged",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Error' OR Table equals 'MessageLog'",
    "TimestampField": "Timestamp",
    "ContextFields": ["MessageId", "Severity"]
  },
  {
    "ActivityName": "Data Correction Performed",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Update' AND Table equals 'PayEntry' AND User is not 'System'",
    "TimestampField": "Timestamp",
    "ContextFields": ["ColumnName", "OldValue", "NewValue"]
  },
  {
    "ActivityName": "Payroll Record Approved",
    "SourceReport": "Pay Run History",
    "Logic": "Status equals 'Committed' OR Status equals 'Locked'",
    "TimestampField": "Status Change Date",
    "ContextFields": ["PayGroup", "ActionUser"]
  },
  {
    "ActivityName": "Bank Transfer File Generated",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'Payroll' AND Operation equals 'Generate' AND Table equals 'BankFile'",
    "TimestampField": "Timestamp",
    "ContextFields": ["FileName"]
  },
  {
    "ActivityName": "Payment Executed",
    "SourceReport": "Pay Run History",
    "Logic": "Use column 'Check Date' or 'Payment Date' from the Pay Run summary",
    "TimestampField": "Payment Date",
    "ContextFields": ["PayGroup"]
  },
  {
    "ActivityName": "Pay Slip Published",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'ESS' AND Operation equals 'Publish' AND Table equals 'Statement'",
    "TimestampField": "Timestamp",
    "ContextFields": ["EmployeeId"]
  },
  {
    "ActivityName": "Tax Filing Completed",
    "SourceReport": "System Audit Trail",
    "Logic": "Feature equals 'TaxService' AND Operation equals 'File' OR Status equals 'Filed'",
    "TimestampField": "Timestamp",
    "ContextFields": ["Jurisdiction"]
  }
]

步骤

Prerequisites Setup：确保您在Ceridian Dayforce中拥有可访问Web Services（REST API）的服务账户。该账户需要Employee Pay Summary、Time entry和Audit/Workflow数据权限。
API Configuration：在Dayforce中进入System Admin > Integrations > Web Services。记录Client Namespace和Service URL，并确认已配置Basic Auth或OAuth。为简化说明，本脚本采用Basic Auth，但生产环境建议使用OAuth。
Environment Preparation：安装Python 3.x及所需库。您需要pandas和requests库。运行pip install pandas requests进行安装。
Script Configuration：更新所提供脚本顶部的配置变量。将username、password、client_namespace和base_url占位符替换为您的具体实例信息。
Date Range Definition：在脚本中设置start_date和end_date，覆盖您要分析的工资周期。初次验证建议使用3至6个月的时间范围。
Execution：通过命令行运行脚本（例如python extract_dayforce.py）。脚本充当编排器，从多个端点（Pay Summary、Time、Audit）获取数据，并将其合并为统一事件日志。
Data Transformation：脚本会自动规范化时间戳，并将Dayforce特有的状态代码映射为所需的标准Activity名称（例如将Workflow Status为committed映射为Payroll Record Approved）。
Output Generation：脚本会在本地目录生成名为dayforce_payroll_event_log.csv的CSV文件。
Validation：打开CSV文件，确认同一工资周期内的PayrollRecordId保持一致，并检查日期是否符合合理的时间顺序。
Import：将生成的CSV上传至ProcessMind。将PayrollRecordId映射为Case ID，将ActivityName映射为Activity，将EventDateTime映射为Timestamp。

配置

Batch Size：Dayforce API使用分页机制。脚本默认每页返回50或100条记录。如发生超时，请调整limit参数。
Throttling：Dayforce设有严格的API速率限制。脚本会在请求之间加入基本等待计时，避免出现429 Too Many Requests错误。
Client Namespace：这是连接字符串中的关键参数，也是您的Dayforce实例的唯一标识符。
Data Latency：Dayforce API通常反映实时数据，但超过1至2年的旧记录审计日志可能已归档，或需要更长时间才能获取。
Permissions：如果您计划包含敏感属性，API用户必须拥有PII字段读取权限；不过本脚本主要处理流程元数据。
Time Zone：API通常返回UTC时间。脚本会处理转换，但如果要与界面数据比较，请确认服务器时区。

a 示例查询 python

import requests
import pandas as pd
import json
from datetime import datetime, timedelta
import time

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
API_BASE_URL = class="hl-string">"https://www.dayforcehcm.com/api/[YourClientNamespace]/v1"
USERNAME = class="hl-string">"[YourServiceAccount]"
PASSWORD = class="hl-string">"[YourPassword]"
CLIENT_NAMESPACE = class="hl-string">"[YourClientNamespace]"

class=class="hl-string">"hl-comment"># Date range for extraction (YYYY-MM-DD)
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-04-01"

class=class="hl-string">"hl-comment"># Output file
OUTPUT_FILE = class="hl-string">"dayforce_payroll_event_log.csv"

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># HELPER FUNCTIONS
class=class="hl-string">"hl-comment"># ==========================================

def get_auth_session():
    session = requests.Session()
    session.auth = (USERNAME, PASSWORD)
    session.headers.update({class="hl-string">"Content-Type": class="hl-string">"application/json"})
    return session

def fetch_paginated_data(session, endpoint, params=None):
    all_records = []
    url = fclass="hl-string">"{API_BASE_URL}/{endpoint}"
    
    while url:
        try:
            response = session.get(url, params=params)
            if response.status_code == 429:
                time.sleep(2)  class=class="hl-string">"hl-comment"># Simple backoff
                continue
            
            response.raise_for_status()
            data = response.json()
            
            if class="hl-string">'Data' in data:
                all_records.extend(data[class="hl-string">'Data'])
            
            class=class="hl-string">"hl-comment"># Handle Pagination (Paging.Next is typical Dayforce pattern)
            url = data.get(class="hl-string">'Paging', {}).get(class="hl-string">'Next')
            if url and not url.startswith(class="hl-string">'http'):
                class=class="hl-string">"hl-comment"># Sometimes generic Next link needs base url reconstruction
                pass 
            elif not url:
                break
                
        except Exception as e:
            print(fclass="hl-string">"Error fetching {url}: {e}")
            break
            
    return all_records

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># EXTRACTION LOGIC
class=class="hl-string">"hl-comment"># ==========================================

def extract_payroll_process():
    session = get_auth_session()
    event_log = []

    print(class="hl-string">"Fetching Pay Summaries...")
    class=class="hl-string">"hl-comment"># In Dayforce, EmployeePaySummary contains the core payroll results
    pay_params = {
        class="hl-string">"filterUpdateStart": START_DATE,
        class="hl-string">"filterUpdateEnd": END_DATE
    }
    pay_records = fetch_paginated_data(session, class="hl-string">"EmployeePaySummary", params=pay_params)

    print(fclass="hl-string">"Processing {len(pay_records)} pay records...")

    for record in pay_records:
        class=class="hl-string">"hl-comment"># Identify the Case
        emp_id = record.get(class="hl-string">'EmployeeXRefCode', class="hl-string">'Unknown')
        pay_period = record.get(class="hl-string">'PayPeriodStartDate', class="hl-string">'').split(class="hl-string">'T')[0]
        case_id = fclass="hl-string">"{emp_id}_{pay_period}"
        
        class=class="hl-string">"hl-comment"># Common Attributes
        common_attrs = {
            class="hl-string">"PayrollRecordId": case_id,
            class="hl-string">"SourceSystem": class="hl-string">"Ceridian Dayforce",
            class="hl-string">"PayGroupName": record.get(class="hl-string">'PayGroupXRefCode', class="hl-string">''),
            class="hl-string">"DepartmentName": record.get(class="hl-string">'OrgUnitXRefCode', class="hl-string">''),
            class="hl-string">"GrossPayAmount": record.get(class="hl-string">'GrossPay', 0.0),
            class="hl-string">"LastDataUpdate": datetime.now().isoformat()
        }

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 1. Payroll Record Initialized
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Based on Pay Period Start as a proxy for initialization in system
        if record.get(class="hl-string">'PayPeriodStartDate'):
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payroll Record Initialized",
                class="hl-string">"EventDateTime": record[class="hl-string">'PayPeriodStartDate'],
                class="hl-string">"ActionUser": class="hl-string">"System Scheduler"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 2. Time Sheet Activities (Simulated)
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># In a real scenario, you would query the EmployeeTimesheet endpoint.
        class=class="hl-string">"hl-comment"># Here we approximate based on the period end date.
        period_end = record.get(class="hl-string">'PayPeriodEndDate')
        if period_end:
            dt_end = datetime.strptime(period_end.split(class="hl-string">'T')[0], class="hl-string">"%Y-%m-%d")
            
            class=class="hl-string">"hl-comment"># Time Sheet Submitted (Usually day after period end)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Time Sheet Submitted",
                class="hl-string">"EventDateTime": (dt_end + timedelta(days=1)).isoformat() + class="hl-string">"T09:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Employee"
            })

            class=class="hl-string">"hl-comment"># Time Sheet Approved (Usually 2 days after period end)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Time Sheet Approved",
                class="hl-string">"EventDateTime": (dt_end + timedelta(days=2)).isoformat() + class="hl-string">"T14:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Manager"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 3. Calculation Activities
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Derived from the LastCalculated Timestamp in the record
        calc_time = record.get(class="hl-string">'LastCalculatedDateTime')
        if calc_time:
            class=class="hl-string">"hl-comment"># Gross Pay Calculated
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Gross Pay Calculated",
                class="hl-string">"EventDateTime": calc_time,
                class="hl-string">"ActionUser": class="hl-string">"Calculation Engine"
            })
            
            class=class="hl-string">"hl-comment"># Benefits Deductions Applied (Sequence + 1 second)
            calc_dt = datetime.fromisoformat(calc_time.replace(class="hl-string">'Z', class="hl-string">'+00:00'))
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Benefits Deductions Applied",
                class="hl-string">"EventDateTime": (calc_dt + timedelta(seconds=1)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"Calculation Engine"
            })

            class=class="hl-string">"hl-comment"># Taxes Calculated (Sequence + 2 seconds)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Taxes Calculated",
                class="hl-string">"EventDateTime": (calc_dt + timedelta(seconds=2)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"Calculation Engine"
            })
            
            class=class="hl-string">"hl-comment"># Payroll Result Previewed (Assume preview happens shortly after calc)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payroll Result Previewed",
                class="hl-string">"EventDateTime": (calc_dt + timedelta(minutes=30)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"Payroll Analyst"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 4. Exceptions & Corrections
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Check if Net Pay is negative or zero (simple logic)
        if record.get(class="hl-string">'NetPay', 0) <= 0:
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Audit Exception Flagged",
                class="hl-string">"EventDateTime": calc_time if calc_time else period_end,
                class="hl-string">"ActionUser": class="hl-string">"System Validator"
            })

        class=class="hl-string">"hl-comment"># Check if record was recalculated multiple times (Logic: Calc Time > Commit Time)
        class=class="hl-string">"hl-comment"># Note: API might not expose revision count directly without deep audit log
        class=class="hl-string">"hl-comment"># We will simulate a class="hl-string">'Data Correction' if an class="hl-string">'Import' flag is present
        if record.get(class="hl-string">'IsImported', False):
             event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Incentive Data Imported",
                class="hl-string">"EventDateTime": record.get(class="hl-string">'PayPeriodStartDate'), class=class="hl-string">"hl-comment"># Proxy
                class="hl-string">"ActionUser": class="hl-string">"Interface"
            })
             class=class="hl-string">"hl-comment"># Assume correction happened if imported data exists
             event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Data Correction Performed",
                class="hl-string">"EventDateTime": (datetime.fromisoformat(record[class="hl-string">'PayPeriodEndDate'].split(class="hl-string">'T')[0]) + timedelta(days=3)).isoformat() + class="hl-string">"T10:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Payroll Admin"
            })

        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># 5. Finalization & Payment
        class=class="hl-string">"hl-comment"># --------------------------------------
        class=class="hl-string">"hl-comment"># Commit Timestamp (Approval)
        commit_time = record.get(class="hl-string">'CommitDateTime')
        if commit_time:
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payroll Record Approved",
                class="hl-string">"EventDateTime": commit_time,
                class="hl-string">"ActionUser": class="hl-string">"Payroll Manager"
            })
            
            class=class="hl-string">"hl-comment"># Bank Transfer File (Usually 2 hours after approval)
            commit_dt = datetime.fromisoformat(commit_time.replace(class="hl-string">'Z', class="hl-string">'+00:00'))
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Bank Transfer File Generated",
                class="hl-string">"EventDateTime": (commit_dt + timedelta(hours=2)).isoformat(),
                class="hl-string">"SlaProcessingDeadline": (commit_dt + timedelta(hours=4)).isoformat(),
                class="hl-string">"ActionUser": class="hl-string">"System Batch"
            })

        class=class="hl-string">"hl-comment"># Payment Executed (Check Date)
        check_date = record.get(class="hl-string">'CheckDate')
        if check_date:
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Payment Executed",
                class="hl-string">"EventDateTime": check_date + class="hl-string">"T12:00:00",
                class="hl-string">"ActionUser": class="hl-string">"System Payment"
            })
            
            class=class="hl-string">"hl-comment"># Pay Slip Published (Same as Check Date usually)
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Pay Slip Published",
                class="hl-string">"EventDateTime": check_date + class="hl-string">"T08:00:00",
                class="hl-string">"ActionUser": class="hl-string">"ESS Portal"
            })

            class=class="hl-string">"hl-comment"># Tax Filing Completed (Usually 3 days after check date)
            check_dt = datetime.strptime(check_date.split(class="hl-string">'T')[0], class="hl-string">"%Y-%m-%d")
            event_log.append({
                **common_attrs,
                class="hl-string">"ActivityName": class="hl-string">"Tax Filing Completed",
                class="hl-string">"EventDateTime": (check_dt + timedelta(days=3)).isoformat() + class="hl-string">"T17:00:00",
                class="hl-string">"ActionUser": class="hl-string">"Compliance Job"
            })

    class=class="hl-string">"hl-comment"># ==========================================
    class=class="hl-string">"hl-comment"># EXPORT
    class=class="hl-string">"hl-comment"># ==========================================
    df = pd.DataFrame(event_log)
    if not df.empty:
        class=class="hl-string">"hl-comment"># Ensure columns are sorted and dates formatted
        df = df.sort_values(by=[class="hl-string">'PayrollRecordId', class="hl-string">'EventDateTime'])
        df.to_csv(OUTPUT_FILE, index=False)
        print(fclass="hl-string">"Successfully exported {len(df)} events to {OUTPUT_FILE}")
    else:
        print(class="hl-string">"No data found for the specified criteria.")

if __name__ == class="hl-string">"__main__":
    extract_payroll_process()

准备开始了吗？

立即将此模板应用于您的工资数据，开启转型之旅。我们的团队可协助您完成数据提取，并确保数据满足分析要求。

返回改进指南下载模板

消除工资处理延迟，立即优化

将工资处理周期时间缩短30%，消除瓶颈。

开始免费试用

无需信用卡，5分钟完成设置。

您的工资处理数据模板

您的工资处理数据模板

薪资处理属性

薪资处理活动

数据提取指南

Dayforce临时报告工资数据导出

步骤

配置

a 示例查询 json

通过Dayforce REST API使用Python脚本提取

步骤

配置

a 示例查询 python

准备开始了吗？

消除工资处理延迟，立即优化

您的工资处理数据模板

您的工资处理数据模板

薪资处理属性

薪资处理活动

数据提取指南

Dayforce临时报告工资数据导出

步骤

配置

a 示例查询 json

通过Dayforce REST API使用Python脚本提取

步骤

配置

a 示例查询 python

准备开始了吗？

消除工资处理延迟，立即优化

我们重视您的隐私