文档中心 > API类目 > 度假-签证管理API

alitrip.travel.visa.renovation.update (港澳签注订单状态同步接口)

港澳签注订单状态同步接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
applicants VisaRenovationApplicantInfo [] 必须
  • 最大列表长度:20
  • 必填,申请人签注列表。
    • └ apply_id
    • String
    • 必须
    • 122
    • 必填,申请人id
    • └ pass
    • Boolean
    • 可选
    • true
    • 已废弃。审核是否通过
    • └ refuse_reason
    • String
    • 可选
    • 不合规
    • 特殊必填,终止办理 的情况下(oper_type为99),必须填写拒绝原因。
    • └ post_number
    • String
    • 可选
    • 22222
    • 特殊必填,物流单编号,当操作类型为6时必填
    • └ refund_visa_fee
    • Boolean
    • 可选
    • true
    • 可选,是否退回签注费用,当操作类型为4或99时必填
    • └ refund_service_fee
    • Number
    • 可选
    • 1000
    • 可选,退回的服务费金额,单位:分。当操作类型为4或99时必填
    oper_type Number 必须 1 必填,操作类型:1、审核通过,2、揽收预约,3、送交公安局,4、签注失败、5、投递预约(证件寄回给买家),6、投递成功(买家已收到证件),99、终止办理
    order_id String 必须 1234 必填,主订单id

    响应参数

    名称 类型 示例值 描述
    update_result VisaRenovationUpdateResult 签注更新结果
    • └ is_success
    • Boolean
    • true
    • 订单状态更新是否成功。如果更新失败,详见e_code和e_msg描述
    • └ error_code
    • String
    • -1
    • 订单状态更新是否成功。如果更新失败,详见e_code和e_msg描述
    • └ error_msg
    • String
    • 操作失败详细描述
    • 操作失败详细描述

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelVisaRenovationUpdateRequest req = new AlitripTravelVisaRenovationUpdateRequest();
    List<AlitripTravelVisaRenovationUpdateRequest.VisaRenovationApplicantInfo> list2 = new ArrayList<AlitripTravelVisaRenovationUpdateRequest.VisaRenovationApplicantInfo>();
    AlitripTravelVisaRenovationUpdateRequest.VisaRenovationApplicantInfo obj3 = new AlitripTravelVisaRenovationUpdateRequest.VisaRenovationApplicantInfo();
    list2.add(obj3);
    obj3.setApplyId("122");
    obj3.setPass(true);
    obj3.setRefuseReason("不合规");
    obj3.setPostNumber("22222");
    obj3.setRefundVisaFee(true);
    obj3.setRefundServiceFee(1000L);
    req.setApplicants(list2);
    req.setOperType(1L);
    req.setOrderId("1234");
    AlitripTravelVisaRenovationUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_visa_renovation_update_response>
        <update_result>
            <is_success>true</is_success>
            <error_code>-1</error_code>
            <error_msg>操作失败详细描述</error_msg>
        </update_result>
    </alitrip_travel_visa_renovation_update_response>

    异常示例

    • 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

    返回
    顶部