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

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

Sage Intacct

← 返回改进指南

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

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

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

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

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

下载模板

应付账款发票处理属性

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

5 必需 9 建议 10 可选

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

必需建议可选

应付账款发票处理活动

以下是建议采集的关键流程步骤和里程碑，用于准确发现并分析您的发票工作流。

7 建议 7 可选

	活动	说明
	付款已结清	最后一步，确认付款已通过银行清算且交易已完成对账。通常在Sage Intacct现金管理模块的银行对账过程中记录。
为什么重要此事件标志着发票生命周期真正结束。端到端完整周期时间计算至此，为现金流出提供完整视图。获取位置根据现金管理模块中与AP Payment交易关联的“Clearing Date”或“Reconciliation Date”推断。采集使用与付款交易关联的银行对账记录中的清算日期。事件类型 inferred
	发票已批准	表示指定审批人已批准发票，发票可以过账付款。这是Sage Intacct审批历史或审计轨迹中明确记录的事件。
为什么重要这是结束审批周期的关键里程碑。此步骤前的延误表明存在审批瓶颈，而快速审批是获取提前付款折扣的关键。获取位置从与AP Bill对象关联的审批历史日志中明确获取。通常会记录时间戳和审批用户。采集使用发票审批历史中最终批准记录的时间戳。事件类型 explicit
	发票已过账至总账	标记已批准发票正式过账至总账的交易，并形成财务负债。这是Sage Intacct中的明确核心会计事件。
为什么重要这是重要的财务里程碑，表示发票已成为企业的正式负债，可以付款，并会影响财务报表。获取位置这是明确的交易。过账日期直接存储在AP Bill对象或关联的“GL Entry”记录中。采集使用AP Bill中的“Posting Date”，或相关GL交易的创建日期。事件类型 explicit
	已执行付款	标记付款交易已执行，资金已支付给供应商。这是带有明确交易日期的事件。
为什么重要这是衡量付款合规和提前付款折扣获取率的关键里程碑。从审批到此事件的时间反映付款处理效率。获取位置从与AP Bill关联的“AP Payment”对象中获取。该对象包含“Payment Date”或交易执行时间戳。采集使用关联AP Payment记录中的“Payment Date”字段。事件类型 explicit
	已提交审批	表示已验证并完成匹配的发票已提交至审批工作流。发票提交审批后，Sage Intacct会记录此操作并触发通知。
为什么重要标志着审批周期开始。跟踪此事件对于分析发票平均审批时间KPI和识别延误至关重要。获取位置当AP Bill状态变为“Submitted for Approval”时，从审计轨迹或交易日志中获取。此操作通常会作为明确事件记录。采集使用发票提交至审批引擎时审计日志中的时间戳。事件类型 explicit
	收到发票	表示流程开始，即发票通过人工或自动采集方案录入Sage Intacct。通常可根据AP Bill记录的创建时间戳推断此事件。
为什么重要这为所有周期时间计算建立起点，对于衡量整体流程效率和发票处理量至关重要。获取位置根据AP Bill（APBILL）对象中的“Created Date”时间戳推断。这是该流程最可靠的开始事件。采集使用AP Bill记录的创建时间戳。事件类型 inferred
	采购订单已匹配	确认发票详情，例如数量和价格，已与对应的采购订单成功匹配。通常可在用户将PO关联至AP Bill时明确记录。
为什么重要这是有采购订单支持的发票的关键步骤。匹配失败或耗时过长，通常表明存在潜在差异，也是常见的瓶颈来源。获取位置当用户执行“Match”操作，或将“Purchase Order”关联至“AP Bill”对象时，通过交易日志或审计轨迹记录。采集识别将Purchase Order关联至AP Bill的事件日志条目。事件类型 explicit
	发现差异	表示在验证或匹配过程中发现不一致，例如价格或数量差异。通常可在发票进入“Hold”或“Exception”状态时推断此事件。
