> 持续流程改进 > 应付账款发票处理 > Sage Intacct > 数据模板

应付账款发票处理数据模板

Sage Intacct

← 返回改进指南

应付账款发票处理属性(24) 应付账款发票处理活动(14) 数据提取指南(3)

应付账款发票处理数据模板

此模板为收集应付账款发票处理分析所需数据提供了清晰框架，并列出您需要从系统中提取的关键属性和活动。按照本指南准备数据，助您高效开启流程挖掘。

建议收集的属性
需要跟踪的关键活动
数据提取指南

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

下载模板

应付账款发票处理属性

以下是建议纳入事件日志的数据字段，可用于全面分析应付账款发票处理流程。

5 必填 9 建议填写 10 选填

	名称	说明
	发票 InvoiceNumber	每张供应商发票的唯一标识符，也是跟踪发票从收到到付款全过程的主要案例ID。
说明发票编号是应付账款分析的核心，用于唯一标识每张已处理的发票。它将验证、审批和付款等相关活动关联起来，形成一个完整的流程实例。在流程挖掘中，此属性可用于端到端还原每张发票的生命周期，分析流程路径、找出特定发票的瓶颈，并计算案例级指标，例如总周期时间。其他属性则用于补充这张发票的处理情况。重要性这是关键的案例ID，可关联单张发票的所有流程步骤，从而分析端到端处理时间和路径。获取途径这通常是Sage Intacct中应付账款账单或供应商发票对象的“账单编号”或“发票编号”字段。示例 INV-2023-001237854-AXBSI-990432
	开始时间 EventTime	具体活动或流程步骤发生的准确日期和时间。
说明事件时间（即时间戳）记录活动发生的准确时刻。这些时间数据对于正确排列事件顺序以及计算流程各步骤之间的耗时至关重要。在流程挖掘分析中，时间戳用于按时间顺序构建流程图、计算活动间的周期时间，并分析流程绩效随时间的变化。它有助于识别延误发生的时段（例如周末或非工作时间），也是所有基于时间的关键绩效指标的计算依据。重要性此时间戳对于按时间顺序排列事件以及计算周期时间、等待时间等所有时长指标至关重要。获取途径根据Sage Intacct对象中的多个日期字段生成，例如应付账款账单的“创建日期”、“审批日期”或应付账款付款的“付款日期”。示例 2023-10-26T10:00:00Z2023-10-27T14:35:10Z2023-11-05T09:15:00Z
	数据上次更新时间 LastDataUpdate	表示此记录的数据上次从源系统刷新或提取时间的时间戳。
说明此属性记录最近一次数据提取的时间戳，有助于了解所分析数据的新旧程度并管理数据刷新计划。在仪表板和报告中，此信息可帮助用户判断洞察是否及时。例如，如果数据上次更新是在一周前，得出的结论就需要考虑到尚未纳入近期流程活动。此字段对于数据治理和维护分析可信度也很重要。重要性显示数据的新旧程度，帮助用户了解流程分析反映的最新情况，以及何时需要再次刷新数据。获取途径在数据提取、转换和加载（ETL）过程中生成此时间戳，并添加到每一行。示例 2023-11-20T04:00:00Z2023-11-21T04:00:00Z
	活动 ActivityName	具体流程步骤或事件的名称，例如“发票已批准”或“付款已执行”。
说明活动名称用于描述应付账款流程中的单个步骤。这些活动按顺序排列，构成每张发票的流程路径。分析活动顺序是流程挖掘的核心。通过分析，您可以发现实际流程图、识别偏离标准过程的情况，并分析返工循环（例如“发现差异”后接“差异已解决”）。活动的频率和顺序是了解流程效率的基础。重要性此属性定义流程图中的步骤，是可视化流程路径、找出瓶颈和分析偏差的基础。获取途径此属性根据Sage Intacct中与应付账款账单和付款相关的系统事件、状态变更或审计轨迹条目生成。示例收到发票发票已批准已安排付款付款已执行
	源系统 SourceSystem	数据提取自哪个系统，通常是用于标识ERP或会计软件的固定值。
说明此属性标识流程数据的来源。在多系统环境中，它有助于区分数据源并明确数据沿袭。在此视图中，该值始终为“Sage Intacct”。在单系统分析中，此值通常固定不变，但对于数据治理以及未来可能整合多个系统数据的项目而言，它仍然十分重要。此属性可确认分析使用的是预期来源的数据。重要性明确标识数据来源，确保数据可追溯。这对于数据治理和多系统环境至关重要。获取途径通常是在数据提取和转换过程中添加的固定值。示例 Sage Intacct
	付款状态 PaymentStatus	与发票关联的付款交易当前状态。
说明付款状态描述付款本身的状态，与发票状态不同。可能的值包括“已安排”“处理中”“已付款”“已结清”或“失败”。这一属性是“付款状态与错误监控”仪表板的重点。财务团队可借此跟踪付款批次的成功情况，快速发现并处理付款失败，并监控潜在的重复付款。了解付款在各状态停留的时间，有助于优化付款执行流程，提高现金流预测的准确性。重要性跟踪最终付款步骤的状态和结果，帮助快速发现并处理付款错误或延迟。获取途径这些信息可在Sage Intacct的AP Payment或Bill Payment对象中找到。示例已安排已发送至银行已结清已作废
	供应商名称 VendorName	提交发票的供应商法定名称。
说明供应商名称用于标识与发票关联的供应商。此属性对于分析应付账款流程中各供应商的行为和绩效至关重要。您可以按此维度筛选流程图，查看特定供应商的发票如何处理。它是“供应商绩效与处理时间”仪表板和“供应商周期时间差异”关键绩效指标的重要依据，可帮助找出哪些供应商的发票处理较快，哪些经常延误或出现差异，从而发现与供应商协作和标准化流程的机会。重要性按供应商分析流程差异和绩效，帮助找出特定供应商相关的瓶颈或发票质量问题。获取途径此信息位于Sage Intacct的“供应商”对象中，并与应付账款账单关联。示例 Staples Inc.Office DepotGlobal Tech ServicesCreative Solutions LLC
	到期日 DueDate	根据付款条款，发票应付款的日期。
说明到期日是合同约定的发票结算日期，由发票日期和与供应商协商的付款条款（例如净30天）确定。此属性对于监控按时付款情况和财务规划至关重要。您可以在“付款合规与政策遵循”仪表板中使用它标记逾期付款。它也是计算“提前付款折扣获取率”关键绩效指标的重要依据，可作为衡量提前付款的基准。重要性此日期对于分析按时付款率、管理现金流和发现获取提前付款折扣的机会至关重要。获取途径这是Sage Intacct应付账款账单对象中的“到期日”字段。可以手动输入，也可以根据付款条款自动计算。示例 2023-11-152023-12-302024-01-10
	发票状态 InvoiceStatus	发票在应付账款工作流中的当前处理状态。
说明发票状态表示发票在处理周期中的当前位置，例如“草稿”“已提交审批”“已批准”或“已付款”，反映发票当前的处理进度。这一属性是“发票处理量与数量趋势”仪表板的关键依据，可显示任一时点不同状态下的发票分布。运营经理可借此监控工作量、发现发票积压的瓶颈，并预测完成时间。跟踪状态随时间的变化，也是生成流程挖掘事件日志的常见方法。重要性呈现发票的当前状态，便于监控工作量，并发现发票停滞的环节。获取途径在Sage Intacct的AP Bill对象中，通常对应“状态”或“State”字段。示例草稿已提交已批准已付款
	发票金额 InvoiceAmount	发票的总金额。
说明发票金额表示供应商提交发票的总金额。此属性对于财务分析以及了解发票金额如何影响处理路径至关重要。分析时，您可以按金额区间（例如低、中、高）对发票分类，查看高金额发票是否采用不同的审批路径或需要更长处理时间。此属性也是“付款政策一致性率”关键绩效指标的重要组成部分，因为审批限额通常取决于发票金额。它还有助于优先改进高金额交易的处理流程。重要性支持按金额开展分析，例如识别高金额发票是否采用不同路径或耗时更长，也有助于检查审批限额是否得到遵守。获取途径这是Sage Intacct应付账款账单对象中的“金额”或“交易金额”字段。示例 150.755000.0025000.50
	成本中心 CostCenter	发票费用所归属的具体部门或业务单元。
