> 持续流程改进 > 采购到付款－发票处理 > SAP Ariba > 数据模板

您的采购到付款发票处理数据模板

SAP Ariba

← 返回改进指南

采购到付款－发票处理属性 (22) 采购到付款－发票处理活动 (13) 提取指南 (1)

您的采购到付款发票处理数据模板

该模板为收集优化SAP Ariba发票处理所需的关键数据提供结构化方法，列出需要采集的重要属性和跟踪的关键活动，并提供实用的数据提取指导。使用该资源，您可以快速建立事件日志，开展有价值的流程分析。

建议采集的属性
SAP Ariba中需要跟踪的关键活动
实用的数据提取指导

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

下载模板

采购到付款－发票处理属性

以下是建议纳入事件日志的数据字段，用于全面分析SAP Ariba中的发票处理。

3 必需 7 建议 12 可选

	名称	说明
	事件时间 EventTime	表示活动发生确切日期和时间的时间戳。
说明事件时间或时间戳记录具体活动发生的时间。这些数据是绩效分析的基础，可用于计算活动之间的时长以及整个案例的周期时间。流程挖掘工具利用这些时间戳按时间顺序排列事件，构建准确的流程路径表示。它对于衡量发票审批周期时间和付款冻结解决时间等KPI至关重要，也支持延迟和效率分析。为什么重要它支持计算周期时间和持续时长等所有基于时间的指标，而这些指标对于识别流程延迟至关重要。获取位置 SAP Ariba会为每次状态变化、用户操作或系统事件自动记录该时间，通常与活动名称一起存储在事件日志或历史表中。示例 2023-10-26T10:00:00Z2023-11-15T14:35:10Z2024-01-05T09:12:45Z
	发票编号 InvoiceNumber	每张供应商发票的唯一标识符，作为发票处理流程的主要案例ID。
说明发票编号是供应商为发票文档分配的唯一参考编号。在流程挖掘中，该属性至关重要，因为它充当案例ID，将从收到发票到最终付款的所有相关活动关联起来。通过跟踪这一标识符，分析人员可以重建每张发票完整的端到端生命周期，从而详细分析流程路径、识别瓶颈，并衡量单张发票的周期时间等关键绩效指标。为什么重要这是连接单张发票所有流程步骤的关键，使您能够分析端到端处理时间和路径。获取位置这是发票文档及SAP Ariba Invoicing解决方案中的主要字段，通常位于发票抬头表或交易数据中。示例 INV-2023-001239876543210SI-58840-A
	活动名称 ActivityName	发票处理生命周期中某一时点发生的具体事件或任务的名称。
说明活动名称描述发票处理工作流中的单个步骤，例如“Invoice Received”“Invoice Approved”或“Payment Executed”。每项活动都代表一个推动发票完成处理的业务事件。在流程挖掘中，这些活动的顺序构成流程图。分析活动有助于识别最常见的流程路径、偏离标准流程的情况、差异处理等返工循环，以及自动化机会。为什么重要该属性是可视化流程图、发现流程变体以及识别返工或瓶颈的基础。获取位置根据SAP Ariba中记录的系统事件日志、状态变化或用户操作生成，数据通常来自工作流或文档历史表。示例收到发票发票审批通过设置付款冻结付款已执行
	付款冻结原因 PaymentBlockReason	对发票设置付款冻结的具体原因。
说明当发票被冻结付款时，该属性会提供具体原因，例如“价格差异”“数量不匹配”或“缺少收货单”。这些原因通常以系统中的标准化代码或描述表示。分析不同冻结原因的发生频率，有助于定位付款延迟的根因。例如，大量“价格差异”冻结可能表明主数据准确性存在问题。该属性对于付款冻结解决时间仪表板至关重要，可帮助您优先处理最常见且耗时最长的问题。为什么重要它提供付款延迟的根因，支持有针对性地改进流程，预防价格或数量不匹配等常见问题。获取位置在SAP Ariba或连接的ERP系统中对发票设置付款冻结时录入该信息。示例价格差异数量不匹配等待收货确认
	付款到期日 PaymentDueDate	根据付款条款，为避免产生罚金而必须完成发票付款的日期。
说明付款到期日是合同约定的发票结算日期，通常根据发票文档日期和约定的付款条款（例如Net 30）计算。该属性是“按时付款率”KPI的基础。通过比较“Payment Executed”时间戳与付款到期日，分析可以识别逾期付款、衡量供应商付款表现，帮助企业避免滞纳金并维护良好的供应商关系。为什么重要它是计算按时付款率的基准，也是供应商关系管理和财务合规的重要KPI依据。获取位置该日期可能直接存在于发票文档中，也可能根据SAP Ariba中的“DocumentDate”和“PaymentTerms”字段计算得出。示例 2023-11-302024-01-152023-12-25
	供应商名称 VendorName	提交发票的供应商或供货商名称。
