您的费用管理数据模板

Coupa费用

← 返回改进指南

费用管理属性(20) 费用管理活动(13) 数据提取指南(2)

您的费用管理数据模板

这份完整的数据模板为您分析Coupa Expenses中的费用管理流程提供了清晰框架，列出需要采集的关键数据属性、需要跟踪的重要活动，以及数据提取的实用指导。使用此模板，确保收集到全面流程挖掘分析所需的信息。

全面采集数据时建议包含的属性
需要跟踪的关键费用管理活动
从Coupa Expenses提取数据的分步指南

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

下载模板

费用管理属性

以下是建议纳入事件日志的数据字段，可用于全面分析费用管理流程。

5 必填 7 建议填写 8 选填

	名称	说明
	事件时间 EventTime	表示活动或事件发生时间的时间戳。
说明事件时间是系统记录特定活动的准确日期和时间戳。它对于按时间顺序排列事件以及开展所有基于时间的分析至关重要，可为了解流程步骤的发生时间和持续时长提供事实依据。在流程挖掘中，此属性用于构建每个案例的时间线、计算活动间隔时长、发现延误并衡量整体周期时间。它对于分析绩效、评估服务级别协议的执行情况以及识别时间规律或瓶颈都十分重要。重要性此时间戳确定事件的先后顺序，是所有时长和绩效分析的基础，包括周期时间计算和瓶颈识别。获取途径此信息位于Coupa的审计跟踪表或事件日志表中，通常与活动或状态变更记录一同保存。示例 2023-10-26T10:00:00Z2023-10-26T14:35:10Z2023-10-27T09:15:00Z
	活动名称 ActivityName	费用报告在特定时间发生的业务事件名称。
说明活动名称用于描述费用管理流程中的具体步骤或里程碑，例如“费用报告已提交”“经理已批准”或“报销已执行”。这些活动构成流程图中的节点，也是分析流程路径、瓶颈和差异的基础。分析此属性有助于了解事件顺序、各流程步骤的发生频率及其转换情况。它是构建流程图、计算转换时间以及识别常见或不符合规范的流程路径的基础。重要性此属性定义流程中的步骤，支持流程路径的可视化与分析，这是流程挖掘的核心。获取途径通常取自Coupa中与费用报告对象关联的事件日志、状态变更记录或审计跟踪表。可能需要将状态代码或事件类型映射为便于用户理解的名称。示例费用报告已提交经理已批准财务已驳回报销已执行
	费用报告ID ExpenseReportId	费用报告的唯一标识符，用于汇总单次提交涉及的所有相关活动和费用。
说明费用报告ID是主要案例标识符，用于汇总单次费用提交涉及的所有事件和活动。每份费用报告在创建时都会分配一个唯一ID，以便按时间顺序完整追踪费用申报从初始录入到最终付款的全过程。在流程挖掘分析中，此ID对于还原每份费用报告的端到端流程至关重要。分析人员可以据此查看流程路径、识别处理路径中的差异，并计算单笔申报的案例级指标，例如总周期时间和返工循环。重要性这是关联单笔费用申报所有相关事件的关键，可用于分析从开始到结束的完整流程。获取途径这是Coupa费用报告对象中的主键，通常在Expense Reports API端点或底层表中以'id'或'report-id'的形式出现。示例 ER-0012345ER-0012399ER-0013001
	上次数据更新 LastDataUpdate	上次从源系统刷新或提取数据的时间戳。
说明此属性记录上次从Coupa Expenses提取数据并加载到流程挖掘工具的日期和时间，用于说明所分析数据的新鲜度。用户可据此了解分析结果的时效性，以及仪表板是否反映当前运营情况。这也是数据治理和确保分析结果可信的重要元数据。重要性说明数据的更新时间，帮助用户了解分析所覆盖的时间范围，并判断结果是否仍具参考价值。获取途径此时间戳通常由数据提取工具或ETL工具在数据成功加载后生成并保存。示例 2024-05-21T02:00:00Z2024-05-22T02:00:00Z
	源系统 SourceSystem	数据的来源系统。
说明此属性标识生成事件数据的源应用。在此场景中，源应用为“Coupa Expenses”。它对于数据治理以及在多系统流程视图中区分不同系统的数据十分重要。此属性说明数据来源，在分析跨多个应用的流程时可提供必要背景。重要性提供数据来源的关键信息，对于数据治理、验证和多系统流程分析至关重要。获取途径通常在数据提取和转换过程中添加固定值，用于标记数据集的来源。示例 Coupa费用Coupa
	员工部门 EmployeeDepartment	提交费用报告的员工所属部门。
说明此属性表示费用报告提交人所属的组织部门或业务单元，通常取自员工主数据。这是重要的分析维度，可用于比较组织不同部门的流程绩效。按部门分析审批时间、拒绝率或政策违规情况的仪表板会大量使用此属性，以发现需要改进流程或开展针对性培训的领域。重要性支持比较不同部门的绩效，帮助识别哪些部门运作顺畅，哪些部门可能需要支持。获取途径可从Coupa中的提交用户资料获取，也可通过用户ID与外部HR主数据系统关联。请查找用户对象中的'department'字段。示例销售市场营销工程财务
	总金额 TotalAmount	费用报告的货币总额。
