您的应收账款数据模板

HighRadius

← 返回改进指南

应收账款属性 (19) 应收账款活动 (13) 提取指南 (2)

您的应收账款数据模板

此模板概述了在HighRadius中分析开票工作流所需的核心要素，系统梳理了构建完整事件日志所需的数据点、流程里程碑和技术步骤。按照本指南操作，您可以成功映射催收周期，并发现改善现金流的机会。

流程所需的具体数据属性
标准化活动里程碑
HighRadius数据提取说明

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

下载模板

应收账款属性

此表列出了构建详细事件日志所需的推荐数据字段，用于分析发票管理和收款绩效。

3 必需 6 建议 10 可选

	名称	说明
	事件时间戳 EventDateTime	活动发生的具体日期和时间。
说明该属性标记事件在HighRadius系统中发生的准确时刻，为活动排序和计算流程步骤之间的时长提供时间维度。在分析中，时间戳用于计算销售未收款天数（DSO）或争议解决时间等处理周期，也支持分析特定时间段内的吞吐量和资源利用率。为什么重要精确的时间信息是计算所有基于时长的KPI并正确排列事件的必要条件。获取位置 HighRadius Transaction Logs中的时间戳列示例 2023-10-01T08:30:00Z2023-10-15T14:22:10Z2023-11-05T09:15:00Z
	发票编号 InvoiceNumber	发票单据的唯一标识符，用作案件ID。
说明发票编号是跟踪财务义务从创建到最终结算的核心标识符。它将争议、付款承诺和付款等所有相关活动关联到同一案件历史中。在分析中，该属性用于将事件日志分组为不同的流程实例，从而计算每张发票的处理周期，并作为连接流程数据与HighRadius环境或源ERP中其他主数据表的主键。为什么重要它用于识别唯一案件，并确保所有事件都正确关联到特定财务交易。获取位置 HighRadius发票数据/抬头表或源ERP（例如SAP VBAK、Oracle Headers）示例 INV-2023-001900123456US-102938550002931
	活动 ActivityName	在发票上执行的事件或操作名称。
说明该属性记录从赊销到收款生命周期中发生的具体步骤或操作，包括发票创建、自动通知、催收电话、争议记录和付款应用等事件。分析人员使用此字段重建流程并可视化步骤顺序。活动顺序的变化有助于识别流程偏差、返工循环和不合规行为。为什么重要它定义流程步骤，是流程发现和变体分析的基础。获取位置 HighRadius Activity Log、Notes History或Transaction History表示例发票已创建付款提醒已发送争议案件已开启已收到全额付款
	付款期限偏差 PaymentTermVariance	到期日与付款日之间的天数。
说明此计算属性用于衡量实际付款与约定付款期限之间的偏差。正数表示逾期付款，负数表示提前付款。这是付款期限合规审计的直接指标。汇总该偏差后，企业可以识别系统性逾期付款客户，并相应调整信用期限或催收策略。为什么重要直接衡量客户对合同条款的遵守程度。获取位置根据到期日和付款日计算示例 5天-2天0天
	催收人员姓名 CollectorName	负责催收活动的人员或用户姓名。
说明该属性用于识别执行人工操作的具体HighRadius用户或催收人员，例如记录通话、发送定制邮件或审核争议。它用于Collector Productivity Benchmarks仪表板，以评估个人绩效和工作量分配，帮助管理人员识别培训需求，或在催收团队中重新平衡客户组合。为什么重要支持在资源层面分析绩效。获取位置 Activity Log/User表示例 John DoeJane Smith系统管理员CollectionAgent_01
	到期日 DueDate	客户根据合同约定必须付款的日期。
说明到期日由应用于发票创建日期的付款条款确定，是催收流程的目标期限。将全额付款日期与该属性进行比较，可以计算Payment Term Compliance Rate，并判断付款是否按时、逾期或提前。为什么重要用于判断逾期情况和计算销售未收款天数（DSO）的参考点。获取位置 Invoice Header表（Due Date字段）示例 2023-11-302023-12-15
	发票金额 InvoiceAmount	发票的货币总金额。
说明该属性表示向客户开具的原始总金额，是计算未结余额以及评估争议或延迟付款财务影响的基准。流程挖掘分析使用此字段按金额衡量案件权重。例如，在Low Value Dispute Volume KPI中，它可以区分高价值优先催收案件与低价值行政噪声。为什么重要支持按财务影响而非仅按案件数量进行加权分析。获取位置 Invoice Header表（Amount字段）示例 1500.00250.5010000.00
	客户名称 CustomerName	与发票关联的客户账户名称。
