概述

此页面将托管在公开可用的所有Concor费用相关事件的文档public.concur.expense.report.事件订阅服务（ESS）中的主题。订阅者将通过遵循所描述的步骤来订阅这些事件事件订阅服务v4页。

限制：此活动订阅仅适用于已授予SAP Confor访问权限的合作伙伴。访问此文档不提供对订阅的访问权限。

范围使用

名称 描述
Expense.Report.read.Read.Read. 获取有关费用报告的信息。
Expense.Report.ReadWrite. 读写费用报告标题。

活动

本节列出了所有公开的活动。

报告状态更改了事件

这statusChanged.每当费用报告的状态更改时，事件旨在发布消息，因为它在其生命周期期间遍历批准工作流程。事件的订阅者能够利用消息中的数据来执行同步或异步操作，具体取决于其业务流程。例如，这可以触发应用程序以使API调用在第三方应用程序中进行费用或开始过程。

这statusChanged.事件将始终在没有任何其他配置的情况下发布以下状态更改：

  • 每当提交报告时。
  • 每当报告被审批人/处理器发送回员工时。
  • 每当员工回忆报告时。
  • 每当报告停止在使用应用程序连接器配置的遗留外部验证步骤中。
  • 每当报告付款时。

除此之外，还将发布为管理员提供通知的任何工作流程步骤。请参考过程：创建外部验证和工作流事件通知部分工作流程 - 设置指南有关如何配置和优化事件的详细信息。

通过订阅者过滤事件：

  • 仅在报告提交的事件中感兴趣的订阅者应筛选PreviousapprovalStatus.在有效载荷中属性，应具体过滤值A_NOTF.和a_resu.。
  • 对报告感兴趣的订阅者召回或发送返回事件应通过Stepcode.具有值的有效载荷中的属性退还。
  • 对遗留外部验证步骤事件中待处理的报告感兴趣的订阅者应由该报告Stepcode.具有值的有效载荷中的属性Extval.。
  • 对付费报告事件感兴趣的订阅者应由该订户筛选CurrentPaymentStatus.具有值的有效载荷中的属性P_Paid.。
  • 对所有其他事件感兴趣的订阅者可以通过筛选Stepcode.属性使用管理员在工作流程ui屏幕中输入的值。

架构

statuschangd事件有效载荷架构

名称 类型 格式 描述
ID uuid. RFC 4122. 必需的随机生成此事件的唯一标识符。
相关性 uuid. RFC 4122. 必需的用于记录/可追溯性的唯一标识符。
事件类型 细绳 细绳 必需的事件类型：statusChanged.- 标识主题的事件类型。
话题 细绳 枚举 必需的识别事件所属的主题public.concur.expense.report.。
副主题 细绳 - 必需的Subtopic被分配了公司ID，也填充为Companyid.。
时间戳 时间戳 RFC 3339. 必需的发出事件通知时当前系统时间（UTC）。
事实 地图 事实架构 必需的键值对提供事件的内容。
TransactionTimestamp. 细绳 约会时间 链接到格式的定义的关键。
Arrayofthings. 大批 架构二 链接到格式的另一个模式的键。

状态改变了事实架构

名称 类型 格式 描述
Companyid. uuid. RFC 4122. 必需的公司唯一标识符从简介服务。
用户身份 uuid. RFC 4122. 唯一标识符，用于用户在报表资源上行为的用户服务。这可能或可能不是报告所有者，具体取决于状态更改。这可能是无效的当系统在报告上行动时。
ActingUserid. uuid. RFC 4122. 来自配置文件服务的用户唯一标识符 - 如果代表委托或费用代理正在代表用户正在处理报表资源，那么这将被填充，否则它将是无效的。
Reportid. 细绳 字母数字 必需的其状态已更改的费用报告的唯一标识符。最大字符：20
PreviousapprovalStatus. 细绳 枚举 必需的其状态已更改的费用报告的先前批准状态的唯一标识符。支持的值：
没有提交 -A_NOTF.那
送回员工 -a_resu.那
员工回忆起 -a_resu.那
提交和等待批准 -A_Pend.那
得到正式认可的 -A_APT.那
挂接外部验证 -a_extv.那
待预算批准 -a_pbdg.那
待成本对象批准 -a_peco.那
批准和会计审查 -A_ACCO.
CurrentAverProalStatus. 细绳 枚举 必需的当前批准状态的唯一标识符，其状态已更改。支持的值：
送回员工 -a_resu.那
雇员回忆起：a_resu.那
提交和待批准：A_Pend.那
得到正式认可的：A_APT.那
挂接外部验证：a_extv.那
待预算批准：a_pbdg.那
待成本对象批准：a_peco.那
批准和会计审查：A_ACCO.
以前的paymentstatus 细绳 枚举 必需的其状态已更改的费用报告的先前付款状态的唯一标识符。支持的值：
未支付 -p_notp.那
处理付款 -P_Proc.那
付款确认成功 -P_Payc.（可能取决于配置）
CurrentPaymentStatus. 细绳 枚举 必需的状态已更改的费用报告的当前付款状态的唯一标识符。支持的值：
未支付 -p_notp.那
处理付款 -P_Proc.那
有薪酬的 -P_Paid.那
付款确认成功 -P_Payc.（可能取决于配置）
Stepcode. 细绳 枚举 管理员提供的代码，客户端可以用于区分步骤。
报告提交 - 如果目标步骤（报告停止的下一个工作流程图）未配置通知，则步骤代码将是无效的。
报告发送回复或报告召回 -退还
遗留外部验证发布提交 -Extval.
遗留外部验证预提取物 -Extval.
报告付费 - 如果目标步骤（报告停止的下一个工作流步骤）未配置通知，则步骤代码将是PakReport.。
将填充由管理员配置的Admin配置的所有其他情况代码步骤代码。
HREF. 细绳 RFC 3986. 可以通过费用V4 API调用的报告资源的URI。