说明此属性表示报告中所有费用行的总和，是了解流程中涉及金额的重要财务指标。分析总金额有助于按金额区间划分费用报告，不同区间可能对应不同的审批路径或审查级别。仪表板可用此属性分析支出模式、识别可能造成瓶颈的高金额报告，并分析报告金额与处理时间或拒绝率之间的关系。重要性为流程分析提供财务背景，支持按费用报告金额开展分析，因为金额往往会影响审批路径和处理优先级。获取途径这是Coupa费用报告表头中的标准字段，通常名为'total'或'total-amount'。示例 150.752500.0085.50
	拒绝原因 RejectionReason	审批人拒绝费用报告时填写的原因。
说明经理或财务团队成员拒绝费用报告时，通常会填写原因。此属性记录该原因，内容可能来自预设列表，也可能是自由文本。此属性对于根因分析很有价值。通过分析常见拒绝原因，组织可以发现政策说明不清、员工需要更多培训或提交流程存在问题的领域。这有助于减少返工并提高一次审批通过率。重要性直接说明返工原因，为通过针对性培训、明确政策或改进流程来降低拒绝率提供可执行的依据。获取途径此信息通常记录在Coupa中与拒绝事件关联的审计跟踪或评论中，可能位于专用字段，也可能需要从评论中提取。示例缺少收据费用不符合政策费用类别错误重复提交
	政策违规标记 PolicyViolationFlag	布尔标记；费用报告因违反政策而被标记时为true。
说明 Coupa可以自动标记违反公司政策的费用，例如超出支出限额或使用未经批准的供应商。此属性以true或false表示费用报告是否检测到此类违规。此标记对于合规监控和分析至关重要。借助此属性，可以创建仪表板，跟踪政策违规率随时间和部门的变化。还可以比较违规报告与符合政策的报告在处理方式上的差异，例如前者是否审批耗时更长或更常被拒绝。重要性支持直接衡量和分析政策执行情况，帮助发现并处理风险较高或经常不遵守政策的领域。获取途径此属性通常以标记或状态的形式记录在Coupa的费用报告或单项费用行中，往往由系统规则引擎设置。示例 truefalse
	用户名 UserName	执行活动的员工或用户姓名。
说明此属性标识与特定事件相关的人员，例如提交、批准或拒绝费用报告的人。其值可以是姓名、员工ID或系统用户账户。按用户分析流程有助于发现绩效规律、工作量分布和潜在培训需求。按资源细分指标的仪表板也会用到此属性，例如比较不同经理的审批时间。重要性将活动关联到具体人员，以便分析流程中的工作量、绩效和人员行为。获取途径此信息通常位于Coupa Expenses的审计跟踪表中，并与各事件或操作关联。可查找'user-id'、'submitted-by'或'updated-by'等字段。示例 John Smithjsmith11023
	结束时间 EndTime	表示活动完成时间的时间戳。
说明结束时间表示活动结束的时刻。在许多事务系统中，活动是瞬时事件，因此结束时间与开始时间相同。但对于有明确持续时长的活动，此属性记录其完成时间。此字段对于准确计算单项活动的处理时间至关重要，可更准确地分析流程中各环节的耗时，帮助区分等待时间与实际工作时间。重要性支持准确计算活动时长，对于识别和分析具体任务的耗时与等待时间至关重要。获取途径对于瞬时事件，此值通常与开始时间（EventTime）相同。对于持续性活动，可能需要从单独字段获取，或根据下一事件的时间戳推算。示例 2023-10-26T10:00:00Z2023-10-26T14:35:10Z2023-10-27T09:15:00Z
	费用报告状态 ExpenseReportStatus	费用报告当前或最终状态。
说明此属性表示费用报告生命周期结束时的整体状态，例如“已批准”“已付款”“已拒绝”或“已撤回”，用于明确每个案例的最终结果。分析时，可按最终状态筛选已完成的案例并对结果分类。此属性对于计算拒绝率等指标以及了解报告最终进入各状态的比例至关重要，也有助于发现停留在中间状态的报告。重要性定义每个案例的结果，是按结果开展分析的基础，例如比较已批准与已拒绝报告的流程路径。获取途径这是Coupa费用报告对象中的主要状态字段，位于表头数据中，并会在流程中持续更新。示例 pending_approvalapprovedpaidrejected
	国家/地区 Country	提交员工所在国家/地区或交易发生地。
说明此属性表示与费用报告相关的国家/地区，通常是提交员工的常驻国家/地区，是分析全球组织流程的重要维度。按国家/地区分析流程有助于比较不同地区的绩效、合规情况和流程差异，从而发现需要处理的地区法规、政策或运营效率差异。重要性支持比较不同地区的流程绩效和合规情况，对全球组织至关重要。获取途径此属性可从Coupa中的用户资料或费用报告关联的法人实体信息中获取。示例 USADEUGBRJPN
	审批人姓名 ApproverName	批准或拒绝费用报告的经理或财务用户姓名。
说明此属性标识参与经理审批或财务审批的具体审批人，与报告提交人不同。此数据有助于分析审批人的绩效和行为。按个人衡量审批周期时间，可以发现因个别审批人工作量过大或需要额外培训而造成的瓶颈。此属性也支持旨在平衡工作量、提高审批效率的仪表板。重要性将延误或较高拒绝率关联到具体审批人，帮助定位审批环节中的瓶颈并采取针对性措施。获取途径可在Coupa费用报告的审批历史或审计跟踪中找到。每个审批步骤都应记录执行操作的用户。示例 Sarah ChenDavid Rodriguez财务团队队列
	币种 Currency	费用报告总金额所用的币种代码。
