旅游网站服务(TMC/第三方)

SAP Concur行程Web服务允许差旅管理公司(TMC)、SAP Concur客户端和第三方开发人员在Concur Travel系统中查看和创建与差旅相关的事件。旅游管理公司可以发布任何旅游类型的预订。SAP Concur客户端和第三方开发人员也可以使用该web服务为SAP Concur用户请求旅行信息。可以找到公共的Itinerary XSD在这里。此外，还可以找到GetList XSD在这里。

GET行程列表

检索OAuth令牌中指定的旅行者的旅行摘要。该端点还可以用于获取不同用户或整个公司的旅行详细信息。当差旅管理公司需要代表用户或公司获取旅行列表时，通常会这样做。在请求期间，来自用户所在公司的具有以下用户角色之一的用户必须通过OAuth进行身份验证:专业的Web服务管理员或标准的可管理人员。

此函数的响应可以划分为多个页面，以便于处理。

参数

的名字 描述
tripId 这次旅行id
startDate可以= {_date_} 旅程的url编码的开始日期(以协调世界时(UTC)表示)。格式:YYYY-MM-DD。如果不提供查询参数，则开始日期设置为今天的日期- 30天。该请求将只处理在指定日期期间正在进行的回程，或者从指定日期开始，或者在指定日期之前开始并在指定日期期间进行。
endDate * * * * = {_date_} 行程的url编码的UTC结束日期。格式:YYYY-MM-DD。如果没有提供查询参数，则结束日期设置为今天的日期+ 12个月。该请求将只处理在所提供日期期间正在进行的回程，要么在该日期结束，要么在该日期之前开始并在所提供的日期期间正在进行。
createdAfterDate * * * * = {_date_} 创建行程时用url编码的UTC日期。查询字符串将返回在该日期或之后创建的行程。与createdBeforeDate一起使用，用于查找在日期范围内创建的旅行。格式:YYYY-MM-DD。
createdBeforeDate * * * * = {_date_} 创建行程时用url编码的UTC日期。查询字符串将返回在该日期或之前创建的行程。与createdAfterDate一起使用，用于查找在日期范围内创建的旅行。格式:YYYY-MM-DD。
lastModifiedDate * * * * = {_date_} 行程的最后修改UTC日期及其任何相关预订。此查询字符串将只返回最近修改日期大于或等于所提供时间的旅行或其任何关联预订。提供的日期/时间可以是从现在到数据库中创建旅行的第一个日期之间的任何时间。格式要么是日期，要么是日期和时间的组合。
bookingType = {_type_} 这次旅行至少包括一次这种类型的预订。形式:飞机，汽车，餐饮，酒店，停车场，铁路，或乘车
userid_type = login&userid_value = _ {loginID} _ loginID是用户的SAP Concur登录ID。ALL的userid_value可以被发送来获得公司所有用户的旅行摘要。只有当OAuth使用者具有上面列出的用户角色之一时，才能使用userid_type和userid_value参数。
includeMetadata = true&ItemsPerPage = {_number_}和页面= {_number_} includeMetadata查询参数结合ItemsPerPage和Page查询参数将导致响应被划分为页面。响应将被包装在ConcurResponse父元素，其中包括响应详细信息和分页元数据。回应的细节在这里。如果没有发送ItemsPerPage查询参数，则如果发送了Page查询参数，则响应默认为200，如果没有设置Page查询参数，则响应默认为1000。如果没有发送Page查询参数，则默认响应到Page 1。
includeVirtualTrip = _1_ 虚拟旅行是通过Travel Request产品离线预订的部分。将includeVirtualTrip查询参数设置为1，将这些旅行包含在列表中。
includeCanceledTrips = _{真/假}_ inclecanceledtrips查询参数将导致请求返回状态为“已取消”的行程。当此查询参数设置为真正的，该响应将包括TripStatus元素。

例子:

要获取整个公司的行程列表(OAuth消费者必须具有Admin用户角色):
https://www.concursolutions.com/api/travel/trip/v1.1/?startDate= {startdate可以} &endDate = {enddate｝&_createdAfterDate = {_date} &createdBeforeDate = {日期} &lastModifiedDate = {日期} &bookingType = {类型} &userid_type = login&userid_value =

要获取单个用户(OAuth消费者)的行程列表:
https://www.concursolutions.com/api/travel/trip/v1.1/?startDate= {startdate可以} &endDate = {enddate｝&_createdAfterDate = {_date} &createdBeforeDate = {日期} &lastModifiedDate = {日期} &bookingType = {类型｝

要获取单个用户(不包括OAuth消费者)的行程列表:
https://www.concursolutions.com/api/travel/trip/v1.1/?startDate= {startdate可以} &endDate = {enddate｝&_createdAfterDate = {_date} &createdBeforeDate = {日期} &lastModifiedDate = {日期} &bookingType = {类型} &userid_type = login_id&userid_value = {loginID｝

XML示例请求按开始和结束日期

得到/ api /旅游/旅行/ v1.1 / ?startDate可以= 2012% 2 f02 % 2 2 f12 % 2 f31 f01&enddate = 2013%HTTP/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}.．.

XML示例请求按预订类型和开始日期

得到/ api /旅游/旅行/ v1.1 / ?startDate可以= 2 f02 % 2012% 2 f01&bookingtype =空气HTTP/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}.．.

XML示例请求按创建日期

得到/ api /旅游/旅行/ v1.1 / ?2 f02 % 2 f01 createdAfterDate = 2012%HTTP/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}

XML示例请求与分页

得到/ api /旅游/旅行/ v1.1 / ?createdAfterDate = 2012% 2 f02 % 2 f01&includemetadata = true&ItemsPerPage = 2和页面= 1HTTP/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}

获取行程响应列表

此请求将返回一个ItineraryInfoList的父元素ItineraryInfo指定旅行者的每次旅行摘要的子元素。每一个ItineraryInfo元素有以下子元素:

的名字 描述
TripId 加密的行程标识值。
TripName 旅行名称
TripStatus 旅行的状态。此元素仅在includeCanceledTrips查询参数在请求中使用。
StartDateLocal 旅行的开始日期在起始地点的时区。格式:YYYY-MM-DDThh: mm: ss。
EndDateLocal 在结束地点的时区内的旅行结束日期。格式:YYYY-MM-DDThh: mm: ss。
UserLoginId 用户登录SAP Concur。只有当OAuth使用者具有指定的管理角色之一时才会出现。
DateModifiedUtc 此行程最后修改的UTC日期。格式:YYYY-MM-DDThh: mm: ss。
id 带有加密ID的旅行ID URI。

分页

如果在请求中包含includeMetadata和ItemsPerPage查询参数，则响应将包含一个ConnectResponse包含以下元素的父元素:

的名字 描述
数据 这个父元素包含上面详细描述的响应。
元数据 父元素包含分页元素。

分页的元素

分页信息的父元素。包含以下子元素:

的名字 描述
TotalPages 查询返回的页面总数。
TotalItems 查询返回的行程总数。
当前页 当前响应中结果集的页码。
ItemsPerPage 设置为每页显示的项数。
PreviousPageURL 结果前一页的URI。当没有前一页时，此元素将为空。
NextPageURL 指向下一组结果的URI。当没有下一页时，此元素将为空。

XML成功响应示例

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< / TripId >< TripName >从巴尔的摩到纽约的旅行< / TripName >< StartDateLocal >2012 - 02年- 15 - t09:00:00< / StartDateLocal >< EndDateLocal >2012 - 02年- 21 - t17:30:00< / EndDateLocal >< UserLoginId >cm@example.com< / UserLoginId >< DateModifiedUtc >2012 - 02 - 14 - t17:13:07< / DateModifiedUtc ><标识>https://www.concursolutions.com/api/travel/trip/v1.1/naIzQJ0y2DBWjCIQOb2SHTsozwBsHDkdP< / id >< / ItineraryInfo >< ItineraryInfo >< TripId >I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL< / TripId >< TripName >从巴尔的摩到西雅图的旅行< / TripName >< StartDateLocal >2012 - 03 - 26 - t09:00:00< / StartDateLocal >< EndDateLocal >2012 - 03 - 29 - t17:30:00< / EndDateLocal >< DateModifiedUtc >2012 - 03 - 24 - t19:00:00< / DateModifiedUtc >< UserLoginId >cm@example.com< / UserLoginId ><标识>https://www.concursolutions.com/api/travel/trip/v1.1/I2uwiJJw8r7Owl3IWlSie9WIelxhAhwiL< / id >< / ItineraryInfo >< / ItineraryInfoList >

使用分页成功响应的XML示例

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

把行程细节

检索指定旅行的详细信息。默认情况下，OAuth消费者应该是旅行的所有者。这个端点还可以用于获取OAuth使用者不拥有的行程的详细信息。当差旅管理公司需要代表用户获取旅行详细信息时，通常会这样做。TMC必须向SAP Concur注册，并拥有一个SAP Concur帐户，该帐户具有以下用户角色之一:专业的Web服务管理员，或标准的可以管理。

根据以下条件，返回的元素会有所不同:

  • 一些元素，比如AirlineTickets或RailPayments，只会出现在适当类型的预订。
  • 数量值，例如率或税，只有当请求者是预订的来源时才会出现。所有其他供应商将不会收到与预订相关的金额元素。
  • 一些元素，比如SabreDKNumber，只有当预订是由相关GDS创建时才会显示。
  • 有些元素是特定于供应商的，只会出现在相关供应商的响应中。

该文档包含可返回的所有可能元素。没有一个行程可以包含所有可能的元素，因此响应总是可能返回值的子集。

参数

的名字 描述
{_tripId_} 必需的。所需行程的标识符。
userid_type = login&userid_value = _ {loginID} _ loginID是用户的SAP Concur登录ID。ALL的userid_value可以被发送来获得公司所有用户的旅行摘要。只有当OAuth使用者具有上面列出的用户角色之一时，才能使用userid_type和userid_value参数。
systemFormat = _{格式}_ 的systemFormat参数可用于指定针对不同系统格式化响应。支持的值为Tripit．