说明供应商名称用于标识申请付款的供应商，是按供应商细分发票处理绩效的主要分析维度。该属性可用于创建跟踪供应商付款表现的仪表板，识别差异率较高的供应商，或分析战略供应商的处理时间。了解特定供应商的问题，有助于改善供应商关系并简化协作。为什么重要它支持按供应商分析绩效，帮助识别经常出现发票问题或付款延迟的供应商。获取位置这是发票抬头数据中的标准字段，关联SAP Ariba或连接的ERP系统中的供应商主数据。示例 Global Office Supplies Inc.Tech Solutions LLCInnovate Logistics
	发票状态 InvoiceStatus	发票案例当前或最终状态，例如Paid、Rejected或In Process。
说明发票状态反映数据提取时发票处于生命周期的哪个阶段，或显示发票的最终结果。这是案例级属性，用于概括发票的整体状态。在流程挖掘中，该属性可用于筛选案例，仅分析已完成（Paid）或存在问题（Rejected）的发票。它有助于了解不同流程变体的最终结果，也可用于衡量最终成功完成处理的发票比例。为什么重要它提供发票流程的最终结果，支持重点分析已成功付款和被拒绝的发票。获取位置这是SAP Ariba发票抬头中的标准状态字段。示例已付款已拒绝处理中已批准
	发票金额 InvoiceAmount	发票的货币总金额。
说明发票金额表示供应商申请支付的总额，是分析发票处理工作量的基础财务属性。在流程挖掘中，该属性可用于筛选高价值发票，因为这类发票可能遵循不同的审批路径或受到更严格的控制。它还可用于优先改进财务影响最大的发票流程。仪表板通常利用该属性展示处于不同流程阶段的发票总金额。为什么重要它支持财务影响分析，例如筛选高价值发票，或了解流程瓶颈中占用的资金规模。获取位置 SAP Ariba发票抬头数据中的标准字段。示例 5250.75120000.00895.50
	审批人 Approver	负责审批发票付款的用户或角色。
说明审批人是负责审核和批准发票的个人或用户组。发票通常会根据金额或类型要求一级或多级审批。该属性有助于分析审批工作流的表现。按审批人或审批组细分“发票审批周期时间”，可以识别流程中审批周期最长的个人或团队。这些信息对于平衡工作量和提高审批效率至关重要。为什么重要它通过显示哪些用户或团队的审批周期最长，帮助识别审批流程中的瓶颈。获取位置从SAP Ariba中发票的工作流或审批历史日志获取，也可能记录为用户ID。示例 j.smithFinance_Approvers_Tier1m.jones
	采购订单编号 PurchaseOrderNumber	与发票关联的采购订单标识符，如适用。
说明采购订单（PO）编号将发票关联到相应的采购文件，该文件授权采购商品或服务。并非所有发票都有采购订单支持，但对于有采购订单的发票，这一关联至关重要。按采购订单编号分析发票，有助于了解三方匹配（采购订单、收货单、发票）的表现。它是识别差异的关键，也支持比较有采购订单和无采购订单的发票处理流程，因为两者通常遵循不同路径，效率水平也不同。为什么重要它将发票与采购流程关联起来，从而支持匹配差异分析，以及有采购订单与无采购订单发票流程的比较。获取位置 SAP Ariba中有采购订单支持的发票通常包含该标准字段，可在发票行项目或抬头数据中找到。示例 45000123454500054321PO-2023-789
	付款条款 PaymentTerms	约定的发票付款条件，通常包括提前付款折扣等信息。
说明付款条款规定向供应商付款的规则，例如“Net 30”（30天内到期付款）或“2% 10, Net 30”（10天内付款可享受2%折扣，否则30天内到期）。这些信息来自供应商主数据或采购订单。该属性是“提前付款折扣机会”仪表板及相关KPI的基础。分析会利用这些条款识别符合折扣条件的发票，并判断付款是否在折扣期限内执行，从而发现节省成本的机会。为什么重要它对于识别提前付款折扣机会至关重要，有助于显著降低成本。获取位置存储在供应商主数据中，并复制到SAP Ariba或ERP系统的发票详情中。示例净额30天2%10天内付款，净额30天净额60天
	公司代码 CompanyCode	组织内负责处理发票的特定法人实体或公司的标识符。
