费用API可用于读取属于特定费用报告的费用，并在现有费用报告中修改费用。此API可用于更改交易日期，交易金额，位置等的属性。

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

先前版本

  • 费用分录v1.1(已弃用)文档可用在这里
  • 费用分录v3文档是可用的在这里

产品和版本

  • Concur费用专业版
  • 同意费用标准版

使用范围

要求的范围:

名称 描述 端点
expense.report.read 获取有关费用报告的信息。 得到
expense.report.readwrite 读写费用报告标题。 补丁
user.read 获取用户信息，必要的用户身份． 得到

可选范围:

名称 描述 端点
spend.listitem.read 只读访问消费清单项目listItemId． 得到
spend.list.read 只读访问开支清单和类别详细信息。 得到

依赖性

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

访问令牌用法

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

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

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

作用域

expense.report.read——是指使用范围全部细节。

要求

URI模板

https://{datacenterURI}/ Expensereports / V4 /用户/{用户身份}/环境/{ContextType.}/报告/{reportId}/费用

参数

名称 类型 格式 描述
用户身份 字符串 - 要求SAP同意用户的唯一标识符。采用身份v4 API检索用户身份．
ContextType. 字符串 - 要求SAP Concur用户的访问级别，它决定了他们可以查看/修改的表单字段。支持的值:游客
reportId 字符串 - 要求正在读取的报表的唯一标识符。

头

响应

状态代码

头

有效载荷

例子

要求

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

响应

200好了[{“ExpenseID”：“84 fcbb92bd4e5342b849dac29fd163a1”那“恳署justedamount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“alloverationstate”：“NOT_ALLOCATED”那“allocationSetId”:零,“approvedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“businessPurpose”：“测试”那“claimedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“ereceiptImageId”:零,“汇率”：{“价值”: 1.00000000000000,“操作”：“乘”}那“expenseSourceIdentifiers”:零,“expenseType”：{“id”：“午餐”那“名称”：“午餐”那“代码”：“其他”那“isDeleted”：假}那“hasBlockingExceptions”：假那“hasexceptions”：假那“hasMissingReceiptDeclaration”：假那“isAutoCreated”：假那“imageCertificationStatus”:零,“isImageRequired”：真正的那“isPaperReceiptRequired”：假那“isPersonalExpense”：假那“位置”：{“id”：“04 f3ed00d0884f4681628e3337a5b515”那“名称”：“华盛顿贝尔维尤那“城市”：“bellevue”那“COMPORTSUBDIVISIONCODE”：“US-WA”那“countryCode”：“我们”}那“paymentType”：{“id”：“现金”那“名称”：“现金”那“代码”：“现金”}那“postedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“proceptimageid”:零,“ticketNumber”:零,“transactionAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“transactionDate”：“2020-03-11”那“travelAllowance”：{“dailylimitamount”:零,“dailyTravelAllowanceId”:零,“IsexpensePartoftravellaluthance”：假}那“供应商”:零,“attendeeCount”: 1、“链接”：[{“rel”：“自我”那“href”：“https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3-b2e8-4907-9672-5b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/expense/84fcbb92bd4e5342b849dac29fd163a1”那“hreflang”:零,“媒体”:零,“标题”:零,“类型”:零,“弃用”:零,“方法”：“得到”那“ise决定”：假}]}那{“ExpenseID”：“29 ee3c62f5d844458828a5c1086072d1”那“恳署justedamount”：{“价值”: 500.00000000,“currencyCode”：“美元”}那“alloverationstate”：“NOT_ALLOCATED”那“allocationSetId”:零,“approvedAmount”：{“价值”: 500.00000000,“currencyCode”：“美元”}那“businessPurpose”：“设施供应”那“claimedAmount”：{“价值”: 500.00000000,“currencyCode”：“美元”}那“ereceiptImageId”:零,“汇率”：{“价值”: 1.00000000000000,“操作”：“乘”}那“expenseSourceIdentifiers”:零,“expenseType”：{“id”：“OFCSP”那“名称”：“办公用品”那“代码”：“其他”那“isDeleted”：假}那“hasBlockingExceptions”：假那“hasexceptions”：假那“hasMissingReceiptDeclaration”：假那“isAutoCreated”：假那“imageCertificationStatus”:零,“isImageRequired”：真正的那“isPaperReceiptRequired”：假那“isPersonalExpense”：假那“位置”：{“id”：“0BC6B782B77349898E2CA814F5B57C08”那“名称”：“西雅图,华盛顿那“城市”：“西雅图”那“COMPORTSUBDIVISIONCODE”：“US-WA”那“countryCode”：“我们”}那“paymentType”：{“id”：“1022”那“名称”：“万事达”那“代码”：“其”}那“postedAmount”：{“价值”: 500.00000000,“currencyCode”：“美元”}那“proceptimageid”:零,“ticketNumber”:零,“transactionAmount”：{“价值”: 500.00000000,“currencyCode”：“美元”}那“transactionDate”：“2020-03-11”那“travelAllowance”：{“dailylimitamount”:零,“dailyTravelAllowanceId”:零,“IsexpensePartoftravellaluthance”：假}那“供应商”：{“id”:零,“名称”:零,“描述”：“安提阿建设”}那“attendeeCount”:0,“链接”：[{“rel”：“自我”那“href”：“https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3 - b2e8 - 4907 - 9672 - 5 - b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/expenses/29ee3c62f5d844458828a5c1086072d1”那“hreflang”:零,“媒体”:零,“标题”:零,“类型”:零,“弃用”:零,“方法”：“得到”那“ise决定”：假}]}]