获取行程详情

此请求将返回一个行程带有以下子元素子集的父元素:

参数

的名字 描述
BookedByFirstName 预订行程的人的名字。
BookedByLastName 预订这次旅行的人的姓。
BookedVia 旅行的预订方法。
CancelComments 如果行程取消，提供的评论。最大长度256个字符。
评论 可选的评论。最大长度:512个字符。
DateBookedLocal 预订行程的日期，以预订地点的当地时间表示。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建此行程的日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 此行程最后修改的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
描述 这次旅行描述。最大长度:512个字符。
EndDateLocal 在结束地点的时区内的旅行结束日期。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 旅行的结束日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
IsPersonal 无论这次旅行是商务旅行还是休闲旅行。格式:真/假。
ProjectName 行程的关联项目名称。最大长度为255个字符。
StartDateLocal 旅行的开始日期在起始地点的时区。格式:YYYY-MM-DDThh: mm: ss
StartDateUtc 旅行的开始日期，UTC。格式:YYYY-MM-DDThh: mm: ss
TripName 旅行名称。最大长度为255个字符。
预订 这个父元素将包含一个预订与此行程相关联的每个预订的子元素。请参阅“预订子元素”表。
RuleViolations 与行程有关的违反规则的清单。父元素包含一个RuleViolation每个关联规则违反的子元素。指的是公开行程XSD为更多的信息。
状态 行程的状态。以下之一:0 =已确认;1 =代理开票;2 =取消

预订子元素

的名字 描述
BookingSource 此预订的预订源的名称。预订源是一个文本名称，系统使用它来跟踪预订发生的位置。
DateBookedLocal 用预订地点的当地时间创建预订的日期。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 最后修改预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
FormOfPaymentName 预订付款方式的名称。
FormOfPaymentType 支付形式的类型。
PassengerCount 订票包括的旅客人数。
RecordLocator 此预订的记录定位器。这通常是六个字母数字字符，但根据预订源可以有其他格式。
RetrievedDateUtc 最后访问预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
TicketMailingAddress 所订机票的邮寄地址(如有)。
TicketPickupLocation 已预订机票的取票地点(如有的话)。
TicketPickupNumber 取票的确认号码(如有)。
AirfareQuotes 存储的机票报价列表。这个父元素有一个报价每个机票报价的子元素。的报价父元素包含机票报价子元素
AirlineTickets 机票清单。这个父元素包含机票子元素
指控 预订的费用。
MiscChargeOrders 这个父元素有一个MiscellaneousChargeOrder每项包括杂项费用的子元素。的MiscellaneousChargeOrder父元素包含杂项收费顺序子元素
乘客 这个父元素有一个乘客每个被包含的乘客的子元素。指的是乘客子元素
PassPrograms 这个父元素有通过程序子元素对于与预订相关联的每个通行证程序。
phonenumber 这个父元素有电话号码的数据子元素与预订相关的每个电话号码。
RailPayments 这个父元素有铁路付款子元素
段 这个父元素将包含以下子元素中的至少一个:空气，车，酒店，餐厅，骑，铁路，停车．
交付 用于交付此预订的方法。指的是子元素
WaitListSegments 如果段在等待列表中，信息将出现在该元素中。
警告 与预订相关的警告。
WebAddresses 网址列表。这个父元素包括网络地址数据子元素为每个相关网址。
BookingReferrer BookingReferrer仅在特定的源跟踪场景中使用，此时需要区分来自不同流的相同bookingsource的预订。不要在没有与您的技术联系人协调的情况下进行填充。支持的值是:Concur Travel, sign in with SAP Concur, Supplier Mobile, Supplier Web。

机票报价子元素

的名字 描述
BaseFare 预订报价的基本费用。
BaseFareCurrency 的3个字母的ISO 4217货币代码预订报价。
BaseFareNuc 基本票价NUC．
BaseFareNucCurrency 的3个字母的ISO 4217货币代码在NUC的基本票价。
DateCreatedUtc 引用的创建日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 报价最后修改的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
代言 如果航空公司认可该机票在其他航空公司可接受，则由航空公司发出通知。
IssueByDate 报价的日期必须在。格式:YYYY-MM-DDThh: mm: ss
TotalFare 预订的总价。
TotalFareCurrency 的3个字母的ISO 4217货币代码总价。
AirlineCharges 航空公司收取的费用。父元素包含一个固定来自航空公司的每个固定费用的子元素。
税 税金适用于这张机票。

机票子元素

的名字 描述
ManualAirlineTicket 用于预订的手动机票。
AirlineTicket 预订机票。
AirlineAdjustment 任何对预订的调整。

杂项收费顺序子元素

的名字 描述
DateCreatedUtc 记账订单被创建的日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 最后修改收费命令的日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
IssueDate 押记令发出的日期。格式:YYYY-MM-DDThh: mm: ss
PlatingCarrierNumericCode 表示航空公司代码的机票号码的一部分。这是一个三位数。例如:001=美国航空，005=大陆航空，006=达美航空，012=西北航空
PlatingControlNumber 票号的一部分，表示票号控制号码。格式:10位数字。
TotalAmount 该票据的收费订单总额。
TotalAmountCurrency 的3个字母的ISO 4217货币代码为总收费订单金额。

传递程序子元素

的名字 描述
量 该项目金额。
的名字 这个项目的名字。
类型 程序类型。
UserFirstName 乘客的名字。
UserLastName 乘客的姓。

电话号码数据子元素

的名字 描述
PassengerRPH 表示该电话号码所属的乘客。
PhoneNumber 乘客的电话号码。
类型 电话号码的类型。
描述 电话号码的描述。

铁路付款子元素

的名字 描述
RailPayment 铁路预订的付款信息。
RailAdjustment 根据铁路预订调整的金额。指的是公开行程XSD为更多的信息。

子元素

的名字 描述
LocationAdditionalDetails 关于交付地点的附加信息。
AddressLine1 交货地址。
AddressLine2 交货地址。
城市 交货地址。
国家 交货地址。
LocationDesc 交货地点的描述。
电子邮件 发送邮件联系方式。
纬度 交货地址。
经度 交货地址。
LocationName 送货地点的名称。
PhoneNumber 送货联系人的电话号码。
ReferenceNumber 交付的参考编号。
状态 交货地址。
类型 收货地址的类型。
邮政编码 交货地址。

Web地址数据子元素

的名字 描述
PassengerRPH 指示此网址所属的旅客。
WebAddress 网络地址。格式:email地址或URL地址。最大长度:250个字符。
格式 网址格式。格式:E=Email, U=URL, I=IM
类型 输入网址代码。格式:TKT, RES, BUS
描述 描述网址的免费文本。最大长度:50个字符。

乘客子元素

的名字 描述
FirstNameNumber 乘客名字的字符数。
LastNameNumber 乘客姓氏的字符数。
NameFirst 乘客的名字。
NameLast 乘客的姓。
NameMiddle 乘客的中间名。
NamePrefix 旅客姓名的前缀。
NameRemark 乘客姓名的其他详细信息。
NameSuffix 乘客的名字后缀。
NameTitle 乘客的姓名和头衔。
TextName 用户的全名。
FrequentTravelerProgram 乘客的忠诚计划标识符。父元素包含FrequentFlyer而且RailProgram子元素。
FrequentFlyer 乘客的飞行常客计划详情。这个父元素有常旅客子元素
RailProgram 乘客的铁路忠诚计划详情。这个父元素有铁路计划子元素

常旅客子元素

的名字 描述
AirlineVendor 常旅客计划的供应商。
描述 程序描述。
DiscountProgramExpirationDate 折扣计划注册截止日期。格式:YYYY-MM-DDThh: mm: ss
DiscountProgramType 折扣计划的类型。
FrequentFlyerNumber 乘客的程序识别码。
ProgramVendor 程序供应商。
状态 乘客的计划状态。
StatusExpirationDate 乘客计划状态的截止日期。

铁路计划子元素

的名字 描述
描述 折扣计划的描述。
DiscountProgramExpirationDate 折扣计划注册截止日期。格式:YYYY-MM-DDThh: mm: ss
DiscountProgramType 折扣计划的类型。
ProgramNumber 乘客的程序识别码。
ProgramVendor 程序供应商。
状态 乘客的计划状态。
StatusExpirationDate 乘客计划状态的截止日期。

XML成功响应示例

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 >< ClientLocator >KK-CNQ-1M1P6-5HJ< / ClientLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< TripName >从达拉斯到西雅图的旅程< / TripName ><评论/>< StartDateLocal >2013 - 12 - 21 - t07:25:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< BookedVia >EveryGDS< / BookedVia >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012 - 07 - 24 - t19:15:52< / DateBookedLocal ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >< ConfirmationNumber >F1672664579< / ConfirmationNumber >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< StartCityCode >海< / StartCityCode >< EndCityCode >海< / EndCityCode >< StartLocation >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播米> < /传播<空调装置>R< /空调装置>< NumCars >1< / NumCars >< DiscountCode >346660< / DiscountCode >< DailyRate >44.0000< / DailyRate >< TotalRate >44.0000< / TotalRate >< RateType >D< / RateType ><货币>美元货币> < /< >指控固定> <<描述>减费> < /描述<货币>美元货币> < /< >数量0.0000< / >数量< IsPrimary >假< / IsPrimary >< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><货币>美元货币> < /< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< IsPrimary >真正的< / IsPrimary >< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< / AllowanceNumUnits >< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /> < /部分< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >C123456789< / RecordLocator >< BookingSource >ConcurCars< / BookingSource >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >TravelSupplier< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段>酒店> <<供应商>CQ> < /供应商< >状态门将> < /状态< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< ConfirmationNumber >3364214265< / ConfirmationNumber >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< RateCode >LV4< / RateCode ><名称>同意酒店< /名称>< HotelPropertyId >CONQ< / HotelPropertyId >< CheckinTime >00:00< / CheckinTime >< CheckoutTime >00:00< / CheckoutTime >< NumPersons >1< / NumPersons >< NumRooms >1< / NumRooms >< CancellationPolicy >到达前1天< / CancellationPolicy >< DailyRate >240.3500< / DailyRate ><货币>美元货币> < /< RoomDescription >1个大床房- k1rrc< / RoomDescription >< >指控<率><货币>美元货币> < /< >数量240.3500< / >数量< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< IsPrimary >假< / IsPrimary >< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >3.0000< / NumUnits >< / >速度< / >指控> < /酒店> < /部分< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >0987654321< / RecordLocator >< BookingSource >ConcurHotel< / BookingSource >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /预订>< /行程>

