行程Web服务(TMC/第三方)

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

获取行程列表

检索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查询参数将导致请求也返回状态为cancelled的行程。当此查询参数设置为真正的时,响应将包括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版本="1.0"编码="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服务管理员或标准管理员。

返回的元素将根据以下条件而变化:

  • 一些元素,如AirlineTicketsRailPayments,只会出现在适当类型的预订中。
  • 数量值,例如,只有当请求者是预订的来源时才会显示。所有其他供应商将不会收到与预订相关的金额元素。
  • 一些元素,如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 网址列表。这个父元素包括网址数据子元素对于每个相关的web地址。
BookingReferrer BookingReferrer仅在特定的源跟踪场景中使用,此时需要区分通过不同流的相同BookingSources的预订。不要在没有与技术联系人协调的情况下进行填充。支持的值是:Concur旅行、SAP Concur登录、供应商移动、供应商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 表示票证控制号码的票证号码的一部分。格式:十位数字。
TotalAmount 购票的总金额。
TotalAmountCurrency 3个字母的ISO 4217货币代码为总收费订单金额。

传递程序子元素

的名字 描述
程序金额。
的名字 程序名。
类型 程序类型。
UserFirstName 乘客的名字。
UserLastName 乘客的姓。

电话号码数据子元素

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

铁路支付子元素

的名字 描述
RailPayment 铁路预订的付款信息。
RailAdjustment 为铁路预订调整的金额。请参阅公众行程XSD获取更多信息。

交付方法子元素

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

Web地址数据子元素

的名字 描述
PassengerRPH 表示此网址所属的乘客。
WebAddress 网络地址。格式:电子邮件地址或URL。最大长度:250个字符。
格式 web地址的格式。格式: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版本="1.0"编码="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 >< /预订>< /预订>< /行程>

XML响应在TripIt格式

<?XML版本="1.0"编码="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登录id。可在创建新行程或更新现有行程时使用。只有当OAuth使用者具有上面列出的用户角色时,才能使用userid_type和userid_value参数。

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

为OAuth消费者更新一个trip:
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 concurrent用户,带有OAuth令牌的授权头。要为OAuth使用者以外的用户发布行程,OAuth使用者必须在SAP Concur中具有以下用户角色之一:公司管理员或专业Web服务管理员,或标准管理员。 没有一个

内容的身体

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

必需的元素

元素 描述
TripName 行程名称。最大长度为255个字符。
TripStatus 行程的状态。下列其中一项:
0 -确认
1 -带票
2 -取消
6 -提案
7 -预定提案

代理提案所需要素

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

CustomAttributes元素-必选

数据类型 的名字 数据支持值 评论
数字 ProposalBatchSize 1到3 批中提案的数量。最大:3
数字 ProposalSequenceIndex 1到3 提案在提案批次中的索引。
文本 AutoSelectProposal 真的,假的 如果为真,则建议将被相应选择,并替换用户先前输入的段。
如果为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 -乘客的姓名前缀。
NameRemark -关于乘客姓名的附加细节。
姓名后缀-乘客的姓名后缀。
姓名-乘客的姓名。
TextName -用户在预订工具中输入的全名,如果与数据库中的名称不同。
常客计划-乘客的忠诚计划。
PassPrograms 此预订的通过程序列表。
phonenumber 与此预订相关的电话号码列表。
RailPayments 此预订中与铁路段相关的铁路付款清单。
这个父元素至少包含以下子元素之一:空气酒店餐厅铁路停车事件
交付 此预订交付的方式。
WaitListSegments 旅行者在此预订中等待列出的航段。
警告 与预订相关的警告。
WebAddresses 与此预订相关的网址列表,如电子邮件、取件url等。
BookingReferrer BookingReferrer仅在特定的源跟踪场景中使用,此时需要区分通过不同流的相同BookingSources的预订。不要在没有与技术联系人协调的情况下进行填充。支持的值是:Concur旅行、SAP Concur登录、供应商移动、供应商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
    所需行程的标识符和取消关键字。

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

