文档中心 > API类目 > 旅行用车API

qimen.alitrip.transfer.order.submit (接送机订单提交接口)

接送机订单提交接口,向具体服务商提交订单请求,完成服务商系统下单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 可选 1234 请求标识
channelId String 可选 2001 服务商id
isPressureTest Boolean 可选 false 是否压测流量,默认false
orderId Number 可选 1111 飞猪订单id
orderTime String 可选 2017-05-05 13:52:32 创建时间
channelName String 可选 阳光车导 服务商名称
travellerInfo TravellerInfo 可选 乘车人信息
  • └ overseasPhone
  • String
  • 可选
  • 1234567
  • 可选,境外联系电话
  • └ overseasPhoneAreaCode
  • String
  • 可选
  • 86
  • 可选,境外联系电话国际区号
  • └ weChatNo
  • String
  • 可选
  • 1234567
  • 可选,微信号
  • └ name
  • String
  • 可选
  • 张三
  • 必填,姓名
  • └ namePinyin
  • String
  • 可选
  • zhangsan
  • 可选,姓名(拼音)
  • └ phone
  • String
  • 可选
  • 13801196360
  • 必填,联系电话
  • └ phoneAreaCode
  • String
  • 可选
  • 86
  • 可选,联系人电话国际区号
  • └ email
  • String
  • 可选
  • abc@a.com
  • 可选,联系电子邮箱
  • └ sex
  • Number
  • 可选
  • 0
  • 可选,性别。0-男,1-女
  • └ birthday
  • String
  • 可选
  • 2000-05-02
  • 可选,出生日期,格式yyyy-mm-dd
  • └ nationality
  • String
  • 可选
  • 中国
  • 可选,国籍
  • └ credentialType
  • Number
  • 可选
  • 0
  • 可选,证件类型。0:身份证 1:护照 2:学生证3:军官证 4:回乡证 5:台胞证 6:港澳通行证 10:警官证 11:士兵证 12:台湾通行证
  • └ credentialNo
  • String
  • 可选
  • E12123123
  • 可选,证件号码
  • └ validDate
  • String
  • 可选
  • 2033-02-02
  • 可选,证件有效期
  • └ verifyPhoneCode
  • String
  • 可选
  • 6360
  • 乘车人安全号验证码(手机后四码),注意:如果有此值表示启用虚拟号,否则没有启用虚拟号功能
userId Number 可选 1234567 本次请求的用户id
userNick String 可选 用户昵称 本次请求的用户昵称
exts String 可选 k1:v1;k2:v2 预留扩展信息,KV对形式
invoiceInfo InvoiceInfo 可选 发票信息(下单不开发票,统一走提交发票接口开票)
  • └ invoiceSend
  • Boolean
  • 可选
  • false
  • 发票是否寄送
  • └ invoiceTypeName
  • String
  • 可选
  • 纸质发票
  • 发票寄送类型
  • └ invoiceTitle
  • String
  • 可选
  • 发票抬头
  • 发票抬头
  • └ invoiceSendWay
  • Number
  • 可选
  • 1
  • 发票寄送类型。1预付邮费,2到付
  • └ eInvoiceSendEmail
  • String
  • 可选
  • 123@12.com
  • 电子发票寄送邮箱
  • └ taxNo
  • String
  • 可选
  • no123445
  • 企业税号
  • └ coAddress
  • String
  • 可选
  • 公司注册地址
  • 公司注册地址
  • └ invoiceSendAddr
  • String
  • 可选
  • 杭州市
  • 发票寄送地址信息
  • └ coPhone
  • String
  • 可选
  • 13666666666
  • 公司电话
  • └ invoiceSendFee
  • Number
  • 可选
  • 1000
  • 发票寄送费用,单位分
  • └ coBank
  • String
  • 可选
  • 工商银行
  • 公司开户银行的名称
  • └ invoiceReceivePhone
  • String
  • 可选
  • 13666666666
  • 发票接收人电话
  • └ coBankNo
  • String
  • 可选
  • 21212121
  • 公司开户银行帐号
  • └ invoiceReceiverName
  • String
  • 可选
  • 张三
  • 发票接收人姓名
