> 持续流程改进 > 采购到付款—采购订单 > SAP Ariba > 数据模板

数据模板：采购到付款—采购订单

SAP Ariba

← 返回改进指南

采购到付款—采购订单属性 (23) 采购到付款—采购订单活动 (14) 提取指南 (2)

你的采购到付款-采购订单数据模板

本模板提供了一份全面指南，用于收集分析采购到付款 - 采购订单流程所需的关键数据。它概述了需要追踪的重要属性和活动，并提供了从源系统提取数据的实用指导。利用此资源可为流程发现和优化奠定完整准确的基础。

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

不熟悉事件日志？了解如何创建流程挖掘事件日志.

下载模板

采购到付款—采购订单属性

为全面分析从采购到付款（P2P）-采购订单流程，建议在事件日志中纳入以下数据字段。

3 必填 6 推荐 14 可选

	名称	描述
	Event 时间 EventTime	特定活动或事件发生的精确日期和时间。
描述 Event Time是与每个活动关联的时间戳，用于记录开始时间。这些数据用于按时间顺序排列事件，并计算流程各环节之间的持续时长和周期时间。该属性几乎是所有基于时间的分析的关键，例如“采购订单端到端周期时间”和“采购订单审批周期时间”仪表板。它支持计算关键指标，例如通过比较“创建采购订单”和“采购订单已批准”的时间戳来得到“平均PO审批周期时间”。为何重要此时间戳对于正确排序事件和计算所有基于时长的指标（例如周期时间和等待时间）至关重要。获取方式这通常可以在SAP Ariba中采购订单文档的审计追踪或变更日志数据中找到。示例 2023-04-15T10:30:00Z2023-04-16T14:05:22Z2023-05-01T09:00:15Z
	活动名称 ActivityName	记录在采购订单流程中某一时间点发生的具体事件或任务的名称。
描述 “活动名称”描述采购订单生命周期中的一个步骤，例如“创建采购订单”“批准采购订单”或“登记收货”。这些活动的先后顺序构成了流程图的基础。分析这些活动是流程挖掘的核心。它可以可视化流程，识别常见与不常见的流程变体，并测量各步骤之间的耗时。理解“采购订单已变更”等活动的顺序和发生频率，对“采购订单变更率分析”等仪表板尤为关键。为何重要该属性用于定义流程中的各个步骤，便于可视化流程流向，并识别瓶颈、返工与偏差。获取方式通过映射SAP Ariba底层与单据历史和工作流相关表中的状态变更、事务代码或事件日志生成。示例采购订单已批准采购订单已更改收货已过账已收到PO对应发票
	采购订单 PurchaseOrderNumber	每张采购订单单据的唯一标识，用作该流程的核心实例标识符。
描述采购订单编号是贯穿采购全生命周期、关联所有相关活动与事件的主键。每个编号代表一笔采购交易，从订单创建直至完成或取消。在流程挖掘中，该属性是开展实例级分析的基础。它可重建每张采购订单的端到端旅程，用于计算周期时间、识别流程变体，并跟踪单笔订单状态。按采购订单编号进行分析，有助于看清完整流程并定位特定交易的瓶颈或偏差。为何重要这是连接全部流程步骤的关键 Case ID，可用于分析每张采购订单的端到端生命周期。获取方式这是 SAP Ariba Buying and Invoicing 或 SAP Ariba Sourcing 中采购订单单据上的主要字段。示例 PO7000123456PO7000123457PO7000123458
	PO金额 PurchaseOrderAmount	采购订单的总金额。
描述该属性表示采购订单中所有货物与服务的总金额，除非另有说明，不含税费及其他收费。它是理解流程中交易金额规模的核心财务指标。在分析中，采购订单金额常用于对流程分层。例如，高金额订单可能遵循比低金额订单更严格的审批路径。它还能帮助将改进优先级聚焦在财务影响更大的交易上，并按部门或供应商分析支出模式。为何重要为每个流程实例提供财务背景，支持基于价值的分析，帮助确定改进优先级，并理解订单金额如何影响流程表现。获取方式这是采购订单单据抬头级的标准计算字段，用于汇总所有行项目的金额。示例 1500.0025000.50500.75
	供应商名称 VendorName	采购的商品或服务的供应商名称。
描述该属性用于标识参与该采购订单的外部合作方。供应商是采购到付款（P2P）流程中的关键角色，其表现直接影响整体周期效率。供应商名称是绩效分析的核心维度。它是供应商交付绩效仪表板的必要字段，用于对比不同供应商的交付日期。按供应商分析流程，可看出哪些供应商经常延迟、返工更多或发票流程更复杂，为供应商关系管理提供有价值的洞察。为何重要支持分析供应商绩效，识别可靠合作伙伴，并定位造成延误或其他问题的供应商。获取方式这是 SAP Ariba 中采购订单单据抬头级的标准字段。示例环球办公用品有限公司科技解决方案有限责任公司Advanced Industrial Parts
	收货日期 GoodsReceiptDate	系统正式记录收货或服务完成的日期。
描述该属性记录“Goods Receipt Posted”或“Services Confirmation Entered”活动的时间戳，是对已收货的正式确认。此日期是衡量实际交付时长的关键字段，与“RequestedDeliveryDate”相对应，用于计算交付偏差与及时性KPI。收货过账及时性仪表板依赖该属性评估收货后过账的速度，这对库存准确性和发票按时付款都很重要。为何重要表示实际交付日期，是计算交付绩效并识别供应链延误的关键。获取方式这是参考采购订单的收货或服务记录单的时间戳。示例 2023-06-02T11:00:00Z2023-07-14T15:30:00Z2023-08-22T09:45:00Z
	期望交货日期 RequestedDeliveryDate	申请方期望货物或服务交付的日期。
描述这是业务在创建采购申请或订单时设定的目标交货日期，它作为衡量实际交货绩效的基准。该属性对供应商交货绩效仪表板和收货及时率KPI至关重要。通过比较要求交货日期与实际收货日期，企业可以衡量供应商的准时性、计算交货差异，并识别那些持续未能按时交货的供应商。这项分析对于管理供应商关系和降低供应链风险至关重要。为何重要作为衡量按时交付表现的基准，这对评估供应商可靠性与供应链效率至关重要。获取方式这是采购订单单据行项目级的标准日期字段。示例 2023-06-012023-07-152023-08-20
	用户名称 UserName	执行该活动的用户姓名或ID。
