> Cải tiến quy trình liên tục > Phải thu > HighRadius > Mẫu dữ liệu

Mẫu dữ liệu khoản phải thu

HighRadius

Thuộc tính khoản phải thu(19) Hoạt động trong quy trình khoản phải thu(13) Hướng dẫn trích xuất dữ liệu(2)

Mẫu dữ liệu khoản phải thu

Mẫu này nêu các thành phần cần thiết để phân tích quy trình lập hóa đơn trong HighRadius. Mẫu cung cấp cấu trúc tổng quan về các điểm dữ liệu, mốc quy trình và bước kỹ thuật cần có để tạo nhật ký sự kiện. Làm theo hướng dẫn này, bạn có thể sơ đồ hóa chu trình thu hồi công nợ và tìm cơ hội cải thiện dòng tiền.

Các thuộc tính dữ liệu cụ thể của quy trình
Các mốc hoạt động tiêu chuẩn
Hướng dẫn trích xuất dữ liệu từ HighRadius

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 khoản phải thu

Bảng này liệt kê các trường dữ liệu nên có để tạo nhật ký sự kiện chi tiết, phục vụ phân tích hiệu quả quản lý hóa đơn và thu hồi công nợ.

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

	Tên	Mô tả
	Dấu thời gian 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 sự kiện diễn ra trong hệ thống HighRadius. Đây là dữ liệu thời gian cần thiết để sắp xếp hoạt động và tính khoảng thời gian giữa các bước trong quy trình. Trong phân tích, dấu thời gian được dùng để tính thời gian xử lý, chẳng hạn số ngày thu tiền bán hàng còn tồn đọng (DSO) hoặc thời gian giải quyết tranh chấp. Thuộc tính này cũng giúp phân tích thông lượng và mức sử dụng tài nguyên trong từng khoảng thời gian. Vì sao điều này quan trọng Cần có thời điểm chính xác để tính mọi KPI dựa trên thời lượng và sắp xếp sự kiện đúng thứ tự. Lấy dữ liệu ở đâu Cột dấu thời gian trong HighRadius Transaction Logs Ví dụ 2023-10-01T08:30:00Z2023-10-15T14:22:10Z2023-11-05T09:15:00Z
	Hoạt động ActivityName	Tên sự kiện hoặc hành động được thực hiện trên hóa đơn.
Mô tả Thuộc tính này ghi lại bước hoặc hành động cụ thể trong quy trình từ bán hàng đến thu tiền. Các sự kiện có thể gồm tạo hóa đơn, gửi thư tự động, gọi điện thu hồi công nợ, ghi nhận tranh chấp và áp dụng khoản thanh toán. Chuyên viên phân tích dùng trường này để dựng lại luồng quy trình và trực quan hóa thứ tự các bước. Những khác biệt trong chuỗi hoạt động giúp xác định sai lệch quy trình, vòng lặp xử lý lại và hành vi không tuân thủ. Vì sao điều này quan trọng Thuộc tính này xác định các bước trong quy trình, rất cần thiết để khám phá quy trình và phân tích biến thể. Lấy dữ liệu ở đâu Bảng HighRadius Activity Log, Notes History hoặc Transaction History Ví dụ Hóa đơn được tạoĐã gửi nhắc thanh toánĐã mở hồ sơ tranh chấpĐã nhận đủ tiền thanh toán
	Số hóa đơn InvoiceNumber	Mã định danh duy nhất của chứng từ hóa đơn, được dùng làm mã hồ sơ.
Mô tả Số hóa đơn là mã định danh chính để theo dõi nghĩa vụ tài chính từ lúc tạo đến khi tất toán. Mã này liên kết mọi hoạt động liên quan, gồm tranh chấp, cam kết thanh toán và các khoản thanh toán, thành một lịch sử hồ sơ duy nhất. Trong phân tích, thuộc tính này dùng để nhóm nhật ký sự kiện thành các phiên bản quy trình riêng biệt. Nhờ đó, bạn có thể tính thời gian xử lý cho từng hóa đơn. Đây cũng là khóa chính để kết hợp dữ liệu quy trình với các bảng dữ liệu chủ khác trong môi trường HighRadius hoặc ERP nguồn. Vì sao điều này quan trọng Thuộc tính này xác định hồ sơ duy nhất và đảm bảo mọi sự kiện được liên kết chính xác với giao dịch tài chính tương ứng. Lấy dữ liệu ở đâu Dữ liệu hóa đơn HighRadius / bảng Header hoặc ERP nguồn, chẳng hạn SAP VBAK, Oracle Headers Ví dụ INV-2023-001900123456US-102938550002931
	Chênh lệch thời hạn thanh toán PaymentTermVariance	Số ngày chênh lệch giữa ngày đến hạn và ngày thanh toán.
Mô tả Thuộc tính được tính toán này đo mức chênh lệch so với điều khoản thanh toán đã thỏa thuận. Số dương cho biết thanh toán trễ hạn, còn số âm cho biết thanh toán sớm. Đây là chỉ số trực tiếp dùng trong Kiểm tra tuân thủ điều khoản thanh toán. Khi tổng hợp mức chênh lệch, doanh nghiệp có thể xác định các khách hàng thường xuyên trả chậm và điều chỉnh điều khoản tín dụng hoặc cách thu hồi công nợ cho phù hợp. Vì sao điều này quan trọng Đo trực tiếp mức độ khách hàng thực hiện đúng điều khoản hợp đồng. Lấy dữ liệu ở đâu Tính từ Ngày đến hạn và Ngày thanh toán Ví dụ 5 ngày-2 ngày0 ngày
	Được tự động hóa IsAutomated	Cờ cho biết hoạt động có được hệ thống thực hiện mà không cần người dùng can thiệp hay không.
Mô tả Thuộc tính đúng/sai này phân biệt các bước do công cụ tự động hóa của HighRadius thực hiện, chẳng hạn gửi thư tự động hoặc đối chiếu tiền thanh toán, với các bước thủ công do người dùng thực hiện. Thuộc tính này rất quan trọng đối với Công cụ theo dõi tự động hóa Cash Application và KPI Tỷ lệ hóa đơn xử lý không cần thao tác thủ công. Chuyên viên phân tích có thể đo lường hiệu quả đầu tư vào tự động hóa và xác định các bước vẫn cần nhiều thao tác thủ công. Vì sao điều này quan trọng Đo lường hiệu quả triển khai HighRadius. Lấy dữ liệu ở đâu Nhật ký hoạt động (kiểm tra người dùng hệ thống và người dùng thực) Ví dụ truefalse
	Giá trị hóa đơn InvoiceAmount	Tổng giá trị tiền tệ của hóa đơn.
Mô tả Thuộc tính này thể hiện tổng số tiền ban đầu tính cho khách hàng. Đây là mốc cơ sở để tính số dư chưa thanh toán và đánh giá tác động tài chính của tranh chấp hoặc chậm trễ. Phân tích process mining dùng trường này để tính trọng số theo giá trị hồ sơ. Ví dụ, trường này giúp phân biệt các khoản thu hồi công nợ giá trị cao cần ưu tiên với những việc hành chính giá trị thấp trong KPI Số lượng tranh chấp giá trị thấp. Vì sao điều này quan trọng Giúp phân tích dựa trên tác động tài chính thay vì chỉ đếm số hồ sơ. Lấy dữ liệu ở đâu Bảng Invoice Header (trường Amount) Ví dụ 1500.00250.5010000.00
	Ngày đến hạn DueDate	Ngày khách hàng có nghĩa vụ thanh toán theo hợp đồng.
