> 持续流程改进 > 工资处理 > 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中的标准活动包括“工时表已提交”“税前工资已计算”“薪资已提交”“付款已执行”和“税务申报已完成”。这些值通常从工作流审计日志、系统交易日志（例如薪资状态变更）或与发薪批次、工时表等业务对象关联的时间戳中提取。重要性它定义流程步骤，对于重建流程并分析变体至关重要。获取途径工作流日志、审计跟踪或状态变更历史表。示例工时表已提交税前工资已计算付款已执行已更正数据已标记审计例外
	薪资记录 PayrollRecordId	薪资案例的唯一标识符，由员工和发薪周期组合而成。
说明此属性是流程的唯一案例ID。在Ceridian Dayforce中，薪资记录可理解为特定员工与特定发薪周期的交集，发薪周期通常在薪资组中定义。它跟踪该员工在此周期内的薪酬处理全过程。在技术实现上，通常将发薪周期ID与员工XRefCode或系统ID拼接生成此标识符。它关联从提交工时表到完成最终税务申报和生成工资单的所有活动。重要性此属性标识流程挖掘分析的核心对象，使所有事件都能归入同一条端到端执行路径。获取途径根据薪资结果表或工时录入表中的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天，也可以在薪资组设置中配置。重要性这是计算按时完成率和合规风险的基准。获取途径根据发薪日期和银行处理规则配置得出。示例 2023-10-25T14:00:00Z2023-10-26T10:00:00Z
	操作用户 ActionUser	执行特定活动的用户。
说明标识事件的负责人，例如批准工时表的经理或提交发薪批次的薪资专员。此数据对于“薪资专员工作效率”视图至关重要，也有助于发现经理的培训需求。重要性它支持流程中的资源分析和责任追踪。获取途径审计日志、交易表中的用户ID列。示例 jsmith系统管理员mgarcia_mgr
	税前工资金额 GrossPayAmount	该记录计算出的税前工资。
说明扣除项目和税款前的薪酬总额。此值会在“税前工资已计算”活动中填入。分析税前工资处理时间的差异，有助于发现拖慢“计算引擎流程速度”仪表板所跟踪流程的复杂计算。重要性它为流程提供财务背景，并支持分析高价值与低价值记录的处理情况。获取途径薪资结果表或发薪批次详情表。示例 2500.004150.501200.00
	薪资组 PayGroupName	为薪资处理划分的员工组。
说明按相同时间安排发薪的员工类别，例如“美国双周薪”和“英国月薪”。在Dayforce中，薪资组是发薪批次的主要组织单位。此属性是“端到端薪资周期时长”仪表板的重要数据，因为不同薪资组的周期时间和截止时间通常不同。重要性这是对薪资绩效进行基准比较并发现特定群组问题的主要分类维度。获取途径 PayGroup表或PayRun定义。示例美国企业员工月薪组加拿大零售员工时薪组英国高管月薪组
	部门 DepartmentName	员工所属的组织单位。
说明表示与薪资记录关联的职能部门，例如销售、IT或人力资源。在Dayforce中，此属性通常关联“组织单位”或“部门”层级。此字段用于“工时表审批绩效”仪表板，支持逐级下钻到具体业务领域，找出经理可能延误审批的环节。重要性它支持组织层面的基准比较，并帮助分析审批延误的根本原因。获取途径员工记录或组织单位层级。示例财务部供应链物流部北美销售部
	工资周期 PayPeriodDescription	工资发放周期的描述性名称。
说明工资周期的易读标签（例如“2023年第42周”“2023年10月半月薪”），便于在仪表板中筛选和可视化。此属性为“工资记录”提供背景信息，通常显示在“流程变体路径分析”中，用于筛选特定批次。重要性让业务用户更容易理解数据。获取途径 PayPeriod表中的描述列。示例 2023年第42周2023年10月半月薪12023年11月
	成本中心 CostCenterCode	用于核算工资支出的财务代码。