说明此属性说明费用报告总金额所用的币种，例如USD、EUR或GBP，是财务数据不可缺少的背景信息。分析全球组织的费用时，此字段对于正确解读和汇总金额至关重要。为便于比较不同地区的数据，分析时可能需要将所有金额换算为同一种基准币种。重要性为金额提供必要背景，确保财务分析准确，并支持全球报告中的币种换算。获取途径这是Coupa费用报告表头中的标准字段，通常与总金额字段并列，名称可能为'currency-code'。示例 USDEURGBPJPY
	成本中心 CostCenter	费用分配到的成本中心。
说明成本中心是用于会计和预算管理的财务维度，表示由组织的哪个部分承担费用。它可能与提交人的所属部门不同。按成本中心分析可从财务会计角度了解流程，并按特定预算或财务单元跟踪支出和流程效率。这对于希望了解和管理组织支出的财务部门尤为重要。重要性提供重要的财务分析维度，使流程指标能够直接关联到财务和预算单元。获取途径这是Coupa中的标准会计字段，位于费用报告表头或费用行中，通常属于会计科目表结构的一部分。示例 CC4510-市场营销CC2100-工程CC7800-东区销售
	政策违规原因 PolicyViolationReason	费用报告被标记为违反政策的具体原因。
说明发现政策违规时，此属性会说明具体原因，例如“金额超出限额”或“商户未经批准”，提供比简单布尔标记更详细的信息。分析政策违规原因有助于更细致地了解合规问题，并找出经常被违反的具体政策。这可能意味着需要加强沟通、调整政策或严格执行相关规定，是制定有效合规改进策略的重要依据。重要性详细说明合规问题，便于采取有针对性的措施，推动员工遵守公司费用政策。获取途径此信息通常位于Coupa合规引擎生成的政策标记详情或警告消息中。示例超出每日餐费限额费用重复需要提供收据
	是否一次审批通过 IsFirstPassApproval	费用报告未经拒绝或修改即获批准时，此标记为true。
说明这是案例级计算属性，用于表示费用报告是否在首次审批时顺利通过。如果案例中没有拒绝或“退回修改”活动，则设为'true'。此属性直接衡量提交和审批流程的效率，也是一次审批通过率KPI的计算依据。分析与一次审批通过率偏低相关的因素，例如部门或费用类别，可为流程改进提供有价值的见解。重要性清晰衡量流程质量和效率，帮助计算无需返工即可完成处理的报告比例。获取途径在案例级别计算。需要扫描指定ExpenseReportId的所有活动，检查是否存在拒绝或修改事件。示例 truefalse
	是否返工 IsRework	用于标记某项活动是否属于返工循环，例如报告被退回修改。
说明此布尔计算属性用于标记代表返工的活动。对于“退回修改”等事件，或同一案例中此类事件之后发生的活动，通常将其设为'true'。识别返工是流程挖掘的主要目标之一。此标记便于直接筛选和汇总返工情况，可用于计算返工率、在流程图中展示返工循环，并分析导致流程重复执行步骤的根本原因。重要性直接标记低效的返工循环，便于量化其发生频率、对周期时间的影响及根本原因。获取途径根据流程路径计算此属性。需要应用相应逻辑，识别表示流程返回到较早阶段的活动，例如“退回修改”。示例 truefalse
	费用类别 ExpenseCategory	费用类别，例如差旅、餐饮或办公用品。
说明此属性用于对申报费用的类型进行分类。费用报告通常包含多条费用行，每行都有自己的类别。进行案例级分析时，可使用最常见的类别或汇总后的类别列表。按费用类别划分流程，可以发现不同类别对应的行为差异或瓶颈。例如，差旅费用的审批路径可能比办公用品采购更复杂。此维度有助于了解费用性质如何影响处理流程。重要性按支出类型划分流程，有助于发现特定类别的瓶颈、政策要求或审批路径。获取途径此信息存储在Coupa的费用行中。进行案例级分析时，需要汇总，例如采用金额最高的费用行类别。示例机票餐饮和娱乐软件办公用品

必填建议填写选填

费用管理活动

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

6 建议填写 7 选填

	活动	说明
	会计已入账	与费用报告相关的财务交易已记入总账。从财务会计角度看，这是流程的最后一步。
重要性这是最后一项活动，标志着流程真正结束。从报销到记账所需的时间对快速、准确地完成财务结账至关重要。获取途径此事件取自费用报告关联的日记账分录或会计行的记账日期，由Coupa的会计集成进行管理。采集取自费用报告相关会计行中的记账日期字段。事件类型 explicit
	报销已执行	付款已成功处理，款项已发放给员工。此事件确认员工已收到款项，并标志报销流程完成。
重要性这是影响员工满意度的关键节点，也是平均报销周期时间这一关键绩效指标的终点。获取途径从与费用报告关联的付款记录中的付款执行日期获取，通常来自Coupa Pay或集成的应付账款系统。采集从与费用报告关联的付款记录中的付款日期获取。事件类型 explicit
	经理已批准	员工的直属经理或第一层审批人批准费用报告。报告审批历史中会明确记录此事件及其时间戳。
重要性标志第一层审批完成。分析到达此事件所需的时间，有助于衡量审批周期时间这一关键绩效指标，并识别经理层级的瓶颈。获取途径从Coupa费用报告详细审批历史或审计轨迹中审批操作对应的时间戳获取。采集从费用报告审批历史日志中的审批事件时间戳获取。事件类型 explicit
	财务已批准	财务或审计团队最终批准费用报告。此事件表明报告已通过验证，可以进入付款处理阶段，并记录在审批历史中。