说明成本中心是组织维度，用于标明发票费用由业务的哪个部分承担。它可用于预算管理、成本分摊和财务报告。在流程挖掘中，这一属性是“成本中心处理差异”仪表板的重要依据。您可以按成本中心比较周期时间、返工率等关键指标。找出表现较好的成本中心，有助于总结并推广最佳实践；表现不佳的成本中心则可能需要有针对性的流程改进或培训。这也是“成本中心周期时间差异”KPI的主要属性。重要性支持比较不同业务单元的绩效，发现差异和流程标准化机会。获取途径这是Sage Intacct中AP Bill行项目的标准维度，通常标记为“部门”，也可能是用于成本中心的自定义维度。示例销售 - US市场营销IT基础设施研发
	用户名 UserName	在发票处理过程中执行特定活动的员工或用户姓名。
说明用户名用于标识流程事件的负责人，例如数据录入、验证或审批。它有助于明确责任，并分析个人或团队的绩效。这一属性是“发票审批周期时间分析”仪表板的重要依据，可用于查看某些审批人是否经常处理缓慢，也能找出表现突出的员工或需要额外培训的用户。按用户分析活动，有助于管理资源并了解工作量分布。重要性记录执行操作的用户，是分析审批人绩效、工作量分布和培训需求的关键依据。获取途径这些信息记录在Sage Intacct中AP Bill和AP Payment对象的审计轨迹或历史日志中，并与状态变更或修改相关联。示例 Alice JohnsonBob Williamssystem.user
	过账日期 PostingDate	发票交易过账至总账（GL）的日期。
说明过账日期是与发票相关的财务交易正式记入公司账簿（总账）的日期。此日期对于会计和财务报告至关重要，因为它决定了费用计入哪个财务期间。在流程分析中，从收到发票到过账之间的时间差，可以揭示验证和审批环节的低效之处。它是“发票已过账至总账”活动的关键节点，也常用于衡量周期时间中的“入账至付款”阶段。分析过账日期有助于确保及时结账并准确报告。重要性显示发票正式记入财务系统的时间，对于衡量会计周期时间和确保及时提交财务报告至关重要。获取途径这是Sage Intacct应付账款账单对象中的“过账日期”字段。示例 2023-10-282023-11-022023-11-10
	采购订单编号 PurchaseOrderNumber	与发票关联的采购订单（PO）标识符（如适用）。
说明采购订单编号将发票与预先批准的采购申请关联起来。发票可以关联采购订单，也可以不关联。采购订单编号通常有助于实现更自动化的匹配流程（双向或三方匹配）。此属性是分析“采购订单已匹配”活动及相关差异的基础。您可以据此区分关联采购订单和未关联采购订单的发票，比较两者的周期时间和自动化率。关联采购订单的发票若差异率较高，可能表明采购订单创建或收货流程存在问题。重要性区分关联采购订单和未关联采购订单的发票。两者通常采用不同的处理路径，自动化潜力也不同。获取途径 Sage Intacct应付账款账单对象中提供此字段，用于将账单关联到现有采购订单。示例 PO-004581PO-005123不适用
	供应商ID VendorId	供应商的唯一系统标识符。
说明供应商ID是系统为每条供应商记录生成的唯一标识符。与有时不一致的供应商名称不同，供应商ID是稳定的数据关联键，适用于数据分析。在仪表板中，供应商名称更便于阅读；但在汇总和筛选时，供应商ID更可靠，尤其是在供应商名称略有差异的情况下，例如“Staples Inc.”和“Staples”。它能确保同一供应商的所有交易正确归组，从而准确分析绩效。重要性为供应商提供稳定且唯一的标识，即使名称存在差异，也能准确汇总相关数据。获取途径对应Sage Intacct中Vendor对象的“供应商ID”字段。示例 V1001V1002V2304
	发票日期 InvoiceDate	供应商开具发票的日期。
说明发票日期也称账单日期，是供应商印在发票上的日期，也是付款期限的正式起算日，例如“Net 30”期限的起始日。这一属性可作为基准，用于衡量发票录入系统所需的时间，即“收到发票”活动的发生时间。这个指标称为“发票延迟”。对于希望提高流程可见性并改善现金流预测的应付账款部门，缩短这一延迟通常是重要目标。发票日期也是许多财务计算的基础日期。重要性代表供应商视角下的起始日期，可用于计算发票接收延迟和确定付款到期日。获取途径对应Sage Intacct中AP Bill对象的“账单日期”或“日期”字段。示例 2023-10-152023-10-202023-11-01
	审批周期时间 ApprovalCycleTime	从发票提交审批到最终获批所经过的时间。
说明审批周期时间专门衡量流程中审批阶段的持续时间，计算方式为“发票已批准”时间戳减去“已转交审批”时间戳。这一指标是“发票审批周期时间分析”仪表板的重点，可帮助您定位审批工作流中的瓶颈，判断问题是否与特定审批人、部门或发票类型有关。缩短审批周期时间通常是重要目标，因为它会直接影响提前付款折扣的获取和按时付款。重要性衡量审批工作流的效率，帮助发现处理缓慢的审批人或延误付款、导致错失折扣的瓶颈。获取途径在流程挖掘工具中，用“发票已批准”活动的时间戳减去“已转交审批”活动的时间戳即可计算此指标。示例 2天3小时7天1小时10小时30分钟
	差异原因 DiscrepancyReason	说明发票差异原因的代码或文本，例如价格或数量不符。
说明差异原因用于说明发票未通过验证或采购订单匹配的具体情况，解释发票为何被标记为需要人工审核。常见原因包括价格差异、数量不符或信息缺失。这一属性是“差异解决时间与返工”仪表板的重要依据。分析最常见的差异原因，有助于企业找出根本原因，例如特定供应商或商品的问题，或内部数据录入错误。这些洞察对于有针对性的流程改进非常有价值，例如更新主数据或改善与供应商的沟通。重要性说明返工和延迟的根本原因，便于有针对性地改进，减少异常并提高直通处理率。获取途径这些信息可能存储在Sage Intacct的自定义字段或备注字段中，也可能根据其中的特定异常状态，或集成的OCR/数据采集解决方案推导得出。示例价格不符数量不符采购订单编号无效重复发票
	币种 Currency	发票金额所使用的币种。
说明币种属性用于指定发票金额的货币单位，例如USD、EUR或GBP。对于处理多种币种发票的跨国组织，这一属性尤为重要。分析时，币种是准确编制财务报告以及将金额换算为统一币种进行比较的必要依据。按币种筛选，还能发现某些币种的发票是否处理时间更长，原因可能是银行规定或审批流程不同。它为所有金额提供必要的背景信息。重要性为所有金额提供必要的背景信息，确保财务分析准确，尤其适用于跨国组织。获取途径对应AP Bill对象中的“币种”字段。启用多币种功能时，该字段通常继承自Sage Intacct中的Vendor记录。示例 USDEURGBP
	折扣截止日期 EarlyPaymentDiscountDate	符合提前付款折扣条件的付款截止日期。
说明这一属性表示符合供应商折扣条件的付款截止日期。它根据发票日期和折扣条款计算，例如“2/10，Net 30”条款下，截止日期为发票日期后10天。这一日期是应付账款流程的重要内部SLA。“提前付款折扣获取率”仪表板会根据此日期判断付款是否及时，从而获得折扣。监控付款时间与截止日期的间隔，有助于发现审批和付款安排环节的瓶颈。重要性这是应付账款团队必须关注的重要期限；按时付款可直接为公司节省成本。获取途径根据Sage Intacct中AP Bill记录的“账单日期”和“付款条款”计算。示例 2023-10-252023-11-102023-11-30
	折扣金额 EarlyPaymentDiscountAmount	在标准到期日之前付款时可享受的折扣金额。
说明这一属性表示供应商根据付款条款提供的提前付款折扣金额。例如，“2/10，Net 30”表示在10天内付款可享受2%的折扣。这一金额是“提前付款折扣获取率”KPI和仪表板的重要依据。它量化了每张发票的节省机会，帮助财务团队优先处理折扣力度较大的发票。比较潜在折扣总额与实际获得的折扣，可了解流程低效造成的财务影响。重要性量化提前付款的潜在节省金额，帮助确定发票处理优先级，并衡量应付账款流程效率对财务的影响。获取途径通常根据Sage Intacct中AP Bill的“付款条款”和“发票金额”字段计算。示例 10.0050.25250.00
	是否直通处理 IsStraightThrough	布尔标记；如果发票处理过程中没有人工干预或返工，则值为true。
