> Cải tiến quy trình liên tục > Xử lý bảng lương > ADP Workforce Now > Mẫu dữ liệu

Mẫu dữ liệu xử lý bảng lương

ADP Workforce Now

Thuộc tính xử lý bảng lương(17) Hoạt động xử lý bảng lương(15) Hướng dẫn trích xuất(3)

Mẫu dữ liệu xử lý bảng lương

Mẫu này cung cấp khung để sơ đồ hóa các chu kỳ trả lương trong ADP Workforce Now. Mẫu nêu rõ các thuộc tính và hoạt động cần thiết để tạo event log, giúp bạn tìm điểm nghẽn và theo dõi việc tuân thủ trong toàn tổ chức. Làm theo hướng dẫn để chuyển dữ liệu thô từ hệ thống thành hình ảnh rõ ràng về cách công việc thực sự diễn ra.

Các thuộc tính nên có để phân tích chi tiết
Các bước và mốc quan trọng của quy trình
Cách trích xuất dữ liệu từ ADP Workforce Now

Chưa quen với nhật ký sự kiện? Tìm hiểu cách tạo nhật ký sự kiện cho process mining.

Tải mẫu xuống

Thuộc tính xử lý bảng lương

Các trường dữ liệu được đề xuất cung cấp ngữ cảnh cần thiết cho event log, giúp bạn phân tích sâu các chu kỳ trả lương.

5 Bắt buộc 7 Nên có 5 Không bắt buộc

	Tên	Mô tả
	Hồ sơ lương PayrollRecordId	Mã định danh duy nhất cho từng nhân viên và kỳ lương.
Mô tả Hồ sơ lương là mã định danh trung tâm của từng trường hợp trong quy trình. Hồ sơ đại diện cho một lần trả lương cho một nhân viên trong một kỳ cụ thể, chẳng hạn kỳ lương 12 của nhân viên X. Khi phân tích, thuộc tính này nhóm các sự kiện rời rạc, từ lúc gửi bảng chấm công đến khi hoàn tất khai thuế, thành một hành trình xuyên suốt. Nhờ đó, chuyên viên phân tích có thể theo dõi tốc độ và độ chính xác của từng hồ sơ lương. Vì sao điều này quan trọng Đây là khóa trường hợp bắt buộc, liên kết toàn bộ dữ liệu sự kiện để tái dựng quy trình. Lấy dữ liệu ở đâu Tham khảo tài liệu ADP Workforce Now Ví dụ PR-2023-10-A-00123PR-2023-10-A-00456PR-2023-10-B-00789
	Hoạt động ActivityName	Tên bước hoặc sự kiện đã thực hiện trong quy trình.
Mô tả Thuộc tính này ghi lại hành động cụ thể trong quy trình xử lý lương, chẳng hạn như “Đã gửi bảng chấm công”, “Đã tính tổng lương trước khấu trừ” hoặc “Đã tạo tệp chuyển khoản ngân hàng”. Đây là thuộc tính cốt lõi của sơ đồ quy trình. Nó xác định các nút trong biểu đồ và giúp hiển thị thứ tự các bước. Những khác biệt trong chuỗi hoạt động cho thấy các vòng lặp làm lại và sai lệch so với quy trình vận hành tiêu chuẩn. Vì sao điều này quan trọng Thuộc tính này cho biết quy trình đã làm gì, giúp hiển thị luồng quy trình và các biến thể. Lấy dữ liệu ở đâu Nhật ký kiểm toán hoặc lịch sử giao dịch trong ADP Workforce Now. Ví dụ Đã gửi bảng chấm côngĐã phê duyệt hồ sơ lươngĐã thực hiện chỉnh sửa dữ liệu
	Thời điểm sự kiện EventDateTime	Ngày và giờ cụ thể khi hoạt động diễn ra.
Mô tả Thuộc tính này ghi lại chính xác thời điểm hoạt động được lưu trong hệ thống. Dữ liệu này dùng để sắp xếp sự kiện theo thời gian và tính khoảng thời gian giữa các bước. Dấu thời gian chính xác giúp xác định điểm nghẽn, đo thời gian hoàn tất từng bước, chẳng hạn thời gian chờ phê duyệt, và bảo đảm quy trình xử lý lương đáp ứng các thỏa thuận mức dịch vụ. Vì sao điều này quan trọng Thuộc tính này cung cấp dữ liệu thời gian cần thiết để phân tích thời gian chu kỳ và hiệu suất. Lấy dữ liệu ở đâu Dấu thời gian hệ thống gắn với nhật ký giao dịch. Ví dụ 2023-10-01T08:30:00Z2023-10-01T14:45:12Z2023-10-02T09:15:00Z
	Hệ thống nguồn SourceSystem	Hệ thống lưu hồ sơ gốc, nơi sự kiện phát sinh.
Mô tả Xác định môi trường phần mềm nơi dữ liệu được trích xuất, trong trường hợp này là “ADP Workforce Now”. Khi dữ liệu được kết hợp từ nhiều hệ thống HRIS hoặc ngân hàng, trường này giúp truy vết nguồn gốc dữ liệu và xác định các vấn đề tích hợp riêng của từng hệ thống. Vì sao điều này quan trọng Thuộc tính này giúp truy vết dữ liệu và hiểu rõ bối cảnh, nhất là khi process mining sử dụng dữ liệu từ nhiều hệ thống. Lấy dữ liệu ở đâu Được thiết lập cố định trong quy trình ETL. Ví dụ ADP Workforce NowADP WFNADP_PROD
	Lần cập nhật dữ liệu gần nhất LastDataUpdate	Dấu thời gian cho biết lần gần nhất hồ sơ được chỉnh sửa trong hệ thống nguồn.
Mô tả Cho biết thời điểm gần nhất hồ sơ dữ liệu được chỉnh sửa trong ADP Workforce Now. Thông tin này giúp xác định độ mới của dữ liệu và quản lý các lần tải dữ liệu tăng dần. Nhờ đó, phân tích quy trình phản ánh đúng trạng thái hiện tại của hồ sơ lương. Vì sao điều này quan trọng Cần thiết để trích xuất dữ liệu tăng dần và bảo đảm phân tích dựa trên dữ liệu hiện tại. Lấy dữ liệu ở đâu Tham khảo tài liệu ADP Workforce Now Ví dụ 2023-10-05T17:00:00Z2023-10-06T08:00:00Z
	Chuyên viên xử lý lương PayrollSpecialistName	Người dùng hoặc tác nhân hệ thống chịu trách nhiệm thực hiện hoạt động.
Mô tả Xác định người thực hiện hoạt động, chẳng hạn chuyên viên xử lý lương hoặc quản lý, hay tài khoản hệ thống tự động. Thuộc tính này hỗ trợ dashboard “Hiệu suất xử lý của chuyên viên”, giúp cân đối khối lượng công việc và xác định nhu cầu đào tạo hoặc điểm nghẽn do thiếu nguồn lực. Vì sao điều này quan trọng Thuộc tính này hỗ trợ phân tích nguồn lực, cân đối khối lượng công việc và kiểm tra việc phân tách nhiệm vụ. Lấy dữ liệu ở đâu Trường User ID hoặc Actor trong nhật ký kiểm toán. Ví dụ Jane DoeQuản trị viên hệ thốngJohn Smith
	Có can thiệp thủ công IsManualIntervention	Cờ cho biết hoạt động có bao gồm nhập hoặc chỉnh sửa dữ liệu thủ công hay không.
Mô tả Thuộc tính đúng/sai được suy ra từ tên hoạt động hoặc nguồn giao dịch, chẳng hạn có giá trị true nếu hoạt động là “Đã thực hiện chỉnh sửa dữ liệu”. Thuộc tính này dùng để tính KPI “Tỷ lệ chỉnh sửa thủ công”, giúp quản lý xác định khâu nào tự động hóa chưa hiệu quả và nơi cần nhiều công sức của nhân viên. Vì sao điều này quan trọng Hỗ trợ trực tiếp việc phân tích mức độ tự động hóa và hiệu quả quy trình. Lấy dữ liệu ở đâu Suy ra từ ActivityName hoặc mã giao dịch cụ thể. Ví dụ truefalse
	Khu vực tính thuế TaxJurisdictionCode	Mã khu vực hoặc tiểu bang cụ thể dùng để khai thuế.
