取消预订操作将发送给供应商代表用户取消旅行预订。地面运输直接连接将相关信息发送到旅行供应商维护的URI。标准位置是:https:// {servername} / concur / groundtransportation
.供应商在注册合作伙伴应用程序时配置此URI。
/ concur /地区Portation
授权头必须包含Base64编码的基本身份验证凭据(登录ID和密码)。在注册应用程序连接器时建立登录和密码。
'授权:基本{Base64编码LoginID:password}'
请求包含一个CC_LimoCancelRequest
父元素和子元素在下表中列出:
元素 | 必需的/可选 | 描述 |
---|---|---|
ReservationID | 要求 | 预留的唯一标识符。 |
邮政/ concur /地区Portationhttps./1.1宿主:example.com授权:基本…内容类型:应用程序/ xml内容长度:{内容身体的长度}< CC_LimoCancelRequest > 1234.保留> cc_limocanceLrequest>
供应商通过提供完整的预订细节和更新的状态来响应请求。
响应将包含一个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. confnum>/> 55555< / CancelNum >< PrimaryPassenger ><名>克里斯< / FirstName >< LastName >磨坊主< / LastName ><手机>5551234567电话> 5551234568< / Phone2 ><手机>5551234569.手机>< EmailAddress >cmiller@example.com< / EmailAddress > migentPaser>< ServiceType >110 serviceType>< ClassOfService/>< PickupLocation >< LocationType >One hundred.< / LocationType >> <机场<机场代码/><飞行>/>/>/>< / >航班机场>/>< StationName/><市/><国家/>< >的火车/>/>/>/>火车> trainstation><地址>209麦迪逊圣< /地址><城市>亚历山大> < /城市< >状态弗吉尼亚州 state><中国>我们国家> 22314< / PostalCode >< ExtraNotes/>< / PickupLocation >< DropoffLocation >< LocationType >200< / LocationType >> <机场< AirportCode >DCA< / AirportCode ><飞行>< CarrierCode >UA coriercode>< FlightNumber >333< / FlightNumber >< DepartureDateTime >2012 - 02年- 19 - t11:29:00< / DepartureDateTime >< / >航班机场>/>< StationName/><市/><国家/>< >的火车/>/>/>< DepartureDateTime/>火车> trainstation><地址/><市/><国家/><国家/>< PostalCode/>< ExtraNotes/>< / DropoffLocation >< StartDateTime >2012 - 02年- 19 - t09:00:00< / StartDateTime >< EndDateTime/>< PickupInstructions >接我 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/>/>/> RATEINFO>< RateDisclaimer/><车辆> One hundred.< / VehicleType ><描述>这是一辆轿车。> < /描述< MaxPassengers >1< / MaxPassengers >< VehicleID >12< / VehicleID >汽车> < /<供应商>< VendorCode >LML< / VendorCode >< VendorName >LimoVendor< / VendorName >< PhoneNumber >4354654654 phonenumber>> < /供应商/>< FormOfPayment ><现金/><检查/>< DirectBilling/> <类型>6> < /类型<数>XXXXXXXXXXXX1111< / >数量<到期>2013-02-19< / >到期< /信用卡>< / FormOfPayment > < AccountingField1 >715.< / AccountingField1 > temp@outtask.com< / AccountingField2 > 11< / AccountingField3 >< AccountingField4 >发展< / AccountingField4 > AccountingInfo> cc_limocanceLreply>