旅行

TRIPS资源代表Concur旅行系统中的行程。Triplink供应商使用此资源显示完整预订字段的子集。

版本

1．1

URI

/travel/trip/v1.1/ query_parameters}

范围

为了在进行行程API调用时获取行程数据，必须将OAuth范围参数的值设置为：ITINER

运营

旅行得到总结

在获取行程摘要端点用于检索行程摘要用于其帐户与OAuth访问关联标记用来做API调用的旅客。此端点也可以用来获取行程摘要针对不同的用户或整个公司。当一个旅行管理公司（TMC）需要获得代表用户或公司的行程摘要这通常是。

最佳做法

  • 提取过去数据时:
    • 提取一个月的行程总结，以测量交通量。如果返回了数百个，则将提取调整为每周。
    • 无论数据量大小，在任何给定时间提取的数据不得超过一年。对于较长的回顾，一次最多提取6个月的分段。
    • 不要用多线程请求来检索多页数据。并发请求将影响应用程序的性能。
  • 行程变化频繁。变化并不一定表明旅行者修改了他们的行程。如果您的申请适用于即将到来的或正在进行的旅行，请注意，您必须评估各个部分，以确定这对您的申请是否有重大变化。
  • 此API将仅返回已发送给Concur Travel的行程；这包括在Concur travel、TripIt、Trilink供应商网站上预订的旅行，以及您旅行社的大多数预订。一些客户可能有多个预订选项，这可能意味着并非所有员工旅行都可以通过此API进行。一个好的经验法则：如果旅行者在他们的“旅行”列表中看到了行程，那么您可以从这个API中检索它。

请求

GET /旅游/旅行/ v1.1 / {query_parameters}

查询参数

查询参数为可选参数。

通过登录ID或XMLSyncID，你可以指定以下请求参数：

参数名称 参数类型 数据类型 描述
startDate可以 日期 dateTime URL编码的开始日期（协调世界时，或UTC）的行程。格式:YYYY-MM-DD。如果没有提供查询参数，开始日期设置为今天的日期 - 30天。该请求将只返回被提供的日期进行中的，无论是开始的日期或日期之前开始，所提供的日期进行中的旅行。
endDate 日期 dateTime url编码的UTC旅行结束日期。格式:YYYY-MM-DD。如果不提供查询参数，则结束日期设置为今天的日期+ 12个月。该请求只返回在提供的日期内正在进行的旅行，要么在提供的日期结束，要么在提供的日期之前开始并在提供的日期内进行。
createdAfterDate 日期 dateTime url编码的UTC日期，用于表示创建旅行的时间。查询字符串将返回在该日期或之后创建的行程。使用的createdBeforeDate用于查找在日期范围内创建的行程。格式:YYYY-MM-DD。
createdBeforeDate 日期 dateTime url编码的UTC日期，用于表示创建旅行的时间。查询字符串将返回在此日期或之前创建的行程。使用的createdAfterDate用于查找在日期范围内创建的行程。格式:YYYY-MM-DD。
最后修改日期 日期 dateTime TRIPS的最后修改过的UTC日期及其相关预订。此查询字符串将仅返回跳闸或其相关预订的旅行的浏览具有更大或等于提供的时间的最后修改日期。提供的日期/时间可以在现在和数据库中创建的第一个旅行日期之间随时。格式为日期或日期和时间组合。
bookingtype. 类型 细绳 这次旅行至少包括一次这种类型的预订。格式:空气，车，餐厅，酒店，停车，铁路,或骑。
userid_type =登录 用户ID 细绳 的loginID是用户的SAP Concur的登录ID。如果OAuth用户端具有上面列出的用户角色之一，才能使用此参数。
userid_value 用户ID 细绳 的userid_value所有的可以被发送到得到的行程摘要的在公司的所有用户。如果OAuth用户端具有上面列出的用户角色之一，才能使用此参数。
includeMetadata 真/假 细绳 的includeMetadata查询参数与ItemsPerPage和页面查询参数会导致响应分为页面。响应被包裹在一个ConcurResponse父元素，其中包含响应详细信息和分页元数据。如果ItemsPerPage查询参数未发送，如果页面发送查询参数，如果发送，则为1000页面未设置查询参数。如果页面查询参数不发送，响应将默认为第1页。
ItemsPerPage 数量 整数 的includeMetadata查询参数与ItemsPerPage和页面查询参数将导致将响应划分为多个页面。响应将被包装在一个ConcurResponse父元素，其中包含响应详细信息和分页元数据。如果ItemsPerPage查询参数未发送，如果页面发送查询参数，如果发送，则为1000页面未设置查询参数。如果页面查询参数不发送，响应将默认为第1页。
includeVirtualTrip 国旗 整数 虚拟旅行是通过Concur Request产品离线预订的部分。设置includeVirtualTrip查询参数为1以将这些行程包含在列表中。
包括取消旅行 真/假 细绳 的包括取消旅行查询参数将导致请求也返回状态为Canceled的行程。当该查询参数设置为true时，响应将包括TripStatus元素。
包括预订 真/假 细绳 的包括预订查询参数将导致请求显示客人预订，如果设置为true。默认为false。

下面是一些如何使用这些查询参数组合格式化GET请求的示例:

  • 要获得整个公司的行程摘要：
https://www.concursolutions.com/api/travel/trip/v1.1/?startDate={{u startdate}&endDate={u endDate}{u&{u createdAfterDate={u date}&createdBeforeDate={u date}&lastModifiedDate={{u date}&bookingType={u type}&userid\u type=login&userid\u value=ALL