Mô tả Cho biết cơ quan thuế hoặc khu vực chính liên quan đến hồ sơ lương, chẳng hạn CA, NY hoặc cấp liên bang. Thuộc tính này cần thiết cho dashboard “Mốc thời gian hoàn tất khai thuế”, giúp xác định khu vực nào đang chậm khai thuế theo quy định và bảo đảm tuân thủ quy định địa phương. Vì sao điều này quan trọng Cần thiết để theo dõi tuân thủ và phân tích hiệu suất theo khu vực. Lấy dữ liệu ở đâu Hồ sơ thuế hoặc các bảng Payroll Tax. Ví dụ Mỹ-CAMỹ-NYMỹ-TX
	Là điều chỉnh hồi tố IsRetrospective	Cờ cho biết hồ sơ lương này có phải là điều chỉnh cho kỳ trước hay không.
Mô tả Xác định hồ sơ đang được xử lý cho kỳ hiện tại hay để chỉnh sửa kỳ đã đóng trước đó (trả lương hồi tố). Thuộc tính này hỗ trợ dashboard “Số lượng điều chỉnh hồi tố”, cho thấy mức độ ổn định của quy trình xử lý lương và tần suất phát sinh lỗi sau khi công bố. Vì sao điều này quan trọng Phân biệt xử lý thông thường với các chu kỳ làm lại hoặc chỉnh sửa. Lấy dữ liệu ở đâu Suy ra từ Pay Run Type hoặc bằng cách so sánh kỳ lương với ngày hiện tại. Ví dụ truefalse
	Nhóm lương PayGroupCode	Xác định kỳ hoặc nhóm tính lương cụ thể, chẳng hạn nhóm trả lương hai tuần một lần tại Mỹ.
Mô tả Chia nhân viên thành các nhóm xử lý dựa trên tần suất và loại hình trả lương, chẳng hạn hàng tuần, hai tuần một lần hoặc nhóm điều hành. Thuộc tính này dùng để lọc phân tích theo từng kỳ. Đây cũng là dữ liệu quan trọng cho dashboard “Tần suất chỉnh sửa dữ liệu thủ công”, giúp xác định nhóm nào thường gặp lỗi hơn. Vì sao điều này quan trọng Cho phép phân tích quy trình theo tần suất trả lương và loại nhân viên. Lấy dữ liệu ở đâu Cấu hình Pay Group hoặc các bảng Payroll Header. Ví dụ Mỹ_Hai tuần một lầnCanada_Hàng thángMỹ_Điều hành
	Phòng ban DepartmentCode	Phòng ban hoặc trung tâm chi phí gắn với nhân viên.
Mô tả Cho biết đơn vị trong tổ chức của nhân viên được trả lương. Trong ADP, trường này thường là “Home Department”. Thuộc tính này cần thiết cho phân tích “Chênh lệch quy trình giữa các phòng ban”, giúp tổ chức so sánh thời gian phê duyệt và tỷ lệ lỗi giữa các đơn vị kinh doanh. Vì sao điều này quan trọng Dùng để so sánh hiệu suất giữa các đơn vị trong tổ chức. Lấy dữ liệu ở đâu Dữ liệu nhân viên chính hoặc các trường trung tâm chi phí. Ví dụ Kinh doanh-101CNTT-Phát triển-200Nhân sự-Hành chính-001
	Tổng lương trước khấu trừ GrossPayAmount	Tổng lương trước khấu trừ được tính cho hồ sơ, trước khi trừ các khoản khấu trừ.
Mô tả Tổng tiền lương được tính cho nhân viên trong kỳ lương cụ thể. Dù không phải lúc nào cũng dùng để phân tích luồng quy trình, thuộc tính này cung cấp bối cảnh cho “ActivityAmount” và giúp ưu tiên các hồ sơ có giá trị cao khi phân tích ngoại lệ kiểm toán hoặc điều chỉnh hồi tố. Vì sao điều này quan trọng Cung cấp bối cảnh tài chính và quy mô giá trị của hồ sơ lương. Lấy dữ liệu ở đâu Các bảng Payroll Result. Ví dụ 2500.005430.501200.00
	Loại ngoại lệ kiểm toán AuditExceptionType	Phân loại cảnh báo về tuân thủ hoặc dữ liệu đã được đánh dấu.
Mô tả Nêu cụ thể loại vấn đề phát hiện trong quá trình xác thực, chẳng hạn “Lương thực nhận âm” hoặc “Thiếu mã số thuế”. Thuộc tính này được dùng trong “Bảng theo dõi xử lý ngoại lệ kiểm toán” để phân tích loại lỗi nào gây chậm trễ lâu nhất và tìm nguyên nhân gốc rễ nhằm cải thiện chất lượng dữ liệu ở các bước trước. Vì sao điều này quan trọng Cho biết lý do quy trình bị tạm dừng hoặc bị đánh dấu. Lấy dữ liệu ở đâu Tham khảo tài liệu ADP Workforce Now Ví dụ Thiếu SSNLương thực nhận âmThông tin phúc lợi không khớp
	Mã nhân viên EmployeeId	Mã định danh duy nhất của nhân viên được trả lương.
Mô tả Mã cụ thể của nhân viên gắn với hồ sơ lương. CaseId dùng để theo dõi hồ sơ, còn Mã nhân viên cho phép phân tích theo thời gian để xác định nhân viên thường xuyên gửi bảng chấm công trễ hoặc cần chỉnh sửa thủ công nhiều lần. Vì sao điều này quan trọng Cho phép phân tích các kiểu hành vi ở cấp nhân viên. Lấy dữ liệu ở đâu AssociateOID hoặc File Number trong ADP. Ví dụ A102030000123456
	Mã tệp ngân hàng BankTransferFileId	Mã định danh của tệp thanh toán được tạo để gửi đến ngân hàng.
Mô tả Số tham chiếu duy nhất của tệp ACH hoặc chuyển khoản được tạo trong hoạt động 'Đã tạo tệp chuyển khoản ngân hàng'. Mã này giúp liên kết từng hồ sơ lương với bước thực hiện thanh toán hàng loạt, từ đó phân tích tốc độ chi trả và công bố. Vì sao điều này quan trọng Liên kết từng trường hợp với các sự kiện xử lý theo lô. Lấy dữ liệu ở đâu Tham khảo tài liệu ADP Workforce Now Ví dụ ACH-20231005-01ACH-20231005-02
	Ngày kết thúc kỳ lương PayPeriodEndDate	Ngày kết thúc kỳ trả lương.
Mô tả Đánh dấu ngày kết thúc kỳ mà nhân viên được trả lương. Kết hợp thuộc tính này với dấu thời gian sự kiện để xác định việc xử lý có diễn ra đúng lịch so với thời điểm kết thúc kỳ lương hay không. Vì sao điều này quan trọng Mốc tham chiếu để tính mức độ đúng lịch và tình trạng trễ hạn. Lấy dữ liệu ở đâu Cấu hình kỳ trả lương. Ví dụ 2023-10-152023-10-31
	Trung tâm chi phí CostCenterId	Mã trung tâm chi phí tài chính được tính cho khoản lương.
Mô tả Cho biết đơn vị GL hoặc trung tâm chi phí cụ thể gắn với chi phí lương. Thuộc tính này cung cấp góc nhìn tài chính về quy trình, giúp tổ chức đối chiếu các điểm kém hiệu quả trong xử lý, chẳng hạn chi phí làm lại, với từng đơn vị kinh doanh. Vì sao điều này quan trọng Giúp phân tích quy trình phù hợp với cấu trúc báo cáo tài chính. Lấy dữ liệu ở đâu Các trường Labor Distribution. Ví dụ TTCP-500TTCP-900CC-120

Bắt buộc Nên có Không bắt buộc

Hoạt động xử lý bảng lương

Các bước và mốc quan trọng này ghi lại toàn bộ vòng đời của một đợt chạy bảng lương, từ lúc nhập giờ làm đến khi thanh toán xong.

9 Nên có 6 Không bắt buộc

	Hoạt động	Mô tả
	Đã chi trả	Ngày tiền được chuyển cho nhân viên. Đây thường là sự kiện được tính dựa trên ngày ghi trên séc trong đợt tính lương.
Vì sao điều này quan trọng Kết quả chính của quy trình. Cần thiết để tính “Thời gian hoàn tất nghĩa vụ khai thuế”. Lấy dữ liệu ở đâu Lịch sử lương; trường “Check Date”. Thu thập Xác định bằng cách so sánh trường Check Date với ngày hệ thống Loại sự kiện calculated
	Đã công bố phiếu lương	Phiếu lương điện tử được cung cấp cho nhân viên qua cổng tự phục vụ iPay. Thường được lên lịch dựa trên ngày chi trả.