描述该属性用于标识执行特定流程步骤的责任人，如审批采购订单或过账收货。可为唯一用户ID或姓名。按用户维度分析有助于发现培训需求或表彰优秀表现；在合规分析中也至关重要，例如PO审批合规偏差仪表板，可用于定位跳过必需审批步骤的人员。同时还能用于了解工作量分布与资源配置。为何重要明确责任归属，并支持按用户分析绩效、工作量与合规性，有助于识别培训需求或流程偏差。获取方式该信息通常可在 SAP Ariba 的工作流和文档历史日志中获取，并常与每个事件关联。示例 john.smithLROSSIjane.doe
	部门名称 DepartmentName	与该采购订单关联的业务部门或成本中心。
描述该属性表示发起采购请求的组织单元，或采购所服务的组织单元，通常来自PO上的成本中心信息。该维度是部门PO处理效率仪表板的基础，可直接对比不同部门的周期时长和流程变体，识别遵循最佳实践的部门，以及需要加强培训或优化流程的部门；也是计算部门PO周期时长方差KPI的关键字段。为何重要支持跨业务单元进行绩效对比，帮助识别部门级瓶颈并共享最佳实践。获取方式该信息可在采购订单的抬头或行项目级别找到，通常与成本中心或申请人资料关联。示例市场营销IT运维设施管理研发
	PO审批周期 POApprovalCycleTime	从创建采购订单到最终批准之间的计算时长。
描述该指标衡量采购订单完成所有必要审批步骤所需的时间。其计算方式为给定案例中，第一个采购订单创建活动的时间戳与最后一个采购订单已审批活动的时间戳之间的时间差。这是平均采购订单审批周期KPI的直接衡量指标，也是采购订单审批周期仪表板的核心指标。分析这段时长有助于企业识别审批层级中的瓶颈，无论这些瓶颈是来自特定人员、部门，还是特定类型的采购。缩短这个周期时间通常是流程改进项目的关键目标。为何重要直接衡量审批流程效率——这往往是采购延误的常见来源，也是流程负责人的关键KPI。获取方式在数据转换过程中计算：用最终审批事件的开始时间减去创建事件的开始时间。示例 P2DPT8H30MP0D
	PO是否变更 IsPurchaseOrderChanged	用于指示采购订单在初次创建后是否被修改的布尔标记。
描述这是一个派生属性，如果某个案例存在“Purchase Order Changed”活动，则该属性为“true”。它为变更率分析提供了简洁的案例级变更指示器，简化了分析工作。该标记用于计算“Purchase Order Change Rate”KPI，可快速切分数据，对比已变更与未变更订单的流程差异，从而揭示变更的下游影响，如周期时间变长或发票差异增多。Purchase Order Change Rate Analysis 仪表板据此量化变更发生的频率。为何重要提供简单标记以识别所有发生变更的采购订单，便于计算变更率并分析其影响。获取方式该标记在数据转换过程中生成：针对每个采购订单号检查是否存在“Purchase Order Changed”事件。示例 truefalse
	PO状态 PurchaseOrderStatus	采购订单在其生命周期中的当前状态。
描述该属性表示采购订单的当前状态，如“Ordering”“Receiving”“Invoiced”或“Completed”，用于快速了解PO在整体流程中的位置。尽管流程挖掘会根据活动重建流程，但当前状态非常适合用于筛选流程实例并判断当前在制工作量。例如，分析师可能只关注尚未完结的在制PO。它也可用于校验流程轨迹中的最终活动。为何重要快速呈现采购订单所在的生命周期阶段，便于筛选并聚焦进行中或已完成的流程实例。获取方式这是 SAP Ariba 中采购订单单据抬头上的标准状态字段。示例下单收货已完成已取消
	PO端到端周期 POEndToEndCycleTime	从首个采购申请创建到采购订单最终完成所经历的总时间。
描述该计算属性衡量采购订单全流程的总时长，通常从“Purchase Requisition Created”事件开始，至“Purchase Order Completed”或最后一次“Goods Receipt Posted”事件结束，提供对流程效率的整体视角。它是端到端PO周期时长KPI与采购订单端到端周期仪表板的核心指标，帮助企业跟踪整体绩效及各项改进的影响。按供应商、部门或物料组拆解该总周期，可找出导致交期过长的主要因素。为何重要表示采购订单的总处理时长，是衡量整体流程效率与体验的宏观指标。获取方式在数据转换中，通过计算该流程实例最早与最晚时间戳之间的差值得到。示例 P15DP30D12HP7D
	PO类型 PurchaseOrderType	采购订单的分类，例如标准、框架协议或分包。
描述采购订单类型按业务用途对订单进行分类。不同类型的订单可能遵循不同的流程路径，并在审批与履行上有不同规则。该属性支持对流程进行分段，获得更有意义的分析。例如，将“标准PO”的周期与“服务类PO”分开分析，能够揭示不同类型的瓶颈。它有助于构建同质性更高的数据子集，更清晰地洞察特定采购场景。为何重要支持按订单类型细分分析。不同类型往往对应不同的流程路径，可获得更准确的洞察。获取方式参考SAP Ariba文档。该字段通常可在PO抬头层级进行配置。示例标准采购订单服务采购订单框架采购订单
	事件结束时间 EventEndTime	标识某项活动完成时刻的时间戳，用于计算人工活动的处理时长。
描述虽然StartTime表示活动的开始时间，但EventEndTime则标志着活动的结束。对于许多系统生成事件，开始时间和结束时间是相同的。然而，对于手动任务或耗时较长的自动化作业，开始时间与结束时间之间的差异代表了活动的处理时间。此属性用于计算处理时间指标，这对采购订单活动时长分析仪表板至关重要。它有助于精确找出哪些特定任务耗时最长，从而突显出培训、资源重新分配或自动化的机会。为何重要支持精确计算各项活动的处理时间，帮助定位最耗时的具体任务。获取方式参考SAP Ariba文档。如未显式提供，可能需要由后续活动的开始时间推导。示例 2023-04-15T10:45:00Z2023-04-16T14:05:30Z2023-05-01T11:00:00Z
	交货偏差 DeliveryVariance	需求交付日期与实际收货日期之间的计算时间差。