说明该属性用于识别负责支付发票的实体。在HighRadius中，它与债务人的主数据记录关联。按客户名称分析流程绩效，可以突出显示需要定制催收策略或持续延迟付款的特定账户，并支持Customer Risk and Aging Matrix仪表板。为什么重要按账户细分分析、发现问题客户的必要属性。获取位置客户主数据或发票抬头示例 Acme CorpGlobal IndustriesTechStart IncRetail Giant Ltd
	是否自动执行 IsAutomated	用于标识活动是否由系统在无人干预的情况下执行。
说明该布尔属性用于区分HighRadius自动化引擎执行的步骤（如自动通知或现金匹配）与用户执行的人工步骤。它是Cash Application Automation Tracker和Touchless Invoice Rate KPI的重要基础，可帮助分析人员衡量自动化投资回报，并识别仍需大量人工操作的流程步骤。为什么重要衡量HighRadius实施的效率。获取位置 Activity Log（系统用户与人工用户检查）示例 truefalse
	上次数据更新时间 LastDataUpdate	数据在挖掘模型中上次刷新的时间戳。
说明该属性记录数据集中的记录何时被提取或上次更新，确保分析人员了解数据时效性以及报告中可能存在的延迟。对于持续监控仪表板，这一点尤其重要，因为用户需要知道查看的是实时数据，还是前一天的快照。为什么重要它确保用于KPI的数据新鲜度透明可见。获取位置 ETL时间戳示例 2023-12-01T00:00:00Z2023-12-02T06:00:00Z
	业务单元 BusinessUnit	开具发票的内部部门或子公司。
说明该属性根据组织结构细分数据，例如“北美销售”“EMEA服务”或特定产品部门。它支持Payment Term Compliance Audit比较组织不同部分的绩效，帮助判断催收问题是系统性的，还是局限于特定业务实践。为什么重要支持跨不同组织条线进行比较分析。获取位置发票抬头/ERP映射示例消费电子产品工业零部件软件服务NA-West
	争议原因代码 DisputeReasonCode	分配给争议案件的类别代码。
说明该属性用于对客户拒付原因进行分类，例如“定价错误”“货物损坏”或“缺少文件”。在HighRadius Deductions Cloud中，这些是标准代码。分析这些代码有助于识别未付款的根因。汇总相关数据后，企业可以修复销售或物流环节的上游问题，减少其导致的下游催收延迟。为什么重要用于延迟付款根因分析的关键属性。获取位置争议/扣款管理模块示例 P01（定价）Q02（质量）S03（短缺）管理错误
	信用评级 CreditRating	分配给客户的信用状况评分或评级。
说明该属性反映客户的风险等级，通常来源于征信机构或HighRadius Credit Cloud中的内部评分。它是Customer Risk and Aging Matrix中的一个维度。结合信用评级分析账龄，有助于识别高风险敞口，例如信用评级较低但未结余额较大的客户。为什么重要风险管理和催收优先级排序不可或缺。获取位置 Credit Management Module / Customer Master 示例 AAAB+高风险低风险
	区域 Region	与发票或客户相关的地理区域。
说明此属性用于定义与交易相关的地理区域，例如“北美”“EMEA”或“APAC”。它有助于开展区域基准比较，并了解文化或监管差异如何影响付款行为和催收速度，也适用于高层管理报告。为什么重要支持地理区域绩效分析。获取位置客户主数据或发票抬头示例 NAEMEALATAMAPAC
	客户细分 CustomerSegment	根据客户规模、行业或战略价值对客户进行分类。
说明该属性将客户划分为“战略客户”“中端市场”“SMB”或“高风险”等层级。它用于Dispute Resolution Performance仪表板，以了解不同客户群体是否获得不同的服务水平，并确保高价值客户在催收过程中得到适当关注。为什么重要支持按客户群体分析，以匹配业务战略和服务级别协议。获取位置客户主数据示例战略重点客户批发零售政府
	承诺付款日期 PromiseToPayDate	客户承诺付款的日期。
