请求v3

此API已弃用。

使用已弃用API的合作伙伴和客户应该联系SAP Concur，并讨论如何转移到最新版本。

Concur Request自动化了旅行和日常支出的支出请求和批准流程，为您提供准确跟踪和更好地控制支出所需的数据。通过增加对计划支出和最新预算数据的可见性，您可以在实际支出发生之前做出战略性支出决策。Request资源提供了许多功能，包括查看请求和将请求转换到工作流。

检索所有请求
根据ID检索请求
根据ID提交请求
模式
- 请求
- 预付现金
- 评论
- 自定义
- 条目
- 分配
- 例外情况
- 段
- 用户权限
- 链接

版本

4．0(当前)
3．0
1．0

检索所有请求

GET / api / v3.0 / travelrequest /请求

参数

的名字	类型	格式	描述
`抵消`	`字符串`	`查询`	开始页面抵消
`限制`	`Int32`	`查询`	要返回的记录数量(默认为100)
`用户`	`字符串`	`查询`	拥有此请求的用户的登录ID。用户必须具有Web服务管理员(专业)或可以管理员(标准)用户角色才能使用此参数。
`状态`	`字符串`	`查询`	状态搜索词指定返回哪个旅行请求或批准状态。如果没有发送Status值，则使用默认的Active状态。
`modifiedAfter`	`DateTime`	`查询`	这将返回在指定日期和时间之后修改相关依赖项(头、条目、段、分配、参与者、注释)的旅行请求。这个搜索词可以与其他搜索词一起使用，以缩小搜索结果。日期和时间(如果需要)应该使用UTC。格式为:YYYY-MM-DDThh:mm:ss。
`modifiedBefore`	`DateTime`	`查询`	这将返回在指定日期和时间之前修改相关依赖项(头、条目、段、分配、参与者、注释)的旅行请求。这个搜索词可以与其他搜索词一起使用，以缩小搜索结果。日期和时间(如果需要)应该使用UTC。格式为:YYYY-MM-DDThh:mm:ss。
`withSegmentTypes`	`布尔`	`查询`	传递true以填充结果中的SegmentType字段。

根据ID检索请求

得到/ api / v3.0 / travelrequest /请求/ {id}

参数

的名字	类型	格式	描述
`id`	`字符串`	`路径`	要求请求ID
`用户`	`字符串`	`查询`	用户的登录ID。可选的。用户必须具有Web服务管理员(专业)或可以管理员(标准)用户角色才能使用此参数。

根据ID提交请求

POST / api / v3.0 / travelrequest /请求/ {id} /提交

参数

的名字	类型	格式	描述
`id`	`字符串`	`路径`	请求ID

模式

请求

的名字	类型	格式	描述
`AgencyOfficeName`	`字符串`	-	旅行社办公室名称。
`AllocationFormID`	`字符串`	-	段表单资源的唯一标识符（有关更多信息，请参阅“表单”资源）。
`ApprovalLimitDate`	`DateTime`	-	申请须获批准的日期。此元素仅在与Concur Travel集成时出现。
`ApprovalStatusCode`	`字符串`	-	请求的批准状态代码。
`ApprovalStatusName`	`字符串`	-	请求的批准状态。
`AuthorizedDate`	`DateTime`	-	请求被批准的日期。格式:YYYY-MM-DDThh: mm: ss。
`CashAdvances`	`数组`	预付现金	每个现金预支都有一个CashAdvance子元素。有关子元素的完整列表，请参阅CashAdvance模型。
`评论`	`数组`	评论	这个父元素的每个注释都有一个Comment子元素。有关子元素的完整列表，请参见Comment模型。
`创建日期`	`DateTime`	-	请求创建的日期。
`CurrencyCode`	`字符串`	-	请求货币的3个字母ISO 4217货币代码。请求货币被定义为请求创建者的默认偿付货币。
`货币名称`	`字符串`	-	请求货币的货币名称。请求货币被定义为请求创建者的默认偿付货币。
`通过Custom20 Custom1`	`海关总署`	-	来自自定义字段的详细信息。这些字段可能没有数据，这取决于配置。
`EmployeeName`	`字符串`	-	创建请求的员工的第一个、中间(或中间首字母)和姓。
`EndDate`	`字符串`	-	请求的结束日期。
`EndTime`	`字符串`	-	请求的结束时间。
`条目`	`数组`	条目	这个父元素的每个条目都有一个RequestEntry子元素。有关子元素的完整列表，请参阅RequestEntry模型。
`EverSentBack`	`字符串`	-	指示是否曾经将请求发送回雇员。格式:Y / N
`异常`	`数组`	例外情况	这个父元素对每个异常都有一个Exception子元素。有关子元素的完整列表，请参见Exception模型。
`ExtensionOf`	`字符串`	-	初始请求的ID，该初始请求是该请求的扩展或附录。
`HasException`	`字符串`	-	指示请求是否有异常。格式:Y / N
`HeaderFormID`	`字符串`	-	Header Form资源的唯一标识符(更多信息请参见“Forms”资源)。
`LastModifiedDate`	`DateTime`	-	请求最后修改的日期。格式:YYYY-MM-DDThh: mm: ss
`LoginID`	`字符串`	-	请求所有者的Concur登录ID。
`的名字`	`字符串`	-	请求的名称。
`PolicyID`	`字符串`	-	应用于此请求的策略的唯一标识符。最大长度64个字符。
`PolicyName`	`字符串`	-	应用于此请求的策略的名称。
`目的`	`字符串`	-	请求的目的。
`RequestID`	`字符串`	-	请求的唯一键。
`StartDate可以`	`字符串`	-	请求的开始日期。
`开始时间`	`字符串`	-	请求的开始时间。
`SubmitDate`	`DateTime`	-	提交请求的日期。格式:YYYY-MM-DDThh: mm: ss。
`TotalApprovedAmount`	`字符串`	-	申请中已批准的费用总额。
`TotalPostedAmount`	`字符串`	-	请求的总额。
`TotalRemainingAmount`	`字符串`	-	在申请中剩余的总费用。
`UserPermissions`	`UserPermissions`	-	允许用户对请求执行的操作。