重要性这是最终审批节点。从经理批准到财务批准的时长，是整体审批周期的重要组成部分。获取途径从费用报告详细审批历史或审计轨迹中最终审批操作对应的时间戳获取。采集从费用报告审批历史中的最终审批事件时间戳获取。事件类型 explicit
	费用报告已创建	标志费用报告生命周期的开始。用户首次创建并保存新的费用报告时，系统会记录此事件，报告进入草稿状态。
重要性这是所有流程分析的起点，对于衡量费用报告的端到端总周期时间至关重要。获取途径这是从费用报告创建时间戳中直接获取的事件。数据来源为Coupa费用报告表头记录中的“created_at”时间戳。采集使用费用报告对象的创建时间戳。事件类型 explicit
	费用报告已提交	员工正式提交已完成的费用报告以供审批。此操作会使报告从草稿状态转为待审批状态，系统会明确记录该事件。
重要性这是一个关键节点，标志着审批计时开始。从创建到提交的时长，反映员工准备报告所需的时间。获取途径从费用报告记录中的提交时间戳，或提交事件对应的审计轨迹日志条目中获取。采集使用费用报告中的“submitted_at”时间戳字段。事件类型 explicit
	已安排报销	最终审批完成后，费用报告会被归入付款批次以便付款。这标志着流程从审批阶段转入付款处理阶段。
重要性此活动标志着报销执行周期时间开始计时。此处的延迟表明已批准报告转入付款系统时出现积压。获取途径可根据状态变为“待付款”，或报告与Coupa Pay中的付款批次记录关联的日期推断。采集状态变为“待付款”时的时间戳，或相关付款批次的创建日期。事件类型 inferred
	已执行政策检查	系统执行公司费用政策合规自动检查。通常可根据报告首次出现政策违规标记或警告的时间戳推断此活动。
重要性这是政策合规概览仪表板的重要数据。它有助于了解流程中是否以及何时发现违规，以及违规对审批时间的影响。获取途径根据费用明细或报告表头上应用政策违规标记的相关时间戳推断。采集费用报告或其明细首次出现政策违规标记时的时间戳。事件类型 inferred
	已退回修改	审批人将报告退回员工修改，但未作出最终驳回决定。此操作会形成返工循环，可根据状态变化或特定审计轨迹事件推断。
重要性此活动是分析返工循环的关键。找出报告被退回的原因，有助于改进培训并提高首次审批通过率。获取途径可根据状态变为“待更正”或“已退回”等情况推断。Coupa也可能在审批历史中明确记录此操作。采集状态变为“需要修改”时的时间戳，或审计日志中的特定事件时间戳。事件类型 inferred
	已附上收据	表示用户将收据上传或附加到报告中的费用明细。可通过观察与费用报告关联的附件记录创建情况来捕获此活动。
重要性分析此活动发生的时间和频率，有助于了解用户行为模式，并发现因缺少凭证而造成的潜在延迟。获取途径根据与特定费用报告ID关联的附件记录创建时间戳推断。采集识别附件记录与费用报告关联时的时间戳。事件类型 inferred
	经理已驳回	员工的经理驳回费用报告，通常会中止流程并将报告退回员工。审批历史中会将此记录为特定事件。
重要性这是一个反映流程阻力的负面结果。分析此类事件对于费用报告驳回率仪表板和关键绩效指标至关重要。获取途径从费用报告审批历史或审计轨迹中驳回操作对应的时间戳获取。采集从费用报告审批历史日志中的驳回事件时间戳获取。事件类型 explicit
	财务已驳回	财务或审计团队驳回费用报告，这是流程最终的负面结果。报告历史中会记录最终驳回状态。
重要性跟踪财务驳回有助于发现早期审核未能识别的严重合规或凭证问题，并分析其对驳回率关键绩效指标的影响。获取途径从费用报告审计轨迹中财务审批人执行驳回操作时的时间戳获取。采集从财务审核步骤审计轨迹中的驳回事件时间戳获取。事件类型 explicit
	费用报告已撤回	员工在费用报告完全获批前撤回已提交的报告。此操作会取消当前审批流程，系统会明确记录该事件。
重要性跟踪员工自行更正或取消提交的情况，这可能反映他们对流程存在疑惑，也属于流程中断的一种。获取途径用户执行明确的撤回操作后，报告状态变为“已撤回”或“已取消”，并记录在审计轨迹中。采集从费用报告审计轨迹中“撤回”操作的时间戳获取。事件类型 explicit

建议填写选填

数据提取指南

如何从Coupa Expenses获取数据

步骤

前提条件：您需要拥有Coupa用户账户，并具备访问和配置定时导出所需的权限，通常为管理员或集成专员角色。您还需要有权访问SFTP服务器，以便Coupa将导出文件传输到该服务器。
进入定时导出：登录Coupa实例。打开“Setup”菜单，在“Integrations”部分中点击“Scheduled Exports”。
配置费用报销单导出：点击“Create”按钮，为“Expense Report”对象配置第一项导出。为其设置易于识别的名称，例如“ProcessMind_Expense_Reports”。选择“CSV”格式。在“Fields”部分选择所需列，例如id、created-at、submitted-at、updated-at、status、total、user-id及其他相关报销单属性。
配置审批历史导出：为“Expense Report Approval”对象创建第二项定时导出，命名为“ProcessMind_Expense_Approvals”。包含id、created-at、updated-at、status、approver-id和expense-report-id等字段。此对象对于记录审批、拒绝和修改事件至关重要。
配置附件导出：为“Expense Report Attachment”对象创建第三项导出，命名为“ProcessMind_Expense_Attachments”。包含created-at时间戳以及关联的expense-report-id或expense-line-id，以跟踪收据的添加时间。
配置付款发票导出：为“Invoice from Expense Report”对象创建第四项导出，命名为“ProcessMind_Expense_Invoices”。此项导出用于跟踪报销和会计事件。包含expense-report-id、paid-date、scheduled-payment-date、exported和updated-at等字段。
设置传输方式和计划：对每项导出，打开“Delivery”选项卡，填写SFTP服务器连接信息，包括主机、用户名和目录路径。设置身份验证方式，通常使用密码或密钥。在“Schedule”选项卡中，将频率设为“Daily”，以定期获取更新。
运行并导入导出文件：激活计划；如有需要，首次手动运行。设置自动化流程，例如ETL脚本或数据仓库导入工具，从SFTP服务器获取CSV文件并加载到暂存数据库。
将数据转换为事件日志：对暂存数据运行转换脚本，例如提供的SQL查询。该脚本会合并不同表（报销单、审批、发票）中的数据，生成统一的事件日志表。
导出供ProcessMind使用：将数据库或数据仓库中的事件日志表导出为单个CSV文件。确保列标题符合所需属性，例如ExpenseReportId、ActivityName和EventTime。现在即可将文件上传到流程挖掘工具。