用于进行API调用的访问令牌必须与具有Admin用户角色的帐户相关联。

  • 获取与该应用程序关联的账户的旅行总结:
https://www.concursolutions.com/api/travel/trip/v1.1/?startDate= {_startdate_} &endDate = {_enddate_} _&_createdAfterDate = {_date_} &createdBeforeDate = {_date_} &lastModifiedDate = {_date_} &bookingType = {_type_}

用于进行API调用的访问令牌与进行调用的应用程序的帐户相关联。

  • 要获取具有指定登录凭据的用户的旅行摘要，请执行以下操作:
https://www.concursolutions.com/api/travel/trip/v1.1/?startDate= {_startdate_} &endDate = {_enddate_} _&_createdAfterDate = {_date_} &createdBeforeDate = {_date_} &lastModifiedDate = {_date_} &bookingType = {_type_} &userid_type = login_id&userid_value = {_loginID_}

用于进行API调用的访问令牌与具有指定登录凭据的SAP Concur帐户相关联。

头

授权标题（必填）

授权:OAuth {access_token}在哪里Access_Token.是要检索其行程信息的用户的OAuth 2.0访问令牌。如果要访问公司范围内的行程信息，与OAuth 2.0访问令牌关联的SAP Concur用户帐户必须具有以下角色之一：Web Services Administrator for Professional或Can Administrator for Standard。

接受标题（可选）

应用程序/ xml

获取旅行摘要响应架构

响应返回一个ItineraryInfoList父元素与一个ItineraryInfo.子元素，用于指定旅行者的每个旅行摘要。如果includeMetadata和ItemsPerPage查询参数被包括在所述请求，响应将包括一个连接响应包含a的父元素元数据元素，该元素具有分页信息和资料带有ItineraryInfoList子元素。此操作的响应可以划分为页面，以便于处理。

数据元素

元素名称 数据类型 描述
ItineraryInfoList 元素 带有ItineraryInfo.子元素，用于指定旅行者的每个旅行摘要。

行程信息列表元素

元素名称 数据类型 描述
ItineraryInfo. 元素 包含指定用户的行程信息的父元素。

ItineraryInfo元素

元素名称 数据类型 描述
TRIPID 细绳 加密的行程标识符值。
TripName 细绳 旅行的名字。
TripStatus 细绳 旅行的状况。该元素仅在包括取消旅行请求中使用查询参数。
StartDateLocal dateTime 在开始地点的时区中旅行的开始日期。格式:YYYY-MM-DDThh: mm: ss。
EndDateLocal dateTime 在结束地点的时区中旅行的结束日期。格式:YYYY-MM-DDThh: mm: ss。
DateModifiedUtc dateTime 上次修改此行程的UTC日期。格式:YYYY-MM-DDThh: mm: ss。
UserLoginId 细绳 用户登录SAP Concur。当OAuth 2.0是访问令牌与具有以下角色之一的SAP Concur帐户相关联时，此元素出现在GET /api/travel/trip/v1.1操作的响应中:Professional的Web Services Administrator或Standard的Can Administrator。
id 细绳 具有加密ID的旅行ID URI。

元数据元素

分页信息的父元素。

分页的元素

元素名称 数据类型 描述
TotalPages 整数 查询返回的页面总数。
TOTALITEMS 整数 查询返回的行程总数。
当前页 整数 当前响应中结果集的页码。
ItemsPerPage 整数 设置为每页显示的项目数。
上一页URL 细绳 结果的URI结果。没有先前页面时，此元素将为空。
NextPageURL 细绳 下一组结果的URI。当没有下一页时，此元素将为空。

例子

例1：获取旅行的开始和结束日期摘要

请求

得到/ api /旅游/旅行/ v1.1 / ?startDate可以=2012%2F02%2F01&endDate=2013%2F12%2F31HTTP/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}......

回复

HTTP/1．1200.好的内容类型：应用程序/ xml......<？xml version = " 1.0 " encoding = " utf - 8 " ?>< ItineraryInfoListxmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xmlns: xsd =“http://www.w3.org/2001/XMLSchema”>< ItineraryInfo >< TripId >naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP从巴尔的摩到纽约< / TripName >2012 - 02年- 15 - t09:00:00< EndDateLocal >2012-02-21T17：30：00< / EndDateLocal >cm@example.com.< / UserLoginId >2012-02-14T17：13：07<标识>https://www.concursolutions.com/api/travel/trip/v1.1/naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP< / id >< / ItineraryInfo >< ItineraryInfo >< TripId >I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL从巴尔的摩到西雅图< / TripName >2012 - 03 - 26 - t09:00:00< EndDateLocal >2012-03-29T17:30:00< / EndDateLocal >2012-03-24T19：00：00cm@example.com.< / UserLoginId ><标识>https://www.concursolutions.com/api/travel/trip/v1.1/I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL< / id >< / ItineraryInfo >

示例2：按预订类型和开始日期请求获取行程摘要

此请求返回指定预订类型的指定日期开始的旅行摘要。

请求

得到/api/travel/trip/v1.1/？startDate=2015%2F01%2F01&bookingType=AirHTTP/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}......

回复