描述该指标通过衡量交货的提前或延迟情况，量化供应商交货绩效。它通过从收货日期中减去要求交货日期来计算。正值表示延迟交货，负值表示提前交货，零表示准时交货。这是供应商交货绩效仪表板和供应商交货绩效差异KPI背后的核心计算。通过分析不同供应商的这一差异，企业可以识别可靠和不可靠的合作伙伴，这有助于制定供应商谈判和风险管理策略。它有助于超越简单的准时/延迟标记，深入了解交货偏差的程度。为何重要通过衡量交付提前或延迟的具体时长来量化供应商准时性，这对管理供应商绩效至关重要。获取方式在数据转换层计算：'GoodsReceiptDate'减去'RequestedDeliveryDate'。示例 P2D-P1DP0D
	最后数据更新 LastDataUpdate	指示该事件数据最近一次从源系统刷新或提取的时间戳。
描述该属性提供从SAP Ariba最近一次拉取数据的日期和时间，是判断分析数据新鲜度的关键元数据。在任何流程挖掘分析中，了解数据的时效性对于报告与决策至关重要。该时间戳可帮助用户确认其仪表板和KPI（如采购订单吞吐量趋势）基于最新信息。为何重要指示数据的新鲜度，帮助用户了解分析的时效性，增强对洞察的信任。获取方式此时间戳通常在数据提取、转换和加载 (ETL) 过程中生成并附加到数据集。示例 2023-10-27T02:00:00Z2023-10-28T02:00:00Z
	是否返工 IsRework	用于指示采购订单是否经历返工循环（例如被驳回后再次提交）的计算标记。
描述该布尔属性根据活动序列计算：当PO在流程中出现回退时（例如“Approve Purchase Order”之后紧跟“Change Purchase Order”，随后再次审批），则置为“true”，表明偏离了理想的直通式流程。该标记用于计算PO返工循环率KPI，并在流程图中过滤并突出低效路径。识别返工的流程实例后，分析师可进一步定位根因，如录入错误或需求不清，从而提升一次性通过率。为何重要直接标记存在流程低效与返工的流程实例，便于分析人员量化循环的影响并有针对性地消除。获取方式该属性并非来源系统字段，而是在数据转换过程中根据每个流程实例的活动序列计算得出。示例 truefalse
	源系统 SourceSystem	标识数据来源系统，此处为SAP Ariba。
描述该属性用于标识流程数据的来源。在多系统集成环境中，它对于区分不同来源并确保数据血缘至关重要。在分析中，它可用于按系统过滤数据，或理解跨平台的流程交互。它也是数据治理与校验的重要元数据，确保分析基于正确的数据集。为何重要提供数据来源的关键上下文，在多系统环境中的数据治理、校验与分析尤为重要。获取方式这是一个静态值（“SAP Ariba”），通常在数据抽取与转换过程中添加。示例 SAP AribaSAP-Ariba-USAribaCloud
	物料组 MaterialGroup	用于将特性相近的物料或服务分组的分类。
描述物料组（在Ariba中称为Commodity Code）用于对采购内容进行分类，便于进行支出分析，并针对不同商品或服务制定差异化的采购策略。在流程挖掘中，该属性支持基于“采购了什么”来分析采购流程。例如，IT硬件的审批流程可能不同于办公用品。由此可以获得更细致的洞察，从而针对具体采购品类定制改进方案。为何重要支持按商品或服务的品类开展流程分析，揭示不同品类在采购方式上的差异。获取方式这是采购订单行项目级的标准字段，通常标注为“Commodity Code”（商品分类编码）。示例 IT.HardwareOffice.SuppliesProfessional.Services
	请购单编号 PurchaseRequisitionNumber	在采购订单之前的采购申请（请购单）的唯一标识。
描述该属性用于将采购订单关联到其对应的采购申请/请购单。并非所有PO都有前置申请，例如直接创建PO的情况。此关联对端到端采购流程分析至关重要，从最初请求开始贯穿全程。它是“申请到PO转化漏斗”仪表板与“申请到PO转化时长”KPI的必备字段。分析该关联有助于找出从请求获批到向供应商正式下单之间的延误。为何重要将采购订单与最初的申请关联起来，实现从请购创建到订单履约的端到端分析。获取方式该信息通常作为采购订单行项目上的参考字段提供。示例 PR10004567PR10004568PR10004569
	货币 DocumentCurrency	采购订单金额所使用的货币代码。
描述该属性指定采购订单金额所使用的币种，如USD、EUR或GBP，是解读任何财务数据的必要上下文。在跨国家或区域的流程分析中，凭证币种对于正确解读和对比金额至关重要。所有财务KPI与仪表板都应使用该字段来筛选单一币种，或应用适当汇率以实现准确汇总与对比。为何重要为所有金额字段提供必要的上下文，确保财务分析准确无误，避免不同货币被错误汇总。获取方式这是 SAP Ariba 中采购订单单据抬头级的标准字段。示例美元EURGBPJPY
	采购组织 PurchasingOrganization	负责采购物料与服务并与供应商进行谈判的组织单元。
描述采购组织是采购体系中的关键实体，负责采购的策略性工作。企业可能按地区或业务单元设置不同的采购组织。按采购组织维度分析流程，可揭示公司内部在效率、合规与供应商管理策略上的差异，有助于沉淀并统一最佳实践，识别组织层面的瓶颈与低效来源。为何重要支持对不同战略采购单元的流程效率与合规进行宏观分析。获取方式这是采购订单单据抬头级的标准组织数据字段。示例 PO_US01PO_EMEAPO_GLOBAL

必填推荐可选

采购到付款—采购订单活动

为精准发现从采购到付款（P2P）-采购订单流程，应在事件日志中记录以下关键步骤与里程碑。

6 推荐 8 可选

	活动	描述
	已创建请购单	该活动标识采购申请的创建，这是在采购订单之前发起的正式需求申请。在SAP Ariba中，通常在用户保存并提交新的请购单时进行记录，并生成带有创建时间戳的明确记录。
