Exchange Rate Broker API允许用户为公司创建自定义汇率。有关其他配置信息，请参阅货币管理配置页面。

限制: API目前允许每个POST请求最多100个汇率。此API仅对已被SAP Concur授予访问权限的用户可用。对该文档的访问不能提供对API的访问。

工艺流程

Exchange Rate Broker v4 POST流

产品和版本

Concur费用专业版
同意费用标准版
Concur旅游专业版
Concur旅行标准版
同意发票专业版
同意发票标准版
同意请求专业版
同意请求标准版

使用范围

的名字	描述	端点
`expense.exchangerate.writeonly`	创建自定义汇率。	`帖子`

依赖关系

一个也没有。

访问令牌的使用

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

创建自定义汇率

为给定的日期和货币对创建一组自定义汇率。

作用域

expense.exchangerate.writeonly——是指使用范围全部细节。

请求

URI

模板

帖子｛数据中心｝/汇率/ v4 /利率

参数

一个也没有。

头

内容类型:application / json
授权:无记名令牌

有效载荷

JSON请求体示例:

         ｛“currency_sets”：(｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．2，“to_crn_code”：“欧元”}，｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．3，“to_crn_code”：“CAD”｝］｝
        

响应

如果成功，JSON响应体将是与之相同的汇率项数组overallStatus，个人费率上传statusCode和statusMessage．批量上传可以部分成功。

状态码

头

concur-correlationidSAP Concur特定的自定义标头是否以a的形式用于技术支持RFC 4122 UUID URN命名空间．
RFC 7231内容类型
内容长度RFC 7230

有效载荷

成功创建了回应:

         ｛“overallStatus”：“成功”，“消息”：“请求成功完成”，“currencySets”：(｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．2，“to_crn_code”：“欧元”，“statusMessage”：“成功”，“statusCode”：200}，｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．3，“to_crn_code”：“CAD”，“statusMessage”：“成功”，“statusCode”：200｝］｝
        

例子——成功

请求

         POST https://us.api.concursolutions.com/exchangerate/v4/rates接受:application/json授权:承载｛令牌｝内容类型:application / json
        

         ｛“currency_sets”：(｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．2，“to_crn_code”：“欧元”｝，｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．3，“to_crn_code”：“CAD”｝］｝
        

响应

         HTTP/1.1 200 OK Content-Type: application/json Date: Thu, 01 Jan 2020 18:50:00 GMT
        

         ｛“overallStatus”：“成功”，“消息”：“请求成功完成”，“currencySets”：(｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．2，“to_crn_code”：“欧元”，“statusMessage”：“成功”，“statusCode”：200}，｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．3，“to_crn_code”：“CAD”，“statusMessage”：“成功”，“statusCode”：200｝］｝
        

范例-部分成功

由于无效，此示例仅部分成功创建所有汇率from_crn_code在第一个数组项中。但是，第二个数组条目已经成功创建。

请求

         POST https://us.api.concursolutions.com/exchangerate/v4/rates接受:application/json授权:承载｛令牌｝内容类型:application / json
        

         ｛“currency_sets”：(｛“from_crn_code”：“无效”，“start_date”：“2019-01-01”，“速度”：1．2，“to_crn_code”：“欧元”}，｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．3，“to_crn_code”：“CAD”｝］｝
        

响应

         HTTP/1.1 200 OK Content-Type: application/json Date: Thu, 01 Jan 2020 18:50:00 GMT
        

         ｛“overallStatus”：“部分成功”，“消息”：“有错误的请求”，“currencySets”：(｛“from_crn_code”：“无效”，“start_date”：“2019-01-01”，“速度”：1．2，“to_crn_code”：“欧元”，“statusMessage”：“无效请求收到”，“statusCode”：400}，｛“from_crn_code”：“美元”，“start_date”：“2019-01-01”，“速度”：1．3，“to_crn_code”：“CAD”，“statusMessage”：“成功”，“statusCode”：200｝］｝
        

模式

BulkExchangeRateUploadRequest

的名字	类型	格式	描述
`currency_sets`	`数组`	`ExchangeRateUploadRequest`	要求一组汇率上传请求。

ExchangeRateUploadRequest

的名字	类型	格式	描述
`from_crn_code`	`字符串`	-	要求ISO 4217货币转换的字母代码。
`to_crn_code`	`字符串`	-	要求ISO 4217转换为的货币的字母代码。
`start_date`	`字符串`	`YYYY-MM-DD`	要求UTC时间的汇率开始生效。
`率`	`数量`	-	要求定制的汇率。

BulkExchangeRateUploadResponse

的名字	类型	格式	描述
`overallStatus`	`字符串`	-	此批量上传的总体状态。
`消息`	`字符串`	-	这次批量上传的全部消息。
`currencySets`	`数组`	`ExchangeRateUploadResponse`	个人上传结果的数组。

ExchangeRateUploadResponse

的名字	类型	格式	描述
`from_crn_code`	`字符串`	-	ISO 4217字母代码的货币转换。
`to_crn_code`	`字符串`	-	ISO 4217的字母代码的货币转换。
`start_date`	`字符串`	`YYYY-MM-DD`	UTC时间的汇率开始生效。
`率`	`数量`	-	定制的汇率。
`statusCode`	`数量`	-	用于上传此自定义货币集的HTTP状态代码。
`statusMessage`	`字符串`	-	用于上传此自定义货币集的HTTP消息。

错误

的名字	类型	格式	描述
`errorId`	`字符串`	-	是与响应关联的错误的唯一标识符，还是错误响应本身。
`errorMessage`	`字符串`	-	详细的错误消息。
`httpStatus`	`字符串`	-	响应的HTTP响应代码和短语。
`路径`	`字符串`	-	尝试请求的URI。
`时间戳`	`字符串($日期-时间)`	-	捕获错误的日期时间。例子:`2016 - 10 - 04 - t00:53:25.931 + 0000`
`validationErrors`	`数组`	`ValidationError`	此请求的验证错误。

ValidationError

的名字	类型	格式	描述
`消息`	`字符串`	-	验证错误的详细消息。
`源`	`字符串`	-	失败的验证类型。