HTTP/1．1200.好的内容类型：应用程序/ xml......<？xml version = " 1.0 " encoding = " utf - 8 " ?>< ItineraryInfoListxmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xmlns: xsd =“http://www.w3.org/2001/XMLSchema”>< ItineraryInfo >< TripId >I2uwiJJw8r7OwCIQOb2SHTsozwBsSie9W乘飞机从西雅图到旧金山< / TripName >2015-01-01T12：30：00< EndDateLocal >2015-01-05T10：30：00< / EndDateLocal >cm@example.com.< / UserLoginId >2014 - 12 - 23 - t11:10:00<标识>https://www.concursolutions.com/api/travel/trip/ v1.1 / I2uwiJJw8r7OwCIQOb2SHTsozwBsSie9W< / id >< / ItineraryInfo >

示例3:通过创建日期获取旅行摘要

这个请求返回在指定日期之后创建的旅行摘要。

请求

得到/api/travel/trip/v1.1/？createdAfterDate=2015%2F02%2F13HTTP/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}

回复

HTTP/1．1200.好的内容类型：应用程序/ xml......<？xml version = " 1.0 " encoding = " utf - 8 " ?>< ItineraryInfoListxmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xmlns: xsd =“http://www.w3.org/2001/XMLSchema”>< ItineraryInfo >< TripId >bwjcijjw8r7owciqob2shtsozwbswlsie9.乘飞机从洛杉矶到墨西哥城< / TripName >2015 - 03 - 09 - t18:45:00< EndDateLocal >2015-03-30T08：00：00< / EndDateLocal >cm@example.com.< / UserLoginId >2015-01-28T09：30：00<标识>https://www.concursolutions.com/api/travel/trop/ v1.1 / bwjcijjw8r7owciqob2shtsozwbswlsie9< / id >< / ItineraryInfo >

示例4:使用分页获取行程摘要

此请求用于将响应除以页面以便更容易处理。

请求

得到/ api /旅游/旅行/ v1.1 / ?createdAfterDate=2012%2F02%2F01&includeMetadata=true&ItemsPerPage=2&Page=1HTTP/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}

回复

响应返回连接响应包含a的父元素元数据元素，该元素具有分页信息和资料带有ItineraryInfoList子元素。

HTTP/1．1200.好的内容类型：应用程序/ xml......< ConnectResponse >< >元数据< TotalPages >38< / TotalPages >187<当前页>2< /当前页>< ItemsPerPage >2< / ItemsPerPage >https://www.concursolutions.com/api/travel/trip/v1.1/?2 f02 % 2 f01 createdAfterDate = 2012%,itemsPerPage = 5,页面= 3,includeMetaData = true< / PreviousPageURL >< NextPageURL >https://www.concursolutions.com/api/travel/trip/v1.1/?2 f02 % 2 f01 createdAfterDate = 2012%,itemsPerPage = 5,页面= 1,includeMetaData = true< / NextPageURL >分页> < /<数据>< ItineraryInfoListxmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”XMLNS：i =“http://www.w3.org/2001/XMLSchema-instance”>< ItineraryInfo >< TripId >naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP从巴尔的摩到纽约< / TripName >2012 - 02年- 15 - t09:00:00< EndDateLocal >2012-02-21T17：30：00< / EndDateLocal >cm@example.com.< / UserLoginId >2012-02-14T17：13：07<标识>https://www.concursolutions.com/api/travel/trip/v1.1/naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP< / id >< / ItineraryInfo >< ItineraryInfo >< TripId >I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL从巴尔的摩到西雅图< / TripName >2012 - 03 - 26 - t09:00:00< EndDateLocal >2012-03-29T17:30:00< / EndDateLocal >2012-03-24T19：00：00cm@example.com.< / UserLoginId ><标识>https://www.concursolutions.com/api/travel/trip/v1.1/I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL< / id >< / ItineraryInfo >< / ConnectResponse >

让旅行的细节

获取行程详细信息端点用于获取指定行程的详细信息。响应中包含的元素如下所示：

  • 一些元素，如AirlineTickets或RailPayments，只出现在适当类型的预订。例如AirlineTickets在回复中只出现在机票预订和RailPayments，预订火车票。
  • 金额值，例如Rate或Tax，只在请求者是预订的来源时显示。所有其他供应商将不会收到与预订相关的金额元素。
  • 一些元素，如SabreDKNumber，只有当预订是由相关GDS创建时才显示。
  • 某些元素是特定于供应商的，仅出现在关联供应商的响应中。

本主题描述可返回的可能元素的完整集合。没有行程可以包含所有可能的元素，因此响应将始终是所有可能返回值的子集。

默认情况下，调用此API时，与用于进行API调用的OAuth访问令牌关联的SAP Concur帐户应该是trip的所有者。此端点还可用于获取OAuth使用者不拥有的行程的详细信息。当TMC需要代表用户获取行程详细信息时，通常会执行此操作。TMC必须向SAP Concur注册，并拥有具有以下用户角色之一的SAP Concur帐户：Web Services Administrator for Professional或Can Administrator for Standard。

请求

获得/旅游/旅行/ v1.1 / trip_ID吗?[systemFormat = system_format | &userid_type =登录| user_id = login_ID]

路径参数

参数名称 数据类型 描述
行程ID 细绳 要求的:所需行程的标识符。在获取旅行摘要时，这个标识符作为ID元素的值返回。例如，如果ID元素的返回值是I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL，则请求的URI是/行程/行程/v1.1/I2uwiJJw8r7Owl3IWlSie9WIelxhAhwi。

查询参数