为何重要这是采购流程的主要起点。分析从该事件到采购订单创建的时间，对理解请购到下单的周期时间并识别前端瓶颈至关重要。获取方式该事件取自SAP Ariba Buying模块中Requisition文档对象的创建日期；状态变更为“Submitted”通常表示流程正式开始。捕获以请购单文档的创建时间戳为准。事件类型 explicit
	已创建采购订单	该活动表示在SAP Ariba中正式生成了采购订单单据，来源可能是已批准的请购单，也可能是直接创建。其依据为PO单据的创建时间戳，代表PO生命周期的正式起点。
为何重要对于直接创建的PO，这是流程起点。它是衡量请购转PO用时和整体PO处理周期的关键里程碑。获取方式来自SAP Ariba Buying中PurchaseOrder文档对象的创建时间戳。此时状态通常为“Composing”或“Submitted”。捕获以采购订单文档的创建时间戳为准。事件类型 explicit
	收货已过账	表示实物收货，并在 SAP Ariba 中记录。当用户针对采购订单行创建并提交收货单时，会显式记录该事件。
为何重要这是用于确认交付的关键里程碑，也是衡量供应商交付绩效的终点事件。在三方匹配场景下，该节点也会授权发票进入付款流程。获取方式来自与PurchaseOrder关联的Receipt文档的创建或提交时间戳。捕获以收货单的提交时间戳为准。事件类型 explicit
	采购订单已发送给供应商	表示已批准的采购订单正式发送给供应商（通常经由 Ariba Network）的时刻。当 PO 状态变为“已发送”或“已下单”时记录该事件。
为何重要这标志着从内部处理到外部履行的过渡。它是衡量供应商提前期和交货绩效的起点。获取方式根据PurchaseOrder单据状态变更为“Sent”或“Ordered”时的时间戳推断。这是Ariba中的标准状态流转。捕获根据状态变更为“Sent”或类似状态时的时间戳推断。事件类型 inferred
	采购订单已完成	该活动标志采购订单生命周期的结束，表示货物或服务已全部收货并完成开票。通常可根据PO状态变为“Received”“Invoiced”或类似终态来判断。
为何重要这是流程的主要成功状态终点。衡量达到此状态所需时间，可得到端到端周期时间，这是评估整体流程效率的关键指标。获取方式根据PurchaseOrder状态变更为例如“Received”这样的最终状态时的时间戳推断。当所有行项目全部完成收货时，PO即视为完成。捕获当PO状态变更为“Received”或类似的完成状态时推断。事件类型 inferred
	采购订单已批准	表示该采购订单已完成所有内部审批，已准备发送给供应商。该事件基于PO文档在完成指定工作流后状态变更为“Approved”而推断。
为何重要这是衡量审批周期时间并识别管理层审批瓶颈的关键里程碑。此处延迟将直接影响供应商交期与采购效率。获取方式根据PurchaseOrder单据的状态或“ApprovedState”字段变更为“Approved”时的时间戳推断。审批历史日志提供详细数据。捕获根据PO审批流中最终批准动作的时间戳推断。事件类型 inferred
	供应商确认采购订单	表示供应商已收到并确认采购订单，确认将履行订单。当供应商通过Ariba Network提交订单确认单并触发PO状态更新时，即可捕获该事件。
为何重要该活动表明供应商已开始处理订单，有助于跟踪供应商响应度以及初始订单的准确性。获取方式根据在收到供应商订单确认后，PurchaseOrder状态更新为“Confirmed”时的时间戳推断。捕获以关联的订单确认文档创建日期或PO状态变更为依据。事件类型 inferred
	已录入服务确认	表示服务已完成的确认，相当于货物收货的服务版。当针对服务类采购订单创建并批准服务验收单时记录该事件。
为何重要该活动用于跟踪服务类订单的履约并作为付款授权。分析其及时性有助于管理服务交付与相关支出。获取方式来自与PurchaseOrder关联的ServiceSheet文档的审批时间戳。捕获以服务单文档的审批时间戳为准。事件类型 explicit
	已收到PO对应发票	表示已收到供应商针对该采购订单的发票并录入SAP Ariba。此事件将采购流程与后续付款流程衔接起来。
为何重要该活动是采购与财务之间的关键集成点，其发生时间对于营运资金管理与确保按时支付供应商至关重要。获取方式来自Ariba Invoicing中Invoice文档的创建时间戳，该文档包含对PurchaseOrder的引用。捕获以关联该PO的发票文档创建时间戳为准。事件类型 explicit
	已收到预先发货通知（ASN）	当供应商通过Ariba Network发送预先发货通知（Advance Ship Notice，ASN）时记录该活动，表示货物已发出。ASN包含发运明细，如物品、数量及跟踪信息。
为何重要 ASN 提供供应链可视性，便于收货部门提前做好交付准备；同时也是跟踪在途库存和预测到货时间的关键输入。获取方式来自与PurchaseOrder行项目关联的ShipNotice文档的创建日期。捕获以预先发货通知（ASN）文档的创建时间戳为准。事件类型 explicit
	请购单已批准	表示请购单已由所有相关方最终批准，获准转换为采购订单。通常可根据请购单状态变为“已批准”及其最终批准动作的时间戳来判断。
为何重要这一里程碑标志着请求的内部审批阶段结束。追踪此里程碑有助于在采购订单创建之前，衡量内部控制和审批工作流的效率。获取方式根据Requisition单据的审批历史或状态字段推断。事件时间戳对应状态变更为“Approved”的日期。捕获根据请购单的“ApprovedState”字段变更为“Approved”时的时间戳推断。事件类型 inferred
	货物退回供应商	该活动记录将货物退回给供应商的行为，通常因破损、缺陷或到货不符而发生。当针对原始收货单创建退货收据或借项通知单时进行记录。
为何重要追踪退货能够揭示供应商质量和交货准确性方面的问题。分析退货的频率和原因有助于改善供应商选择和管理。获取方式可根据创建了专用于退货的收货单据，或收货记录中出现负数量来推断。具体判定机制取决于系统配置。捕获当创建数量为负的收货记录或特定的“Return”类型时推断。事件类型 inferred
	采购订单已取消	表示在履约完成前终止采购订单。可由采购方发起，少数情况下也可能由供应商发起。
