SAP Concur Developer Center | Travel Request v4 -端点-模式

架构

要求

名称	类型	格式	描述
`approvalLimitDate`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	请求必须批准的日期。仅在与Concur Travel集成时才会出现此元素。
`ApprovalStatus`	`对象`	`批准状态`	请求的批准状态。
`批准`	`布尔`	-	指示此请求是否已批准。
`审批人`	`对象`	`员工`	发送请求的批准者。
`授权`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	对于批准的请求，审批程序完成的日期。
`商业目的`	`细绳`	-	该请求的经营宗旨。
`canceledPostApproval`	`布尔`	-	表示此请求是否为`canceledPostApproval`．
`养老渣`	`对象`	`ResourceLink`	本申请的预支现金清单。
`关闭`	`布尔`	-	指示此请求是否已关闭。
`评论`	`细绳`	-	附加到此请求的最后一条评论。
`评论`	`对象`	`ResourceLink`	此请求的评论列表。
`创立日期`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	请求创建的日期。
`Custom1.`到`Custom20.`	`对象`	`CustomField`	自定义字段中的详细信息。这些字段可能没有数据，具体取决于配置。
`结束日期`	`日期`	[ISO 8601]`yyyy-MM-dd`	请求的结束日期。
`时间结束`	`时间`	[ISO 8601]`yyyy-MM-dd`	请求的结束时间。
`eversentback.`	`布尔`	-	指示是否曾经将请求发送回雇员。
`异常`	`对象`	`ResourceLink`	已提出到此请求的例外列表。
`费用`	`数组`	`ResourceLink`	附加到此请求的预期费用。
`的扩展`	`对象`	`RequestLink`	本请求是…的延伸或附录的请求。
`highestExceptionLevel`	`细绳`	-	此请求中包含的最高级别的例外。支持的价值观:`警告`，`错误`，和`没有一个`
`href`	`细绳`	[RFC 3986]	超链接到此请求的资源。
`ID`	`细绳`	-	请求的唯一标识符。
`lastModified`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	请求最后修改的日期。
`mainDestination`	`对象`	`地点`	请求的主要目的地。
`名称`	`细绳`	-	请求的名称。
`老板`	`对象`	`员工`	拥有请求的员工。
`Picending申请人`	`布尔`	-	指示此请求是否正在等待批准。
`政策`	`对象`	`ResourceLink`	应用于请求的策略。
`QueedId.`	`细绳`	4到6个字母数字字符	请求的公钥(每个客户唯一)。
`开始日期`	`日期`	[ISO 8601]`yyyy-MM-dd`	请求的开始日期。
`开始时间`	`时间`	[ISO 8601]`yyyy-MM-dd`	请求的开始时间。
`submitDate`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	提交请求的日期（召回的最后提交日期）。
`totalApprovedAmount`	`对象`	`数量`	请求中批准的预期费用总额，以员工创建请求时的报销货币表示。
`totalPostedAmount`	`对象`	`数量`	请求的总金额，以员工在创建请求时的偿付货币表示。
`TotnerRemainingAmount.`	`对象`	`数量`	不包含在费用报告中的总金额，以员工的报销货币在创建请求时表达。
`travelAgency`	`对象`	`ResourceLink`	旅行社办公室正在管理与此请求相关的行程。
`操作`	`数组`	`链接`	与请求可用的操作的链接取决于当前的工作流状态。
`类型`	`对象`	`请求类型`	请求的类型，继承自请求策略类型。

数量

名称	类型	格式	描述
`价值`	`数字`	-	要求以指定货币表示的金额。
`货币`	`细绳`	[ISO 4217：2015]	要求由3个字母组成的ISO 4217代码表示金额所使用的货币。

批准状态

名称	类型	格式	描述
`代码`	`细绳`	-	请求批准状态的代码。支持的价值观:`没有提交`，`提交`，`批准`，`取消了`，要么`送回`
`名称`	`细绳`	-	当前用户语言中请求的批准状态。

预借现金

