分配API可用于读取属于费用报告的特定费用的分配,并在费用报告中修改现有费用的分配。此API可用于更改自定义字段属性等。
限制:此API仅对已被SAP Concur授予访问权限的合作伙伴可用。对该文档的访问不能提供对API的访问。
所需的范围:
姓名 | 描述 | 终点 |
---|---|---|
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的拨款。
expense.report.read
- 请参阅使用范围全部细节。
https://{datacenterURI}/ Expensereports / V4 /用户/{用户标识}/语境/{contextType}/报告/{reportId}/费用/{expenseId}/配置
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
用户标识 |
细绳 |
- | 要求SAP Concur用户的唯一标识符。使用身份v4 API检索用户标识 . |
contextType |
细绳 |
- | 要求SAP Concur用户的访问级别,它决定了他们可以查看/修改的表单字段。支持的值:游客 |
reportId |
细绳 |
- | 要求支出条目所属的报告的唯一标识符,它的分配正在被检索。 |
expenseId |
细绳 |
- | 要求正在检索其分配的费用条目的唯一标识符。 |
同意相关性
是一个同意特定的自定义标题,用于技术支持的形式RFC 4122 UUID URN命名空间同意相关性
SAP Concur特定的自定义标头是否以a的形式用于技术支持RFC 4122 UUID URN命名空间卷曲- 地点- 要求得到“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}]
检索报表上费用分录的特定分配的详细信息。
expense.report.read
- 请参阅使用范围全部细节。
https://{datacenterURI}/ Expensereports / V4 /用户/{用户标识}/语境/{contextType}/报告/{reportId}/ /分配{allocationId}
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
用户标识 |
细绳 |
- | 要求SAP Concur用户的唯一标识符。使用身份v4 API检索用户标识 . |
contextType |
细绳 |
- | 要求SAP Concur用户的访问级别,它决定了他们可以查看/修改的表单字段。支持的值:游客 ,代理 |
reportId |
细绳 |
- | 要求此分配所属的报表的唯一标识符。 |
allocationId |
细绳 |
- | 要求正在检索的分配的唯一标识符。 |
同意相关性
是一个同意特定的自定义标题,用于技术支持的形式RFC 4122 UUID URN命名空间同意相关性
SAP Concur特定的自定义标头是否以a的形式用于技术支持RFC 4122 UUID URN命名空间卷曲- 地点- 要求得到'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.
- 请参阅使用范围全部细节。
https://{datacenterURI}/ Expensereports / V4 /用户/{用户标识}/语境/{contextType}/报告/{reportId}/ /分配{allocationId}
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
用户标识 |
细绳 |
- | 要求SAP Concur用户的唯一标识符。使用身份v4 API检索用户标识 . |
contextType |
细绳 |
- | 要求SAP Concur用户的访问级别,它决定了他们可以查看/修改的表单字段。支持的值:游客 ,代理 |
reportId |
细绳 |
- | 要求此分配所属的报表的唯一标识符。 |
allocationId |
细绳 |
- | 要求正在检索的分配的唯一标识符。 |
同意相关性
是一个同意特定的自定义标题,用于技术支持的形式RFC 4122 UUID URN命名空间费用报告的补丁操作V4符合JSON合并修补程序规范:
同意相关性
SAP Concur特定的自定义标头是否以a的形式用于技术支持RFC 4122 UUID URN命名空间卷曲- 地点- 要求补丁“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没有内容
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
AccountCode. |
细绳 |
- | 与分配相关的分类帐户代码。 |
allocationAmount |
量 |
- | 分配的数量。 |
allocationId |
细绳 |
- | 要求分配的唯一标识符。 |
赞美amount. |
量 |
- | 根据批准的费用金额批准偿还偿还金额。 |
索赔被告. |
量 |
- | 要求偿还的拨款数额。 |
customdata. |
customdata. |
- | 来自的细节customdata. 字段。这些字段可能没有数据,这取决于配置。 |
expenseId |
细绳 |
- | 要求与分配相关的费用的唯一标识符。 |
isPercentEdited |
布尔 |
真正的 /假 |
要求是否已编辑分配百分比。 |
Issystemallocation. |
布尔 |
真正的 /假 |
要求分配是一种系统分配,通常来自用户。如果显示给用户,应该是只读的。 |
overlimitAccountCode. |
细绳 |
- | 例如,如果它超过预定阈值,则与分配相关联的分类帐帐户代码,例如,用户的旅行允许限制。 |
百分比 |
数量 |
双倍的 |
要求这种分配所代表的总费用的百分比。 |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
id |
细绳 |
- | 要求自定义字段的唯一标识符。例子:Custom1. ,orgunit1. |
已验证 |
布尔 |
真正的 /假 |
返回值是否有效。此值为所有数据类型的自定义字段返回,并专门为表示当前状态的列表项计算。默认值:真正的 |
价值 |
细绳 |
- | 自定义字段的值。该字段可以包含所有受支持的数据类型的值,例如文本 ,整数 ,布尔 和listItemId .最大长度:48个字符 |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
货币代码 |
细绳 |
- | 要求费用报告货币的3个字母ISO 4217货币代码,基于创建报告时用户指定的报销货币。例子:美元 - 美元;兄弟 - 巴西真实;计算机辅助设计 - 加拿大元;瑞士法郎 ——瑞士法郎;欧元 - 欧元;GBO. ——英镑;港币 -港元;印度卢比 - 印度卢比;麦根 - 墨西哥比索;诺克 - 挪威克朗;瑞典克朗 - 瑞典克朗 |
价值 |
数量 |
双倍的 |
要求以指定货币表示的金额。 |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
分配 |
UpdateAllocation. |
- | 要求这是一个要更新的分配自定义数据对象。 |
expenseIds |
细绳 |
- | 要求这是本报告中正在更新的费用的唯一标识符数组。 |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
customdata. |
customdata. | - | 来自的细节customdata. 字段。这些字段可能没有数据,这取决于配置。 |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
弃用 |
细绳 |
- | - |
HREF. |
细绳 |
- | 要求相关的URL哈托斯 可用于后续调用的链接。 |
hreflang |
细绳 |
- | - |
isTemplated |
布尔 |
真正的 /假 |
要求是否HREF. 参数化。 |
媒体 |
细绳 |
- | - |
方法 |
细绳 |
- | 要求相关呼叫所需的HTTP方法。 |
rel |
细绳 |
- | 要求描述如何的链接关系HREF. 与API调用相关。 |
标题 |
细绳 |
- | - |
类型 |
细绳 |
- | - |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
错误 |
细绳 |
- | 与响应相关的错误的唯一标识符。 |
错误信息 |
细绳 |
- | 要求详细的错误消息。 |
httpStatus |
细绳 |
- | 要求HTTP响应代码和响应短语。 |
路径 |
细绳 |
- | 要求未遂请求的URI。 |
时间戳 |
细绳 |
日期-时间 |
要求捕获错误的时间。 |
validationErrors |
验证误合 |
- | 验证错误消息。 |
姓名 | 类型 | 格式 | 描述 |
---|---|---|---|
id |
细绳 |
- | 验证错误的ID。 |
消息 |
细绳 |
- | 验证错误的详细消息。 |
来源 |
细绳 |
- | 失败的验证类型。 |