此API已被弃用。

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

详情请参阅API生命周期和弃用政策。

Concur Travel Request旨在通过要求员工在发生费用前获得批准来帮助企业控制费用。Travel Request资源提供了查看请求和更新旅行请求工作流的功能。

请求版本1.0检索多达1000个旅行请求的列表。请求可以包含一个或多个搜索项。该资源支持以下操作:

版本

1.0

身份验证

Travel Request web服务支持OAuth 2.0身份验证模型。web服务请求所需的任何附加元素都包含在函数文档中。不支持公司级令牌。

获取旅行请求列表

请求

参数

参数 描述
requestslist 要求requestslist关键字。
?状态={地位} 的地位搜索词指定返回的旅行请求或批准状态。如果没有地位值发送时，将使用默认的Active状态。有关所有状态的列表，请参见状态值．
? loginid = {loginid} LoginID是旅行请求所有者的Concur登录，该所有者不是OAuth消费者。这将响应限制为指定用户拥有的旅行请求。如果您将此与TOAPPROVE或APPROVED Status搜索词一起使用，您应该发送旅行请求批准人的登录ID。
？modifiedawterdate = {date} 这返回在指定日期和时间后修改关联的依赖项（标题，条目，段，分配，与会者，评论）的旅行请求。此搜索项可以随着其他搜索术语使用，以缩小结果。日期和时间（如果需要）应该在UTC中。格式是：yyyy-mm-ddthh：mm：ss
？ModifiedBefordate = {date} 这返回在指定日期和时间之前修改关联的依赖项（标题，条目，段，分配，与会者，评论）的旅行请求。此搜索项可以与其他搜索条件一起使用以缩小结果。日期和时间（如果需要）应该在UTC中。格式是：yyyy-mm-ddthh：mm：ss

状态值

价值 描述
积极的 返回所有有效的旅行请求。
UNSUBMITTED 返回未提交的旅行请求。
待办的 返回提交的待批准的旅行请求。
验证 返回已批准的旅行申请。
取消了 退货已取消的旅行请求。
关闭 返回关闭的旅行请求。
提交 返回提交的旅行请求。
TOAPPROVE 返回待批准的旅行请求。如果将此搜索词与登录ID搜索词一起使用，则应该提供审批人的登录ID。
批准 返回已批准的旅行申请。如果将此搜索词与登录ID搜索词一起使用，则应该提供审批人的登录ID。

例子

https://www.concursolutions.com/api/travelrequest/v1.0/requestslist/ https：//www.concursolutions.com/api/travelrequest/v1.0/requestslist?status= {status} https：// www．concursolutions.com/api/travelrequest/v1.0/requestslist?loginid={loginID} https://www.concursolutions.com/api/travelrequest/v1.0/requestslist?modifiedafterdate={date} https://www.concursolutions.com/api/travelrequest/v1.0/requestslist?modifiedafterdate=2012-01-01T00:00:00 https://www.concursolutions.com/api/travelrequest/v1.0/requestslist?modifiedbeforedate={date} https://www.concursolutions.com//api/travelrequest/v1.0/requestslist?modifiedbeforedate=2012-01-01T00:00:00 https://www.concursolutions.com/api/travelrequest/v1.0/requestslist?status={status}&loginid={loginID}

头

授权头

授权头必须包含有效的Concur用户的OAuth令牌。OAuth消费者必须具有以下角色:专业/高级的Web服务管理员。

Accept标头

应用程序/ XML

回复

这个请求将返回一个RequestSwithCount.父元素与RequestsList和总数儿童元素。的RequestsList父元素包含RequestSummary.每个旅行请求的子元素。的RequestSummary.元素将具有以下子元素。

RequestSummary元素