为何重要这是一个重要的异常与流程终点。分析采购订单取消的原因，可暴露计划、预算或供应商可靠性方面的问题。获取方式根据PurchaseOrder单据状态变更为“Cancelled”或“Closed”时的时间戳推断。捕获根据状态变更为“Cancelled”时的时间戳推断。事件类型 inferred
	采购订单已更改	该活动记录在采购订单初次创建后所做的任何修改，例如数量、价格或交货日期的变更。系统会生成PO的新版本，并通常会触发重新审批的工作流。
为何重要追踪变更对于识别流程低效、返工循环以及采购错误的根本原因至关重要。高变更率可能表明初始需求收集不佳。获取方式通过识别同一PurchaseOrder文档的多个版本确定。每个新版本都有创建时间戳，可用于此事件。捕获在创建并保存PO文档新版本时记录。事件类型 explicit

推荐可选

提取指南

如何从SAP Ariba获取数据

步骤

访问 Analytical Reporting：使用具备报表管理员或报表用户权限的账号登录你的 SAP Ariba 实例。点击 Manage > Analytical Reporting 进入报表仪表板。
新建报表：点击 Create 并选择 Report。在可选类型中选择 Transactional Report，以交易数据为基础构建报表。
选择数据模型（Fact）：选择包含采购数据的合适数据模型，常见名称如 Procurement Workspace Data、Sourcing and Procurement Data，或类似的自定义 Fact（如 [Your Procurement Data Mart]）。将其作为报表的数据基础。
添加报表内容（事实与维度）：在 Data Fields 面板中，通过添加所需对象来搭建查询。至少包含 Purchase Order、Purchase Requisition、Receipt、Invoice 和 User 的事实。将这些对象中的必需字段拖动到 Report Columns。
定义报表列：添加构建事件日志所需的全部字段。这将是一次“宽表”导出，后续再转换。包括：
- Purchase Order.ID（作为 PurchaseOrderNumber）
- Purchase Requisition.Time Created
- Purchase Requisition.Approved Date
- Purchase Order.Time Created
- Purchase Order.Approved Date
- Purchase Order.Version Time Created（用于变更）
- Purchase Order.Ordered Date（用于 Sent to Vendor）
- Order Confirmation.Confirmation Date
- Advance Ship Notice.Time Created
- Receipt.Receipt Date（作为 GoodsReceiptDate）
- Service Sheet.Approved Date
- Invoice.Time Created
- Purchase Order.Closed Date（用于 Completed）
- Purchase Order.Canceled Date
- 另外添加 User.Name、Department.Name、Supplier.Name、Purchase Order.Total Cost 和 Purchase Order.Req Delivery Date。
设置报表筛选：打开 Filters 选项卡。为主时间戳设置筛选以限定数据量，通常选择最近 3–6 个月的 Purchase Order.Time Created。根据分析范围再添加关键筛选，如 Company Code 或 Purchasing Organization。
保存并运行报表：以清晰的名称保存，如 ProcessMind_P2P_PO_Extraction。数据量大时使用 Schedule 安排夜间运行，避免影响性能，请勿立即执行。
导出报表数据：报表完成后，进入已计划的报表，找到已完成的实例并下载结果。导出格式选择 CSV，与数据转换工具兼容性最佳。
转换数据：导出的 CSV 为宽表（每个 PO 一行）。需要转换为长表事件日志。使用 Microsoft Excel Power Query、Python 或专用 ETL 工具对日期列进行取消透视（unpivot）。原文件每一行需在新文件中生成多行，每个非空日期列对应一行。每行包含 PurchaseOrderNumber、ActivityName（由原日期列的列名派生）和 EventTime（该列的值）。
最终整理与上传：确认转换后的 CSV 含所需列头（PurchaseOrderNumber、ActivityName、EventTime 等）。文件即可上传至你的流程挖掘平台。

配置

先决条件：需要具备 'Reporting User' 或 'Reporting Administrator' 权限的账号，才能创建、运行并调度分析报表。
报表类型：使用 Transactional Report。它可以将多个业务数据（如采购订单、采购申请、发票）整合到一份报表中，以还原端到端流程。
数据模型（Fact）：报表需基于完整的采购数据集市，例如 Procurement Workspace Data 或等效的自定义数据集，用于关联采购订单及其相关单据。
日期范围过滤：务必设置日期过滤以控制数据量。建议先按最近 3 至 6 个月的 Purchase Order Creation Date 进行筛选。
关键数据过滤：为确保数据相关性并控制数据量，可按 Company Code 和/或 Purchasing Organization 进行过滤，将抽取范围限定在特定业务单元。
性能考虑：如果数据集超过数万张采购订单，请将报表安排在非高峰时段运行。临时运行大型且复杂的报表可能会影响所有用户的系统性能。

a 查询示例 config

/*
This is a conceptual SQL query representing the logic to be built in the SAP Ariba Analytical Reporting UI.
The final output is a single CSV file that is later transformed into an event log.
The Ariba UI does not use SQL directly; this query illustrates the required data structure and joins.
*/

-- Activity: Purchase Requisition Created
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Requisition Created' AS "ActivityName",
  pr.CREATION_TIME AS "EventTime",
  pr_creator.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.PRHeader] pr ON po.PR_ID = pr.PR_ID
LEFT JOIN [Ariba.Users] pr_creator ON pr.CREATED_BY_USER_ID = pr_creator.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Requisition Approved
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Requisition Approved' AS "ActivityName",
  pr.APPROVAL_TIME AS "EventTime",
  pr_approver.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.PRHeader] pr ON po.PR_ID = pr.PR_ID
LEFT JOIN [Ariba.Users] pr_approver ON pr.APPROVED_BY_USER_ID = pr_approver.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND pr.APPROVAL_TIME IS NOT NULL

UNION ALL

-- Activity: Purchase Order Created
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Created' AS "ActivityName",
  po.CREATION_TIME AS "EventTime",
  po_creator.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] po_creator ON po.CREATED_BY_USER_ID = po_creator.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Order Approved
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Approved' AS "ActivityName",
  po.APPROVAL_TIME AS "EventTime",
  po_approver.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] po_approver ON po.APPROVED_BY_USER_ID = po_approver.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.APPROVAL_TIME IS NOT NULL