参数名称 数据类型 描述
systemFormat 细绳 可选:响应不同系统的格式。支持的取值为Tripit。使用此查询参数的请求URI的格式为/旅游/旅行/ v1.1 / trip_ID吗?systemFormat = Tripit。
userid_type 细绳 可选：要使用的用户标识的类型。可能的值是：login。
userid_value 细绳 可选:用户的登录ID。必须与此参数结合提供userid_type参数这个userid_type和userid_value参数只能使用，如果使用OAuth 2.0访问令牌关联的用户帐户必须具有SAP Concur帐户与这些角色之一：Web服务管理专业或可以管理标准。用于使用所述请求URI的格式userid_type和userid_value查询参数是/旅游/旅行/ v1.1 / trip_ID吗?userid_type =登录&userid_value=login_ID。

头

授权标题（必填）

授权:OAuth {access_token}
在哪里Access_Token.是您希望检索其行程信息的用户的OAuth 2.0访问令牌。如果希望访问公司范围内的行程信息，与OAuth 2.0访问令牌关联的用户帐户必须具有SAP Concur帐户，该帐户必须具有以下角色之一:专业Web服务管理员或标准Web服务管理员。

Accept标头(可选)

应用程序/ xml

获取旅行详细信息响应架构

响应根据请求中使用的参数以及行程的状态和详细信息，返回下表中描述的元素的子集。可以使用该响应来进行Tripit，使用systemformat查询字符串。

父元素

元素名称 数据类型 描述
id 细绳 具有加密ID的旅行ID URI。
ItinLocator 细绳 行程定位器。此元素现在已弃用，仅为向后兼容而支持。
客户申请者 细绳 表示外部（非同意）系统中跳闸的唯一标识符。最大长度32个字符。
Itinsourcename. 细绳 行程来源。格式：travelsupplier。
TripName 细绳 旅行的名字。最大长度255个字符。
评论 细绳 评论此行程。最大长度512个字符。
StartDateLocal dateTime 在开始地点的时区中旅行的开始日期。格式:YYYY-MM-DDThh: mm: ss。
EndDateLocal dateTime 在结束地点的时区中旅行的结束日期。格式:YYYY-MM-DDThh: mm: ss。
DateCreatedUtc dateTime 创建此旅行的日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss。
DateModifiedUtc dateTime 上次修改此行程的UTC日期。格式:YYYY-MM-DDThh: mm: ss。
BookedVia 细绳 这次旅行的预订方法。
按名字预订 细绳 预订旅行的人的名字。
BookedBylastname. 细绳 预定行程的人的姓。
datebookedlocal. dateTime 在预订位置的当地时间预订了旅行的日期。格式:YYYY-MM-DDThh: mm: ss。
CancelComments 细绳 如果行程被取消提出的意见。最大长度：256个字符。
描述 细绳 这次旅行描述。最大长度512个字符。
EndDateUtc dateTime 以UTC表示的旅行的结束日期。格式:YYYY-MM-DDThh: mm: ss。
IsPersonal 布尔基 无论是商务旅行还是休闲旅行。格式:真/假。
ProjectName 细绳 该旅行的相关项目名称。最大长度：255个字符。
起始日期UTC dateTime 旅行的开始日期，在UTC。格式:YYYY-MM-DDThh: mm: ss。
RuleViolations 数组 与行程关联的规则违规列表。这个父元素包含一个RuleViolation每个相关规则违规的子元素。
状态 细绳 行程的情况。以下之一:0-确认;1-代理购票;2 -取消。
预订 数组 父元素，包含预订子元素，用于与此行程关联的每个预订。

预订元素

元素名称 数据类型 描述
段 数组 此预订的分段清单。此元素中包含的子元素因TMC，SAP Confor客户端，第三方开发人员或Triplink供应商在请求Itinerary详细信息：适用于TMC、客户机和第三方开发人员这个段元素包含一个或多个空气，车，酒店，餐厅，骑，铁路，停车,或旅行父元素。TripLink供应商这个段元素包含一个或多个空气，车，酒店,或骑父元素。
乘客 数组 包含一个乘客每个包含乘客的子元素。有关乘客元素，见创造一次新的旅行。
记录定位器 细绳 预订的唯一标识符。这通常是6个字母数字字符，但根据预订来源可以有其他格式。
BookingSource 细绳 此预订的预订源的名称。预订源是系统用于跟踪预订发生地点的文本名称。
DateModifiedUtc dateTime 最后修改预订的日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss。
datebookedlocal. dateTime 以预订地点的当地时间创建预订的日期。格式:YYYY-MM-DDThh: mm: ss。
Itinsourcename. 细绳 行程来源。格式：travelsupplier。
passengercount. 整数 预订中包含的乘客数量。

例子

示例1：获取旅行ID的旅行详情

请求

得到/ api /旅游/旅行/ v1.1 / CNQR1234567890HTTP/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}......

回复