Mô tả Ngày đến hạn được xác định dựa trên điều khoản thanh toán áp dụng cho ngày lập hóa đơn. Đây là hạn chót cần đạt trong quy trình thu hồi công nợ. So sánh ngày nhận đủ tiền thanh toán với thuộc tính này giúp tính Tỷ lệ tuân thủ điều khoản thanh toán. Đây là căn cứ quan trọng để xác định khoản thanh toán đúng hạn, trễ hạn hay sớm hạn. Vì sao điều này quan trọng Mốc tham chiếu để xác định khoản thanh toán trễ hạn và tính số ngày thu tiền bán hàng còn tồn đọng (DSO). Lấy dữ liệu ở đâu Bảng Invoice Header (trường Due Date) Ví dụ 2023-11-302023-12-15
	Tên khách hàng CustomerName	Tên tài khoản khách hàng liên kết với hóa đơn.
Mô tả Thuộc tính này xác định đơn vị chịu trách nhiệm thanh toán hóa đơn. Trong HighRadius, thông tin này liên kết với bản ghi dữ liệu chủ của bên nợ. Phân tích hiệu quả quy trình theo tên khách hàng giúp xác định tài khoản cần có chiến lược thu hồi công nợ riêng hoặc thường xuyên thanh toán trễ. Thuộc tính này hỗ trợ bảng điều khiển Ma trận rủi ro và thời gian tồn đọng của khách hàng. Vì sao điều này quan trọng Cần thiết để phân tích theo tài khoản và tìm khách hàng có vấn đề. Lấy dữ liệu ở đâu Dữ liệu chủ khách hàng hoặc Invoice Header Ví dụ Acme CorpGlobal IndustriesTechStart IncRetail Giant Ltd
	Tên nhân viên thu hồi công nợ CollectorName	Tên nhân viên hoặc người dùng phụ trách hoạt động thu hồi công nợ.
Mô tả Thuộc tính này xác định người dùng hoặc nhân viên cụ thể của HighRadius đã thực hiện các hoạt động thủ công như ghi chú cuộc gọi, gửi email riêng hoặc xem xét tranh chấp. Thuộc tính này được dùng trong bảng điều khiển Số liệu tham chiếu về năng suất nhân viên thu hồi công nợ để đánh giá hiệu suất cá nhân và phân bổ khối lượng công việc. Nhờ đó, quản lý có thể xác định nhu cầu đào tạo hoặc phân bổ lại danh mục khách hàng trong đội ngũ thu hồi công nợ. Vì sao điều này quan trọng Cho phép phân tích hiệu suất ở cấp độ tài nguyên. Lấy dữ liệu ở đâu Activity Log / bảng User Ví dụ John DoeJane SmithQuản trị viên hệ thốngCollectionAgent_01
	Đơn vị kinh doanh BusinessUnit	Bộ phận hoặc công ty con nội bộ đã phát hành hóa đơn.
Mô tả Thuộc tính này phân nhóm dữ liệu theo cơ cấu tổ chức, chẳng hạn 'Bán hàng Bắc Mỹ', 'Dịch vụ EMEA' hoặc các bộ phận sản phẩm cụ thể. Thuộc tính này cho phép Kiểm tra tuân thủ điều khoản thanh toán so sánh hiệu quả giữa các bộ phận khác nhau trong tổ chức. Nhờ đó, bạn có thể xác định vấn đề thu hồi công nợ xảy ra trên toàn hệ thống hay chỉ ở một số hoạt động kinh doanh cụ thể. Vì sao điều này quan trọng Cho phép so sánh giữa các bộ phận khác nhau trong tổ chức. Lấy dữ liệu ở đâu Invoice Header / ánh xạ ERP Ví dụ Điện tử tiêu dùngLinh kiện công nghiệpDịch vụ phần mềmBắc Mỹ - miền Tây
	Hệ thống nguồn SourceSystem	Tên hệ thống nơi dữ liệu được tạo ra.
Mô tả Thuộc tính này cho biết dữ liệu được tạo trực tiếp trong các phân hệ của nền tảng HighRadius, chẳng hạn Collections Cloud hoặc Cash Application Cloud, hay được nhập từ hệ thống ERP bên ngoài như SAP hoặc Oracle. Thuộc tính này hữu ích khi truy xuất nguồn gốc và xác thực dữ liệu. Khi phân tích vướng mắc trong quy trình, biết hệ thống nguồn giúp xác định độ trễ đến từ khâu tích hợp hay thời gian xử lý của hệ thống. Vì sao điều này quan trọng Thuộc tính này cho biết nguồn gốc dữ liệu, đặc biệt khi nhiều hệ thống ERP cùng gửi dữ liệu vào HighRadius. Lấy dữ liệu ở đâu Cấu hình hệ thống hoặc thiết lập cố định dựa trên logic trích xuất Ví dụ HighRadiusSAP ECCOracle NetSuiteMicrosoft Dynamics
	Khu vực Region	Khu vực địa lý gắn với hóa đơn hoặc khách hàng.
Mô tả Thuộc tính này xác định khu vực địa lý liên quan đến giao dịch, chẳng hạn 'Bắc Mỹ', 'EMEA' hoặc 'APAC'. Thuộc tính này hỗ trợ so sánh hiệu quả giữa các khu vực và tìm hiểu ảnh hưởng của khác biệt văn hóa hoặc quy định đến hành vi thanh toán và tốc độ thu hồi công nợ. Thông tin này hữu ích cho báo cáo cấp lãnh đạo. Vì sao điều này quan trọng Hỗ trợ phân tích hiệu quả theo khu vực địa lý. Lấy dữ liệu ở đâu Dữ liệu chủ khách hàng hoặc Invoice Header Ví dụ Bắc MỹEMEAMỹ LatinhAPAC
	Lần cập nhật dữ liệu gần nhất LastDataUpdate	Thời điểm dữ liệu được làm mới gần nhất trong mô hình process mining.
Mô tả Thuộc tính này ghi lại thời điểm bản ghi được trích xuất hoặc cập nhật gần nhất trong tập dữ liệu process mining. Nhờ đó, chuyên viên phân tích biết dữ liệu mới đến đâu và báo cáo có thể bị trễ bao lâu. Thuộc tính này đặc biệt quan trọng với các bảng điều khiển theo dõi liên tục, khi người dùng cần biết dữ liệu đang xem là dữ liệu thời gian thực hay ảnh chụp từ ngày hôm trước. Vì sao điều này quan trọng Thuộc tính này giúp bạn biết rõ dữ liệu dùng để tính KPI được cập nhật đến thời điểm nào. Lấy dữ liệu ở đâu Dấu thời gian ETL Ví dụ 2023-12-01T00:00:00Z2023-12-02T06:00:00Z
	Mã lý do tranh chấp DisputeReasonCode	Mã phân loại được gán cho hồ sơ tranh chấp.