预付现金

的名字	类型	格式	描述
`AmountRequested`	`字符串`	-	在现金预支中要求的金额，以CurrencyCode元素中指定的货币表示。
`ApprovalStatusName`	`字符串`	-	预支现金的审批情况。
`评论`	`数组`	评论	这个父元素的每个注释都有一个Comment子元素。有关子元素的完整列表，请参阅Comments模型。
`CurrencyCode`	`字符串`	-	3个字母的ISO 4217货币代码用于现金预支货币。
`货币名称`	`字符串`	-	预支现金的货币名称。
`EmployeeCurrencyCode`	`字符串`	-	3个字母的ISO 4217货币代码是员工的货币，也被称为本国货币。
`EmployeeCurrencyName`	`字符串`	-	雇员的货币名称，也称为本国货币。
`ExchangeRate`	`字符串`	-	适用于预付现金的汇率。
`IssueDate`	`DateTime`	-	现金预支的发行日期。
`RequestDate`	`DateTime`	-	从详细的现金预支记录中获得的预支日期。
`StartingBalance`	`字符串`	-	预支现金的初始余额。

的名字	类型	格式	描述
`AuthorFirstName`	`字符串`	-	发表评论的人的名字。
`AuthorLastName`	`字符串`	-	发表评论的人的姓。
`CommentDateTime`	`DateTime`	-	用户发表评论的时间(以GMT为单位)。
`IsLatest`	`保龄球`	-	表示注释是最后一个注释。
`价值`	`字符串`	-	请求头注释的文本。

自定义

的名字	类型	格式	描述
`代码`	`字符串`	-	对于列表字段，这是列表项代码。
`ListItemID`	`字符串`	-	对于列表字段，这是列表项ID。
`类型`	`字符串`	-	自定义字段类型。可能的值:数量、布尔值、ConnectedList、日期、整数、列表、数字、文本
`价值`	`字符串`	-	Org Unit或Custom字段中的值。对于列表字段，这是列表项的名称。最大长度:48个字符

条目

的名字	类型	格式	描述
`分配`	`数组`	分配	对于每个关联的分配，这个父元素有一个Allocation子元素。有关子元素的完整列表，请参见Allocation模型。
`ApprovedAmount`	`字符串`	-	请求货币中请求条目的批准数量。
`评论`	`数组`	评论	这个父元素的每个注释都有一个Comment子元素。有关子元素的完整列表，请参见Comments模型。
`Custom1`通过`Custom40`	`海关总署`	-	来自自定义字段的详细信息。这些字段可能没有数据，这取决于配置。
`EntryDescription`	`字符串`	-	请求条目的描述。
`EntryFormID`	`字符串`	-	Entry Form资源的唯一标识符(有关更多信息，请参阅“Forms”资源)。
`异常`	`数组`	例外情况	这个父元素对每个异常都有一个Exception子元素。有关子元素的完整列表，请参见Exception模型。
`ExchangeRate`	`字符串`	-	适用于条目的汇率。
`ExpenseTypeName`	`字符串`	-	费用类型名称。
`ForeignAmount`	`字符串`	-	请求条目的外国金额。
`ForeignCurrencyCode`	`字符串`	-	3个字母的ISO 4217货币代码，用于请求条目的外币金额。
`ForeignCurrencyName`	`字符串`	-	外汇金额的货币名称。
`LastModifiedDate`	`DateTime`	-	最后修改条目的日期。格式:YYYY-MM-DDThh: mm: ss
`OrgUnit1`通过`OrgUnit6`	`海关总署`	-	来自Org Unit自定义字段的详细信息。这些字段可能没有数据，这取决于配置。
`PostedAmount`	`字符串`	-	请求货币中请求条目的已过金额。
`RemainingAmount`	`字符串`	-	请求货币中请求条目的剩余金额。
`段`	`数组`	段	这个父元素有一个Segment子元素，对应于与旅行请求相关联的每个段。有关子元素的完整列表，请参见Segment模型。
`TransactionDate`	`DateTime`	-	请求条目的日期。
`TripType`	`字符串`	-	[' ONE_WAY ' or ' ROUND_TRIP ' or ' MULTI_STOP ']航空或铁路段的行程类型。取值为:ONE_WAY、ROUND_TRIP和MULTI_STOP。