样本事件

{“ID”：“0490B3FB-04AD-4919-B299-AFB9FA75E07C”那“相关性”：“7E38939D-62F1-4BB4-9EEF-5EA71FCBB1D8”那“事件类型”：“standchanged”那“话题”：“public.concur.expense.report”那“时间戳”：“2021-03-18T23：11：51.034z”那“亚主题”：“685FA226-B72D-47F9-B9AD-E621DE12D094”那“事实”：{“trountapprovalstatus”：“a_pend”那“公司”：“685FA226-B72D-47F9-B9AD-E621DE12D094”那“验证”：“57EE1FDA348046E8A08B”那“stepcode”：无效的那“CurrentPaymentStatus”：“p_notp”那“prevardapproverstatus”：“a_notf”那“actinguserid”：无效的那“href”：“https://us.api.concursolutions.com/expensereports/v4/users/08a39ab2-9998-465d-b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b2f7-588d -b66ce2/context/traveler/reports/57ee1fda348046e8a08b”那“用户身份”：“08A39AB2-9998-465D-B2F7-588DBE636CE2”那“prevararpaymentstatus”：“p_notp”}}，{“ID”：“3ABDCBF-07DF-4ACD-99DE-7F5AEF0F673D”那“相关性”：“Viswa-test”那“事件类型”：“standchanged”那“话题”：“public.concur.expense.report”那“时间戳”：“2021-03-19T00：37：39.550z”那“亚主题”：“0FFA9CE0-F00B-408A-8344-8AAD502B0D7”那“事实”：{“trountapprovalstatus”：“A_APP”那“公司”：“0FFA9CE0-F00B-408A-8344-8AAD502B0D7”那“验证”：“1b5a6194dfb047dab0bd”那“stepcode”：“exrtready”那“CurrentPaymentStatus”：“p_proc”那“prevardapproverstatus”：“a_acco”那“actinguserid”：无效的那“href”：“https://us.api.concursolutions.com/expenseereports/v4/users/22f91cc6-581c-488c -8573-d2c208136d8b/context/traveler/reports/1b5a6194dfb047dab0bd”那“用户身份”：“13FA626B-9563-4013-886C-9FD730545277”那“prevararpaymentstatus”：“p_notp”}}，{“ID”：“be3a6976-00E7-4B06-9C95-B4F2C3330EA6”那“相关性”：“Viswa-test”那“事件类型”：“standchanged”那“话题”：“public.concur.expense.report”那“时间戳”：“2021-03-19T01：11：57.169Z”那“亚主题”：“0FFA9CE0-F00B-408A-8344-8AAD502B0D7”那“事实”：{“trountapprovalstatus”：“a_resu”那“公司”：“0FFA9CE0-F00B-408A-8344-8AAD502B0D7”那“验证”：“1b5a6194dfb047dab0bd”那“stepcode”：“退还”那“CurrentPaymentStatus”：“p_notp”那“prevardapproverstatus”：“a_acco”那“actinguserid”：无效的那“href”：“https://us.api.concursolutions.com/expenseereports/v4/users/22f91cc6-581c-488c -8573-d2c208136d8b/context/traveler/reports/1b5a6194dfb047dab0bd”那“用户身份”：“22F91CC6-581C-488C-8573-D2C208136D8B”那“prevararpaymentstatus”：“p_notp”}}