配置

前提条件：需要启用Coupa Expenses模块。配置导出的用户必须拥有“Scheduled CSV Exports”权限。还需准备SFTP服务器，并在必要时将其IP地址加入白名单。
Coupa关键对象：数据提取依赖于以下标准Coupa数据对象的定时导出：“Expense Report”、“Expense Report Approval”、“Expense Report Attachment”和“Invoice from Expense Report”。
SFTP配置：您需要提供SFTP服务器URL、端口（通常为22）、专用用户凭据和文件存放目录。请在Coupa界面中测试连接，确保连接成功。
日期范围和筛选：定时导出通常仅导出自上次成功运行以来新建或更新的记录。首次加载历史数据时，可设置特定的created-at或updated-at日期范围，覆盖所需时段，例如过去6到12个月。
文件格式：建议始终使用CSV格式，便于处理且兼容大多数数据处理工具。
计划频率：建议每天导出一次，以确保流程挖掘所用数据及时更新。在非高峰时段运行，可尽量减少对系统性能的影响。

查询示例 sql

WITH last_update AS (
  SELECT CURRENT_TIMESTAMP AS last_data_update
)
SELECT
  er.id AS ExpenseReportId,
  'Expense Report Created' AS ActivityName,
  er."created-at" AS EventTime,
  er."updated-at" AS EndTime,
  u.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_reports er
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu

UNION ALL

SELECT
  er.id AS ExpenseReportId,
  'Receipts Attached' AS ActivityName,
  att."created-at" AS EventTime,
  att."updated-at" AS EndTime,
  u.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_report_attachments att
JOIN stg_expense_reports er ON att.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu

UNION ALL

SELECT
  er.id AS ExpenseReportId,
  'Expense Report Submitted' AS ActivityName,
  er."submitted-at" AS EventTime,
  er."updated-at" AS EndTime,
  u.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_reports er
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu
WHERE er."submitted-at" IS NOT NULL

UNION ALL

SELECT
  era.expense_report_id AS ExpenseReportId,
  'Manager Approved' AS ActivityName,
  era."updated-at" AS EventTime,
  era."updated-at" AS EndTime,
  approver.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_report_approvals era
JOIN stg_expense_reports er ON era.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
LEFT JOIN stg_users approver ON era.approver_id = approver.id
CROSS JOIN last_update lu
WHERE era.status = 'approved' AND approver.role LIKE '%Manager%'

UNION ALL

SELECT
  era.expense_report_id AS ExpenseReportId,
  'Manager Rejected' AS ActivityName,
  era."updated-at" AS EventTime,
  era."updated-at" AS EndTime,
  approver.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  era.reason AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_report_approvals era
JOIN stg_expense_reports er ON era.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
LEFT JOIN stg_users approver ON era.approver_id = approver.id
CROSS JOIN last_update lu
WHERE era.status = 'rejected' AND approver.role LIKE '%Manager%'

UNION ALL

SELECT
  era.expense_report_id AS ExpenseReportId,
  'Sent Back For Revision' AS ActivityName,
  era."updated-at" AS EventTime,
  era."updated-at" AS EndTime,
  approver.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  era.reason AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_report_approvals era
JOIN stg_expense_reports er ON era.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
LEFT JOIN stg_users approver ON era.approver_id = approver.id
CROSS JOIN last_update lu
WHERE era.status = 'sent_back'

UNION ALL

SELECT
  er.id AS ExpenseReportId,
  'Policy Check Performed' AS ActivityName,
  er."updated-at" AS EventTime,
  er."updated-at" AS EndTime,
  'System' AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_reports er
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu
WHERE er.has_policy_violations = TRUE

UNION ALL

SELECT
  era.expense_report_id AS ExpenseReportId,
  'Finance Approved' AS ActivityName,
  era."updated-at" AS EventTime,
  era."updated-at" AS EndTime,
  approver.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_report_approvals era
JOIN stg_expense_reports er ON era.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
LEFT JOIN stg_users approver ON era.approver_id = approver.id
CROSS JOIN last_update lu
WHERE era.status = 'approved' AND approver.role LIKE '%Finance%'

UNION ALL

SELECT
  era.expense_report_id AS ExpenseReportId,
  'Finance Rejected' AS ActivityName,
  era."updated-at" AS EventTime,
  era."updated-at" AS EndTime,
  approver.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  era.reason AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_report_approvals era
