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

必填建议填写选填

采购到付款发票处理活动

建议在事件日志中记录这些关键流程步骤和里程碑，以便准确发现并分析发票处理工作流。

6 建议填写 7 选填

	活动	说明
	发票对账完成	这是一个关键里程碑，表示发票已成功与采购订单和收货记录匹配，且不存在未解决的差异。这确认发票符合审批条件。
重要性完成此步骤表示验证阶段结束，发票已准备好进入审批工作流。这也是衡量直通处理率的重要检查点。获取途径可通过发票对账（IR）单据的状态变更记录，例如状态变为“已对账”。采集使用发票对账单据状态更新为“已对账”时的时间戳。事件类型 inferred
	发票已批准	表示审批工作流已成功完成，所有必需的审批人均已批准发票付款。这是发票过账前的关键里程碑。
重要性此活动是衡量审批周期时间的终点，也是后续付款处理步骤的重要影响因素。此处的延误会直接影响按时付款表现。获取途径通常可在 Ariba 的发票审批历史记录中明确找到此信息。也可以根据单据状态变为“已批准”来推断。采集从审批流历史记录中提取，或使用状态变为“已批准”的时间戳。事件类型 explicit
	发票已过账	此活动表示已批准的发票已成功发送至下游ERP系统，并被系统接收，用于财务核算和付款处理。这是重要的集成里程碑。
重要性确认采购与财务之间的交接已完成。这是安排和执行付款前的关键里程碑。获取途径可根据发票状态变为“已发送”或“正在处理付款”等最终状态来推断，同时应有相应的ERP确认消息记录。采集识别发票状态更新为成功发送至ERP时的时间戳。事件类型 inferred
	已执行付款	流程中的最后一项活动，确认款项已发送给供应商，至此发票生命周期结束。
重要性此活动是衡量发票整体周期时间的主要终点，也是计算按时付款率和早期付款折扣获取率的关键依据。获取途径此事件发生在ERP系统中。付款状态、付款日期和交易详情通常会发送回SAP Ariba，以更新发票单据。采集可根据发票付款状态变为“已付款”并记录相应付款日期来推断。事件类型 inferred
	提交发票以供审批	发票成功完成对账后，此活动标志着正式审批工作流的开始。系统会根据业务规则将发票发送给一位或多位指定审批人。
重要性这是衡量发票审批周期时间KPI、分析审批流程效率的起点。获取途径可根据发票单据的状态变更推断，状态通常会从“已对账”变为“审批中”或“待审批”。采集记录发票或IR单据状态变为“审批中”或类似状态时的时间戳。事件类型 inferred
	收到发票	标志着发票处理全生命周期的开始，即发票首次录入SAP Ariba系统。录入渠道包括Ariba Network、供应商门户或手工录入。
重要性此活动是衡量发票端到端周期时间、了解初始处理延误的主要起点。获取途径通常根据SAP Ariba Buying and Invoicing中发票单据的创建时间戳推断。该时间戳表示发票记录首次在系统中生成的时间。采集使用主发票对象或单据的创建时间戳。事件类型 inferred
	发现匹配差异	当系统或用户发现发票、采购订单和收货信息之间不匹配时，就会发生此异常活动。常见差异包括价格、数量或税额不一致。
重要性此活动对于计算匹配差异率、识别常见错误来源至关重要，而这些问题是造成处理延误的主要原因。获取途径通常通过发票对账（IR）单据的特定状态记录，例如“已拒绝”或“有争议”，并附带原因代码。采集识别IR单据状态变为不匹配或异常状态时的时间戳。事件类型 inferred
	发票已拒绝	审批工作流中的异常活动，表示审批人拒绝了发票。通常需要更正并重新提交发票，从而形成返工循环。
重要性跟踪拒绝情况对于计算发票拒绝率KPI，以及分析审批失败的根本原因至关重要，例如违反政策或编码错误。获取途径此信息会记录在发票单据的审批历史中，单据状态也会变为“已拒绝”。采集从审批历史中的备注和时间戳提取，或根据状态变为“已拒绝”来识别。事件类型 explicit
	已安排付款	表示财务团队在ERP系统中将发票纳入特定付款批次。付款已列入计划，但尚未执行。
重要性此信息有助于了解付款流程的最后阶段、预测现金流出，并分析过账至最终付款之间的延误。获取途径此信息通常保存在ERP系统中，也可能同步回SAP Ariba，并显示在发票的付款状态信息中。采集可根据ERP发送回Ariba发票单据的付款状态详情推断。事件类型 inferred
	已解除付款冻结	表示此前设置的付款冻结已解除，发票可以进入付款排程。此活动表明相关问题已解决。
重要性此活动是衡量付款冻结解决时间的终点，标志着冻结发票的异常处理闭环。获取途径与设置冻结类似，此操作通常在ERP系统中执行，状态可能会同步回Ariba。可根据付款冻结标记的移除情况推断。采集需要识别付款冻结标记或状态被移除或停用的时间戳。事件类型 inferred
	已设置付款冻结	用户或系统主动阻止已批准的发票付款时会发生此活动。常见原因包括供应商争议、质量问题或其他商业原因。
重要性此活动是衡量付款冻结解决时间的起点。分析冻结情况有助于发现并解决导致付款延迟的系统性问题。获取途径发票过账后，通常在集成的ERP系统（如SAP S/4HANA）中管理付款冻结，但冻结状态可能会同步回Ariba。系统可能通过特定标记或状态指示冻结情况。采集需要识别表示付款冻结已生效的标记或状态字段变更。事件类型 inferred
	提交发票以进行对账	表示发票已录入并正式提交至对账流程，以便与采购订单或合同进行匹配。这是从数据录入到验证的关键交接点。
重要性此里程碑标志着匹配和验证阶段的开始。分析从收到发票到此活动的耗时，有助于发现数据录入环节的瓶颈。获取途径可根据发票或发票对账（IR）单据的状态变更推断，状态通常会变为“已提交”或“对账中”。采集记录发票对账单据状态变为“已提交”时的时间戳。事件类型 inferred
	解决差异	表示先前发现的不匹配问题已得到处理，发票可以继续进入对账和审批流程。处理方式可能包括手动调整或与供应商沟通。
重要性跟踪解决差异所需的时间，有助于量化返工的影响，并发现提高首次匹配成功率的机会。获取途径可根据发票对账（IR）单据的状态变更推断：状态从异常状态恢复为“对账中”或“已提交”等处理状态。采集记录IR单据脱离差异状态并重新进入处理工作流时的时间戳。事件类型 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和Client 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响应。它会依次调用API，并使用每次响应中的page_token请求下一批结果，直到获取指定时间段内的全部数据。
生成事件日志文件：获取并转换所有数据后，脚本会将其整理为pandas DataFrame，并导出为ariba_invoice_event_log.csv，保存在脚本运行目录中。
检查并上传：打开生成的CSV文件并检查内容。确认文件包含所需列（InvoiceNumber、ActivityName、EventTime），且数据正确。随后即可将文件上传至ProcessMind进行分析。

配置

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

查询示例 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脚本提取数据

步骤

配置

查询示例 python

准备好开始了吗？

立即优化采购到付款流程中的发票处理