说明这一属性用于识别从接收到安排付款全程自动处理、没有人工操作或异常处理的发票。它通常与“是否返工”标记相反。此标记用于计算“发票直通处理率”KPI，这是衡量自动化程度和流程效率的重要指标。直通处理率较高，说明应付账款流程成熟且管控良好。分析未能直通处理的发票特征，有助于找出实现全面自动化仍面临的障碍。重要性识别全自动处理的发票，帮助衡量自动化举措的成效，并找出进一步改进的机会。获取途径此标记在流程挖掘工具中计算，通常取“是否返工”标记的反值，或通过定义一组“理想路径”活动序列来确定。示例 truefalse
	是否返工 IsRework	布尔标记；如果发票经历过返工循环，例如差异处理，则值为true。
说明这一计算属性用于标记经历过一次或多次返工的发票。当流程步骤因错误或异常而需要重复执行时，就会发生返工，例如先出现“发现差异”事件，随后出现“差异已解决”事件。此标记用于计算“发票返工率”KPI，也可用于筛选流程图，专门分析返工路径。了解哪些发票需要返工及其原因，对于找出流程低效的根本原因至关重要，例如供应商数据质量不佳或主数据有误。重要性标记需要额外计划外工作的发票，帮助量化流程低效并找出异常的根本原因。获取途径在流程挖掘工具中，通过检查案例事件序列中是否出现特定返工活动（例如“差异已解决”）来计算此布尔标记。示例 truefalse
	部门 Department	与发票相关的内部部门名称，通常用于审批和成本分摊。
说明部门是组织属性，用于将发票分配给公司内特定职能部门，例如“市场营销”或“信息技术”。它通常用于将审批任务分派给相应的部门负责人或经理。与成本中心类似，这一维度支持比较业务不同部分的绩效。您可以按部门比较审批时间或返工率，了解哪些部门的流程顺畅，哪些部门仍有改进空间。这类分析有助于推动整个组织的应付账款流程标准化。重要性支持比较业务不同职能部门的流程绩效，推动流程标准化。获取途径这是Sage Intacct中的标准维度，可分配给AP Bill等交易。示例市场营销销售IT财务

必填建议填写选填

应付账款发票处理活动

以下是建议记录在事件日志中的关键流程步骤和里程碑，可用于准确发现并分析发票工作流。

7 建议填写 7 选填

	活动	说明
	付款已执行	表示付款交易已执行，资金已支付给供应商。这是带有明确交易日期的事件。
重要性这是衡量付款合规性和提前付款折扣获取率的关键节点。从审批到此事件的耗时反映付款处理效率。获取途径从与“应付账款账单”关联的“应付账款付款”对象中获取。该对象包含“付款日期”或交易执行时间戳。采集使用相关应付账款付款记录中的“付款日期”字段。事件类型 explicit
	付款已结清	最后一步，确认款项已通过银行结算且交易已对账。通常会在Sage Intacct现金管理模块的银行对账过程中记录。
重要性此事件标志着发票生命周期真正结束。端到端周期时间计算至此，完整呈现现金流出情况。获取途径根据现金管理模块中与“应付账款付款”交易关联的“结算日期”或“对账日期”推断。采集使用与付款交易关联的银行对账记录中的结算日期。事件类型 inferred
	发票已批准	表示指定审批人已批准发票，可以进行付款过账。Sage Intacct的审批历史或审计轨迹会明确记录此事件。
重要性这是审批周期结束的关键节点。此步骤之前的延误表明审批存在瓶颈，而快速审批有助于获得提前付款折扣。获取途径 “应付账款账单”对象关联的审批历史日志会明确记录此事件，通常还会记录时间戳和审批人。采集使用发票审批历史中最终审批记录的时间戳。事件类型 explicit
	发票已过账至总账	表示已批准的发票正式过账至总账，并形成财务负债。这是Sage Intacct中的核心会计事件，会作为明确交易记录。
重要性这是重要的财务节点，意味着发票已成为公司的正式负债，可以安排付款，并会影响财务报表。获取途径这是明确记录的交易。过账日期直接存储在“应付账款账单”对象或相关“总账分录”记录中。采集使用应付账款账单中的“过账日期”，或相关总账交易的创建日期。事件类型 explicit
	已提交审批	表示已验证并完成匹配的发票进入审批工作流。发票提交审批并触发通知时，Sage Intacct会记录此操作。
重要性这标志着审批周期开始。跟踪此事件对于分析发票平均审批时间这一关键绩效指标和找出延误至关重要。获取途径 “应付账款账单”状态变为“已提交审批”时，可从审计轨迹或交易日志中获取。此操作通常会作为明确事件记录。采集使用审计日志中发票提交至审批引擎时的时间戳。事件类型 explicit
	收到发票	发票手动录入Sage Intacct或通过自动采集方案录入时，流程即开始。通常可根据应付账款账单记录的创建时间推断此事件。
重要性这是计算所有周期时间的起点，对于衡量整体流程效率和发票处理量至关重要。获取途径根据“应付账款账单”（APBILL）对象中的“创建日期”时间戳推断。这是最可靠的流程开始事件。采集使用应付账款账单记录的创建时间戳。事件类型 inferred
	采购订单已匹配	确认发票数量、价格等明细已与相应采购订单成功匹配。通常会在用户将采购订单关联到应付账款账单时明确记录。
重要性这是有采购订单支持的发票处理中的关键步骤。匹配失败或耗时过长，可能意味着存在差异，也是常见的瓶颈来源。获取途径用户执行“匹配”操作或将“采购订单”关联到“应付账款账单”对象时，可从交易日志或审计轨迹中获取此事件。采集找出将采购订单关联到应付账款账单的事件日志条目。事件类型 explicit
	发现差异	表示验证或匹配过程中发现不一致，例如价格或数量有差异。发票状态变为“暂停”或“异常”时，通常可推断此事件。
重要性标记返工循环的起点。分析差异的频率和类型，是改善发票返工率这一关键绩效指标的关键。获取途径根据“应付账款账单”对象的状态变更推断，例如变为“暂停”“异常”或“差异”。审计轨迹也可能记录匹配失败的尝试。采集记录应付账款账单对象变为异常相关状态时的时间戳。事件类型 inferred
	发票已取消	表示应付账款账单已取消或作废，流程提前终止。这是系统审计轨迹中明确记录的操作，会使相关负债失效。
重要性识别流程中的终止异常。取消率偏高可能表明存在重复发票或初始数据录入错误。获取途径用户作废或取消“应付账款账单”时会明确记录此事件及其时间戳，也可能反映为“作废”或“已取消”状态。采集使用应付账款账单对象中“作废”交易或状态变为“已取消”时的时间戳。事件类型 explicit
	发票已拒绝	表示审批人拒绝了发票，通常需要更正后重新提交。审批历史日志会明确记录此事件。
重要性揭示审批流程中的返工循环。拒绝率偏高可能表明上游数据不准确或不符合政策要求。获取途径 “应付账款账单”对象关联的审批历史日志会明确记录此事件，其中包含“拒绝”或“驳回”操作。采集使用发票审批历史中“拒绝”或“驳回”记录的时间戳。事件类型 explicit
	发票数据已验证	表示发票数据已通过业务规则验证，例如供应商信息正确且必填字段齐全。通常可根据应付账款账单记录保存或提交时未触发验证错误来推断。
重要性记录初始数据质量检查。此处延误可能表明数据采集不准确或供应商不符合要求，进而影响直通处理率。获取途径根据应付账款账单记录从“草稿”变为“已提交”时的时间戳推断。请检查“应付账款账单”对象中的“状态”或“状态”字段。采集记录应付账款账单对象的状态从“草稿”变为“已提交”时的时间戳。事件类型 inferred
	差异已解决	表示先前发现的差异已解决，发票可以继续处理。通常可根据发票状态从“暂停”变回正常处理状态来推断。
重要性衡量从“发现差异”到“差异已解决”的耗时，对于计算差异解决周期时间这一关键绩效指标至关重要。获取途径根据“应付账款账单”对象从异常状态（如“暂停”）变为活动状态（如“已提交”或“待审批”）推断。采集记录状态从异常状态恢复为处理状态时的时间戳。事件类型 inferred
	已享受提前付款折扣	当付款在供应商提供的提前付款折扣期限内执行时，会触发此计算事件。通过比较付款执行日期、发票日期和付款条款日期得出。
重要性此事件会明确标记成功获得折扣的情况，直接用于计算提前付款折扣获取率这一关键绩效指标，帮助分析并提高成本节省。获取途径将“应付账款付款”对象中的“付款日期”与“应付账款账单”对象中的“发票日期”和“付款条款”字段进行比较后计算得出。采集如果“付款日期”≤（“发票日期”＋“付款条款”中的折扣期限），则触发此事件。事件类型 calculated
	已安排付款	表示已批准并过账的发票被选中并纳入付款批次或付款流程。发票加入“应付账款付款申请”或类似批次对象时，可推断此事件。
