预订资源表示SAP Concur Travel系统中的预订部分。TripLink供应商使用此资源显示完整预订字段的子集。
版本1.1
/旅游/预订/ v1.1 / {query_parameters}
为了在进行行程API调用时获取行程数据,必须将OAuth范围参数的值设置为:也就是说
创建新的预订或更新现有预订。新的预订将分配给指定的行程,如果没有指定行程,则分配给跨越预订日期的第一个行程。如果没有指定任何行程,并且没有跨越预订日期的行程,则将创建一个新的行程。
这个端点可用于为非OAuth消费者的用户创建/更新预订。当旅游供应商或旅游管理公司需要代表用户创建/更新预订时,通常会这样做。供应商或TMC必须向SAP Concur注册,并且必须具有以下用户角色之一的帐户:Professional的Web Services Administrator或Standard的Can administrtor。
帖子/ api /旅游/预订/ v1.0吗?tripId = 12345678HTTPS/1.1宿主:www.concursolutions.com.授权: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}
应用程序/ XML
有效的SAP Concur用户的带有OAuth令牌的授权头。为了为OAuth消费者以外的任何人创建或更新预订,OAuth消费者必须在SAP Concur中具有以下用户角色之一:公司管理员或专业Web服务管理员,或标准管理员。
该请求包含一个Booking父元素和以下子元素:
必需的元素 | 描述 |
---|---|
BookingSource |
供应商的名字。 |
录制器 |
记录这个预定的定位器。这通常是六个字母数字字符,但根据预订来源可以有其他格式 |
可选元素 | 描述 |
---|---|
datebookedlocal. |
预订的日期是在预订位置的当地时间创建的日期。格式:YYYY-MM-DDTHH:MM:SS |
FormOfPaymentName |
预订的付款方式的名称。 |
formofpaymenttype. |
付款方式。 |
TicketMailingAddress. |
如果可用的预订票证的邮寄地址。 |
TicketPickupLocation |
预订票的拾取位置(如果有)。 |
TicketPickupNumber |
如果有的话,确认号码拿起预订的票证。 |
AirfareQuotes |
此预订的存储机票报价清单。 |
AirlineTickets |
这笔预订的机票列表。 |
收费 |
订舱费用清单。 |
MiscChargeOrders |
杂项列表航空收费 这个预订。 |
乘客 |
的乘客 元素包含A.乘客 每个被预订的乘客的儿童元素。可以在后续表中看到每个子元素的描述。 |
译文 |
此预订的传递程序列表。 |
phonenumber |
与此预订有关的电话号码列表。 |
RailPayments |
本次预订中与铁路段相关的铁路付款清单。 |
段 |
在此预订的段的清单。这个父元素包含一个或多个空气 ,汽车 ,酒店 ,餐厅 ,骑 ,铁路 ,停车 ,或事件 预订的父元素。参考预订对象元素有关booking元素中包含的子元素的详细信息。 |
交付 |
该预订的方法已交付。 |
WaitListSegments |
旅客在此预订中等待的部分。 |
警告 |
与预订相关的警告。 |
WebAddresses |
与此预订相关的网站地址列表,如电子邮件、pickup url等 |
必需的元素 | 描述 |
---|---|
NameFirst |
乘客的名字。 |
NameLast |
乘客的姓。 |
可选元素 | 描述 |
---|---|
namemiddle. |
乘客的中间名。 |
NamePrefix |
旅客姓名的前缀。 |
NameRemark |
有关乘客姓名的其他详细信息。 |
名称uffix. |
旅客的姓名后缀。 |
NameTitle |
旅客的姓名。 |
TextName |
如果与数据库中的名称不同,则在预订工具中输入的用户的全名。 |
FrequentTravelerProgram |
旅客的忠诚度计划 |
此函数返回全程详细信息,如在响应中记录获取行程细节函数。
如果最终用户更新了一个现有的预订,结果是一个新的确认号码,那么除了将新的预订发送到SAP Concur之外,旧的预订必须被明确地取消。如果之前的预订没有取消,用户将在他们的SAP Concur旅行列表中看到这两个预订。
帖子/ api /旅游/预订/ v1.0吗?tripId = 12345678HTTPS/1.1宿主:www.concursolutions.com.授权:OAuth{访问令牌}...
<预订xmlns: xsi =“http://www.w3.org/2001/XMLSchema-instance”xmlns: xsd =“http://www.w3.org/2001/xmlschema”><段><汽车><供应商>艾尔供应商> 阿拉莫 Vendorname>< >状态香港 status>< StartDateLocal >2013 - 12 - 21 - t12:00:00 startdatelocal>< EndDateLocal >2013 - 12 - 23 - t12:00:00< / EndDateLocal >< StartDateUtc >2013-12-21T20: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 >< EndLocation >海< / EndLocation > E类> < /身体< >C身体< / >< >传播一个> < /传播<空调装置>R< /空调装置>< NumPersons >1< / NumPersons >< NumCars >1< / NumCars >< DiscountCode >4321折扣码>< DailyRate >35.0000< / DailyRate >< TotalRate >105.0000< / TotalRate >< RateType >D RateType><货币>美元货币> < /汽车> < / segments>< 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 >< >的乘客乘客> << PassengerKey >0乘客>< NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< /预订>
<行程xmlns =“https://www.concursolutions.com/api/travel/trip/2010/06”><标识>https://www.concursolutions.com/api/travel/trip/v1.1/CNQR1234567890< / id >< ItinLocator >CNQR1234567890< / ItinLocator > KK-CNQ-1M1P6-5HJ< / ClientLocator > TravelSupplier ITISOURCENAME>< TripName >西雅图之旅< / TripName ><评论/>< StartDateLocal >2013-12-21T07:25:00 startdatelocal>< EndDateLocal >2013-12-23T23:59:00< / EndDateLocal >< DateModifiedUtc >2012 - 07 - 24 - t19:15:52 datemodifiedutc> EveryGDS< / BookedVia > 克里斯< / BookedByFirstName >< BookedByLastName >米勒< / BookedByLastName >< DateBookedLocal >2012 - 07 - 24 - t19:15:52< / DateBookedLocal ><预订><段><汽车><供应商>艾尔供应商> 阿拉莫 Vendorname>< >状态香港 status>< StartDateLocal >2013 - 12 - 21 - t12:00:00 startdatelocal>< EndDateLocal >2013 - 12 - 23 - t12:00:00< / EndDateLocal >< StartDateUtc >2013-12-21T20: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 >< EndLocation >海< / EndLocation > E类> < /身体< >C身体< / >< >传播一个> < /传播<空调装置>R< /空调装置>< NumPersons >1< / NumPersons >< NumCars >1< / NumCars >< DiscountCode >4321折扣码>< DailyRate >35.0000< / DailyRate >< TotalRate >105.0000< / TotalRate >< RateType >D RateType><货币>美元货币> < /汽车> < / segments>< 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 > TravelSupplier ITISOURCENAME>< >的乘客乘客> << PassengerKey >0乘客>< NameFirst >克里斯< / NameFirst >< NameLast >米勒< / NameLast >乘客> < /< / >的乘客< /预订>< /行程>
取消现有的预订。默认情况下,OAuth消费者应该是预订的所有者。这个端点还可以用来取消OAuth消费者不拥有的预订。当旅行管理公司需要代表用户取消预订时,通常会这样做。TMC必须向SAP Concur注册,并拥有一个SAP Concur帐户,该帐户具有以下用户角色之一:Professional的Web Services Administrator或Standard的Can administrtor。
注意:
示例:
https:// {baseUri} / api /旅游/预订/ v1.1 /取消? bookingSource ={供应商}&confirmationNumber = {confnum}
帖子/ api /旅游/预订/ v1.1 /取消吗?bookingSource = {FastTravel} &confirmationNumber = {098765431}HTTPS/1.1宿主:www.concursolutions.com.授权:OAuth{访问令牌}
取消关键字和供应商的唯一标识符,由SAP Concur在应用程序审查期间配置。预订源必须与与预订相关联的供应商名称相匹配。
取消预订的确认号码。
示例:https://www.concursolutions.com/api/travel/booking/v1.1/cancel?bookingSource={供应商}&confirmationNumber = {confnum}
拥有预订的用户的SAP Concur登录ID。仅当预订所有者不是OAuth消费者时提供。只能在OAuth使用者具有所需的用户角色时使用。
示例:https://www.concursolutions.com/api/travel/booking/v1.1/cancel ?bookingsource= {supplier} &confirmationnumber= {confnum} &Uture_type =login_id&Userid_value= {loginid}
应用程序/ XML
授权标题必须具有OAUTH令牌的有效SAP Confur用户。OAuth消费者必须使用SAP Confur注册为供应商或TMC,并且必须在SAP Concur中的以下用户角色之一:公司管理员或Web服务管理员专业,或者可以为标准管理。
该函数返回预订对象元素部分中指定的完整预订细节。
如果没有找到预订,函数返回一个HTTP 404错误和以下元素:
状态:此元素包含值:notfound。
帖子/ api /旅游/预订/ v1.1 /取消吗?bookingSource = {FastTravel} &confirmationNumber = {098765431}HTTPS/1.1宿主:www.concursolutions.com.授权:OAuth{访问令牌}
<汽车><供应商>泽供应商>< >状态香港 status>< StartDateLocal >2013 - 12 - 21 - t12:00:00 startdatelocal>< EndDateLocal >2013 - 12 - 24 - t12:00:00< / EndDateLocal >xsi: nil =“真正的”/>< StartDateUtc >2013-12-21T20:00:00< / StartDateUtc >< EndDateUtc >2013 - 12 - 24 - t20:00:00< / EndDateUtc >< ConfirmationNumber >0987654321< / ConfirmationNumber > 1029384756 cancellationnumber>< DateCreatedUtc >2012 - 07 - 22 - t11:55:42< / DateCreatedUtc > 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 >< EndLocation >海< / EndLocation > E类> < /身体< >C身体< / >< >传播米> < /传播<空调装置>R< /空调装置>< PhoneNumber / >< NumPersonsxsi: nil =“真正的”/>< NumCars >1< / NumCars >< DiscountCode >346660折扣码>< >指控固定> <<描述>减费描述><货币>美元货币> < /< >数量0.0000< / >数量xsi: nil =“真正的”/>xsi: nil =“真正的”/> DROPOFFFEE< / SemanticsCode > C< / SemanticsVendorType >固定> < /< RateWithAllowance ><货币>美元货币> < /< >数量44.0000< / >数量< StartDateLocal >2013 - 12 - 21 - t12:00:00 startdatelocal>xsi: nil =“真正的”/> 天< / SemanticsCode > C< / SemanticsVendorType >< PerUnit >一天< / PerUnit >< NumUnits >1.0000< / NumUnits > < AllowanceNumUnits >250.0000 allowanceNumunits>< AllowanceAmount >0.2400< / AllowanceAmount >< AllowanceIsUnlimited >假允许isunlimited>< / RateWithAllowance > charges><讲话/ >< PerDiemLocation / >汽车> < /