为什么重要标记返工循环的起点。分析差异的频率和类型，是改善发票返工率KPI的关键。获取位置根据AP Bill对象状态变更为“On Hold”“Exception”或“Discrepancy”等状态推断。审计轨迹也可能记录匹配失败的尝试。采集记录AP Bill对象变更为异常相关状态的时间戳。事件类型 inferred
	发票已取消	表示AP Bill已取消或作废，流程提前终止。这是系统审计轨迹中记录的明确操作，会相应移除该负债。
为什么重要识别流程中的终止性异常。较高的取消率可能表明存在重复发票或初始数据录入错误。获取位置用户作废或取消“AP Bill”时明确记录。该操作及其时间戳会出现在审计轨迹中，或通过“Void”或“Cancelled”状态体现。采集使用AP Bill对象中“Void”交易或状态变为“Cancelled”的时间戳。事件类型 explicit
	发票已拒绝	表示审批人拒绝了发票，通常需要更正后重新提交。这是审批历史日志中明确记录的事件。
为什么重要突出显示审批流程中的返工循环。较高的拒绝率可能表明上游数据准确性或政策遵循存在问题。获取位置从与AP Bill对象关联的审批历史日志中明确获取，日志会记录“Decline”或“Reject”操作。采集使用发票审批历史中“Reject”或“Decline”记录的时间戳。事件类型 explicit
	发票数据已验证	表示发票数据已根据业务规则成功验证，例如供应商信息正确且必填字段完整。通常可在AP Bill记录保存或提交且未触发验证错误时推断此事件。
为什么重要记录初始数据质量检查。此处出现延误可能表明数据采集准确性或供应商合规存在问题，从而影响直通处理率。获取位置根据AP Bill记录从“Draft”变为“Submitted”状态时的时间戳推断。请检查AP Bill对象中的“State”或“Status”字段。采集记录AP Bill对象中状态从“Draft”变为“Submitted”的时间戳。事件类型 inferred
	差异已解决	标记此前发现的差异已解决，发票可以继续处理。通常可在发票状态从“On Hold”恢复为正常处理状态时推断。
为什么重要衡量从“Discrepancy Found”到“Discrepancy Resolved”的时间，对于差异解决周期时间KPI至关重要。获取位置根据AP Bill对象状态从异常状态（例如“On Hold”）变为活动状态（例如“Submitted”“Pending Approval”）推断。采集记录状态从异常状态恢复为处理状态的时间戳。事件类型 inferred
	已享受提前付款折扣	这是一个计算得出的事件，表示付款在供应商提前付款折扣期限内执行。该事件通过比较付款执行日期与发票日期及付款条款日期得出。
为什么重要通过明确标记成功获取的折扣，直接支持提前付款折扣获取率KPI，有助于分析并最大化成本节约。获取位置将“AP Payment”对象中的“Payment Date”与AP Bill对象中的“Invoice Date”和“Payment Terms”字段进行比较后计算。采集 IF“Payment Date”<=（“Invoice Date”+“Payment Terms”中的Discount Period），THEN事件发生。事件类型 calculated
	已安排付款	表示已批准并过账的发票被选中并纳入付款批次或付款运行。通常可在发票加入“AP Payment Request”或类似批次对象时推断。
为什么重要衔接审批与实际付款执行。分析此处耗时，有助于了解现金流管理和付款安排效率。获取位置根据包含AP Bill的“AP Payment”对象创建日期推断。账单状态也可能变为“Scheduled for Payment”。采集使用AP Bill关联至已安排但尚未执行的付款批次时的时间戳。事件类型 inferred

建议可选

提取指南

如何从Sage Intacct获取数据

步骤