根据ID检索费用

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

作用域

expense.report.read——是指使用范围全部细节。

要求

URI模板

https://{datacenterURI}/ Expensereports / V4 /用户/{用户身份}/环境/{ContextType.}/报告/{reportId}/费用/{expenseId}

参数

名称 类型 格式 描述
用户身份 字符串 - 要求SAP同意用户的唯一标识符。采用身份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/84fcbb92bd4e5342b849dac29fd163a1”\- 主人“授权:无记名{access_token}”\- 主人“Concur-CorrelationId: Expense-Report-test”\- 主人“application / json内容类型:

响应

200好了{“ExpenseID”：“84 fcbb92bd4e5342b849dac29fd163a1”那“恳署justedamount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“alloverationstate”：“NOT_ALLOCATED”那“allocationSetId”:零,“approvedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“businessPurpose”：“测试”那“claimedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“ereceiptImageId”:零,“汇率”：{“价值”: 1.00000000000000,“操作”：“乘”}那“expenseSourceIdentifiers”:零,“expenseType”：{“id”：“onlin”那“名称”：“在线费用”那“代码”：“其他”那“isDeleted”：假}那“hasBlockingExceptions”：假那“hasexceptions”：假那“hasMissingReceiptDeclaration”：假那“isAutoCreated”：假那“imageCertificationStatus”:零,“isImageRequired”：真正的那“isPaperReceiptRequired”：假那“isPersonalExpense”：假那“位置”：{“id”：“04 f3ed00d0884f4681628e3337a5b515”那“名称”：“华盛顿贝尔维尤那“城市”：“bellevue”那“COMPORTSUBDIVISIONCODE”：“US-WA”那“countryCode”：“我们”}那“paymentType”：{“id”：“现金”那“名称”：“现金”那“代码”：“现金”}那“postedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“proceptimageid”:零,“ticketNumber”:零,“transactionAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“transactionDate”：“2020-03-11”那“travelAllowance”：{“dailylimitamount”:零,“dailyTravelAllowanceId”:零,“IsexpensePartoftravellaluthance”：假}那“供应商”:零,“attendeeCount”: 1、“链接”：[{“rel”：“自我”那“href”：“https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3-b2e8-4907-9672-5b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/expense/84fcbb92bd4e5342b849dac29fd163a1”那“hreflang”:零,“媒体”:零,“标题”:零,“类型”:零,“弃用”:零,“方法”：“得到”那“ise决定”：假}]那“budgetaccrualdate”:零,“authorizationRequestExpenseId”:零,“customData”：[{“id”：“custom9”那“价值”：“AB8596D91C994F4DBBD820D6DCBDC599”那“isValid”：真正的那“listitemurl”：“https://us.api.concursolutions.com/list/v4/items?id=AB8596D91C994F4DBBD820D6DCBDC599”}]那“ExpensetaxSummary”：{“totalTaxPostedAmount”：{“价值”: 0 e-8,“currencyCode”：“美元”}那“totaltaxadjustedamount”：{“价值”: 0 e-8,“currencyCode”：“美元”}那“TotalReclaimPostedamount”：{“价值”: 0 e-8,“currencyCode”：“美元”}那“totalleclaimadjustedamount”：{“价值”: 0 e-8,“currencyCode”：“美元”}那“netTaxAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“netAdjustedTaxAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“netReclaimAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“netReclaimAdjustedAmount”：{“价值”: 25.00000000,“currencyCode”：“美元”}那“vatTaxTotal”:零}那“isExcludedFromCashAdvanceByUser”：假那“isExpenseBillable”：假那“是itexpensoneageed”：假那“是paperreceiptreceive”：假那“merchanttaxid”:零,“里程”:零,“parentexpensedd”:零,“probipttype”：{“id”：“n”那“地位”：“没有收据”}那“taxRateLocation”：“家”那“旅行”:零,}

更新未被扣除的报告中的特定费用条目

更新未订报中的指定费用，灵活地修改下面详述的模式中的多个属性

作用域

expense.report.readwrite——是指使用范围全部细节。

要求

URI模板

https://{datacenterURI}/ Expensereports / V4 /用户/{用户身份}/环境/{ContextType.}/报告/{reportId}/费用/{expenseId}

参数

名称 类型 格式 描述
用户身份 字符串 - 要求SAP同意用户的唯一标识符。采用身份v4 API检索用户身份．
ContextType. 字符串 - 要求SAP Concur用户的访问级别，它决定了他们可以查看/修改的表单字段。支持的值:游客那代理人
reportId 字符串 - 要求此费用分录所属报表的唯一标识符。
expenseId 字符串 - 要求正在读取的费用分录的唯一标识符。

头

休息设计规范

Expense Reports v4中的PATCH操作符合JSON Merge PATCH规范:

有效载荷

响应

状态代码

头

有效载荷

例子

要求

卷曲——位置——请求补丁“https://us.api.concursolutions.com/expensereports/v4/users/32c2fcc3 b2e8 - 4907 - 9672 - 5 - b3f49b1c643/context/traveler/reports/764428dd6a664af0bfcb/expenses/84fcbb92bd4e5342b849dac29fd163a1”\- 主人“授权:无记名{access_token}”\- 主人“Concur-CorrelationId: Expense-Test”\- 主人“application / json内容类型:\- 主人'内容类型：文本/平原'\- 原始'{"customData": [{"id": "custom09"， "value": "81188b39-605d-2d4f-b80b-43efa84a7b49"， "isValid": true}]， "businessPurpose":"Office Facility Supplies"， "transactionAmount":{"value": 50.00000000， "currencyCode": "USD"}， "expenseSource":"OTHER"}'

响应

204没有内容

更新已提交报告中的特定费用分录

更新未订阅或提交的报告中的指定费用，仅限于修改“商业目的”和“自定义/或org单元”字段。

作用域

expense.report.readwrite——是指使用范围全部细节。

要求

URI模板

https://{datacenterURI}/ Expensereports / V4 /报告/{reportId}/费用/{expenseId}

参数

名称 类型 格式 描述
reportId 字符串 - 要求此费用分录所属报表的唯一标识符。
expenseId 字符串 - 要求正在读取的费用分录的唯一标识符。

头

休息设计规范

Expense Reports v4中的PATCH操作符合JSON Merge PATCH规范:

有效载荷

响应

状态代码

头

有效载荷

更新报表费用紧凑模式

名称 类型 格式 描述
商业目的 字符串 - 用户用于业务目的的文本输入。最大长度:64个字符
customData CustomData - 来自的细节customData字段。这些字段可能没有数据，这取决于配置。
费用 字符串 - 要求费用来源。支持的值：ea——费用助理,暴徒——移动,其他未知,SE——聪明的费用,助教- 旅行津贴，TR——旅行请求,用户界面——Web UI

CustomData

名称 类型 格式 描述
id 字符串 - 要求自定义字段的唯一标识符。例子:custom1那orgUnit1
isValid 布尔 真正的/假 返回值是否有效。此值为所有数据类型的自定义字段返回，并专门为表示当前状态的列表项计算。默认：真正的
价值 字符串 - 自定义字段的值。该字段可以包含所有受支持的数据类型的值，例如文本那整数那布尔和listItemId．最大长度:48个字符

例子

要求

卷曲——位置——请求补丁“https://us.api.concursolutions.com/expensereports/v4/reports/764428DD6A664AF0BFCB/expenses/84FCBB92BD4E5342B849DAC29FD163A1”\- 主人“授权:无记名{access_token}”\- 主人“Concur-CorrelationId: Expense-Test”\- 主人“application / json内容类型:\- 主人'内容类型：文本/平原'\- 原始'{"customData": [{"id": "custom09"， "value": "81188b39-605d-2d4f-b80b-43efa84a7b49"， "isValid": true}]， "businessPurpose":"Office Supplies"， "expenseSource":"OTHER"}'

响应

204没有内容

模式

报告ExpecedEsmumary.

名称 类型 格式 描述
allocationSetId 字符串 - 与费用关联的分配集的标识符。属于同一集合的拨款是在同一时间创建的。
allocationstate. 字符串 - 要求费用的分配状态。支持的值：完全分配那NOT_ALLOCATED那PARTIALLY_ALLOCATED
approvedAmount 数量 - 以报告货币核定的费用金额。
批准justedamount. 数量 - 经批准人调整的费用总额
attendeeCount 整数 int32 与费用相关的出席人数。
商业目的 字符串 - 用户用于业务目的的文本输入。
索赔被告. 数量 - 要求偿还费用的非个人总金额。
ereceiptImageId 字符串 - 与费用相关联的Ereeceipt图像的唯一标识符。
汇率 汇率 - 要求费用的汇率数据。
expenseId 字符串 - 要求费用的唯一标识符。
费用源员工 ExpenseSourceIdentifiers - 与费用相关的费用源列表
expensetype. ExpenseType - 要求费用类型的费用。
hasBlockingExceptions 布尔 - 要求费用是否有任何阻止其提交的例外情况。
hasExceptions 布尔 真正的/假 要求费用是否有例外。
hasMissingReceiptDeclaration 布尔 真正的/假 要求费用是否有丢失收据的宣誓书。
imageCertificationStatus 字符串 - 与费用相关的收据图像的最终状态。
isAutoCreated 布尔 真正的/假 要求费用是否自动创建。
isimagrequired. 布尔 真正的/假 要求费用是否需要图像。
isPaperReceiptRequired 布尔 真正的/假 要求是否需要提交纸张收据。
ispersonalexpense. 布尔 真正的/假 要求该费用是否被用户标记为个人(不可报销)。
jptRouteId 字符串 - 识别日本铁路路线的唯一路线ID。
链接 链接 - 与此调用相关的资源链接。
地点 地点 - 费用的位置信息。
支付方式 PaymentType - 要求费用的支付类型信息。
postedAmount 数量 - 要求以报告货币计算的费用金额。
receiptImageId 字符串 - 与费用关联的图像的唯一标识符。
票号 字符串 - 与旅行有关的机票号码。
transactionAmount 数量 - 要求以交易货币支付给供应商的费用金额。
transactionDate 字符串 YYYY-MM-DD 交易日期。
travelAllowance TravelAllowance - 与费用相关的差旅津贴数据。
供应商 供应商 - 费用的供应商信息。

ReportExpenseDetail

名称 类型 格式 描述
allocationSetId 字符串 - 与费用关联的分配集的标识符。属于同一集合的拨款是在同一时间创建的。
allocationstate. 字符串 - 要求费用的分配状态。支持的值：完全分配那NOT_ALLOCATED那PARTIALLY_ALLOCATED
approvedAmount 数量 - 以报告货币核定的费用金额。
批准justedamount. 数量 - 批准人的费用调整的总金额。
attendeeCount 整数 int32 与费用相关的出席人数。
authorizationRequestExpenseId 字符串 - 授权请求费用ID与费用相关联。
budgetAccrualDate 字符串 YYYY-MM-DD 费用的预算发生日期。
商业目的 字符串 - 用户用于业务目的的文本输入。
索赔被告. 数量 - 要求偿还费用的非个人总金额
customData CustomData - 来自的细节customData字段。这些字段可能没有数据，这取决于配置。
ereceiptImageId 字符串 - 与费用相关联的Ereeceipt图像的唯一标识符。
汇率 汇率 - 要求费用的汇率数据。
expenseId 字符串 - 要求费用的唯一标识符
费用源员工 ExpenseSourceIdentifiers - 与费用相关的费用来源列表。
ExpensetaxSummary. ExpenseTaxSummary - 有关费用的税务资料。
expensetype. ExpenseType - 要求费用类型的费用。
hasBlockingExceptions 布尔 真正的/假 要求费用是否具有阻止其提交的任何例外情况。
hasExceptions 布尔 真正的/假 要求费用是否有例外。
hasMissingReceiptDeclaration 布尔 真正的/假 费用是否有丢失收据的宣誓书。
imageCertificationStatus 字符串 - 与费用相关的收据图像的最终状态。支持的值：公认那加工过的那处理那PDF那失败的那NO_PROCESSING_REQUIRED
isAutoCreated 布尔 真正的/假 要求费用是否自动创建。
isExcludedFromCashAdvanceByUser 布尔 真正的/假 要求用户是否从现金提前排除了费用。
IsexpenseBillable. 布尔 真正的/假 要求费用是否可以计费。
Isexpense重入 布尔 真正的/假 要求批准者或处理器是否在报告中拒绝了此费用。如果真正的然后，此费用将被发送回报附录（拆分）报告中提交的报告。
isimagrequired. 布尔 真正的/假 要求费用是否需要图像。
isPaperReceiptReceived 布尔 真正的/假 要求纸质收到是否收到费用。
isPaperReceiptRequired 布尔 真正的/假 要求是否需要提交纸张收据。
ispersonalexpense. 布尔 真正的/假 要求该费用是否被用户标记为个人(不可报销)。
jptRouteId 字符串 - 识别日本铁路路线的唯一路线ID。
链接 链接 - 与此调用相关的资源链接。
地点 地点 - 费用的位置信息。
merchantTaxId 字符串 - 用于支付费用的商人税号。
里程 里程 - 与费用相关的里程数据。
parentExpenseId 字符串 - 父开销ID。
支付方式 PaymentType - 要求费用的支付类型信息。
postedAmount 数量 - 要求以报告货币计算的费用金额。
receiptImageId 字符串 - 与费用关联的图像的唯一标识符。
收据 ReceiptType - 收据类型为费用。
taxRateLocation 字符串 - 要求事务位置相对于由用户配置文件定义的员工的家庭位置。支持的值：外国的- 费用交易以外币进行，首页-费用交易以偿还货币进行，Out_of_Province.- 费用交易发生在国家司法管辖区外。默认：首页
transactionAmount 数量 - 要求以交易货币支付给供应商的费用金额。
transactionDate 字符串 YYYY-MM-DD 交易日期的费用。
旅行 旅行 - 旅行数据与费用相关联。
travelAllowance TravelAllowance - 与费用相关的差旅津贴数据。
供应商 供应商 - 费用的供应商信息。

CustomData

名称 类型 格式 描述
id 字符串 - 要求自定义字段的唯一标识符。例子:custom1那orgUnit1
isValid 布尔 真正的/假 返回值是否有效。此值为所有数据类型的自定义字段返回，并专门为表示当前状态的列表项计算。默认：真正的
价值 字符串 - 自定义字段的值。该字段可以包含所有受支持的数据类型的值，例如文本那整数那布尔和listItemId．最大长度:48个字符

数量

名称 类型 格式 描述
currencyCode 字符串 - 要求费用报告货币的3个字母ISO 4217货币代码，基于创建报告时用户指定的报销货币。例子:美元- 美元;强——巴西雷亚尔;计算机辅助设计- 加拿大元;瑞士法郎- 瑞士法郎;欧元欧元;GBO- 英镑;港币-港元;印度卢比——印度卢比;麦根- 墨西哥比索;诺克- 挪威克朗;se——瑞典克朗
价值 数字 双 要求规定货币的金额。

ExpenseSourceIdentifiers

名称 类型 格式 描述
creditCardTransactionId 字符串 - 信用卡事务的唯一标识符(索引)TransmactionID.）与费用相关联。
ereceiptId 字符串 - -
expenseCaptureImageId 字符串 - 与费用相关联的费用捕获图像的唯一标识符。
jptRouteId 字符串 - 识别日本铁路路线的唯一标识符。
personalCardTransactionId 字符串 - 与费用相关的个人卡交易的唯一标识符。
quickExpenseId 字符串 - 与费用相关联的移动费用的唯一标识符。
分段 整数 int64 与费用相关联的段的唯一标识符。
segmentTypeId 字符串 - 与行程相关的段类型ID。支持的值：机场- 飞机票，艾苏- 航空订阅，CARRT- 汽车出租，迪纳丁- 用餐，事件——事件,酒店-酒店预订,insur- 保险，Limof.——豪华轿车预订,MISC杂,PARKG停车费,RAILF火车票,RAISU- 训练订阅，报价出租汽车费,签证——签证
tripId 整数 int64 与费用相关的旅行ID的唯一标识符。

汇率

名称 类型 格式 描述
手术 字符串 - 要求汇率操作。支持的值：乘或划分
价值 数字 双 要求汇率值。

ExpenseTaxSummary

名称 类型 格式 描述
netAdjustedTaxAmount 数量 - 净调整税金额。
netReclaimAdjustedAmount 数量 - 净回收调整金额。
netreclaimamount. 数量 - 净回收金额。
netTaxAmount 数量 - 净税额。
totalReclaimAdjustedAmount 数量 - 总回收调整金额。
TotalReclaimPostedamount. 数量 - 回收的总金额。
totalTaxAdjustedAmount 数量 - 税收调整总金额。
totalTaxPostedAmount 数量 - 税收总额。
vatTaxTotal 数量 - 增值税总额。

ExpenseType

名称 类型 格式 描述
代码 字符串 - 费用类型的代码。
id 字符串 - 要求费用类型的唯一标识符。最大长度:5个字符。例子：BRKFT
isdeleted 布尔 真正的/假 返回的费用类型是否已删除。
的名字 字符串 - 费用类型的名称(本地化为接收语言标题）。

地点

名称 类型 格式 描述
城市 字符串 - 城市的位置。
国家代码 字符串 - 位置国家ISO 3166-1代码。
countrySubDivisionCode 字符串 - 所在国分部ISO 3166-2代码。
id 字符串 - 该位置的唯一标识符。指定位置ID（创建或更新资源时），将忽略其他位置对象字段。
的名字 字符串 - 位置名称(本地化为接收语言标题）。

里程

名称 类型 格式 描述
hasCaravanAttached 布尔 真正的/假 里程费用是否有大篷车或拖车附在车上。默认：假
hasdogincluded 布尔 真正的/假 里程费用是否包括用于工作目的的狗。默认：假
hasforestorconstructionsitoroadinRoute. 布尔 真正的/假 无论里程路线是通过森林道路还是建筑工地道路。默认：假
hasForestRoadInRoute 布尔 真正的/假 里程路线是否有森林公路。默认：假
hasmachinery. 布尔 真正的/假 无论是机器或设备是否在汽车中运输，以获得此里程费用。默认：假
hasMobileCanteenOrHeavyLoadAttached 布尔 真正的/假 里程费用是否具有移动食堂或者正在运输到汽车上的重载。默认：假
hasTrailerAttached 布尔 真正的/假 里程费用是否挂在汽车上。默认：假
isMarkedAsHigherRate 布尔 真正的/假 里程费是否适用更高的费率。默认：假
odometerEnd 整数 int32 里程表在旅途结束时阅读。
odomatomertart. 整数 int32 旅程开始时里程表上的读数。
passengerCount 整数 int32 在旅途中车辆中的乘客数量。
个人竞争 整数 int32 旅程的部分归因于个人使用。默认：0.
routeId 字符串 - 这次旅行的路线的唯一标识符。
mysound。 整数 int32 要求这次旅行的总距离。
vehicleId 字符串 - 要求用于这次旅行的车辆的唯一标识符。

PaymentType

名称 类型 格式 描述
代码 字符串 - 支付类型的代码。
id 字符串 - 要求付款类型的唯一标识符。最大长度：4个字符。例子：现金
的名字 字符串 - 支付类型的名称(本地化为接收语言标题）。

ReceiptType

名称 类型 格式 描述
id 字符串 - 要求收据类型的唯一标识符。支持的值：N- 没有收据，R.——普通收据,T.——税收收据。默认值:N
状态 字符串 - 收货状态(本地化为接收语言标题）。

旅行

名称 类型 格式 描述
airlefeetypecode. 字符串 - 航空公司费用类型代码。支持的值：白格斯那布林那OBENT那ONBRD那其他那PRACC那座位那Tkchg.那UPGRD
airlineFeeTypeName 字符串 - 本地化的航空公司费用类型名称。
airlineServiceClassCode 字符串 - 航空公司服务等级代码。支持的值：布林那教练那第一个
airlineServiceClassName 字符串 - 本地化的航空公司服务类名。
CARRITANTDAYS. 整数 int32 租车的天数。最小值:0.
endLocation 字符串 - 旅行结束的地点。最大长度:100个字符
hotelCheckinDate 字符串 YYYY-MM-DD 费用的入住日期。
hotelCheckoutDate 字符串 YYYY-MM-DD 酒店结帐日期的费用。
启动分配 字符串 - 旅行开始的地点。最大长度:100个字符
票号 字符串 - 与旅行有关的机票号码。最大长度：32个字符

TravelAllowance

名称 类型 格式 描述
dailyLimitAmount 数字 双 基于政府旅行津贴率的允许金额。
dailyTravelAllowanceId 字符串 - 与费用相关的固定日常旅行津贴ID。最大长度：32个字符
isExpensePartOfTravelAllowance 布尔 真正的/假 费用是旅行津贴的一部分。默认值:假

供应商

名称 类型 格式 描述
描述 字符串 - 供应商的描述。最大长度:64个字符
id 字符串 - 供应商的唯一标识符。
的名字 字符串 - 供应商的名称(根据接收语言标题）。

UpdateReportExpense

名称 类型 格式 描述
批准justedamount. 数量 - 批准人的费用调整的总金额。
authorizationRequestExpenseId 字符串 - 授权请求费用ID与费用相关联。
budgetAccrualDate 字符串 YYYY-MM-DD 预算发生日期。
商业目的 字符串 - 用户用于业务目的的文本输入。最大长度:64个字符
评论 字符串 - 描述费用的评论。最大长度：2000个字符
customData CustomData - 来自的细节customData字段。这些字段可能没有数据，这取决于配置。
汇率 汇率 - 费用的汇率数据。
费用 字符串 - 要求费用来源。支持的值：ea——费用助理,暴徒——移动,其他未知,SE——聪明的费用,助教- 旅行津贴，TR——旅行请求,用户界面——Web UI
expensetype. ExpenseType - 费用的费用类型数据。
hasMissingReceiptDeclaration 布尔 真正的/假 费用是否有丢失收据的宣誓书。
IscopyDownInherited. 布尔 真正的/假 如果真正的，报表费用字段中的任何更改都将按照配置向下复制到逐项和拨款中。
isExcludedFromCashAdvanceByUser 布尔 真正的/假 用户是否从现金提前排除了费用。
IsexpenseBillable. 布尔 真正的/假 费用是否可以计费。
Isexpense重入 布尔 真正的/假 批准者或处理器是否在报告中拒绝了此费用。如果真正的然后，此费用将被发送回报附录（拆分）报告中提交的报告。
isPaperReceiptReceived 布尔 真正的/假 是否已收到费用。
ispersonalexpense. 布尔 真正的/假 该费用是否被用户标记为个人(不可报销)。
jptRouteId 字符串 - 识别日本铁路路线的唯一路线ID。
地点 地点 - 费用的位置数据。
merchantTaxId 字符串 - 用于支付费用的商人税号。最大长度:64个字符
里程 里程 - 与费用相关的里程数据。
支付方式 PaymentType - 支付类型数据的费用。默认：现金
receiptImageId 字符串 - 与费用关联的图像的唯一标识符。
收据 ReceiptType - 收据类型为费用。
smartExpense SmartExpense - 与此费用相关的智能费用数据。
税 税 - 与费用相关的税务数据。
taxRateLocation 字符串 - 事务位置相对于由用户配置文件定义的员工的家庭位置。支持的值：外国的- 费用交易以外币进行，首页-费用交易以偿还货币进行，Out_of_Province.- 在国家司法管辖区外发生费用交易
transactionAmount 数量 - 以交易货币支付给供应商的费用金额。
transactionDate 字符串 YYYY-MM-DD 费用的交易日期(ISO-8601)。
旅行 旅行 - 旅行数据与费用相关联。
travelAllowance TravelAllowance - 与费用相关的差旅津贴数据。
供应商 供应商 - 费用的供应商数据。

SmartExpense

名称 类型 格式 描述
creditCardTransactionId 字符串 - 信用卡事务的唯一标识符(索引)TransmactionID.）与费用相关联。
ereceipt Ereeceipt. - 费用收据信息。
expenseAttendees ExpenseAttendees - 与智能费用相关的与会者详细信息。
isAutoCreated 布尔 真正的/假 是否自动创建此开销。此元素仅适用于POST费用请求。默认：假
personalCardTransactionId 字符串 - 与费用相关的个人卡交易的唯一标识符。
quickExpenseId 字符串 - 与费用相关联的移动费用的唯一标识符。当quickExpenseId是指定的,交换字段值将被忽略，其值将从汇率货币服务读取。交换仍将受到尊敬。
旅行 旅行 - 与费用相关的旅行数据。

税

名称 类型 格式 描述
Expensetax1. ExpenseTax - 要求费用的税收数据。
Expensetax2. ExpenseTax - 费用的税收数据。

ExpenseTax

名称 类型 格式 描述
customData CustomData - 来自的细节customData字段。这些字段可能没有数据，这取决于配置。
reclaimCode 字符串 - 税收回收代码。最大长度：20个字符
reclaimTransactionAmount 数字 双 退税交易金额。
taxAuthorityId 字符串 - 要求税务机关的唯一标识符。
taxAuthorityName 字符串 - 税务机关的名称。
税法 字符串 - 税法。最大长度：20个字符
taxFormId 字符串 - 与费用相关的纳税表格的唯一标识符。
taxLabel 字符串 - 税务机关的本地化标识。
划分税前类型 字符串 - 税率类型ID的唯一标识符。
taxRateTypeName 字符串 - 税率类型的名称。
taxReclaimConfigurationId 字符串 - 税收回收配置ID的唯一标识符。
taxTransactionAmount 数字 双 二税务成交金额。

Ereeceipt.

名称 类型 格式 描述
carereceipt. CarEReceipt - eReceipt汽车数据。
hotelEReceipt HotelEReceipt - eReceipt酒店数据。
id 字符串 - 要求Ereeceipt的唯一标识符，费用。
imageid. 字符串 - 与费用相关联的Ereeceipt图像的唯一标识符。
templateURL 字符串 - Ereeceipt模板的URL。最大长度：512个字符
类型 字符串 - 要求与费用相关的收据类型。支持的值：空气那车那GASXX那一般那GRTRN那酒店那JPT那饭菜那办公室那Prkng.那铁路那骑那船舶那TELEC

HotelEReceipt

名称 类型 格式 描述
calculatedDailyRate 数字 双 计算出的旅馆日房价。
结束日期 字符串 YYYY-MM-DD 酒店结帐日期。
locationId 字符串 - 这个酒店位置的唯一标识符。
开始日期 字符串 YYYY-MM-DD 酒店入住日期。
totalAmountPaid 数量 - 支付的总金额。
供应商名称 字符串 - 酒店供应商的名字。最大长度:255个字符。例子:希尔顿那西雅图喜来登的福朋酒店

CarEReceipt

名称 类型 格式 描述
calculatedDailyRate 数字 双 计算的租车日费率。
carClass 字符串 - 汽车类。最大长度：4个字符。例子:idad.那ECMZ那PCAV.那IGDV
currencyCode 字符串 - 3字母ISO 4217货币代码。例子:美元- 美元，强——巴西雷亚尔计算机辅助设计——加拿大元
结束日期 字符串 YYYY-MM-DD 汽车租赁结束日期。
fuelServiceCharge 数字 双 燃油服务费。最小值：0
numberOfRentalDays 整数 int32 租车天数计算。最小值：0
开始日期 字符串 YYYY-MM-DD 汽车租赁开始日期。
单位驱动 整数 int32 驱动的总单位。最小值：0
供应商名称 字符串 - 汽车供应商的名称。最大长度:255个字符。例子：ABC租车公司

Expenseattendee

名称 类型 格式 描述
associatedAttendeeCount 整数 int32 参加者的总数。一个大于1(1)的计数意味着这个费用-出席者记录中有未命名的出席者。默认值:1
与会者 字符串 - 要求SAP Confur解决方案中的相关费用与会者的唯一标识符。
customData CustomData - 来自的细节customData字段。这些字段可能没有数据，这取决于配置。
isAmountUserEdited 布尔 真正的/假 此字段指示最终用户是否曾经手动编辑过该费用的参与者的金额值。默认：假
isTraveling 布尔 真正的/假 费用发生时与会者是否正在旅行。用于FBT税计算。
transactionAmount 数字 双 分配给该参与者的费用交易金额的部分，用于跨时间段的个人费用跟踪和参与者总数。
versionNumber 整数 int32 与会者的版本号。根据配置，该字段值始终可以是一个（1）。默认：1

ExpenseAttendees

名称 类型 格式 描述
expenseAttendeeList Expenseattendee - 与费用有关的参会者名单。最大的参与者:500
noshowattendeCount. 整数 int32 计划好的但没有出席的人数。默认值:0.

旅行

名称 类型 格式 描述
空气局衣 AirTrip - 与费用相关的航空旅行数据。
bookingOrigin 字符串 - 预订行程的出发地。支持的值：AETM——Amadeus电子旅行,CLIQ大有- 同意旅行，PANM——开放预订,TRPTTripIt,TSUP——旅游供应商
预订源 字符串 - 行程的预订来源。最大长度:48个字符。例子:Expedia那Travelocity那手册
墨迹 CarTrip - 与费用相关的汽车旅行数据。
cliqbookPaymentId 整数 int32 与旅行相关的Cliqbook付款ID。
cliqbookPaymentMethod 字符串 - 与旅行相关的Cliqbook付款方式。支持的值：GHOST_CARD或FLGHT_PASS
饭店 HotelTrip - 与费用相关的酒店旅行数据。
merchantCode 字符串 - 与旅行相关联的商家代码。最大长度：4个字符
骑号 RideTrip - 与费用相关的乘车或打车数据。
分段 整数 int64 要求与费用相关联的段的唯一标识符。
segmentTypeId 字符串 - 要求与行程相关的段类型ID。支持的值：机场- 飞机票，艾苏- 航空订阅，CARRT- 汽车出租，迪纳丁- 用餐，事件——事件,酒店-酒店预订,insur- 保险，Limof.——豪华轿车预订,MISC杂,PARKG停车费,RAILF火车票,RAISU- 训练订阅，报价出租汽车费,签证——签证
startlocationid 字符串 - 与之关联的起始位置的唯一标识符。
tripId 整数 int64 要求与费用相关的旅行ID的唯一标识符。

HotelTrip

名称 类型 格式 描述
calculatedDailyRate 数字 双 计算出的旅馆日房价。
结束日期 字符串 YYYY-MM-DD 酒店结帐日期。
numberoftode. 整数 int32 有多少个夜晚。最小值:1
numberOfRooms 整数 int32 酒店房间的数量。最小值:1
开始日期 字符串 YYYY-MM-DD 酒店入住日期。
totalAmountPaid 数量 - 支付的总金额。
供应商名称 字符串 - 酒店供应商的名字。最大长度:255个字符。例子:希尔顿那西雅图喜来登的福朋酒店

AirTrip

名称 类型 格式 描述
airlineName 字符串 - 航空公司供应商的名称。最大长度:255个字符。例子：阿拉斯加航空公司
结束日期 字符串 YYYY-MM-DD 最后旅行日期或旅行结束日期。
numberOfTravelDays 整数 int32 旅行的天数。最小值:1
开始日期 字符串 YYYY-MM-DD 第一次旅行日期或旅行开始日期。
ticketType 字符串 - 航空公司的服务等级。最大长度:10个字符。例子：经济
totalAmountPaid 数量 - 支付的总金额。

RideTrip

名称 类型 格式 描述
开始日期 字符串 YYYY-MM-DD 开始骑行的日期。
totalAmountPaid 数量 - 支付的总金额。
供应商名称 字符串 - 卖主的名字。最大长度:255个字符。例子：黄色驾驶室

CarTrip

名称 类型 格式 描述
calculatedDailyRate 数字 双 计算的租车日费率。
carClass 字符串 - 汽车类。最大长度:10个字符。例子:idad.那ECMZ那PCAV.那IGDV
结束日期 字符串 YYYY-MM-DD 汽车租赁结束日期。
Numberofcar. 整数 int32 出租汽车的数量。最小值:1
numberOfRentalDays 整数 int32 租车天数计算。最小值:0.
开始日期 字符串 YYYY-MM-DD 汽车租赁开始日期。
totalAmountPaid 数量 - 支付的总金额。
供应商名称 字符串 - 汽车供应商的名称。最大长度:255个字符。例子：ABC租车公司
名称 类型 格式 描述
弃用 字符串 - -
href 字符串 - 要求相关的URLHATEOAS链接您可以用于后续调用。
hreflang 字符串 - -
isTemplated 布尔 真正的/假 要求是否href是参数化的。
媒体 字符串 - -
方法 字符串 - 要求相关调用所需的HTTP方法。
rel. 字符串 - 要求描述如何的链接关系href涉及API呼叫。
标题 字符串 - -
类型 字符串 - -

ErrorMessage

名称 类型 格式 描述
错误 字符串 - 与响应关联的错误的唯一标识符。
errorMessage 字符串 - 要求详细错误消息。
httpstatus. 字符串 - 要求HTTP响应代码和响应短语。
路径 字符串 - 要求尝试请求的URI。
时间戳 字符串 日期-时间 要求捕获错误的时间。
validationErrors ValidationError - 验证错误消息。

ValidationError

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