Vì sao điều này quan trọng Hỗ trợ theo dõi “Thời gian công bố phiếu lương” và phân tích mức độ hài lòng của nhân viên. Lấy dữ liệu ở đâu Suy ra từ cài đặt hệ thống (quy tắc cung cấp phiếu lương) áp dụng cho Check Date. Thu thập Xác định bằng cách so sánh trường Check Date với quy tắc công bố Loại sự kiện inferred
	Đã gửi bảng chấm công	Ghi nhận thời điểm nhân viên hoặc quản lý gửi dữ liệu thời gian và chấm công của kỳ lương. Dữ liệu được lấy trực tiếp từ nhật ký kiểm tra của mô-đun Time & Attendance trong ADP Workforce Now.
Vì sao điều này quan trọng Bắt đầu tính thời gian của chu kỳ tính lương. Chậm trễ ở bước này sẽ ảnh hưởng đến các bước sau, làm giảm thời gian chuyên viên tính lương có để kiểm tra dữ liệu. Lấy dữ liệu ở đâu Nhật ký kiểm tra ADP Time & Attendance; lọc 'Status Change' thành 'Submitted' trên các đối tượng Timecard. Thu thập Ghi nhận khi giao dịch 'Submit Timecard' được thực hiện Loại sự kiện explicit
	Đã khởi tạo hồ sơ tính lương	Xảy ra khi lô tính lương được tạo hoặc mở cho kỳ mới, qua đó khởi tạo hồ sơ tính lương cho nhân viên. Xác định dựa trên dấu thời gian tạo bản ghi Paydata trong lô đang hoạt động.
Vì sao điều này quan trọng Xác định thời điểm bắt đầu của khoảng thời gian tính lương cụ thể. Dùng để đo 'Incentive Data Integration Lag' khi so sánh với dấu thời gian nhập dữ liệu. Lấy dữ liệu ở đâu Mô-đun Payroll; dấu thời gian tạo Paydata Batch Header hoặc mục nhập đầu tiên trong Paydata Grid. Thu thập So sánh trường trạng thái trước và sau khi tạo lô Loại sự kiện inferred
	Đã phê duyệt bảng chấm công	Ghi nhận việc quản lý phê duyệt bảng chấm công, xác nhận số giờ để xử lý tính lương. Đây là bước kiểm soát quan trọng, chuyển dữ liệu từ T&A sang mô-đun Payroll.
Vì sao điều này quan trọng Cần thiết cho bảng điều khiển 'Timesheet Approval Cycle Times'. Giúp xác định điểm nghẽn do quản lý gây ra, có thể làm chậm tiến độ xử lý. Lấy dữ liệu ở đâu Nhật ký kiểm tra ADP Time & Attendance; lọc 'Status Change' thành 'Approved'. Thu thập Ghi nhận khi giao dịch 'Approve Timecard' được thực hiện Loại sự kiện explicit
	Đã phê duyệt hồ sơ lương	Chính thức chấp nhận đợt tính lương, khóa để không thể chỉnh sửa thêm và cho phép chuyển tiền. Đây là bước “Finalize” trong ADP WFN.
Vì sao điều này quan trọng Mốc cuối cùng của giai đoạn xử lý lương, đồng thời đánh dấu thời điểm bắt đầu chi trả. Lấy dữ liệu ở đâu Quy trình xử lý lương; trạng thái của đợt tính lương chuyển thành “Finalized” hoặc “Committed”. Thu thập Ghi nhận khi thực hiện giao dịch “Finalize Payroll” Loại sự kiện explicit
	Đã tạo tệp chuyển khoản ngân hàng	Tạo tệp NACHA/ACH để chuyển lương trực tiếp vào tài khoản. Thường được kích hoạt ngay sau khi hoàn tất bước “Finalize”.
Vì sao điều này quan trọng Theo dõi “Thời gian tạo tệp chuyển khoản ngân hàng” để bảo đảm các bước bàn giao kỹ thuật không làm chậm việc chi trả. Lấy dữ liệu ở đâu Nhật ký đầu ra/báo cáo; thời điểm tạo “ACH File” hoặc “Direct Deposit File”. Thu thập Ghi nhận khi tạo tệp đầu ra Loại sự kiện explicit
	Đã tính lương gộp	Hệ thống thực hiện phép tính số giờ nhân với mức lương, rồi cộng các khoản thu nhập bổ sung. Sự kiện này được xác định dựa trên dấu thời gian hoàn tất của quy trình lô 'Calculate Payroll'.
Vì sao điều này quan trọng Bước xử lý cốt lõi. Nếu sự kiện xảy ra nhiều lần, có thể hồ sơ đang đi qua vòng lặp làm lại, thường được trực quan hóa trong 'Payroll Preview Loop Analysis'. Lấy dữ liệu ở đâu Nhật ký kiểm tra Payroll; thời điểm hoàn tất thao tác 'Calculate' trên Pay Group Batch cụ thể. Thu thập Xác định dựa trên dấu thời gian hoàn tất của tác vụ tính toán Loại sự kiện inferred
	Đánh dấu ngoại lệ kiểm toán	Cho biết hệ thống phát hiện vi phạm quy tắc xác thực trong khi tính lương, chẳng hạn như lương thực nhận âm hoặc thiếu khu vực tính thuế. Ghi nhận sự kiện này khi thông báo lỗi xuất hiện trong kết quả tính lương.
Vì sao điều này quan trọng Chỉ số đầu vào cho “Bảng theo dõi xử lý ngoại lệ kiểm toán”. Số lượng lớn thường cho thấy vấn đề về chất lượng dữ liệu ở các bước trước. Lấy dữ liệu ở đâu Nhật ký lỗi xử lý lương hoặc báo cáo kết quả “Verify Payroll”. Thu thập Ghi nhận khi hệ thống tạo lỗi xác thực Loại sự kiện explicit
	Đã áp dụng khoản khấu trừ phúc lợi	Áp dụng các quy tắc phúc lợi (y tế, 401k) vào tổng lương trước khấu trừ. Thường diễn ra đồng thời với bước tính lương nhưng được xem là bước riêng để phục vụ kiểm toán.
Vì sao điều này quan trọng Đối chiếu với sự kiện “Đánh dấu ngoại lệ kiểm toán” để xác định liệu logic tính phúc lợi có gây lỗi tuân thủ hay không. Lấy dữ liệu ở đâu Suy ra từ việc tạo hoặc cập nhật các khoản khấu trừ trong Paydata Grid sau khi chạy tính lương. Thu thập So sánh các trường khấu trừ trước và sau khi tính lương Loại sự kiện inferred
	Đã ghi nhận điều chỉnh hồi tố	Xảy ra khi áp dụng chỉnh sửa dữ liệu lịch sử vào hồ sơ lương đã đóng, thường ảnh hưởng đến kỳ tiếp theo. Sự kiện này giúp xác định lỗi được phát hiện sau khi quy trình chính thức kết thúc.
Vì sao điều này quan trọng Cần thiết để phân tích “Số lượng điều chỉnh hồi tố”, qua đó nhận biết các bước kiểm tra chất lượng dữ liệu trước đó chưa phát hiện được lỗi. Lấy dữ liệu ở đâu Lịch sử lương; giao dịch mới được ghi nhận với “Effective Date” trong quá khứ. Thu thập Ghi nhận khi thực hiện giao dịch “Post Adjustment” Loại sự kiện explicit
	Đã hoàn tất khai thuế	Đánh dấu việc hoàn tất khai thuế theo quy định cho kỳ lương. Với khách hàng sử dụng ADP Tax Service, đây là thời điểm ADP xác nhận đã đóng hồ sơ khai thuế.
Vì sao điều này quan trọng Theo dõi rủi ro tuân thủ. Chậm trễ ở bước này có thể dẫn đến tiền phạt. Lấy dữ liệu ở đâu Phân hệ thuế; cập nhật trạng thái khai thuế cuối quý hoặc cuối kỳ. Thu thập Cần phân tích hệ thống Loại sự kiện inferred
	Đã nhập dữ liệu thưởng	Ghi nhận việc nhập dữ liệu lương bên ngoài, chẳng hạn như hoa hồng hoặc tiền thưởng, qua tiện ích ADP Import. Sự kiện này theo dõi thời điểm các nguồn thu nhập bổ sung được gắn vào hồ sơ tính lương.
Vì sao điều này quan trọng Rất quan trọng để xác định độ trễ tích hợp. Nhập dữ liệu muộn thường buộc phải tính toán lại và làm phát sinh vòng lặp làm lại. Lấy dữ liệu ở đâu Nhật ký tích hợp/nhập ADP; dấu thời gian thành công của tác vụ 'Paydata Import'. Thu thập Ghi nhận khi giao dịch 'Import Paydata' được thực hiện Loại sự kiện explicit
	Đã thực hiện chỉnh sửa dữ liệu	Chuyên viên xử lý lương chỉnh sửa thủ công Paydata Grid để khắc phục lỗi hoặc điều chỉnh số tiền. Ghi nhận qua nhật ký kiểm toán ở cấp trường.