UNION ALL

-- Activity: Purchase Order Changed
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Changed' AS "ActivityName",
  ver.VERSION_CREATION_TIME AS "EventTime",
  changer.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.POVersions] ver ON po.PO_ID = ver.PO_ID AND ver.VERSION_NUMBER > 1
LEFT JOIN [Ariba.Users] changer ON ver.CHANGED_BY_USER_ID = changer.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Order Sent To Vendor
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Sent To Vendor' AS "ActivityName",
  po.ORDERED_TIME AS "EventTime",
  sender.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] sender ON po.ORDERED_BY_USER_ID = sender.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.ORDERED_TIME IS NOT NULL

UNION ALL

-- Activity: Vendor Confirmed Purchase Order
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Vendor Confirmed Purchase Order' AS "ActivityName",
  oc.CONFIRMATION_TIME AS "EventTime",
  'System/Vendor' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.OrderConfirmations] oc ON po.PO_ID = oc.PO_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND oc.CONFIRMATION_TIME IS NOT NULL

UNION ALL

-- Activity: Advance Ship Notice Received
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Advance Ship Notice Received' AS "ActivityName",
  asn.CREATION_TIME AS "EventTime",
  'System/Vendor' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.ASNs] asn ON po.PO_ID = asn.PO_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND asn.CREATION_TIME IS NOT NULL

UNION ALL

-- Activity: Goods Receipt Posted
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Goods Receipt Posted' AS "ActivityName",
  rcpt.RECEIPT_TIME AS "EventTime",
  receiver.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  rcpt.RECEIPT_TIME AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.Receipts] rcpt ON po.PO_ID = rcpt.PO_ID
LEFT JOIN [Ariba.Users] receiver ON rcpt.CREATED_BY_USER_ID = receiver.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND rcpt.RECEIPT_TYPE = 'Goods'

UNION ALL

-- Activity: Services Confirmation Entered
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Services Confirmation Entered' AS "ActivityName",
  ss.APPROVAL_TIME AS "EventTime",
  ss_creator.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  ss.APPROVAL_TIME AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.ServiceSheets] ss ON po.PO_ID = ss.PO_ID
LEFT JOIN [Ariba.Users] ss_creator ON ss.CREATED_BY_USER_ID = ss_creator.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND ss.APPROVAL_TIME IS NOT NULL

UNION ALL

-- Activity: Goods Returned To Vendor
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Goods Returned To Vendor' AS "ActivityName",
  rcpt.RECEIPT_TIME AS "EventTime",
  returner.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.Receipts] rcpt ON po.PO_ID = rcpt.PO_ID AND rcpt.RECEIPT_TYPE = 'Return'
LEFT JOIN [Ariba.Users] returner ON rcpt.CREATED_BY_USER_ID = returner.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Invoice Received Against PO
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Invoice Received Against PO' AS "ActivityName",
  inv.CREATION_TIME AS "EventTime",
  'System/AP' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
INNER JOIN [Ariba.Invoices] inv ON po.PO_ID = inv.PO_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]')

UNION ALL

-- Activity: Purchase Order Completed
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Completed' AS "ActivityName",
  po.COMPLETED_TIME AS "EventTime",
  'System' AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.STATUS = 'Completed'

UNION ALL

-- Activity: Purchase Order Cancelled
SELECT
  po.PO_NUMBER AS "PurchaseOrderNumber",
  'Purchase Order Cancelled' AS "ActivityName",
  po.CANCELLED_TIME AS "EventTime",
  canceller.USER_NAME AS "UserName",
  dept.DEPARTMENT_NAME AS "DepartmentName",
  vendor.VENDOR_NAME AS "VendorName",
  po.TOTAL_AMOUNT AS "PurchaseOrderAmount",
  po.REQUESTED_DELIVERY_DATE AS "RequestedDeliveryDate",
  NULL AS "GoodsReceiptDate"
FROM [Ariba.POHeader] po
LEFT JOIN [Ariba.Users] canceller ON po.CANCELLED_BY_USER_ID = canceller.USER_ID
LEFT JOIN [Ariba.Departments] dept ON po.DEPARTMENT_ID = dept.DEPT_ID
LEFT JOIN [Ariba.Vendors] vendor ON po.VENDOR_ID = vendor.VENDOR_ID
WHERE po.CREATION_TIME BETWEEN '[START_DATE]' AND '[END_DATE]' AND po.COMPANY_CODE IN ('[Your Company Code]') AND po.STATUS = 'Cancelled'

步骤

前置条件：确保你拥有 SAP Ariba 开发者账号，并已创建具备 API 访问权限的应用。你需要 API Key、OAuth Client ID 和 OAuth Client Secret。该应用需获批，并被授予 Analytical Reporting API 的权限。
配置报表视图：在 SAP Ariba 管理界面，配置一个 Analytical Reporting 视图（也称视图模板），包含采购订单全生命周期所需字段。该视图应关联请购、采购订单、收货和发票等数据。记录该视图模板的准确名称，后续 API 调用会用到。
安装 Python 库：准备 Python 环境并安装必要库：用于发起 API 调用的 requests，以及用于数据处理的 pandas。可通过 pip 安装：pip install requests pandas。
编写 Python 脚本：将提供的脚本复制为例如 ariba_p2p_extractor.py 的文件。在脚本顶部填入你的 Ariba 凭据、API 端点，以及报表视图模板名等占位变量。
认证并获取令牌：脚本首先执行 OAuth 2.0 认证，向 Ariba 认证端点发送凭据，获取后续 API 调用所需的临时访问令牌（token）。
定义并提交报表任务：脚本构建描述报表任务的 JSON 负载，指定要使用的视图模板，并设置筛选条件，如采购订单创建日期的时间范围。随后将任务提交至 Ariba Reporting API，后台异步生成报表。
轮询任务完成：由于报表生成是异步的，脚本进入轮询循环，定期查询任务状态，直至状态变为 Completed。
下载报表数据：任务完成后，脚本从状态响应中获取下载 URL，下载 GZIP 压缩的 CSV 文件，并解压缩。
转为事件日志：将下载的 CSV 载入 pandas DataFrame。该数据通常为宽表（每个采购订单一行）。脚本把宽表转换为长表事件日志，遍历各业务事件对应的列（如 pr.TimeCreated、po.ApprovedDate），对每个有效时间戳生成一行活动记录。
映射属性：转换过程中为每条事件填充所需列：PurchaseOrderNumber（Case ID）、ActivityName、EventTime；并将 UserName、VendorName、PurchaseOrderAmount 等相关信息映射到事件行。
保存最终事件日志：处理完所有活动并生成完整事件日志后，按 Case ID 和事件时间排序。最终将结果保存为 ariba_p2p_event_log.csv，即可上传至流程挖掘工具。