说明公司代码是SAP环境中的标准组织单位，代表一个独立的法律实体，并为其编制财务报表。发票始终记账到特定的公司代码。该属性可用于比较不同业务部门或法律实体的流程绩效，帮助识别哪些实体的效率更高，并支持跨全球组织实现流程标准化。为什么重要支持比较不同法律实体或业务部门的绩效，帮助识别区域或部门层面的低效问题。获取位置 SAP Ariba发票单据中的基础组织字段，可从采购订单继承，也可在创建非PO发票时录入。示例 1000US01DE01
	最近数据更新时间 LastDataUpdate	表示该事件数据最近一次刷新或提取时间的时间戳。
说明该属性提供从源系统最近一次提取数据的日期和时间，是数据治理以及了解分析数据新鲜度的重要元数据字段。分析人员可以利用该信息确认所使用的数据是否为最新，并了解源系统中事件发生与其出现在流程挖掘工具之间可能存在的延迟。它对于管理数据刷新周期和确保洞察可靠性至关重要。为什么重要它提供有关数据新鲜度的重要背景信息，确保分析基于当前且相关的数据。获取位置该时间戳通常在数据提取（ETL）过程中生成并附加到数据集中。示例 2024-03-15T02:00:00Z2024-03-16T02:00:00Z2024-03-17T02:00:00Z
	单据日期 DocumentDate	供应商在发票单据上打印的日期。
说明单据日期是供应商创建发票的日期，与发票进入处理系统时的“发票接收日期”不同。两者之间的时间差可能很大。该属性有助于分析供应商绩效并识别发票提交延迟。单据日期与接收日期之间的间隔过长，会压缩发票处理和获取早付折扣的有效时间。它通常也是计算付款到期日的起点。为什么重要帮助分析供应商开具发票与企业接收发票之间的延迟，该延迟可能影响按时付款。获取位置发票抬头数据中的标准字段，从纸质或电子发票单据中获取。示例 2023-10-202023-11-102024-01-02
	发票类型 InvoiceType	对发票进行分类，例如区分是否关联采购订单（PO）或不关联采购订单（非PO）。
说明发票类型将发票划分为不同类别，而不同类别通常对应不同流程。最常见的区分是PO发票和非PO发票。PO发票可与预先批准的订单进行匹配；非PO发票则需要更复杂的编码和审批。该属性对流程分析至关重要，因为PO和非PO发票的处理流程存在根本差异。将两者分开，可以更准确地评估各自流程，避免汇总指标产生误导，并帮助了解不同流程路径的效率和合规情况。为什么重要将发票划分到不同流程路径中，例如PO与非PO，这对于准确衡量和分析绩效至关重要。获取位置这通常是SAP Ariba发票单据中的标准字段，也可以根据是否存在“PurchaseOrderNumber”进行推导。示例采购订单发票非采购订单发票贷项通知单
	国家/地区 Country	与发票关联的国家/地区，通常根据公司代码或供应商所在地确定。
说明国家/地区属性为分析提供地理维度。它通常来源于发票记账所使用的公司代码，或供应商地址。按国家/地区分析流程，有助于发现绩效、合规和流程执行方面的区域差异。该分析可以显示某些国家/地区办公室是否面临独特挑战，或是否采用了可在全球推广的最佳实践。这对于全球共享服务环境中的流程标准化非常有价值。为什么重要支持按地理位置分析流程，比较不同国家/地区或区域的流程绩效和合规情况。获取位置来源于SAP Ariba或所连接ERP系统中的公司代码主数据或供应商主数据。示例 USA德国英国
	审批周期时间 ApprovalCycleTime	从发票提交审批到作出最终决定（批准或拒绝）所经过的时间。
说明该计算指标衡量审批子流程的持续时间，计算方式为“发票已提交审批”活动与对应的“发票已批准”或“发票已拒绝”活动之间的时间差。该属性直接衡量“发票审批周期时间”KPI，是相关仪表板的重要指标。它有助于单独识别并量化审批阶段的延迟，而审批阶段通常是整体处理时间过长的主要原因。您可以按审批人、部门或发票金额进行分析，以发现具体瓶颈。为什么重要单独评估审批工作流的绩效，便于识别由审批人或复杂审批链导致的瓶颈。获取位置在数据转换过程中计算，为每张发票找到相关审批的开始和结束事件，并计算两者之间的时间差。示例 2天5小时10天1小时8小时30分钟
	拒绝原因 RejectionReason	用于说明发票在审批过程中被拒绝原因的代码或文本。