分配

的名字	类型	格式	描述
`Custom1`通过`Custom20`	`海关总署`	-	来自自定义字段的详细信息。这些字段可能没有数据，这取决于配置。
`百分比`	`字符串`	-	包括在这一分配中的费用的百分比。

例外情况

的名字	类型	格式	描述
`代码`	`字符串`	-	为异常定义的系统异常代码。例如:BADCODE
`水平`	`int`	-	与异常关联的数值级别。例子:99
`消息`	`字符串`	-	为异常定义的面向用户的消息。

段

的名字	类型	格式	描述
`ApprovedAmount`	`字符串`	-	请求货币中已批准的部分数量。
`ArrivalDate`	`字符串`	-	段的到达日期。
`ArrivalTime`	`字符串`	-	段的到达时间。
`ClassOfServiceCode`	`字符串`	-	来自Concur Travel的服务代码等级。仅当请求与Concur Travel集成时出现。
`评论`	`数组`	评论	为这个部分添加的评论列表。
`Custom1`通过`Custom40`	`海关总署`	-	来自自定义字段的详细信息。这些字段可能没有数据，这取决于配置。
`DepartureDate`	`字符串`	-	这一段的出发日期。
`DepartureTime`	`字符串`	-	段的出发时间。
`异常`	`数组`	例外情况	这个父元素对每个异常都有一个Exception子元素。有关子元素的完整列表，请参阅Exception模型。
`ExchangeRate`	`字符串`	-	适用于该部分的汇率。
`FlightNumber`	`字符串`	-	航段的航班号。仅当Request与Concur Travel集成时出现。
`ForeignAmount`	`字符串`	-	该段的外币金额。
`ForeignCurrencyCode`	`字符串`	-	由3个字母组成的ISO 4217货币代码表示区段的外币金额。
`ForeignCurrencyName`	`字符串`	-	该区段的外币金额的货币名称。
`FormTypeCode`	`字符串`	-	段类型的窗体类型代码。
`FromLocationDetail`	`字符串`	-	起始位置的代码。
`FromLocationID`	`字符串`	-	出发地点的唯一标识符。(更多信息请参见“位置”资源)。
`FromLocationName`	`字符串`	-	起始位置的名称。
`IsAgencyBooked`	`字符串`	-	指示该航段是否由代理商预订。格式:Y / N。
`IsSelfBooked`	`字符串`	-	指示是否自行预订了航段。格式:Y / N。
`LastModifiedDate`	`DateTime`	-	段最后修改的日期。格式:YYYY-MM-DDThh: mm: ss
`OutboundSegmentID`	`字符串`	-	REQ_SEGMENT_OUTBOUND_ID
`PostedAmount`	`字符串`	-	在请求货币中公布的部分金额。
`RecordLocator`	`字符串`	-	仅当请求与Concur Travel集成时出现。
`RemainingAmount`	`字符串`	-	请求货币中段的剩余金额。
`SegmentFormID`	`字符串`	-	段表单资源的唯一标识符（有关更多信息，请参阅“表单”资源）。
`SegmentLocator`	`字符串`	-	与此段关联的Concur Travel段的唯一标识符。仅当请求与Concur Travel集成时出现。
`SegmentType`	`字符串`	-	行程段的类型。形式:空中、汽车、酒店、铁路、餐饮、活动、地面、出租车、停车场等
`SegmentTypeCode`	`字符串`	-	行程段类型的代码。
`ToLocationDetail`	`字符串`	-	结束位置的代码。
`ToLocationID`	`字符串`	-	到达位置的唯一标识符。(更多信息请参见“位置”资源)。
`ToLocationName`	`字符串`	-	结束位置的名称。
`TripLocator`	`字符串`	-	与此段关联的Concur Travel行程的唯一标识符。仅当请求与Concur Travel集成时出现。

用户权限

的名字	类型	格式	描述
`链接`	`数组`	链接	允许用户对请求执行的操作。

链接

的名字	类型	格式	描述
`行动`	`字符串`	-	允许用户对资源执行的操作。
`方法`	`字符串`	-	请求的方法。取值范围:GET、POST、PUT和DELETE。
`Url`	`字符串`	-	用户可以访问的资源的URL。

请求v3

版本

检索所有请求

参数

根据ID检索请求

参数

根据ID提交请求

参数

模式

请求

预付现金

评论

自定义

条目

分配

例外情况

段

用户权限

链接