HTTP/1．1200.好的内容类型：应用程序/ xml......<？xml version = " 1.0 " encoding = " utf - 8 " ?>xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >KK-CNQ-1M1P6-5HJ< ItinSourceName >ConcurTravel< / ItinSourceName >从达拉斯到西雅图< / TripName ><评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >2012-07-24T19:15:52< BookedVia >EveryGDS< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012-07-24T19:15:52< / DateBookedLocal ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >F1672664579< / ConfirmationNumber >2012-07-24T19:15:52< StartCityCode >海< / StartCityCode >< EndCityCode >海海< EndLocation >海< / EndLocation >E类> < /C< >传播米<空调装置>R< NumCars >1<折扣码>346660.< DailyRate >44.0000< TotalRate >44.0000< RateType >D<币片美元< >指控固定> <减费<币片美元< >数量0.0000< IsPrimary >假< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><币片美元< >数量44.00002013 - 12 - 21 - t12:00:00< IsPrimary >真正的< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >调整2012-07-24T19:15:52< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >travelsupplier< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段><供应商>CQ> < /供应商< >状态门将2013 - 12 - 21 - t23:59:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >3364214265< / ConfirmationNumber >2012-07-24T19:15:52< RateCode >LV4<名称>同意酒店< /名称>CONQ00:00< / CheckinTime >< CheckoutTime >00:00< / CheckoutTime >1< / NumPersons >1< / NumRooms >CXL在抵达前1天< DailyRate >240.3500.<币片美元< RoomDescription >1大床可访问的房间- k1rrc< >指控<率><币片美元< >数量240.3500.2013 - 12 - 21 - t23:59:00< IsPrimary >假< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >3.0000< / NumUnits >< / >速度< / >指控> < /酒店< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >ConcurHotel2012-07-24T19:15:52< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /行程>

示例2：获取Tripit格式的旅行详细信息

请求

得到/旅游/旅行/ v1.1/73014481752吗?systemFormat = TripitHTTP/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}......

回复

<？xml version = " 1.0 " encoding = " utf - 8 " ?><回答>< >旅行<标识>73014481752< / id >/ api /旅游/旅行/ v1.1/73014481752< / relative_url >< start_date >2013-08-212013-08-24< / end_date >战略小组会议< is_private >真正的< / is_private >RL10001005< booking_site_name >同意旅行< / booking_site_name >< booking_site_phone > < / booking_site_phone >< booking_site_url >https://www.concursolutions.com< record_locator >4294993825< / record_locator >< supplier_conf_num >CN10001005< supplier_contact > < / supplier_contact > < supplier_name > < / supplier_name > < supplier_url > < / supplier_url ><是否已购买>1< / is_purchased > <限制> < total_cost > < / total_cost ><段>< StartDateTime ><日期>2013-08-21> < /日期<时间>07:45:00< / StartDateTime ><日期>2013-08-21> < /日期<时间>13:03:00PHX< start_gate >A11< start_terminal >4ord.< / end_airport_code >< end_gate >F8< / end_gate >< end_terminal >2< / end_terminal >< marketing_airline >我们< / marketing_airline >< marketing_flight_number >1< / marketing_flight_number ><飞机>320<持续时间> < >的距离1433> < /距离 <座位> < service_class >经济<停止>不间断的<段>< StartDateTime ><日期>2013-08-24> < /日期<时间>13:55:00< / StartDateTime ><日期>2013-08-24> < /日期<时间>16:58:00ord. < start_terminal > < / start_terminal >PHX< / end_airport_code >< end_gate > < / end_gate >< end_terminal > < / end_terminal >< marketing_airline >我们< / marketing_airline >< marketing_flight_number >1728< / marketing_flight_number ><飞机>A320<持续时间>  <座位> < service_class >经济<停止>停止<旅行者>< first_name >威廉< / first_name >< middle_name > < / middle_name >从来没有< / last_name >< frequent_traveler_num > < / frequent_traveler_num > < ticket_num > < / ticket_num >< /旅行>< / AirObject >< /响应>

创造一次新的旅行

这个端点用于创建一个新的旅程。要创建一个新的旅程，在内容主体指定的日期只能跨越要创建的行程并不能跨越现有的旅行。要创建或更新代表用户，令牌OAuth访问用来做API调用应与SAP的Concur帐户的用户相关联的行程。该TripLink供应商或TMC必须与SAP的Concur注册并拥有一个具有以下用户角色之一的SAP Concur帐户：Web服务管理专业，或可以管理标准。

请求

POST /旅游/旅行/ v1.1吗?[userid_type = login&user_id = login_ID]

请求参数

参数名称 数据类型 描述
userid_type 细绳 可选:要使用的用户标识类型。可能的值是:login_id。
userid_value 细绳 可选：用户识别类型的值。目前唯一可用的类型是login_id因此，该值是登录凭据。必须与此参数结合提供userid_type参数这个userid_type和userid_value只有当与OAuth 2.0访问令牌关联的用户帐户与具有以下角色之一的SAP Concur帐户相关联时才能使用参数:Professional的Web Services Administrator或Standard的can administrtor。用于使用所述请求URI的格式userid_type和userid_value查询参数是/旅游/旅行/ v1.1 / trip_ID吗?userid_type =登录&userid_value=login_ID。

头

授权标题（必填）

授权:OAuth {access_token}

在哪里Access_Token.是您希望创建或更新其行程的用户的OAuth 2.0访问令牌。如果希望访问公司范围内的行程信息，与OAuth 2.0访问令牌关联的用户帐户必须具有SAP Concur帐户，该帐户必须具有以下角色之一:专业Web服务管理员或标准Web服务管理员。

创建新的行程请求模式

