取消预订操作将发送给供应商代表用户取消旅行预订。地面运输直接连接将相关信息发送到旅行供应商维护的URI。标准位置是:https:// {servername} / concur / groundtransportation.供应商在注册合作伙伴应用程序时配置此URI。

请求

URI

/ concur /地区Portation

内容类型标题(可选)

  • 应用程序/ xml

接受标题(可选)

  • 应用程序/ xml

授权标题(必填)

授权头必须包含Base64编码的基本身份验证凭据(登录ID和密码)。在注册应用程序连接器时建立登录和密码。

'授权:基本{Base64编码LoginID:password}'

请求体

请求包含一个CC_LimoCancelRequest父元素和子元素在下表中列出:

元素 必需的/可选 描述
ReservationID 要求 预留的唯一标识符。

示例请求

邮政/ concur /地区Portationhttps./1.1宿主example.com授权基本…内容类型应用程序/ xml内容长度{内容身体的长度}< CC_LimoCancelRequest >1234.

响应

供应商通过提供完整的预订细节和更新的状态来响应请求。

内容类型

  • 应用程序/ xml

响应模式

响应将包含一个CC_LimoCancelReply父元素,子元素如下:

元素 需要吗? 描述
错误 y 如果发生错误,则错误信息。此父元素包含以下子元素:
错误代码:错误代码。将包含以下值之一:
证书相关错误
预订不能取消
900:未知错误
erroreource:误差的来源。
误操作:附加的错误信息。
ReservationID N 预订的标识符。
地位 N 预订的状态。该值将是下列值之一:
XB:取消请求
XA:取消接受
XD:取消拒绝
ConfNum N 预订的确认号码。
CancelPolicy N 取消预订的政策。
CancelNum N 预订的取消号码。
PrimaryPassenger y 预订的旅客联系人姓名。此父元素包含以下子元素:
名字:联系人的名字。
姓:联系人的姓氏。
电话:联系人的电话号码。
Phone2:联系人的备份电话号码。
手机:联系人的手机号码。
EmailAddress:联系人的电子邮件地址。
ServiceType y 请求的服务类型。将包含以下值之一:
100:点对点
去机场的单程票
111:从机场的一种方式
去火车站的单程
从火车站去的单程
200:每小时
300:机场到机场
ClassOfService N 请求的服务类。将包含以下值之一:
100:正常
200年:高
300:最高
如果用户没有提供这个值,它将默认为100。
PickupLocation y 拾取位置。此父元素包含以下子元素:
LocationType:以下是以下之一:100 - 地址,200机场,300场 - 火车站。
机场:请参阅机场元素表。如果LocationType = 200。
TrainStation:请参阅火车站元素表。提供如果LocationType = 300。
地址:该位置的街道地址。如果LocationType = 100。
城市:地点城市。
状态:的位置状态。最好是2个字符,最多10个字符。
国家:该位置的2个字符ISO 3166-1 Alpha-2国家代码。示例:美国
邮政编码:所在地邮政编码。
ExtraNotes:关于位置的附加说明。示例:ring门铃,假日旅馆等
DropoffLocation y 降落地点。此父元素包含以下子元素:
LocationType:100 -地址,200 -机场,300 -火车站,400 -按指示。
机场:请参阅机场元素表。如果LocationType = 200。
TrainStation:请参阅火车站元素表。提供如果LocationType = 300。
地址:该位置的街道地址。如果LocationType = 100。
城市:地点城市。
状态:的位置状态。
国家:该位置的2个字符ISO 3166-1 Alpha-2国家代码。示例:美国
邮政编码:所在地邮政编码。
ExtraNotes:关于位置的附加说明。例如:公寓楼、砾石车道等。
StartDateTime y 在GMT中的时间,预订必须开始。格式: 2015 - 05 - 19 - t18:00:00
EndDateTime N 按照格林尼治标准时间,保留区将会结束。提供每小时预订。格式: 2015 - 05 - 19 - t18:00:00
PickupInstructions N 有关拾取请求的其他说明。
DropoffInstructions N 关于投递请求的附加说明。
landagecode. y 旅行者的语言。将是以下选项之一:
恩:英语
en-US:英语(美国)
en:英语(英国)
fr:法国
fr - ca:法语(加拿大)
德:德国
pt:葡萄牙语
es:西班牙语
问:荷兰
:意大利
是:日本
pl:波兰
pt-br:葡萄牙语(巴西)
ru:俄语
胡:匈牙利
柯:韩国
SV:瑞典语
Zh-CN:中文
zh-tw:中国传统
货币 y 3个字母的ISO 4217货币代码预订金额。
NumPassengers N 乘客的数量。
RequestedDriver N 请求的驱动程序的名称(如果可用)。
SpecialServiceRequest. N 特殊服务请求的详细信息,如果可用。
Pickupservicearrandement. N 如果可以的话,接车安排的细节。
DropoffServiceArrangement N 如果可以,请提供接送安排的细节。
ExtraStopArrangement N 额外停止安排的细节(如果有)。
Ratiinfo. y 预订的汇率详细信息。有关更多信息,请参阅速率信息元素表。
车辆 y 车辆的详细信息。此父元素包含以下子元素:
车辆类型:下列值之一:
100:轿车
200:豪华轿车
250:拉伸豪华轿车
300:越野车
350:弹力SUV
400:范
450:迷你巴士
500:大客车
600:班车
700:手推车
800:运输
900:任何
描述:车辆的描述。
MaxPassengers:车辆的最大乘客数。必须大于零。
VehicleID:用来识别特定车辆的信息。
供应商 y 预约供应商。此父元素包含以下子元素:
VendorCode:供应商的供应商代码。
VendorName:供应商的名字。
PhoneNumber:供应商的电话号码。
FormOfPayment y 预订的付款方式。这个父元素包含以下子元素之一:
信用卡:如果在场,乘客将用信用卡付款。有关子元素,请参阅Reply Credit Card Elements表。
现金:如果在场,乘客将支付现金。
查看:如果存在,乘客将支付支票。
DirectBilling:如果在场,旅客将通过直接开票方式付款。
RateDisclaimer N 关于费率的免责文本。
ProviderFeedback N 供应商的任何额外反馈。
AccountingInfo N 预订的会计信息。此父元素包含以下子元素:
AccountingField1通过AccountingField5:这些字段包含详细的会计信息。