Mô tả Thuộc tính này phân loại lý do khách hàng từ chối thanh toán, chẳng hạn 'Sai giá', 'Hàng hóa hư hỏng' hoặc 'Thiếu chứng từ'. Trong HighRadius Deductions Cloud, đây là các mã tiêu chuẩn. Phân tích các mã này giúp xác định nguyên nhân gốc rễ của việc không thanh toán. Tổng hợp dữ liệu giúp doanh nghiệp khắc phục vấn đề ở các khâu trước đó như bán hàng hoặc logistics, vốn gây chậm trễ cho hoạt động thu hồi công nợ. Vì sao điều này quan trọng Rất cần thiết để phân tích nguyên nhân gốc rễ của các khoản thanh toán trễ. Lấy dữ liệu ở đâu Phân hệ quản lý tranh chấp và khoản khấu trừ Ví dụ P01 (Giá cả)Q02 (Chất lượng)S03 (Thiếu hàng)Lỗi quản trị
	Mã tiền tệ CurrencyCode	Mã tiền tệ ISO của số tiền trên hóa đơn.
Mô tả Thuộc tính này cho biết hóa đơn được phát hành bằng loại tiền tệ nào, chẳng hạn USD, EUR hoặc GBP. Khi phân tích quy trình toàn cầu, bạn cần thông tin này để diễn giải chính xác các trường Số tiền hóa đơn và Số dư chưa thanh toán. Nhờ đó, các phép tổng hợp được xử lý đúng, thường bằng cách quy đổi sang tiền tệ báo cáo. Vì sao điều này quan trọng Cần thiết để tổng hợp tài chính chính xác trong môi trường đa tiền tệ. Lấy dữ liệu ở đâu Phần đầu hóa đơn Ví dụ USDEURGBPJPY
	Ngày hứa thanh toán PromiseToPayDate	Ngày khách hàng hứa sẽ thanh toán.
Mô tả Thuộc tính này ghi lại ngày khách hàng cam kết thanh toán trong quá trình trao đổi thu hồi công nợ. Đây là thông tin quan trọng trong HighRadius Collections Cloud. Ngày này được dùng trong Chỉ số độ tin cậy của cam kết thanh toán, bằng cách đối chiếu với ngày thanh toán thực tế để xác định khách hàng có giữ lời hứa hay không. Thông tin này giúp đánh giá chất lượng cam kết và hiệu quả thương lượng của nhân viên thu hồi công nợ. Vì sao điều này quan trọng Thông tin quan trọng để dự báo dòng tiền và đánh giá độ tin cậy của khách hàng. Lấy dữ liệu ở đâu Phân hệ thu hồi công nợ / Bảng giao dịch P2P Ví dụ 2023-12-102023-12-20
	Phân khúc khách hàng CustomerSegment	Phân loại khách hàng theo quy mô, ngành nghề hoặc giá trị chiến lược.
Mô tả Thuộc tính này chia khách hàng thành các nhóm như 'Chiến lược', 'Thị trường tầm trung', 'Doanh nghiệp nhỏ và vừa' hoặc 'Rủi ro cao'. Thuộc tính này được dùng trong dashboard Hiệu quả xử lý tranh chấp để xem các phân khúc có nhận được mức độ dịch vụ khác nhau hay không. Nhờ đó, bạn có thể đảm bảo khách hàng có giá trị cao được quan tâm phù hợp trong quy trình thu hồi công nợ. Vì sao điều này quan trọng Phân tích phân khúc để điều chỉnh theo chiến lược kinh doanh và thỏa thuận mức dịch vụ. Lấy dữ liệu ở đâu Dữ liệu chính khách hàng Ví dụ Khách hàng chiến lược trọng điểmBán buônBán lẻChính phủ
	Số dư chưa thanh toán OpenAmount	Số dư còn nợ trên hóa đơn.
Mô tả Thuộc tính này theo dõi số tiền khách hàng còn nợ và được cập nhật khi ghi nhận các khoản thanh toán một phần. Đây là thông tin thiết yếu để phân tích mức độ phức tạp của thanh toán một phần. Chuyên viên phân tích có thể lọc hóa đơn chưa thanh toán hoặc đã thanh toán một phần, rồi ưu tiên thu hồi các khoản còn nợ có giá trị cao. Vì sao điều này quan trọng Quan trọng để xác định mức dư nợ hiện tại và hiệu quả thu hồi các khoản thanh toán một phần. Lấy dữ liệu ở đâu Phần đầu hóa đơn / Bảng khoản mục chưa thanh toán Ví dụ 0.00500.0012000.00
	Xếp hạng tín dụng CreditRating	Điểm hoặc mức xếp hạng thể hiện khả năng tín dụng của khách hàng.
Mô tả Thuộc tính này thể hiện mức độ rủi ro của khách hàng, thường lấy từ các tổ chức cung cấp thông tin tín dụng hoặc hệ thống chấm điểm nội bộ trong HighRadius Credit Cloud. Đây là một chiều phân tích trong Ma trận rủi ro và tuổi nợ khách hàng. Đối chiếu tuổi nợ với xếp hạng tín dụng giúp phát hiện rủi ro có mức độ phơi nhiễm cao, chẳng hạn khách hàng bị xếp hạng thấp nhưng còn số dư nợ lớn. Vì sao điều này quan trọng Cần thiết để quản lý rủi ro và ưu tiên thu hồi công nợ. Lấy dữ liệu ở đâu Phân hệ quản lý tín dụng / Hồ sơ khách hàng Ví dụ AAAB+Rủi ro caoRủi ro thấp

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

Hoạt động trong quy trình khoản phải thu

Các mục này thể hiện những bước quan trọng và mốc giao dịch cần ghi nhận để trực quan hóa toàn bộ hành trình hóa đơn.

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

	Hoạt động	Mô tả
	Đã đối chiếu sao kê ngân hàng	Công cụ Cash Application hoặc người dùng đã liên kết thành công một dòng trên sao kê ngân hàng với hóa đơn cụ thể này.
Vì sao điều này quan trọng Chỉ số cốt lõi cho 'Tỷ lệ tự động ghi nhận tiền thanh toán'. Phân biệt thời điểm nhận tiền với thời điểm ghi nhận tiền vào hóa đơn. Lấy dữ liệu ở đâu Phân hệ Cash Application; bản ghi đối chiếu được tạo. Thu thập Ghi nhận khi quy tắc đối chiếu được thực thi Loại sự kiện explicit
	Đã giải quyết tranh chấp	Kết thúc quá trình điều tra tranh chấp và đưa ra quyết định, chẳng hạn khoản khấu trừ hợp lệ hoặc khiếu nại không hợp lệ.
Vì sao điều này quan trọng Sự kiện dừng tính thời gian cho 'Thời gian xử lý tranh chấp'. Chậm trễ ở bước này ảnh hưởng trực tiếp đến thời gian tồn đọng. Lấy dữ liệu ở đâu Phân hệ Deductions; trạng thái chuyển thành 'Đã đóng', 'Đã giải quyết' hoặc 'Đã phê duyệt'. Thu thập So sánh trường trạng thái trước và sau Loại sự kiện inferred
	Đã gửi nhắc thanh toán	Thư hoặc email tự động được gửi cho khách hàng qua phân hệ Collections. Sự kiện này ghi nhận việc thực hiện chiến lược nhắc nợ.