元素名称 必需的或可选的 三联线 数据类型 描述
行程 必需的 Y ItineraryType trip的根元素。对于这个端点，它包含以下元素:客户申请者，Itinsourcename.，TripName，评论，StartDateLocal，EndDateLocal，按名字预订，BookedBylastname.，预订。
TripName 必需的 Y 细绳 旅行的名字。最大长度：255个字符。
TripStatus 必需的 Y unsignedByte 行程的状态。以下情况之一：0-已确认；1-有票；2-取消；6-提案；7-预定的建议。此元素仅在包括取消旅行请求中使用查询参数。
记录定位器 必需的 Y 细绳 预订的唯一标识符。这通常是6个字母数字字符，但根据预订来源可以有其他格式。
BookingSource 必需的 Y 细绳 此预订的预订源的名称。预订源是系统用于跟踪预订发生地点的文本名称。这可以是GDS, OTA，供应商网站的供应商代码，或供应商直接连接API。对于TripLink供应商，这是供应商的名称。
StartDateLocal 可选 Y dateTime 在开始地点的时区中旅行的开始日期。格式:YYYY-MM-DDThh: mm: ss。
EndDateLocal 可选 Y dateTime 在结束地点的时区中旅行的结束日期。格式:YYYY-MM-DDThh: mm: ss。
按名字预订 可选 Y 细绳 预订旅行的人的名字。
BookedBylastname. 可选 Y 细绳 预定行程的人的姓。
预订 可选 Y 数组 父元素，包含预订子元素，用于与此行程关联的每个预订。
预订 可选 Y 数组 的子元素预订元素，该元素又包含以下子元素：段，乘客年代,记录定位器，BookingSource，DateModifiedUtc，datebookedlocal.，Itinsourcename.,passengercount.。
段 可选 Y 数组 此预订的分段清单。该元素中包含的子元素因TMC、客户端、第三方开发人员或TripLink供应商是否请求行程细节而不同:适用于TMC、客户机和第三方开发人员这个段元素包含一个或多个空气，车，酒店，餐厅，骑，铁路，停车,或旅行父元素。对于Triplink供应商，段元素包含一个或多个空气，车，酒店,或骑父元素。
评论 可选 Y 细绳 对行程的评论。最大长度512个字符。
Itinsourcename. 可选 N 细绳 行程来源。格式：travelsupplier。
书为主 可选 Y 细绳 指示提供的预订到Concur的旅游工具。
源 可选 N / A. 细绳 这个元素过时了。它只支持向后兼容性。
datebookedlocal. 可选 Y dateTime 以预订地点的当地时间创建预订的日期。格式:YYYY-MM-DDThh: mm: ss。
formofpaymentname. 可选 - 细绳 预订付款方式的名称。
FormOfPaymentType 可选 - 细绳 在付款方式的形式。
售票员服装 可选 - - 预订机票的邮寄地址，如果有的话。
TicketPickupLocation 可选 - - 预定机票的取票地点，如果可以的话。
TicketPickupNumber 可选 - - 预订机票的确认号码，如果有的话。
AirfareQuotes 可选 - 数组 此预订的存储机票报价列表。
飞机票 可选 - 数组 本次预订的机票清单。
收费 可选 - 数组 本预订的收费清单。
MiscChargeOrders 可选 - 数组 对于本次预订杂气价格表。
乘客 可选 Y 数组 包含一个乘客包含的每个乘客的子元素。的乘客子元素依次包含以下内容所需的子元素：NameFirst，NameLast，以及以下内容可选元素：NameMiddle，NamePrefix，NameRemark，NameSuffix，NameTitle，TextName,FrequentTravelerProgram。
PassPrograms 可选 - 数组 此预订的通行证程序清单。这个父元素有PassProgram与预订相关联的每个通行证计划的子元素。的PassProgram父元素具有以下子元素：数量，的名字，类型，UserFirstName,UserLastname。
phonenumber 可选 - 数组 与此预订有关的电话号码列表。这个父元素有Phonenumberdata.子元素用于与预订关联的每个电话号码。的Phonenumberdata.父元素具有以下子元素：PassengerRPH，PhoneNumber，类型,描述。
RailPayments 可选 - 数组 与此预订的铁路段有关的铁路付款清单。它有以下子元素:RailPayment表示火车票预订和支付信息RailAdjustment为铁路订票调整的金额。
段 可选 Y 数组 此预订的分段清单。该元素中包含的子元素因TMC、客户端、第三方开发人员或TripLink供应商是否请求行程细节而不同:适用于TMC、客户机和第三方开发人员这个段元素包含一个或多个空气，车，酒店，餐厅，骑，铁路，停车,或旅行父元素。TripLink供应商这个段元素包含一个或多个空气，车，酒店,或骑父元素。
交付 可选 - - 该预订的方法已交付。
WaitListSegments 可选 - - 旅客在此预订中等待的部分。
警告 可选 - - 与预订相关的警告。
WebAddresses 可选 - - 网站地址列表，如电子邮件，接送网址，因此与此相关的预订。

创建新释放响应模式

响应返回一个HTTP状态码，如果成功创建了旅行，它还返回完整的已发布的旅行详细信息，其中包含以下附加元素行程父元素:

元素名称 数据类型 三联线 描述
id 细绳 Y 包含行程ID的URI。
ItinLocator 细绳 Y 的行程定位器值（不URL跳闸ID）。的ItinLocator值在更新现有的行程时使用。
DateModifiedUtc dateTime Y 最后修改此预订的UTC格式化日期。
BookedVia 细绳 Y 预订方法或英国资讯GDS预订。
datebookedlocal. dateTime Y 按旅行者的当地时间计算的预订日期。

例子

示例1:TMC使用用户的登录凭据创建一个Trip

这个示例展示了如何使用用户的登录凭据为用户创建一个旅行。

请求

