文档中心 > API类目 > 度假&门票-交易管理API

alitrip.travel.visa.applicant.update (飞猪度假-普通签证-申请人进度推进接口)

普通签证订单的申请人进度推进接口,用于商家代用户填写申请人基本信息 或 推进单个申请人的签证进度。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sub_order_id String 必须 1234456 必填,子订单id
oper_type Number 必须 1 必填,操作类型。1-上传新申请人基本信息(商家代填申请人),2-更新已有申请人基本信息,3-更新已有申请人的签证进度,4-商家代传申请人信息和材料(使馆直连订单)
applicant_infos NormalVisaApplicantInfo [] 可选
  • 最大列表长度:50
  • 特殊必填,申请人基本信息(证件号,姓名,手机号)列表。当operType为1或2或4时必填
    • └ apply_id
    • String
    • 可选
    • 123
    • 可选,申请人ID。更新申请人基本信息时必填,新增申请人信息时不用填
    • └ surname
    • String
    • 可选
    • 姓,新增申请人时必填
    • └ given_name
    • String
    • 可选
    • 名,新增申请人时必填
    • └ mobile
    • String
    • 可选
    • 13777777777
    • 手机号,新增申请人时必填
    • └ cert_no
    • String
    • 可选
    • E23242
    • 证件号(护照、入台证等),新增申请人时必填
    • └ user_type
    • Number
    • 可选
    • 16
    • 办理人身份类型(8-在职人员,9-自由职业,10-在校学生,11-退休人员,12-学龄年儿童,13-所有申请者,14-单个成年人,15-随行直系亲属,16-在读学生)
    • └ apply_name_cn
    • String
    • 可选
    • 张三
    • 办理人中文全名
    applicant_op NormalVisaApplicantOperation 可选 特殊必填,签证申请人进度推进操作(目前只支持对单个申请人状态进行推进)。当operType为3时必填
    • └ apply_id
    • String
    • 可选
    • 123
    • 必填,申请人ID
    • └ status
    • Number
    • 可选
    • 1001
    • 必填,申请人状态推进,本次操作需要推进到的目标状态。具体状态值枚举及推进流程详见:https://open.alitrip.com/docs/doc.htm?spm=a21tt.7629140.0.0.fYvMkZ&docType=1&articleId=108046&previewCode=9D5F931C2254C7B3FE16B8DB7F9CECB4
    • └ remark
    • String
    • 可选
    • 商家备注
    • 可选,备注
    • logistics_info
    • NormalVisaLogisticsInfo
    • 可选
    • 特殊必填,上传该申请人 签证结果寄回物流信息。当status值为1013(已寄回结果)时,必填
    • └ post_number
    • String
    • 可选
    • 13234
    • 必填,物流号
    • └ post_company_code
    • String
    • 可选
    • xxxx
    • 必填,物流公司编码
    • └ post_company_name
    • String
    • 可选
    • 顺丰
    • 必填,物流公司名称
    • └ concat_phone
    • String
    • 可选
    • 5705
    • 选填,物流联系人手机号(顺丰物流需要)
    • eta_info
    • NormalVisaEtaInfo
    • 可选
    • 特殊必填,上传该申请人 电子签结果。当该签证为电子签证且status值为1006(已收到签证结果)时 必填
    • └ file_name
    • String
    • 可选
    • 电子签证结果
    • 必填,电子签pdf文件名称。具体的pdf文件字节流信息请设置到父级参数的 fileBytes字段!!!
    • appointment_info
    • NormalVisaAppointmentInfo
    • 可选
    • 特殊必填,上传该申请人 预约面试信息。当status值为1007(已预约面试)时 必填
    • └ book_file_name
    • String
    • 可选
    • 预约面试信
    • 必填,预约面试信pdf文件名称。具体的pdf文件字节流信息请设置到父级参数的 fileBytes字段!!!
    • └ book_time
    • String
    • 可选
    • 2018-01-01 10:00:00
    • 必填,预约时间,格式:yyyy-MM-dd hh:mm:ss
    • └ book_place
    • String
    • 可选
    • 预约地点
    • 必填,预约地点
    • └ need_modify_doc_types
    • Number []
    • 可选
    • [0,1,2]
    • 签证需补充材料,0:护照,1:证件照,2:申请表,3:身份证,4:户口本,5:暂住证,6:在职收入证明,7:营业执照,8:组织机构代码证,9:结婚证,10:个人信息处理同意书,11:退休证,12:保险订单,13:在读证明,14:机票预订证明,15:酒店预订证明,16:财力证明,17:房产证,18:汽车驾驶证,19:社保缴纳记录,20:学校准假证明,21:儿童出生医学证明,22:未成年人亲属关系证明,23:其他材料,24:银行存款证明,25:学生证,26:其他材料2,27:其他材料3,28:居住证,29:车辆登记证,34:保险声明,36:出行同意书,38:职业证明,39:以往申根签证页
    • └ applicant_form_data_json
    • String
    • 可选
    • {"lastNamePinyin":"ZHANG","firstNamePinyin":"SAN","nameCh":"中文名","passportNumber":"G12345678","sex":"M","nationality":"CHN","birthday":"1900-01-01","enterDate":"2019-07-01","domesticPhoneNum":"15911111111","applicantEmail":"12@qq.com","passportValidUntil": "2022-10-01"}
    • 代填申请人信息。字段注释:1.sex(性别),值:M/F;2.nationality(国籍),值:CHN(中国大陆),HKG(中国香港),MAC(中国澳门),USA(美国),CAN(加拿大)
    file_bytes byte[] 可选 [1,1,1] 特殊必填,pdf文件字节流。用于上传电子签pdf结果 或者 预约面试信pdf文件。
    支持的文件类型:
    photo_bytes byte[] 可选 [1,1,1] 特殊必填,文件字节流,用于上传证件照,必须和photoType同时传
    支持的文件类型:
    photo_type String 可选 jpg 证件照文件类型
    passport_bytes byte[] 可选 [1,1,1] 特殊必填,文件字节流,用于上传护照,必须和passportType同时传
    支持的文件类型:
    passport_type String 可选 jpg 护照文件类型
    hotel_booking_form_type String 可选 jpg 酒店预订文件类型
    hotel_booking_form_bytes byte[] 可选 [1,1,1] 特殊必填,文件字节流,用于上传酒店预订,必须和hotelBookingFormType同时传
    支持的文件类型:
    flight_booking_form_type String 可选 png 机票预订文件类型
    flight_booking_form_bytes byte[] 可选 [1,1,1] 特殊必填,文件字节流,用于上传机票预订,必须和flightBookingFormType同时传
    支持的文件类型:

    响应参数

    名称 类型 示例值 描述
    update_result Boolean true 申请人状态更新是否成功
    applicants NormalVisaApplicantInfo [] 该订单上已经上传的申请人列表信息
    • └ apply_id
    • String
    • 12345
    • 申请人id
    • └ cert_no
    • String
    • E22323
    • 申请人护照号

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelVisaApplicantUpdateRequest req = new AlitripTravelVisaApplicantUpdateRequest();
    req.setSubOrderId("1234456");
    req.setOperType(1L);
    List<NormalVisaApplicantInfo> list2 = new ArrayList<NormalVisaApplicantInfo>();
    NormalVisaApplicantInfo obj3 = new NormalVisaApplicantInfo();
    list2.add(obj3);
    obj3.setApplyId("123");
    obj3.setSurname("张");
    obj3.setGivenName("三");
    obj3.setMobile("13777777777");
    obj3.setCertNo("E23242");
    obj3.setUserType(16L);
    obj3.setApplyNameCn("张三");
    req.setApplicantInfos(list2);
    NormalVisaApplicantOperation obj4 = new NormalVisaApplicantOperation();
    obj4.setApplyId("123");
    obj4.setStatus(1001L);
    obj4.setRemark("商家备注");
    NormalVisaLogisticsInfo obj5 = new NormalVisaLogisticsInfo();
    obj5.setPostNumber("13234");
    obj5.setPostCompanyCode("xxxx");
    obj5.setPostCompanyName("顺丰");
    obj5.setConcatPhone("5705");
    obj4.setLogisticsInfo(obj5);
    NormalVisaEtaInfo obj6 = new NormalVisaEtaInfo();
    obj6.setFileName("电子签证结果");
    obj4.setEtaInfo(obj6);
    NormalVisaAppointmentInfo obj7 = new NormalVisaAppointmentInfo();
    obj7.setBookFileName("预约面试信");
    obj7.setBookTime("2018-01-01 10:00:00");
    obj7.setBookPlace("预约地点");
    obj4.setAppointmentInfo(obj7);
    obj4.setNeedModifyDocTypes(new Long[] { 0,1,2 };
    );
    obj4.setApplicantFormDataJson("{\"lastNamePinyin\":\"ZHANG\",\"firstNamePinyin\":\"SAN\",\"nameCh\":\"中文名\",\"passportNumber\":\"G12345678\",\"sex\":\"M\",\"nationality\":\"CHN\",\"birthday\":\"1900-01-01\",\"enterDate\":\"2019-07-01\",\"domesticPhoneNum\":\"15911111111\",\"applicantEmail\":\"12@qq.com\",\"passportValidUntil\": \"2022-10-01\"}");
    req.setApplicantOp(obj4);
    req.setFileBytes(new FileItem("/tmp/file.txt"));
    req.setPhotoBytes(new FileItem("/tmp/file.txt"));
    req.setPhotoType("jpg");
    req.setPassportBytes(new FileItem("/tmp/file.txt"));
    req.setPassportType("jpg");
    req.setHotelBookingFormType("jpg");
    req.setHotelBookingFormBytes(new FileItem("/tmp/file.txt"));
    req.setFlightBookingFormType("png");
    req.setFlightBookingFormBytes(new FileItem("/tmp/file.txt"));
    AlitripTravelVisaApplicantUpdateResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_visa_applicant_update_response>
        <update_result>true</update_result>
        <applicants>
            <normal_visa_applicant_info>
                <apply_id>12345</apply_id>
                <cert_no>E22323</cert_no>
            </normal_visa_applicant_info>
        </applicants>
    </alitrip_travel_visa_applicant_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.out-system-error 外部系统异常 请稍后重试
    isv.invalid-parameter:ERROR 参数异常 根据错误提示修改
    isv.invalid-parameter:NOTNULL
    isv.visa_state_wrong
    isv.too_many_applicants
    isv.no_visa_order
    isv.order_refund_processing
    isv.system_busy
    isp.SYS_EXCEPTION
    isv.visa_hold
    isv.rights-invalid:VIEW_NOT_PERMIT 您没有权限查询此宝贝或交易 请确认您的订单号是否正确

    API工具

    如何获得此API

    FAQ

    返回
    顶部