说明审批人拒绝发票时，通常需要提供原因。该属性记录相关信息，可能包括“价格错误”“发票重复”或“违反政策”等值。这是“发票拒绝分析”仪表板的关键属性。通过分析最常见的拒绝原因，组织可以识别上游问题，例如供应商发票质量问题或内部数据不一致。相关洞察有助于减少返工，并提高发票处理的一次通过率。为什么重要说明返工发生的原因，直接揭示流程低效和发票质量问题的根本原因。获取位置当SAP Ariba中发生“发票已拒绝”活动时，从工作流日志或备注字段中获取。示例重复发票采购订单引用不正确金额超出已批准预算
	是否取得折扣 IsEarlyPaymentDiscountTaken	用于表示符合条件的发票是否成功取得早付折扣的布尔标记。
说明该属性通过计算得出：首先根据“PaymentTerms”判断发票是否符合早付折扣条件，然后检查“付款已执行”事件是否发生在规定的折扣期限内。该标记对于衡量“早付折扣取得率”KPI至关重要，可直接量化资金管理和应付账款职能在优化营运资金方面的成效。分析值为false的案例，有助于发现错失节省机会的原因，例如审批缓慢或其他流程瓶颈。为什么重要直接衡量成本节省的实现情况，并帮助识别错失折扣机会的原因。获取位置在数据转换过程中计算，解析“PaymentTerms”，并将“付款已执行”的时间戳与计算出的折扣截止时间进行比较。示例 truefalse
	是否按时付款 IsPaidOnTime	用于表示发票是否在到期日当天或之前完成付款的布尔标记。
说明该计算属性将“付款已执行”活动的时间戳与“PaymentDueDate”进行比较。如果付款日期早于或等于到期日，则值为true，否则为false。该标记简化了付款绩效分析，可用于筛选和汇总，从而计算“按时付款率”KPI。仪表板可以利用该属性，快速按供应商、国家/地区或公司代码展示绩效，帮助识别长期存在延迟付款问题的领域。为什么重要简化按时付款率KPI的计算，并支持快速筛选逾期发票，以便进行根因分析。获取位置在数据转换过程中计算，将付款活动的“EventTime”与“PaymentDueDate”属性进行比较。示例 truefalse
	源系统 SourceSystem	提取事件数据的记录系统。
说明该属性标识每个事件的来源系统，例如“SAP Ariba”“SAP S/4HANA”或第三方扫描解决方案。在现代企业中，发票处理可能跨越多个应用程序。了解源系统有助于诊断数据质量问题，并分析不同平台之间的流程交接。它可以明确发票扫描、发票审批等具体活动在哪个系统中完成。为什么重要它有助于区分发生在不同系统中的活动，对于了解集成节点和特定系统中的瓶颈至关重要。获取位置通常在数据提取、转换和加载（ETL）过程中添加，根据数据来源分配固定值。示例 SAP AribaSAP S4HANACoupa
	货币 Currency	发票金额使用的货币代码，例如USD或EUR。
说明该属性指定发票金额所使用的货币。对于全球性组织，发票通常涉及多种货币。货币信息对于财务分析至关重要，可确保金额得到正确比较。在流程挖掘仪表板中，该信息支持正确汇总财务数据，通常还需要将金额换算为统一的报告货币。它为“发票金额”属性提供必要的背景信息。为什么重要为“发票金额”属性提供必要背景，确保财务数据得到正确解读，尤其适用于跨国业务场景。获取位置发票抬头数据中的标准字段，通常位于SAP Ariba的发票金额字段旁。示例 USDEURGBP

必需建议可选

采购到付款－发票处理活动

以下是应纳入事件日志的关键流程步骤和里程碑，用于准确发现和分析您的发票处理工作流。

6 建议 7 可选

	活动	说明
	付款已执行	流程中的最后一项活动，确认款项已发送给供应商，发票生命周期至此完成。
为什么重要该活动是衡量整体发票周期时间的主要终点，也是计算按时付款率和提前付款折扣获取率的基础。获取位置该事件发生在ERP系统中。付款状态、付款日期和交易详情通常会发送回SAP Ariba，以更新发票文档。采集根据发票付款状态变为“Paid”并记录相关付款日期推断。事件类型 inferred
	发票完成对账	这是一个关键里程碑，表示发票已成功与采购订单和收货单匹配，且不存在未解决的差异，确认发票可以进入审批。
为什么重要完成此步骤意味着验证阶段结束，发票已准备好进入审批工作流。这是衡量直通处理率的重要检查点。获取位置通过Invoice Reconciliation（IR）文档状态变为“Reconciled”等状态记录。采集使用Invoice Reconciliation文档状态更新为“Reconciled”时的时间戳。事件类型 inferred
	发票审批通过	表示审批工作流成功完成，所有必要审批人均已授权支付发票。这是发票过账前的关键里程碑。