查询参数—可选

  • userid_type = login_id&userid_value = {loginID
    拥有旅行的用户的SAP Concur登录id。只有当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服务管理员或标准管理员。

帖子/ 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 与此预订相关的网址列表,如电子邮件、取件url等
BookingReferrer BookingReferrer仅在特定的源跟踪场景中使用,此时需要区分通过不同流的相同BookingSources的预订。不要在没有与技术联系人协调的情况下进行填充。支持的值是:Concur旅行、SAP Concur登录、供应商移动、供应商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 ={供应商}

取消关键字和供应商的唯一标识符,由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 - Open Booking供应商预订对象元素。

航空订票要素

核心元素-必备

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

核心元素-可选

元素 描述
CancellationNumber 供应商的取消号。当您取消一个段时,应该设置此字段。
CancellationPolicy 来自供应商的取消策略。
指控 预订的费用。请参考电荷子元素表。
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 预订的腿号。连接上的Leg id不会改变。对于旅程中的每个唯一leg ID,在第一个航段之后具有相同leg ID的所有航班都是连接航班。
座位 预定座位。父元素包含AirSeat元素用于每个包含的座位。的AirSeat元素包含以下子元素:PassengerRph-被分配到座位上的乘客。SeatNumber-座位号。
StartDateUtc 预订开始时间和日期,以UTC为单位。格式:YYYY-MM-DDThh: mm: ss
StartGate 登机门办理登机手续。
StartTerminal 在出发终点站办理预订手续。
状态 基于GDS的航段预订状态,如香港、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 来自供应商的取消策略。
指控 预订的费用。请参考电荷子元素表。
货币 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代表AC, N代表无AC
身体 表示汽车能容纳多少乘客的字符代码。
表示汽车等级的字符代码,如经济型、全尺寸型、紧凑型等。因供应商而异
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 来自供应商的取消策略。
指控 预订的费用。请参考电荷子元素表。
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 酒店的属性ID。
笔记 关于预订的其他信息。
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 常旅客奖励计划的旅客身份证。
HadDeposit 预订是否有押金。格式:真/假
IsUpgradeAllowed 预订是否可以升级。格式:真/假
ModificationCode 更改预订的代码。
PartnerMembershipId 与预订关联的合作伙伴的会员ID。
PassiveType 预订的类型。
RateAccess 预订的费率访问。
RateType 预订的费率类型。
UpgradedDateTime 预订升级的日期和时间。格式:YYYY-MM-DDThh: mm: ss
VendorFlags 以分号分隔的免费酒店服务旗帜列表。例如,免费早餐(FB),互联网(FI),停车位(FP)等。如果它们都出现了,它们可以连接为- FB;FI;FP;
VendorName 供应商的名称。当使用未知供应商代码($$)时,此值将作为行程中的供应商出现。

餐饮预订要素

核心元素-必备

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

核心元素-可选

元素 描述
CancellationNumber 供应商的取消号。当您取消一个段时,应该设置此字段。
指控 预订的费用。请参考电荷子元素表。
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 供应商的名称。当使用未知供应商代码($$)时,此值将作为行程中的供应商出现。
指控 预订的费用。请参考电荷子元素表。

铁路订票要素

核心元素-必备

元素 描述
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 常旅客奖励计划的旅客身份证。
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 火车车厢的车号。
指控 预订的费用。请参考电荷子元素表。
座位 预定的座位。父元素包含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 常旅客奖励计划的旅客身份证。
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 供应商的名称。当使用未知供应商代码($$)时,此值将作为行程中的供应商出现。
指控 预订的费用。请参考电荷子元素表。

旅游预订

请注意: 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 供应商的名称。当使用未知供应商代码($$)时,此值将作为行程中的供应商出现。
指控 预订的费用。请参考电荷子元素表。
座位 预定座位。父元素包含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 供应商的收费代码。
带津贴的价格-预订的价格,包括任何旅行津贴

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

元素 描述
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

在本页