应收账款数据模板

HighRadius

← 返回改进指南

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

应收账款数据模板

此模板概述了在HighRadius中分析开票工作流所需的核心内容，包括构建完整事件日志所需的数据点、流程节点和技术步骤。按照本指南，您可以梳理收款周期，并找出改善现金流的机会。

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

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

下载模板

应收账款属性

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

3 必填 6 建议填写 10 选填

	名称	说明
	事件时间戳 EventDateTime	活动发生的具体日期和时间。
说明此属性标记事件在HighRadius系统中发生的准确时刻，为活动排序和计算流程步骤间的时长提供时间维度。分析时，时间戳用于计算周期时间，例如应收账款周转天数（DSO）或争议处理时间。它还支持分析特定时段内的吞吐量和资源利用情况。重要性准确的时间信息是计算各项基于时长的KPI并正确排列事件的必要条件。获取途径 HighRadius交易日志中的时间戳列示例 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活动日志、备注历史记录或交易历史记录表示例发票已创建已发送付款提醒争议案例已立案已收到全额付款
	付款期限偏差 PaymentTermVariance	到期日与付款日期之间的天数差。
说明此计算属性用于衡量实际付款与约定付款期限之间的偏差。正数表示逾期付款，负数表示提前付款。这是付款期限一致性审计的直接衡量指标。汇总分析偏差后，企业可以识别经常逾期付款的客户，并相应调整信用期限或催收策略。重要性直接衡量客户是否遵守合同条款。获取途径根据到期日和付款日期计算示例 5天-2天0天
	催收人员姓名 CollectorName	负责催收活动的经办人或用户姓名。
说明此属性用于识别执行人工活动的具体HighRadius用户或经办人，例如记录通话、发送专门邮件或审核争议。 “催收人员效率基准”仪表板使用此属性评估个人绩效和工作量分配，帮助管理者识别培训需求，或在催收团队内重新分配客户组合。重要性支持在资源层面分析绩效。获取途径活动日志/用户表示例 John DoeJane Smith系统管理员CollectionAgent_01
	到期日 DueDate	客户按合同约定应付款的日期。
说明到期日根据发票创建日期和适用的付款条款确定，是催收流程的目标期限。将全额付款日期与此属性进行比较，即可计算付款条款合规率。此属性对于判断付款是否按时、逾期或提前至关重要。重要性用于判断逾期情况和计算应收账款周转天数（DSO）的参考日期。获取途径发票抬头表（到期日字段）示例 2023-11-302023-12-15
	发票金额 InvoiceAmount	发票的总金额。
说明此属性表示向客户开具的原始总金额，是计算未结余额以及评估争议或延迟付款财务影响的基准。流程挖掘分析会按金额为案例赋予权重。例如，在“低金额争议量”KPI中，可据此区分高金额优先催收案例与低金额行政事务。重要性支持按财务影响而非仅按案例数量进行加权分析。获取途径发票抬头表（金额字段）示例 1500.00250.5010000.00
	客户名称 CustomerName	与发票关联的客户账户名称。
说明此属性用于识别负责支付发票的实体。在HighRadius中，它关联到债务人的主数据记录。按客户名称分析流程绩效，可以找出需要采用专门催收策略或经常延迟付款的账户，并为“客户风险与账龄矩阵”仪表板提供数据。重要性支持按账户细分分析，找出存在问题的客户。获取途径客户主数据或发票抬头示例 Acme CorpGlobal IndustriesTechStart IncRetail Giant Ltd
	是否自动执行 IsAutomated	用于标记活动是否由系统在无人介入的情况下执行。
说明此布尔属性用于区分HighRadius自动化引擎执行的步骤（如自动发送通知或现金匹配）与用户手动执行的步骤。它是“现金应用自动化跟踪器”和“无人工干预发票率”KPI的重要数据，可用于衡量自动化投资回报，并找出仍需大量人工操作的流程步骤。重要性用于衡量HighRadius实施效果。获取途径活动日志（系统用户与人工用户检查）示例 truefalse
	业务单元 BusinessUnit	开具发票的内部部门或子公司。