JOIN stg_expense_reports er ON era.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
LEFT JOIN stg_users approver ON era.approver_id = approver.id
CROSS JOIN last_update lu
WHERE era.status = 'rejected' AND approver.role LIKE '%Finance%'

UNION ALL

SELECT
  er.id AS ExpenseReportId,
  'Expense Report Withdrawn' AS ActivityName,
  er."updated-at" AS EventTime,
  er."updated-at" AS EndTime,
  u.full_name AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_expense_reports er
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu
WHERE er.status = 'withdrawn'

UNION ALL

SELECT
  inv.expense_report_id AS ExpenseReportId,
  'Reimbursement Scheduled' AS ActivityName,
  inv.scheduled_payment_date AS EventTime,
  inv.updated_at AS EndTime,
  'System' AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_invoices_from_expense_reports inv
JOIN stg_expense_reports er ON inv.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu
WHERE inv.scheduled_payment_date IS NOT NULL

UNION ALL

SELECT
  inv.expense_report_id AS ExpenseReportId,
  'Reimbursement Executed' AS ActivityName,
  inv.paid_date AS EventTime,
  inv.updated_at AS EndTime,
  'System' AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_invoices_from_expense_reports inv
JOIN stg_expense_reports er ON inv.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu
WHERE inv.paid_date IS NOT NULL

UNION ALL

SELECT
  inv.expense_report_id AS ExpenseReportId,
  'Accounting Posted' AS ActivityName,
  inv.updated_at AS EventTime,
  inv.updated_at AS EndTime,
  'System' AS UserName,
  u.department_name AS EmployeeDepartment,
  er.total AS TotalAmount,
  er.status AS ExpenseReportStatus,
  NULL AS RejectionReason,
  er.has_policy_violations AS PolicyViolationFlag,
  'Coupa' AS SourceSystem,
  lu.last_data_update AS LastDataUpdate
FROM stg_invoices_from_expense_reports inv
JOIN stg_expense_reports er ON inv.expense_report_id = er.id
LEFT JOIN stg_users u ON er.user_id = u.id
CROSS JOIN last_update lu
WHERE inv.exported = TRUE;

步骤

前提条件和环境设置：确保已安装Python 3.6或更高版本。在终端运行pip install pandas requests，安装用于数据处理的pandas和用于发送API请求的requests。您还需要向Coupa管理员申请API密钥，并确保该密钥对费用报销单、费用明细、附件和审批具有读取权限。
生成Coupa API密钥：登录Coupa实例。依次进入Setup > Company Setup > API Keys。创建新的API密钥，并确保其具有所需费用模块的读取权限。请妥善保管该密钥，因为它可以访问公司的数据。
初始化Python脚本：新建Python文件，导入所需库（requests、pandas、datetime）。定义全局常量，包括Coupa实例URL（例如https://[your_company].coupahost.com）、API密钥以及API身份验证所需的请求头。
设置日期范围和API参数：指定数据提取的起止日期，并在API请求中将其用作筛选条件，以控制数据量。同时设置分页上限，Coupa每次请求通常返回50条记录。
获取费用报销单表头：编写函数，获取指定日期范围内的所有费用报销单表头。该函数应通过重复调用/api/expense_reports端点处理分页，每次递增offset参数，直到获取全部报销单。将表头数据存入列表。
遍历并获取详细数据：遍历上一步获取的每个费用报销单表头，分别调用API获取相关详情：通过/api/expense_reports/{id}/approvals获取审批记录，通过/api/expense_reports/{id}/attachments获取附件。这些详情对于构建完整事件日志至关重要。
构建事件日志：创建一个空列表，用于存放事件日志记录。处理每份费用报销单及其详细数据时，将原始API响应转换为标准化的事件日志行。针对13项必需活动，分别创建代表单个事件的字典并添加到列表。例如，使用created-at字段记录“费用报销单已创建”事件，并遍历审批数据，生成“经理已批准”或“财务已拒绝”等事件。
将API数据映射到属性：在转换逻辑中，将Coupa API响应中的JSON字段映射到必需和建议的属性。例如，将id映射到ExpenseReportId，将created-at映射到EventTime，将total映射到TotalAmount。从嵌套的用户对象中提取用户和部门信息。
处理推断事件：某些活动（如“已安排报销”或“已记账”）需要根据状态变化推断。使用报销单的status字段和updated-at时间戳生成这些事件。例如，状态变为“processing_payment”时，可记录为“已安排报销”活动。
创建并导出DataFrame：处理完所有费用报销单并填充事件列表后，将列表转换为pandas DataFrame。添加SourceSystem和LastDataUpdate等静态列。最后使用to_csv方法将DataFrame导出为CSV文件，并确保index设为False。现在即可将该CSV文件上传到ProcessMind。

配置

API密钥权限：用于身份验证的API密钥必须至少具有以下Coupa对象的只读权限：费用报销单、费用明细、用户、审批和附件。
Coupa实例URL：您需要提供公司Coupa实例的基础URL（例如https://your-company.coupahost.com）。所有API端点请求均以此为根地址。
日期范围筛选：必须按指定时段筛选数据，以控制性能和数据量。使用created-at[gt]（大于）和created-at[lt]（小于）查询参数。通常可先提取3到6个月的数据。
分页上限：Coupa API限制单次请求返回的记录数，通常为50条。脚本必须处理此limit，并使用offset参数获取后续所有数据页。
状态筛选：如需进一步缩小提取范围，可在初始报销单表头查询中添加status筛选条件。例如，仅提取状态为“approved”、“paid”或“denied”的报销单。
性能注意事项：脚本会针对每份费用报销单发起多次API请求。如果实例中有数万份报销单，提取可能耗时较长。建议在非高峰时段运行脚本，或根据updated-at时间戳采用增量加载策略。