Vì sao điều này quan trọng Cần thiết để bảng điều khiển 'Hiệu quả nhắc thu hồi công nợ' đo lường liệu thư từ có thực sự thúc đẩy thanh toán hay không. Lấy dữ liệu ở đâu Tab Correspondence History hoặc nhật ký Communication liên kết với Invoice ID. Thu thập Ghi nhận khi chiến lược nhắc nợ thực hiện một hành động Loại sự kiện explicit
	Đã mở hồ sơ tranh chấp	Tạo khoản khấu trừ hoặc hồ sơ tranh chấp liên kết với hóa đơn, cho biết khách hàng từ chối thanh toán một phần hoặc toàn bộ số dư.
Vì sao điều này quan trọng Kích hoạt phân tích 'Hiệu quả xử lý tranh chấp' và tạm dừng quy trình nhắc nợ thông thường đối với khoản tiền đang tranh chấp. Lấy dữ liệu ở đâu Phân hệ Deductions/Disputes; thời điểm tạo mã hồ sơ liên kết với hóa đơn. Thu thập Ghi nhận khi tạo hồ sơ tranh chấp Loại sự kiện explicit
	Đã nhận đủ tiền thanh toán	Nhận được khoản tiền thanh toán đủ để tất toán công nợ. Đây là ngày thanh toán thực tế dùng để tính thời gian tồn đọng.
Vì sao điều này quan trọng Dùng để tính 'Tỷ lệ thực hiện cam kết thanh toán' và so sánh dòng tiền thực tế với dự kiến. Lấy dữ liệu ở đâu Ngày giao dịch thanh toán gắn với chứng từ tất toán cuối cùng. Thu thập Ngày giao dịch tất toán được ghi nhận Loại sự kiện explicit
	Đã tạo cam kết thanh toán	Cam kết chính thức được ghi vào hệ thống, trong đó khách hàng hứa thanh toán một khoản tiền cụ thể vào một ngày cụ thể.
Vì sao điều này quan trọng Cần thiết cho 'Chỉ số độ tin cậy của cam kết thanh toán', giúp dự báo dòng tiền và đo lường độ tin cậy của khách hàng. Lấy dữ liệu ở đâu Phân hệ hoặc tab P2P (Promise to Pay) liên kết với hóa đơn. Thu thập Ghi nhận khi tạo bản ghi P2P Loại sự kiện explicit
	Hóa đơn đã tất toán	Trạng thái cuối cùng khi số dư hóa đơn về 0 và hóa đơn được đóng trong hệ thống.
Vì sao điều này quan trọng Mốc thời gian kết thúc để tính 'Số ngày thu tiền bán hàng còn tồn đọng trung bình'. Đánh dấu quy trình đã hoàn tất. Lấy dữ liệu ở đâu Bảng Invoice Header; Status = 'Closed' hoặc 'Cleared'. Thu thập So sánh trường trạng thái trước và sau Loại sự kiện inferred
	Hóa đơn được tạo	Hóa đơn được lập hoặc nhập vào nền tảng HighRadius từ hệ thống ERP. Đây là thời điểm bắt đầu quy trình thu hồi công nợ.
Vì sao điều này quan trọng Làm mốc thời gian ban đầu để tính thời gian tồn đọng và số ngày thu tiền bán hàng còn tồn đọng (DSO). Lấy dữ liệu ở đâu Bảng Open Invoices hoặc nhật ký Data Integration, nơi số hóa đơn xuất hiện lần đầu. Thu thập Ghi nhận khi bản ghi được thêm vào bảng tiêu đề hóa đơn Loại sự kiện explicit
	Đã ghi nhận cuộc gọi thu hồi công nợ	Ghi chú thủ công hoặc tương tác do nhân viên thu hồi công nợ ghi lại về hóa đơn này. Cho biết có sự can thiệp của người dùng trong quy trình.
Vì sao điều này quan trọng Hỗ trợ 'Số liệu tham chiếu về năng suất nhân viên thu hồi công nợ' và phân biệt hoạt động thu hồi công nợ tự động với thủ công. Lấy dữ liệu ở đâu Tab Notes/History trong phân hệ Collections. Thu thập Ghi nhận khi người dùng lưu ghi chú cuộc gọi Loại sự kiện explicit
	Đã ghi nhận thanh toán một phần	Khoản thanh toán chỉ bù đắp một phần tổng giá trị hóa đơn, để lại số dư chưa thanh toán.
Vì sao điều này quan trọng Cung cấp dữ liệu cho 'Phân tích độ phức tạp của khoản thanh toán một phần' và cho thấy khả năng có vướng mắc trong quy trình ghi nhận tiền thanh toán. Lấy dữ liệu ở đâu Phân hệ Cash Application; giao dịch thanh toán liên kết với hóa đơn, trong đó Payment Amount < Open Amount. Thu thập Ghi nhận khi đã áp dụng khoản thanh toán nhưng trạng thái vẫn là đang mở Loại sự kiện explicit
	Đã phát hành giấy báo có	Tạo giấy báo có để bù trừ số dư hóa đơn, thường là kết quả của việc giải quyết tranh chấp hợp lệ hoặc hàng hóa được trả lại.
Vì sao điều này quan trọng Theo dõi 'Hiệu quả xử lý giấy báo có' và thời gian từ lúc giải quyết tranh chấp đến khi ghi nhận vào sổ tài chính. Lấy dữ liệu ở đâu Nhật ký đồng bộ ERP hoặc bảng Credit Memo liên kết với Invoice ID ban đầu. Thu thập Ghi nhận khi chứng từ CM được liên kết với hóa đơn Loại sự kiện explicit
	Đã qua ngày đến hạn	Sự kiện được tính toán để cho biết hóa đơn vẫn chưa được thanh toán sau ngày đến hạn theo thỏa thuận.
Vì sao điều này quan trọng Cần thiết cho 'Kiểm tra tuân thủ điều khoản thanh toán'. Đánh dấu thời điểm hóa đơn chuyển từ chưa đến hạn sang quá hạn. Lấy dữ liệu ở đâu Được tính bằng cách so sánh ngày đến hạn của hóa đơn với ngày hiện tại nếu hóa đơn còn mở, hoặc với ngày thanh toán nếu hóa đơn đã đóng. Thu thập Tính bằng cách so sánh trường Due Date với Activity Date Loại sự kiện calculated
	Đang xem xét tranh chấp	Hồ sơ tranh chấp chuyển từ trạng thái 'Mới' sang trạng thái điều tra đang diễn ra. Đây là lúc chuyên viên bắt đầu xử lý thực tế.
Vì sao điều này quan trọng Dùng trong 'Công cụ tìm điểm nghẽn quy trình tranh chấp' để đo thời gian từ lúc tạo hồ sơ đến khi bắt đầu xử lý. Lấy dữ liệu ở đâu Nhật ký kiểm tra của phân hệ Deductions; trạng thái chuyển thành 'Đang xử lý' hoặc 'Đang tìm hiểu'. Thu thập So sánh trường trạng thái trước và sau Loại sự kiện inferred

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

Hướng dẫn trích xuất dữ liệu

Cách lấy dữ liệu từ HighRadius

Các bước