为什么重要该活动是衡量审批周期时间的终点，也是后续付款处理步骤的重要影响因素。此处的延迟会直接影响按时付款表现。获取位置通常可直接从Ariba发票审批历史日志中获取，也可以根据文档状态变为“Approved”推断。采集从审批流程历史记录中提取，或使用状态变为“Approved”时的时间戳。事件类型 explicit
	发票已过账	表示已审批发票成功发送至下游ERP系统，并被系统接收，用于财务记账和付款处理。这是一个关键集成里程碑。
为什么重要确认采购部门向财务部门的交接已完成。这是安排和执行付款前的关键里程碑。获取位置通常根据发票状态变为“Sent”或“Processing Payment”等最终状态推断，同时记录ERP系统返回的确认消息。采集识别发票状态更新为成功发送至ERP时的时间戳。事件类型 inferred
	发送发票进行审批	该活动标志着发票成功完成对账后，正式审批工作流的开始。系统会根据业务规则，将发票路由给一个或多个指定审批人。
为什么重要这是衡量发票审批周期时间KPI和分析审批流程本身效率的起点。获取位置通常根据发票文档状态变化推断，状态从“Reconciled”变为“Approving”或“Pending Approval”等状态。采集记录发票或IR文档状态变为“Approving”或类似状态时的时间戳。事件类型 inferred
	收到发票	标志着发票处理生命周期的开始，即发票首次录入SAP Ariba系统。发票可以通过Ariba Network、供应商门户或人工录入等多种渠道进入系统。
为什么重要该活动是衡量端到端发票周期时间和了解初始处理延迟的主要起点。获取位置通常根据SAP Ariba Buying and Invoicing中发票文档的创建时间戳推断。该时间戳表示发票记录首次在系统中生成的时间。采集使用主发票对象或文档的创建时间戳。事件类型 inferred
	发现匹配差异	当系统或用户发现发票、采购订单和收货信息之间不匹配时，就会发生这一异常活动。常见差异包括价格、数量或税额差异。
为什么重要该活动对于计算匹配差异率和识别常见错误来源至关重要，而这些错误通常是处理延迟的主要原因。获取位置通常通过Invoice Reconciliation（IR）文档中的特定状态记录，例如“Rejected”或“Disputed”，并附带原因代码。采集识别IR文档状态变为不匹配或异常状态时的时间戳。事件类型 inferred
	发票被拒绝	这是审批人在审批工作流中拒绝发票时发生的异常活动。通常需要更正并重新提交发票，从而形成返工循环。
为什么重要跟踪拒绝情况对于发票拒绝率KPI至关重要，也有助于分析审批失败的根因，例如违反政策或编码错误。获取位置该事件会记录在发票文档的审批历史中，也会反映为文档状态变为“Rejected”。采集从审批历史中的评论和时间戳，或状态变为“Rejected”中提取。事件类型 explicit
	已安排付款	表示财务团队在ERP系统中将发票纳入特定付款批次。付款已计划，但尚未执行。
为什么重要帮助您了解付款流程的最后阶段，预测现金流出，并分析过账到最终付款之间的延迟。获取位置这些信息通常存储在ERP系统中，也可能同步回SAP Ariba，并反映在发票付款状态信息中。采集根据ERP发送回Ariba发票文档的付款状态详情推断。事件类型 inferred
	提交发票进行对账	表示发票已录入并正式提交至对账流程，以便与采购订单或合同进行匹配。这是从数据录入到验证的关键交接点。
为什么重要该里程碑启动匹配和验证阶段。分析从收到发票到该活动之间的时间，有助于识别数据录入瓶颈。获取位置通常根据发票或Invoice Reconciliation（IR）文档的状态变化推断，状态可能变为“Submitted”或“Reconciling”。采集记录Invoice Reconciliation文档状态变为“Submitted”时的时间戳。事件类型 inferred
	解决差异	表示此前发现的不匹配问题已得到处理，发票可以继续进行对账和审批。处理过程可能包括人工调整或与供应商沟通。
为什么重要跟踪解决差异所用的时间，有助于量化返工影响，并发现提高首次匹配率的机会。获取位置通常根据Invoice Reconciliation（IR）文档的状态变化推断，状态从异常状态恢复为“Reconciling”或“Submitted”等处理状态。采集记录IR文档退出差异状态并重新进入处理工作流时的时间戳。事件类型 inferred
	解除付款冻结	表示此前设置的付款冻结已被移除，发票可以进入付款计划安排阶段，也意味着相关问题已经解决。