说明该属性记录客户在催收互动中承诺的付款日期，是HighRadius Collections Cloud的重要功能。在Promise to Pay Reliability Index中，该日期会与实际付款日期进行比较，以判断客户是否履行承诺，并评估承诺质量和催收人员的谈判效果。为什么重要用于预测现金流和衡量客户可靠性的关键属性。获取位置 Collections模块/P2P交易表示例 2023-12-102023-12-20
	未结金额 OpenAmount	发票中尚未支付的余额。
说明此属性用于跟踪客户仍需支付的金额，并在登记部分付款后更新。它是部分付款复杂性分析的关键数据。分析人员可以据此筛选全额未结和部分付款发票，并优先催收金额较高的未结项目。为什么重要对于确定当前风险敞口和部分催收成效至关重要。获取位置发票抬头／未结项目表示例 0.00500.0012000.00
	源系统 SourceSystem	数据来源系统的名称。
说明该属性表示数据点是直接来自HighRadius平台模块（如Collections Cloud或Cash Application Cloud），还是从外部ERP系统（如SAP或Oracle）导入。它有助于数据溯源和验证。在分析流程摩擦时，了解源系统可以帮助判断延迟是由集成滞后还是原生系统处理时间造成的。为什么重要它提供数据来源背景，尤其适用于多个ERP向HighRadius提供数据的环境。获取位置根据提取逻辑在系统配置中设定或硬编码示例 HighRadiusSAP ECCOracle NetSuiteMicrosoft Dynamics
	货币代码 CurrencyCode	发票金额使用的ISO货币代码。
说明此属性用于指定发票开具时采用的货币，例如USD、EUR或GBP。分析全球流程时，必须使用该属性正确解读发票金额和未结金额字段，并确保汇总处理准确，通常需要转换为报告货币。为什么重要多币种环境下进行准确财务汇总的必要数据。获取位置发票抬头示例 USDEURGBPJPY

必需建议可选

应收账款活动

这些条目代表您应采集的关键流程步骤和交易里程碑，用于可视化端到端发票历程。

8 建议 5 可选

	活动	说明
	争议已解决	争议调查结束并作出决定，例如确认扣款有效或索赔无效。
为什么重要 “Dispute Resolution Cycle Time”的停止计时事件。此处的延迟会直接影响账龄。获取位置 Deductions模块；状态变更为“Closed”“Resolved”或“Approved”。采集比较变更前后的状态字段事件类型 inferred
	争议案件已开启	创建与发票关联的扣款或争议案件，表示客户拒绝支付部分或全部余额。
为什么重要触发“Dispute Resolution Performance”分析，并暂停争议金额的标准催收。获取位置 Deductions/Disputes模块中与发票关联的案件ID及其创建时间戳。采集生成争议案件时记录事件类型 explicit
	付款承诺已创建	系统中记录的一项正式承诺，客户承诺在指定日期前支付指定金额。
为什么重要这是“Promise to Pay Reliability Index”的基础，用于预测现金流并衡量客户可靠性。获取位置与发票关联的P2P（Promise to Pay）模块或选项卡。采集创建P2P记录时记录事件类型 explicit
	付款提醒已发送	通过Collections模块向客户发送的自动通知（电子邮件或信函）。用于跟踪催收策略的执行情况。
为什么重要这是“Collection Reminder Effectiveness”仪表板的关键数据，用于衡量通知是否实际促成付款。获取位置与发票ID关联的Correspondence History选项卡或Communication日志。采集催收策略执行操作时记录事件类型 explicit
	发票已创建	发票从ERP系统首次创建或导入HighRadius平台。这标志着催收生命周期的开始。
为什么重要为账龄计算和销售未收款天数（DSO）指标建立基准时间戳。获取位置 Open Invoices表或Data Integration日志中首次出现发票编号的位置。采集发票记录插入发票抬头表时记录事件类型 explicit
	发票已清账	发票余额变为零并在系统中关闭时的最终状态变更。
为什么重要 “Average Days Sales Outstanding”的结束时间戳，表示流程完成。获取位置 Invoice Header表；Status = “Closed”或“Cleared”。采集比较变更前后的状态字段事件类型 inferred
	已收到全额付款	收到足以完全结清债务的资金。这是用于账龄计算的付款生效日期。
为什么重要用于计算“Promise to Pay Fulfillment Rate”，并比较实际现金流与预期现金流。获取位置与最终清账单据关联的付款交易日期。采集清账付款的交易日期已记录事件类型 explicit
	银行对账单已匹配	Cash Application引擎或用户成功将银行对账单中的一行与该发票关联。