Đăng nhập vào nền tảng HighRadius Integrated Receivables, rồi mở mô-đun Analytics hoặc Reports.
Tìm mẫu báo cáo Transaction History hoặc Open Items. Có thể bạn cần cấu hình ba lượt xuất riêng để lấy toàn bộ vòng đời: dữ liệu tiêu đề hóa đơn, hoạt động thu hồi công nợ và lịch sử tranh chấp/khấu trừ.
Cấu hình lượt xuất tiêu đề hóa đơn: Chọn các cột Số hóa đơn, Tên khách hàng, Số tiền hóa đơn, Ngày hóa đơn, Ngày đến hạn, Ngày tất toán và Trạng thái cuối cùng. Lọc theo Company Code liên quan và khoảng ngày tạo bao phủ thời gian process mining cần phân tích.
Cấu hình lượt xuất hoạt động thu hồi công nợ: Chọn các cột Số hóa đơn, Loại hoạt động (Cuộc gọi, Email, Ghi chú), Ngày hoạt động, Tên nhân viên thu hồi công nợ và thông tin Cam kết thanh toán. Đảm bảo có cả hành động tự động của hệ thống lẫn nhật ký thao tác thủ công của người dùng.
Cấu hình lượt xuất lịch sử tranh chấp: Chọn các cột Số hóa đơn, ID trường hợp tranh chấp, Số tiền tranh chấp, Ngày thay đổi trạng thái, Mã lý do và Ngày giải quyết. Dữ liệu này ghi lại vòng đời các khoản khấu trừ.
Cấu hình lượt xuất thanh toán/ghi nhận tiền: Chọn các cột Số hóa đơn, Mã tham chiếu thanh toán, Ngày thanh toán, Số tiền thanh toán và Loại thanh toán (Một phần, Toàn bộ, Credit Memo).
Chạy các báo cáo này và xuất kết quả sang định dạng CSV.
Nhập các tệp CSV vào cơ sở dữ liệu trung gian hoặc công cụ chuyển đổi dữ liệu, chẳng hạn Python/Pandas hoặc cơ sở dữ liệu SQL, để hợp nhất dữ liệu.
Chạy tập lệnh chuyển đổi trong phần Query để chuẩn hóa tên cột, tính các sự kiện suy ra như Due Date Passed và hợp nhất các nguồn riêng biệt thành một nhật ký sự kiện.
Kiểm tra định dạng ngày tháng nhất quán, nên dùng ISO 8601. Đảm bảo Số hóa đơn có cùng định dạng trong mọi tệp, chẳng hạn loại bỏ số 0 ở đầu nếu các tệp không nhất quán.
Xuất tập kết quả cuối cùng thành một tệp CSV.
Tải tệp CSV cuối cùng lên ProcessMind, ánh xạ InvoiceNumber thành ID trường hợp, EventDateTime thành Dấu thời gian và ActivityName thành Hoạt động.

Cấu hình

Khoảng ngày: Chọn khoảng thời gian cuốn chiếu, chẳng hạn 12 tháng gần nhất, dựa trên Ngày tạo hóa đơn để lấy đầy đủ vòng đời.
Nguồn dữ liệu: Cần quyền truy cập các mô-đun Collections, Cash Application và Deductions trong HighRadius.
Mức độ chi tiết: Đảm bảo báo cáo được tạo ở cấp hóa đơn, không phải cấp tài khoản hoặc cấp tổng hợp.
Quyền người dùng: Người trích xuất cần có quyền Reporting hoặc Analytics Admin để truy cập nhật ký hoạt động lịch sử.
Hành động hệ thống: Bật rõ các bộ lọc để đưa hành động của người dùng Hệ thống hoặc Tự động vào nhật ký Hoạt động, nhằm ghi nhận thư từ tự động.
Cần ánh xạ: Có thể cần ánh xạ loại hoạt động HighRadius sang tên hoạt động process mining tiêu chuẩn, chẳng hạn ánh xạ 'Dunning Letter' thành 'Đã gửi nhắc thanh toán'.

Truy vấn mẫu sql

/* 
Title: HighRadius Event Log Transformation Script
Description: This script assumes the raw CSV exports from HighRadius have been loaded into four staging tables:
1. STG_INVOICES (Header data)
2. STG_ACTIVITIES (Collections notes, calls, correspondence)
3. STG_DISPUTES (Deduction and dispute lifecycle)
4. STG_PAYMENTS (Cash application details)
*/

/* 1. Invoice Created */
SELECT 
    InvoiceNumber AS InvoiceNumber,
    'Invoice Created' AS ActivityName,
    InvoiceDate AS EventDateTime,
    CustomerName AS CustomerName,
    InvoiceAmount AS InvoiceAmount,
    DueDate AS DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    NULL AS PaymentTermVariance,
    0 AS DaysSalesOutstanding
FROM STG_INVOICES

UNION ALL

/* 2. Payment Reminder Sent */
SELECT 
    InvoiceNumber,
    'Payment Reminder Sent',
    ActivityDate,
    CustomerName,
    NULL,
    NULL,
    UserName AS CollectorName,
    CASE WHEN UserName = 'System' THEN 'True' ELSE 'False' END,
    NULL,
    NULL
FROM STG_ACTIVITIES
WHERE ActivityType IN ('Dunning', 'Correspondence', 'Email Sent')

UNION ALL

/* 3. Collection Call Logged */
SELECT 
    InvoiceNumber,
    'Collection Call Logged',
    ActivityDate,
    CustomerName,
    NULL,
    NULL,
    UserName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_ACTIVITIES
WHERE ActivityType IN ('Call', 'Outbound Call')

UNION ALL

/* 4. Promise to Pay Created */
SELECT 
    InvoiceNumber,
    'Promise to Pay Created',
    PromiseDate,
    CustomerName,
    PromiseAmount,
    NULL,
    UserName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_ACTIVITIES
WHERE ActivityType = 'Promise to Pay' AND PromiseDate IS NOT NULL

UNION ALL

/* 5. Dispute Case Opened */
SELECT 
    InvoiceNumber,
    'Dispute Case Opened',
    CreateDate,
    CustomerName,
    DisputeAmount,
    NULL,
    AnalystName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_DISPUTES

UNION ALL

/* 6. Dispute Under Review */
SELECT 
    InvoiceNumber,
    'Dispute Under Review',
    StatusDate,
    CustomerName,
    NULL,
    NULL,
    AnalystName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_DISPUTES
WHERE Status = 'In Review'

UNION ALL

/* 7. Dispute Resolved */
SELECT 
    InvoiceNumber,
    'Dispute Resolved',
    ResolutionDate,
    CustomerName,
    NULL,
    NULL,
    AnalystName AS CollectorName,
    'False' AS IsAutomated,
    NULL,
    NULL
FROM STG_DISPUTES
WHERE Status IN ('Closed', 'Resolved', 'Denied', 'Approved')

UNION ALL

/* 8. Credit Memo Issued */
SELECT 
    InvoiceNumber,
    'Credit Memo Issued',
    PaymentDate,
    CustomerName,
    PaymentAmount,
    NULL,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    NULL,
    NULL
FROM STG_PAYMENTS
WHERE PaymentType = 'Credit Memo'

UNION ALL