Vì sao điều này quan trọng Chỉ số chính cho “Tần suất chỉnh sửa dữ liệu thủ công”. Tỷ lệ chỉnh sửa cao có thể cho thấy tự động hóa đang gặp lỗi. Lấy dữ liệu ở đâu Nhật ký kiểm toán Paydata Grid; các thao tác “Update” của người dùng trên dòng lương. Thu thập Ghi nhận khi thực hiện giao dịch “Update Paydata” Loại sự kiện explicit
	Đã xem trước kết quả tính lương	Tạo bảng lương hoặc báo cáo “Preview Payroll” để người phụ trách kiểm tra. Bước này xác thực kết quả tính lương trước khi chốt.
Vì sao điều này quan trọng Dùng trong “Phân tích vòng lặp xem trước bảng lương”. Xem trước quá nhiều lần có thể cho thấy người dùng chưa tin tưởng dữ liệu. Lấy dữ liệu ở đâu Nhật ký hệ thống; thời điểm tạo báo cáo “Preview Payroll”. Thu thập Ghi nhận khi thực hiện giao dịch “Generate Preview” Loại sự kiện explicit

Nên có Không bắt buộc

Hướng dẫn trích xuất

Cách lấy dữ liệu từ ADP Workforce Now

Các bước

Đăng nhập ADP Workforce Now bằng tài khoản có quyền Administrator hoặc Payroll Practitioner.
Mở Reports & Analytics, rồi chọn Custom Reports trong menu dashboard.
Nhấp vào New Custom Report và chọn miền dữ liệu Payroll. Tùy phiên bản, mục này có thể mang tên Pay Data hoặc Payroll Register.
Trong bước Field Selection, tìm và thêm mã định danh duy nhất cho trường hợp. Chọn File Number hoặc Associate ID kết hợp với Pay Frequency và Pay Period Number để tạo PayrollRecordId.
Chọn tất cả trường ngày cần thiết để ánh xạ hoạt động. Bạn phải thêm Pay Period Start Date, Pay Period End Date, Check Date, Period End Date và Calculation Date. Lưu ý, một số trường kiểm tra như Timecard Approval Date có thể cần được nối từ mô-đun Time & Attendance nếu không có trong khung nhìn chính.
Thêm các trường tài chính và phân loại, gồm Gross Pay, Net Pay, Department, Cost Center và Tax Jurisdiction.
Thêm khối Audit Trail hoặc Field Changes vào bố cục báo cáo nếu có. Đây là bước quan trọng để ghi nhận các sự kiện thủ công như Data Correction Performed. Nếu không thể nối dữ liệu này trong cùng một báo cáo, hãy tạo Audit Report riêng rồi nối dữ liệu bên ngoài theo Employee ID và Pay Period.
Cấu hình bộ lọc để loại trừ séc đã hủy và giới hạn khoảng ngày theo kỳ phân tích mong muốn (ví dụ: Last 12 Months).
Mở bước Sort & Total, sắp xếp theo Pay Period Start Date rồi đến Associate ID để dữ liệu có thứ tự hợp lý.
Chuyển đến bước Run/Schedule. Chọn Run Now để kiểm tra, sau đó thiết lập Schedule định kỳ để xuất tệp CSV hoặc Excel.
Sau khi tạo báo cáo thô ở định dạng rộng, dùng công cụ hoặc tập lệnh ETL để chuyển đổi dữ liệu. Bạn cần chuyển các cột ngày thành hàng riêng trong nhật ký sự kiện (Hoạt động).
Trước khi tải lên ProcessMind, xác nhận tệp CSV cuối cùng có đủ các cột bắt buộc: PayrollRecordId, ActivityName, EventDateTime và SourceSystem.

Cấu hình

Loại báo cáo: Báo cáo tùy chỉnh tiêu chuẩn
Miền dữ liệu: Payroll / Pay Data Dictionary
Định dạng đầu ra: Giá trị phân tách bằng dấu phẩy (CSV)
Khoảng ngày nên dùng: 12 đến 24 tháng gần nhất để phân tích xu hướng
Bộ lọc chính: Pay Group Code (chọn các nhóm cần thiết), Company Code (nếu có nhiều pháp nhân), Status là Active hoặc Leave
Mức độ chi tiết: Một hàng cho mỗi nhân viên trong mỗi kỳ trả lương (dữ liệu thô), chuyển thành nhiều hàng cho mỗi nhân viên (dữ liệu cuối)
Quyền cần có: Xem dữ liệu bảng lương, xem nhật ký kiểm tra, tạo báo cáo tùy chỉnh
Thiết lập định dạng: Chọn định dạng ngày ISO 8601 (YYYY-MM-DD HH:MM:SS) trong tùy chọn người dùng để tránh nhầm lẫn

Truy vấn mẫu sql

/* 
ADP Workforce Now does not accept SQL queries from end-users. 
The following configuration block represents the Transformation Logic required to convert the ADP Custom Report export (Wide Format) into the Process Mining Event Log (Long Format).

Input Source: ADP_Custom_Payroll_Export.csv
Logic Language: Pseudo-ETL/Config
*/

TRANSFORMATION_CONFIG {

  GLOBAL_SETTINGS {
    SOURCE_SYSTEM: "ADP Workforce Now"
    CASE_ID_FORMULA: CONCATENATE(Field_AssociateID, "-", Field_PayPeriodNumber, "-", Field_Year)
    LAST_DATA_UPDATE: SYSTEM_TIMESTAMP()
  }

  ACTIVITY_MAPPING_RULES {

    /* 1. Time Sheet Submitted */
    RULE "Time Sheet Submitted" {
      IF Field_Timecard_Submit_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Time Sheet Submitted",
          TIMESTAMP: Field_Timecard_Submit_Date,
          ATTRIBUTES: [PayrollSpecialistName: Field_Timecard_User, IsManualIntervention: "False"]
        )
    }

    /* 2. Time Sheet Approved */
    RULE "Time Sheet Approved" {
      IF Field_Timecard_Approval_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Time Sheet Approved",
          TIMESTAMP: Field_Timecard_Approval_Date,
          ATTRIBUTES: [PayrollSpecialistName: Field_Manager_Name, IsManualIntervention: "True"]
        )
    }

    /* 3. Payroll Record Initialized */
    RULE "Payroll Record Initialized" {
      IF Field_Pay_Period_Start_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Payroll Record Initialized",
          TIMESTAMP: Field_Pay_Period_Start_Date,
          ATTRIBUTES: [PayGroupCode: Field_PayGroup, IsRetrospective: "False"]
        )
    }

    /* 4. Incentive Data Imported */
    RULE "Incentive Data Imported" {
      IF Field_Import_Batch_Date IS NOT NULL AND Field_Batch_Type == "Import" THEN
        CREATE_EVENT(
          ACTIVITY: "Incentive Data Imported",
          TIMESTAMP: Field_Import_Batch_Date,
          ATTRIBUTES: [IsManualIntervention: "False"]
        )
    }

    /* 5. Gross Pay Calculated */
    RULE "Gross Pay Calculated" {
      IF Field_Calc_DateTime IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Gross Pay Calculated",
          TIMESTAMP: Field_Calc_DateTime,
          ATTRIBUTES: [GrossPayAmount: Field_Gross_Pay, DepartmentCode: Field_Home_Dept]
        )
    }

    /* 6. Benefits Deductions Applied */
    RULE "Benefits Deductions Applied" {
      /* Often occurs simultaneous to Calc, adding 1 second for logical sort */
      IF Field_Calc_DateTime IS NOT NULL AND Field_Total_Deductions > 0 THEN
        CREATE_EVENT(
          ACTIVITY: "Benefits Deductions Applied",
          TIMESTAMP: DATE_ADD(Field_Calc_DateTime, 1, "SECOND"),
          ATTRIBUTES: [GrossPayAmount: Field_Gross_Pay]
        )
    }

    /* 7. Audit Exception Flagged */
    RULE "Audit Exception Flagged" {
      IF Field_Error_Message_Timestamp IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Audit Exception Flagged",
          TIMESTAMP: Field_Error_Message_Timestamp,
          ATTRIBUTES: [IsManualIntervention: "False"]
        )
    }

    /* 8. Data Correction Performed */
    RULE "Data Correction Performed" {
      IF Field_Audit_Change_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Data Correction Performed",
          TIMESTAMP: Field_Audit_Change_Date,
          ATTRIBUTES: [PayrollSpecialistName: Field_Audit_User, IsManualIntervention: "True"]
        )
    }

    /* 9. Payroll Result Previewed */
    RULE "Payroll Result Previewed" {
      IF Field_Preview_Run_DateTime IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Payroll Result Previewed",
          TIMESTAMP: Field_Preview_Run_DateTime,
          ATTRIBUTES: [IsManualIntervention: "True"]
        )
    }

    /* 10. Payroll Record Approved */
    RULE "Payroll Record Approved" {
      IF Field_Finalize_DateTime IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Payroll Record Approved",
          TIMESTAMP: Field_Finalize_DateTime,
          ATTRIBUTES: [PayrollSpecialistName: Field_Finalizer_User, IsManualIntervention: "True"]
        )
    }

    /* 11. Bank Transfer File Generated */
    RULE "Bank Transfer File Generated" {
      /* Logic: Usually occurs 2 hours after Finalize or at specific cutoff */
      IF Field_ACH_File_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Bank Transfer File Generated",
          TIMESTAMP: Field_ACH_File_Date,
          ATTRIBUTES: [IsManualIntervention: "False"]
        )
    }

    /* 12. Payment Executed */
    RULE "Payment Executed" {
      IF Field_Check_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Payment Executed",
          TIMESTAMP: Field_Check_Date,
          ATTRIBUTES: [GrossPayAmount: Field_Gross_Pay, IsRetrospective: "False"]
        )
    }

    /* 13. Pay Slip Published */
    RULE "Pay Slip Published" {
      IF Field_Advice_Available_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Pay Slip Published",
          TIMESTAMP: Field_Advice_Available_Date,
          ATTRIBUTES: [IsManualIntervention: "False"]
        )
    }

    /* 14. Tax Filing Completed */
    RULE "Tax Filing Completed" {
      IF Field_Tax_Filing_Confirmation_Date IS NOT NULL THEN
        CREATE_EVENT(
          ACTIVITY: "Tax Filing Completed",
          TIMESTAMP: Field_Tax_Filing_Confirmation_Date,
          ATTRIBUTES: [TaxJurisdictionCode: Field_Tax_State, IsManualIntervention: "False"]
        )
    }

    /* 15. Retrospective Adjustment Posted */
    RULE "Retrospective Adjustment Posted" {
      IF Field_Adjustment_Run_Date IS NOT NULL AND Field_Run_Type == "Adjustment" THEN
        CREATE_EVENT(
          ACTIVITY: "Retrospective Adjustment Posted",
          TIMESTAMP: Field_Adjustment_Run_Date,
          ATTRIBUTES: [IsRetrospective: "True", IsManualIntervention: "True"]
        )
    }
  }
}