为什么重要 “Automated Cash Application Rate”的核心指标，用于区分资金到账与资金应用。获取位置 Cash Application模块；匹配记录创建。采集匹配规则执行时记录事件类型 explicit
	争议审核中	争议案件从“New”转为主动调查状态，表示分析人员开始实际处理。
为什么重要用于“Dispute Workflow Bottleneck Finder”，衡量案件创建到开始处理之间的延迟。获取位置 Deductions模块审计日志；状态变更为“In Progress”或“Researching”。采集比较变更前后的状态字段事件类型 inferred
	催收电话已记录	催收人员针对该发票记录的人工备注或互动记录，表示流程中发生了人工干预。
为什么重要支持“Collector Productivity Benchmarks”，并区分自动催收与人工催收工作。获取位置 Collections模块中的Notes/History选项卡。采集用户保存通话备注时记录事件类型 explicit
	已超过到期日	一个计算得出的事件，表示发票在约定付款期限后仍处于未结状态。
为什么重要这是“Payment Term Compliance Audit”的关键事件，标志着发票从未逾期转为逾期。获取位置通过比较发票到期日与当前日期（若仍未结）或付款日期（若已结清）计算得出。采集通过比较Due Date字段与Activity Date得出事件类型 calculated
	贷项通知单已开具	生成用于冲销发票余额的贷项通知单，通常源于有效的争议解决结果或退货。
为什么重要用于跟踪“Credit Memo Processing Efficiency”，以及争议解决与财务过账之间的时间延迟。获取位置 ERP同步日志或与原始发票ID关联的Credit Memo表。采集 CM单据与发票关联时记录事件类型 explicit
	部分付款已过账	应用一笔仅覆盖发票总金额部分金额的付款，仍留有余额。
为什么重要为“Partial Payment Complexity Analysis”提供数据，并表示现金应用可能存在摩擦。获取位置 Cash Application模块；与发票关联的付款交易，其中Payment Amount < Open Amount。采集付款已应用但状态仍为未结时记录事件类型 explicit

建议可选

提取指南

如何从HighRadius获取数据

步骤

登录HighRadius Integrated Receivables平台，进入Analytics或Reports模块。
找到Transaction History或Open Items报告模板。为覆盖完整生命周期，您可能需要配置三个独立导出：Invoice Header Data、Collection Activities和Dispute/Deduction History。
配置Invoice Header Export：选择Invoice Number、Customer Name、Invoice Amount、Invoice Date、Due Date、Clear Date和Final Status列。筛选相关Company Codes，并设置覆盖流程挖掘时间窗口的创建日期范围。
配置Collection Activities Export：选择Invoice Number、Activity Type（Call、Email、Note）、Activity Date、Collector Name和Promise to Pay详细信息。确保同时包含自动系统操作和手动用户日志。
配置Dispute History Export：选择Invoice Number、Dispute Case ID、Dispute Amount、Status Change Date、Reason Code和Resolution Date列，以捕获扣款争议的生命周期。
配置Payment/Cash App Export：选择Invoice Number、Payment Reference、Payment Date、Payment Amount和Payment Type（Partial、Full、Credit Memo）列。
运行这些报告，并将结果导出为CSV格式。
将这些CSV文件导入暂存数据库或数据转换工具，例如Python/Pandas或SQL数据库，以执行统一处理。
执行Query部分提供的转换脚本，统一列名，计算派生事件，例如Due Date Passed，并将不同来源合并为一个事件日志。
验证日期格式一致，建议使用ISO 8601；同时确认所有文件中的Invoice Number格式一致，例如在格式不一致时删除前导零。
将最终结果集导出为单个CSV文件。
将最终CSV上传到ProcessMind，并将InvoiceNumber映射为Case ID、EventDateTime映射为Timestamp、ActivityName映射为Activity。

配置

日期范围：根据Invoice Creation Date选择滚动时间窗口（例如过去12个月），确保完整记录流程生命周期。
数据源：需要访问HighRadius中的Collections、Cash Application和Deductions模块。
粒度：确保报表按Invoice级别生成，而非Account或Summary级别。
用户权限：提取数据的用户需要具备Reporting或Analytics Admin权限，才能访问历史活动日志。
系统操作：明确启用筛选条件，将System或Automated User操作纳入Activity日志，以记录自动发送的通知。
需要映射：HighRadius活动类型可能需要映射为标准流程挖掘活动名称，例如将“Dunning Letter”映射为“Payment Reminder Sent”。