TripIt格式的XML响应

<？xml version = " 1.0 " encoding = " utf - 8 " ?><回答>< >旅行<标识>73014481752< / id >< relative_url >/ api /旅游/旅行/ v1.1/73014481752< / relative_url >< start_date >2013-08-21< / start_date >< end_date >2013-08-24< / end_date >< display_name >战略小组会议< / display_name >< is_private >真正的< / is_private >> < /旅行< AirObject >< booking_site_conf_num >RL10001005< / booking_site_conf_num >< booking_site_name >同意旅行< / booking_site_name >< booking_site_phone > < / booking_site_phone >< booking_site_url >https://www.concursolutions.com< / booking_site_url >< record_locator >4294993825< / record_locator >< supplier_conf_num >CN10001005< / supplier_conf_num >< supplier_contact > < / supplier_contact >< supplier_email_address > < / supplier_email_address >< supplier_name > < / supplier_name >< supplier_phone > < / supplier_phone >< supplier_url > < / supplier_url >< is_purchased >1< / is_purchased ><笔记> < /笔记>> <限制> < /限制< total_cost > < / total_cost ><段>< StartDateTime ><日期>2013-08-21> < /日期<时间>07:45:00< /时间>< / StartDateTime >< EndDateTime ><日期>2013-08-21> < /日期<时间>13:03:00< /时间>< / EndDateTime >< start_airport_code >PHX< / start_airport_code >< start_gate >A11< / start_gate >< start_terminal >4< / start_terminal >< end_airport_code >奥德< / 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 >经济< / service_class ><停止>不间断的< /停止>> < /部分<段>< StartDateTime ><日期>2013-08-24> < /日期<时间>13:55:00< /时间>< / StartDateTime >< EndDateTime ><日期>2013-08-24> < /日期<时间>16:58:00< /时间>< / EndDateTime >< start_airport_code >奥德< / start_airport_code >< start_gate > < / start_gate >< start_terminal > < / start_terminal >< end_airport_code >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 >经济< / service_class ><停止>停止< /停止>> < /部分<旅行者>< first_name >威廉< / first_name >< middle_name > < / middle_name >< last_name >从来没有< / last_name >< frequent_traveler_num > < / frequent_traveler_num >< frequent_traveler_supplier > < / frequent_traveler_supplier >< ticket_num > < / ticket_num >< /旅行>< / AirObject >< /响应>

行程的细节后

描述

创建新行程或更新现有行程。如果旅行日期不跨越现有的旅行，并且请求不包含tripId，则将创建一个新的旅行。如果URI中包含一个tripId，它将更新指定的trip。完整的旅行信息包含在更新请求中，它将替换现有的旅行。

此端点可用于为非OAuth消费者的用户创建行程。当旅行供应商或旅行管理公司需要代表用户创建旅行时，通常会这样做。供应商或TMC必须在SAP Concur中注册，并拥有一个SAP Concur帐户，该帐户具有以下用户角色之一:专业的Web服务管理员，或标准的可以管理。

机构的建议

为SAP Concur提供旅行请求代理提议功能的差旅管理公司可以使用Itinerary web服务发送提议的行程。TMC将使用TripStatus元素。请求还必须包括CustomAttributes元素及其子元素。

查询参数—必选 支持内容类型
没有一个 应用程序/ xml