说明此属性按组织结构细分数据，例如“北美销售”“欧洲、中东和非洲服务”或特定产品部门。它支持“付款条款合规审计”比较组织不同部分的绩效，帮助判断催收问题是普遍存在，还是仅出现在特定业务实践中。重要性支持比较不同组织业务领域的表现。获取途径发票抬头/ERP映射示例消费电子工业零部件软件服务北美西部
	争议原因代码 DisputeReasonCode	分配给争议案例的类别代码。
说明此属性用于分类客户拒绝付款的原因，例如“定价错误”“货物损坏”或“缺少文档”。HighRadius Deductions Cloud使用标准代码。分析这些代码有助于找出未付款的根本原因。汇总相关数据后，企业可以解决销售或物流环节的上游问题，避免其导致后续催收延迟。重要性是延迟付款根因分析的关键数据。获取途径争议/扣款管理模块示例 P01（定价）Q02（质量）S03（短缺）管理错误
	信用评级 CreditRating	分配给客户的信用状况评分或评级。
说明此属性反映客户的风险等级，通常来自信用机构，或由HighRadius Credit Cloud根据内部评分得出。它是客户风险与账龄矩阵中的一个维度。将账龄与信用评级结合分析，有助于识别高风险敞口，例如信用评级较低的客户仍有大量未结余额。重要性是风险管理和确定催收优先级的重要依据。获取途径信用管理模块／客户主数据示例 AAAB+高风险低风险
	地区 Region	与发票或客户相关的地理区域。
说明此属性定义交易涉及的地理区域，例如“北美”“EMEA”或“APAC”。它有助于开展区域对标，了解文化或监管差异对付款行为和催收速度的影响，也适用于高层管理报告。重要性支持按地理区域分析绩效。获取途径客户主数据或发票抬头示例北美EMEA拉丁美洲APAC
	客户细分 CustomerSegment	根据客户规模、行业或战略价值进行分类。
说明此属性将客户划分为“战略客户”“中型市场”“中小企业”或“高风险”等层级。在争议解决绩效仪表板中，可借此查看不同客户群体的服务水平是否存在差异，并确保高价值客户在催收过程中得到适当关注。重要性分析客户细分，以配合业务战略和服务水平协议。获取途径客户主数据示例战略重点客户批发零售政府
	承诺付款日期 PromiseToPayDate	客户承诺付款的日期。
说明此属性记录客户在催收沟通中承诺付款的日期，是HighRadius Collections Cloud的一项关键功能。此日期用于计算承诺付款可靠性指数，并与实际付款日期进行比较，以判断客户是否履行承诺。它有助于评估承诺的可信度以及催收人员的协商成效。重要性是预测现金流和衡量客户可靠性的关键依据。获取途径催收模块／P2P交易表示例 2023-12-102023-12-20
	数据上次更新时间 LastDataUpdate	流程挖掘模型中数据上次刷新的时间戳。
说明此属性记录数据集中的记录提取或上次更新的时间，帮助分析人员了解数据时效性和报告可能存在的延迟。对于持续监控仪表板，这一点尤为重要，因为用户需要知道查看的是实时数据，还是前一天的数据快照。重要性确保KPI所用数据的新鲜度清晰可见。获取途径 ETL时间戳示例 2023-12-01T00:00:00Z2023-12-02T06:00:00Z
	未结金额 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 选填

	活动	说明
	争议已解决	争议调查结束并作出决定，例如确认扣款有效或认定索赔无效。
重要性这是“争议处理周期时间”的计时终止事件。此处的延迟会直接影响账龄。获取途径扣款模块中的状态变更，例如变为“已关闭”“已解决”或“已批准”。采集比较状态字段变更前后的值事件类型 inferred
	争议案例已立案	创建与发票关联的扣款或争议案例，表示客户拒绝支付部分或全部余额。