Các bước

Lấy thông tin xác thực API từ ADP Marketplace, gồm Client ID, Client Secret và chứng chỉ SSL Client Certificate (các tệp PEM và Key) gắn với ứng dụng của bạn.
Kiểm tra ứng dụng đã được cấp các quyền cần thiết: Payroll (read), Worker (read) và Time (read).
Cài các thư viện Python cần thiết bằng pip: requests, pandas và pyOpenSSL (thường cần để xử lý TLS hai chiều).
Cấu hình tập lệnh Python bên dưới với các endpoint ADP API và đường dẫn đến tệp thông tin xác thực của bạn.
Tập lệnh tạo phiên bảo mật bằng TLS hai chiều để xác thực với ADP Token Endpoint.
Trước tiên, tập lệnh truy vấn Time and Labor Management API để lấy các thay đổi trạng thái bảng chấm công trong kỳ cần phân tích.
Tiếp theo, tập lệnh truy vấn Payroll Output API (payroll-v1) để lấy dữ liệu Pay Statement dạng JSON chi tiết của từng nhân viên.
Tập lệnh duyệt cấu trúc JSON lồng nhau để tìm dấu thời gian của các sự kiện cụ thể như tính toán, phê duyệt và tạo tệp.
Tập lệnh dùng điều kiện để suy ra các hoạt động như Audit Exception Flagged bằng cách kiểm tra các mảng thông báo/cảnh báo trong phản hồi.
Dữ liệu từ Time và Payroll được kết hợp dựa trên AssociateOID, mã định danh nhân viên duy nhất trong ADP.
Danh sách sự kiện cuối cùng được chuyển thành Pandas DataFrame và định dạng theo cấu trúc event log của ProcessMind.
Chạy tập lệnh để tạo tệp CSV đầu ra. Kiểm tra tiêu đề cột có đúng yêu cầu trước khi tải lên ProcessMind.

Cấu hình

Client ID và Secret: Lấy thông tin này từ ADP Developer Portal cho ứng dụng của bạn.
Chứng chỉ SSL: Đường dẫn đến các tệp client.pem và client.key. ADP yêu cầu TLS hai chiều (mTLS) để giao tiếp qua API.
URL cơ sở của API: Thường là https://api.adp.com, nhưng có thể khác tùy môi trường (ví dụ: wfn-api.adp.com).
Khoảng ngày: Nên trích xuất dữ liệu trong khoảng 3 đến 6 tháng mỗi lần để đáp ứng giới hạn phân trang và thời gian chờ của API.
Kích thước trang: Đặt tham số $top (giới hạn) ở mức 50 hoặc 100 bản ghi mỗi yêu cầu để tăng tốc độ xử lý mà không vượt quá thời gian chờ.
Mã công ty: Lọc theo Organization Unit hoặc Company Code nếu phiên bản ADP của bạn có nhiều pháp nhân.
AssociateOID: Đây là khóa chính để kết hợp dữ liệu Time và Payroll, khác với Employee ID hiển thị.

Truy vấn mẫu python

import requests
import pandas as pd
import json
from datetime import datetime
import uuid

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
class=class="hl-string">"hl-comment"># Replace these placeholders with your actual ADP credentials and paths
ADP_CLIENT_ID = class="hl-string">"[Your ADP Client ID]"
ADP_CLIENT_SECRET = class="hl-string">"[Your ADP Client Secret]"
CERT_PATH = class="hl-string">"path/to/your/client_certificate.pem"
KEY_PATH = class="hl-string">"path/to/your/client_private_key.key"
TOKEN_URL = class="hl-string">"https://api.adp.com/auth/oauth/v2/token"
PAYROLL_API_URL = class="hl-string">"https://api.adp.com/payroll/v1/payroll-output"
TIME_API_URL = class="hl-string">"https://api.adp.com/time/v1/time-cards"

class=class="hl-string">"hl-comment"># Output File
OUTPUT_FILENAME = class="hl-string">"ADP_Payroll_Event_Log.csv"

class=class="hl-string">"hl-comment"># === AUTHENTICATION ===
def get_access_token():
    class=class="hl-string">"hl-comment"># ADP requires mutual TLS (mTLS) for authentication
    payload = {
        class="hl-string">'client_id': ADP_CLIENT_ID,
        class="hl-string">'client_secret': ADP_CLIENT_SECRET,
        class="hl-string">'grant_type': class="hl-string">'client_credentials'
    }
    try:
        response = requests.post(
            TOKEN_URL,
            data=payload,
            cert=(CERT_PATH, KEY_PATH),
            verify=True
        )
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except Exception as e:
        print(fclass="hl-string">"Authentication failed: {str(e)}")
        return None

class=class="hl-string">"hl-comment"># === DATA EXTRACTION ===
def fetch_adp_data(url, token, params=None):
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}',
        class="hl-string">'Accept': class="hl-string">'application/json'
    }
    all_records = []
    
    class=class="hl-string">"hl-comment"># Simple pagination loop (ADP uses class="hl-string">'skip' and class="hl-string">'top' or class="hl-string">'next' links)
    class=class="hl-string">"hl-comment"># This is a simplified implementation assuming standard offset pagination
    skip = 0
    limit = 50
    fetching = True
    
    while fetching:
        current_params = params.copy() if params else {}
        current_params[class="hl-string">'$skip'] = skip
        current_params[class="hl-string">'$top'] = limit
        
        try:
            response = requests.get(
                url, 
                headers=headers, 
                params=current_params, 
                cert=(CERT_PATH, KEY_PATH)
            )
            if response.status_code != 200:
                break
                
            data = response.json()
            class=class="hl-string">"hl-comment"># Adjust key based on actual API response structure (e.g., class="hl-string">'payrollOutputs', class="hl-string">'timeCards')
            class=class="hl-string">"hl-comment"># Using generic list detection for the script
            key = next((k for k in data.keys() if isinstance(data[k], list)), None)
            
            if not key or len(data[key]) == 0:
                fetching = False
            else:
                all_records.extend(data[key])
                skip += limit
                
        except Exception:
            fetching = False
            
    return all_records

