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

qimen.alitrip.rentcar.order.cancel (租车订单取消接口)

当飞猪用户取消一笔租车订单时,同步取消服务商对应的订单,两种场景:1.用户取消订单,2接单超时平台认为商家接单失败,商家成功的情况调用此场景没有商家订单ID

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
traceId String 必须 12344 本次请求的标识
isPressureTest Boolean 可选 false
  • 默认值:false
  • 是否压测流量,默认false
    channelId String 可选 20010 渠道id
    channelName String 可选 赫兹 渠道名称
    orderId Number 可选 12344 飞猪订单订单号
    outOrderId String 可选 11111 商家订单号
    cancelType Number 可选 1 订单取消类型
    cancelMessage String 可选 不想要了 订单取消说明
    cancelTime String 可选 2017-05-22 11:11:11 订单取消时间
    firstName String 可选 zhang 赫兹租车使用,用车人姓名,英文
    lastName String 可选 san 赫兹租车使用,用车人姓名,英文
    hertzSupplierCode String 可选 ZE 赫兹租车使用,赫兹供应商code。ZE-赫兹,ZR-道乐,ZT-苏立夫提
    useTestData Boolean 可选 true 是否调用服务商测试环境数据。true:调用服务商测试环境,false:调用服务商线上正式环境
    exts String 可选 扩展字段 { "flightOrder":"1", "cancelReason":"航班延误", "refundFee":"20.08" }

    响应参数

    名称 类型 示例值 描述
    success Boolean true 接口调用是否成功
    orderId String 12344 飞猪订单id
    outOrderId String 1212 外部商家订单号
    cancelStatus String 取消中 订单取消状态说明
    cancelStatusCode Number 1 租车业务,订单取消状态,1-取消成功,2-取消中,3-取消失败,需人工处理
    errorInfo ErrorInfo 错误信息
    • └ code
    • String
    • 1001
    • 自定义错误码。1001:商家接口 系统异常。2001:商家接口 业务异常。3001:uac内部系统异常。4001:uac业务校验异常。
    • └ message
    • String
    • 错误信息
    • 自定义错误信息。记录各链路错误详细描述,以“|”分隔,如:商家接口出现系统异常/业务错误(uac)|商家具体错误描述。
    • └ subCode
    • String
    • -1
    • 子错误码
    • └ subMessage
    • String
    • 子错误信息
    • 子错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripRentcarOrderCancelRequest req = new AlitripRentcarOrderCancelRequest();
    req.setTraceId("12344");
    req.setIsPressureTest(false);
    req.setChannelId("20010");
    req.setChannelName("赫兹");
    req.setOrderId(12344L);
    req.setOutOrderId("11111");
    req.setCancelType(1L);
    req.setCancelMessage("不想要了");
    req.setCancelTime("2017-05-22 11:11:11");
    req.setFirstName("zhang");
    req.setLastName("san");
    req.setHertzSupplierCode("ZE");
    req.setUseTestData(true);
    req.setExts("扩展字段");
    AlitripRentcarOrderCancelResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <success>true</success>
    <orderId>12344</orderId>
    <outOrderId>1212</outOrderId>
    <cancelStatus>取消中</cancelStatus>
    <cancelStatusCode>1</cancelStatusCode>
    <errorInfo>
        <code>1001</code>
        <message>错误信息</message>
        <subCode>-1</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>

    错误码解释

    错误码 错误描述 解决方案
    -1 根据错误提示修改 根据错误提示修改
    sign-check-failture 根据错误提示修改 根据错误提示修改
    2001 根据错误提示修改 根据错误提示修改
    4001 根据错误提示修改 根据错误提示修改
    isv.PARAM_ERROR 参数异常 根据错误提示修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部