查询参数-可选

  • ｛tripId｝
    所需行程的标识符。如果请求正在更新现有的行程，则提供。
  • userid_type = login_id&userid_value = {loginID｝
    拥有旅行的用户的SAP Concur loginID。可在创建新行程或更新现有行程时使用。只有当OAuth使用者具有上面列出的用户角色时，才能使用userid_type和userid_value参数。

例子:
为OAuth消费者发布一个新的旅程:
https://www.concursolutions.com/api/travel/trip/v1.1

要为OAuth使用者更新一次旅行:
https://www.concursolutions.com/api/travel/trip/v1.1?tripId= {_tripId_}

为OAuth使用者以外的用户发布旅行:
https://www.concursolutions.com/api/travel/trip/v1.1?userid_type=login_id&userid_value= {_loginID_}

请求头-必需 请求头-可选
有效SAP Concur用户的带有OAuth令牌的授权头。要为OAuth使用者以外的用户发布行程，OAuth使用者必须在SAP Concur中具有以下用户角色之一:公司管理员或面向专业的Web服务管理员，或面向标准的可管理人员。 没有一个

内容的身体

这个函数需要作为它的参数行程父元素。父元素包含以下子元素:

必需的元素

元素 描述
TripName 旅行名称。最大长度为255个字符。
TripStatus 行程的状态。以下其中之一:
0 -确认
1 -出票
2 -取消
6 -建议
7 -预订提案

机构提案所需要素

元素 描述
ClientLocator 该批次提案的唯一标识符。批处理中的所有建议都应该具有相同的值。
TravelRequestId 与建议相关联的旅行请求的标识符。
CustomAttributes 这个父元素将包含CustomAttributes子元素。的CustomAttributes子元素在CustomAttributes elements表中详细说明。

CustomAttributes元素-必选

数据类型 的名字 数据支持的值 评论
数字 ProposalBatchSize 1到3 批中提案的数量。最大:3
数字 ProposalSequenceIndex 1到3 该提案在该批次提案中的索引。
文本 AutoSelectProposal 真的,假的 如果为true，则建议将被相应选择，并替换用户先前输入的段。
如果为False，则该提议将由用户决定他/她想手动选择哪个提议。
文本 TicketIssued 真的,假的 这个提案的票出了没有?
文本 DisplayOnItinerary 真正的 该元素的值必须为' True '。
N/A DisplayTitle N/A 这个元素应该为空。
N/A ExternalId N/A 这个元素应该为空。

可选元素

元素 描述
BookedByFirstName 旅行主人的名字。
BookedByLastName 旅行主人的姓。
预订 这个父元素将包含一个预订与此行程相关联的每个预订的子元素。的预订子元素在Booking elements表中详细说明。
CancelComments 如果旅行被取消，用户提供评论。最大256个字符
评论 对行程的评论。最大512个字符
DateBookedLocal 预订行程的日期，以预订地点的当地时间表示。格式:YYYY-MM-DDThh: mm: ss
描述 这次旅行描述。最大长度:512个字符。
IsPersonal 无论这次旅行是商务旅行还是休闲旅行。
ProjectName 行程的关联项目名称。最大长度为255个字符。
RuleViolations 与行程有关的违反规则的清单。父元素包含一个 每个关联规则违反的子元素。

预订要素-必需

元素 描述
BookingSource 此预订的预订源的名称。预订源是一个文本名称，系统使用它来跟踪预订发生的位置。这可以是一个GDS, OTA，供应商网站的供应商代码，或供应商直接连接API。
RecordLocator 预订的唯一标识符。发送现有预订的值以更新现有的旅行。

预订要素-可选

元素 描述
BookingOwner 指示向Concur Travel提供预订的工具。
源 过时，支持向后兼容。
DateBookedLocal 用预订地点的当地时间创建预订的日期。格式:YYYY-MM-DDThh: mm: ss
FormOfPaymentName 预订付款方式的名称。
FormOfPaymentType 支付形式的类型。
TicketMailingAddress 订票的邮寄地址，如果有的话。
TicketPickupLocation 预定机票的取票地点，如果有的话。
TicketPickupNumber 订票的确认号码，如果有的话。
AirfareQuotes 此预订的储存机票报价列表。
机票 本次预定的机票清单。
指控 此预订的费用清单。
MiscChargeOrders 此订位之杂项空运费用一览表。
乘客 父元素包含一个乘客每个已预订乘客的子元素。的乘客子元素包含以下子元素:
NameFirst -乘客的名字。
NameLast(可选)——乘客的姓。
NameMiddle -乘客的中间名。
NamePrefix -乘客姓名前缀。
姓名标记——乘客姓名的附加信息。
NameSuffix -乘客的名字后缀。
姓名头衔-乘客的姓名头衔。
TextName—如果与数据库中的名称不同，则在预订工具中输入的用户全名。
FrequentTravelerProgram -旅客忠诚计划。
PassPrograms 此预订的通行证程序列表。
phonenumber 与此预订相关的电话号码列表。
RailPayments 此预订中与铁路部分相关的铁路付款清单。
段 这个父元素将包含以下子元素中的至少一个:空气，车，酒店，餐厅，骑，铁路，停车，事件．
交付 此预订的交付方法。
WaitListSegments 旅客在此预订中等待的航段。
警告 与预订相关的警告。
WebAddresses 与此预订相关的网址列表，如电子邮件、取件地址等。
BookingReferrer BookingReferrer仅在特定的源跟踪场景中使用，此时需要区分来自不同流的相同bookingsource的预订。不要在没有与您的技术联系人协调的情况下进行填充。支持的值是:Concur Travel, sign in with SAP Concur, Supplier Mobile, Supplier Web

XML示例请求

帖子/ 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”>< ClientLocator >KK-CNQ-1M1P6-5HJ< / ClientLocator >< ItinSourceName >ConcurConnectAPI< / ItinSourceName >< TripName >从达拉斯到西雅图的旅程< / TripName ><评论/>< StartDateLocal >2013 - 12 - 21 - t07:25:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >< ConfirmationNumber >F1672664579< / ConfirmationNumber >< StartCityCode >海< / StartCityCode >< EndCityCode >海< / EndCityCode >< StartLocation >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播米> < /传播<空调装置>R< /空调装置>< NumCars >1< / NumCars >< DiscountCode >346660< / DiscountCode >< DailyRate >44.0000< / DailyRate >< TotalRate >44.0000< / TotalRate >< RateType >D< / RateType ><货币>美元货币> < /< >指控固定> <<描述>减费> < /描述<货币>美元货币> < /< >数量0.0000< / >数量< IsPrimary >假< / IsPrimary >< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><货币>美元货币> < /< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< IsPrimary >真正的< / IsPrimary >< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< / AllowanceNumUnits >< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /> < /部分< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >C123456789< / RecordLocator >< BookingSource >TravelBookings.com< / BookingSource >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >ConcurConnectAPI< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段>酒店> <<供应商>CQ> < /供应商< >状态门将> < /状态< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< ConfirmationNumber >3364214265< / ConfirmationNumber >< RateCode >LV4< / RateCode ><名称>同意酒店< /名称>< HotelPropertyId >CONQ< / HotelPropertyId >< CheckinTime >03:00点< / CheckinTime >< CheckoutTime >下午12点< / CheckoutTime >< NumPersons >1< / NumPersons >< NumRooms >1< / NumRooms >< CancellationPolicy >到达前1天< / CancellationPolicy >< DailyRate >240.3500< / DailyRate ><货币>美元货币> < /< RoomDescription >1个大床房- k1rrc< / RoomDescription >< >指控<率><货币>美元货币> < /< >数量240.3500< / >数量< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< IsPrimary >假< / IsPrimary >< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >3.0000< / NumUnits >< / >速度< / >指控> < /酒店> < /部分< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >0987654321< / RecordLocator >< BookingSource >TravelBookings.com< / BookingSource >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >ConcurConnectAPI< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /预订>< /行程>

代理提案的XML示例请求

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

邮寄行程详情

HTTP响应 支持内容类型
HTTP状态代码 应用程序/ xml

内容的身体

当成功创建旅行时，请求将返回完整的发布的旅行详细信息，并在行程父元素:

元素 描述
id 包含旅行ID的URI。
ItinLocator 行程定位器值(不带URL的行程ID)。的ItinLocator值在更新现有行程时使用。
DateModifiedUtc 此预订最后修改的UTC格式日期。
BookedVia 预定行程的GDS。
DateBookedLocal 以旅行者当地时间计算的预订日期。

代理的计划

响应将包括CustomAttributes元素及其子元素，如果请求是一个Agency Proposal。

XML成功响应示例

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

成功响应代理提案的XML示例

<行程xmlns =“http://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >< ClientLocator >KK-CNQ-1M1P6-5HJ< / ClientLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< TripName >从达拉斯到西雅图的旅程< / TripName ><评论/>< StartDateLocal >2013 - 12 - 21 - t07:25:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< BookedVia >EveryGDS< / BookedVia >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012 - 07 - 24 - t19:15:52< / DateBookedLocal ><预订><预订><段><汽车><供应商>CQ> < /供应商< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >< ConfirmationNumber >F1672664579< / ConfirmationNumber >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< StartCityCode >海< / StartCityCode >< EndCityCode >海< / EndCityCode >< StartLocation >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播米> < /传播<空调装置>R< /空调装置>< NumCars >1< / NumCars >< DiscountCode >346660< / DiscountCode >< DailyRate >44.0000< / DailyRate >< TotalRate >44.0000< / TotalRate >< RateType >D< / RateType ><货币>美元货币> < /< >指控固定> <<描述>减费> < /描述<货币>美元货币> < /< >数量0.0000< / >数量< IsPrimary >假< / IsPrimary >< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><货币>美元货币> < /< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< IsPrimary >真正的< / IsPrimary >< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >1.0000< / NumUnits >< AllowanceNumUnits >250.0000< / AllowanceNumUnits >< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控汽车> < /> < /部分< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >C123456789< / RecordLocator >< BookingSource >ConcurCars< / BookingSource >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >TravelSupplier< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订><预订><段>酒店> <<供应商>CQ> < /供应商< >状态门将> < /状态< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t23:59:00< / EndDateLocal >< ConfirmationNumber >3364214265< / ConfirmationNumber >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< RateCode >LV4< / RateCode ><名称>同意酒店< /名称>< HotelPropertyId >CONQ< / HotelPropertyId >< CheckinTime >00:00< / CheckinTime >< CheckoutTime >00:00< / CheckoutTime >< NumPersons >1< / NumPersons >< NumRooms >1< / NumRooms >< CancellationPolicy >到达前1天< / CancellationPolicy >< DailyRate >240.3500< / DailyRate ><货币>美元货币> < /< RoomDescription >1个大床房- k1rrc< / RoomDescription >< >指控<率><货币>美元货币> < /< >数量240.3500< / >数量< StartDateLocal >2013 - 12 - 21 - t23:59:00< / StartDateLocal >< IsPrimary >假< / IsPrimary >< SemanticsCode >ROOMRATE< / SemanticsCode >< SemanticsVendorType >H< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >3.0000< / NumUnits >< / >速度< / >指控> < /酒店> < /部分< >的乘客乘客> << NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< RecordLocator >0987654321< / RecordLocator >< BookingSource >ConcurHotel< / BookingSource >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< OriginalItinLocator >33491211< / OriginalItinLocator >< ItinSourceName >ConcurTravel< / ItinSourceName >< PassengerCount >1< / PassengerCount >< /预订>< /预订>< CustomAttributes >< CustomAttribute >< ExternalId/><数据类型>数字< /数据类型><名称>ProposalBatchSize< /名称>< DisplayTitle/><数据>3.> < /数据< DisplayOnItinerary >真正的< / DisplayOnItinerary >< / CustomAttribute >< CustomAttribute >< ExternalId/><数据类型>数字< /数据类型><名称>ProposalSequenceIndex< /名称>< DisplayTitle/><数据>1> < /数据< DisplayOnItinerary >真正的< / DisplayOnItinerary >< / CustomAttribute >< / CustomAttributes >< /行程>

邮寄行程取消申请

描述 支持内容类型
取消所提供行程中的所有段。
此端点可用于为非OAuth消费者的用户取消行程。当旅行供应商或旅行管理公司需要代表用户取消旅行时，通常会这样做。供应商或TMC必须在SAP Concur中注册，并拥有具有以下用户角色之一的SAP Concur帐户:专业的Web服务管理员或标准的可管理人员。
 应用程序/ xml

查询参数—必选

  • 取消吗?｛tripId｝
    所需行程的标识符和cancel关键字。

例子:
https://www.concursolutions.com/api/travel/trip/v1.1/cancel?tripId= {_tripId_}

查询参数-可选

  • userid_type = login_id&userid_value = {loginID｝
    拥有旅行的用户的SAP Concur loginID。只有当OAuth使用者具有上面列出的用户角色时，才能使用userid_type和userid_value参数。

例子:
https://www.concursolutions.com/api/travel/trip/v1.1/cancel?tripId= {_tripId_} &userid_type = login_id&userid_value = {_loginID_}

请求头-必需 请求头-可选
有效SAP Concur用户的带有OAuth令牌的授权头。OAuth使用者在SAP Concur中必须具有以下用户角色之一:公司管理员或专业的Web服务管理员，或标准的可管理人员。 没有一个

XML示例请求

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

后行程取消

HTTP响应 支持内容类型
HTTP状态代码 应用程序/ xml

内容的身体

该请求将返回已取消行程的完整行程细节。这次旅行将不包含任何环节，因为所有环节都被取消了。控件中包含以下附加元素行程父元素:

元素 描述
id 包含旅行ID的URI。
ItinLocator 行程定位器值(不带URL的行程ID)。
ClientLocator 客户端的标识符。
DateModifiedUtc 此预订最后修改的UTC格式日期。
BookedVia 预定行程的GDS。
DateBookedLocal 以旅行者当地时间计算的预订日期。

XML成功响应示例

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

后预订细节

创建新预订或更新现有预订。新的预订将分配给指定的旅行，如果没有指定旅行，则分配给跨越预订日期的第一个行程。如果没有指定行程，也不存在跨越预订日期的行程，则将创建一个新的行程。

此端点可用于为非OAuth消费者的用户创建/更新预订。当旅行供应商或旅行管理公司需要代表用户创建/更新预订时，通常会使用这种方法。供应商或TMC必须在SAP Concur上注册，并且必须拥有具有以下用户角色之一的帐户:Web Services Administrator for Professional，或Can administrative for Standard。

帖子/ api /旅游/预订/ v1.0吗?tripId = 12345678HTTPS/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}

请求参数

查询参数-可选

  • tripId = {tripId}旅行的唯一标识符。为将预订添加到现有的旅行中而提供。
  • userid_type = login_id&userid_value = {loginID}拥有预订的用户的SAP Concur登录ID。仅当预订所有者不是OAuth消费者时提供。只能在OAuth使用者具有所需的用户角色时使用。

例子:

https://www.concursolutions.com/api/travel/booking/v1.1?tripId= {tripId}

https://www.concursolutions.com/api/travel/booking/v1.1?userid_type=login_id&userid_value= {loginID}

请求主体根元素

该请求包含一个Booking父元素，带有以下子元素:

必需的元素 描述
BookingSource 供应商的名字。
ItinSourceName 行程的来源。格式:TravelSupplier
RecordLocator 此预订的记录定位器。这通常是六个字母数字字符，但根据预订源可以有其他格式
可选的元素 描述
DateBookedLocal 用预订地点的当地时间创建预订的日期。格式:YYYY-MM-DDThh: mm: ss
FormOfPaymentName 预订付款方式的名称。
FormOfPaymentType 支付形式的类型。
TicketMailingAddress 订票的邮寄地址，如果有的话。
TicketPickupLocation 预定机票的取票地点，如果有的话
TicketPickupNumber 取票的确认号码，如果有的话。
AirfareQuotes 此预订的储存机票报价列表。
AirlineTickets 本次预定的机票清单。
指控 此预订的费用清单。
MiscChargeOrders 此订位之杂项空运费用一览表。
乘客 的乘客元素包含每个预订乘客的子元素。每个子元素的描述可以在后面的表中看到。
PassPrograms 此预订的通行证程序列表。
phonenumber 与此预订相关的电话号码列表。
RailPayments 此预订中与铁路部分相关的铁路付款清单。
段 此预订的分段清单。这个父元素包含一个或多个空气，车，酒店，餐厅，骑，铁路，停车,或事件预订的父元素。
交付 此预订的交付方法。
WaitListSegments 旅客在此预订中等待的航段。
警告 与预订相关的警告。
WebAddresses 与此预订相关的网址列表，如电子邮件、取件地址等
BookingReferrer BookingReferrer仅在特定的源跟踪场景中使用，此时需要区分来自不同流的相同bookingsource的预订。不要在没有与您的技术联系人协调的情况下进行填充。支持的值是:Concur Travel, sign in with SAP Concur, Supplier Mobile, Supplier Web

乘客子元素

必需的元素 描述
NameFirst 乘客的名字。
NameLast 乘客的姓。
可选的元素 描述
NameMiddle 乘客的中间名。
NamePrefix 旅客的姓名前缀。
NameRemark 乘客姓名的其他详细信息。
NameSuffix 乘客的姓名后缀。
NameTitle 旅客的姓名。
TextName 如果与数据库中的名称不同，则在预订工具中输入的用户全名。
FrequentTravelerProgram 旅客的忠诚度计划

响应

这个函数返回完整的旅行细节。

如果最终用户更新现有的预订导致新的确认号，那么除了将新的预订发布到SAP Concur之外，还必须显式取消旧的预订。如果之前的预订没有取消，用户将在SAP Concur旅行列表中看到两个预订。

例子

例1:XML示例请求

帖子/ api /旅游/预订/ v1.0吗?tripId = 12345678HTTPS/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}内容类型：应用程序/ xml.．.<预订xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xmlns: xsd =“http://www.w3.org/2001/XMLSchema”><段><汽车><供应商>艾尔> < /供应商< VendorName >阿拉莫< / VendorName >< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 23 - t12:00:00< / EndDateLocal >< StartDateUtc >2013 - 12 - 21 - t20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 23 - t20:00:00< / EndDateUtc >< ConfirmationNumber >F16726AIUS< / ConfirmationNumber >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< / DateModifiedUtc >< StartCityCode >海< / StartCityCode >< EndCityCode >海< / EndCityCode >< StartLocation >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播一个> < /传播<空调装置>R< /空调装置>< NumPersons >1< / NumPersons >< NumCars >1< / NumCars >< DiscountCode >4321< / DiscountCode >< DailyRate >35.0000< / DailyRate >< TotalRate >105.0000< / TotalRate >< RateType >D< / RateType ><货币>美元货币> < /汽车> < /> < /部分< RecordLocator >PANAMA50< / RecordLocator >< BookingSource >阿拉莫< / BookingSource >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >TravelSupplier< / ItinSourceName >< >的乘客乘客> << PassengerKey >0< / PassengerKey >< NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< /预订>

