文档中心 > API类目 > 旅行度假API

qimen.alitrip.rentcar.order.submit (租车订单提交接口)

提交订单给服务商,完成服务商端的下单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 必须 123456 请求标识
isPressureTest Boolean 可选 false
  • 默认值:false
  • 是否压测流量,默认false
    channelId String 可选 20010 渠道id
    orderId Number 必须 1234 订单id
    createdTime String 可选 2017-05-11 11:11:11 订单创建时间
    channelName String 可选 赫兹 渠道名称
    userId Number 可选 22322 用户id
    userNick String 可选 用户昵称 用户昵称
    priceInfo PriceInfo 可选 订单价格信息
    • └ totalFee
    • String
    • 可选
    • 122.33
    • 订单应付金额,元
    • └ totalFeeUSD
    • String
    • 可选
    • 122.33
    • 订单应付金额,美元
    • └ payment
    • String
    • 可选
    • 122.33
    • 订单实付金额,元
    • └ paymentUSD
    • String
    • 可选
    • 122.33
    • 订单实付金额,美元
    • └ priceMark
    • String
    • 可选
    • 123456
    • 价格标识符
    • └ payType
    • Number
    • 可选
    • 1
    • 支付类型。1-在线付,2-到店付。目前涉及的业务:租车
    • └ addedServices
    • String
    • 可选
    • 111,112,113
    • 选择的增值服务code,以“,”分隔
    • └ isAlipayCredit
    • Number
    • 可选
    • 0
    • 是否信用免押,0 不是,1 免车辆押金,2 免违章押金,3 全免
    carUseInfo CarUseInfo 可选 租用车信息
    • └ carUseTime
    • String
    • 可选
    • 2017-05-11 11:11:11
    • 取车时间
    • └ carReturnTime
    • String
    • 可选
    • 2017-05-11 11:11:11
    • 还车时间
    • └ carId
    • String
    • 可选
    • 1111
    • 车型id
    • └ originStoreCode
    • String
    • 可选
    • LAX
    • 取车门店码
    • └ returnStoreCode
    • String
    • 可选
    • LAX
    • 还车门店码
    • └ flightNo
    • String
    • 可选
    • CA1111
    • 航班号
    • └ sipp
    • String
    • 可选
    • CERS
    • sipp
    • └ hertzSupplierCode
    • String
    • 可选
    • ZE
    • 赫兹供应商code。ZE-赫兹,ZR-道乐,ZT-苏立夫提
    • equipmentList
    • RentEquipment []
    • 可选
    • 设备租用列表
    • └ code
    • String
    • 可选
    • GPS
    • 设备代码
    • └ name
    • String
    • 可选
    • GPS
    • 设备名称
    • └ num
    • Number
    • 可选
    • 1
    • 租用数量
    • └ outCarId
    • String
    • 可选
    • out123
    • 外部商家自定义的车型id。国内租车、国际租车惠租车使用。
    • └ originCityCode
    • String
    • 可选
    • 110000
    • 取车城市Code
    • └ returnCityCode
    • String
    • 可选
    • 110000
    • 还车城市Code
    • └ isPickUpOnDoor
    • Boolean
    • 可选
    • true
    • 是否送车上门
    • pickUpAddr
    • AddressInfo
    • 可选
    • 取车地址
    • └ address
    • String
    • 可选
    • 阿里巴巴
    • 地址名称
    • └ longitude
    • String
    • 可选
    • 116.123
    • 地址经度
    • └ latitude
    • String
    • 可选
    • 116.123
    • 地址纬度
    • └ isPickOffOnDoor
    • Boolean
    • 可选
    • false
    • 是否上门取车
    • pickOffAddr
    • AddressInfo
    • 可选
    • 还车地址
    • └ address
    • String
    • 可选
    • 阿里巴巴
    • 地址名称
    • └ longitude
    • String
    • 可选
    • 116.123
    • 地址经度
    • └ latitude
    • String
    • 可选
    • 116.123
    • 地址纬度
    • └ thirdExtInfos
    • String
    • 可选
    • 第三方扩展信息
    • 第三方扩展信息
    travellerInfo TravellerInfo 可选 必须,驾驶人信息
    • └ name
    • String
    • 可选
    • 张三
    • 姓名
    • └ namePinyin
    • String
    • 可选
    • zhangsan
    • 姓名拼音
    • └ firstNamePinyin
    • String
    • 可选
    • zhang
    • 姓(拼音)
    • └ lastNamePinyin
    • String
    • 可选
    • san
    • 名(拼音)
    • └ phone
    • String
    • 可选
    • 123333
    • 联系电话
    • └ phoneAreaCode
    • String
    • 可选
    • 0571
    • 联系电话国际区号
    • └ email
    • String
    • 可选
    • 123@xx.com
    • 联系电子邮箱
    • └ sex
    • Number
    • 可选
    • 0
    • 性别。0-男,1-女
    • └ birthday
    • String
    • 可选
    • yyyy-mm-dd
    • 出生日期,格式yyyy-mm-dd
    • └ age
    • Number
    • 可选
    • 21
    • 年龄
    • └ credentialType
    • Number
    • 可选
    • 0
    • 证件类型。0:身份证 1:护照 2:学生证3:军官证 4:回乡证 5:台胞证 6:港澳通行证 10:警官证 11:士兵证 12:台湾通行证
    • └ credentialNo
    • String
    • 可选
    • 313131313131
    • 证件号码
    contactorInfo ContactorInfo 可选 可选,联系人信息。
    • └ name
    • String
    • 可选
    • 张三
    • 姓名
    • └ namePinyin
    • String
    • 可选
    • zhangsan
    • 姓名拼音
    • └ firstNamePinyin
    • String
    • 可选
    • zhang
    • 姓(拼音)
    • └ lastNamePinyin
    • String
    • 可选
    • san
    • 名(拼音)
    • └ phone
    • String
    • 可选
    • 123333
    • 联系电话
    • └ phoneAreaCode
    • String
    • 可选
    • 0571
    • 联系电话国际区号
    • └ email
    • String
    • 可选
    • 123@xx.com
    • 联系电子邮箱
    promotionDetails PromotionDetail [] 可选
  • 最大列表长度:20
  • 优惠信息
    • └ id
    • String
    • 可选
    • 1223
    • 优惠id
    • └ name
    • String
    • 可选
    • 优惠信息名称
    • 优惠信息名称
    • └ desc
    • String
    • 可选
    • 优惠活动的描述
    • 优惠活动的描述
    • └ couponValue
    • Number
    • 可选
    • 3000
    • 卡券金额,分
    • └ investor
    • Number
    • 可选
    • 1
    • 出资方。1-平台,2-商家
    useTestData Boolean 可选 true 是否调用服务商测试环境数据。true:调用服务商测试环境,false:调用服务商线上正式环境
    cardTag String 可选 2 次卡标记(1:次卡 2:天卡 3:随心租卡)
    rentCardAttrMap String 可选 {"cardOrderId":"132798776633334","basicRentFee":"138.38","cardId":"jfefew*&65fe#","cardTradeNo":"2088993232232","basicServiceFee":"50","poundageFee":"20.01"} 宝贝卡扩展属性 宝贝ID:cardId 宝贝订单号:cardOrderId 宝贝支付宝流水号:cardTradeNo 减免的总租金金额:basicRentFee 减免的总基础服务费金额:basicServiceFee 减免的总手续费金额:poundageFee 如果租金、手续费、基础服务费无减免则返回0

    响应参数

    名称 类型 示例值 描述
    success Boolean true 接口调用是否成功
    orderId Number 122 飞猪度假订单id
    outOrderId String 1233 外部商家订单号
    confirmId String 2132 租车,官方确认号
    coverageNo String ref323213 第三方保险号。个别包含第三方保险的套餐,预定成功后会返回保险号
    claimService String 理赔热线:11333 包含第三方保险的情况下,对应的保险理赔专线
    createdTime String 2017-05-11 11:11:11 外部商家订单创建时间
    providerId String 20001 用车服务商渠道标识
    errorInfo ErrorInfo 错误信息
    • └ code
    • String
    • 1001
    • 自定义错误码。1001:商家接口 系统异常。2001:商家接口 业务异常。3001:uac内部系统异常。4001:uac业务校验异常。
    • └ message
    • String
    • 错误信息
    • 自定义错误信息。记录各链路错误详细描述,以“|”分隔,如:商家接口出现系统异常/业务错误(uac)|商家具体错误描述。
    • └ subCode
    • String
    • -2
    • 子错误码
    • └ subMessage
    • String
    • 子错误信息
    • 子错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripRentcarOrderSubmitRequest req = new AlitripRentcarOrderSubmitRequest();
    req.setTraceId("123456");
    req.setIsPressureTest(false);
    req.setChannelId("20010");
    req.setOrderId(1234L);
    req.setCreatedTime("2017-05-11 11:11:11");
    req.setChannelName("赫兹");
    req.setUserId(22322L);
    req.setUserNick("用户昵称");
    AlitripRentcarOrderSubmitRequest.PriceInfo obj1 = new AlitripRentcarOrderSubmitRequest.PriceInfo();
    obj1.setTotalFee("122.33");
    obj1.setTotalFeeUSD("122.33");
    obj1.setPayment("122.33");
    obj1.setPaymentUSD("122.33");
    obj1.setPriceMark("123456");
    obj1.setPayType(1L);
    obj1.setAddedServices("111,112,113");
    obj1.setIsAlipayCredit(0L);
    req.setPriceInfo(obj1);
    AlitripRentcarOrderSubmitRequest.CarUseInfo obj2 = new AlitripRentcarOrderSubmitRequest.CarUseInfo();
    obj2.setCarUseTime("2017-05-11 11:11:11");
    obj2.setCarReturnTime("2017-05-11 11:11:11");
    obj2.setCarId("1111");
    obj2.setOriginStoreCode("LAX");
    obj2.setReturnStoreCode("LAX");
    obj2.setFlightNo("CA1111");
    obj2.setSipp("CERS");
    obj2.setHertzSupplierCode("ZE");
    List<AlitripRentcarOrderSubmitRequest.RentEquipment> list4 = new ArrayList<AlitripRentcarOrderSubmitRequest.RentEquipment>();
    AlitripRentcarOrderSubmitRequest.RentEquipment obj5 = new AlitripRentcarOrderSubmitRequest.RentEquipment();
    list4.add(obj5);
    obj5.setCode("GPS");
    obj5.setName("GPS");
    obj5.setNum(1L);
    obj2.setEquipmentList(list4);
    obj2.setOutCarId("out123");
    obj2.setOriginCityCode("110000");
    obj2.setReturnCityCode("110000");
    obj2.setIsPickUpOnDoor(true);
    AlitripRentcarOrderSubmitRequest.AddressInfo obj6 = new AlitripRentcarOrderSubmitRequest.AddressInfo();
    obj6.setAddress("阿里巴巴");
    obj6.setLongitude("116.123");
    obj6.setLatitude("116.123");
    obj2.setPickUpAddr(obj6);
    obj2.setIsPickOffOnDoor(false);
    AlitripRentcarOrderSubmitRequest.AddressInfo obj7 = new AlitripRentcarOrderSubmitRequest.AddressInfo();
    obj7.setAddress("阿里巴巴");
    obj7.setLongitude("116.123");
    obj7.setLatitude("116.123");
    obj2.setPickOffAddr(obj7);
    obj2.setThirdExtInfos("第三方扩展信息");
    req.setCarUseInfo(obj2);
    AlitripRentcarOrderSubmitRequest.TravellerInfo obj8 = new AlitripRentcarOrderSubmitRequest.TravellerInfo();
    obj8.setName("张三");
    obj8.setNamePinyin("zhangsan");
    obj8.setFirstNamePinyin("zhang");
    obj8.setLastNamePinyin("san");
    obj8.setPhone("123333");
    obj8.setPhoneAreaCode("0571");
    obj8.setEmail("123@xx.com");
    obj8.setSex(0L);
    obj8.setBirthday("yyyy-mm-dd");
    obj8.setAge(21L);
    obj8.setCredentialType(0L);
    obj8.setCredentialNo("313131313131");
    req.setTravellerInfo(obj8);
    AlitripRentcarOrderSubmitRequest.ContactorInfo obj9 = new AlitripRentcarOrderSubmitRequest.ContactorInfo();
    obj9.setName("张三");
    obj9.setNamePinyin("zhangsan");
    obj9.setFirstNamePinyin("zhang");
    obj9.setLastNamePinyin("san");
    obj9.setPhone("123333");
    obj9.setPhoneAreaCode("0571");
    obj9.setEmail("123@xx.com");
    req.setContactorInfo(obj9);
    List<AlitripRentcarOrderSubmitRequest.PromotionDetail> list11 = new ArrayList<AlitripRentcarOrderSubmitRequest.PromotionDetail>();
    AlitripRentcarOrderSubmitRequest.PromotionDetail obj12 = new AlitripRentcarOrderSubmitRequest.PromotionDetail();
    list11.add(obj12);
    obj12.setId("1223");
    obj12.setName("优惠信息名称");
    obj12.setDesc("优惠活动的描述");
    obj12.setCouponValue(3000L);
    obj12.setInvestor(1L);
    req.setPromotionDetails(list11);
    req.setUseTestData(true);
    req.setCardTag("2");
    req.setRentCardAttrMap("{\"cardOrderId\":\"132798776633334\",\"basicRentFee\":\"138.38\",\"cardId\":\"jfefew*&65fe#\",\"cardTradeNo\":\"2088993232232\",\"basicServiceFee\":\"50\",\"poundageFee\":\"20.01\"}");
    AlitripRentcarOrderSubmitResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <orderId>122</orderId>
    <outOrderId>1233</outOrderId>
    <confirmId>2132</confirmId>
    <coverageNo>ref323213</coverageNo>
    <claimService>理赔热线:11333</claimService>
    <createdTime>2017-05-11 11:11:11</createdTime>
    <providerId>20001</providerId>
    <errorInfo>
        <code>1001</code>
        <message>错误信息</message>
        <subCode>-2</subCode>
        <subMessage>子错误信息</subMessage>
    </errorInfo>
    

    异常示例

    • 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>

    错误码解释

    错误码 错误描述 解决方案
    isp.http-read-timeout 根据错误提示修改 根据错误提示修改
    isp.http-connection-timeout 根据错误提示修改 根据错误提示修改
    -1 根据错误提示修改 根据错误提示修改
    sign-check-failture 根据错误提示修改 根据错误提示修改
    2001 根据错误提示修改 根据错误提示修改
    2999 根据错误提示修改 根据错误提示修改
    1001 根据错误提示修改 根据错误提示修改
    isv.param 参数异常 请根据错误提示修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部