元素名称 描述
QueedId. 出现在Concur UI中的旅行请求的唯一标识符。
RequestName 旅行请求的名称。
目的 旅行请求的目的。
RequestCurrency 的3字母ISO 4217货币代码旅行请求货币。
RequestTotal 旅行请求的总金额。
查询日期 创建旅行请求日期。
开始日期 开始日期旅行请求。
EndDate 旅行请求的结束日期。
持久 关于旅行请求的最新评论文本。
RequestDetailsurl. 访问旅行请求详细信息的URL。
RequestUserLoginID 该旅行请求的用户的登录ID属于。
批准者 用户旅行请求审批人的登录ID。
EmployeeName 旅行请求所有者的名称。
ApprovalStatus. 旅行请求的批准状态，以OAuth消费者的语言表示。

获取旅行请求详情

请求

检索旅行请求的完整信息集。包括旅行请求标题，部分，入口，分配和现金预支细节。

参数

请求/ {ComplequeKey.｝：所需旅行请求的请求关键字和标识符。必需的。

例子

https://www.concursolutions.com/api/travelrequest/v1.0 / requests/ {重键}

乌利来源:中提供了URIObjectURI元素的事件通知要求。

头

授权头

授权标题必须为有效的同意用户提供OAuth令牌。OAuth消费者必须同意以下用户角色之一：公司管理员或Web服务管理员专业，或者可以为标准管理。这些角色允许用户管理整个公司的数据。

Accept标头

应用程序/ XML

回复

这个请求将返回一个TravelRequestDetails带有以下子元素的父元素。

travelrequestdetails元素

元素名称 描述
登录ID 旅行请求所有者的同意登录ID。
QueedId. 旅行请求的独特密钥。
RequestKey 旅行请求的加密数据库密钥。
RequestName 旅行请求的名称。
目的 来自“目的”字段的信息。
CurrencyCode 的3字母ISO 4217货币代码旅行请求货币。旅行请求货币定义为旅行请求创建者的默认报销货币。
创建日期 创建旅行请求的日期。
hasexception. 旅行请求是否有例外。格式：y / n
eversentback. 旅行请求是否已被发送回员工。格式：y / n
EmployeeName 第一个，中间（或中间名），以及创建旅行请求的员工的姓氏。
approvalstatusname. 旅行请求的批准状态。
approvertatuskey. 审批状态键。
授权 旅行请求授权的日期。此元素具有名为i：nil的属性。如果此元素的值为null，则i：nil属性将设置为true。格式：YYYY-MM-DDTHH：MM：SS
SubmitDate 提交旅行请求的日期。格式：YYYY-MM-DDTHH：MM：SS
LastModifiedDate. 旅行请求最后修改的日期。格式：YYYY-MM-DDTHH：MM：SS
semmenct. 旅行请求中的段数。
Custom1到Custom20. 自定义字段中的详细信息。这些可能没有数据，具体取决于配置。如果自定义字段是列表字段，则数据将返回为:(列表项短代码）列表项名称。列表现场示例：（1234）项目1234
TravelRequestPolicyKey 应用于旅行请求的策略的唯一标识符。
ExpensePolicyKey 与差旅请求策略相关的费用策略的唯一标识符。
RequestTotal 旅行请求的总金额。
TotalAckavedAmount. 旅行请求中批准的费用总额。
TotnerRemainingAmount. 旅行请求中剩余的总额。
Approvallimitdate. 旅行请求必须批准的日期。仅在与同意旅行集成时出现。
宗旨办公室 原子能机构办公室关键。
AgencyOfficeName 机构办公室名称。
开始日期 旅行请求的开始日期。
EndDate 旅行请求的结束日期。
开始时间 旅行请求的开始时间。
时间结束 旅行请求的结束时间。
ExtensionOf 此旅行请求的初始旅行请求的ID是扩展或附件的扩展。
WorkFlowIactionURL. 将工作流程操作发布到旅行请求的URL发布请求工作流程操作函数。
commentcount. 与旅行请求头相关的评论数量。
CommentsList 这个父元素有一个Count属性，指示旅行请求头中包含的注释的数量。它有一个评论子元素。有关子元素的完整列表，请参见Comment Child Elements表。
ExceptionCount 与旅行请求标头关联的异常数。
异常表 此父元素有一个Count属性，指示旅行请求条目中包含的异常数量。它有一个例外每个例外的子元素。有关子元素的完整列表，请参阅异常子元素表。
EntriesList 此父元素具有一个Count属性，指示旅行请求中包含的旅行请求条目的数量。它有一个请求服每个条目的子元素。有关子元素的完整列表，请参阅请求企业子元素表。
储麦列表 此父元素具有计数属性，指示旅行请求中包含的现金预付款数量。它有一个CashAdvance每个现金提前的儿童元素。请参阅“储存”儿童元素表的全部名单。

评论元素

元素名称 描述
评论 旅行请求标题注释的文本。
FirstName 发表评论的人的名字。
姓 发表评论的人的姓氏。
约会时间 时间，在GMT，当用户发表评论时。

例外元素

元素名称 描述
例外码 为异常定义的系统异常代码。例如:BADCODE
例外 为异常定义的面向用户的消息。
ExceptionLevel 与异常相关的数字级别。例：99

RequestEntry元素

元素名称 描述
requestentrykey. 旅行请求条目的唯一标识符。
EntryDescription 来自描述字段的文本。
TransactionDate 旅行请求条目的日期。
RequestKey 旅行请求的唯一标识符。
FormKey 旅行请求条目表单的唯一标识符。
ExpenseTypeKey 费用类型的唯一标识符。
expensetypename. 费用类型名称。
ExchangeRate 适用于条目的汇率。
ForeignAmount 旅行请求条目的外币金额。
figndcurrencyname. 外汇金额的货币名称。
PostedAmount 在旅行请求货币中旅行请求条目的过账金额。
ApprovedAmount 旅行请求条目的批准金额在旅行请求货币中。
RemainingAmount 旅行请求条目中的剩余金额在旅行请求货币中。
LastModifiedDate. 最后修改条目的日期。格式：YYYY-MM-DDTHH：MM：SS
orgunit1通过orgunit6. 来自ORG单元自定义字段的详细信息。这些可能没有数据，具体取决于配置。
Custom1到Custom40. 自定义字段中的详细信息。这些可能没有数据，具体取决于配置。如果自定义字段是列表字段，则数据将返回为:(列表项短代码）列表项名称。列表现场示例：（1234）项目1234
AllocationsList 这个父元素有一个分配每个相关分配的子元素。有关子元素的完整列表，请参阅分配子元素表。
commentcount. 与旅行请求条目相关的评论数。
CommentsList 这个父元素有一个Count属性，指示旅行请求条目中包含的注释的数量。它有一个评论子元素。有关子元素的完整列表，请参见Comment Child Elements表。
ExceptionCount 与旅行请求条目相关的例外数量。
异常表 此父元素有一个Count属性，指示旅行请求条目中包含的异常数量。它有一个例外每个例外的子元素。有关子元素的完整列表，请参阅异常子元素表。
semmenct. 与旅行请求条目相关联的段数。
SegmentsList. 此父元素包含一个部分与旅行请求相关联的每个段的子元素。有关子元素的完整列表，请参阅段子元素表。

分配儿童元素

元素名称 描述
Custom1到Custom20. 与分配关联的自定义字段。这些可能没有数据，具体取决于您的配置。如果自定义字段是列表字段，则数据将返回为:(列表项短代码）列表项名称。列表现场示例：（1234）项目1234
AllocationKey 分配的唯一标识符。
百分比 包括在这一分配中的费用的百分比。

段子元素

元素名称 描述
分段 段表的加密数据库主键。段的唯一标识符。
分段型 行程段的类型。格式：空气，汽车，酒店，铁路，餐厅，活动，豪华轿车，出租车，停车，其他
RecordLocator 仅当旅行请求与Concur travel集成时出现。
DepartureDate 这一段的出发日期。
DepartureTime 分部的出发时间。
到达日期 段的到达日期。
ArrivalTime 分部的到达时间。
FromLocationName 起始位置的名称。
fromlocationDetail. 起始位置的代码。
tolocationname. 结束位置的名称。
ToLocationDetail 结束位置的代码。
航班号 航段的航班号。仅当旅行请求与Concur travel集成时出现。
ClassOfServiceCode 来自Concur旅行的服务代码。仅当旅行请求与Concur travel集成时出现。
三倍体 与此段关联的Concur Travel行程的唯一标识符。仅当旅行请求与Concur travel集成时出现。
SegmentLocator 与此段关联的Concur Travel段的唯一标识符。仅当旅行请求与Concur travel集成时出现。
ExchangeRate 适用于该段的汇率。
ForeignAmount 细分市场的外汇金额。
figndcurrencyname. 该区段的外币金额的货币名称。
PostedAmount 在旅行请求货币中公布的部分金额。
ApprovedAmount 以旅行请求货币核定的部分金额。
RemainingAmount 旅行请求货币中剩余金额。
IsAgencyBooked 航空部门是被预订的代理商。格式：y / n。
IsSelfBooked 航段是否自行预订。格式：y / n
LastModifiedDate. 段最后修改的日期。格式：YYYY-MM-DDTHH：MM：SS
Custom1到Custom40. 与段关联的自定义字段。这些可能没有数据，具体取决于您的配置。如果自定义字段是列表字段，则数据将返回为:(列表项短代码）列表项名称。列表现场示例：（1234）项目1234
commentcount. 与该段相关的注释数。
CommentsList 此父元素具有指示段中包含的注释数的计数属性。它有一个评论子元素。有关子元素的完整列表，请参见Comment Child Elements表。
ExceptionCount 与旅行请求段相关的例外数量。
异常表 此父元素有一个Count属性，表示差旅请求段中包含的异常数量。它有一个例外每个例外的子元素。有关子元素的完整列表，请参阅异常子元素表。

CashAdvance子元素

元素名称 描述
CashAdvanceKey 预付款的唯一标识符。
AmountRequested 现金提前所要求的金额，以货币列入CurrencyCode元素。
CurrencyCode 的3字母ISO 4217货币代码为现金预支货币。
CurrencyName. 预支现金的货币名称。
ExchangeRate 适用于预付现金的汇率。
查询日期 现金提前要求的日期从详细的现金推进记录。
发行日期 现金预支的发行日期。
初期 现金预付款的初始余额。
approvalstatusname. 现金预付款的批准状态。
approvertatuskey. 唯一标识符，用于现金预付款的批准状态。
员工疗法代码 的3字母ISO 4217货币代码对于员工的货币（“家庭货币”）。
雇佣验证名表 雇员的货币名称(“本国货币”)。

例子

示例1:获取旅行请求列表

请求

get api / travelrequest / v1.0 / requestslist /？status =提交的https / 1.1主机：www.concursolutions.com授权：OAuth {Access令牌}

回复

<？XML Version =“1.0”编码=“UTF-8”？>XMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>< RequestsList >提交,等待批准< / ApprovalStatus >< ApproverLoginID >patdavis@example.com.< / ApproverLoginID >< RequestCurrency >美元< / RequestCurrency >< EmployeeName >克里斯米勒/><目标>d< RequestDate >2013-03-07T08：25：57< / RequestDate >https://www.concursolutions.com/api/travelrequest/v1.0/requests/nf0ma53XrNuqmoVSZesQZL99xN1xIg5dX< / RequestDetailsUrl >< RequestID >APXTTVR-2861-2< / RequestName >10.00000000< / RequestTotal >chrismiller@example.com< / RequestUserLoginID >< TotalCount >1< / TotalCount >< / RequestsWithCount >

示例2:获取旅行请求的详细信息

请求

获取API / TravelRequest / v1.0 /请求/ nxxkgllnroz3zhjbcrksaas23dsfs https / 1.1主机：www.consolutions.com授权：OAuth {Access令牌}

回复

XMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>< AgencyOfficeKey >1< AgencyOfficeName >旅行很棒2012 - 06 - 09 - t23:59:00Q_Pend.< / ApprovalStatusKey >< ApprovalStatusName >提交＆等待批准< / ApprovalStatusName >< AuthorizedDate我：否=“真的”/>2012 - 06 - 08 - t16:35:20< / LastModifiedDate ><储存列表>< CashAdvance >400.000000< / AmountRequested >A_NOTF.< / ApprovalStatusKey >< ApprovalStatusName >没有提交< / ApprovalStatusName >nu1p4xwrqdvwwactn5kznh1oxxfiz1z06< / CashAdvanceKey >< CommentsList我:type =“意见列表”/>< CurrencyCode >美元美元< EmployeeCurrencyCode >麦根< EmployeeCurrencyName >墨西哥，比索< / EmployeeCurrencyName >1.00000000000000<发行我：否=“真的”/>< RequestDate >2012-06-08T23：35：20< / RequestDate >< StartingBalance >0.01< CommentsList >< >的评论<评论>达拉斯销售会议之旅< DateTime >2012 - 06 - 08 - t16:35:20克里斯< / FirstName >磨坊主< / LastName >< / CommentsList >2012 - 06 - 08 - t23:33:39< CurrencyCode >麦根< EmployeeName >米勒,克里斯9/25/2012< / EndDate >11:59< / EndTime ><请求服>3.< / AllocationCount >< >分配nG p6tMeoepRby4MJptMA6 sf4ucfZW7d5y美元< / AllocationKey ><百分比>33.33333334> < /百分比（7732）Viajar< / Custom1 >（881991）Nuevos Proyectos< / Custom2 >< Custom3/>< Custom4/>（1234）项目1234< / Custom5 >< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>> < /分配< >分配ng $ p6tmeoeprg7jyl $ slxyxm43lbgtr0b< / AllocationKey ><百分比>33.3333333> < /百分比（7112）纯版< / Custom1 >（223817）Modelo Informatico< / Custom2 >< Custom3/>< Custom4/>（1234）项目1234< / Custom5 >< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>> < /分配< >分配ng $ p6tmeoeprtfxjejufhaw $ sdhh $ prhfl $ sd< / AllocationKey ><百分比>33.3333333> < /百分比（8826）Finanzas< / Custom1 >< Custom2/>< Custom3/>< Custom4/>（4321）项目4321< / Custom5 >< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>> < /分配8947.77000000< / ApprovedAmount >< CommentsList/>< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/><异常表/>14.01220000000000AIRFRBoleto de军用飞机638.57000000< / ForeignAmount >美元2012 - 06 - 08 - t16:35:20< / LastModifiedDate >8947.77000000< / PostedAmount >< RemainingAmount >8947.77000000nteaeqfud4aao6nfsxh7x3tgnk3 $ pyqifm.< SegmentCount >2< SegmentsList ><段>/>2012年9月21日< ArrivalTime >上午8:55< / ArrivalTime >年代< CommentsList/><离开>2012年9月21日< DepartureTime >上午6:15<异常表/><交换/>1066.< / FlightNumber >638.57000000< / ForeignAmount >美元< FromLocationDetail >墨西哥华雷斯Intl< FromLocationName >华雷斯Intl< / FromLocationName >< IsAgencyBooked >Y< / IsAgencyBooked >< IsSelfBooked >Y/>/>< RemainingAmount/>nLY990POOA2TVhHrpTZH sxmlZ1S4s5nVf美元<段分段器>1飞机票< ToLocationDetail >达拉斯Ft Worth国际公司，德克萨斯州达拉斯ft值得国际< / ToLocationName >< TripLocator >33519718< / TripLocator >2012 - 06 - 08 - t16:35:20< / LastModifiedDate >< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>> < /部分<段>/>9/25/2012< ArrivalTime >下午7:50< / ArrivalTime >年代< CommentsList/><离开>9/25/2012< DepartureTime >25点<异常表/><交换/>481.< / FlightNumber >638.57000000< / ForeignAmount >美元< FromLocationDetail >达拉斯Ft Worth国际公司，德克萨斯州< FromLocationName >达拉斯ft值得国际< / FromLocationName >< IsAgencyBooked >Y< / IsAgencyBooked >< IsSelfBooked >Y/>/>< RemainingAmount/>nly990pooa2xfrkuq $ sjqrgxki3zk0 $ pn54<段分段器>2飞机票< ToLocationDetail >墨西哥华雷斯Intl华雷斯Intl< / ToLocationName >< TripLocator >33519718< / TripLocator >2012 - 06 - 08 - t16:35:20< / LastModifiedDate >< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>> < /部分< / SegmentsList >< TransactionDate >2012-09-21T06：15：00< / TransactionDate ><请求服>3.< / AllocationCount >< >分配nG p6tMeoepROA p19BXBVIKWPf6FyHoC2k美元< / AllocationKey ><百分比>33.33333334> < /百分比（7732）Viajar< / Custom1 >（881991）Nuevos Proyectos< / Custom2 >< Custom3/>< Custom4/>（1234）项目1234< / Custom5 >< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>> < /分配< >分配nG p6tMeoepRBwXZeblcbD8giw9LbZm2FT美元< / AllocationKey ><百分比>33.3333333> < /百分比（7112）纯版< / Custom1 >（223817）Modelo Informatico< / Custom2 >< Custom3/>< Custom4/>（1234）项目1234< / Custom5 >< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>> < /分配< >分配nG p6tMeoepREmXR98pw3YLB4zFRxPasgE美元< / AllocationKey ><百分比>33.3333333> < /百分比（8826）Finanzas< / Custom1 >< Custom2/>< Custom3/>< Custom4/>（4321）项目4321< / Custom5 >< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>> < /分配4764.15000000< / ApprovedAmount >< CommentsList/>< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/><异常表/>14.01220000000000小屋酒店/住宿340.00000000< / ForeignAmount >美元2012 - 06 - 08 - t16:35:20< / LastModifiedDate >4764.15000000< / PostedAmount >< RemainingAmount >4764.15000000nteaeqfud4ta34cjqky3 $ pqosbxl6q4qtd.< SegmentCount >1< SegmentsList ><段>/>9/25/2012< ArrivalTime >上午12点< / ArrivalTime >/>< CommentsList/><离开>2012年9月21日< DepartureTime >上午12点<异常表/><交换/>< FlightNumber/>340.00000000< / ForeignAmount >美元< FromLocationDetail/>/>< IsAgencyBooked >Y< / IsAgencyBooked >< IsSelfBooked >Y/>/>< RemainingAmount/>nly990pooa2lqa0 $ pzpiwe6d0uu51z5dyo.<段分段器>47244773465酒店预订< ToLocationDetail/>< ToLocationName/>< TripLocator >33519718< / TripLocator >2012 - 06 - 08 - t16:35:20< / LastModifiedDate >< Custom1/>< Custom2/>< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>/>> < /部分< / SegmentsList >< TransactionDate >2012 - 09 - 21 - t23:59:00< / TransactionDate >< / EntriesList >< EntryCount >2< / EntryCount >N< / EverSentBack ><异常表/>< ExpensePolicyKey >ni6nfrt2vq7zszffgqvgnjeyfxkaxvggn.< / ExpensePolicyKey >/>< HasException >Ncmiller@example.com<目标>达拉斯的商务旅行< RequestID >337E.nyc7eqm $ pprgnouridp6bkoij8bntytr3.从墨西哥城旅行到达拉斯< / RequestName >13711.92000000< / RequestTotal >2012年9月21日< / StartDate可以><开始时间>上午6:15< /开始时间>2012-06-08T23：36：1013711.92000000< / TotalApprovedAmount >< TotalRemainingAmount >13711.92000000< / TotalRemainingAmount >< TravelRequestPolicyKey >n $ snd $ psi09k6nxqagonwgks76hozdylhds< / TravelRequestPolicyKey >< WorkflowActionURL >https：/www.concursolutions.com/api/travelrequest/v1.0/requests/n3cc3i7npbss5u2aofqvxao5t3hvfeqo/workflowation.（7732）Viajar< / Custom1 >（881991）Nuevos Proyectos< / Custom2 >< Custom3/>< Custom4/>< Custom5/>< Custom6/>< Custom7/>< Custom8/>< Custom9/>/>/>/>/>/>/>/>/>/>/>/>

邮政旅行请求标题

发布旅行请求标题信息，了解OAuth访问令牌中指定的用户的新或现有的旅行请求。旅行请求标题包含旅行请求的分类信息。

请求

参数

要求关键字的请求。必需的。

例子：

https://www.concursolutions.com/api/travelrequest/v1.0 / requests.

｛QueedId.｝：所需旅行请求的唯一标识符。在更新现有旅行请求时提供。可选的。

例子：

https://www.concursolutions.com/api/travelrequest/v1.0 / requests/ {Requestid}

乌利来源:返回requesttid值Get请求详细信息功能,Request-URL.此功能中的元素。

头

授权头

对于有效的Concur用户，授权头带有OAuth令牌。必需的。

在旅行请求中，此请求的OAuth消费者必须具有以下角色:请求用户。该角色允许用户创建旅行请求。

内容类型标题

应用程序/ XML

要求身体

这个请求应该包含一个请求带有以下子元素的父元素:

元素 必须(必须包含值)? 描述
的名字 Y 旅行请求的名称。
目的 取决于配置 出差请求的商务目的。最大长度:2000。
评论 取决于配置 旅行请求标题评论。
Custom1到Custom20. 取决于配置 旅行请求头部表单上的自定义字段。根据配置可能需要。
笔记:如果任何自定义字段配置为包含列表值，请参考邮寄自定义清单页，了解如何正确提交列表项值的信息。
开始日期 取决于配置 旅行请求的开始日期。格式:YYYY-MM-DD
开始时间 取决于配置 旅行请求的开始时间。格式：hh：mm：ss
EndDate 取决于配置 旅行请求的结束日期。格式:YYYY-MM-DD
时间结束 取决于配置 旅行请求的结束时间。格式：hh：mm：ss

笔记：有关所需字段和格式的列表，请参阅Travel Request Admin用户界面。

XML示例请求

POST /api/travelrequest/v1.0/requests HTTPS/1.1 Host: www.concursolutions.com Authorization: OAuth {access token} Content-Type: application/xml
<请求XMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”><名称>请求旅行到西雅图< /名称><目标>销售团队会议<评论>西北区域销售团队2012-09-30< / StartDate可以><开始时间>3：15< /开始时间>2012-10-05< / EndDate >15:25< / EndTime >> < /请求

回复

支持的内容类型

应用程序/ XML

响应体根元素

这个请求将返回一个RequestStatus.带有以下子元素的父元素:

元素 描述
状态 旅行请求的状态。
Request-URL. 将旅行请求报头细节发送到该旅行请求时使用的URI。

如果保存旅行请求标题触发异常，aRequestExceptions将提供父元素，其中包含RequestException.每个异常的父元素。的RequestException.元素包含以下元素。

RequestException子元素
元素 描述
EventCode 导致异常的事件。
ExceptionCod 公司定义的异常代码。
例外 公司定义的异常消息。在系统MISREQFLD异常的情况下，消息将列出缺少值的必需字段。
异常可见性 哪些用户能够看到异常。
是清楚的 请求处理器是否已清除异常。
severitylevel. 指示异常严重程度的数值。阈值可配置。

xml响应的示例，具有成功的旅行请求创建和例外

< RequestStatusXMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>< Request-Details-Url >https://www.concursolutions.com/api/travelrequest/v1.0/requests/nf0ma53xrn$s6z5ikrann6eisw89ate3m.< >状态成功< RequestExceptions >< EventCode/>< ExceptionCode >MissReqfld.< ExceptionErrorCode/>1< / ExceptionVisibility ><清晰>N< /清晰>缺少必需字段:Custom 02,Custom 03,Cash Advance，消息> < /2147483647<类型/>< / RequestException >

发布旅行请求工作流程

发布提供的旅行请求的工作流程操作。工作流程操作通过工作流程来移动旅行请求。可用的行动是：

  • 批准:为当前工作流批准者批准旅行请求。旅行请求将继续在工作流中进行，并可能需要基于配置的额外批准。
  • 寄回员工：旅行请求被发送回员工进行修订。当您发现必须由用户纠正的错误时，验证者和处理器使用此工作流程操作。当用户重新提交旅行请求时，它再次通过整个工作流程。
  • 召回员工:此工作流操作由员工发起，仅在提交旅行请求后可用。这个工作流操作很少被开发人员使用，并且由于配置的原因可能对某些客户端不可用。

两个不同的工作流程角色

每个工作流操作都与一个工作流角色相关联。当工作流操作不需要特定用户执行操作时，使用System角色。想要以编程方式评估旅行请求的开发人员可以使用System角色来提供工作流操作。

当工作流程步骤需要个人执行动作时，使用批准者角色。当批准者使用批准者角色评估旅行请求时，希望展示旅行请求列表和发送工作流程操作的开发人员。此角色要求用户在提供工作流程操作之前使用标准OAuth进行正确的恭维角色（请求审批人员或请求处理器）对用户进行身份验证。用户还必须具有提供的请求ID的访问权限（是有效的审批人或处理器）。

请求

请求参数

请求/ {WorkflowStepid.} / workflowaction：请求和工作键关键字和所需工作流程步骤的唯一标识符。必需的。

例子：https://www.concursolutions.com/api/travelrequest/v1.0 / requests/（requests/

乌利来源: URI是WorkflowStepURL元素的响应中找到的Get请求详细信息端点。workflowstepId必须与旅行请求的当前工作流步骤匹配。使用Get请求详细信息端点立即发送此请求，以保证您拥有当前WorkflowStepURL．

头

授权头

对于有效的Concur用户，授权头带有OAuth令牌。必需的。OAuth消费者必须同意以下用户角色之一：公司管理员或Web服务管理员专业，或者可以为标准管理。

内容类型标题

应用程序/ XML

要求身体

这个请求应该包含一个工作荧​​喷带有以下子元素的父元素:

元素 必须(必须包含值)? 描述
行动 Y 工作流操作的名称。可能的值是:批准，**发送回员工，或**召回员工．必须是工作流步骤可用的工作流操作之一。咨询请求管理员，工作流以了解细节。
评论 Y，代表送回员工 必须与发送回员工工作流程操作。在员工，批准者和/或处理器可获得旅行请求评论的地方可见此评论。

XML示例请求

Post API / TravelRequest / V1.0 /请求/ NX2WRNZP18 $ WJEHK％WQEL6EDHRWI9R $ PAQS1UQYL6A4QQ / WORKFLOMACTION HTTPS / 1.1主机：www.concursolutions.com授权：OAUTH {Access令牌}内容类型：应用程序/ XML
<工作荧光XMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”><行动>批准<评论>通过SAP Concur批准< / WorkflowAction >

回复

支持的内容类型

应用程序/ XML

响应体根元素

这个请求将返回一个ActionStatus带有以下子元素的父元素:

元素 描述
消息 错误消息。只有在生成工作流程操作错误时才出现
状态 旅行请求工作流程操作的状态。

XML成功响应的示例

<？XML Version =“1.0”编码=“UTF-8”？>< ActionStatusXMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>成功!消息> < /< >状态成功!

XML示例的响应失败

<？XML Version =“1.0”编码=“UTF-8”？>< ActionStatusXMLNS =“http://www.concursolutions.com/api/travelrequest/2012/06”xmlns:我=“http://www.w3.org/2001/XMLSchema-instance”>由于最近已更改了该项目，因此无法执行该操作。请刷新列表，然后重试。消息> < /< >状态失败