配置

API 应用：需在 SAP Ariba Developer Portal 注册应用，并为 'Analytical Reporting API' 开通访问权限。
报表视图模板：本方法依赖预置的报表视图。需在 Ariba 中配置该视图，将所需单据类型（采购申请、采购订单、收货单、服务单、发票）关联起来，并包含所有必需的日期和属性字段。
认证：脚本使用 OAuth 2.0 进行认证。您需要提供来自 Ariba 应用的有效 API Key、Client ID 和 Client Secret。
日期范围筛选：API 调用应基于采购订单创建日期（po.TimeCreated）添加过滤条件，以限定抽取范围。通常建议选择近 3 至 12 个月的数据，兼顾明细与性能。
Realm 名称：构建 API 端点需要贵公司的 Ariba Realm 名称。
API 端点：确保正确使用认证（api.ariba.com）与报表（[your-realm].ariba.com）的基础 URL。
数据粒度：可将报表视图配置为采购订单抬头级或行项目级，可按分析需要选择。

a 查询示例 python

import requests
import pandas as pd
import json
import time
import gzip
import io

class=class="hl-string">"hl-comment"># --- Configuration Settings --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Ariba Developer Portal application credentials
API_KEY = class="hl-string">'[Your_API_Key]'
CLIENT_ID = class="hl-string">'[Your_OAuth_Client_ID]'
CLIENT_SECRET = class="hl-string">'[Your_OAuth_Client_Secret]'

class=class="hl-string">"hl-comment"># Replace with your company's Ariba realm information
REALM = class="hl-string">'[Your_Company_Ariba_Realm]'

class=class="hl-string">"hl-comment"># Replace with the exact name of your pre-configured reporting view in Ariba
VIEW_TEMPLATE_NAME = class="hl-string">'[Your_P2P_View_Template]'

class=class="hl-string">"hl-comment"># --- API Endpoints --- #
AUTH_URL = class="hl-string">'https://api.ariba.com/v2/oauth/token'
API_BASE_URL = fclass="hl-string">'https://{REALM}.ariba.com/api/analytics-reporting-view/v1'

class=class="hl-string">"hl-comment"># --- Helper Functions --- #
def get_access_token():
    class="hl-string">"""Authenticates with Ariba and returns an access token."""
    auth_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(AUTH_URL, data=auth_payload)
        response.raise_for_status()
        return response.json()[class="hl-string">'access_token']
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        print(fclass="hl-string">"Response body: {response.text}")
        return None