orderInfo OrderInfo 可选 主订单信息
  • └ expireTime
  • String
  • 可选
  • 2017-05-05 12:00:00
  • 可选,子订单超时自动关单时间
  • └ totalFee
  • String
  • 可选
  • 105.50
  • 子订单应付金额(原价,商品价格 * 商品数量),精确到2位小数;单位:元。如:200.07,表示:200元7分
  • └ priceMark
  • String
  • 可选
  • 1e4sdfsdg5
  • 价格标识符。目前涉及的业务:用车
  • └ payment
  • String
  • 可选
  • 105.50
  • 子订单实付金额.精确到2位小数;单位:元.如:200.07,表示:200元7分
  • └ comment
  • String
  • 可选
  • 备注
  • 可选,备注
  • promotionDetails
  • PromotionDetail []
  • 可选
  • 优惠信息
  • └ id
  • String
  • 可选
  • 1234
  • 优惠id
  • └ name
  • String
  • 可选
  • 优惠信息名称
  • 优惠信息名称,如”满减券“
  • └ desc
  • String
  • 可选
  • 优惠活动的描述
  • 优惠活动的描述
  • └ target
  • Number
  • 可选
  • 1
  • 优惠对象:1-商品优惠,2-订单优惠
  • └ couponValue
  • Number
  • 可选
  • 11
  • 卡券金额,单位为分
  • └ offValue
  • Number
  • 可选
  • 11
  • 优惠金额
  • └ originValue
  • Number
  • 可选
  • 111
  • 原价
  • └ finalValue
  • Number
  • 可选
  • 110
  • 最终价格
  • └ investor
  • Number
  • 可选
  • 1
  • 出资方。1-平台2-商家
  • └ userRealPay
  • String
  • 可选
  • 102.33
  • 用户实付金额,精确到2位小数;单位:元
transferCarExtInfo TransferCarExtInfo 可选 接送机信息
  • └ useType
  • Number
  • 可选
  • 1
  • 用车类型。1-接机 2-送机 3-接站 4-送站 5-预约车 6-实时叫车
  • └ isCorpOrder
  • Boolean
  • 可选
  • false
  • 是否企业用车,默认false
  • └ adultNum
  • Number
  • 可选
  • 2
  • 可选,用车 成人数
  • └ childNum
  • Number
  • 可选
  • 1
  • 可选,用车 儿童数
  • transferDest
  • TransferDest
  • 可选
  • 接送机,接送站 所在地信息
  • └ supportVisaOnArrival
  • Boolean
  • 可选
  • true
  • 可选,是否支持落地签
  • └ countryName
  • String
  • 可选
  • 中国
  • 国家名称
  • └ cityName
  • String
  • 可选
  • 杭州
  • 城市名称
  • └ countryCode
  • String
  • 可选
  • CN
  • 国家编码
  • └ cityCode
  • String
  • 可选
  • HZ
  • 可选,城市编码
  • └ originCity
  • String
  • 可选
  • 上海
  • 出发地所在城市
  • └ destCity
  • String
  • 可选
  • 杭州
  • 到达地所在城市
  • fromPlaceInfo
  • FromPlaceInfo
  • 可选
  • 送机、送站 对应的用户出发地信息
  • └ fromAddress
  • String
  • 可选
  • 杭州
  • 出发地
  • └ fromDetailAddress
  • String
  • 可选
  • 西湖
  • 可选,出发详细地址
  • └ fromLongitude
  • String
  • 可选
  • 111.111
  • 出发地经度
  • └ fromLatitude
  • String
  • 可选
  • 111.111
  • 出发地纬度
  • toPlaceInfo
  • ToPlaceInfo
  • 可选
  • 接机、接站 对应的用户目的地信息
  • └ toAddress
  • String
  • 可选
  • 杭州
  • 到达地
  • └ toDetailAddress
  • String
  • 可选
  • 西湖
  • 可选,到达地详细地址
  • └ toLongitude
  • String
  • 可选
  • 111.111
  • 到达地经度
  • └ toLatitude
  • String
  • 可选
  • 111.111
  • 到达地纬度
  • flightInfo
  • FlightInfo
  • 可选
  • 接送机航班、航站信息
  • └ flightNo
  • String
  • 可选
  • CA149
  • 航班号
  • └ flightFlyTime
  • String
  • 可选
  • 2017-05-05 11:00:00
  • 航班起飞时间 (当地时间)
  • └ flightDepartureTime
  • String
  • 可选
  • 2017-05-05 11:00:00
  • 可选,航班起飞时间
  • └ airportCode
  • String
  • 可选
  • HZZ
  • 机场三字码
  • └ originAirportCode
  • String
  • 可选
  • HGH
  • 接机航班出发地三字码
  • └ airportTerminal
  • String
  • 可选
  • 2号
  • 可选,航站楼
  • carUseInfo
  • CarUseInfo
  • 可选
  • 用车时间、距离、车型信息
  • └ serviceTime
  • String
  • 可选
  • 2020-02-22 15:50:00
  • 用车时间(当地时间)
  • └ serviceTimeMs
  • String
  • 可选
  • 1582357800000
  • 用车时间毫秒数
  • └ distance
  • String
  • 可选
  • 111
  • 出发地至目的地之间距离 单位(米)
  • └ distanceType
  • Number
  • 可选
  • 0
  • 地图距离计算类型 0地图API 1自算
  • └ expectedTime
  • String
  • 可选
  • 1111
  • 预计用时 单位:秒
  • └ flightDelayTime
  • String
  • 可选
  • 22
  • 下飞机后多久用车(分)
  • └ carTypeList
  • Number []
  • 可选
  • 指定车型列表
  • └ providerId
  • String
  • 可选
  • 1001
  • 用车 服务商id
  • └ providerName
  • String
  • 可选
  • 服务商名称
  • 用车 服务商名称
  • └ safeTripOrder
  • Boolean
  • 可选
  • false
  • 安心行订单标识(true:是安心行)
  • bookingAgentInfo
  • BookingAgentInfo
  • 可选
  • 代订人信息
  • └ agentContactPhone
  • String
  • 可选
  • 15801178982
  • 代订人手机号,如果有verifyPhoneCode不为空,此值是虚拟号,否则是真实号