a 示例查询 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

步骤

前提条件与环境设置 确保已安装Python 3.8或更高版本，并准备好requests和pandas库。如尚未安装，请通过pip安装。向系统管理员获取HighRadius API Client ID、Client Secret和Base URL。这些信息通常位于HighRadius的Administration或Developer Portal部分。
配置API凭据 打开提供的Python脚本，找到顶部的配置部分，替换CLIENT_ID、CLIENT_SECRET和BASE_URL占位符。确保与这些凭据关联的用户有权访问Collections、Cash Application和Deductions模块。
设置数据提取参数 在脚本中定义START_DATE和END_DATE变量。建议按月或按季度分批提取数据，以避免超时。脚本要求使用标准ISO 8601日期格式（YYYY-MM-DD）。
脚本执行：身份验证 脚本首先执行OAuth2流程以获取bearer token。该令牌有效期有限，通常为1小时。脚本会自动完成初始令牌获取。
脚本执行：获取数据 脚本依次查询指定端点。首先获取发票表头数据，然后以Invoice Number作为必要的关联键，遍历Activities（Notes）、Promises to Pay、Disputes和Payment History相关端点。
数据转换与活动映射 脚本将原始JSON响应处理为扁平化事件日志结构，并将特定HighRadius代码映射为所需的Activity Names。例如，通过比较invoice_balance和total_amount，区分“Partial Payment Posted”和“Full Payment Received”。同时，通过比较到期日与清账日期或当前日期，计算“Due Date Passed”事件。
处理分页 HighRadius API通常会对结果分页。提供的脚本包含循环机制，会持续获取所有数据页，直到不再返回记录。此过程中请确保网络连接稳定。
数据整合 脚本将所有提取列表（Invoices、Activities、Disputes、Payments）合并到单个Pandas DataFrame中，并按InvoiceNumber和EventDateTime排序，确保事件流按时间顺序排列。
验证与质量检查 在最终确定前，脚本会输出提取到的唯一活动摘要。请根据实际业务量检查数量是否合理，并确认EventDateTime列已正确格式化为YYYY-MM-DD HH:MM:SS。
导出为CSV 最终DataFrame会导出为HighRadius_EventLog.csv文件，文件包含ProcessMind所需的指定列。
最终检查 打开CSV文件，检查InvoiceNumber或ActivityName中是否存在NULL值。确保日期不是未来日期，除非对应预期到期日（但EventDateTime应始终为过去或当前时间）。
上传至ProcessMind 将生成的CSV文件导入ProcessMind。将InvoiceNumber映射为Case ID、ActivityName映射为Activity、EventDateTime映射为Timestamp。

配置

API Base URL：确认连接的是Production还是Sandbox环境。两者的URL结构通常不同，例如https://[client].highradius.com/api与https://[client]-sandbox.highradius.com/api。
Client Scope：确保API Client对radiusOne、collections、deductions和cashApp作用域具有read访问权限。
日期范围：如果交易量较高（每月超过10万张发票），每次运行的提取窗口应控制在3个月以内。
分页限制：脚本默认每页返回1000条记录。如果服务器返回超时错误，请调整API调用中的limit参数。
节流与速率限制：HighRadius可能会实施速率限制。如果遇到HTTP 429错误，请在分页循环中加入time.sleep(1)命令。

a 示例查询 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()

准备好开始了吗？

立即开始映射发票生命周期，改善流动性并缩短应收账款周转天数。我们的团队将在整个技术实施过程中为您提供支持。

返回改进指南下载模板

优化应收账款管理，立即改善现金流

借助自动化流程洞察，将应收账款周转天数缩短15至20天

开始免费试用

无需信用卡……几分钟即可完成设置

您的应收账款数据模板

您的应收账款数据模板

应收账款属性

应收账款活动

提取指南

HighRadius分析与报表导出

步骤

配置

a 示例查询 sql

HighRadius REST API数据提取

步骤

配置

a 示例查询 python

准备好开始了吗？

优化应收账款管理，立即改善现金流

您的应收账款数据模板

您的应收账款数据模板

应收账款属性

应收账款活动

提取指南

HighRadius分析与报表导出

步骤

配置

a 示例查询 sql

HighRadius REST API数据提取

步骤

配置

a 示例查询 python

准备好开始了吗？

优化应收账款管理，立即改善现金流

我们重视您的隐私