class=class="hl-string">"hl-comment"># === EVENT LOG GENERATION ===
def generate_event_log(payroll_data, time_data):
    event_log = []
    
    class=class="hl-string">"hl-comment"># Index time data by AssociateOID for quick lookup
    time_map = {item.get(class="hl-string">'associateOID'): item for item in time_data}

    for pay_record in payroll_data:
        class=class="hl-string">"hl-comment"># Basic Attributes
        associate_id = pay_record.get(class="hl-string">'associateOID', class="hl-string">'Unknown')
        pay_period_start = pay_record.get(class="hl-string">'payPeriodStartDate', class="hl-string">'')
        class=class="hl-string">"hl-comment"># Create a unique Case ID using AssociateID and Pay Period
        case_id = fclass="hl-string">"{associate_id}-{pay_period_start}"
        
        dept_code = pay_record.get(class="hl-string">'worker', {}).get(class="hl-string">'homeOrganizationalUnits', [{}])[0].get(class="hl-string">'nameCode', {}).get(class="hl-string">'code', class="hl-string">'Unknown')
        pay_group = pay_record.get(class="hl-string">'payrollGroupCode', class="hl-string">'Main')
        gross_pay = pay_record.get(class="hl-string">'grossPayAmount', 0.0)
        tax_jur = pay_record.get(class="hl-string">'taxJurisdiction', {}).get(class="hl-string">'code', class="hl-string">'US')
        last_update = datetime.now().isoformat() class=class="hl-string">"hl-comment"># Using extraction time as fallback if record update time missing

        class=class="hl-string">"hl-comment"># Helper to append event
        def add_event(activity, timestamp, specialist=None, manual=False, retro=False):
            if timestamp:
                event_log.append({
                    class="hl-string">'PayrollRecordId': case_id,
                    class="hl-string">'ActivityName': activity,
                    class="hl-string">'EventDateTime': timestamp,
                    class="hl-string">'SourceSystem': class="hl-string">'ADP Workforce Now',
                    class="hl-string">'LastDataUpdate': last_update,
                    class="hl-string">'PayrollSpecialistName': specialist if specialist else class="hl-string">'System Agent',
                    class="hl-string">'DepartmentCode': dept_code,
                    class="hl-string">'PayGroupCode': pay_group,
                    class="hl-string">'GrossPayAmount': gross_pay,
                    class="hl-string">'TaxJurisdictionCode': tax_jur,
                    class="hl-string">'IsManualIntervention': manual,
                    class="hl-string">'IsRetrospective': retro
                })

        class=class="hl-string">"hl-comment"># --- ACTIVITY 1: Time Sheet Submitted ---
        class=class="hl-string">"hl-comment"># Derived from Time API
        t_card = time_map.get(associate_id)
        if t_card and t_card.get(class="hl-string">'submissionDateTime'):
            add_event(class="hl-string">"Time Sheet Submitted", t_card[class="hl-string">'submissionDateTime'], specialist=t_card.get(class="hl-string">'submittedBy'))

        class=class="hl-string">"hl-comment"># --- ACTIVITY 2: Time Sheet Approved ---
        class=class="hl-string">"hl-comment"># Derived from Time API
        if t_card and t_card.get(class="hl-string">'approvalDateTime'):
            add_event(class="hl-string">"Time Sheet Approved", t_card[class="hl-string">'approvalDateTime'], specialist=t_card.get(class="hl-string">'approvedBy'))

        class=class="hl-string">"hl-comment"># --- ACTIVITY 3: Payroll Record Initialized ---
        class=class="hl-string">"hl-comment"># Creation of the pay data record
        create_time = pay_record.get(class="hl-string">'creationDateTime')
        add_event(class="hl-string">"Payroll Record Initialized", create_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 4: Incentive Data Imported ---
        class=class="hl-string">"hl-comment"># Check for specific earnings codes related to incentives
        earnings = pay_record.get(class="hl-string">'earnings', [])
        for earn in earnings:
            if earn.get(class="hl-string">'typeCode') in [class="hl-string">'BONUS', class="hl-string">'COMMISSION']:
                class=class="hl-string">"hl-comment"># Use entry time of the specific line item
                add_event(class="hl-string">"Incentive Data Imported", earn.get(class="hl-string">'entryDateTime', create_time))
                break class=class="hl-string">"hl-comment"># Capture once per case to avoid duplicates or refine logic for multiple

        class=class="hl-string">"hl-comment"># --- ACTIVITY 5: Gross Pay Calculated ---
        class=class="hl-string">"hl-comment"># When the calculation engine finished
        calc_time = pay_record.get(class="hl-string">'calculationDateTime')
        add_event(class="hl-string">"Gross Pay Calculated", calc_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 6: Benefits Deductions Applied ---
        class=class="hl-string">"hl-comment"># Usually happens same time as calc, but logically distinct
        class=class="hl-string">"hl-comment"># We look for deduction processing timestamp
        deductions = pay_record.get(class="hl-string">'deductions', [])
        if deductions and calc_time:
             add_event(class="hl-string">"Benefits Deductions Applied", calc_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 7: Audit Exception Flagged ---
        class=class="hl-string">"hl-comment"># Check notification messages
        msgs = pay_record.get(class="hl-string">'notificationMessages', [])
        if msgs:
            class=class="hl-string">"hl-comment"># Take the timestamp of the first warning
            add_event(class="hl-string">"Audit Exception Flagged", msgs[0].get(class="hl-string">'generationDateTime', calc_time))

        class=class="hl-string">"hl-comment"># --- ACTIVITY 8: Data Correction Performed ---
        class=class="hl-string">"hl-comment"># Compare modification time vs creation time. If significantly different, assume correction.
        mod_time = pay_record.get(class="hl-string">'modificationDateTime')
        if mod_time and create_time and mod_time > create_time:
            add_event(class="hl-string">"Data Correction Performed", mod_time, manual=True)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 9: Payroll Result Previewed ---
        class=class="hl-string">"hl-comment"># Report generation time
        report_time = pay_record.get(class="hl-string">'reportGenerationDateTime')
        add_event(class="hl-string">"Payroll Result Previewed", report_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 10: Payroll Record Approved ---
        class=class="hl-string">"hl-comment"># Final approval timestamp
        approve_time = pay_record.get(class="hl-string">'approvalDateTime')
        add_event(class="hl-string">"Payroll Record Approved", approve_time, specialist=class="hl-string">"Payroll Manager")

        class=class="hl-string">"hl-comment"># --- ACTIVITY 11: Bank Transfer File Generated ---
        class=class="hl-string">"hl-comment"># Distribution file generation
        dist_time = pay_record.get(class="hl-string">'distribution', {}).get(class="hl-string">'fileGenerationDateTime')
        add_event(class="hl-string">"Bank Transfer File Generated", dist_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 12: Payment Executed ---
        class=class="hl-string">"hl-comment"># The actual check date or payment date
        pay_date = pay_record.get(class="hl-string">'paymentDate')
        class=class="hl-string">"hl-comment"># Convert date-only string to datetime (assuming 9 AM local)
        if pay_date:
            pay_dt_time = fclass="hl-string">"{pay_date}T09:00:00"
            add_event(class="hl-string">"Payment Executed", pay_dt_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 13: Pay Slip Published ---
        class=class="hl-string">"hl-comment"># Usually available on Check Date
        class=class="hl-string">"hl-comment"># Or specific class="hl-string">'publicationDate' if available
        pub_date = pay_record.get(class="hl-string">'payStatementAvailableDateTime')
        if not pub_date and pay_date:
             pub_date = fclass="hl-string">"{pay_date}T08:00:00"
        add_event(class="hl-string">"Pay Slip Published", pub_date)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 14: Tax Filing Completed ---
        class=class="hl-string">"hl-comment"># Tax filing status date
        tax_file_time = pay_record.get(class="hl-string">'taxFiling', {}).get(class="hl-string">'completionDateTime')
        add_event(class="hl-string">"Tax Filing Completed", tax_file_time)

        class=class="hl-string">"hl-comment"># --- ACTIVITY 15: Retrospective Adjustment Posted ---
        class=class="hl-string">"hl-comment"># Check if this record is marked as a retro adjustment
        is_retro = pay_record.get(class="hl-string">'isRetroactive', False)
        if is_retro:
            retro_time = pay_record.get(class="hl-string">'postingDateTime', calc_time)
            add_event(class="hl-string">"Retrospective Adjustment Posted", retro_time, retro=True)

    return pd.DataFrame(event_log)

class=class="hl-string">"hl-comment"># === EXECUTION ===
if __name__ == class="hl-string">"__main__":
    class=class="hl-string">"hl-comment"># 1. Authenticate
    token = get_access_token()
    
    if token:
        class=class="hl-string">"hl-comment"># 2. Fetch Data
        print(class="hl-string">"Fetching Payroll Data...")
        class=class="hl-string">"hl-comment"># Filter for last 90 days - example
        payroll_raw = fetch_adp_data(PAYROLL_API_URL, token)
        
        print(class="hl-string">"Fetching Time Data...")
        time_raw = fetch_adp_data(TIME_API_URL, token)
        
        class=class="hl-string">"hl-comment"># 3. Transform
        print(class="hl-string">"Generating Event Log...")
        df_events = generate_event_log(payroll_raw, time_raw)
        
        class=class="hl-string">"hl-comment"># 4. Export
        if not df_events.empty:
            class=class="hl-string">"hl-comment"># Ensure timestamp format
            df_events[class="hl-string">'EventDateTime'] = pd.to_datetime(df_events[class="hl-string">'EventDateTime']).dt.strftime(class="hl-string">'%Y-%m-%d %H:%M:%S')
            df_events.to_csv(OUTPUT_FILENAME, index=False)
            print(fclass="hl-string">"Success! Event log written to {OUTPUT_FILENAME} with {len(df_events)} rows.")
        else:
            print(class="hl-string">"No events generated.")

Các bước

Xác nhận các tính năng General Ledger Interface, Payroll, Time & Attendance, kiểm tra, nhập dữ liệu, báo cáo và dịch vụ thuế cần thiết đã được bật cho môi trường mục tiêu trong ADP Workforce Now. Xác nhận bạn có quyền xem dữ liệu kiểm tra và báo cáo bảng lương cần thiết. Tên menu và mã giao dịch tùy cấu hình, vì vậy hãy ghi lại đường dẫn áp dụng bằng [Cấu hình theo hệ thống của bạn].
Cấu hình ánh xạ General Ledger Interface cho công ty, nhóm trả lương, thu nhập, khoản khấu trừ, thuế, phòng ban và mã tài khoản cần thiết. Lưu đầu ra giao tiếp được tạo cùng siêu dữ liệu xử lý. Tệp GL là nguồn chính cho số tiền lương và chiều kế toán, còn dữ liệu trích xuất hỗ trợ cung cấp dấu thời gian sự kiện và bằng chứng hoạt động.
Trích xuất dữ liệu nguồn cho kỳ đã chọn từ [Tên bảng của bạn] hoặc tệp xuất tương ứng của ADP Workforce Now. Các nhóm dữ liệu cần có gồm sự kiện kiểm tra Time & Attendance, bản ghi Paydata, bản ghi nhập dữ liệu thưởng, kết quả tính lương, kết quả khấu trừ, thông báo xác thực, bản ghi kiểm tra cấp trường, bảng lương xem trước, bản ghi chốt bảng lương, bản ghi tệp ngân hàng, bản ghi thanh toán, bản ghi công bố phiếu lương, xác nhận kê khai thuế, bản ghi điều chỉnh hồi tố và đầu ra General Ledger Interface.
Thay từng tham chiếu nguồn trong ngoặc vuông ở truy vấn bằng bảng, chế độ xem, báo cáo hoặc tệp xuất đã lưu tạm thực tế trong môi trường. Ánh xạ các trường nguồn sang trường logic trong truy vấn. Không xem dấu thời gian suy luận là bằng chứng kiểm tra trực tiếp nếu chưa ghi lại quy tắc suy luận.
Chuẩn hóa tất cả dấu thời gian nguồn về cùng một múi giờ, ưu tiên UTC, đồng thời chuyển mã định danh nguồn sang dạng văn bản nhất quán. Chuẩn hóa tên hoạt động đúng như trong truy vấn. Chuyển các trường số tiền về cùng một kiểu số và chuẩn hóa giá trị Boolean thành TRUE hoặc FALSE.
Chạy truy vấn trong khoảng ngày có kiểm soát, thường là ba đến sáu tháng. Dùng mã định danh hồ sơ lương làm mã trường hợp. Giữ lại nhiều hàng cho cùng một trường hợp nếu một hoạt động xảy ra nhiều lần, vì ProcessMind đọc event log nguyên trạng và không tự suy ra sự kiện bổ sung.
Kiểm tra cách xử lý bản ghi trùng, thứ tự dấu thời gian và thứ tự ưu tiên nguồn. Truy vấn cố ý dùng UNION ALL để giữ mỗi hoạt động được trích xuất rõ ràng thành một hàng sự kiện. Nếu hoạt động không có sự kiện nguồn trực tiếp, chỉ giữ dấu thời gian nguồn được suy luận đã ghi nhận khi nguồn được cấu hình hỗ trợ suy luận đó.
Xác nhận có đủ cả 15 tên hoạt động, các thuộc tính bắt buộc được điền khi nguồn có dữ liệu và khoảng ngày sự kiện khớp với tham số trích xuất. Đối chiếu tổng lương và chiều kế toán với đầu ra General Ledger Interface cùng bảng lương áp dụng.
Xuất kết quả thành CSV UTF-8 dạng phẳng hoặc định dạng event log khác mà ProcessMind hỗ trợ. Thêm các cột PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention và IsRetrospective. Tải tệp lên ProcessMind, đặt PayrollRecordId làm mã trường hợp, ActivityName làm hoạt động và EventDateTime làm dấu thời gian sự kiện.

Cấu hình

Khoảng ngày: Bắt đầu với dữ liệu của ba đến sáu tháng lương đã hoàn tất. Lấy đủ dữ liệu lịch sử để bao gồm các kỳ trả lương thường lệ, điều chỉnh, tiền thưởng, hoạt động thuế và hiệu chỉnh hồi tố. Dùng [Tham số ngày bắt đầu] và [Tham số ngày kết thúc] để trích xuất tăng dần.
Bộ lọc công ty và nhóm trả lương: Giới hạn dữ liệu theo Company Code, Pay Group Code, pháp nhân và lịch trả lương cần thiết. Dùng [Bộ lọc công ty] nếu môi trường có nhiều công ty.
Phạm vi nguồn: Bao gồm đầu ra General Ledger Interface cùng các nguồn hỗ trợ về bảng lương, Time & Attendance, nhập dữ liệu, kiểm tra, tính toán, thanh toán, phiếu lương, thuế và điều chỉnh. Chỉ riêng tệp GL thường không đủ để xác minh mọi hoạt động trong vòng đời.
Lọc hoạt động: Dùng chính xác 15 giá trị ActivityName trong truy vấn. Không gộp hoạt động thành các nhóm rộng hơn, vì ProcessMind không tự tạo các sự kiện còn thiếu.
Quy tắc dấu thời gian: Xác định múi giờ của nguồn và chuyển đổi nhất quán mọi giá trị EventDateTime và LastDataUpdate. Nếu cần khả năng kiểm tra, hãy giữ dấu thời gian nguồn ban đầu ở lớp lưu tạm.
Cấu hình số tiền và kế toán: Xác nhận cách ánh xạ thu nhập, khoản khấu trừ, thuế, phòng ban, trung tâm chi phí và tài khoản trong cấu hình GL Interface. Đối chiếu GrossPayAmount với nguồn tính lương hoặc bảng lương, không mặc định mọi dòng GL đều là lương gộp.
Lưu giữ dữ liệu kiểm tra: Bật hoặc đảm bảo lưu giữ nhật ký kiểm tra Time & Attendance, bản ghi kiểm tra Paydata cấp trường, thông báo tính toán, bản ghi chốt bảng lương, bản ghi thanh toán và xác nhận kê khai thuế.
Hiệu suất: Lọc theo kỳ trả lương, công ty và nhóm trả lương trước khi kết hợp các nguồn. Nếu được hỗ trợ, lập chỉ mục hoặc phân vùng dữ liệu lưu tạm theo PayrollRecordId, kỳ trả lương, dấu thời gian sự kiện và mã lô. Trích xuất từng phần khi xử lý khoảng thời gian dài.
Quyền truy cập: Cấp quyền truy cập dữ liệu bảng lương, Time & Attendance, General Ledger Interface, kiểm tra, nhập dữ liệu, thanh toán, phiếu lương và dịch vụ thuế. Vai trò, giấy phép, đường dẫn menu và mã giao dịch cụ thể tùy cấu hình ADP Workforce Now.
Kiểm soát suy luận: Ghi rõ trong tài liệu kỹ thuật các sự kiện suy luận như Payroll Record Initialized, Gross Pay Calculated, Benefits Deductions Applied và Payment Executed. Nếu nguồn không hỗ trợ suy luận, hãy loại hàng đó thay vì tạo dấu thời gian giả.
Quản lý tệp: Lưu tệp GL Interface gốc, dữ liệu trích xuất từ nguồn, tham số trích xuất, phiên bản truy vấn và thời điểm chạy để đối chiếu và kiểm tra.

Truy vấn mẫu sql

WITH
params AS (
    SELECT
        CAST('[Start date parameter]' AS TIMESTAMP) AS start_datetime,
        CAST('[End date parameter]' AS TIMESTAMP) AS end_datetime
),

time_sheet_submitted AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)) AS PayrollRecordId,
        'Time Sheet Submitted' AS ActivityName,
        CAST(t.SubmittedDateTime AS TIMESTAMP) AS EventDateTime,
        'ADP Workforce Now' AS SourceSystem,
        CAST(t.LastDataUpdate AS TIMESTAMP) AS LastDataUpdate,
        CAST(t.PayrollSpecialistName AS VARCHAR(255)) AS PayrollSpecialistName,
        CAST(t.DepartmentCode AS VARCHAR(100)) AS DepartmentCode,
        CAST(t.PayGroupCode AS VARCHAR(100)) AS PayGroupCode,
        CAST(t.GrossPayAmount AS DECIMAL(18,2)) AS GrossPayAmount,
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)) AS TaxJurisdictionCode,
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN) AS IsManualIntervention,
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN) AS IsRetrospective
    FROM [Your time and attendance audit table] t
    CROSS JOIN params p
    WHERE t.SubmittedDateTime >= p.start_datetime
      AND t.SubmittedDateTime < p.end_datetime
      AND t.EventType = 'Time Sheet Submitted'
),