/* 9. Partial Payment Posted */
SELECT 
    P.InvoiceNumber,
    'Partial Payment Posted',
    P.PaymentDate,
    I.CustomerName,
    P.PaymentAmount,
    I.DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    DATEDIFF(day, I.DueDate, P.PaymentDate) AS PaymentTermVariance,
    DATEDIFF(day, I.InvoiceDate, P.PaymentDate) AS DaysSalesOutstanding
FROM STG_PAYMENTS P
JOIN STG_INVOICES I ON P.InvoiceNumber = I.InvoiceNumber
WHERE P.PaymentType = 'Payment' AND P.PaymentAmount < I.InvoiceAmount

UNION ALL

/* 10. Bank Statement Matched */
SELECT 
    InvoiceNumber,
    'Bank Statement Matched',
    MatchDate,
    CustomerName,
    NULL,
    NULL,
    'CashApp System' AS CollectorName,
    'True' AS IsAutomated,
    NULL,
    NULL
FROM STG_PAYMENTS
WHERE MatchDate IS NOT NULL

UNION ALL

/* 11. Full Payment Received */
SELECT 
    P.InvoiceNumber,
    'Full Payment Received',
    P.PaymentDate,
    I.CustomerName,
    P.PaymentAmount,
    I.DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    DATEDIFF(day, I.DueDate, P.PaymentDate) AS PaymentTermVariance,
    DATEDIFF(day, I.InvoiceDate, P.PaymentDate) AS DaysSalesOutstanding
FROM STG_PAYMENTS P
JOIN STG_INVOICES I ON P.InvoiceNumber = I.InvoiceNumber
WHERE P.PaymentType = 'Payment' AND P.PaymentAmount >= I.InvoiceAmount

UNION ALL

/* 12. Due Date Passed */
SELECT 
    InvoiceNumber,
    'Due Date Passed',
    DueDate,
    CustomerName,
    InvoiceAmount,
    DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    NULL,
    DATEDIFF(day, InvoiceDate, DueDate) AS DaysSalesOutstanding
FROM STG_INVOICES
WHERE DueDate < GETDATE() AND (ClearDate IS NULL OR ClearDate > DueDate)

UNION ALL

/* 13. Invoice Cleared */
SELECT 
    InvoiceNumber,
    'Invoice Cleared',
    ClearDate,
    CustomerName,
    InvoiceAmount,
    DueDate,
    'System' AS CollectorName,
    'True' AS IsAutomated,
    DATEDIFF(day, DueDate, ClearDate) AS PaymentTermVariance,
    DATEDIFF(day, InvoiceDate, ClearDate) AS DaysSalesOutstanding
FROM STG_INVOICES
WHERE ClearDate IS NOT NULL

Các bước

Điều kiện tiên quyết và thiết lập môi trường Đảm bảo máy đã cài Python 3.8 trở lên. Bạn cần các thư viện requests và pandas. Nếu chưa có, hãy cài bằng pip. Nhờ quản trị viên hệ thống cung cấp API Client ID, Client Secret và Base URL của HighRadius. Bạn thường tìm thấy các thông tin này trong mục Administration hoặc Developer Portal của HighRadius.
Cấu hình thông tin xác thực API Mở tập lệnh Python được cung cấp. Tìm phần cấu hình ở đầu tập lệnh rồi thay các giá trị giữ chỗ CLIENT_ID, CLIENT_SECRET và BASE_URL. Đảm bảo người dùng gắn với thông tin xác thực này có quyền truy cập các mô-đun Collections, Cash Application và Deductions.
Đặt tham số trích xuất dữ liệu Khai báo biến START_DATE và END_DATE trong tập lệnh. Bạn nên trích xuất dữ liệu theo từng tháng hoặc quý để tránh hết thời gian chờ. Tập lệnh yêu cầu định dạng ngày ISO 8601 chuẩn (YYYY-MM-DD).
Chạy tập lệnh: xác thực Trước tiên, tập lệnh thực hiện quy trình OAuth2 để lấy bearer token. Token này chỉ có hiệu lực trong một khoảng thời gian giới hạn, thường là 1 giờ. Tập lệnh tự động lấy token ban đầu.
Chạy tập lệnh: lấy dữ liệu Tập lệnh lần lượt truy vấn các endpoint cụ thể. Trước tiên, tập lệnh lấy dữ liệu hóa đơn ở cấp tiêu đề. Sau đó, tập lệnh truy vấn các endpoint liên quan để lấy Hoạt động (ghi chú), cam kết thanh toán, tranh chấp và lịch sử thanh toán. Khi cần, tập lệnh dùng số hóa đơn làm khóa tham chiếu.
Chuyển đổi dữ liệu và ánh xạ hoạt động Tập lệnh chuyển các phản hồi JSON thô thành cấu trúc nhật ký sự kiện đã được làm phẳng. Tập lệnh ánh xạ các mã HighRadius cụ thể sang tên hoạt động cần dùng. Ví dụ, tập lệnh so sánh invoice_balance với total_amount để phân biệt giữa sự kiện 'Đã ghi nhận thanh toán một phần' và 'Đã nhận đủ thanh toán'. Tập lệnh cũng xác định sự kiện 'Đã qua ngày đến hạn' bằng cách so sánh ngày đến hạn với ngày thanh toán bù trừ hoặc ngày hiện tại.
Xử lý phân trang API HighRadius thường chia kết quả thành nhiều trang. Tập lệnh được cung cấp có vòng lặp để lấy hết các trang cho đến khi không còn bản ghi nào. Đảm bảo kết nối mạng ổn định trong quá trình này.
Hợp nhất dữ liệu Tập lệnh hợp nhất tất cả danh sách đã trích xuất (hóa đơn, hoạt động, tranh chấp, thanh toán) vào một Pandas DataFrame. Tập lệnh sắp xếp DataFrame theo InvoiceNumber và EventDateTime để các sự kiện hiển thị theo thứ tự thời gian.
Xác thực và kiểm tra chất lượng Trước khi hoàn tất, tập lệnh in bản tóm tắt các hoạt động riêng biệt đã trích xuất. Kiểm tra xem số lượng có hợp lý so với khối lượng vận hành hay không. Đảm bảo cột EventDateTime có định dạng YYYY-MM-DD HH:MM:SS.
Xuất CSV DataFrame cuối cùng được xuất thành tệp HighRadius_EventLog.csv. Tệp này có các cột cụ thể mà ProcessMind yêu cầu.
Kiểm tra lần cuối Mở tệp CSV. Kiểm tra xem InvoiceNumber hoặc ActivityName có giá trị NULL hay không. Đảm bảo ngày không nằm trong tương lai, trừ khi đó là ngày đến hạn dự kiến. EventDateTime luôn phải là thời điểm hiện tại hoặc trong quá khứ.
Tải lên ProcessMind Nhập tệp CSV đã tạo vào ProcessMind. Ánh xạ InvoiceNumber với ID trường hợp, ActivityName với Hoạt động và EventDateTime với Dấu thời gian.

Cấu hình