说明与员工收入相关联的总账成本中心。此属性用于“成本中心处理基准”视图，比较不同财务单元的处理效率。在Dayforce中，此信息属于总账（GL）分摊明细。重要性将流程绩效与财务报告结构关联起来。获取途径员工GL设置或人工成本分配表。示例 CC-1020CC-5500-USCC-IT-OPS
	是否存在审计异常 IsAuditExceptionFlagged	用于标记记录是否触发审计警告的布尔值。
说明此属性可直接获取或通过计算得出，用于标记此案例是否发生“审计异常已标记”活动，并用于计算“审计异常标记率”KPI。异常率偏高可能意味着数据质量存在问题，或Dayforce合规引擎的配置过于严格。重要性简化错误率和返工循环的计算。获取途径根据是否存在“审计异常已标记”活动得出。示例 truefalse
	更正原因 CorrectionReason	数据更正时提供的原因代码。
说明如果发生“已执行数据更正”活动，此属性会记录相应原因（例如“漏打卡”“追溯调整薪资”）。此属性可为“手动更正与返工率”仪表板提供详细信息，帮助团队针对手动操作的具体根因采取措施。重要性这是分析返工根因的关键属性。获取途径审计日志明细或更正交易的备注字段。示例漏打卡费率错误追溯调整
	税务管辖区 TaxJurisdiction	负责税务申报的地区或机构。
说明标识与薪资记录相关的具体税务机关，例如州、省或国家。此属性用于“税务申报与合规监控”仪表板。它支持按地区分析薪资发放后的合规流程，并突出显示经常出现申报延误的管辖区。重要性它支持合规监控和流程绩效的地理维度分析。获取途径员工税务设置或薪资结果税务详情。示例加利福尼亚州安大略省纽约州英国
	银行转账是否延迟 IsBankTransferLate	用于标记银行文件是否错过截止时间。
说明通过比较“银行转账文件生成”时间戳与“SLA处理截止时间”计算得出的布尔值，用于计算“银行转账按时率”KPI。识别延迟转账对于避免员工延迟收款至关重要。重要性这是衡量合规性和可靠性的关键指标。获取途径计算方式：BankTransferTime > SlaProcessingDeadline。示例 truefalse
	雇佣类型 EmploymentType	员工类别（全职、兼职、合同工）。
说明用于划分员工的雇佣关系。基准分析可借此比较合同工或兼职员工的工资处理特点和错误率是否不同。此属性通常位于Dayforce的员工记录中。重要性便于分组分析，并公平比较处理数据。获取途径员工表。示例全职兼职合同工

必填建议填写选填

工资处理活动

记录这些关键流程事件和状态变更，准确还原工资处理与发放工作流的时间顺序。

7 建议填写 8 选填

	活动	说明
	付款已执行	向员工付款的生效日期。这是员工薪资流程的最终财务节点。
重要性这是衡量“端到端薪资周期时长”和员工满意度的关键节点。获取途径已最终确定的薪资记录中的“支票日期”或“付款日期”字段。采集执行“付款”交易时记录事件类型 explicit
	工时表已批准	经理或主管批准已提交的工时数据。此处的延误会直接影响“工时表审批绩效”仪表板。
重要性找出审批链中的瓶颈，了解哪些环节延误了薪资计算的启动。获取途径跟踪WFM模块中工时卡状态变为“已批准”或“已签核”的记录。采集执行“已批准”交易时记录事件类型 explicit
	工时表已提交	员工或经理提交工时和出勤数据以供处理的事件。此步骤连接WFM模块与薪资模块。
重要性这是“端到端薪资周期时长”仪表板的重要数据，可用于衡量从数据产生到处理完成的延误。获取途径根据Dayforce WFM模块日志，或工时卡对象状态变为“已提交”的记录得出。采集比较更改前后的状态字段事件类型 inferred
	税前工资已计算	系统计算引擎根据工时、费率和导入的数据计算税前工资。这是“计算引擎流程速度”仪表板跟踪的第一步。
重要性衡量输入数据确定后计算引擎的处理延迟。获取途径根据计算批次期间“税前工资”字段填入或更新的时间推断。采集比较更改前后的状态字段事件类型 inferred
	薪资记录初始化	标记员工特定发薪批次实例的创建。在Dayforce中，系统会在该周期打开薪资组并将员工加入发薪批次时创建此记录。