time_sheet_approved AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Time Sheet Approved',
        CAST(t.ApprovedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your time and attendance approval table] t
    CROSS JOIN params p
    WHERE t.ApprovedDateTime >= p.start_datetime
      AND t.ApprovedDateTime < p.end_datetime
      AND t.EventType = 'Time Sheet Approved'
),

payroll_record_initialized AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Payroll Record Initialized',
        CAST(t.PaydataCreatedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your Paydata table] t
    CROSS JOIN params p
    WHERE t.PaydataCreatedDateTime >= p.start_datetime
      AND t.PaydataCreatedDateTime < p.end_datetime
),

incentive_data_imported AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Incentive Data Imported',
        CAST(t.ImportedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your incentive import table] t
    CROSS JOIN params p
    WHERE t.ImportedDateTime >= p.start_datetime
      AND t.ImportedDateTime < p.end_datetime
),

gross_pay_calculated AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Gross Pay Calculated',
        CAST(t.CalculationCompletedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your payroll calculation result table] t
    CROSS JOIN params p
    WHERE t.CalculationCompletedDateTime >= p.start_datetime
      AND t.CalculationCompletedDateTime < p.end_datetime
      AND t.ProcessName = 'Calculate Payroll'
),

benefits_deductions_applied AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Benefits Deductions Applied',
        CAST(t.CalculationCompletedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your payroll deduction result table] t
    CROSS JOIN params p
    WHERE t.CalculationCompletedDateTime >= p.start_datetime
      AND t.CalculationCompletedDateTime < p.end_datetime
      AND t.DeductionCategory IN ('Medical', '401k')
),