重要性此事件会触发“争议处理绩效”分析，并暂停对争议金额执行常规催收。获取途径扣款/争议模块中与发票关联的案例ID及其创建时间戳。采集生成争议案例时记录事件类型 explicit
	发票已创建	发票首次在HighRadius平台中创建，或从ERP系统导入平台。这标志着催收生命周期的开始。
重要性为账龄计算和应收账款周转天数（DSO）指标确定基准时间戳。获取途径发票编号首次出现的未结发票表或数据集成日志。采集发票抬头表插入记录时记录事件类型 explicit
	发票已结清	发票余额归零并在系统中关闭时发生的最终状态变更。
重要性这是“平均应收账款周转天数”的结束时间戳，表示流程已完成。获取途径发票抬头表；状态为“已关闭”或“已结清”。采集比较状态字段变更前后的值事件类型 inferred
	已创建付款承诺	系统中记录的正式承诺，客户承诺在指定日期前支付指定金额。
重要性这是“付款承诺可靠性指数”的关键数据，可用于预测现金流并衡量客户可靠性。获取途径与发票关联的P2P（付款承诺）模块/选项卡。采集创建P2P记录时记录事件类型 explicit
	已发送付款提醒	通过催收模块向客户发送的自动通知（电子邮件或信函），用于跟踪催收策略的执行情况。
重要性这是衡量通知是否实际促成付款的“催收提醒效果”仪表板的关键数据。获取途径与发票ID关联的通知历史选项卡或通信日志。采集催收策略执行操作时记录事件类型 explicit
	已收到全额付款	收到的款项已全额偿清债务。此日期是计算账龄时采用的实际付款日期。
重要性用于计算“付款承诺兑现率”，并比较实际现金流与预期现金流。获取途径与最终结清凭证关联的付款交易日期。采集记录结清付款的交易日期事件类型 explicit
	银行对账单已匹配	现金应用引擎或用户成功将银行对账单中的一条记录与这张发票关联。
重要性这是“现金自动应用率”的核心指标，可区分资金到账与资金应用。获取途径现金应用模块中的匹配记录创建事件。采集匹配规则执行时记录事件类型 explicit
	争议审核中	争议案例从“新建”转为正在调查状态，标志着分析人员开始实际处理。
重要性用于“争议工作流瓶颈查找”分析，衡量案例创建到开始处理之间的延迟。获取途径扣款模块审计日志中的状态变更，例如变为“处理中”或“调查中”。采集比较状态字段变更前后的值事件类型 inferred
	已开具贷项通知单	生成贷项通知单以冲减发票余额，通常源于争议得到确认或发生退货。
重要性用于跟踪“贷项通知单处理效率”，以及争议解决到财务过账之间的时间差。获取途径 ERP同步日志，或与原始发票ID关联的贷项通知单表。采集贷项通知单凭证关联到发票时记录事件类型 explicit
	已记录催收电话	催收人员针对该发票记录的人工备注或互动，表明流程中发生了人工介入。
重要性支持“催收人员效率基准”分析，并区分自动催收和人工催收。获取途径催收模块中的备注/历史记录选项卡。采集用户保存通话备注时记录事件类型 explicit
	已过付款到期日	此计算事件表示发票在约定付款期限过后仍未结清。
重要性这是“付款条款合规审计”的关键数据，标志着发票从未逾期转为已逾期。获取途径通过比较发票到期日与当前日期（未结时）或付款日期（已结时）计算得出。采集比较到期日字段与活动日期得出事件类型 calculated
	部分付款已过账	收到的付款仅覆盖发票总额的一部分，因此仍有余额未结清。
重要性为“部分付款复杂度分析”提供数据，并反映现金应用可能存在的阻碍。获取途径现金应用模块中与发票关联的付款交易，且付款金额小于未结金额。采集付款已应用但状态仍为未结时记录事件类型 explicit

建议填写选填

数据提取指南

如何从HighRadius获取数据

步骤