帖子/ api /旅游/旅行/ v1.1 ? userid_type = login_id&userid_value = cm@example.comHTTPS/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}内容类型：应用程序/ xml......xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”>KK-CNQ-1M1P6-5HJ< ItinSourceName >Concurconnectapi.< / ItinSourceName >从达拉斯到西雅图< / TripName ><评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >F1672664579< / ConfirmationNumber >< StartCityCode >海< / StartCityCode >< EndCityCode >海海< EndLocation >海< / EndLocation >E类> < /C< >传播米<空调装置>R< NumCars >1<折扣码>346660.< DailyRate >44.0000< TotalRate >44.0000< RateType >D<币片美元< >指控固定> <减费<币片美元< >数量0.0000< IsPrimary >假< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><币片美元< >数量44.00002013 - 12 - 21 - t12:00:00< IsPrimary >真正的< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >Concurconnectapi.< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段><供应商>CQ> < /供应商< >状态门将2013 - 12 - 21 - t23:59:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >3364214265< / ConfirmationNumber >< RateCode >LV4<名称>同意酒店< /名称>CONQ03:00点< / CheckinTime >< CheckoutTime >下午12点< / CheckoutTime >1< / NumPersons >1< / NumRooms >CXL在抵达前1天< DailyRate >240.3500.<币片美元< RoomDescription >1大床可访问的房间- k1rrc< >指控<率><币片美元< >数量240.3500.2013 - 12 - 21 - t23:59:00< IsPrimary >假< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >3.0000< / NumUnits >< / >速度< / >指控> < /酒店< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >Concurconnectapi.< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /行程>

回复

xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >KK-CNQ-1M1P6-5HJ< ItinSourceName >ConcurTravel< / ItinSourceName >从达拉斯到西雅图< / TripName ><评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >2012-07-24T19:15:52< BookedVia >EveryGDS< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012-07-24T19:15:52< / DateBookedLocal ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >F1672664579< / ConfirmationNumber >2012-07-24T19:15:52< StartCityCode >海< / StartCityCode >< EndCityCode >海海< EndLocation >海< / EndLocation >E类> < /C< >传播米<空调装置>R< NumCars >1<折扣码>346660.< DailyRate >44.0000< TotalRate >44.0000< RateType >D<币片美元< >指控固定> <减费<币片美元< >数量0.0000< IsPrimary >假< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><币片美元< >数量44.00002013 - 12 - 21 - t12:00:00< IsPrimary >真正的< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >调整2012-07-24T19:15:52< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >travelsupplier< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段><供应商>CQ> < /供应商< >状态门将2013 - 12 - 21 - t23:59:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >3364214265< / ConfirmationNumber >2012-07-24T19:15:52< RateCode >LV4<名称>同意酒店< /名称>CONQ00:00< / CheckinTime >< CheckoutTime >00:00< / CheckoutTime >1< / NumPersons >1< / NumRooms >CXL在抵达前1天< DailyRate >240.3500.<币片美元< RoomDescription >1大床可访问的房间- k1rrc< >指控<率><币片美元< >数量240.3500.2013 - 12 - 21 - t23:59:00< IsPrimary >假< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >3.0000< / NumUnits >< / >速度< / >指控> < /酒店< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >ConcurHotel2012-07-24T19:15:52< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /行程>

此示例显示Triplink供应商如何创建旅行。

请求

帖子/api/travel/trip/v1.1/HTTPS/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}内容类型：应用程序/ xml......xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”>从达拉斯到西雅图< / TripName >< TripStatus >香港<评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName ><预订><预订><段><汽车>2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >< StartCityCode >海< / StartCityCode >< EndCityCode >海汽车> < /< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< /预订><预订><段>< >状态门将< StartCityCode >海< / StartCityCode >2013 - 12 - 21 - t23:59:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< TimeZoneId >太平洋< / TimeZoneId >2012-07-24T19:15:52西雅图< / StartCity >我们< / StartCountry >> < /酒店< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< /预订>< /行程>

回复

xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >从达拉斯到西雅图< / TripName >< TripStatus >香港<评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >2012-07-24T19:15:52< BookedVia >EveryGDS< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012-07-24T19:15:52< / DateBookedLocal ><预订><预订><段><汽车>2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >< StartCityCode >海< / StartCityCode >< EndCityCode >海汽车> < /< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< /预订><预订><段>< >状态门将< StartCityCode >海< / StartCityCode >2013 - 12 - 21 - t23:59:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< TimeZoneId >太平洋< / TimeZoneId >2012-07-24T19:15:52西雅图< / StartCity >我们< / StartCountry >> < /酒店< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< /预订>< /行程>

示例3:第三方开发人员使用用于进行API调用的访问令牌创建一个行程

这个示例展示了如何为其帐户与用于进行API调用的访问令牌相关联的用户创建旅行。

请求