查询示例 python

import requests
import pandas as pd
import datetime
import time

class=class="hl-string">"hl-comment"># --- Configuration Settings ---
class=class="hl-string">"hl-comment"># Replace with your Coupa instance URL and API Key
COUPA_URL = class="hl-string">"https://[your_company].coupahost.com"
API_KEY = class="hl-string">"[your_api_key]"

class=class="hl-string">"hl-comment"># Define the date range for the extraction
class=class="hl-string">"hl-comment"># Format: YYYY-MM-DDTHH:MM:SSZ (UTC)
START_DATE = class="hl-string">"2023-01-01T00:00:00Z"
END_DATE = class="hl-string">"2023-12-31T23:59:59Z"

class=class="hl-string">"hl-comment"># API request headers
HEADERS = {
    class="hl-string">"Accept": class="hl-string">"application/json",
    class="hl-string">"X-COUPA-API-KEY": API_KEY
}

class=class="hl-string">"hl-comment"># Static values for the event log
SOURCE_SYSTEM = class="hl-string">"Coupa Expenses"
LAST_DATA_UPDATE = datetime.datetime.utcnow().isoformat() + class="hl-string">'Z'

def get_paginated_data(endpoint, params):
    class="hl-string">"""Helper function to fetch all pages for a given API endpoint."""
    all_data = []
    offset = 0
    limit = 50
    while True:
        params[class="hl-string">'offset'] = offset
        params[class="hl-string">'limit'] = limit
        try:
            response = requests.get(endpoint, headers=HEADERS, params=params)
            response.raise_for_status() class=class="hl-string">"hl-comment"># Raises an HTTPError for bad responses (4xx or 5xx)
            data = response.json()
            if not data:
                break
            all_data.extend(data)
            offset += limit
        except requests.exceptions.RequestException as e:
            print(fclass="hl-string">"Error fetching data from {endpoint}: {e}")
            break
    return all_data

