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

qimen.alitrip.rentcar.order.check (提交订单前校验是否可下单接口)

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 必须 123456 请求标识
channelId String 可选 20010 渠道id
createdTime String 可选 2017-05-11 11:11:11 订单创建时间
priceInfo PriceInfo 可选 订单价格信息
  • └ totalFee
  • String
  • 可选
  • 122.33
  • 订单应付金额,元
  • └ payment
  • 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
  • 还车门店码
  • 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-商家
    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 接口调用是否成功
    errorInfo ErrorInfo 错误信息
    • └ errCode
    • String
    • 1001
    • 自定义错误码。1001:商家接口 系统异常。2001:商家接口 业务异常。3001:uac内部系统异常。4001:uac业务校验异常。
    • └ errMessage
    • String
    • 错误信息
    • 自定义错误信息。记录各链路错误详细描述,以“|”分隔,如:商家接口出现系统异常/业务错误(uac)|商家具体错误描述。
    • └ subErrCode
    • String
    • -2
    • 子错误码
    • └ subErrMessage
    • String
    • 子错误信息
    • 子错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripRentcarOrderCheckRequest req = new AlitripRentcarOrderCheckRequest();
    req.setTraceId("123456");
    req.setChannelId("20010");
    req.setCreatedTime("2017-05-11 11:11:11");
    AlitripRentcarOrderCheckRequest.PriceInfo obj1 = new AlitripRentcarOrderCheckRequest.PriceInfo();
    obj1.setTotalFee("122.33");
    obj1.setPayment("122.33");
    obj1.setPriceMark("123456");
    obj1.setPayType(1L);
    obj1.setAddedServices("111,112,113");
    obj1.setIsAlipayCredit(0L);
    req.setPriceInfo(obj1);
    AlitripRentcarOrderCheckRequest.CarUseInfo obj2 = new AlitripRentcarOrderCheckRequest.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");
    List<AlitripRentcarOrderCheckRequest.RentEquipment> list4 = new ArrayList<AlitripRentcarOrderCheckRequest.RentEquipment>();
    AlitripRentcarOrderCheckRequest.RentEquipment obj5 = new AlitripRentcarOrderCheckRequest.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);
    AlitripRentcarOrderCheckRequest.AddressInfo obj6 = new AlitripRentcarOrderCheckRequest.AddressInfo();
    obj6.setAddress("阿里巴巴");
    obj6.setLongitude("116.123");
    obj6.setLatitude("116.123");
    obj2.setPickUpAddr(obj6);
    obj2.setIsPickOffOnDoor(false);
    AlitripRentcarOrderCheckRequest.AddressInfo obj7 = new AlitripRentcarOrderCheckRequest.AddressInfo();
    obj7.setAddress("阿里巴巴");
    obj7.setLongitude("116.123");
    obj7.setLatitude("116.123");
    obj2.setPickOffAddr(obj7);
    obj2.setThirdExtInfos("第三方扩展信息");
    req.setCarUseInfo(obj2);
    AlitripRentcarOrderCheckRequest.TravellerInfo obj8 = new AlitripRentcarOrderCheckRequest.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);
    AlitripRentcarOrderCheckRequest.ContactorInfo obj9 = new AlitripRentcarOrderCheckRequest.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<AlitripRentcarOrderCheckRequest.PromotionDetail> list11 = new ArrayList<AlitripRentcarOrderCheckRequest.PromotionDetail>();
    AlitripRentcarOrderCheckRequest.PromotionDetail obj12 = new AlitripRentcarOrderCheckRequest.PromotionDetail();
    list11.add(obj12);
    obj12.setId("1223");
    obj12.setName("优惠信息名称");
    obj12.setDesc("优惠活动的描述");
    obj12.setCouponValue(3000L);
    obj12.setInvestor(1L);
    req.setPromotionDetails(list11);
    req.setCardTag("2");
    req.setRentCardAttrMap("{\"cardOrderId\":\"132798776633334\",\"basicRentFee\":\"138.38\",\"cardId\":\"jfefew*&65fe#\",\"cardTradeNo\":\"2088993232232\",\"basicServiceFee\":\"50\",\"poundageFee\":\"20.01\"}");
    AlitripRentcarOrderCheckResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <errorInfo>
        <errCode>1001</errCode>
        <errMessage>错误信息</errMessage>
        <subErrCode>-2</subErrCode>
        <subErrMessage>子错误信息</subErrMessage>
    </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

    返回
    顶部