adjustPriceInfo AdjustPriceInfo 可选 商家自动调价信息 如需开通请联系运营
  • └ adjustAmount
  • String
  • 可选
  • -20.00
  • e.g: 加价:20.00元 降价:-20.00元
  • └ adjustPriceRuleId
  • String
  • 可选
  • 17
  • 本次调价生次规则ID

响应参数

名称 类型 示例值 描述
success Boolean true 必填,接口调用是否成功
orderId Number 12345 飞猪订单id
outOrderId String 11233 外部商家订单号
createdTime String 2017-05-05 12:00:00 外部商家订单创建时间
providerId String 1001 用车服务商渠道标识,联系飞猪运营人员提供
errorInfo ErrorInfo 错误信息
  • └ code
  • String
  • -1
  • 错误码
  • └ message
  • String
  • 错误信息
  • 错误信息
  • └ subCode
  • String
  • -1
  • 子错误码
  • └ subMessage
  • String
  • 子错误信息
  • 子错误信息
providerName String 易途8 用车服务商渠道名称,联系飞猪运营人员提供

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlitripTransferOrderSubmitRequest req = new AlitripTransferOrderSubmitRequest();
req.setTraceId("1234");
req.setChannelId("2001");
req.setIsPressureTest(false);
req.setOrderId(1111L);
req.setOrderTime("2017-05-05 13:52:32");
req.setChannelName("阳光车导");
AlitripTransferOrderSubmitRequest.TravellerInfo obj1 = new AlitripTransferOrderSubmitRequest.TravellerInfo();
obj1.setOverseasPhone("1234567");
obj1.setOverseasPhoneAreaCode("86");
obj1.setWeChatNo("1234567");
obj1.setName("张三");
obj1.setNamePinyin("zhangsan");
obj1.setPhone("13801196360");
obj1.setPhoneAreaCode("86");
obj1.setEmail("abc@a.com");
obj1.setSex(0L);
obj1.setBirthday("2000-05-02");
obj1.setNationality("中国");
obj1.setCredentialType(0L);
obj1.setCredentialNo("E12123123");
obj1.setValidDate("2033-02-02");
obj1.setVerifyPhoneCode("6360");
req.setTravellerInfo(obj1);
req.setUserId(1234567L);
req.setUserNick("用户昵称");
req.setExts("k1:v1;k2:v2");
AlitripTransferOrderSubmitRequest.InvoiceInfo obj2 = new AlitripTransferOrderSubmitRequest.InvoiceInfo();
obj2.setInvoiceSend(false);
obj2.setInvoiceTypeName("纸质发票");
obj2.setInvoiceTitle("发票抬头");
obj2.setInvoiceSendWay(1L);
obj2.setEInvoiceSendEmail("123@12.com");
obj2.setTaxNo("no123445");
obj2.setCoAddress("公司注册地址");
obj2.setInvoiceSendAddr("杭州市");
obj2.setCoPhone("13666666666");
obj2.setInvoiceSendFee(1000L);
obj2.setCoBank("工商银行");
obj2.setInvoiceReceivePhone("13666666666");
obj2.setCoBankNo("21212121");
obj2.setInvoiceReceiverName("张三");
req.setInvoiceInfo(obj2);
AlitripTransferOrderSubmitRequest.OrderInfo obj3 = new AlitripTransferOrderSubmitRequest.OrderInfo();
obj3.setExpireTime("2017-05-05 12:00:00");
obj3.setTotalFee("105.50");
obj3.setPriceMark("1e4sdfsdg5");
obj3.setPayment("105.50");
obj3.setComment("备注");
List<AlitripTransferOrderSubmitRequest.PromotionDetail> list5 = new ArrayList<AlitripTransferOrderSubmitRequest.PromotionDetail>();
AlitripTransferOrderSubmitRequest.PromotionDetail obj6 = new AlitripTransferOrderSubmitRequest.PromotionDetail();
list5.add(obj6);
obj6.setId("1234");
obj6.setName("优惠信息名称");
obj6.setDesc("优惠活动的描述");
obj6.setTarget(1L);
obj6.setCouponValue(11L);
obj6.setOffValue(11L);
obj6.setOriginValue(111L);
obj6.setFinalValue(110L);
obj6.setInvestor(1L);
obj3.setPromotionDetails(list5);
obj3.setUserRealPay("102.33");
req.setOrderInfo(obj3);
AlitripTransferOrderSubmitRequest.TransferCarExtInfo obj7 = new AlitripTransferOrderSubmitRequest.TransferCarExtInfo();
obj7.setUseType(1L);
obj7.setIsCorpOrder(false);
obj7.setAdultNum(2L);
obj7.setChildNum(1L);
AlitripTransferOrderSubmitRequest.TransferDest obj8 = new AlitripTransferOrderSubmitRequest.TransferDest();
obj8.setSupportVisaOnArrival(true);
obj8.setCountryName("中国");
obj8.setCityName("杭州");
obj8.setCountryCode("CN");
obj8.setCityCode("HZ");
obj8.setOriginCity("上海");
obj8.setDestCity("杭州");
obj7.setTransferDest(obj8);
AlitripTransferOrderSubmitRequest.FromPlaceInfo obj9 = new AlitripTransferOrderSubmitRequest.FromPlaceInfo();
obj9.setFromAddress("杭州");
obj9.setFromDetailAddress("西湖");
obj9.setFromLongitude("111.111");
obj9.setFromLatitude("111.111");
obj7.setFromPlaceInfo(obj9);
AlitripTransferOrderSubmitRequest.ToPlaceInfo obj10 = new AlitripTransferOrderSubmitRequest.ToPlaceInfo();
obj10.setToAddress("杭州");
obj10.setToDetailAddress("西湖");
obj10.setToLongitude("111.111");
obj10.setToLatitude("111.111");
obj7.setToPlaceInfo(obj10);
AlitripTransferOrderSubmitRequest.FlightInfo obj11 = new AlitripTransferOrderSubmitRequest.FlightInfo();
obj11.setFlightNo("CA149");
obj11.setFlightFlyTime("2017-05-05 11:00:00");
obj11.setFlightDepartureTime("2017-05-05 11:00:00");
obj11.setAirportCode("HZZ");
obj11.setOriginAirportCode("HGH");
obj11.setAirportTerminal("2号");
obj7.setFlightInfo(obj11);
AlitripTransferOrderSubmitRequest.CarUseInfo obj12 = new AlitripTransferOrderSubmitRequest.CarUseInfo();
obj12.setServiceTime("2020-02-22 15:50:00");
obj12.setServiceTimeMs("1582357800000");
obj12.setDistance("111");
obj12.setDistanceType(0L);
obj12.setExpectedTime("1111");
obj12.setFlightDelayTime("22");
obj12.setCarTypeList(new Long[] {  };
);
obj7.setCarUseInfo(obj12);
obj7.setProviderId("1001");
obj7.setProviderName("服务商名称");
obj7.setSafeTripOrder(false);
AlitripTransferOrderSubmitRequest.BookingAgentInfo obj13 = new AlitripTransferOrderSubmitRequest.BookingAgentInfo();
obj13.setAgentContactPhone("15801178982");
obj7.setBookingAgentInfo(obj13);
req.setTransferCarExtInfo(obj7);
AlitripTransferOrderSubmitRequest.AdjustPriceInfo obj14 = new AlitripTransferOrderSubmitRequest.AdjustPriceInfo();
obj14.setAdjustAmount("-20.00");
obj14.setAdjustPriceRuleId("17");
req.setAdjustPriceInfo(obj14);
AlitripTransferOrderSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<success>true</success>
<orderId>12345</orderId>
<outOrderId>11233</outOrderId>
<createdTime>2017-05-05 12:00:00</createdTime>
<providerId>1001</providerId>
<errorInfo>
    <code>-1</code>
    <message>错误信息</message>
    <subCode>-1</subCode>
    <subMessage>子错误信息</subMessage>
</errorInfo>
<providerName>易途8</providerName>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部