重要性标记薪资案例的开始，并作为衡量总周期时间的基准。获取途径确定薪资组实例中员工发薪批次记录的创建时间。采集创建发薪批次记录时记录事件类型 explicit
	薪资记录已批准	对薪资记录进行最终授权，通常称为“提交”或“锁定”发薪批次。这标志着计算和审核阶段结束。
重要性这是区分处理阶段与付款阶段的关键节点。获取途径发薪批次状态变为“已提交”“已锁定”或“已批准”。采集执行“提交”交易时记录事件类型 explicit
	银行转账文件已生成	生成NACHA、SEPA或其他银行文件。此数据用于根据SLA截止时间计算“银行转账按时完成率”。
重要性这是关键的合规步骤，确保资金及时转出以便按时付款。获取途径查看系统任务日志，确认银行传输文件已成功生成。采集执行“文件生成”交易时记录事件类型 explicit
	工资单已发布	员工可在ESS门户中查看电子工资单。此数据可用于“电子工资单可用时间”仪表板。
重要性衡量付款执行到相关信息可供查看之间的延迟。获取途径工资单发布任务完成，或可见性标记设为true时的时间戳。采集比较更改前后的状态字段事件类型 inferred
	已扣除福利费用	根据福利规则从税前工资中扣除相应费用。这是流程速度仪表板监控的自动计算顺序的一部分。
重要性单独分析薪资批次中福利引擎的处理时间或错误。获取途径扣款明细写入薪资记录，或“扣款总额”字段更新时的时间戳。采集比较字段的更新时间戳与上一个时间戳得出事件类型 calculated
	已更正数据	用户在初次计算后手动修改薪资数据，例如工时、费率或扣款。此活动用于跟踪“人工更正与返工率”仪表板。
重要性这是衡量返工的直接指标。提高流程效率的一项主要目标是减少此类活动。获取途径查看审计跟踪记录，确认用户是否更新了员工薪资明细表。采集执行“更新记录”交易时记录事件类型 explicit
	已标记审计例外	系统根据验证规则生成警告或错误消息，例如实发工资为负数。此数据可用于“审计例外标记率”KPI。
重要性发生频率较高，通常表明上游数据质量欠佳或配置有误，需要人工干预。获取途径从与发薪批次ID关联的系统消息或错误日志表中提取。采集执行“创建例外”交易时记录事件类型 explicit
	激励数据已导入	记录包含奖金、佣金或一次性付款的外部数据文件是否成功导入。此数据可用于“激励数据导入周期”仪表板。
重要性未能及时收到这些数据，是薪资处理暂停的常见原因。获取途径查看Dayforce集成日志，确认面向发薪批次的XML或CSV导入任务已完成。采集执行“导入”交易时记录事件类型 explicit
	税务申报已完成	确认薪资发放后的税务申报已在相关管辖区成功处理。此数据可用于“税务申报与合规监控”仪表板。
重要性确保遵守法规，避免员工收到薪资后产生罚款。获取途径税务模块或集成日志中的状态更新，确认税务机关或第三方申报服务商已收到申报。采集执行“确认申报”交易时记录事件类型 explicit
	税款已计算	计算的最后一步，根据税务管辖区规则确定实发工资，并完成自动计算顺序。
重要性复杂的税务规则可能拖慢处理速度。此活动有助于评估税务引擎的性能。获取途径生成税款明细，或数据库中的“实发工资”字段最终确定时的时间戳。采集比较更改前后的状态字段事件类型 inferred
	薪资结果已预览	用户查看初步薪资登记表或薪资预览。此活动用于分析“预览阶段效率”并发现返工循环。
重要性标记人工审核阶段的开始。反复预览可能意味着数据问题仍未解决。获取途径查看访问日志，确认用户是否生成“薪资预览”报告或打开预览页面。采集执行“预览报告”交易时记录事件类型 explicit

建议填写选填

数据提取指南

如何从Ceridian Dayforce获取数据