为什么重要该活动是衡量付款冻结解决时间的终点，结束冻结发票的异常处理循环。获取位置与设置冻结类似，该操作通常在ERP系统中完成，状态可能同步回Ariba。通常根据付款冻结标记被移除推断。采集需要识别付款冻结标记或状态被移除或停用时的时间戳。事件类型 inferred
	设置付款冻结	当用户或系统有意阻止已审批发票付款时，就会发生这一活动。常见原因包括供应商争议、质量问题或其他商业原因。
为什么重要该活动是衡量付款冻结解决时间的起点。分析冻结情况有助于识别并解决导致付款延迟的系统性问题。获取位置通常在发票过账后由集成的ERP系统（如SAP S/4HANA）管理，但冻结状态可能同步回Ariba。系统可能通过特定标记或状态表示该冻结。采集需要识别表示付款冻结已生效的标记或状态字段变化。事件类型 inferred

建议可选

提取指南

如何从SAP Ariba获取数据

步骤

前提条件和设置：确保系统已安装Python 3.6或更高版本。打开命令行终端，运行pip install pandas requests，安装所需的Python库pandas和requests。
SAP Ariba API访问权限：登录SAP Ariba Developer Portal。创建新应用并订阅相关API，通常是Transactional Data Export或其他可提供发票数据的报告API。完成后，您将获得用于身份验证的API Key和OAuth凭据（Client ID和Client Secret）。
配置身份验证：应用需要OAuth2令牌才能调用API。脚本包含一个函数，可使用Client ID和Secret从Ariba身份验证端点请求令牌。请妥善保存这些凭据；如果用于生产环境，请勿将其直接硬编码到最终脚本中。
开发Python脚本：使用提供的Python脚本作为模板。将脚本顶部的占位变量更新为您的Ariba realm名称、基础API URL和前一步获取的API Key。
定义提取参数：在脚本的main部分设置created_date_from和created_date_to变量，定义数据提取的时间范围。您还可以自定义filters字典，例如按公司代码或特定发票状态缩小查询范围。
执行脚本：在终端中运行命令python your_script_name.py。脚本将连接Ariba API，逐页获取发票数据，并在内存中进行处理。
转换数据：脚本遍历API返回的每份发票单据，展开JSON结构，并将各类时间戳字段，例如timeCreated、reconciledDate和approvedDate，转换为独立行，生成规范的事件日志格式。每行代表发票生命周期中的一项独立活动。
处理API分页：脚本支持处理分页API响应。它会使用每次响应提供的page_token依次调用API，请求下一组结果，直到获取指定期间内的全部数据。
生成事件日志文件：完成数据获取和转换后，脚本将结果组装为pandas DataFrame，并导出为ariba_invoice_event_log.csv文件，保存到脚本运行所在目录。
检查并上传：打开生成的CSV文件检查内容，确认包含所需列（InvoiceNumber、ActivityName、EventTime），且数据准确无误。该文件现已准备好上传到ProcessMind进行分析。

配置

API端点：脚本面向Transactional Data Export API中的invoiceReconciliationDocuments视图。必须根据您的Ariba环境所在数据中心配置基础URL和具体端点。
身份验证：脚本使用OAuth 2.0以及客户端ID、客户端密钥和API密钥进行安全访问。这些凭据必须妥善管理，并对应具有必要API权限的应用程序。
日期范围筛选器：最关键的参数是createdDateFrom和createdDateTo。建议按易于管理的批次提取数据，例如每次提取3至6个月，以避免API超时和性能问题。日期格式必须为YYYY-MM-DDTHH:MM:SSZ。
系统筛选器：API调用中的filters参数支持进一步细化查询。您可以按realm、companyCode.uniqueName或statusString等字段筛选，将提取范围限制在特定业务单元或发票类型内。
所需权限：与API凭据关联的用户账户或系统账户，必须在SAP Ariba中拥有访问和导出发票对账数据的足够权限。相关设置位于Ariba管理设置中的API应用程序配置内。

a 示例查询 python

import requests
import pandas as pd
import json
import os
from datetime import datetime

class=class="hl-string">"hl-comment"># --- Configuration Placeholders ---
class=class="hl-string">"hl-comment"># Replace with your actual SAP Ariba credentials and environment details
ARIBE_BASE_URL = class="hl-string">"https://[your-api-gateway-url.com]/api/transactional-data-export/v1/"
API_KEY = class="hl-string">"[Your_API_Key]"
OAUTH_URL = class="hl-string">"https://api.ariba.com/v2/oauth/token"
OAUTH_CLIENT_ID = class="hl-string">"[Your_OAuth_Client_ID]"
OAUTH_CLIENT_SECRET = class="hl-string">"[Your_OAuth_Client_Secret]"
REALM = class="hl-string">"[Your_Company_Realm]"

