分配API可用于读取属于费用报告的特定费用的分配,并在费用报告中修改现有费用的分配。此API可用于更改自定义字段属性等。

限制:此API仅对已被SAP Concur授予访问权限的合作伙伴可用。对该文档的访问不能提供对API的访问。

先前版本

产品和版本

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

使用范围

所需的范围:

姓名 描述 终点
expense.report.read 获取有关费用报告的信息。 得到
Expense.Report.ReadWrite. 读和写费用报告标题。 补丁
user.read 获取必要的用户信息用户标识 得到

可选范围:

姓名 描述 终点
花.Listitem.read. 只读访问消费清单项目listItemId 得到
spend.list.read 只读访问花费列表和类别详细信息。 得到

依赖性

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

访问令牌用法

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

在特定报告ID上检索费用ID的分配

检索属于特定报告ID上的特定费用ID的拨款。

作用域

expense.report.read- 请参阅使用范围全部细节。

要求

URI模板

https://datacenterURI/ Expensereports / V4 /用户/用户标识/语境/contextType/报告/reportId/费用/expenseId/配置

参数

姓名 类型 格式 描述
用户标识 细绳 - 要求SAP Concur用户的唯一标识符。使用身份v4 API检索用户标识
contextType 细绳 - 要求SAP Concur用户的访问级别,它决定了他们可以查看/修改的表单字段。支持的值:游客
reportId 细绳 - 要求支出条目所属的报告的唯一标识符,它的分配正在被检索。
expenseId 细绳 - 要求正在检索其分配的费用条目的唯一标识符。

响应

状态代码

有效载荷

例子

要求

卷曲- 地点- 要求得到“https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3 b2e8 - 4907 - 9672 - 5 - b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/expenses/29ee3c62f5d844458828a5c1086072d1/allocations”- 主人“授权:无记名{access_token}”- 主人“Concur-CorrelationId: Expense-Allocation-test”- 主人“application / json内容类型:

响应

200 OK.“customData”“ID”“custom9”“价值”“D3954B47BCEC9446A4FFC49E0000B46E”“isValid”真正的“allocationid”“3 bbb494511e1c74da04469c45b039871”“AccountCode”“等待客户端”“overlimitAccountCode”:零,“allocationAmount”“价值”: 250.00,“currencyCode”“美元”“approvedAmount”“价值”: 250.00,“currencyCode”“美元”“claimedAmount”“价值”: 250.00,“currencyCode”“美元”“ExpenseID”“29EE3C62F5D844458828A5C1086072D1”“issystemallocation”“isPercentEdited”“比例”: 50.00000000“customData”“ID”“custom9”“价值”“88EACA3116581248BCE27956DE67647D”“isValid”真正的“allocationid”“4 db06b4360e31443ad43ed52b2ae007e”“AccountCode”“等待客户端”“overlimitAccountCode”:零,“allocationAmount”“价值”: 250.00,“currencyCode”“美元”“approvedAmount”“价值”: 250.00,“currencyCode”“美元”“claimedAmount”“价值”: 250.00,“currencyCode”“美元”“ExpenseID”“29EE3C62F5D844458828A5C1086072D1”“issystemallocation”“isPercentEdited”“比例”: 50.00000000

根据ID检索分配

检索报表上费用分录的特定分配的详细信息。

作用域

expense.report.read- 请参阅使用范围全部细节。

要求

URI模板

https://datacenterURI/ Expensereports / V4 /用户/用户标识/语境/contextType/报告/reportId/ /分配allocationId

参数

姓名 类型 格式 描述
用户标识 细绳 - 要求SAP Concur用户的唯一标识符。使用身份v4 API检索用户标识
contextType 细绳 - 要求SAP Concur用户的访问级别,它决定了他们可以查看/修改的表单字段。支持的值:游客代理
reportId 细绳 - 要求此分配所属的报表的唯一标识符。
allocationId 细绳 - 要求正在检索的分配的唯一标识符。

响应

状态代码

有效载荷

例子

要求

卷曲- 地点- 要求得到'https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3-32e8-4907-9672-5b3f49b1c643/context/traveler/reports/764428dd6a66450bfcb/allocations/3bbb494511e1c74da04469c45b039871'- 主人“授权:无记名{access_token}”- 主人“Concur-CorrelationId: Expense-Allocation-test”- 主人“application / json内容类型:

响应

200 OK.“customData”“ID”“custom9”“价值”“D3954B47BCEC9446A4FFC49E0000B46E”“isValid”真正的“allocationid”“3 bbb494511e1c74da04469c45b039871”“AccountCode”“等待客户端”“overlimitAccountCode”:零,“allocationAmount”“价值”: 250.00,“currencyCode”“美元”“approvedAmount”“价值”: 250.00,“currencyCode”“美元”“claimedAmount”“价值”: 250.00,“currencyCode”“美元”“ExpenseID”“29EE3C62F5D844458828A5C1086072D1”“issystemallocation”“isPercentEdited”“比例”: 50.00000000