例2:成功响应的XML示例

<行程xmlns =“https://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator >< ClientLocator >KK-CNQ-1M1P6-5HJ< / ClientLocator >< ItinSourceName >TravelSupplier< / ItinSourceName >< TripName >西雅图之旅< / TripName ><评论/>< StartDateLocal >2013 - 12 - 21 - t07:25:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 23 - t23:59:00< / EndDateLocal >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52< / DateModifiedUtc >< BookedVia >EveryGDS< / BookedVia >< BookedByFirstName >克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012 - 07 - 24 - t19:15:52< / DateBookedLocal ><预订><段><汽车><供应商>艾尔> < /供应商< VendorName >阿拉莫< / VendorName >< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 23 - t12:00:00< / EndDateLocal >< StartDateUtc >2013 - 12 - 21 - t20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 23 - t20:00:00< / EndDateUtc >< ConfirmationNumber >F16726AIUS< / ConfirmationNumber >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< / DateModifiedUtc >< StartCityCode >海< / StartCityCode >< EndCityCode >海< / EndCityCode >< StartLocation >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播一个> < /传播<空调装置>R< /空调装置>< NumPersons >1< / NumPersons >< NumCars >1< / NumCars >< DiscountCode >4321< / DiscountCode >< DailyRate >35.0000< / DailyRate >< TotalRate >105.0000< / TotalRate >< RateType >D< / RateType ><货币>美元货币> < /汽车> < /> < /部分< RecordLocator >PANAMA50< / RecordLocator >< BookingSource >阿拉莫< / BookingSource >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< / DateModifiedUtc >< DateBookedLocal >2013 - 11 - 10 - t13:01:00< / DateBookedLocal >< ItinSourceName >TravelSupplier< / ItinSourceName >< >的乘客乘客> << PassengerKey >0< / PassengerKey >< NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< /预订>< /行程>

后预订取消

取消现有的预订。默认情况下，OAuth消费者应该是预订的所有者。这个端点还可以用于取消OAuth消费者不拥有的预订。当差旅管理公司需要代表用户取消预订时，通常会采用这种方法。TMC必须向SAP Concur注册，并拥有一个SAP Concur帐户，该帐户具有以下用户角色之一:专业的Web服务管理员，或标准的可以管理。

注意:
预订记录只能由创建它们的预订源更新。SAP Concur在处理请求之前验证源信息。

帖子/ api /旅游/预订/ v1.1 /取消吗?bookingSource = {FastTravel} &confirmationNumber = {098765431}HTTPS/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}

请求参数

查询参数—必选

  • 取消吗?bookingSource ={供应商}

cancel关键字和供应商的唯一标识符，由SAP Concur在应用程序审查期间配置。预订源必须与与预订相关联的供应商名称相匹配。

  • confirmationNumber = {confnum}

要取消预订的确认号码。

例子:https://www.concursolutions.com/api/travel/booking/v1.1/cancel?bookingSource={供应商}&confirmationNumber = {confnum}

查询参数-可选

  • userid_type = login_id&userid_value = {loginID}

拥有预订的用户的SAP Concur登录ID。仅当预订所有者不是OAuth消费者时提供。只能在OAuth使用者具有所需的用户角色时使用。

例子:https://www.concursolutions.com/api/travel/booking/v1.1/cancel?bookingSource={供应商}&confirmationNumber = {confnum} &userid_type = login_id&userid_value = {loginID}

内容类型

应用程序/ xml

授权头

授权头必须具有有效SAP Concur用户的OAuth令牌。OAuth使用者必须在SAP Concur中注册为供应商或TMC，并且必须在SAP Concur中具有以下用户角色之一:公司管理员或专业的Web服务管理员，或标准的可管理人员。

响应

这个函数返回完整的预订详细信息。如果没有找到预订，该函数返回一个HTTP 404错误和以下元素:

状态:该元素包含值:NotFound。

例子

示例1:XML示例请求

帖子/ api /旅游/预订/ v1.1 /取消吗?bookingSource = {FastTravel} &confirmationNumber = {098765431}HTTPS/1．1宿主：www.concursolutions.com授权：OAuth{访问令牌}

示例2:成功响应的XML示例

<汽车><供应商>泽> < /供应商< >状态香港> < /状态< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >< TimeZoneIdxsi: nil =“真正的”/>< StartDateUtc >2013 - 12 - 21 - t20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 24 - t20:00:00< / EndDateUtc >< ConfirmationNumber >0987654321< / ConfirmationNumber >< CancellationNumber >1029384756< / CancellationNumber >< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc >< DateCancelledUtc >2012 - 07 - 25 - t14:21:35< / DateCancelledUtc >< DateModifiedUtc >2012 - 07 - 22 - t11:55:42< / DateModifiedUtc >< UpgradedDateTimexsi: nil =“真正的”/>< IsUpgradeAllowedxsi: nil =“真正的”/>< FrequentTravelerId / >< StartCityCode >海< / StartCityCode >< EndCityCode >海< / EndCityCode >< StartLocation >海< / StartLocation >< EndLocation >海< / EndLocation ><课程>E类> < /身体< >C身体< / >< >传播米> < /传播<空调装置>R< /空调装置>< PhoneNumber / >< NumPersonsxsi: nil =“真正的”/>< NumCars >1< / NumCars >< DiscountCode >346660< / DiscountCode >< >指控固定> <<描述>减费> < /描述<货币>美元货币> < /< >数量0.0000< / >数量< StartDateLocalxsi: nil =“真正的”/>< IsPaidxsi: nil =“真正的”/>< SemanticsCode >DROPOFFFEE< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >固定> < /< RateWithAllowance ><货币>美元货币> < /< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00< / StartDateLocal >< IsPaidxsi: nil =“真正的”/>< SemanticsCode >天< / SemanticsCode >< SemanticsVendorType >C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >1.0000< / NumUnits >< AllowanceUnit / >< AllowanceNumUnits >250.0000< / AllowanceNumUnits >< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假< / AllowanceIsUnlimited >< / RateWithAllowance >< / >指控<讲话/ >< PerDiemLocation / >汽车> < /

预订对象元素

booking元素包含许多子元素。为了便于使用，这些元素被分为核心元素(Core elements)和附加元素(Additional elements)，核心元素是最经常使用的，附加元素不经常使用，但由Itinerary web服务支持。有些元素只有在旅行供应商创建预订时才会出现。如果新预订必须提供元素，则将其标记为必需。

注意:TripLink -开放预订供应商看到了这些领域的一个目标子集。参考文档在这里为TripLink -开放预订供应商预订对象元素。

机票预订的元素