def main():
    class="hl-string">"""Main function to run the extraction process."""
    access_token = get_access_token()
    if not access_token:
        return

    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY,
        class="hl-string">'Content-Type': class="hl-string">'application/json'
    }

    class=class="hl-string">"hl-comment"># Define the reporting job with filters
    report_job_payload = {
        class="hl-string">"viewTemplateName": VIEW_TEMPLATE_NAME,
        class="hl-string">"filters": {
            class="hl-string">"createdDateFrom": class="hl-string">"2023-01-01T00:00:00Z",
            class="hl-string">"createdDateTo": class="hl-string">"2023-12-31T23:59:59Z"
        },
        class="hl-string">"outputFormat": class="hl-string">"csv"
    }

    class=class="hl-string">"hl-comment"># 1. Submit the report generation job
    print(class="hl-string">"Submitting report job...")
    try:
        submit_response = requests.post(fclass="hl-string">'{API_BASE_URL}/jobs', headers=headers, json=report_job_payload)
        submit_response.raise_for_status()
        job_id = submit_response.json()[class="hl-string">'jobId']
        print(fclass="hl-string">"Job submitted successfully. Job ID: {job_id}")
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error submitting job: {e}")
        print(fclass="hl-string">"Response body: {submit_response.text}")
        return

    class=class="hl-string">"hl-comment"># 2. Poll for job completion
    while True:
        print(class="hl-string">"Checking job status...")
        try:
            status_response = requests.get(fclass="hl-string">'{API_BASE_URL}/jobs/{job_id}', headers=headers)
            status_response.raise_for_status()
            status = status_response.json()[class="hl-string">'status']
            print(fclass="hl-string">"Current job status: {status}")
            if status == class="hl-string">'COMPLETED':
                download_url = status_response.json()[class="hl-string">'downloadUrl']
                break
            elif status in [class="hl-string">'FAILED', class="hl-string">'NO_DATA']:
                print(fclass="hl-string">"Job finished with status: {status}")
                return
            time.sleep(30)  class=class="hl-string">"hl-comment"># Wait for 30 seconds before polling again
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error checking job status: {e}")
            return

    class=class="hl-string">"hl-comment"># 3. Download the report data
    print(fclass="hl-string">"Job completed. Downloading data from: {download_url}")
    try:
        download_headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}', class="hl-string">'apiKey': API_KEY}
        data_response = requests.get(download_url, headers=download_headers)
        data_response.raise_for_status()
        class=class="hl-string">"hl-comment"># Decompress the gzipped content
        gzip_file = gzip.GzipFile(fileobj=io.BytesIO(data_response.content))
        df_raw = pd.read_csv(gzip_file)
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error downloading data: {e}")
        return

    class=class="hl-string">"hl-comment"># 4. Transform data into event log
    print(class="hl-string">"Transforming data into event log format...")
    event_log = []

    class=class="hl-string">"hl-comment"># Rename columns for clarity, assuming view template field names like class="hl-string">'Purchase Order Id',
    class=class="hl-string">"hl-comment"># class="hl-string">'Requisition TimeCreated', class="hl-string">'PO ApprovedDate', etc. Adjust these to match your view template.
    class=class="hl-string">"hl-comment"># Placeholder names are used here.
    column_mapping = {
        class="hl-string">'[Purchase Order Id]': class="hl-string">'PurchaseOrderNumber',
        class="hl-string">'[Requisition TimeCreated]': class="hl-string">'pr_created_time',
        class="hl-string">'[Requisition ApprovedDate]': class="hl-string">'pr_approved_time',
        class="hl-string">'[PO TimeCreated]': class="hl-string">'po_created_time',
        class="hl-string">'[PO ApprovedDate]': class="hl-string">'po_approved_time',
        class="hl-string">'[PO LastModifiedDate]': class="hl-string">'po_changed_time',
        class="hl-string">'[PO OrderedDate]': class="hl-string">'po_sent_time',
        class="hl-string">'[PO ConfirmedDate]': class="hl-string">'po_confirmed_time',
        class="hl-string">'[ASN TimeCreated]': class="hl-string">'asn_received_time',
        class="hl-string">'[Receipt Date]': class="hl-string">'goods_receipt_time',
        class="hl-string">'[Service Sheet End Date]': class="hl-string">'service_confirmed_time',
        class="hl-string">'[Return Date]': class="hl-string">'goods_returned_time',
        class="hl-string">'[Invoice Date]': class="hl-string">'invoice_received_time',
        class="hl-string">'[PO CompletedDate]': class="hl-string">'po_completed_time',
        class="hl-string">'[PO CancelledDate]': class="hl-string">'po_cancelled_time',
        class="hl-string">'[PO Submitter]': class="hl-string">'UserName',
        class="hl-string">'[Department Name]': class="hl-string">'DepartmentName',
        class="hl-string">'[Vendor Name]': class="hl-string">'VendorName',
        class="hl-string">'[PO TotalAmount]': class="hl-string">'PurchaseOrderAmount',
        class="hl-string">'[PO DeliveryDate]': class="hl-string">'RequestedDeliveryDate',
        class="hl-string">'[Receipt Date]': class="hl-string">'GoodsReceiptDate'
    }
    df_raw.rename(columns=column_mapping, inplace=True)

    class=class="hl-string">"hl-comment"># Define activities and their corresponding timestamp columns
    activities = {
        class="hl-string">'Purchase Requisition Created': class="hl-string">'pr_created_time',
        class="hl-string">'Purchase Requisition Approved': class="hl-string">'pr_approved_time',
        class="hl-string">'Purchase Order Created': class="hl-string">'po_created_time',
        class="hl-string">'Purchase Order Approved': class="hl-string">'po_approved_time',
        class="hl-string">'Purchase Order Changed': class="hl-string">'po_changed_time',
        class="hl-string">'Purchase Order Sent To Vendor': class="hl-string">'po_sent_time',
        class="hl-string">'Vendor Confirmed Purchase Order': class="hl-string">'po_confirmed_time',
        class="hl-string">'Advance Ship Notice Received': class="hl-string">'asn_received_time',
        class="hl-string">'Goods Receipt Posted': class="hl-string">'goods_receipt_time',
        class="hl-string">'Services Confirmation Entered': class="hl-string">'service_confirmed_time',
        class="hl-string">'Goods Returned To Vendor': class="hl-string">'goods_returned_time',
        class="hl-string">'Invoice Received Against PO': class="hl-string">'invoice_received_time',
        class="hl-string">'Purchase Order Completed': class="hl-string">'po_completed_time',
        class="hl-string">'Purchase Order Cancelled': class="hl-string">'po_cancelled_time'
    }

    for index, row in df_raw.iterrows():
        base_event = {
            class="hl-string">'PurchaseOrderNumber': row.get(class="hl-string">'PurchaseOrderNumber'),
            class="hl-string">'UserName': row.get(class="hl-string">'UserName'),
            class="hl-string">'DepartmentName': row.get(class="hl-string">'DepartmentName'),
            class="hl-string">'VendorName': row.get(class="hl-string">'VendorName'),
            class="hl-string">'PurchaseOrderAmount': row.get(class="hl-string">'PurchaseOrderAmount'),
            class="hl-string">'RequestedDeliveryDate': row.get(class="hl-string">'RequestedDeliveryDate'),
            class="hl-string">'GoodsReceiptDate': row.get(class="hl-string">'GoodsReceiptDate')
        }

        for activity_name, time_col in activities.items():
            if time_col in row and pd.notna(row[time_col]):
                event = base_event.copy()
                event[class="hl-string">'ActivityName'] = activity_name
                event[class="hl-string">'EventTime'] = row[time_col]
                
                class=class="hl-string">"hl-comment"># Special handling for class="hl-string">'Purchase Order Changed'
                class=class="hl-string">"hl-comment"># This event should only be created if it's after the PO creation time
                if activity_name == class="hl-string">'Purchase Order Changed':
                    if pd.notna(row.get(class="hl-string">'po_created_time')) and pd.to_datetime(row[time_col]) > pd.to_datetime(row[class="hl-string">'po_created_time']):
                        event_log.append(event)
                else:
                    event_log.append(event)

    df_event_log = pd.DataFrame(event_log)
    df_event_log[class="hl-string">'EventTime'] = pd.to_datetime(df_event_log[class="hl-string">'EventTime'])
    df_event_log.sort_values(by=[class="hl-string">'PurchaseOrderNumber', class="hl-string">'EventTime'], inplace=True)

    class=class="hl-string">"hl-comment"># 5. Save the final event log
    output_filename = class="hl-string">'ariba_p2p_event_log.csv'
    df_event_log.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
    print(fclass="hl-string">"Event log successfully created and saved to {output_filename}")

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

数据模板：采购到付款—采购订单

你的采购到付款-采购订单数据模板

采购到付款—采购订单属性

采购到付款—采购订单活动

提取指南

SAP Ariba 分析报表 CSV/Excel 导出

步骤

配置

a 查询示例 config

使用 SAP Ariba Reporting API 的 Python 脚本

步骤

配置

a 查询示例 python

准备好开始了吗？

立即优化P2P中的采购订单环节！