API Base URL: Xác định bạn đang kết nối với môi trường Production hay Sandbox. Cấu trúc URL thường khác nhau, chẳng hạn https://[client].highradius.com/api và https://[client]-sandbox.highradius.com/api.
Phạm vi Client: Đảm bảo API Client có quyền read trong các phạm vi radiusOne, collections, deductions và cashApp.
Khoảng ngày: Nếu khối lượng giao dịch lớn, trên 100k hóa đơn mỗi tháng, hãy giới hạn mỗi lần trích xuất trong 3 tháng trở xuống.
Giới hạn phân trang: Mặc định, tập lệnh lấy 1000 bản ghi mỗi trang. Điều chỉnh tham số limit trong lệnh gọi API nếu máy chủ báo lỗi hết thời gian chờ.
Giới hạn tốc độ: HighRadius có thể giới hạn số yêu cầu. Nếu gặp lỗi HTTP 429, hãy thêm lệnh time.sleep(1) vào vòng lặp phân trang.

Truy vấn mẫu python

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

class=class="hl-string">"hl-comment"># ==========================================
class=class="hl-string">"hl-comment"># CONFIGURATION
class=class="hl-string">"hl-comment"># ==========================================
BASE_URL = class="hl-string">"https://[Your Instance].highradius.com/api/v1"
TOKEN_URL = class="hl-string">"https://[Your Instance].highradius.com/oauth/token"
CLIENT_ID = class="hl-string">"[Your Client ID]"
CLIENT_SECRET = class="hl-string">"[Your Client Secret]"
SCOPE = class="hl-string">"read_write"

class=class="hl-string">"hl-comment"># Extraction Window
START_DATE = class="hl-string">"2023-01-01"
END_DATE = class="hl-string">"2023-01-31"

class=class="hl-string">"hl-comment"># Global container for event log rows
event_log = []