核心要素-必需

元素 描述
ClassOfService 预订的级别。
ConfirmationNumber 航空公司航班的记录定位器或确认号码。
EndCityCode 的国际航空运输协会机场代码预订的最终城市。
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
FlightNumber 预订的航班号。
StartCityCode 的国际航空运输协会机场代码查看预约的起始地址。
StartDateLocal 预订的开始时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
供应商 两个字母的GDS供应商代码。在不可用时使用$$。

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
CancellationPolicy 来自供应商的取消策略。
指控 这是预订的费用。请参阅charge子元素表。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
围板 预订的到达门。
EndTerminal 预订的到达终点站。
LegId 预订的腿ID。在连接中，Leg id不会改变。对于旅行中的每个唯一航段ID，第一个航段之后的所有具有相同航段ID的航班都是连接航班。
座位 预订的座位。父元素包含AirSeat元素为每个包含的座位。的AirSeat元素包含以下子元素:PassengerRph-指定座位的乘客。SeatNumber-座位号。
StartDateUtc 预订开始时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
StartGate 在登机门订票。
StartTerminal 在出发终点站订票。
状态 基于GDS的航段预订状态，如HK, HL, BK等。
时区 预订的时区。格式:支持的Olson或Windows时区之一。

附加元素-可选

元素 描述
AircraftCode 飞机型号的代码。
袋 预订包的数量。
小屋 预定飞机的部分。
CarbonEmissionLbs 此预订的碳排放磅数。
CarbonModel 用来计算碳排放量的模型。
CheckedBaggage 预订是否包括托运行李。
持续时间 预定的航班的持续时间。
ETicket 预订是否有电子机票。格式:Y / N
IsOpenSegment 段是否打开。格式:真/假
IsPreferredVendor 如果航空公司被公司列为优先资产。格式:真/假
IsUpgradeAllowed 预订是否可以升级。格式:真/假
餐 餐费包括在预订中。
英里 预订时包括的里程数。
笔记 关于预订的其他详细信息。
OpenSegment 关于开放段的附加信息。
OperatedByFlightNumber 由代表所订航空公司经营该航班的航空公司提供的航班号。
OperatedByVendor 代表预订的航空公司运营航班的航空公司。
OperatedByVendorName 代表所订航空公司经营该航班的航空公司名称。
服务 预订中包括的服务。
SpecialInstructions 关于预订的其他说明。最大长度:256
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss

汽车预订元素

核心要素-必需

元素 描述
ConfirmationNumber 来自供应商的确认号码。
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
StartDateLocal 预订的开始时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
供应商 两个字母的GDS供应商代码。

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
CancellationPolicy 来自供应商的取消策略。
指控 这是预订的费用。请参阅charge子元素表。
货币 的3个字母的ISO 4217货币代码预订。
DailyRate 预订的每日费用。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
EndCityCode 的国际航空运输协会机场代码查看预定的结束地址。
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
EndLatitude 预定结束地点的纬度。
EndLongitude 预定结束地点的经度。
笔记 关于预订的其他信息。
PhoneNumber 用户的电话号码。
RateCode 预订的费率代码。
StartCityCode 的国际航空运输协会机场代码查看预约的起始地址。
StartDateUtc 预订开始时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
StartLatitude 预订开始地点的纬度。
StartLongitude 预订开始位置的经度。
状态 预订状态。
时区 预订的时区。格式:支持的Olson或Windows时区之一。
TotalRate 预订的总金额。
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。

附加元素-可选

元素 描述
空调装置 指示汽车是否有空调的字符代码。R代表交流，N代表无交流
身体 表示汽车能容纳多少乘客的字符代码。
类 表示车辆等级的字符代码，例如是否为经济型、全尺寸、紧凑型等。不同的供应商
DiscountCode 公司/TMC用于获得折扣率的折扣代码。
DropoffCollectionAddress1 当租赁服务提供接送时，AddressLine1为接送地址。
DropoffCollectionAddressType
DropoffCollectionCategory
DropoffCollectionCity 当租车服务提供接送服务时，请填写接送地址。
DropoffCollectionCityCode 的国际航空运输协会机场代码当租车服务提供接送服务时，请填写接送地址。
DropoffCollectionCountry 租车公司提供接送服务时，寄件人地址为国家。
DropoffCollectionLatitude 租车服务提供接送时，接送地址的纬度。
DropoffCollectionLongitude 租车服务提供接送时，接送地址的经度。
DropoffCollectionNumber
DropoffCollectionPhoneNumber 租车服务提供接送服务时，接送地址的电话号码。
DropoffCollectionPostalCode 租车服务提供送车服务时，送车地址的邮政编码。
DropoffCollectionState 租车服务提供接送时，接送地址的状态。
EndAddress 预定的结束地址。
EndAddress2 预定的结束地址。
EndCity 预定的结束地址。
EndCloseTime 投送地点的关闭时间。
EndCountry 预定的结束地址。
EndLocation 跳伞的位置。
EndOpenTime 投送地点的开放时间。
EndPhoneNumber 投送地点的电话号码。
EndPostalCode 预定的结束地址。
EndState 预定的结束地址。
FrequentTravelerId 用户的忠诚度计划ID。
IsUpgradeAllowed 预订是否可以升级。格式:真/假
NumCars 出租汽车的数量。
NumPersons 租车的人数，包括司机。
PickupDeliveryAddress1 AddressLine1为租车服务提供取车服务时的取车地址。
PickupDeliveryAddressType
PickupDeliveryCategory
PickupDeliveryCity 当租车服务提供取车服务时，取车地址为城市。
PickupDeliveryCityCode 的国际航空运输协会机场代码当租车服务提供取车服务时，取车地址。
PickupDeliveryCountry 当租车服务提供取车服务时，取车地址为国家。
PickupDeliveryLatitude 租车服务提供取车服务时取车地址的纬度。
PickupDeliveryLongitude 租车服务提供取车服务时取车地址的经度。
PickupDeliveryNumber
PickupDeliveryPhoneNumber 租车服务提供取车服务时取车地址的电话号码。
PickupDeliveryPostalCode 租车服务提供取车服务时取车地址的邮政编码。
PickupDeliveryState 租车服务提供取车服务时，取车地址的状态。
RateType 预订的费率类型。
SpecialEquipment 承租人要求的任何特殊设备。
SpecialInstructions 关于预订的其他说明。最大长度:256
StartAddress 预约的起始地址。
StartAddress2 预订的起始地址。
StartCity 预订的起始地址。
StartCloseTime 取货地点的关门时间。
StartCountry 预订的起始地址。
StartLocation 预订的起始位置。
StartOpenTime 取货地点的开放时间。
StartPostalCode 预订的起始地址。
StartState 预订的起始地址。
传输 表示汽车是否有自动变速器的字符代码。A代表自动，M代表手动
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss

酒店预订的元素

核心要素-必需

元素 描述
ConfirmationNumber 来自供应商的确认号码。
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
的名字 预订的酒店名称。
StartCityCode 的国际航空运输协会机场代码查看预约的起始地址。
StartDateLocal 预订的开始时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
状态 预订状态。
供应商 两个字母的GDS供应商代码。

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
CancellationPolicy 来自供应商的取消策略。
指控 这是预订的费用。请参阅charge子元素表。
CheckinTime 酒店预订要及时办理入住手续。
CheckoutTime 酒店预订的退房时间。
货币 的3个字母的ISO 4217货币代码预订。
DailyRate 酒店的平均每日价格。如果费率在持续时间内发生变化，则可以使用收费模型指定。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
HotelPropertyId 酒店的物业编号。
笔记 关于预订的其他信息。
NumPersons 预订的人数。
NumRooms 预订的房间数量。
PhoneNumber 预订的电话号码。
RateCode 预订的费率代码。
RoomDescription 预订的房间描述。最大长度:200
将可能 要预订的房间类型。
SpecialInstructions 关于预订的其他说明。最大长度:256
StartAddress 预约的起始地址。
StartAddress2 预订的起始地址。
StartCity 预订的起始地址。
StartCountry 预订的起始地址。
StartLatitude 预订开始地点的纬度。
StartLongitude 预订开始位置的经度。
StartPostalCode 预订的起始地址。
StartState 预订的起始地址。
StartDateUtc 预订开始时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
时区 预订的时区。格式:支持的Olson或Windows时区之一。
TotalRate 预订的总金额。

附加元素-可选

元素 描述
EndCityCode 的国际航空运输协会机场代码查看预定的结束地址。
DiscountCode 预订的折扣码。
FrequentTravelerId 常旅客奖励计划的旅客ID。
HadDeposit 预订是否有押金。格式:真/假
IsUpgradeAllowed 预订是否可以升级。格式:真/假
ModificationCode 更改预订的代码。
PartnerMembershipId 与预订相关联的合作伙伴的会员ID。
PassiveType 预订的类型。
RateAccess 预订的费率访问。
RateType 预订的费率类型。
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss
VendorFlags 以分号分隔的免费酒店服务旗帜列表。例如:免费早餐(FB)、互联网(FI)、停车(FP)等。如果它们都出现了它们可以被串联为- FB, FI, FP;
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。

餐饮预订元素

核心要素-必需

元素 描述
ConfirmationNumber 来自供应商的确认号码。

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
指控 这是预订的费用。请参阅charge子元素表。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
FrequentTravelerId 用户的忠诚度计划ID。
IsUpgradeAllowed 预订是否可以升级。格式:真/假
的名字 餐厅的名字。最大长度:80
笔记 关于预订的其他信息。
NumPersons 预定的人数。
PhoneNumber 餐厅的电话号码。
RestaurantId 预订供应商的餐厅ID。最大长度:50
StartAddress 餐厅地址。最大长度:80
StartAddress2 餐厅地址。最大长度:80
StartCity 餐厅地址。最大长度:50
StartCountry 餐厅地址。
StartDateLocal 预订的开始时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
StartDateUtc 预订开始时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
StartLatitude 餐厅的纬度。
StartLongitude 餐厅的经度。
StartPostalCode 餐厅地址。最大长度:24
StartState 餐厅地址。最大长度:50
状态 段的状态。
时区 预订的时区。格式:支持的Olson或Windows时区之一。
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss
供应商 两个字母的GDS供应商代码。
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。

