文档中心 > API类目 > 飞猪-综合交通api

qimen.alitrip.transfer.order.create (即时打车&接送机创建订单)

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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
  • 可选
  • 13666666666
  • 必填,联系电话
  • └ 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
  • 可选,证件有效期
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
  • 可选
  • DJEKEEFHS
  • 价格唯一标识
  • └ 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-商家
  • └ callId
  • String
  • 可选
  • 4880109188406595918
  • 获取请求id接口返回的叫车id
  • carPriceList
  • CarPriceInfo []
  • 可选
  • 可选择多种车型时必填
  • └ carId
  • String
  • 可选
  • 101
  • 飞猪车型编码
  • └ estimatedPrice
  • String
  • 可选
  • 235.05
  • 预估价格(供应商报价接口返回的价格)
  • └ payPrice
  • String
  • 可选
  • 201.05
  • 实际支付价格(优惠后价格)
  • └ priceId
  • String
  • 可选
  • DFEEFEWEESSD
  • 价格id(供应商价格唯一标识)
  • └ exts
  • String
  • 可选
  • k1:v1;k2:v2
  • 供应商车型扩展信息,kv结构,搜索报价时填入的信息
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
  • 可选
  • 杭州
  • 到达地所在城市
  • └ curLongitude
  • String
  • 可选
  • 106.72
  • 用户当前经度
  • └ curLatitude
  • String
  • 可选
  • 26.57
  • 用户当前纬度
  • 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
  • 可选
  • 服务商名称
  • 用车 服务商名称
smsPolicy Number 可选 1 发送短信策略(0,为叫车人和乘车人都发送,1,乘车人发送叫车人不发,2乘车人不发叫车人发,3乘车人和叫车人都不发)
imei String 可选 abdfde 机器唯一标识
clientIp String 可选 192.168.1.22 客户端ip地址

响应参数

名称 类型 示例值 描述
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);
AlitripTransferOrderCreateRequest req = new AlitripTransferOrderCreateRequest();
req.setTraceId("1234");
req.setChannelId("2001");
req.setIsPressureTest(false);
req.setOrderId(1111L);
req.setOrderTime("2017-05-05 13:52:32");
req.setChannelName("阳光车导");
AlitripTransferOrderCreateRequest.TravellerInfo obj1 = new AlitripTransferOrderCreateRequest.TravellerInfo();
obj1.setOverseasPhone("1234567");
obj1.setOverseasPhoneAreaCode("86");
obj1.setWeChatNo("1234567");
obj1.setName("张三");
obj1.setNamePinyin("zhangsan");
obj1.setPhone("13666666666");
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");
req.setTravellerInfo(obj1);
req.setUserId(1234567L);
req.setUserNick("用户昵称");
req.setExts("k1:v1;k2:v2");
AlitripTransferOrderCreateRequest.InvoiceInfo obj2 = new AlitripTransferOrderCreateRequest.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);
AlitripTransferOrderCreateRequest.OrderInfo obj3 = new AlitripTransferOrderCreateRequest.OrderInfo();
obj3.setExpireTime("2017-05-05 12:00:00");
obj3.setTotalFee("105.50");
obj3.setPriceMark("DJEKEEFHS");
obj3.setPayment("105.50");
obj3.setComment("备注");
List<AlitripTransferOrderCreateRequest.PromotionDetail> list5 = new ArrayList<AlitripTransferOrderCreateRequest.PromotionDetail>();
AlitripTransferOrderCreateRequest.PromotionDetail obj6 = new AlitripTransferOrderCreateRequest.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.setCallId("4880109188406595918");
List<AlitripTransferOrderCreateRequest.CarPriceInfo> list8 = new ArrayList<AlitripTransferOrderCreateRequest.CarPriceInfo>();
AlitripTransferOrderCreateRequest.CarPriceInfo obj9 = new AlitripTransferOrderCreateRequest.CarPriceInfo();
list8.add(obj9);
obj9.setCarId("101");
obj9.setEstimatedPrice("235.05");
obj9.setPayPrice("201.05");
obj9.setPriceId("DFEEFEWEESSD");
obj9.setExts("k1:v1;k2:v2");
obj3.setCarPriceList(list8);
req.setOrderInfo(obj3);
AlitripTransferOrderCreateRequest.TransferCarExtInfo obj10 = new AlitripTransferOrderCreateRequest.TransferCarExtInfo();
obj10.setUseType(1L);
obj10.setIsCorpOrder(false);
obj10.setAdultNum(2L);
obj10.setChildNum(1L);
AlitripTransferOrderCreateRequest.TransferDest obj11 = new AlitripTransferOrderCreateRequest.TransferDest();
obj11.setSupportVisaOnArrival(true);
obj11.setCountryName("中国");
obj11.setCityName("杭州");
obj11.setCountryCode("CN");
obj11.setCityCode("HZ");
obj11.setOriginCity("上海");
obj11.setDestCity("杭州");
obj11.setCurLongitude("106.72");
obj11.setCurLatitude("26.57");
obj10.setTransferDest(obj11);
AlitripTransferOrderCreateRequest.FromPlaceInfo obj12 = new AlitripTransferOrderCreateRequest.FromPlaceInfo();
obj12.setFromAddress("杭州");
obj12.setFromDetailAddress("西湖");
obj12.setFromLongitude("111.111");
obj12.setFromLatitude("111.111");
obj10.setFromPlaceInfo(obj12);
AlitripTransferOrderCreateRequest.ToPlaceInfo obj13 = new AlitripTransferOrderCreateRequest.ToPlaceInfo();
obj13.setToAddress("杭州");
obj13.setToDetailAddress("西湖");
obj13.setToLongitude("111.111");
obj13.setToLatitude("111.111");
obj10.setToPlaceInfo(obj13);
AlitripTransferOrderCreateRequest.FlightInfo obj14 = new AlitripTransferOrderCreateRequest.FlightInfo();
obj14.setFlightNo("CA149");
obj14.setFlightFlyTime("2017-05-05 11:00:00");
obj14.setFlightDepartureTime("2017-05-05 11:00:00");
obj14.setAirportCode("HZZ");
obj14.setOriginAirportCode("HGH");
obj14.setAirportTerminal("2号");
obj10.setFlightInfo(obj14);
AlitripTransferOrderCreateRequest.CarUseInfo obj15 = new AlitripTransferOrderCreateRequest.CarUseInfo();
obj15.setServiceTime("2020-02-22 15:50:00");
obj15.setServiceTimeMs("1582357800000");
obj15.setDistance("111");
obj15.setDistanceType(0L);
obj15.setExpectedTime("1111");
obj15.setFlightDelayTime("22");
obj15.setCarTypeList(new Long[] {  };
);
obj10.setCarUseInfo(obj15);
obj10.setProviderId("1001");
obj10.setProviderName("服务商名称");
req.setTransferCarExtInfo(obj10);
req.setSmsPolicy(1L);
req.setImei("abdfde");
req.setClientIp("192.168.1.22");
AlitripTransferOrderCreateResponse 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

返回
顶部