更新特定的分配

更新特定分配的属性。

作用域

Expense.Report.ReadWrite.- 请参阅使用范围全部细节。

要求

URI模板

https://datacenterURI/ Expensereports / V4 /用户/用户标识/语境/contextType/报告/reportId/ /分配allocationId

参数

姓名 类型 格式 描述
用户标识 细绳 - 要求SAP Concur用户的唯一标识符。使用身份v4 API检索用户标识
contextType 细绳 - 要求SAP Concur用户的访问级别,它决定了他们可以查看/修改的表单字段。支持的值:游客代理
reportId 细绳 - 要求此分配所属的报表的唯一标识符。
allocationId 细绳 - 要求正在检索的分配的唯一标识符。

其他设计规范

费用报告的补丁操作V4符合JSON合并修补程序规范:

有效载荷

响应

状态代码

有效载荷

例子

要求

卷曲- 地点- 要求补丁“https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3 b2e8 - 4907 - 9672 - 5 - b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/allocations/3bbb494511e1c74da04469c45b039871”- 主人“授权:无记名{access_token}”- 主人“Concur-CorrelationId: Viswa测试”- 主人“application / json内容类型:- 主人'内容类型:文本/平原'- 原始'{"allocation":{"customData": [{"id": "custom9", "value": "058713001E2CD943824280D9275FDC3F", "isValid": true}]}, "expenseIds": ["29EE3C62F5D844458828A5C1086072D1"]}'

响应

204没有内容

架构

ReportAllocationResponse

姓名 类型 格式 描述
AccountCode. 细绳 - 与分配相关的分类帐户代码。
allocationAmount - 分配的数量。
allocationId 细绳 - 要求分配的唯一标识符。
赞美amount. - 根据批准的费用金额批准偿还偿还金额。
索赔被告. - 要求偿还的拨款数额。
customdata. customdata. - 来自的细节customdata.字段。这些字段可能没有数据,这取决于配置。
expenseId 细绳 - 要求与分配相关的费用的唯一标识符。
isPercentEdited 布尔 真正的/ 要求是否已编辑分配百分比。
Issystemallocation. 布尔 真正的/ 要求分配是一种系统分配,通常来自用户。如果显示给用户,应该是只读的。
overlimitAccountCode. 细绳 - 例如,如果它超过预定阈值,则与分配相关联的分类帐帐户代码,例如,用户的旅行允许限制。
百分比 数量 双倍的 要求这种分配所代表的总费用的百分比。

customdata.

姓名 类型 格式 描述
id 细绳 - 要求自定义字段的唯一标识符。例子:Custom1.orgunit1.
已验证 布尔 真正的/ 返回值是否有效。此值为所有数据类型的自定义字段返回,并专门为表示当前状态的列表项计算。默认值:真正的
价值 细绳 - 自定义字段的值。该字段可以包含所有受支持的数据类型的值,例如文本整数布尔listItemId.最大长度:48个字符

姓名 类型 格式 描述
货币代码 细绳 - 要求费用报告货币的3个字母ISO 4217货币代码,基于创建报告时用户指定的报销货币。例子:美元- 美元;兄弟- 巴西真实;计算机辅助设计- 加拿大元;瑞士法郎——瑞士法郎;欧元- 欧元;GBO.——英镑;港币-港元;印度卢比- 印度卢比;麦根- 墨西哥比索;诺克- 挪威克朗;瑞典克朗- 瑞典克朗
价值 数量 双倍的 要求以指定货币表示的金额。

UpdateReportAllocation

姓名 类型 格式 描述
分配 UpdateAllocation. - 要求这是一个要更新的分配自定义数据对象。
expenseIds 细绳 - 要求这是本报告中正在更新的费用的唯一标识符数组。

UpdateAllocation.

姓名 类型 格式 描述
customdata. customdata. - 来自的细节customdata.字段。这些字段可能没有数据,这取决于配置。
姓名 类型 格式 描述
弃用 细绳 - -
HREF. 细绳 - 要求相关的URL哈托斯可用于后续调用的链接。
hreflang 细绳 - -
isTemplated 布尔 真正的/ 要求是否HREF.参数化。
媒体 细绳 - -
方法 细绳 - 要求相关呼叫所需的HTTP方法。
rel 细绳 - 要求描述如何的链接关系HREF.与API调用相关。
标题 细绳 - -
类型 细绳 - -

ErrorMessage

姓名 类型 格式 描述
错误 细绳 - 与响应相关的错误的唯一标识符。
错误信息 细绳 - 要求详细的错误消息。
httpStatus 细绳 - 要求HTTP响应代码和响应短语。
路径 细绳 - 要求未遂请求的URI。
时间戳 细绳 日期-时间 要求捕获错误的时间。
validationErrors 验证误合 - 验证错误消息。

验证误合

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