旅行预订元素

核心要素-必需

元素 描述
ConfirmationNumber 来自供应商的确认号码。
EndCityCode 结束国际航空运输协会机场代码的预订。
StartCityCode 开始国际航空运输协会机场代码的预订。
供应商 两个字母的GDS供应商代码。以下供应商代码之一:
供应商代码
代码 描述
$ R RideCharge
艾尔 AddisonLee
DG DeemGroundLimo
GC GroundScope
GS GroundSpan
信用证 Limoscom
平方 SummitQwest
西南 SummitQwest
道明 串联
电视 Transvip
$ $ 未知的

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
CancellationPolicy 来自供应商的取消策略。
货币 的3个字母的ISO 4217货币代码预订。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DropoffInstructions 关于预订的说明。
持续时间 预订的持续时间。
EndAddress 预订的结束地址。
EndAddress2 预订的结束地址。
EndCity 预订的结束地址。
EndCountry 预订的结束地址。
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
EndLatitude 预定结束地点的纬度。
EndLocation 预订的结束位置。
EndLocationCode 预订的结束位置码。
EndLocationName 预订的结束位置名称。
EndLongitude 预定结束点的经度。
EndPostalCode 预订的结束地址。
EndState 预订的结束地址。
IsPersonal 这段行程是否适合个人旅行。格式:真/假。
IsUpgradeAllowed 预订是否可以升级。格式:真/假
MeetingInstructions 关于预约会议地点的说明。
英里 预定的里程数。
的名字 预订单上的名字。
笔记 关于预订的其他信息。
NumberOfHours 预订的小时数。
NumPersons 预订包括的人数。
OperatedByVendor 由供应商负责预订。
PassiveCityCode 预订的被动城市代码。
PhoneNumber 车辆供应商的电话号码。
PickupInstructions 关于预订的说明。
率 这是预订的价格。
RateDescription 预订的价格说明。
RateNotes 这是预订的价目表。
RateType 预订的费率类型。
ReservationId 预订供应商的预订ID。
SpecialInstructions 这是骑行的特别说明。最大长度:256
StartAddress 预约的起始地址。
StartAddress2 预约的起始地址。
StartCity 预约的起始地址。
StartCountry 预约的起始地址。
StartDateLocal 预订的开始时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
StartDateUtc 预订开始时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
StartLatitude 预订开始地点的纬度。
StartLocation 预订的起始位置。
StartLocationCode 预订开始地点的代码。
StartLocationName 预订开始地点的名称。
StartLongitude 预订开始位置的经度。
StartPostalCode 预约的起始地址。
StartState 预约的起始地址。
状态 段的状态。
时区 预订的时区。格式:支持的Olson或Windows时区之一。
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。
指控 这是预订的费用。请参阅charge子元素表。

铁路订票元素

核心要素-必需

元素 描述
ConfirmationNumber 来自供应商的确认号码。
StartDateLocal 这段旅程的开始日期，以当地时间为起点。格式:YYYY-MM-DDThh: mm: ss

核心元素-可选

元素 描述
设施 订了设施。
小屋 机舱标识符。
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
CarbonEmissionLbs 此预订的碳排放磅数。
CarbonModel 用来计算碳排放量的模型。
ClassOfService 预订的级别。
货币 的3个字母的ISO 4217货币代码预订。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DiscountCode 预订的折扣码。
持续时间 预定的旅行时间。
EndCity 火车旅行的终点城市。
EndCityCode 的国际航空运输协会机场代码旅行的终点城市。
EndCountry 预订的国家代码。
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
EndLatitude 预定结束点的纬度。
EndLongitude 预定结束点的经度。
EndPlatform 预订的结束平台位置。
EndRailStation 预订终点站的代码。
EndRailStationName 预订终点站的名称。
ETicket 电子机票号码。
FareType 铁路订票上的票价类型。
FrequentTravelerId 常旅客奖励计划的旅客ID。
IsUpgradeAllowed 预订是否可以升级。格式:真/假
LegId 旅行腿ID。
餐 订了餐。
英里 预定的里程数。
笔记 关于预订的其他信息。
NumPersons 预定去旅行的人数。
NumStops 预订中的站数。
OperatedByTrainNumber 已预订行程的营运供应商的列车编号。
OperatedByVendor 所订行程的营运供应商。
RateCode 预订费率的供应商代码。
RouteRestrictCode 限制预订路线的代码。
SpecialInstructions 预订的说明。最大长度:256
StartCity 预订的起始城市。
StartCityCode 的国际航空运输协会机场代码预订的起始城市。
StartCountry 预订的起始国家。
StartDateUtc 这段旅程的开始日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
StartLatitude 预订开始地点的纬度。
StartLongitude 预订开始地点的经度。
StartPlatform 预订的起跑站台位置。
StartRailStation 订舱起始站的编号。
StartRailStationName 预订的起站名称。
状态 预订状态。
时区 预订的时区。格式:支持的Olson或Windows时区之一。
TotalRate 预订的总金额。
TrainNumber 预订的列车号码。
TrainTypeCode 预订时使用的列车类型的代码。
TrainTypeName 预订时使用的列车类型的名称。
运输方式 预订的运输方式。
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss
供应商 两个字母的GDS供应商代码。
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。
WagonNumber 火车车厢的车号。
指控 这是预订的费用。请参阅charge子元素表。
座位 订了座位。父元素包含一个RailSeat元素为每个包含的座位。的RailSeat元素有以下子元素:
RailSeat子元素
元素 描述
设施 座位上的便利设施。
BerthPosition 座位的泊位位置。
甲板 座位在哪一层?
FacingForward 座位是否朝前。
FareSpaceComfort 座位周围的空间。
PassengerRph 这个座位分配给哪位乘客?
SeatNumber 座位号。
SeatPosition 座位的位置。
SpaceType 座位周围的空间类型。
状态 座位预订的状态。
WagonNumber 座位所在的马车号码。
WagonType 座位所在的马车类型。

停车预订元素

核心要素-必需

元素 描述
ConfirmationNumber 来自供应商的确认号码。
StartDateLocal 这段旅程的开始日期，以当地时间为起点。格式:YYYY-MM-DDThh: mm: ss

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
ClassOfService 预订的级别。
货币 的3个字母的ISO 4217货币代码预订。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
FrequentTravelerId 常旅客奖励计划的旅客ID。
IsUpgradeAllowed 预订是否可以升级。格式:真/假
笔记 关于预订的其他信息。
OperatedByVendor 预订的经营供应商。
ParkingLocationId 停车预订的位置。
PhoneNumber 停车电话号码。
销 预订的密码。
RateCode 预订费率的供应商代码。
StartAddress 预约的起始地址。
StartAddress2 预约的起始地址。
StartCity 预约的起始地址。
StartCityCode 的国际航空运输协会机场代码预订的起始城市。
StartCountry 预约的起始地址。
StartDateUtc 这段旅程的开始日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
StartLocation 停车位置。
StartPostalCode 预约的起始地址。最大长度:24
StartState 预约的起始地址。最大长度:50
状态 预订状态。
时区 预订的时区。格式:支持的Olson或Windows时区之一。
TotalRate 预订的总金额。
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss
供应商 两个字母的GDS供应商代码。
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。
指控 这是预订的费用。请参阅charge子元素表。

旅游预订

请注意: Concur Travel Request产品使用此预订类型存储旅行的主要目的地，而不指定运输类型。

核心要素-必需

元素 描述
EndDateLocal 预订结束的时间和日期，以预订地点的当地时间为准。格式:YYYY-MM-DDThh: mm: ss
StartCity 预约的起始地址。
StartCityCode 的国际航空运输协会机场代码预订的起始城市。
StartDateLocal 这段旅程的开始日期，以当地时间为起点。格式:YYYY-MM-DDThh: mm: ss

核心元素-可选

元素 描述
CancellationNumber 来自供应商的取消号码。当您取消一个段时，应该设置此字段。
ConfirmationNumber 来自供应商的确认号码。
货币 的3个字母的ISO 4217货币代码预订。
DailyRate 预订的平均每日价格。如果费率在持续时间内发生变化，则可以使用收费模型指定。
DateCancelledUtc 预订被取消的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
DateCreatedUtc 创建预订的日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
DateModifiedUtc 更改预订的日期，UTC。格式:YYYY-MM-DDThh: mm: ss
EndAddress 预订的结束地址。
EndAddress2 预订的结束地址。
EndCity 预订的结束地址。
EndCityCode 的国际航空运输协会机场代码预订的结束城市。
EndCountry 预订的结束地址。
EndDateUtc 预订结束时间和日期(UTC)。格式:YYYY-MM-DDThh: mm: ss
EndLatitude 预定结束地点的纬度。
EndLocation 预订的结束位置。
EndLongitude 预定结束点的经度。
EndPostalCode 预订的结束地址。
EndState 预订的结束地址。
运输方式 预订的运输方式。
笔记 关于预订的其他信息。
NumPersons 预定去旅行的人数。
PhoneNumber 停车电话号码。
SpecialInstructions 预订的说明。最大长度:256
StartAddress 预约的起始地址。
StartAddress2 预约的起始地址。
StartCity 预约的起始地址。
StartCityCode 的国际航空运输协会机场代码预订的起始城市。
StartCountry 预约的起始地址。
StartDateUtc 这段旅程的开始日期，以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
StartLatitude 预订开始地点的纬度。
StartLongitude 预订开始地点的经度。
StartPostalCode 预约的起始地址。最大长度:24
StartState 预约的起始地址。最大长度:50
状态 预订状态。
时区 预订的时区。格式:支持的Olson或Windows时区之一。
TotalRate 预订的总金额。
供应商 两个字母的GDS供应商代码。
VendorName 供应商的名称。当使用未知供应商代码($$)时，此值在行程中显示为供应商。
指控 这是预订的费用。请参阅charge子元素表。
座位 预订的座位。父元素包含TravelSeat元素为每个包含的座位。的TravelSeat元素包含以下子元素:
TravelSeat元素
元素 描述
PassengerRph 被分配到座位上的乘客
SeatNumber 座位号。