重要性这是审批与实际付款执行之间的衔接环节。分析此处耗时，有助于了解现金流管理和付款安排效率。获取途径可根据包含该“应付账款账单”的“应付账款付款”对象的创建日期推断。账单状态也可能变为“已安排付款”。采集使用应付账款账单关联到已安排但尚未执行的付款批次时的时间戳。事件类型 inferred

建议填写选填

数据提取指南

如何从Sage Intacct获取数据

步骤

准备工作：确保您的Sage Intacct用户角色拥有自定义报表编写器的访问权限，并具备应付账款、采购和现金管理模块的读取权限。
打开报表中心：登录Sage Intacct，依次进入“报表”>“自定义报表”。
创建报表1：发票核心事件：新建自定义报表，将AP Bill设为主对象。此报表用于提取AP Bill记录中直接提供的事件。
为报表1添加关联：在报表编写器的“数据”选项卡中，将AP Bill对象与Vendor对象关联，以获取供应商名称。
设置报表1的列：在“列”选项卡中添加Bill No、Vendor Name、Total Amount、Due Date、PO Number、State等字段，以及关键日期字段：When Created（对应“收到发票”）、When Posted（对应“发票过账至总账”）和When Modified。使用公式为这些特定事件创建ActivityName和EventTime列。
创建报表2：审批事件：新建第二个自定义报表，将AP Bill Approval（或类似的审计/历史对象）设为主对象。通过AP Bill Key将其关联回AP Bill和Vendor。
设置报表2的列：此报表用于提取工作流事件。添加AP Bill No、Approver和审批操作日期等列。根据审批状态/操作字段，使用公式将ActivityName设为“提交审批”“发票已批准”或“发票已拒绝”。EventTime为审批操作的时间戳。
创建报表3：付款事件：新建第三个自定义报表，将AP Payment设为主对象。依次关联AP Payment Detail、AP Bill和Vendor。
设置报表3的列：此报表用于提取付款活动。添加AP Bill No、Payment Date（对应“已执行付款”）和State等列。若要提取“已安排付款”，请使用AP Payment记录的When Created时间戳。将其关联到Bank Transaction（来自现金管理），并使用Reconciliation Date记录“付款已结清”活动。
运行并导出报表：为三个报表设置相同的日期范围筛选条件（例如，按AP Bill创建日期筛选最近3至6个月的数据）。运行每个报表，并将结果导出为CSV文件。
合并并转换数据：使用Microsoft Excel（Power Query）、Python脚本或数据准备工具。加载三个CSV文件，确保每个文件中的列名一致（如InvoiceNumber、ActivityName、EventTime等），然后将三个文件的数据纵向合并为一个表。
完成事件日志：在数据转换工具中添加静态列SourceSystem（例如“Sage Intacct”）和LastDataUpdate（当前时间戳）。通过比较“已执行付款”日期与发票到期日/折扣日期，计算衍生活动“已享受提前付款折扣”。将合并后的表保存为单个CSV文件，即可作为事件日志上传。

配置

用户权限：用户角色必须能够访问自定义报表编写器，并拥有以下Sage Intacct对象的读取权限：AP Bill、AP Payment、AP Payment Detail、Vendor、AP Bill Approval History和Bank Transaction。
日期范围：所有报表都必须使用一致的日期范围筛选条件，以确保数据完整性。通常可按AP Bill > When Created筛选最近3至6个月的数据。对于较大的数据集，可缩短每次运行的时间范围（例如每次运行一个月），避免浏览器超时。
对象关联：数据提取的准确性取决于对象之间的关联是否正确。例如，AP Payment Detail用于关联AP Payment和AP Bill。关联错误会导致数据缺失或重复。
报表筛选条件：除日期范围外，如果您在多实体环境中运营，还可按特定实体/公司筛选，也可按供应商类型或账单状态缩小范围。
计算字段/公式：您需要使用报表编写器的公式功能，为报表中的每个事件创建固定的ActivityName列。这是确保最终输出符合流程挖掘要求的关键步骤。

查询示例 sql

-- This is a configuration-based extraction using Sage Intacct's Custom Report Writer.
-- The logic is implemented by creating and combining multiple reports.

-- =============== REPORT 1: CORE INVOICE EVENTS ===============
-- Primary Object: AP Bill
-- Joins:
--   - AP Bill -> Vendor (on VENDORID)

-- Columns / Mapping:
--   InvoiceNumber: AP Bill.Bill No
--   VendorName: Vendor.Name
--   InvoiceAmount: AP Bill.Total Amount
--   DueDate: AP Bill.Due Date
--   PostingDate: AP Bill.When Posted
--   PurchaseOrderNumber: AP Bill.PO Number
--   CostCenter: AP Bill Entry.Department ID [Or other relevant dimension]
--   InvoiceStatus: AP Bill.State
--   SourceSystem: 'Sage Intacct' (Static Value)
--   LastDataUpdate: [Current Extraction Timestamp] (Static Value)

--   --- Activity: Invoice Received ---
--   ActivityName: 'Invoice Received' (Formula/Static)
--   EventTime: AP Bill.When Created
--   UserName: AP Bill.Created By

--   --- Activity: Invoice Data Validated ---
--   ActivityName: 'Invoice Data Validated' (Formula/Static)
--   EventTime: AP Bill.When Submitted for Approval [If available, otherwise use When Created]
--   UserName: AP Bill.Submitted By

--   --- Activity: Purchase Order Matched ---
--   ActivityName: 'Purchase Order Matched' (Formula/Static, create row only if AP Bill.PO Number is not null)
--   EventTime: AP Bill.When Modified [Timestamp when PO Number was populated, may require audit trail report]
--   UserName: AP Bill.Modified By

--   --- Activity: Discrepancy Found / Resolved / Cancelled ---
--   Note: These are status changes. Create one row per relevant status change from an Audit Trail report on AP Bill.
--   ActivityName: (Formula based on AP Bill.State change, e.g., IF(new_state='On Hold', 'Discrepancy Found', IF(old_state='On Hold', 'Discrepancy Resolved', '')))
--   EventTime: Audit Trail.When Changed
--   UserName: Audit Trail.Changed By

--   --- Activity: Invoice Posted To GL ---
--   ActivityName: 'Invoice Posted To GL' (Formula/Static)
--   EventTime: AP Bill.When Posted
--   UserName: AP Bill.Modified By


-- =============== REPORT 2: APPROVAL EVENTS ===============
-- Primary Object: AP Bill Approval History (or equivalent audit object)
-- Joins:
--   - AP Bill Approval History -> AP Bill (on BILLID)
--   - AP Bill -> Vendor (on VENDORID)

-- Columns / Mapping:
--   InvoiceNumber: AP Bill.Bill No
--   EventTime: AP Bill Approval History.Date
--   UserName: AP Bill Approval History.Approver Name
--   ... (other attributes joined from AP Bill)

--   --- Activity Logic ---
--   ActivityName: (Formula based on AP Bill Approval History.Action, e.g., IF(Action='Submitted', 'Routed For Approval', IF(Action='Approved', 'Invoice Approved', IF(Action='Rejected', 'Invoice Rejected', ''))))


-- =============== REPORT 3: PAYMENT EVENTS ===============
-- Primary Object: AP Payment
-- Joins:
--   - AP Payment -> AP Payment Detail (on RECORDNO)
--   - AP Payment Detail -> AP Bill (on BILLID)
--   - AP Bill -> Vendor (on VENDORID)
--   - AP Payment -> Bank Transaction (on PAYMENTKEY)

-- Columns / Mapping:
--   InvoiceNumber: AP Bill.Bill No
--   PaymentStatus: AP Payment.State
--   ... (other attributes joined from AP Bill and Vendor)

--   --- Activity: Payment Scheduled ---
--   ActivityName: 'Payment Scheduled' (Formula/Static)
--   EventTime: AP Payment.When Created
--   UserName: AP Payment.Created By

--   --- Activity: Payment Executed ---
--   ActivityName: 'Payment Executed' (Formula/Static)
--   EventTime: AP Payment.Payment Date
--   UserName: AP Payment.Created By

--   --- Activity: Early Payment Taken ---
--   ActivityName: 'Early Payment Taken' (Formula/Static, row generated only IF AP Payment.Payment Date <= AP Bill.Discount Date)
--   EventTime: AP Payment.Payment Date
--   UserName: AP Payment.Created By

--   --- Activity: Payment Cleared ---
--   ActivityName: 'Payment Cleared' (Formula/Static)
--   EventTime: Bank Transaction.Reconciliation Date
--   UserName: Bank Transaction.Reconciled By [Or similar field]