def main():
    class="hl-string">"""Main function to extract, transform, and save expense data."""
    print(class="hl-string">"Starting expense report extraction...")
    event_log = []

    class=class="hl-string">"hl-comment"># 1. Fetch all expense report headers in the date range
    reports_endpoint = fclass="hl-string">"{COUPA_URL}/api/expense_reports"
    reports_params = {
        class="hl-string">"created-at[gt]": START_DATE,
        class="hl-string">"created-at[lt]": END_DATE,
        class="hl-string">"fields": class="hl-string">"["idclass="hl-string">", "created-atclass="hl-string">", "updated-atclass="hl-string">", "submitted-atclass="hl-string">", "withdrawn-atclass="hl-string">", "statusclass="hl-string">", "totalclass="hl-string">", "userclass="hl-string">", "exportedclass="hl-string">", "expense-linesclass="hl-string">", "policy-violationsclass="hl-string">"]"
    }
    expense_reports = get_paginated_data(reports_endpoint, reports_params)

    print(fclass="hl-string">"Found {len(expense_reports)} expense reports to process.")

    class=class="hl-string">"hl-comment"># 2. Process each expense report to create events
    for i, report in enumerate(expense_reports):
        print(fclass="hl-string">"Processing report {i+1}/{len(expense_reports)}: ID {report['id']}")
        
        class=class="hl-string">"hl-comment"># Common attributes for all events of this case
        base_event = {
            class="hl-string">'ExpenseReportId': report[class="hl-string">'id'],
            class="hl-string">'TotalAmount': float(report.get(class="hl-string">'total', 0.0)),
            class="hl-string">'ExpenseReportStatus': report.get(class="hl-string">'status'),
            class="hl-string">'EmployeeDepartment': report.get(class="hl-string">'user', {}).get(class="hl-string">'department', {}).get(class="hl-string">'name') if report.get(class="hl-string">'user', {}).get(class="hl-string">'department') else None,
            class="hl-string">'SourceSystem': SOURCE_SYSTEM,
            class="hl-string">'LastDataUpdate': LAST_DATA_UPDATE,
            class="hl-string">'EndTime': None, class=class="hl-string">"hl-comment"># EndTime can be populated if duration is meaningful
            class="hl-string">'RejectionReason': None, class=class="hl-string">"hl-comment"># Will be populated by rejection events
            class="hl-string">'PolicyViolationFlag': bool(report.get(class="hl-string">'policy-violations'))
        }

        class=class="hl-string">"hl-comment"># Event: Expense Report Created
        event_log.append({
            **base_event,
            class="hl-string">'ActivityName': class="hl-string">'Expense Report Created',
            class="hl-string">'EventTime': report[class="hl-string">'created-at'],
            class="hl-string">'UserName': report.get(class="hl-string">'user', {}).get(class="hl-string">'fullname')
        })
        
        class=class="hl-string">"hl-comment"># Event: Expense Report Submitted
        if report.get(class="hl-string">'submitted-at'):
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Expense Report Submitted',
                class="hl-string">'EventTime': report[class="hl-string">'submitted-at'],
                class="hl-string">'UserName': report.get(class="hl-string">'user', {}).get(class="hl-string">'fullname')
            })

        class=class="hl-string">"hl-comment"># Event: Expense Report Withdrawn
        if report.get(class="hl-string">'withdrawn-at'):
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Expense Report Withdrawn',
                class="hl-string">'EventTime': report[class="hl-string">'withdrawn-at'],
                class="hl-string">'UserName': report.get(class="hl-string">'user', {}).get(class="hl-string">'fullname')
            })
        
        class=class="hl-string">"hl-comment"># Event: Policy Check Performed (inferred)
        if base_event[class="hl-string">'PolicyViolationFlag']:
             event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Policy Check Performed',
                class="hl-string">'EventTime': report[class="hl-string">'updated-at'], class=class="hl-string">"hl-comment"># Using updated-at as a proxy timestamp
                class="hl-string">'UserName': class="hl-string">'System'
            })

        class=class="hl-string">"hl-comment"># 3. Fetch attachments for class="hl-string">'Receipts Attached' event
        attachments_endpoint = fclass="hl-string">"{COUPA_URL}/api/expense_reports/{report['id']}/attachments"
        attachments = get_paginated_data(attachments_endpoint, {})
        if attachments:
            first_attachment_time = min(att[class="hl-string">'created-at'] for att in attachments if class="hl-string">'created-at' in att)
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Receipts Attached',
                class="hl-string">'EventTime': first_attachment_time,
                class="hl-string">'UserName': report.get(class="hl-string">'user', {}).get(class="hl-string">'fullname')
            })

        class=class="hl-string">"hl-comment"># 4. Fetch approvals for approval/rejection events
        approvals_endpoint = fclass="hl-string">"{COUPA_URL}/api/expense_reports/{report['id']}/approvals"
        approvals = get_paginated_data(approvals_endpoint, {})
        
        is_first_approval = True
        for approval in sorted(approvals, key=lambda x: x[class="hl-string">'updated-at']):
            activity = None
            rejection_reason = approval.get(class="hl-string">'reason')
            
            if approval[class="hl-string">'status'] == class="hl-string">'approved':
                activity = class="hl-string">'Manager Approved' if is_first_approval else class="hl-string">'Finance Approved'
                is_first_approval = False
            elif approval[class="hl-string">'status'] == class="hl-string">'rejected':
                activity = class="hl-string">'Manager Rejected' if is_first_approval else class="hl-string">'Finance Rejected'
                is_first_approval = False
            elif approval[class="hl-string">'status'] in [class="hl-string">'sent_back', class="hl-string">'pending_resubmit']:
                activity = class="hl-string">'Sent Back For Revision'

            if activity:
                event_log.append({
                    **base_event,
                    class="hl-string">'ActivityName': activity,
                    class="hl-string">'EventTime': approval[class="hl-string">'updated-at'],
                    class="hl-string">'UserName': approval.get(class="hl-string">'approver', {}).get(class="hl-string">'fullname'),
                    class="hl-string">'RejectionReason': rejection_reason
                })
        
        class=class="hl-string">"hl-comment"># 5. Infer payment and accounting events from status
        if report[class="hl-string">'status'] == class="hl-string">'processing_payment':
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Reimbursement Scheduled',
                class="hl-string">'EventTime': report[class="hl-string">'updated-at'], class=class="hl-string">"hl-comment"># Inferred from last update timestamp
                class="hl-string">'UserName': class="hl-string">'System'
            })
            
        if report[class="hl-string">'status'] == class="hl-string">'paid':
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Reimbursement Executed',
                class="hl-string">'EventTime': report[class="hl-string">'updated-at'], class=class="hl-string">"hl-comment"># Inferred from last update timestamp
                class="hl-string">'UserName': class="hl-string">'System'
            })

        class=class="hl-string">"hl-comment"># class="hl-string">'exported' flag indicates posting to an ERP system
        if report.get(class="hl-string">'exported') == True:
            event_log.append({
                **base_event,
                class="hl-string">'ActivityName': class="hl-string">'Accounting Posted',
                class="hl-string">'EventTime': report[class="hl-string">'updated-at'], class=class="hl-string">"hl-comment"># Inferred from last update timestamp
                class="hl-string">'UserName': class="hl-string">'System'
            })

    class=class="hl-string">"hl-comment"># 6. Create DataFrame and save to CSV
    if not event_log:
        print(class="hl-string">"No events were generated. Exiting.")
        return
        
    df = pd.DataFrame(event_log)
    class=class="hl-string">"hl-comment"># Reorder columns for clarity
    column_order = [
        class="hl-string">'ExpenseReportId', class="hl-string">'ActivityName', class="hl-string">'EventTime', class="hl-string">'EndTime', class="hl-string">'UserName',
        class="hl-string">'EmployeeDepartment', class="hl-string">'TotalAmount', class="hl-string">'ExpenseReportStatus',
        class="hl-string">'RejectionReason', class="hl-string">'PolicyViolationFlag', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate'
    ]
    df = df[column_order]
    df.sort_values(by=[class="hl-string">'ExpenseReportId', class="hl-string">'EventTime'], inplace=True)
    
    output_filename = class="hl-string">'coupa_expense_event_log.csv'
    df.to_csv(output_filename, index=False)
    print(fclass="hl-string">"Extraction complete. Event log saved to {output_filename}")

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

准备好开始了吗？

使用此模板开启流程挖掘之旅，深入了解费用管理情况。立即着手优化运营。

返回改进指南

下载模板

优化费用管理，立即消除瓶颈

借助清晰的洞察发现低效环节，将费用处理周期缩短30%。

开始免费试用

无需信用卡，几分钟即可开始。

您的费用管理数据模板

您的费用管理数据模板

费用管理属性

费用管理活动

数据提取指南

通过SFTP定时导出Coupa费用数据

步骤

配置

查询示例 sql

使用Coupa REST API提取费用数据的Python脚本

步骤

配置

查询示例 python

准备好开始了吗？

优化费用管理，立即消除瓶颈