名称	类型	格式	描述
`amountRequested`	`对象`	`数量`	请求中预支现金的数额，以所要求的预支现金的货币表示。仅对现金提前详细终点终点，金额架构将包含额外的`量`特征奇偶校验目的现场现金预付款API部分现金推进服务。这`价值`字段将很快被弃用，强烈建议依赖于`量`字段。
`ApprovalStatus`	`对象`	`现金提前批准状态`	预支现金的审批情况。
`救生圈`	`细绳`	-	现金预付款的唯一标识符。
`评论`	`细绳`	-	最后一条评论是关于这笔现金预支的。
`exchangeRate`	`对象`	`汇率`	适用于预付现金的汇率。
`发行日期`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。瑞士`	现金提升已发布日期。
`查询日期`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。瑞士`	提交现金预付款的日期（召回的最后提交日期）。

现金提前批准状态

名称	类型	格式	描述
`代码`	`细绳`	-	预支现金审批状态代码。支持的价值观:`C_PEND`，`C_APPR`，`C_Comp.`，`C_FILE`，`C_ISSU`，`C_NISU`，`c_notf.`，`C_PECA`，要么`c_reje.`
`名称`	`细绳`	-	现金预付款的批准状态在当前用户的语言中。

名称	类型	格式	描述
`作者`	`对象`	`员工`	雇员在预期的费用中创建了评论。
`创立日期`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。瑞士`	创建评论日期。
`isLatest`	`布尔`	-	如果`真的`，自上次工作流程转换以来已编辑注释。
`价值`	`细绳`	-	评论的价值。

CustomField

名称	类型	格式	描述
`代码`	`细绳`	-	列表项的短代码。对于非列表字段，此值将为空。
`价值`	`细绳`	-	非列表项的值。对于列表字段，这是列表项的唯一id。
`href`	`细绳`	-	在列表服务上获取此列表项的链接。为非列表项目空。

检索这一点listinemid.需要调用List API，该API目前正用于外部化。同时，要为创建Request或Expected Expense填充自定义列表项，客户端可以使用以下一种解决方法:

使用“副本关闭配置”功能将自定义字段从员工配置文件从请求标头更新，以及从请求标题到预期费用。
对于属于自定义字段的有限数量的列表项，可以手动创建包含相关自定义字段中这些值的请求。然后，通过调用这个请求的get细节来检索列表项唯一id。同样的过程用于列表的所有列表项值。

员工

名称	类型	格式	描述
`名`	`细绳`	-	员工的名字。
`href`	`细绳`	[RFC 3986]	超链接到资源。
`ID`	`细绳`	(RFC 4122)	相关对象的唯一标识符。
`姓`	`细绳`	-	员工的姓氏。
`middleInitial`	`细绳`	-	员工的中间首字母。
`模板`	`细绳`	-	将模板超链接到资源。

例外

名称	类型	格式	描述
`代码`	`细绳`	-	为异常定义的系统异常代码。例子：`坏码`
`isblocking.`	`布尔`	-	定义异常是否会阻止请求被提交。
`等级`	`整数`	-	与异常关联的数值级别。例子：`99`
`消息`	`细绳`	-	为异常定义的面向用户的消息。
`来源`	`数组`	`例外来源`	提出了例外的来源。
`参数`	`地图`	`想念`：缺少字段标签数组 `SISCESFIELDSIDS.`：缺少字段ID的数组	对于缺少字段异常，其他值提供缺少字段的更多标签和ID。例子：`参数：{“失踪域”：[“请求名称”，“目的”]，“MissingFieldSID”：[“名称”，“用途”]}`

例外来源

名称	类型	格式	描述
`href`	`细绳`	[RFC 3986]	超链接到资源。
`ID`	`细绳`	(RFC 4122)	源的唯一标识符。
`类型`	`细绳`	-	定义源的类型。支持的价值观:`分配`，`CASH_ADVANCE`，`费用`，和`头`

链接

名称	类型	格式	描述
`rel`	`细绳`	[RFC 5988]	服务器定义的关系类型。RFC 5988 6.2.2中列出了已注册的关系类型。初始注册表内容包括下一步，上一个和最后一个和最后一个。
`href`	`细绳`	[RFC 3986]	超链接到资源。

请求列表

名称	类型	格式	描述
`数据`	`数组`	`要求`	请求页面中的请求列表。
`操作`	`数组`	链接	链接到下一页，前页，第一页和最后一页。

请求策略列表

名称	类型	格式	描述
-	`数组`	`要求政策`	给定用户的活动请求策略列表。

地点

名称	类型	格式	描述
`城市`	`细绳`	-	所有城市位置类型(不包括机场或火车站- STD位置类型除外)城市名称的位置。注意：Rail的STD位置类型被视为城市位置类型，`城市`和`国家代码`在这种情况下，字段是必需的。
`国家代码`	`细绳`	[ISO 3166-1]	如果需要`城市`要么`名称`使用ISO 3166-1国家代码。
`COMPORTSUBDIVISIONCODE.`	`细绳`	(ISO 3166 - 2)	ISO 3166-2国家代码。
`iataCode`	`细绳`	-	如果需要`空气`使用机场所在地的国际航空运输协会代码。
`ID`	`细绳`	-	位置的ID。
`纬度`	`数字`	-	位置的纬度。
`locationCode`	`细绳`	-	如果需要`铁路`与RAIL_xx locationType一起使用位置的代码。可选的基于城市位置的段(在数据库中重复位置的情况下是必需的)。
`locationType`	`细绳`	-	如果需要`铁路`使用位置的类型。
`经度`	`数字`	-	位置的经度。
`名称`	`细绳`	-	该位置的名称。始终提供`国家代码`除了`名称`．

以下是Post Endpoints的不同节点，由地点类型（城市，火车站或机场） - 例如endLocation场地：

机场

         “endLocation”：｛“城市”：“莫斯科”，“名称”：“Sheremetyevo”，“countryCode”：“茹”，“iataCode”：“sov”｝
        

城市

         “endLocation”：｛“城市”：“维也纳”，“countryCode”：“在”｝
        

火车站(locationCode存在，locationType视乎铁路供应商而定)

         “endLocation”：｛“名称”：“马赛圣查尔斯。”，“countryCode”：“fr”，“位置码”：“FRMSC”，“locationType”：“rail_2c”｝
        

铁路的位置类型:

位置类型	铁路公司
`rail_0z.`	瑞士联邦铁路
`rail_2a.`	德国联邦铁路公司
`rail_2c.`	SNCF
`rail_2h.`	Thalys国际
`rail_2r.`	通过铁路加拿大公司
`rail_2v.`	美国铁路公司
`rail_9f.`	欧洲之星国际有限公司
`rail_xh.`	中国铁路
`rail_z0.`	英国铁路
`STD.`	标准地点

ResourceLink

名称	类型	格式	描述
`href`	`细绳`	[RFC 3986]	超链接到资源。
`ID`	`细绳`	(RFC 4122)	相关对象的唯一标识符。
`模板`	`细绳`	-	将模板超链接到资源。

RequestLink

名称	类型	格式	描述
`QueedId.`	`细绳`	4到6个字母数字字符	请求的公钥(每个客户唯一)。

要求政策

名称	类型	格式	描述
`href`	`细绳`	[RFC 3986]	对此请求策略的资源的超链接。
`ID`	`细绳`	-	请求策略唯一标识符。
`名称`	`细绳`	-	请求策略的名称。

请求类型

名称	类型	格式	描述
`代码`	`细绳`	-	从请求策略类型继承的类型的代码。可能的值：`授权`，`预借现金`，`旅行`．
`标签`	`细绳`	-	从请求策略类型继承的类型的标签。

预期费用

名称	类型	格式	描述
`拨`	`对象`	`分配`	此项预期费用拨款的详细情况。
`赞美amount.`	`对象`	`数量`	批准的预期费用条目，以请求的交易货币。
`BudgetAdaccrualdate.`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	确定哪些预算受到影响的日期。
`商业目的`	`细绳`	-	请求条目的业务目的。
`评论`	`对象`	`ResourceLink`	此预期费用的评论清单。
`Custom1.`到`Custom40.`	`对象`	`CustomField`	自定义字段中的详细信息。这些字段可能没有数据，具体取决于配置。
`exchangeRate`	`对象`	`汇率`	适用于条目的汇率。
`expenseType`	`对象`	`费用类型`	分录的费用类型。要求对于预期的费用，自动为段设置段`分段型`代码。
`href`	`细绳`	[RFC 3986]	超链接到此请求项的资源。
`ID`	`细绳`	-	预期费用分录的唯一标识符。
`持久`	`细绳`	-	预期费用分录的最后注释(最近的)。
`lastModifiedDate`	`时间戳`	[RFC 3339]	这个预期费用最后修改的日期。
`地点`	`对象`	`地点`	预期费用分录的位置。
`orgUnit1`到`orgUnit6`	`对象`	`数量`	自定义字段中的详细信息。这些字段可能没有数据，具体取决于配置。
`PostedAmount.`	`对象`	`数量`	以请求的交易货币表示的预期费用分录的过帐金额。
`parentRequest`	`对象`	`ResourceLink`	预期费用的父母请求。
`remainingAmount`	`对象`	`数量`	预期费用条目的剩余金额以要求的交易货币。
`来源`	`枚举`	-	创建预期费用的来源。支持的价值观:`CASH_ADVANCE`要么`Travel_00100,000.`．在任何其他情况下，该字段将为空
`TransactionAmount.`	`对象`	`数量`	要求以交易货币支付给供应商的预期费用分录的金额。
`transactionDate`	`时间戳`	[RFC 3339]`yyyy-MM-dd 'HH: mm: ss。SSS 'Z”`	要求交易的日期。
`travelAllowance`	`对象`	`出差补贴`	旅游津贴。
`tripData`	`对象`	`旅行数据`	旅行的描述。
`小贩`	`对象`	`小贩`	供应商的预期费用分录。

分配

名称	类型	格式	描述
`allocationAmount`	`对象`	`数量`	用百分比值计算的分配的数量乘以预期费用的交易金额。此金额以交易的货币给出，并在小数点后舍入到八位数。
`赞美amount.`	`对象`	`数量`	按百分比计算计算的分配金额乘以预期费用的批准金额。此金额以用户的货币给出，并在小数点后舍入到八位数。
`allocationId`	`细绳`	-	唯一的分配标识符。
`Custom1.`到`Custom20.`	`对象`	`CustomField`	自定义字段中的详细信息。这些字段可能没有数据，具体取决于配置。
`expenseId`	`细绳`	-	与分配相关的预期费用的唯一标识符。
`百分比`	`布尔`	-	是否已编辑分配百分比。
`百分比`	`数字`	-	该分配所代表的预计费用的总百分比。
`PostedAmount.`	`对象`	`数量`	按百分比值计算的分配金额乘以预期费用的发布金额。此金额以用户的货币给出，并在小数点后舍入到八位数。
`系统结表`	`布尔`	-	分配是一种系统分配，通常来自用户。如果显示给用户，应该是只读的。

汇率

名称	类型	格式	描述
`手术`	`细绳`	-	汇率操作。支持的价值观:`乘`，`分`
`价值`	`数字`	-	汇率值。

费用类型

名称	类型	格式	描述
`ID`	`细绳`	-	要求费用类型的唯一标识符。
`名称`	`细绳`	-	费用类型的名称。

列出项目字段

名称	类型	格式	描述
`代码`	`细绳`	-	列表项的短代码。
`价值`	`细绳`	-	列表项的唯一标识符。
`href`	`细绳`	[RFC 3986]	对列表项的资源的超链接。

分段腿

名称	类型	格式	描述
`类`	`列表`	`列出项目字段`	分段腿的预订类。
`classofservice.`	`细绳`	-	分段腿的服务班级。例如，在空中段的情况下，该字段将包含一个字母预订代码：`Y`经济舱，或者`F`第一课。
`评论`	`细绳`	-	包含在此分段腿中保存的最后一条注释。
`Custom1.`到`Custom40.`	`对象`	`CustomField`	自定义字段中的详细信息。这些字段可能没有数据，具体取决于配置。
`结束日期`	`日期`	[ISO 8601]`yyyy-mm-dd`	这段腿结束的日期。它代表的到达日期`AIRFR`和`火车`片段，看看日期`酒店`，或下降`CARRT`．
`endLocation`	`对象`	`ResourceLink`	这段腿到达的位置。例如，航空段的到达位置。
`endLocationDetail`	`细绳`	-	结束位置的详细信息。例如，这将包含关于酒店名称的详细信息，或关于汽车租赁机构的详细信息。
`时间结束`	`时间`	[ISO 8601]`hh：mm`	这个分段腿结束的时间。
`ID`	`细绳`	-	分段腿的唯一标识符。
`return0.`	`布尔`	-	指示此段是否为往返的返回段。万一`往返`，如果没有明确设置，第二段腿将被视为返回腿。
`开始日期`	`日期`	[ISO 8601]`yyyy-mm-dd`	这个分段腿开始的日期。
`启动分配`	`对象`	`ResourceLink`	这个分段腿的起始位置。这将是例如空调的离开位置。
`startLocationDetail`	`细绳`	-	有关起始位置的详细信息。例如，这将包含关于酒店名称的详细信息，或关于汽车租赁机构的详细信息。
`开始时间`	`时间`	[ISO 8601]`hh：mm`	这个分段腿开始的时间。
`segmentLocator`	`细绳`	-	这是Concur Travel部分的标识符(如果适用)。
`供应商名称`	`细绳`	-	包含分段腿的供应商描述。

段类型

名称	类型	格式	描述
`类别`	`枚举`	-	描述该段类型的类别。支持的价值观:`REQ_SEG_AIRFR`，`req_seg_carrt.`，`req_seg_hotel.`，`req_seg_limof.`，`REQ_SEG_RAILF`，`REQ_SEG_TAXIF`，`req_seg_misc`，`req_seg_parkg.`，`REQ_SEG_DININ`，`REQ_SEG_EVENT`
`代码`	`细绳`	-	要求段类型的代码。支持的价值观:`AIRFR`，`CARRT`，`酒店`，`LIMOF`，`轨道`，`报价`，`MISC`，`Parkg.`，`狄宁`，`事件`或自定义代码

它可以REQ_SEG_AIRFR/AIRFR对于常规空中段，或REQ_SEG_AIRFR/10325.对于自定义空调。

例子：

         ｛“类别”：“req_seg_airfr”，“代码”：“AIRFR”｝
        

旅行社

名称	类型	格式	描述
`emailAddress`	`细绳`	-	旅行社电子邮件地址。
`ID`	`细绳`	-	旅行社唯一标识符。
`名称`	`细绳`	-	旅行社办公室名称。
`ProposalType.`	`细绳`	-	旅行社建议类型。支持的价值观:`CWTF.`，`AEBT`，`API.`

出差补贴

名称	类型	格式	描述
`每日运输`	`细绳`	-	固定日常旅行津贴ID与预期费用相关联。

旅行数据

名称	类型	格式	描述
`宗工簿`	`布尔`	-	如果`真的`，此旅行是由旅行社处理的（或必须）。
`腿`	`列表`	`分段腿`	旅行行程的清单。
`Triptype.`	`细绳`	-	表示这次旅行的类型。支持的价值观:`单程`，`往返`，要么`multi_stops.`．如果没有提供，将从给定的腿检测。
`分段型`	`对象`	`段类型`	要求段的类型。
`自我预告`	`布尔`	-	如果`真的`，该旅行已被Concur travel预订，或者Concur travel是否已在GDS中检索旅行信息。

小贩

名称	类型	格式	描述
`ID`	`细绳`	-	条目的供应商标识符。
`名称`	`细绳`	-	进入的供应商描述。

菜单

架构

要求

数量