登录HighRadius Integrated Receivables平台，进入Analytics或Reports模块。
找到Transaction History或Open Items报告模板。您可能需要配置三种独立导出，以覆盖完整生命周期：发票抬头数据、收款活动和争议/扣款历史。
配置发票抬头导出：选择发票编号、客户名称、发票金额、发票日期、到期日、结清日期和最终状态等列。按相关公司代码和创建日期范围筛选，确保覆盖流程挖掘所需的时间段。
配置收款活动导出：选择发票编号、活动类型（电话、电子邮件、备注）、活动日期、收款专员姓名和付款承诺详情等列。确保同时包含自动系统操作和人工用户日志。
配置争议历史导出：选择发票编号、争议案例ID、争议金额、状态变更日期、原因代码和解决日期等列，以记录扣款的完整生命周期。
配置付款/现金应用导出：选择发票编号、付款参考号、付款日期、付款金额和付款类型（部分付款、全额付款、贷项通知单）等列。
运行这些报告，并将结果导出为CSV格式。
将CSV文件导入暂存数据库或数据转换工具（如Python/Pandas或SQL数据库），执行数据整合。
运行查询部分提供的转换脚本，统一列名、计算衍生活动（如已过到期日），并将不同来源的数据整合为单一事件日志。
检查日期格式是否一致（建议使用ISO 8601），并确认所有文件中的发票编号格式相同（例如，在格式不一致时删除前导零）。
将最终结果集导出为单个CSV文件。
将最终CSV上传至ProcessMind，并将InvoiceNumber映射到案例ID、EventDateTime映射到时间戳、ActivityName映射到活动。

配置

日期范围：根据发票创建日期选择滚动时间窗口（例如过去12个月），确保覆盖完整生命周期。
数据源：需要访问HighRadius中的Collections、Cash Application和Deductions模块。
数据粒度：确保报告按发票级别生成，而非账户级别或汇总级别。
用户权限：提取数据的用户需要具备Reporting或Analytics Admin权限，才能访问历史活动日志。
系统操作：明确启用筛选条件，将系统或自动化用户操作纳入活动日志，以记录自动发送的通信。
映射要求：可能需要将HighRadius活动类型映射为标准流程挖掘活动名称（例如，将“催款函”映射为“已发送付款提醒”）。

查询示例 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令牌。令牌有效期有限，通常为1小时。脚本会自动获取初始令牌。
运行脚本：获取数据 脚本依次查询指定端点。首先获取发票抬头级数据，然后使用发票编号作为必要的参考键，逐一查询相关端点，获取活动（备注）、付款承诺、争议和付款历史。
数据转换与活动映射 脚本会将原始JSON响应处理为扁平化的事件日志结构，并将特定HighRadius代码映射为所需的活动名称。例如，脚本会比较invoice_balance和total_amount，区分“已登记部分付款”和“已收到全额付款”。此外，还会将到期日与结清日期或当前日期比较，计算“已过到期日”活动。
处理分页 HighRadius API通常会对结果分页。提供的脚本包含循环机制，会持续获取各页数据，直到没有更多记录。请确保此过程中的网络连接稳定。
整合数据 脚本会将提取的各类列表（发票、活动、争议、付款）合并到单个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映射到案例ID、ActivityName映射到活动、EventDateTime映射到时间戳。

配置

API Base URL：确认连接的是生产环境还是沙盒环境。两种环境的URL结构通常不同（例如，https://[client].highradius.com/api与https://[client]-sandbox.highradius.com/api）。
客户端权限范围：确保API Client对radiusOne、collections、deductions和cashApp范围具有read访问权限。
日期范围：如果交易量较大（每月超过100,000张发票），每次提取的时间范围应控制在3个月以内。
分页限制：脚本默认每页获取1,000条记录。如果服务器返回超时错误，请调整API调用中的limit参数。
请求频率限制：HighRadius可能会限制请求频率。如果遇到HTTP 429错误，请在分页循环中加入time.sleep(1)命令。

查询示例 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分析与报告导出

步骤

配置

查询示例 sql

通过HighRadius REST API提取数据

步骤

配置

查询示例 python

准备好开始了吗？

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