audit_exception_flagged AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Audit Exception Flagged',
        CAST(t.ErrorGeneratedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your payroll calculation error table] t
    CROSS JOIN params p
    WHERE t.ErrorGeneratedDateTime >= p.start_datetime
      AND t.ErrorGeneratedDateTime < p.end_datetime
),

data_correction_performed AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Data Correction Performed',
        CAST(t.ChangedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        TRUE,
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your Paydata field level audit table] t
    CROSS JOIN params p
    WHERE t.ChangedDateTime >= p.start_datetime
      AND t.ChangedDateTime < p.end_datetime
      AND t.ChangeSource = 'Paydata Grid'
),

payroll_result_previewed AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Payroll Result Previewed',
        CAST(t.PreviewGeneratedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your payroll preview register table] t
    CROSS JOIN params p
    WHERE t.PreviewGeneratedDateTime >= p.start_datetime
      AND t.PreviewGeneratedDateTime < p.end_datetime
),

payroll_record_approved AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Payroll Record Approved',
        CAST(t.FinalizedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your payroll finalization table] t
    CROSS JOIN params p
    WHERE t.FinalizedDateTime >= p.start_datetime
      AND t.FinalizedDateTime < p.end_datetime
),

bank_transfer_file_generated AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Bank Transfer File Generated',
        CAST(t.FileGeneratedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your bank transfer file table] t
    CROSS JOIN params p
    WHERE t.FileGeneratedDateTime >= p.start_datetime
      AND t.FileGeneratedDateTime < p.end_datetime
),

payment_executed AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Payment Executed',
        CAST(t.PaymentDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your payment execution table] t
    CROSS JOIN params p
    WHERE t.PaymentDateTime >= p.start_datetime
      AND t.PaymentDateTime < p.end_datetime
),

pay_slip_published AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Pay Slip Published',
        CAST(t.PublishedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your pay statement publication table] t
    CROSS JOIN params p
    WHERE t.PublishedDateTime >= p.start_datetime
      AND t.PublishedDateTime < p.end_datetime
),

tax_filing_completed AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Tax Filing Completed',
        CAST(t.FilingCompletedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        CAST(COALESCE(t.IsRetrospective, FALSE) AS BOOLEAN)
    FROM [Your tax filing confirmation table] t
    CROSS JOIN params p
    WHERE t.FilingCompletedDateTime >= p.start_datetime
      AND t.FilingCompletedDateTime < p.end_datetime
),

retrospective_adjustment_posted AS (
    SELECT
        CAST(t.PayrollRecordId AS VARCHAR(255)),
        'Retrospective Adjustment Posted',
        CAST(t.AdjustmentPostedDateTime AS TIMESTAMP),
        'ADP Workforce Now',
        CAST(t.LastDataUpdate AS TIMESTAMP),
        CAST(t.PayrollSpecialistName AS VARCHAR(255)),
        CAST(t.DepartmentCode AS VARCHAR(100)),
        CAST(t.PayGroupCode AS VARCHAR(100)),
        CAST(t.GrossPayAmount AS DECIMAL(18,2)),
        CAST(t.TaxJurisdictionCode AS VARCHAR(100)),
        CAST(COALESCE(t.IsManualIntervention, FALSE) AS BOOLEAN),
        TRUE
    FROM [Your retrospective adjustment table] t
    CROSS JOIN params p
    WHERE t.AdjustmentPostedDateTime >= p.start_datetime
      AND t.AdjustmentPostedDateTime < p.end_datetime
)

SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM time_sheet_submitted
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM time_sheet_approved
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM payroll_record_initialized
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM incentive_data_imported
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM gross_pay_calculated
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM benefits_deductions_applied
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM audit_exception_flagged
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM data_correction_performed
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM payroll_result_previewed
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM payroll_record_approved
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM bank_transfer_file_generated
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM payment_executed
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM pay_slip_published
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM tax_filing_completed
UNION ALL
SELECT PayrollRecordId, ActivityName, EventDateTime, SourceSystem, LastDataUpdate, PayrollSpecialistName, DepartmentCode, PayGroupCode, GrossPayAmount, TaxJurisdictionCode, IsManualIntervention, IsRetrospective FROM retrospective_adjustment_posted
ORDER BY PayrollRecordId, EventDateTime, ActivityName;

Sẵn sàng bắt đầu?

Tải mẫu ngay hôm nay để bắt đầu chuyển dữ liệu bảng lương thành sơ đồ thể hiện cách công việc thực sự diễn ra.

Quay lại hướng dẫn cải tiến

Tải mẫu xuống

Khắc phục tình trạng chậm xử lý bảng lương trong ADP Workforce Now ngay hôm nay

Rút ngắn thời gian chu kỳ 30% và ngừng hiệu chỉnh dữ liệu thủ công

Bắt đầu dùng thử miễn phí

Không cần thẻ tín dụng. Thiết lập chỉ mất vài phút.

Mẫu dữ liệu xử lý bảng lương

Mẫu dữ liệu xử lý bảng lương

Thuộc tính xử lý bảng lương

Hoạt động xử lý bảng lương

Hướng dẫn trích xuất

Xuất báo cáo tùy chỉnh từ ADP Workforce Now

Các bước

Cấu hình

Truy vấn mẫu sql

Tập lệnh Python dùng Payroll API của ADP Workforce Now

Các bước

Cấu hình

Truy vấn mẫu python

Trích xuất tệp giao tiếp với sổ cái tổng hợp

Các bước

Cấu hình

Truy vấn mẫu sql

Sẵn sàng bắt đầu?

Khắc phục tình trạng chậm xử lý bảng lương trong ADP Workforce Now ngay hôm nay