利率信息元素

元素 需要吗? 描述
RateID y 的标识符。
速度 y 底价+服务费+附加费+税金
RateTypode. y 速率类型的代码。将是以下选项之一:
F:统一率
H:每小时
E:估计数量
N:目前不可用
CategoryCode N 额外的信息,将被传递回期间出售请求,以帮助确定汇率。
货币 y 速率金额的3字母ISO 4217货币代码。
NoRateText N 速率类型的说明。如果RateTypeCode = n提供
MinHours N 预订的最低小时数。
DiscountType N 应用的折扣类型。
BasePrice N 保留价格不含税金、附加费或服务费。
ServiceCharge N 预订的服务费。
附加费 N 该元素包含desc属性,其中的文本描述了收取附加费的原因。例子:<额外费用DESC =“燃料”>
N 预订税。
ExtraPickupCharge N 接送服务的任何额外费用。
ExtraDropoffCharge N 任何交付服务的额外费用。
可选lextrastopcharge. N 额外停车的费用。
OptionalExtraTimeCharge N 超时每小时的收费。

回复信用卡元素

元素 需要吗? 描述
类型 y 卡类型。
数字 y 的卡号。
过期 y 卡的截止日期。格式:2013-02-19

成功回应的例子

https./1.1200好吧内容类型应用程序/ xml内容长度{内容身体的长度}< CC_LimoCancelReply ><错误代码/><测量/>/>> < /错误1234.<状态>XB> < /状态< ConfNum >4444./>55555< / CancelNum >< PrimaryPassenger ><名>克里斯< / FirstName >< LastName >磨坊主< / LastName ><手机>55512345675551234568< / Phone2 ><手机>5551234569.< EmailAddress >cmiller@example.com< / EmailAddress >< ServiceType >110< ClassOfService/>< PickupLocation >< LocationType >One hundred.< / LocationType >> <机场<机场代码/><飞行>/>/>/>< / >航班/>< StationName/><市/><国家/>< >的火车/>/>/>/><地址>209麦迪逊圣< /地址><城市>亚历山大> < /城市< >状态弗吉尼亚州<中国>我们22314< / PostalCode >< ExtraNotes/>< / PickupLocation >< DropoffLocation >< LocationType >200< / LocationType >> <机场< AirportCode >DCA< / AirportCode ><飞行>< CarrierCode >UA< FlightNumber >333< / FlightNumber >< DepartureDateTime >2012 - 02年- 19 - t11:29:00< / DepartureDateTime >< / >航班/>< StationName/><市/><国家/>< >的火车/>/>/>< DepartureDateTime/><地址/><市/><国家/><国家/>< PostalCode/>< ExtraNotes/>< / DropoffLocation >< StartDateTime >2012 - 02年- 19 - t09:00:00< / StartDateTime >< EndDateTime/>< PickupInstructions >接我< DropoffInstructions >没有一个< / DropoffInstructions >< LanguageCode >en - us< / LanguageCode ><货币>美元货币> < /< NumPassengers >1< / NumPassengers >/>< SpecialServiceRequest/>< PickupServiceArrangement/>/><纺织品疗法/>< RateInfo >< RateID >5.< / RateID ><率>42.50< / >速度< RateTypeCode >E.< / RateTypeCode >< CategoryCode/>/><货币>我们货币> < /< NoRateText/>< DiscountType/>< BasePrice >35.00< / BasePrice >5.00< / ServiceCharge ><附加费desc =“燃料”>1.00< /附加费><税务>1.50< ExtraPickupCharge/>/>< OptionalExtraStopCharge/>/>/>< RateDisclaimer/><车辆>One hundred.< / VehicleType ><描述>这是一辆轿车。> < /描述< MaxPassengers >1< / MaxPassengers >< VehicleID >12< / VehicleID >汽车> < /<供应商>< VendorCode >LML< / VendorCode >< VendorName >LimoVendor< / VendorName >< PhoneNumber >4354654654> < /供应商/>< FormOfPayment ><现金/><检查/>< DirectBilling/><类型>6> < /类型<数>XXXXXXXXXXXX1111< / >数量<到期>2013-02-19< / >到期< /信用卡>< / FormOfPayment >< AccountingField1 >715.< / AccountingField1 >temp@outtask.com< / AccountingField2 >11< / AccountingField3 >< AccountingField4 >发展< / AccountingField4 >