def get_access_token():
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': CLIENT_ID,
        class="hl-string">'client_secret': CLIENT_SECRET,
        class="hl-string">'scope': SCOPE
    }
    try:
        response = requests.post(TOKEN_URL, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except Exception as e:
        print(fclass="hl-string">"Authentication failed: {e}")
        return None

def fetch_paged_data(endpoint, token, params={}):
    headers = {class="hl-string">"Authorization": fclass="hl-string">"Bearer {token}", class="hl-string">"Content-Type": class="hl-string">"application/json"}
    all_records = []
    page = 1
    while True:
        params[class="hl-string">'page'] = page
        params[class="hl-string">'limit'] = 1000
        try:
            resp = requests.get(fclass="hl-string">"{BASE_URL}/{endpoint}", headers=headers, params=params)
            if resp.status_code != 200:
                break
            data = resp.json()
            records = data.get(class="hl-string">'data', [])
            if not records:
                break
            all_records.extend(records)
            page += 1
        except Exception:
            break
    return all_records

def process_extraction():
    token = get_access_token()
    if not token:
        return

    class=class="hl-string">"hl-comment"># 1. Fetch Invoices (Header Data)
    print(class="hl-string">"Fetching Invoices...")
    invoices = fetch_paged_data(class="hl-string">"invoices", token, {class="hl-string">"filter_date_from": START_DATE, class="hl-string">"filter_date_to": END_DATE})
    
    class=class="hl-string">"hl-comment"># Process Invoice Headers and Derived Events
    invoice_ids = []
    for inv in invoices:
        inv_num = str(inv.get(class="hl-string">'invoice_number', class="hl-string">''))
        cust_name = inv.get(class="hl-string">'customer_name', class="hl-string">'')
        amount = float(inv.get(class="hl-string">'amount', 0.0))
        create_date = inv.get(class="hl-string">'create_date')  class=class="hl-string">"hl-comment"># YYYY-MM-DD
        due_date = inv.get(class="hl-string">'due_date')
        clear_date = inv.get(class="hl-string">'clear_date')
        status = inv.get(class="hl-string">'status', class="hl-string">'Open')
        
        invoice_ids.append(inv_num)
        
        class=class="hl-string">"hl-comment"># Event: Invoice Created
        event_log.append({
            class="hl-string">"InvoiceNumber": inv_num,
            class="hl-string">"ActivityName": class="hl-string">"Invoice Created",
            class="hl-string">"EventDateTime": fclass="hl-string">"{create_date} 00:00:00",
            class="hl-string">"CustomerName": cust_name,
            class="hl-string">"InvoiceAmount": amount,
            class="hl-string">"DueDate": due_date,
            class="hl-string">"IsAutomated": True
        })
        
        class=class="hl-string">"hl-comment"># Event: Invoice Cleared
        if status.lower() in [class="hl-string">'closed', class="hl-string">'cleared'] and clear_date:
             event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Invoice Cleared",
                class="hl-string">"EventDateTime": fclass="hl-string">"{clear_date} 23:59:59",
                class="hl-string">"CustomerName": cust_name,
                class="hl-string">"InvoiceAmount": amount,
                class="hl-string">"DueDate": due_date,
                class="hl-string">"IsAutomated": True
            })
             
        class=class="hl-string">"hl-comment"># Event: Due Date Passed (Calculated)
        class=class="hl-string">"hl-comment"># Logic: If closed and cleared after due date OR if open and today is after due date
        d_due = datetime.strptime(due_date, class="hl-string">"%Y-%m-%d")
        limit_date = datetime.strptime(clear_date, class="hl-string">"%Y-%m-%d") if clear_date else datetime.now()
        
        if limit_date > d_due:
            overdue_ts = d_due + timedelta(days=1)
            event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Due Date Passed",
                class="hl-string">"EventDateTime": overdue_ts.strftime(class="hl-string">"%Y-%m-%d %H:%M:%S"),
                class="hl-string">"CustomerName": cust_name,
                class="hl-string">"InvoiceAmount": amount,
                class="hl-string">"DueDate": due_date,
                class="hl-string">"IsAutomated": True
            })

        class=class="hl-string">"hl-comment"># Event: Credit Memo Issued
        if inv.get(class="hl-string">'document_type', class="hl-string">'').lower() == class="hl-string">'credit_memo':
             event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Credit Memo Issued",
                class="hl-string">"EventDateTime": fclass="hl-string">"{create_date} 12:00:00",
                class="hl-string">"CustomerName": cust_name,
                class="hl-string">"InvoiceAmount": amount,
                class="hl-string">"DueDate": due_date,
                class="hl-string">"IsAutomated": True
            })

    class=class="hl-string">"hl-comment"># 2. Fetch Activities / Notes (Calls, Reminders)
    print(class="hl-string">"Fetching Activities...")
    class=class="hl-string">"hl-comment"># In a real scenario, you might iterate invoice_ids in chunks if the API requires filtering by ID
    class=class="hl-string">"hl-comment"># Here we assume an endpoint allowing date filtering similar to invoices
    activities = fetch_paged_data(class="hl-string">"activities", token, {class="hl-string">"date_from": START_DATE, class="hl-string">"date_to": END_DATE})
    
    for act in activities:
        inv_num = str(act.get(class="hl-string">'invoice_number', class="hl-string">''))
        act_type = act.get(class="hl-string">'activity_type', class="hl-string">'').lower()
        act_date = act.get(class="hl-string">'activity_date') class=class="hl-string">"hl-comment"># Assume valid timestamp
        user = act.get(class="hl-string">'performed_by', class="hl-string">'System')
        
        activity_name = None
        if class="hl-string">'email' in act_type or class="hl-string">'letter' in act_type or class="hl-string">'reminder' in act_type:
            activity_name = class="hl-string">"Payment Reminder Sent"
        elif class="hl-string">'call' in act_type:
            activity_name = class="hl-string">"Collection Call Logged"
            
        if activity_name:
            event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": activity_name,
                class="hl-string">"EventDateTime": act_date,
                class="hl-string">"CollectorName": user,
                class="hl-string">"IsAutomated": user == class="hl-string">'System'
            })

    class=class="hl-string">"hl-comment"># 3. Fetch Promises to Pay
    print(class="hl-string">"Fetching Promises to Pay...")
    ptps = fetch_paged_data(class="hl-string">"promises", token, {class="hl-string">"created_from": START_DATE, class="hl-string">"created_to": END_DATE})
    for ptp in ptps:
        event_log.append({
            class="hl-string">"InvoiceNumber": str(ptp.get(class="hl-string">'invoice_number', class="hl-string">'')),
            class="hl-string">"ActivityName": class="hl-string">"Promise to Pay Created",
            class="hl-string">"EventDateTime": ptp.get(class="hl-string">'created_at'),
            class="hl-string">"CollectorName": ptp.get(class="hl-string">'created_by'),
            class="hl-string">"IsAutomated": False
        })

    class=class="hl-string">"hl-comment"># 4. Fetch Disputes
    print(class="hl-string">"Fetching Disputes...")
    disputes = fetch_paged_data(class="hl-string">"disputes", token, {class="hl-string">"date_from": START_DATE, class="hl-string">"date_to": END_DATE})
    for disp in disputes:
        inv_num = str(disp.get(class="hl-string">'invoice_number', class="hl-string">''))
        create_ts = disp.get(class="hl-string">'create_date')
        status_history = disp.get(class="hl-string">'status_history', [])
        
        class=class="hl-string">"hl-comment"># Event: Dispute Case Opened
        event_log.append({
            class="hl-string">"InvoiceNumber": inv_num,
            class="hl-string">"ActivityName": class="hl-string">"Dispute Case Opened",
            class="hl-string">"EventDateTime": create_ts,
            class="hl-string">"IsAutomated": False
        })
        
        class=class="hl-string">"hl-comment"># Process Audit Trail for Status Changes
        for history in status_history:
            status = history.get(class="hl-string">'status', class="hl-string">'').lower()
            hist_date = history.get(class="hl-string">'date')
            
            if status == class="hl-string">'in_review' or status == class="hl-string">'investigation':
                event_log.append({
                    class="hl-string">"InvoiceNumber": inv_num,
                    class="hl-string">"ActivityName": class="hl-string">"Dispute Under Review",
                    class="hl-string">"EventDateTime": hist_date,
                    class="hl-string">"IsAutomated": False
                })
            elif status == class="hl-string">'resolved' or status == class="hl-string">'closed':
                 event_log.append({
                    class="hl-string">"InvoiceNumber": inv_num,
                    class="hl-string">"ActivityName": class="hl-string">"Dispute Resolved",
                    class="hl-string">"EventDateTime": hist_date,
                    class="hl-string">"IsAutomated": False
                })

    class=class="hl-string">"hl-comment"># 5. Fetch Payments
    print(class="hl-string">"Fetching Payments...")
    payments = fetch_paged_data(class="hl-string">"payments", token, {class="hl-string">"date_from": START_DATE, class="hl-string">"date_to": END_DATE})
    for pay in payments:
        inv_num = str(pay.get(class="hl-string">'invoice_number', class="hl-string">''))
        pay_date = pay.get(class="hl-string">'payment_date')
        pay_amount = float(pay.get(class="hl-string">'payment_amount', 0.0))
        inv_total = float(pay.get(class="hl-string">'invoice_total_amount', 0.0))
        is_matched = pay.get(class="hl-string">'is_matched', False)
        
        class=class="hl-string">"hl-comment"># Determine Partial vs Full
        class=class="hl-string">"hl-comment"># Note: logic simplified; usually compare accumulated payments
        if pay_amount < inv_total:
            act_name = class="hl-string">"Partial Payment Posted"
        else:
            act_name = class="hl-string">"Full Payment Received"
            
        event_log.append({
            class="hl-string">"InvoiceNumber": inv_num,
            class="hl-string">"ActivityName": act_name,
            class="hl-string">"EventDateTime": pay_date,
            class="hl-string">"InvoiceAmount": inv_total,
            class="hl-string">"IsAutomated": True
        })
        
        class=class="hl-string">"hl-comment"># Event: Bank Statement Matched
        class=class="hl-string">"hl-comment"># Trigger if the system flags this payment as successfully matched to bank line
        if is_matched:
             event_log.append({
                class="hl-string">"InvoiceNumber": inv_num,
                class="hl-string">"ActivityName": class="hl-string">"Bank Statement Matched",
                class="hl-string">"EventDateTime": pay_date, class=class="hl-string">"hl-comment"># Often same time as posting
                class="hl-string">"IsAutomated": True
            })

    class=class="hl-string">"hl-comment"># Export
    df = pd.DataFrame(event_log)
    class=class="hl-string">"hl-comment"># Ensure required columns exist even if empty
    required_cols = [class="hl-string">"InvoiceNumber", class="hl-string">"ActivityName", class="hl-string">"EventDateTime"]
    for col in required_cols:
        if col not in df.columns:
            df[col] = None
            
    class=class="hl-string">"hl-comment"># Fill recommended cols with None if missing
    recommended_cols = [class="hl-string">"CustomerName", class="hl-string">"InvoiceAmount", class="hl-string">"DueDate", class="hl-string">"CollectorName", class="hl-string">"IsAutomated"]
    for col in recommended_cols:
        if col not in df.columns:
            df[col] = None

    df.dropna(subset=[class="hl-string">"InvoiceNumber", class="hl-string">"ActivityName", class="hl-string">"EventDateTime"], inplace=True)
    df.sort_values(by=[class="hl-string">"InvoiceNumber", class="hl-string">"EventDateTime"], inplace=True)
    
    output_file = class="hl-string">"HighRadius_EventLog.csv"
    df.to_csv(output_file, index=False)
    print(fclass="hl-string">"Extraction Complete. {len(df)} rows saved to {output_file}")

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

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

Bắt đầu sơ đồ hóa vòng đời hóa đơn ngay hôm nay để cải thiện thanh khoản và rút ngắn số ngày thu tiền bình quân (DSO). Đội ngũ của chúng tôi sẵn sàng hỗ trợ bạn trong suốt quá trình triển khai kỹ thuật.

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

Tải mẫu xuống

Tối ưu khoản phải thu, cải thiện dòng tiền ngay hôm nay

Rút ngắn DSO từ 15 đến 20 ngày nhờ thông tin chi tiết tự động về quy trình

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

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

Mẫu dữ liệu khoản phải thu

Mẫu dữ liệu khoản phải thu

Thuộc tính khoản phải thu

Hoạt động trong quy trình khoản phải thu

Hướng dẫn trích xuất dữ liệu

Xuất dữ liệu phân tích và báo cáo từ HighRadius

Các bước

Cấu hình

Truy vấn mẫu sql

Trích xuất dữ liệu qua HighRadius REST API

Các bước

Cấu hình

Truy vấn mẫu python

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

Tối ưu khoản phải thu, cải thiện dòng tiền ngay hôm nay