指控子元素

核心要素-必需
百分比-固定费用的百分比

这个父元素包含以下子元素:

元素 描述
量 预订费用的总金额。
货币 的3个字母的ISO 4217货币代码为总金额。
描述 速率的描述。
IsPaid 费率是否已支付。格式:真/假。
IsPrimary 指示计费是主速率还是主速率。例如，如果其中一个速率是实际速率，而其他速率是惩罚值，则实际速率应该设置为IsPrimary。一组中只有一个电荷应该是初级的。格式:真/假。
SemanticsCode 指示行项目的收费类别。
SemanticsVendorType 供应商类型:H=酒店，C=汽车，A=航空，G=地面，R=铁路
StartDateLocal 预订的开始日期，用用户的当地时间表示。格式:YYYY-MM-DDThh: mm: ss
供应商 向卖主索取预订费。
VendorChargeCode 供应商的收费代码
固定-固定费用

这个父元素包含以下子元素:

元素 描述
货币 的3个字母的ISO 4217货币代码为总金额。
描述 固定金额的描述。
IsPaid 固定金额是否已支付。格式:真/假。
IsPrimary 固定金额是否是初级的。格式:真/假。
SemanticsCode 指示行项目的收费类别。指的是语义和供应商代码文档获取更多信息。
SemanticsVendorType 供应商类型:H=酒店，C=汽车，A=航空，G=地面，R=铁路
StartDateLocal 预订的开始日期，用用户的当地时间表示。格式:YYYY-MM-DDThh: mm: ss
供应商 申请预订费用的供应商。
VendorChargeCode 供应商的收费代码。
费率-预订的费率

这个父元素包含以下子元素:

元素 描述
量 预订费用的总金额。
货币 的3个字母的ISO 4217货币代码为总金额。
描述 速率的描述。
IsPaid 费率是否已支付。格式:真/假。
IsPrimary 是否为一级速率。格式:真/假。
NumUnits 预期收费的单元数。例如，3天
PerUnit 费用的计量单位。值表示日、周或月等速率
SemanticsCode 指示行项目的收费类别。指的是语义和供应商代码文档获取更多信息。
SemanticsVendorType 供应商类型:H=酒店，C=汽车，A=航空，G=地面，R=铁路
StartDateLocal 预订的开始日期，用用户的当地时间表示。格式:YYYY-MM-DDThh: mm: ss
供应商 向卖主索取预订费。
VendorChargeCode 供应商的收费代码。
RateWithAllowance -预订的价格，包括任何旅行津贴

这个父元素包含以下子元素:

元素 描述
AllowanceAmount 超出免税额时的超额费用。例如，如果津贴是5000英里，成本可能是每英里0.02美元。透支金额必须与基本利率相同。
AllowanceIsUnlimited 津贴是否无限制。格式:真/假。
AllowanceNumUnits 与费用相关联的津贴的单位数目。例如，5000英里。
AllowanceUnit 与费用相关的津贴的计量单位。例如，一个汽车周费率可能允许5000英里包括在费率中。
量 预订费用的总金额。
货币 的3个字母的ISO 4217货币代码为总金额。
描述 速率的描述。
IsPaid 费率是否已支付。格式:真/假。
IsPrimary 指示计费是主速率还是主速率。例如，如果其中一个速率是实际速率，而其他速率是惩罚值，则实际速率应该设置为IsPrimary。一组中只有一个电荷应该是初级的。格式:真/假。
NumUnits 预期收费的单元数。例如，3天。
PerUnit 费用的计量单位。值表示日、周或月等速率
SemanticsCode 指示行项目的收费类别。指的是语义和供应商代码文档获取更多信息。
SemanticsVendorType 供应商类型:H=酒店，C=汽车，A=航空，G=地面，R=铁路
StartDateLocal 预订的开始日期，用用户的当地时间表示。格式:YYYY-MM-DDThh: mm: ss
供应商 向卖主索取预订费。
VendorChargeCode 供应商的收费代码。

时区格式

奥尔森时区
非洲/开罗 非洲/卡萨布兰卡 非洲/哈拉雷 非洲/罗安达
内罗毕非洲/ 非洲/温得和克 美国/安克雷奇 美国/阿根廷/ Buenos_Aires
美国/亚松森 美国/巴伊亚 美国/波哥大 美国/ Buenos_Aires
美国/加拉加斯 美国/芝加哥 美国/吉娃娃 美国丹佛/
美国/ Godthab 美国/圭亚那 美国/哈利法克斯 美国/印第安纳波利斯
美国/ Los_Angeles 美国/玛瑙斯 美国/ Mexico_City 美国/蒙得维的亚
美国/ New_York 美国凤凰城/ 美国/女王 美国/圣地亚哥
美国/ Sao_Paulo 美国/ St_Johns 美国/ Swift_Current 美国/提华纳
亚洲/阿拉木图 亚洲/安曼 亚洲/巴格达 亚洲/巴库
亚洲/曼谷 亚洲/贝鲁特 亚洲/加尔各答 亚洲/科伦坡
亚洲/大马士革 亚洲/达卡 亚洲/伊尔库茨克 亚洲/耶路撒冷
亚洲/喀布尔 亚洲/堪察加半岛 亚洲/卡拉奇 亚洲/卡拉奇
亚洲/加德满都 亚洲/克拉斯诺雅茨克 亚洲/马加丹州 亚洲/马斯喀特
亚洲/新西伯利亚 亚洲/仰光 亚洲/利雅得 亚洲/首尔
亚洲/上海 亚洲/新加坡 亚洲/台北 亚洲/第比利斯
亚洲/德黑兰 亚洲/东京 亚洲/乌兰巴托 亚洲/海参崴
亚洲/雅库茨克 亚洲/叶卡特琳堡 亚洲/埃里温 大西洋/亚速尔群岛
大西洋/ Cape_Verde 大西洋/ South_Georgia 澳大利亚阿德莱德/ 澳大利亚/布里斯班
澳大利亚/达尔文 澳大利亚/霍巴特 澳大利亚珀斯/ 澳大利亚/悉尼
等/ GMT + 12 等/ GMT-11 等/ GMT-2 欧洲/雅典
欧洲/柏林 欧洲/赫尔辛基 欧洲/伊斯坦布尔 欧洲/加里宁格勒
欧洲/伦敦 欧洲/明斯克 欧洲/俄罗斯 欧洲/巴黎
欧洲/布拉格 欧洲/萨拉热窝 格林尼治时间 1200年,格林尼治时间
印度/毛里求斯 太平洋/阿皮亚 奥克兰太平洋/ 太平洋/斐济
太平洋/瓜达康纳尔岛 太平洋关岛/ 太平洋/火奴鲁鲁 太平洋磅礴/气流
UTC

Windows时区
非洲/开罗 非洲/卡萨布兰卡 非洲/哈拉雷 非洲/罗安达
内罗毕非洲/ 非洲/温得和克 美国/安克雷奇 美国/阿根廷/ Buenos_Aires
美国/亚松森 美国/巴伊亚 美国/波哥大 美国/ Buenos_Aires
美国/加拉加斯 美国/芝加哥 美国/吉娃娃 美国丹佛/
美国/ Godthab 美国/圭亚那 美国/哈利法克斯 美国/印第安纳波利斯
美国/ Los_Angeles 美国/玛瑙斯 美国/ Mexico_City 美国/蒙得维的亚
美国/ New_York 美国凤凰城/ 美国/女王 美国/圣地亚哥
美国/ Sao_Paulo 美国/ St_Johns 美国/ Swift_Current 美国/提华纳
亚洲/阿拉木图 亚洲/安曼 亚洲/巴格达 亚洲/巴库
亚洲/曼谷 亚洲/贝鲁特 亚洲/加尔各答 亚洲/科伦坡
亚洲/大马士革 亚洲/达卡 亚洲/伊尔库茨克 亚洲/耶路撒冷
亚洲/喀布尔 亚洲/堪察加半岛 亚洲/卡拉奇 亚洲/卡拉奇
亚洲/加德满都 亚洲/克拉斯诺雅茨克 亚洲/马加丹州 亚洲/马斯喀特
亚洲/新西伯利亚 亚洲/仰光 亚洲/利雅得 亚洲/首尔
亚洲/上海 亚洲/新加坡 亚洲/台北 亚洲/第比利斯
亚洲/德黑兰 亚洲/东京 亚洲/乌兰巴托 亚洲/海参崴
亚洲/雅库茨克 亚洲/叶卡特琳堡 亚洲/埃里温 大西洋/亚速尔群岛
大西洋/ Cape_Verde 大西洋/ South_Georgia 澳大利亚阿德莱德/ 澳大利亚/布里斯班
澳大利亚/达尔文 澳大利亚/霍巴特 澳大利亚珀斯/ 澳大利亚/悉尼
等/ GMT + 12 等/ GMT-11 等/ GMT-2 欧洲/雅典
欧洲/柏林 欧洲/赫尔辛基 欧洲/伊斯坦布尔 欧洲/加里宁格勒
欧洲/伦敦 欧洲/明斯克 欧洲/俄罗斯 欧洲/巴黎
欧洲/布拉格 欧洲/萨拉热窝 格林尼治时间 1200年,格林尼治时间
印度/毛里求斯 太平洋/阿皮亚 奥克兰太平洋/ 太平洋/斐济
太平洋/瓜达康纳尔岛 太平洋关岛/ 太平洋/火奴鲁鲁 太平洋磅礴/气流
UTC