class=class="hl-string">"hl-comment"># --- Functions ---
def get_oauth_token(client_id, client_secret):
    class="hl-string">"""Fetches OAuth2 token from SAP Ariba."""
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': client_id,
        class="hl-string">'client_secret': client_secret
    }
    try:
        response = requests.post(OAUTH_URL, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error fetching OAuth token: {e}")
        return None

def fetch_ariba_data(access_token, created_date_from, created_date_to):
    class="hl-string">"""Fetches paginated invoice data from the Ariba API."""
    all_invoices = []
    page_token = None
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY,
        class="hl-string">'Accept': class="hl-string">'application/json'
    }
    
    while True:
        params = {
            class="hl-string">'realm': REALM,
            class="hl-string">'product': class="hl-string">'ariba.procurement',
            class="hl-string">'view': class="hl-string">'InvoiceReconciliationDocument',
            class="hl-string">'createdDateFrom': created_date_from,
            class="hl-string">'createdDateTo': created_date_to,
            class="hl-string">'pageSize': 100 class=class="hl-string">"hl-comment"># Adjust as needed
        }
        if page_token:
            params[class="hl-string">'pageToken'] = page_token

        print(fclass="hl-string">"Fetching data with page token: {page_token or 'Initial Page'}")
        try:
            response = requests.get(ARIBE_BASE_URL + class="hl-string">"views/InvoiceReconciliationDocument", headers=headers, params=params)
            response.raise_for_status()
            data = response.json()
            all_invoices.extend(data.get(class="hl-string">'records', []))
            page_token = data.get(class="hl-string">'pageToken')
            if not page_token:
                break
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from Ariba API: {e}")
            break

    return all_invoices

def transform_to_event_log(invoices):
    class="hl-string">"""Transforms raw invoice JSON data into a structured event log DataFrame."""
    event_log_records = []
    for inv in invoices:
        case_id = inv.get(class="hl-string">'uniqueName')
        if not case_id:
            continue

        class=class="hl-string">"hl-comment"># Common attributes
        common_attrs = {
            class="hl-string">'InvoiceNumber': case_id,
            class="hl-string">'PurchaseOrderNumber': inv.get(class="hl-string">'poNumber'),
            class="hl-string">'VendorName': inv.get(class="hl-string">'supplier', {}).get(class="hl-string">'name'),
            class="hl-string">'InvoiceAmount': inv.get(class="hl-string">'totalCost', {}).get(class="hl-string">'amount'),
            class="hl-string">'PaymentDueDate': inv.get(class="hl-string">'paymentTerms', {}).get(class="hl-string">'dueDate'),
            class="hl-string">'InvoiceStatus': inv.get(class="hl-string">'statusString')
        }

        class=class="hl-string">"hl-comment"># Activity: Invoice Received
        if inv.get(class="hl-string">'timeCreated'):
            event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Received',
                class="hl-string">'EventTime': inv[class="hl-string">'timeCreated'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })

        class=class="hl-string">"hl-comment"># Activity: Invoice Submitted for Reconciliation
        if inv.get(class="hl-string">'submittedDate'):
            event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Submitted for Reconciliation',
                class="hl-string">'EventTime': inv[class="hl-string">'submittedDate'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })
        
        class=class="hl-string">"hl-comment"># Activity: Matching Discrepancy Identified
        class=class="hl-string">"hl-comment"># This assumes an exception's creation time is available
        if inv.get(class="hl-string">'exceptionStatus') == class="hl-string">'Active' and inv.get(class="hl-string">'timeUpdated'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Matching Discrepancy Identified',
                class="hl-string">'EventTime': inv[class="hl-string">'timeUpdated'], class=class="hl-string">"hl-comment"># Use timeUpdated as a proxy for exception creation
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })

        class=class="hl-string">"hl-comment"># Activity: Discrepancy Resolved
        class=class="hl-string">"hl-comment"># Assumes a specific timestamp exists for this event
        if inv.get(class="hl-string">'exceptionClearedDate'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Discrepancy Resolved',
                class="hl-string">'EventTime': inv[class="hl-string">'exceptionClearedDate'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })

        class=class="hl-string">"hl-comment"># Activity: Invoice Reconciled
        if inv.get(class="hl-string">'reconciledDate'):
            event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Reconciled',
                class="hl-string">'EventTime': inv[class="hl-string">'reconciledDate'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })
            class=class="hl-string">"hl-comment"># Activity: Invoice Sent for Approval (often occurs immediately after reconciliation)
            event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Sent for Approval',
                class="hl-string">'EventTime': inv[class="hl-string">'reconciledDate'], class=class="hl-string">"hl-comment"># Using reconciledDate as the trigger time
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })

        class=class="hl-string">"hl-comment"># Activity: Invoice Approved
        if inv.get(class="hl-string">'approvedDate'):
            class=class="hl-string">"hl-comment"># Approver information may be nested differently depending on configuration
            approver_name = inv.get(class="hl-string">'lastApprover', {}).get(class="hl-string">'name', class="hl-string">'N/A') 
            event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Approved',
                class="hl-string">'EventTime': inv[class="hl-string">'approvedDate'],
                class="hl-string">'Approver': approver_name,
                class="hl-string">'PaymentBlockReason': None
            })

        class=class="hl-string">"hl-comment"># Activity: Invoice Rejected
        if inv.get(class="hl-string">'statusString') == class="hl-string">'Rejected' and inv.get(class="hl-string">'timeUpdated'):
            event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Rejected',
                class="hl-string">'EventTime': inv[class="hl-string">'timeUpdated'],
                class="hl-string">'Approver': inv.get(class="hl-string">'lastApprover', {}).get(class="hl-string">'name'),
                class="hl-string">'PaymentBlockReason': None
            })

        class=class="hl-string">"hl-comment"># Activities related to payment blocks, posting, and payments
        class=class="hl-string">"hl-comment"># These fields may not be standard and depend on ERP integration
        if inv.get(class="hl-string">'paymentBlockTimestamp'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Payment Block Set',
                class="hl-string">'EventTime': inv[class="hl-string">'paymentBlockTimestamp'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': inv.get(class="hl-string">'paymentBlockReason')
            })
        if inv.get(class="hl-string">'paymentBlockReleasedTimestamp'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Payment Block Released',
                class="hl-string">'EventTime': inv[class="hl-string">'paymentBlockReleasedTimestamp'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })
        if inv.get(class="hl-string">'erpPostingDate'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Invoice Posted',
                class="hl-string">'EventTime': inv[class="hl-string">'erpPostingDate'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })
        if inv.get(class="hl-string">'scheduledPaymentDate'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Payment Scheduled',
                class="hl-string">'EventTime': inv[class="hl-string">'scheduledPaymentDate'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })
        if inv.get(class="hl-string">'paidDate'):
             event_log_records.append({
                **common_attrs,
                class="hl-string">'ActivityName': class="hl-string">'Payment Executed',
                class="hl-string">'EventTime': inv[class="hl-string">'paidDate'],
                class="hl-string">'Approver': None,
                class="hl-string">'PaymentBlockReason': None
            })

    return pd.DataFrame(event_log_records)