步骤

使用具有报告和系统管理员权限的用户账户登录Ceridian Dayforce应用程序。
在应用程序主菜单中打开报告功能。
点击“添加”按钮创建新报告，并选择名为System Audit Trail的主题。该主题包含流程挖掘所需的历史变更日志。
在列选择区域添加以下字段：Transaction Id、User Name、Timestamp、Feature Name、Operation、Table Name、Column Name、Old Value、New Value和Context Info（通常包含员工和薪资组信息）。
为报告添加筛选条件，将Feature Name限制为Payroll、WFM（Workforce Management）和Benefits。
添加第二个筛选条件，设置日期范围以覆盖所需的分析周期（例如，最近90天）。
将报告保存为Process Mining Audit Extract。
使用Pay Run History主题创建第二份报告，以记录高层级状态变更（Calculation、Approval、Commit），这些变更可能不会出现在细粒度的字段级审计跟踪中。选择以下字段：Pay Group、Pay Period End Date、Workflow Status、Status Change Date和用户。
运行两份报告，并将结果导出为CSV格式。
由于Dayforce导出的是规范化数据，您需要合并这两个CSV文件。根据Pay Group和Pay Period标识符匹配记录。
应用下方“查询”部分定义的转换逻辑，将Dayforce原始审计代码映射为标准活动名称。
将最终数据集整理为所需列：PayrollRecordId、ActivityName、EventDateTime、SourceSystem及其他属性，然后保存为单个CSV文件以供上传。

配置

报告主题选择：使用“System Audit Trail”查看细粒度字段变更，使用“Pay Run History”查看高层级工作流节点。
日期范围：选择3至6个月的范围，确保案例已完成，同时避免超出导出大小限制。
功能筛选条件：严格按“Payroll”、“Time And Attendance”和“Benefits”筛选审计跟踪，减少无关人力资源变更带来的干扰。
用户上下文：确保导出包含“System”用户的操作，因为计算等自动化步骤由System账户执行，而非人工用户。
格式设置：将导出格式设为CSV（逗号分隔），且不进行表头分组，以便机器处理。
时区：确认所有导出时间戳均为UTC或服务器时间，确保不同用户所在地的时间顺序一致。

查询示例 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"]
  }
]

步骤

准备工作：确保您拥有Ceridian Dayforce服务账户，并可访问Web Services（REST API）。该账户需要具备Employee Pay Summary、Time entry以及Audit/Workflow数据的权限。
配置API：在Dayforce中依次打开System Admin > Integrations > Web Services。记录Client Namespace和Service URL，并确认已配置Basic Auth或OAuth。为简化说明，本脚本假设使用Basic Auth，但生产环境建议使用OAuth。
准备环境：安装Python 3.x及所需库，包括pandas和requests。运行pip install pandas requests进行安装。
配置脚本：更新所提供脚本顶部的配置变量。将username、password、client_namespace和base_url占位符替换为您实例的具体信息。
设置日期范围：在脚本中设置start_date和end_date，覆盖您要分析的薪资周期。首次验证建议使用3至6个月的时间范围。
运行脚本：通过命令行运行脚本（例如python extract_dayforce.py）。脚本会从多个端点（Pay Summary、Time、Audit）获取数据，并将其合并为统一的事件日志。
转换数据：脚本会自动规范化时间戳，并将Dayforce特有的状态代码映射为所需的标准活动名称（例如，将Workflow Status中的committed映射为Payroll Record Approved）。
生成输出文件：脚本会在本地目录中生成名为dayforce_payroll_event_log.csv的CSV文件。
验证数据：打开CSV文件，确认同一薪资周期的PayrollRecordId一致，且日期顺序符合逻辑。
导入数据：将生成的CSV上传至ProcessMind。将PayrollRecordId映射到案例ID，将ActivityName映射到活动，将EventDateTime映射到时间戳。

配置

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

查询示例 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临时报告薪资数据导出

步骤

配置

查询示例 json

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

步骤

配置

查询示例 python

准备好开始了吗？

减少工资处理延迟，立即优化流程