帖子https://www.concursolutions.com/api/travel/trip/v1.1HTTPS/1．1授权：OAuth{访问令牌}内容类型：应用程序/ xml......xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”>KK-CNQ-1M1P6-5HJ< ItinSourceName >Concurconnectapi.< / ItinSourceName >从达拉斯到西雅图< / TripName ><评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< TripStatus >73339< / TravelRequestId >< CustomAttribute >< ExternalId/><数据类型>数字< /数据类型><名称>ProposalBatchSize< /名称>< DisplayTitle/><数据>3.真正的< / CustomAttribute >< CustomAttribute >< ExternalId/><数据类型>数字< /数据类型><名称>ProposalSequenceIndex< /名称>< DisplayTitle/><数据>1真正的< / CustomAttribute >< / CustomAttributes ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港2013 - 12 - 21 - t12:00:00< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >F1672664579< / ConfirmationNumber >< StartCityCode >海< / StartCityCode >< EndCityCode >海海< EndLocation >海< / EndLocation >E类> < /C< >传播米<空调装置>R< NumCars >1<折扣码>346660.< DailyRate >44.0000< TotalRate >44.0000< RateType >D<币片美元< >指控固定> <减费<币片美元< >数量0.0000< IsPrimary >假< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><币片美元< >数量44.00002013 - 12 - 21 - t12:00:00< IsPrimary >真正的< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >Concurconnectapi.< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段><供应商>CQ> < /供应商< >状态门将2013 - 12 - 21 - t23:59:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >3364214265< / ConfirmationNumber >< RateCode >LV4<名称>同意酒店< /名称>CONQ03:00点< / CheckinTime >< CheckoutTime >下午12点< / CheckoutTime >1< / NumPersons >1< / NumRooms >CXL在抵达前1天< DailyRate >240.3500.<币片美元< RoomDescription >1大床可访问的房间- k1rrc< >指控<率><币片美元< >数量240.3500.2013 - 12 - 21 - t23:59:00< IsPrimary >假< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >3.0000< / NumUnits >< / >速度< / >指控> < /酒店< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >TravelBookings.com< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >Concurconnectapi.< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /行程>

回复

该响应是同实施例1英寸

更新一次

创建一个新的旅行或更新现有的行程。如果行程日期内无现有通行的新的行程将被创建并请求不包括三脚架。如果一个三脚架包括在URI将更新指定的行程。全行程信息被包括在所述更新请求，它取代了现有的跳闸。

这个端点可以用于为非OAuth消费者的用户创建行程。当旅游供应商或TMC需要代表用户创建旅行时，通常会这样做。供应商或TMC必须向SAP Concur注册，并拥有一个SAP Concur帐户，该帐户具有以下用户角色之一:Professional的Web Services Administrator或Standard的Can administrtor。

取消旅行

此端点可以用来取消所有段的行程。要取消代表用户，令牌OAuth访问用来做API调用应与SAP的Concur帐户的用户相关联的行程。该TripLink供应商或TMC必须与SAP的Concur注册并拥有一个具有以下用户角色之一的SAP Concur帐户：Web服务管理专业，或可以管理标准。

请求

POST /旅游/旅行/ v1.1 /取消吗?tripid=trip_ID[&userid_type=login&userid_value=login_ID]

路径参数

参数名称 数据类型 描述
取消 必需的 细绳 用于取消行程的URI路径修饰符。请求的格式为/旅游/旅行/ v1.1 /取消吗?tripid=trip_ID[&userid_type=login&userid_value=login_ID]。

请求参数

参数名称 数据类型 描述
tripid 细绳 可选:要更新的行程的标识符。例如，如果tripid是I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL，则请求是POST /travel/trip/v1.1?tripid=I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL。
userid_type 细绳 可选:要使用的用户标识类型。可能的值是:login_id。
userid_value 细绳 可选:用户的登录ID。必须与此参数结合提供userid_type参数这个userid_type和userid_value只有在与OAuth 2.0访问令牌关联的用户帐户必须具有其中一个角色之一的SAP Confir帐户时，才能使用参数：Web服务管理员专业或可以为标准管理。用于使用所述请求URI的格式userid_type和userid_value查询参数是/旅游/旅行/ v1.1 / trip_ID吗?userid_type =登录&userid_value=login_ID。

头

授权标题（必填）

授权:OAuth {access_token}

在哪里Access_Token.是您希望创建或更新其行程的用户的OAuth 2.0访问令牌。如果希望访问公司范围内的行程信息，与OAuth 2.0访问令牌关联的用户帐户必须具有SAP Concur帐户，该帐户必须具有以下角色之一:专业Web服务管理员或标准Web服务管理员。

请求内容的身体

没有一个

取消旅行请求模式

该请求返回已取消旅行的全程旅行详细信息。如果请求成功，响应之旅将不包含任何段，因为它们已被取消。响应包括以下附加元素行程父元素:

参数名称 数据类型 描述
id 细绳 包含行程ID的URI。
ItinLocator 细绳 行程定位器值(不带URL的行程ID)。的ItinLocator值在更新现有的行程时使用。
DateModifiedUtc dateTime 最后修改此预订的UTC格式化日期。
BookedVia 细绳 GDS的行程已经订好了。
datebookedlocal. dateTime 按旅行者的当地时间计算的预订日期。

例子

例如:取消带有特定Trip ID的Trip

请求

帖子/ api /旅游/旅行/ v1.1 /取消吗?tripId = CNQR1234567890HTTPS/1．1主持人：www.concursolutions.com授权：OAuth{访问令牌}......

回复

xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >KK-CNQ-1M1P6-5HJ< ItinSourceName >ConcurTravel< / ItinSourceName >从达拉斯到西雅图< / TripName ><评论/>2013 - 12 - 21 - t07:25:00< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >2012-07-24T19:15:52< BookedVia >EveryGDS< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012-07-24T19:15:52< / DateBookedLocal ><预订><预订>< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /C123456789< / RecordLocator >< BookingSource >调整2012-07-24T19:15:52< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >travelsupplier< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订>< >的乘客<乘客>< NameFirst >克里斯< NameLast >米勒< / NameLast >乘客> < /0987654321< / RecordLocator >< BookingSource >ConcurHotel2012-07-24T19:15:52< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /行程>