步骤

准备工作：确保已安装Python 3.6或更高版本，以及requests、pandas和lxml库。获取Sage Intacct Web Services凭据（Sender ID、Sender Password、Company ID、User ID和User Password），并确保对应用户拥有APBILL、APPYMT和VENDOR对象的读取权限。
设置环境：新建项目目录。使用pip安装所需的Python库：pip install requests pandas lxml。
配置脚本：将提供的Python脚本保存到文件（例如extract_intacct_ap.py）。打开文件，将SAGE_INTACCT_CREDS字典中的占位值替换为您的实际凭据和端点URL。
设置提取参数：在脚本主程序中，调整start_date和end_date变量，指定数据提取时间范围。建议首次分析使用3至6个月的数据。
运行脚本：打开终端或命令提示符，进入项目目录并运行命令：python extract_intacct_ap.py。脚本随后会向Sage Intacct API发送请求。
监控运行情况：脚本会在控制台输出进度信息，显示当前提取的对象及已获取的记录数。具体耗时取决于日期范围和数据量，可能需要几分钟。
处理API分页：脚本会自动处理API分页，分批（按页）提取指定日期范围内的所有记录。
转换数据：获取原始数据后，脚本会处理每条APBILL和APPYMT记录，并为定义的14项业务活动分别生成数据行，为每个步骤计算相应的ActivityName和EventTime。
丰富数据：脚本根据账单中的VENDORID获取供应商数据，并将VendorName合并到事件日志中，补充数据集信息。
生成输出文件：成功运行后，脚本会在同一目录下创建sage_intacct_ap_event_log.csv文件，其中包含结构化的事件日志。
检查输出：使用电子表格程序打开生成的CSV文件并检查内容。确认包含全部14项活动，且各列均已按预期填充。
上传至ProcessMind：生成的CSV文件现已准备就绪，可直接上传至ProcessMind平台进行分析。

配置

API凭据：脚本需要以下凭据组成的字典：sender_id、sender_password、company_id、user_id和user_password。为保障安全，强烈建议使用专用的Web Services用户，并仅授予读取权限。
API端点：endpoint_url必须设置为您的Sage Intacct实例对应的URL，通常为https://api.intacct.com/ia/xml/xmlgw.phtml。
日期范围：start_date和end_date变量用于设置提取时间范围。脚本根据WHENCREATED字段筛选记录。首次分析建议选择3至6个月的数据，以兼顾数据量和分析价值。
查询筛选条件：脚本中的XML查询会按创建日期筛选APBILL记录。如有需要，可在XML载荷的块中添加筛选条件（例如特定的STATE或DEPARTMENTID）。
分页大小：readByQuery函数中的pagesize参数设为1000，即允许的最大值，以提高数据提取效率。脚本会自动遍历后续页面。
对象字段：脚本指定了从各对象（APBILL、APPYMT、VENDOR）提取的具体字段。如果流程使用自定义字段，必须将其API名称添加到脚本中相应对象的列表。

查询示例 python

import requests
import pandas as pd
from lxml import etree
import datetime
import time

class=class="hl-string">"hl-comment"># --- Configuration ---
class=class="hl-string">"hl-comment"># Replace with your Sage Intacct Web Services Credentials
SAGE_INTACCT_CREDS = {
    class="hl-string">"sender_id": class="hl-string">"[Your Sender ID]",
    class="hl-string">"sender_password": class="hl-string">"[Your Sender Password]",
    class="hl-string">"company_id": class="hl-string">"[Your Company ID]",
    class="hl-string">"user_id": class="hl-string">"[Your Web Services User ID]",
    class="hl-string">"user_password": class="hl-string">"[Your Web Services User Password]",
    class="hl-string">"endpoint_url": class="hl-string">"https://api.intacct.com/ia/xml/xmlgw.phtml"
}

class=class="hl-string">"hl-comment"># --- API Communication ---
def execute_sage_intacct_request(payload):
    class="hl-string">"""Sends an XML request to the Sage Intacct API and returns the response XML tree."""
    headers = {class="hl-string">"Content-Type": class="hl-string">"application/x-www-form-urlencoded"}
    try:
        response = requests.post(SAGE_INTACCT_CREDS[class="hl-string">"endpoint_url"], data=payload, headers=headers, timeout=300)
        response.raise_for_status() class=class="hl-string">"hl-comment"># Raise an exception for bad status codes
        return etree.fromstring(response.content)
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"API Request Failed: {e}")
        print(fclass="hl-string">"Response content: {response.text if 'response' in locals() else 'No response'}")
        return None

def get_session_id():
    class="hl-string">"""Gets a session ID from Sage Intacct."""
    payload = fclass="hl-string">"""<?xml version="1.0" encoding="UTF-8"?>
    <request>
      <control>
        <senderid>{SAGE_INTACCT_CREDS['sender_id']}</senderid>
        <password>{SAGE_INTACCT_CREDS['sender_password']}</password>
        <controlid>req1</controlid>
        <uniqueid>false</uniqueid>
        <dtdversion>3.0</dtdversion>
        <includewhitespace>false</includewhitespace>
      </control>
      <operation>
        <authentication>
          <login>
            <userid>{SAGE_INTACCT_CREDS['user_id']}</userid>
            <companyid>{SAGE_INTACCT_CREDS['company_id']}</companyid>
            <password>{SAGE_INTACCT_CREDS['user_password']}</password>
          </login>
        </authentication>
        <content>
          <function controlid="func1">
            <getAPISession />
          </function>
        </content>
      </operation>
    </request>"""
    root = execute_sage_intacct_request(payload)
    if root is not None:
        session_id_element = root.find(class="hl-string">'.//sessionid')
        if session_id_element is not None:
            print(class="hl-string">"Successfully obtained session ID.")
            return session_id_element.text
    print(class="hl-string">"Failed to obtain session ID.")
    return None

def fetch_all_records(session_id, object_name, query, fields):
    class="hl-string">"""Fetches all records for a given object using readByQuery and handles pagination."""
    all_records = []
    page_size = 1000
    
    payload_template = fclass="hl-string">"""<?xml version="1.0" encoding="UTF-8"?>
    <request>
      <control>
        <senderid>{SAGE_INTACCT_CREDS['sender_id']}</senderid>
        <password>{SAGE_INTACCT_CREDS['sender_password']}</password>
        <controlid>req1</controlid>
        <uniqueid>false</uniqueid>
        <dtdversion>3.0</dtdversion>
        <includewhitespace>false</includewhitespace>
      </control>
      <operation>
        <authentication><sessionid>{session_id}</sessionid></authentication>
        <content>
          <function controlid="func1">
            <readByQuery>
              <object>{object_name}</object>
              <query>{query}</query>
              <fields>{','.join(fields)}</fields>
              <pagesize>{page_size}</pagesize>
              {{result_id_block}}
            </readByQuery>
          </function>
        </content>
      </operation>
    </request>"""
    
    result_id = None
    while True:
        result_id_block = fclass="hl-string">"<resultId>{result_id}</resultId>" if result_id else class="hl-string">""
        payload = payload_template.format(result_id_block=result_id_block)
        root = execute_sage_intacct_request(payload)

        if root is None or root.find(class="hl-string">'.//status').text != class="hl-string">'success':
            error_desc = root.find(class="hl-string">'.//description2').text if root is not None else class="hl-string">"Unknown error"
            print(fclass="hl-string">"Error fetching {object_name}: {error_desc}")
            break
        
        data = root.find(class="hl-string">'.//data')
        records = data.findall(fclass="hl-string">'./{object_name}')
        if not records:
            break
            
        for record in records:
            record_dict = {field.tag: field.text for field in record}
            all_records.append(record_dict)
        
        num_remaining = int(data.get(class="hl-string">'numremaining'))
        result_id = data.get(class="hl-string">'resultId')
        print(fclass="hl-string">"Fetched {len(records)} {object_name} records. {num_remaining} remaining.")
        
        if num_remaining == 0:
            break

        time.sleep(1) class=class="hl-string">"hl-comment"># Be respectful to the API
        
    return all_records