前提条件：确保您拥有具备Custom Report Writer访问权限的Sage Intacct用户角色，并拥有Accounts Payable、Purchasing和Cash Management模块的读取权限。
进入报表中心：登录Sage Intacct，进入Reports > Custom reports。
创建报表1：核心发票事件：创建新的自定义报表。选择AP Bill作为主对象。此报表将记录AP Bill记录中直接提供的事件。
为报表1添加连接：在报表编写器的“Data”选项卡中，将AP Bill对象与Vendor对象连接，以获取供应商名称。
定义报表1的列：在“Columns”选项卡中，添加Bill No、Vendor Name、Total Amount、Due Date、PO Number、State以及关键日期字段：When Created（对应“Invoice Received”）、When Posted（对应“Invoice Posted to GL”）和When Modified。使用公式为这些特定事件创建ActivityName和EventTime列。
创建报表2：审批事件：创建第二个自定义报表。选择AP Bill Approval（或类似的审计/历史对象）作为主对象，并使用AP Bill Key将其连接回AP Bill和Vendor。
定义报表2的列：此报表将记录工作流事件。添加AP Bill No、Approver和审批操作日期列。使用公式，根据审批状态/操作字段将ActivityName设置为“Routed For Approval”“Invoice Approved”或“Invoice Rejected”。EventTime使用审批操作的时间戳。
创建报表3：付款事件：创建第三个自定义报表。选择AP Payment作为主对象，依次连接AP Payment Detail、AP Bill和Vendor。
定义报表3的列：此报表记录付款活动。添加AP Bill No、Payment Date（对应“Payment Executed”）和State列。要记录“Payment Scheduled”，请使用AP Payment记录的When Created时间戳。连接Cash Management中的Bank Transaction，并使用Reconciliation Date记录“Payment Cleared”活动。
运行并导出报表：为三份报表设置相同的日期范围筛选条件，例如按AP Bill创建日期筛选最近3至6个月。运行每份报表，并将结果导出为CSV文件。
合并并转换数据：使用Microsoft Excel（Power Query）、Python脚本或数据准备工具。加载三份CSV文件，确保每个文件的列名保持一致，例如InvoiceNumber、ActivityName、EventTime等。将三份文件的数据追加或合并到同一张表中。
完成事件日志：在转换工具中添加静态列SourceSystem（例如“Sage Intacct”）和LastDataUpdate（当前时间戳）。通过比较“Payment Executed”日期与发票到期日/折扣日期，计算派生事件“Early Payment Taken”。将最终合并表保存为单个CSV文件，即可作为事件日志上传。

配置

用户权限：需要拥有Custom Report Writer访问权限，并能读取以下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。连接错误会导致数据缺失或重复。
报表筛选条件：除日期范围外，如果您在多实体环境中运营，还可以按特定Entity/Company筛选。您也可以按Vendor Type或Bill State筛选，以缩小范围。
计算字段/公式：报表编写器的公式功能用于为报表中的每个事件创建静态ActivityName列。这是确保最终输出结构符合流程挖掘要求的关键步骤。

a 示例查询 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库。为拥有APBILL、APPYMT和VENDOR对象读取权限的用户获取Sage Intacct Web Services凭据（Sender ID、Sender Password、Company ID、User ID和User Password）。
设置环境：创建新的项目目录。使用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名称添加到脚本中对应对象的列表。

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

步骤

订阅并配置Data Delivery Service（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查询。输出将是一张包含AP发票流程所有指定活动和属性的事件日志表。
为ProcessMind导出：从SQL客户端将最终结果集导出为CSV文件。确保文件采用UTF-8编码，日期和时间格式保持一致。该文件现在可以上传到ProcessMind进行分析。

配置

前提条件：需要订阅Sage Intacct Data Delivery Service（DDS）。此外，您还需要在受支持的云数据仓库中拥有有效账户并完成存储配置，例如Snowflake、Google BigQuery或Amazon Redshift。设置过程中需要同时具备Sage Intacct和数据仓库的管理员权限。
复制所需的关键表：要构建完整的AP事件日志，请确保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中事件发生与其出现在数据仓库之间会存在延迟。

a 示例查询 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自定义报表和列表视图导出

步骤

配置

a 示例查询 sql

使用Sage Intacct Web Services API的Python脚本

步骤

配置

a 示例查询 python

Sage Intacct Data Delivery Service（DDS）复制

步骤

配置

a 示例查询 sql

准备好开始了吗？

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

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

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

应付账款发票处理属性

应付账款发票处理活动

提取指南

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

步骤

配置

a 示例查询 sql

使用Sage Intacct Web Services API的Python脚本

步骤

配置

a 示例查询 python

Sage Intacct Data Delivery Service（DDS）复制

步骤

配置

a 示例查询 sql

准备好开始了吗？

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

我们重视您的隐私