评论V4 API用于读取在费用报告标题上输入的注释，或现有费用报告的费用。此API用于详细介绍有关策略发生的支出的信息，这些信息由报告所有者的合理性，或者批准费用报告的批准者指出的不准确性。

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

先前版本

  • 报告V2文档可用这里。

产品和版本

  • Concur Expense专业版
  • Concur费用标准版

范围使用

所需的范围：

名称 描述 终点
Expense.Report.read.Read.Read. 获取有关费用报告的信息。 得到
user.read. 获取必要的用户信息用户身份。 得到

可选范围：

名称 描述 终点
Expense.Report.ReadWrite. 读写费用报告标题。 修补
Expense.Report.WorkFlowStatus.Write. 批准或发送工作流程中的报告 修补

依赖性

SAP Concur客户端必须购买持续费用以使用此API。此API要求Identity V4 API目前仅可用于批准的早期访问合作伙伴。有关更多信息，请联系您的SAP Confur代表。

访问令牌用法

此API支持公司级别和用户级访问令牌。

检索报告标题评论

检索特定报告标题的注释。

范围

Expense.Report.read.Read.Read.- 请参阅范围使用有关详细信息。

要求

URI模板

https：//{Datenteruri.}/ Expensereports / V4 /用户/{用户身份}/语境/{ContextType.}/报告/{Reportid.}/评论

参数

名称 类型 格式 描述
用户身份 细绳 - 必需的SAP同意用户的唯一标识符。采用身份v4检索用户身份。
ContextType. 细绳 - 必需的SAP Confur用户的访问级别，它确定了它们可以查看/修改的表单字段。支持的值：游客那代理人
Reportid. 细绳 - 必需的正在读取的报告的唯一标识符。

标题

回复

状态代码

标题

有效载荷

例子

要求

卷曲- 地点- 要求得到'https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3-32e8-4907-9672-5b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/comments'\- 主人'授权：持票人{Access_Token}'\- 主人'同意 - 相关性：费用报告 - 测试'\- 主人'内容类型：应用程序/ JSON'

回复

200 OK.[{“评论”：“这是办公用品的费用报告”那“创立日期”：“2021-03-17T22：29：50.090Z”那“作者”：{“名”：“同意”那“姓”：“行政人员”那“中间初始”：“}那“createyforemployeeedid”：“32C2FCC3-B2E8-4907-9672-5B3F49B1C643”那“createyforemployeee”：{“名”：“测试人员”那“姓”：“插入”那“中间初始”：“一种”}那“isltaTest”：真的}]

检索费用评论

在费用报告中检索对特定费用的评论。

范围

Expense.Report.read.Read.Read.- 请参阅范围使用有关详细信息。

要求

URI模板

https：//{Datenteruri.}/ Expensereports / V4 /用户/{用户身份}/语境/{ContextType.}/报告/{Reportid.}/花费/{ExpenseId}/评论

参数

名称 类型 格式 描述
用户身份 细绳 - 必需的SAP同意用户的唯一标识符。采用身份v4检索用户身份。
ContextType. 细绳 - 必需的SAP Confur用户的访问级别，它确定了它们可以查看/修改的表单字段。支持的值：游客那代理人
Reportid. 细绳 - 必需的此费用条目所属的报告的唯一标识符。
ExpenseId 细绳 - 必需的评论属于的费用条目的唯一标识符。

标题

回复

状态代码

标题

有效载荷

例子

要求

卷曲- 地点- 要求得到'https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3-b2e8-4907-9672-5b3f49b1c643/context/traveler/reports/764428dd6a66450bfcb/expens/84fcbb92bd4e5342b849dac29fd163a1/comments'\- 主人'授权：持票人{Access_Token}'\- 主人'同意 - 相关性：费用报告 - 测试'\- 主人'内容类型：应用程序/ JSON'

费用评论响应

200 OK.[{“评论”：“由于大流行而允许这种费用”那“创立日期”：“2021-03-17T23：05：40.340z”那“作者”：{“名”：“同意”那“姓”：“行政人员”那“中间初始”：“}那“createyforemployeeedid”：“32C2FCC3-B2E8-4907-9672-5B3F49B1C643”那“createyforemployeee”：{“名”：“测试人员”那“姓”：“插入”那“中间初始”：“一种”}那“isltaTest”：真的}]

架构

报告标题评论

名称 类型 格式 描述
注释书 大批 注释书 链接到格式的另一个模式的键。

费用评论

名称 类型 格式 描述
注释书 大批 注释书 链接到格式的另一个模式的键。

注释书

名称 类型 格式 描述
作者 员工 - 必需的评论作者的姓名。
评论 细绳 - 必需的所有用户的报告中的注释输入。
createdForeMoilcyee 员工 - 必需的评论的员工的名称是代表。这只与评论作者的不同之处仅在于代表创建评论。
createdForEmployeeID 细绳 - 必需的员工的唯一标识符代表评论。这只与评论作者的不同之处仅在于代表创建评论。
创立日期 细绳 YYYY-MM-DDTHH：mm：ssz.sss'z' 必需的在报告或费用上创建评论时的UTC DateTime。
islatest. 布尔基 真的/错误的 必需的如果真的，此属性表示用户的最新注释。

员工

名称 类型 格式 描述
名 细绳 - 员工的名字。
姓 细绳 - 员工的姓氏。
中间初始 细绳 - 员工的中间首字母。

错误信息

名称 类型 格式 描述
错误 细绳 - 与响应相关的错误的唯一标识符。
错误信息 细绳 - 必需的详细错误消息。
httpstatus. 细绳 - 必需的HTTP响应代码和响应短语。
小路 细绳 - 必需的未遂请求的URI。
时间戳 细绳 约会时间 必需的捕获错误时的时间。
验证识别 验证误合 - 验证错误消息。

验证错误

名称 类型 格式 描述
ID 细绳 - 验证错误的ID。
信息 细绳 - 验证错误的详细消息。
来源 细绳 - 失败的验证类型。