class=class="hl-string">"hl-comment"># --- Data Transformation ---
def transform_to_event_log(bills, payments, vendors_map):
    class="hl-string">"""Transforms raw API data into a structured event log."""
    event_log = []
    last_data_update = datetime.datetime.now().isoformat()

    for bill in bills:
        case_id = bill.get(class="hl-string">'BILLNO')
        if not case_id:
            continue

        vendor_name = vendors_map.get(bill.get(class="hl-string">'VENDORID'), class="hl-string">'')
        common_attrs = {
            class="hl-string">'InvoiceNumber': case_id,
            class="hl-string">'SourceSystem': class="hl-string">'Sage Intacct',
            class="hl-string">'LastDataUpdate': last_data_update,
            class="hl-string">'VendorName': vendor_name,
            class="hl-string">'InvoiceAmount': bill.get(class="hl-string">'TOTALAMOUNT'),
            class="hl-string">'DueDate': bill.get(class="hl-string">'DUEDATE'),
            class="hl-string">'PostingDate': bill.get(class="hl-string">'POSTINGDATE'),
            class="hl-string">'PurchaseOrderNumber': bill.get(class="hl-string">'REFERENCENO'),
            class="hl-string">'CostCenter': bill.get(class="hl-string">'DEPARTMENTID'), class=class="hl-string">"hl-comment"># Header-level department
            class="hl-string">'InvoiceStatus': bill.get(class="hl-string">'STATE'),
            class="hl-string">'PaymentStatus': None class=class="hl-string">"hl-comment"># Will be populated later
        }

        class=class="hl-string">"hl-comment"># Event: Invoice Received
        if bill.get(class="hl-string">'WHENCREATED'):
            event_log.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Received',
                class="hl-string">'EventTime': bill.get(class="hl-string">'WHENCREATED'),
                class="hl-string">'UserName': bill.get(class="hl-string">'CREATEDBY')
            })

        class=class="hl-string">"hl-comment"># Event: Invoice Data Validated (inferred from creation)
        if bill.get(class="hl-string">'WHENCREATED'):
            event_log.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Data Validated',
                class="hl-string">'EventTime': bill.get(class="hl-string">'WHENCREATED'),
                class="hl-string">'UserName': bill.get(class="hl-string">'CREATEDBY')
            })

        class=class="hl-string">"hl-comment"># Event: Purchase Order Matched (inferred)
        if bill.get(class="hl-string">'REFERENCENO') and bill.get(class="hl-string">'WHENMODIFIED'):
             event_log.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Purchase Order Matched',
                class="hl-string">'EventTime': bill.get(class="hl-string">'WHENMODIFIED'),
                class="hl-string">'UserName': bill.get(class="hl-string">'MODIFIEDBY')
            })

        class=class="hl-string">"hl-comment"># Events from Status: Discrepancy, Routed, Rejected, Approved, Posted, Cancelled
        class=class="hl-string">"hl-comment"># Note: This simplified model uses final state fields. A full audit trail query is needed for intermediate states.
        if bill.get(class="hl-string">'STATE') == class="hl-string">'On Hold' and bill.get(class="hl-string">'WHENMODIFIED'):
             event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Discrepancy Found', class="hl-string">'EventTime': bill.get(class="hl-string">'WHENMODIFIED'), class="hl-string">'UserName': bill.get(class="hl-string">'MODIFIEDBY')})
        if bill.get(class="hl-string">'STATE') == class="hl-string">'Submitted' and bill.get(class="hl-string">'WHENMODIFIED'):
             event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Routed For Approval', class="hl-string">'EventTime': bill.get(class="hl-string">'WHENMODIFIED'), class="hl-string">'UserName': bill.get(class="hl-string">'MODIFIEDBY')})
        if bill.get(class="hl-string">'STATE') == class="hl-string">'Declined' and bill.get(class="hl-string">'WHENMODIFIED'):
             event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Rejected', class="hl-string">'EventTime': bill.get(class="hl-string">'WHENMODIFIED'), class="hl-string">'UserName': bill.get(class="hl-string">'MODIFIEDBY')})
        if bill.get(class="hl-string">'WHENAPPROVED'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Approved', class="hl-string">'EventTime': bill.get(class="hl-string">'WHENAPPROVED'), class="hl-string">'UserName': bill.get(class="hl-string">'APPROVEDBY')})
        if bill.get(class="hl-string">'STATE') == class="hl-string">'Posted' and bill.get(class="hl-string">'WHENPOSTED'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Posted To GL', class="hl-string">'EventTime': bill.get(class="hl-string">'WHENPOSTED'), class="hl-string">'UserName': bill.get(class="hl-string">'MODIFIEDBY')})
        if bill.get(class="hl-string">'STATE') == class="hl-string">'Voided' and bill.get(class="hl-string">'WHENVOIDED'):
            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Invoice Cancelled', class="hl-string">'EventTime': bill.get(class="hl-string">'WHENVOIDED'), class="hl-string">'UserName': bill.get(class="hl-string">'MODIFIEDBY')})

    class=class="hl-string">"hl-comment"># Process Payments for related events
    bill_map = {b[class="hl-string">'RECORDNO']: b for b in bills if class="hl-string">'RECORDNO' in b}
    for payment in payments:
        for item in payment.get(class="hl-string">'PAYMENTITEMS', {}).get(class="hl-string">'paymentitem', []):
            bill_key = item.get(class="hl-string">'key')
            if bill_key and bill_key in bill_map:
                bill = bill_map[bill_key]
                case_id = bill.get(class="hl-string">'BILLNO')
                vendor_name = vendors_map.get(bill.get(class="hl-string">'VENDORID'), class="hl-string">'')
                common_attrs = {
                    class="hl-string">'InvoiceNumber': case_id,
                    class="hl-string">'SourceSystem': class="hl-string">'Sage Intacct',
                    class="hl-string">'LastDataUpdate': last_data_update,
                    class="hl-string">'VendorName': vendor_name,
                    class="hl-string">'InvoiceAmount': bill.get(class="hl-string">'TOTALAMOUNT'),
                    class="hl-string">'DueDate': bill.get(class="hl-string">'DUEDATE'),
                    class="hl-string">'PostingDate': bill.get(class="hl-string">'POSTINGDATE'),
                    class="hl-string">'PurchaseOrderNumber': bill.get(class="hl-string">'REFERENCENO'),
                    class="hl-string">'CostCenter': bill.get(class="hl-string">'DEPARTMENTID'),
                    class="hl-string">'InvoiceStatus': bill.get(class="hl-string">'STATE'),
                    class="hl-string">'PaymentStatus': payment.get(class="hl-string">'STATE')
                }

                class=class="hl-string">"hl-comment"># Event: Payment Scheduled (inferred from payment creation)
                if payment.get(class="hl-string">'WHENCREATED'):
                    event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Scheduled', class="hl-string">'EventTime': payment.get(class="hl-string">'WHENCREATED'), class="hl-string">'UserName': payment.get(class="hl-string">'CREATEDBY')})

                class=class="hl-string">"hl-comment"># Event: Payment Executed
                if payment.get(class="hl-string">'PAYMENTDATE'):
                    event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Executed', class="hl-string">'EventTime': payment.get(class="hl-string">'PAYMENTDATE'), class="hl-string">'UserName': payment.get(class="hl-string">'CREATEDBY')})

                class=class="hl-string">"hl-comment"># Event: Early Payment Taken (calculated)
                discount_date_str = bill.get(class="hl-string">'DISCOUNTDATE')
                payment_date_str = payment.get(class="hl-string">'PAYMENTDATE')
                if discount_date_str and payment_date_str:
                    try:
                        discount_date = datetime.datetime.strptime(discount_date_str, class="hl-string">'%m/%d/%Y').date()
                        payment_date = datetime.datetime.strptime(payment_date_str, class="hl-string">'%m/%d/%Y').date()
                        if payment_date <= discount_date:
                            event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Early Payment Taken', class="hl-string">'EventTime': payment.get(class="hl-string">'PAYMENTDATE'), class="hl-string">'UserName': payment.get(class="hl-string">'CREATEDBY')})
                    except ValueError:
                        pass class=class="hl-string">"hl-comment"># Ignore parsing errors
                
                class=class="hl-string">"hl-comment"># Event: Payment Cleared
                if payment.get(class="hl-string">'WHENCLEARED'):
                     event_log.append({**common_attrs, class="hl-string">'ActivityName': class="hl-string">'Payment Cleared', class="hl-string">'EventTime': payment.get(class="hl-string">'WHENCLEARED'), class="hl-string">'UserName': payment.get(class="hl-string">'CREATEDBY')})

    class=class="hl-string">"hl-comment"># Add Discrepancy Resolved (placeholder logic)
    class=class="hl-string">"hl-comment"># A robust implementation requires analyzing audit trail for state changes from class="hl-string">'On Hold'.
    class=class="hl-string">"hl-comment"># This simplified version does not generate this event.

    return pd.DataFrame(event_log)


class=class="hl-string">"hl-comment"># --- Main Execution ---
if __name__ == class="hl-string">"__main__":
    start_date = class="hl-string">"01/01/2023"
    end_date = class="hl-string">"12/31/2023"
    
    print(class="hl-string">"Starting Sage Intacct AP Data Extraction...")
    session_id = get_session_id()
    
    if session_id:
        class=class="hl-string">"hl-comment"># 1. Fetch AP Bills
        print(class="hl-string">"\n--- Fetching AP Bills ---")
        bill_query = fclass="hl-string">"WHENCREATED &gt;= '{start_date}' AND WHENCREATED &lt;= '{end_date}'"
        bill_fields = [class="hl-string">'RECORDNO', class="hl-string">'BILLNO', class="hl-string">'STATE', class="hl-string">'VENDORID', class="hl-string">'WHENCREATED', class="hl-string">'WHENMODIFIED', class="hl-string">'WHENPOSTED', class="hl-string">'WHENAPPROVED', class="hl-string">'WHENVOIDED', class="hl-string">'APPROVEDBY', class="hl-string">'CREATEDBY', class="hl-string">'MODIFIEDBY', class="hl-string">'DUEDATE', class="hl-string">'POSTINGDATE', class="hl-string">'TOTALAMOUNT', class="hl-string">'REFERENCENO', class="hl-string">'DEPARTMENTID', class="hl-string">'PAYMENTTERMS', class="hl-string">'DISCOUNTDATE']
        bills = fetch_all_records(session_id, class="hl-string">'APBILL', bill_query, bill_fields)

        if bills:
            class=class="hl-string">"hl-comment"># 2. Fetch related AP Payments
            print(class="hl-string">"\n--- Fetching AP Payments ---")
            bill_keys = class="hl-string">"','".join([b[class="hl-string">'RECORDNO'] for b in bills if class="hl-string">'RECORDNO' in b])
            payment_query = fclass="hl-string">"PAYMENTITEMS.paymentitem.key IN ('{bill_keys}')"
            class=class="hl-string">"hl-comment"># Note: The class="hl-string">'PAYMENTITEMS' field is complex and must be explicitly requested.
            payment_fields = [class="hl-string">'RECORDNO', class="hl-string">'STATE', class="hl-string">'PAYMENTDATE', class="hl-string">'WHENCLEARED', class="hl-string">'WHENCREATED', class="hl-string">'CREATEDBY', class="hl-string">'PAYMENTITEMS']
            payments = fetch_all_records(session_id, class="hl-string">'APPYMT', payment_query, payment_fields)

            class=class="hl-string">"hl-comment"># 3. Fetch Vendors for enrichment
            print(class="hl-string">"\n--- Fetching Vendors ---")
            vendor_ids = class="hl-string">"','".join(list(set([b[class="hl-string">'VENDORID'] for b in bills if class="hl-string">'VENDORID' in b])))
            vendor_query = fclass="hl-string">"VENDORID IN ('{vendor_ids}')"
            vendor_fields = [class="hl-string">'VENDORID', class="hl-string">'NAME']
            vendors = fetch_all_records(session_id, class="hl-string">'VENDOR', vendor_query, vendor_fields)
            vendors_map = {v[class="hl-string">'VENDORID']: v[class="hl-string">'NAME'] for v in vendors}

            class=class="hl-string">"hl-comment"># 4. Transform data into event log
            print(class="hl-string">"\n--- Transforming data into event log ---")
            event_log_df = transform_to_event_log(bills, payments, vendors_map)
            
            class=class="hl-string">"hl-comment"># 5. Sort and save to CSV
            if not event_log_df.empty:
                event_log_df = event_log_df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'])
                output_filename = class="hl-string">'sage_intacct_ap_event_log.csv'
                event_log_df.to_csv(output_filename, index=False)
                print(fclass="hl-string">"\nExtraction complete. Event log saved to {output_filename}")
                print(fclass="hl-string">"Total events extracted: {len(event_log_df)}")
            else:
                print(class="hl-string">"\nNo events were generated from the fetched data.")

        else:
            print(class="hl-string">"\nNo AP Bills found in the specified date range.")

步骤

订阅并配置数据交付服务（DDS）：使用管理员权限登录Sage Intacct环境。依次进入Company > Admin > Subscriptions，确认账户已启用Data Delivery Service。如未启用，请联系Sage Intacct代表。
定义复制作业：在Sage Intacct中打开Data Delivery Service配置区域，创建新的数据复制作业，并选择要纳入复制的数据对象（表）。请确保包含应付账款相关对象，例如APBILL、APBILLITEM、APPAYMENT、APPAYMENTDETAIL、VENDOR、POINVOICE、HISTORY_APBILL、USERS、GLDETAIL和BANKTXNS。
配置云存储目标：设置DDS作业，将复制的数据发送到您的云数据仓库（例如Amazon S3、Azure Blob Storage、Snowflake或Google BigQuery）。填写所需的连接字符串、凭据和目标信息。Sage Intacct将据此推送数据文件。
设置复制计划：设定数据复制频率。通常每天运行一次，并安排在夜间，以尽量减少对生产系统的影响。这样可以定期刷新数据仓库中的数据。
将数据加载到数据仓库：数据文件送达云存储后，设置数据摄取流程，将文件（通常为CSV或Parquet格式）加载到数据仓库的结构化表中。大多数云数据仓库都提供相应工具（例如Snowflake的Snowpipe、BigQuery的Load Jobs）来自动完成此步骤。
连接数据仓库：使用可连接云数据仓库的SQL客户端或商业智能工具，并通过相应凭据和连接信息配置连接。
运行事件日志查询：打开新的查询编辑器，粘贴提供的SQL脚本。您需要修改占位值，例如WHERE子句中的日期范围（“YYYY-MM-DD”），以匹配具体分析时段。
运行查询并检查结果：执行完整的SQL查询。输出将是一个事件日志表，其中包含应付账款发票流程的所有指定活动和属性。
导出至ProcessMind：在SQL客户端中将最终结果集导出为CSV文件。确保文件采用UTF-8编码，且日期和时间格式一致。随后即可将文件上传至ProcessMind进行分析。

配置

准备工作：您需要订阅Sage Intacct数据交付服务（DDS），并在受支持的云数据仓库（例如Snowflake、Google BigQuery或Amazon Redshift）中拥有有效账户和存储空间。配置时需要具备Sage Intacct和数据仓库的管理员访问权限。
复制所需的关键表：要构建完整的应付账款事件日志，请确保DDS作业包含以下Sage Intacct对象：APBILL、APBILLITEM、APPAYMENT、APPAYMENTDETAIL、GLDETAIL、VENDOR、POINVOICE、HISTORY_APBILL、USERS和BANKTXNS。
按日期范围筛选：强烈建议在SQL查询中按指定日期范围筛选数据，以控制查询负载。可先选择较近的时段，例如最近3至6个月。提供的查询使用ab.WHENCREATED作为主要筛选日期。
数据粒度：DDS会复制整张表。提供的SQL查询用于将原始关系型数据转换为ProcessMind所需的事件日志格式，每一行代表一项业务活动。
复制频率：设置DDS作业的运行计划，在数据时效性与系统性能之间取得平衡。流程挖掘通常采用每日复制。请注意，Sage Intacct中事件发生后，数据不会立即出现在数据仓库中。

查询示例 sql

WITH BaseInvoices AS (
    SELECT
        ab.RECORDNO AS BillRecordNo,
        ab.BILLNO AS InvoiceNumber,
        ab.STATE AS InvoiceStatus,
        ab.TOTALENTERED AS InvoiceAmount,
        ab.WHENCREATED AS CreationTime,
        ab.WHENPOSTED AS PostingDate,
        ab.DUEDATE AS DueDate,
        ab.DISCOUNTDATE AS DiscountDate,
        v.NAME AS VendorName,
        u.LOGINID AS UserName, -- User associated with creation/last modification
        po.PONUMBER AS PurchaseOrderNumber,
        STRING_AGG(DISTINCT abi.DEPARTMENTID, ', ') AS CostCenter, -- Aggregates cost centers from line items
        p.STATE AS PaymentStatus,
        p.PAYMENTDATE AS PaymentDate,
        bt.CLEARDATE AS PaymentClearedDate
    FROM
        APBILL AS ab
    LEFT JOIN VENDOR AS v ON ab.VENDORID = v.RECORDNO
    LEFT JOIN USERS AS u ON ab.MODIFIEDBY = u.USERID
    LEFT JOIN APBILLITEM AS abi ON ab.RECORDNO = abi.APBILLKEY
    LEFT JOIN POINVOICE AS pi ON ab.RECORDNO = pi.BILLKEY
    LEFT JOIN PODOCUMENT AS po ON pi.POKEY = po.RECORDNO
    LEFT JOIN APPAYMENTDETAIL AS pd ON ab.RECORDNO = pd.BILLKEY
    LEFT JOIN APPAYMENT AS p ON pd.PAYMENTKEY = p.RECORDNO
    LEFT JOIN BANKTXNS AS bt ON p.RECORDNO = bt.DOC_RECORDKEY AND bt.DOCTYPE = 'APPAYMENT'
    WHERE
        ab.WHENCREATED BETWEEN '[YYYY-MM-DD]' AND '[YYYY-MM-DD]'
    GROUP BY
        ab.RECORDNO,
        ab.BILLNO,
        ab.STATE,
        ab.TOTALENTERED,
        ab.WHENCREATED,
        ab.WHENPOSTED,
        ab.DUEDATE,
        ab.DISCOUNTDATE,
        v.NAME,
        u.LOGINID,
        po.PONUMBER,
        p.STATE,
        p.PAYMENTDATE,
        bt.CLEARDATE
)
-- 1. Invoice Received
SELECT 
    bi.InvoiceNumber AS "InvoiceNumber",
    'Invoice Received' AS "ActivityName",
    bi.CreationTime AS "EventTime",
    'Sage Intacct DDS' AS "SourceSystem",
    CURRENT_TIMESTAMP AS "LastDataUpdate",
    bi.VendorName AS "VendorName",
    bi.InvoiceAmount AS "InvoiceAmount",
    bi.DueDate AS "DueDate",
    bi.PostingDate AS "PostingDate",
    bi.PurchaseOrderNumber AS "PurchaseOrderNumber",
    bi.CostCenter AS "CostCenter",
    bi.UserName AS "UserName",
    bi.InvoiceStatus AS "InvoiceStatus",
    bi.PaymentStatus AS "PaymentStatus"
FROM BaseInvoices bi

UNION ALL

-- 2. Invoice Data Validated (Inferred from initial creation if not in a DRAFT state)
SELECT 
    bi.InvoiceNumber,
    'Invoice Data Validated',
    bi.CreationTime, -- Assuming validation happens at time of creation/submission
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    bi.UserName,
    bi.InvoiceStatus,
    bi.PaymentStatus
FROM BaseInvoices bi
WHERE bi.InvoiceStatus != 'Draft'

UNION ALL

-- 3. Purchase Order Matched
SELECT
    bi.InvoiceNumber,
    'Purchase Order Matched',
    pi.WHENCREATED, -- Time the PO was linked to the invoice
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    (SELECT LOGINID FROM USERS WHERE USERID = pi.CREATEDBY) AS "UserName",
    bi.InvoiceStatus,
    bi.PaymentStatus
FROM BaseInvoices bi
JOIN POINVOICE pi ON bi.BillRecordNo = pi.BILLKEY
WHERE bi.PurchaseOrderNumber IS NOT NULL

UNION ALL

-- 4 & 5. Discrepancy Found & Resolved (from history table)
SELECT 
    bi.InvoiceNumber,
    CASE 
        WHEN h.NEW_VALUE = 'On Hold' THEN 'Discrepancy Found'
        WHEN h.OLD_VALUE = 'On Hold' AND h.NEW_VALUE != 'On Hold' THEN 'Discrepancy Resolved'
    END AS "ActivityName",
    h.WHEN_CHANGED AS "EventTime",
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    (SELECT LOGINID FROM USERS WHERE USERID = h.WHO_CHANGED_ID) AS "UserName",
    h.NEW_VALUE AS "InvoiceStatus",
    bi.PaymentStatus
FROM BaseInvoices bi
JOIN HISTORY_APBILL h ON bi.BillRecordNo = h.RECORDNO
WHERE h.FIELD_NAME = 'STATE' AND (h.NEW_VALUE = 'On Hold' OR h.OLD_VALUE = 'On Hold')

UNION ALL

-- 6, 7 & 8. Routed For Approval, Invoice Rejected, Invoice Approved (from history table)
SELECT 
    bi.InvoiceNumber,
    CASE 
        WHEN h.NEW_VALUE = 'Submitted' THEN 'Routed For Approval'
        WHEN h.NEW_VALUE = 'Declined' THEN 'Invoice Rejected'
        WHEN h.NEW_VALUE = 'Approved' THEN 'Invoice Approved'
    END AS "ActivityName",
    h.WHEN_CHANGED AS "EventTime",
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    (SELECT LOGINID FROM USERS WHERE USERID = h.WHO_CHANGED_ID) AS "UserName",
    h.NEW_VALUE AS "InvoiceStatus",
    bi.PaymentStatus
FROM BaseInvoices bi
JOIN HISTORY_APBILL h ON bi.BillRecordNo = h.RECORDNO
WHERE h.FIELD_NAME = 'STATE' AND h.NEW_VALUE IN ('Submitted', 'Declined', 'Approved')

UNION ALL

-- 9. Invoice Posted To GL
SELECT 
    bi.InvoiceNumber,
    'Invoice Posted To GL',
    bi.PostingDate,
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    bi.UserName,
    bi.InvoiceStatus,
    bi.PaymentStatus
FROM BaseInvoices bi
WHERE bi.PostingDate IS NOT NULL AND bi.InvoiceStatus = 'Posted'

UNION ALL

-- 10. Payment Scheduled
SELECT 
    bi.InvoiceNumber,
    'Payment Scheduled',
    p.WHENCREATED,
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    (SELECT LOGINID FROM USERS WHERE USERID = p.CREATEDBY) AS "UserName",
    bi.InvoiceStatus,
    p.STATE AS "PaymentStatus"
FROM BaseInvoices bi
JOIN APPAYMENTDETAIL pd ON bi.BillRecordNo = pd.BILLKEY
JOIN APPAYMENT p ON pd.PAYMENTKEY = p.RECORDNO

UNION ALL

-- 11. Payment Executed
SELECT 
    bi.InvoiceNumber,
    'Payment Executed',
    bi.PaymentDate,
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    bi.UserName,
    bi.InvoiceStatus,
    bi.PaymentStatus
FROM BaseInvoices bi
WHERE bi.PaymentDate IS NOT NULL

UNION ALL

-- 12. Early Payment Taken
SELECT 
    bi.InvoiceNumber,
    'Early Payment Taken',
    bi.PaymentDate,
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    bi.UserName,
    bi.InvoiceStatus,
    bi.PaymentStatus
FROM BaseInvoices bi
WHERE bi.PaymentDate IS NOT NULL AND bi.DiscountDate IS NOT NULL AND bi.PaymentDate <= bi.DiscountDate

UNION ALL

-- 13. Payment Cleared
SELECT 
    bi.InvoiceNumber,
    'Payment Cleared',
    bi.PaymentClearedDate,
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    bi.UserName,
    bi.InvoiceStatus,
    bi.PaymentStatus
FROM BaseInvoices bi
WHERE bi.PaymentClearedDate IS NOT NULL

UNION ALL

-- 14. Invoice Cancelled
SELECT 
    bi.InvoiceNumber,
    'Invoice Cancelled',
    h.WHEN_CHANGED,
    'Sage Intacct DDS',
    CURRENT_TIMESTAMP,
    bi.VendorName,
    bi.InvoiceAmount,
    bi.DueDate,
    bi.PostingDate,
    bi.PurchaseOrderNumber,
    bi.CostCenter,
    (SELECT LOGINID FROM USERS WHERE USERID = h.WHO_CHANGED_ID) AS "UserName",
    h.NEW_VALUE AS "InvoiceStatus",
    bi.PaymentStatus
FROM BaseInvoices bi
JOIN HISTORY_APBILL h ON bi.BillRecordNo = h.RECORDNO
WHERE h.FIELD_NAME = 'STATE' AND h.NEW_VALUE = 'Voided';

准备好开始了吗？

借助此模板，您可以着手优化应付账款发票处理流程。立即开始发现流程洞察、提升效率。

返回改进指南

下载模板

立即优化应付账款发票处理流程

将处理成本降低60%，消除延误和重复付款。

开始免费试用

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

应付账款发票处理数据模板

应付账款发票处理数据模板

应付账款发票处理属性

应付账款发票处理活动

数据提取指南

Sage Intacct自定义报表和列表视图导出

步骤

配置

查询示例 sql

使用Sage Intacct Web Services API的Python脚本

步骤

配置

查询示例 python

Sage Intacct数据交付服务（DDS）复制

步骤

配置

查询示例 sql

准备好开始了吗？

立即优化应付账款发票处理流程