def main():
    class="hl-string">"""Main function to execute the extraction process."""
    print(class="hl-string">"Starting SAP Ariba invoice data extraction...")
    
    class=class="hl-string">"hl-comment"># Define the extraction time window (e.g., last 3 months)
    created_date_from = class="hl-string">"2023-01-01T00:00:00Z"
    created_date_to = class="hl-string">"2023-03-31T23:59:59Z"

    access_token = get_oauth_token(OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET)
    if not access_token:
        print(class="hl-string">"Failed to get OAuth token. Exiting.")
        return

    raw_invoices = fetch_ariba_data(access_token, created_date_from, created_date_to)
    if not raw_invoices:
        print(class="hl-string">"No data found for the specified period. Exiting.")
        return
    
    print(fclass="hl-string">"Successfully fetched {len(raw_invoices)} invoice records.")
    
    event_log_df = transform_to_event_log(raw_invoices)
    
    if event_log_df.empty:
        print(class="hl-string">"Transformation resulted in an empty event log.")
        return

    class=class="hl-string">"hl-comment"># Sort by case and time for chronological order
    event_log_df = event_log_df.sort_values(by=[class="hl-string">'InvoiceNumber', class="hl-string">'EventTime'], ascending=[True, True])
    
    output_filename = class="hl-string">'ariba_invoice_event_log.csv'
    event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

准备开始了吗？

使用此模板简化发票处理分析。立即建立事件日志，释放流程效率，加快付款速度。

返回改进指南下载模板

立即优化采购到付款发票处理

将发票周期时间缩短30%，改善现金流。

开始免费试用

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

您的采购到付款发票处理数据模板

您的采购到付款发票处理数据模板

采购到付款－发票处理属性

采购到付款－发票处理活动

提取指南

通过SAP Ariba报告API使用Python脚本提取数据

步骤

配置

a 示例查询 python

准备开始了吗？

立即优化采购到付款发票处理

我们重视您的隐私