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

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

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

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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
    • eta_info
    • NormalVisaETAInfo
    • 可选
    • 特殊必填,上传该申请人 电子签结果。当该签证为电子签证且status值为1006(已收到签证结果)时 必填
    • └ file_name
    • String
    • 可选
    • 电子签证结果
    • 必填,电子签pdf文件名称。具体的pdf文件字节流信息请设置到父级参数的 fileBytes字段!!!
    • logistics_info
    • NormalVisaLogisticsInfo
    • 可选
    • 特殊必填,上传该申请人 签证结果寄回物流信息。当status值为1013(已寄回结果)时,必填
    • └ post_number
    • String
    • 可选
    • SF1234561234563
    • 必填,物流号
    • └ post_company_code
    • String
    • 可选
    • SF
    • 必填,物流公司编码
    • └ post_company_name
    • String
    • 可选
    • 顺丰速运
    • 必填,物流公司名称
    • └ concat_phone
    • String
    • 可选
    • 5705
    • 选填,物流联系人手机号(顺丰物流需要)
    • └ remark
    • String
    • 可选
    • 商家备注
    • 可选,备注
    • └ status
    • Number
    • 可选
    • 1001
    • 必填,申请人状态推进,本次操作需要推进到的目标状态。具体状态值枚举及推进流程详见:https://open.alitrip.com/docs/doc.htm?spm=a21tt.7629140.0.0.fYvMkZ&docType=1&articleId=108046&previewCode=9D5F931C2254C7B3FE16B8DB7F9CECB4
    • 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
    • String []
    • 可选
    • [0,1,2]
    • 签证需补充材料(即状态为1012)时必填,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(加拿大)
    oper_type Number 必须 1 必填,操作类型。1-上传新申请人基本信息(商家代填申请人),2-更新已有申请人基本信息,3-更新已有申请人的签证进度,4-商家代传申请人信息和材料(使馆直连订单)
    sub_order_id String 必须 1234456 必填,子订单id
    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同时传
    document_infos NormalVisaDocumentInfo [] 可选
  • 最大列表长度:20
  • 特殊必填,更多材料
    • └ doc_type
    • Number
    • 可选
    • 0
    • 文档编号,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:以往申根签证页
    • └ file_type
    • String
    • 可选
    • jpg
    • 文件类型
    • └ file_content
    • String
    • 可选
    • +EABwAHAA0AFgAgYWNzcEFQUEwAAAAAQVBQTAAAAAAAAAAAAAAAAAAAAAAAAPbWAAEAAAAA0y1hcHBsyhqVgiV
    • base64编码的文件内容
    • sub_document_infos
    • NormalVisaSubDocumentInfo []
    • 可选
    • 特殊必填,上传子材料,如上传护照封面
    • └ doc_type
    • Number
    • 可选
    • 10001
    • 子材料文档编号,10001:护照封面,10002:护照首页,11401:去程机票,11402:返程机票
    • └ file_type
    • String
    • 可选
    • jpg
    • 文件类型
    • └ file_content
    • String
    • 可选
    • +EABwAHAA0AFgAgYWNzcEFQUEwAAAAAQVBQTAAAAAAAAAAAAAAAAAAAAAAAAPbWAAEAAAAA0y1hcHBsyhqVgiV
    • base64编码的文件内容

    响应参数

    名称 类型 示例值 描述
    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();
    List<AlitripTravelVisaApplicantUpdateRequest.NormalVisaApplicantInfo> list2 = new ArrayList<AlitripTravelVisaApplicantUpdateRequest.NormalVisaApplicantInfo>();
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaApplicantInfo obj3 = new AlitripTravelVisaApplicantUpdateRequest.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);
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaApplicantOperation obj4 = new AlitripTravelVisaApplicantUpdateRequest.NormalVisaApplicantOperation();
    obj4.setApplyId("123");
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaETAInfo obj5 = new AlitripTravelVisaApplicantUpdateRequest.NormalVisaETAInfo();
    obj5.setFileName("电子签证结果");
    obj4.setEtaInfo(obj5);
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaLogisticsInfo obj6 = new AlitripTravelVisaApplicantUpdateRequest.NormalVisaLogisticsInfo();
    obj6.setPostNumber("SF1234561234563");
    obj6.setPostCompanyCode("SF");
    obj6.setPostCompanyName("顺丰速运");
    obj6.setConcatPhone("5705");
    obj4.setLogisticsInfo(obj6);
    obj4.setRemark("商家备注");
    obj4.setStatus(1001L);
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaAppointmentInfo obj7 = new AlitripTravelVisaApplicantUpdateRequest.NormalVisaAppointmentInfo();
    obj7.setBookFileName("预约面试信");
    obj7.setBookTime("2018-01-01 10:00:00");
    obj7.setBookPlace("预约地点");
    obj4.setAppointmentInfo(obj7);
    obj4.setNeedModifyDocTypes("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.setOperType(1L);
    req.setSubOrderId("1234456");
    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"));
    List<AlitripTravelVisaApplicantUpdateRequest.NormalVisaDocumentInfo> list9 = new ArrayList<AlitripTravelVisaApplicantUpdateRequest.NormalVisaDocumentInfo>();
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaDocumentInfo obj10 = new AlitripTravelVisaApplicantUpdateRequest.NormalVisaDocumentInfo();
    list9.add(obj10);
    obj10.setDocType(0L);
    obj10.setFileType("jpg");
    obj10.setFileContent("+EABwAHAA0AFgAgYWNzcEFQUEwAAAAAQVBQTAAAAAAAAAAAAAAAAAAAAAAAAPbWAAEAAAAA0y1hcHBsyhqVgiV");
    List<AlitripTravelVisaApplicantUpdateRequest.NormalVisaSubDocumentInfo> list13 = new ArrayList<AlitripTravelVisaApplicantUpdateRequest.NormalVisaSubDocumentInfo>();
    AlitripTravelVisaApplicantUpdateRequest.NormalVisaSubDocumentInfo obj14 = new AlitripTravelVisaApplicantUpdateRequest.NormalVisaSubDocumentInfo();
    list13.add(obj14);
    obj14.setDocType(10001L);
    obj14.setFileType("jpg");
    obj14.setFileContent("+EABwAHAA0AFgAgYWNzcEFQUEwAAAAAQVBQTAAAAAAAAAAAAAAAAAAAAAAAAPbWAAEAAAAA0y1hcHBsyhqVgiV");
    list11.setSubDocumentInfos(list13);
    req.setDocumentInfos(list9);
    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.rights-invalid:VIEW_NOT_PERMIT 您没有权限查询此宝贝或交易 请确认您的订单号是否正确
    isv.APPLICANT_UPDATE_PARAM_ERROR 申请人数据更新异常 错误内容为"更新需补充材料时,needModifyDocTypes 字段必填"时,则为1012状态时,需要填写对应材料类型列表在needModifyDocTypes。 其他错误场景请根据详细错误内容进行排查。
    isp.SYSTEM_ERROR 系统异常 请联系开发小二排查问题
    isp.SYSTEM_BUSY 系统繁忙异常 请减少调用频率,如果重复出现该问题请联系开发小二排查问题。
    isp.SYSTEM_LOCK 并发锁更新异常 在并发使用写接口时,会对本次接口的业务主键进行加锁(如:订单id、履约单id等),出现这种问题由调用方控制调用频率,如果在极端场景下出现并发情况由调用方根据业务场景选择是否重试。
    isp.SYSTEM_TIME_OUT 系统超时异常 一般由于网络抖动导致接口调用超时,请在调用端重试接口,如果重复出现该问题请联系开发小二排查问题。
    isp.DATEBASE_UPDATE_ERROR 数据库更新异常 在并发使用写接口时,可能会造成更新数据乐观锁失败,出现这种问题由调用方控制调用频率,如果重复出现该问题请联系开发小二排查问题。
    isv.PDF_TRANSFER_TIME_OUT PDF转换超时 一般由于网络抖动导致接口调用超时,请在调用端重试接口,如果重复出现该问题请联系开发小二排查问题。
    isv.APPLICATION_FORM_NOT_READY 申请表材料没有准备好 申请表材料没有准备好,请检查对应申请表材料是否已准备完成。
    isv.PASSPORT_NOT_READY 护照材料没有准备好 护照材料没有准备好,请检查对应申请表材料是否已准备完成。
    isv.PHOTO_NOT_READY 证件照材料没有准备好 证件照材料没有准备好,请检查对应证件照材料是否已准备完成。
    isv.FLIGHT_NOT_READY 机票预定证明材料没有准备好 机票预定证明材料没有准备好,请检查对应机票预定证明材料是否已准备完成。
    isv.HOTEL_NOT_READY 酒店预定证明材料没有准备好 酒店预定证明材料没有准备好,请检查对应酒店预定证明材料是否已准备完成。
    isv.APPLICATION_FORM_INVALID_ERROR 申请表出现错误 申请表出现错误,一般由于申请表的字段参数出现校验异常,如手机号、电子邮箱、家庭住址、护照号码、出生日期、签发日期等校验问题,可以根据对应异常文案排查并解决错误。
    isv.TOO_MANY_APPLICANTS 添加办理人数量超过购买数量 添加办理人数量超过购买数量出现异常,请控制办理人数量不超过购买数量。
    isv.APPLICANTS_HOLDING 当前申请人处于暂停办理状态,不允许更新进度 当前申请人处于暂停办理状态,请先检查对应申请人的办理状态再重试调用接口。
    isv.INTERVIEW_TOO_EARLY 预约的面试时间早于当前时间 预约的面试时间早于当前时间异常,请控制面试时间不早于当前时间。
    isv.APPLICANT_STATE_WRONG 申请人状态更新异常 对应申请人状态推动异常。 在线办理请参考:https://open.alitrip.com/docs/doc.htm?docType=1&articleId=121242#s0
    isv.PROCESS_PUSH_ERROR 流程节点推动异常 流程节点推动异常,请详细参考对接文档进行排查。
    isv.PDF_TRANSFER_ERROR PDF转换异常 请联系开发小二排查问题。
    isv.APPLICANT_UNDEFINED 申请人不存在 申请人不存在,一般由于参数传递异常或对应申请人不存在,请先检查参数是否正确,如果对应申请人存在且仍然返回该异常,请联系开发小二。
    isv.ORDER_UNDEFINED 订单不存在或已进入历史库 订单不存在,一般由于参数传递异常或订单已进入历史库,请先检查参数是否正确,如果订单号正确且仍然返回该异常,请联系开发小二。
    isv.VISA_APPLY_ONLINE_UNDEFINED 签证办理单不存在 签证办理单不存在,一般由于参数传递异常或签证办理单不存在,请先检查参数是否正确,如果签证办理单号正确且仍然返回该异常,请联系小二排查。
    isv.BUYER_ORDER_QUERY_ERROR 买家订单查询异常 买家订单查询异常,请检查参数是否正确,如果参数正确并且重复出现该异常,请联系小二排查。
    isv.PAYMENT_TASK_CANCEL_FAILED 打款任务取消失败 打款任务取消失败,请检查参数是否正确,如果参数正确并且重复出现该异常,请联系小二排查。
    isv.ONLINE_VISA_ORDER_UPDATE_ERROR 在线签证订单更新失败 在线签证订单更新失败,一般由于当前签证订单为在线办理模式,请按照对接文档更新在线签证订单,如果参数正确且仍返回该异常,请联系小二排查。
    isv.ONLINE_VISA_ORDER_OFFLINE_ERROR 在线化订单切线下失败 在线化订单切线下失败,请检查参数是否正确,如果参数正确且仍返回该异常,请联系小二排查。
    isv.ONLINE_VISA_ORDER_SELLER_FILL_ERROR 在线化订单商家代填失败 在线化订单商家代填失败,请检查参数是否正确,如果参数正确且仍返回该异常,请联系小二排查。
    isv.ORDER_REFUND_PROCESSING 当前订单有未处理完的退款单 当前订单有未处理完的退款单,请确认当前订单未处理完的退款单后,再调用该接口。

    API工具

    如何获得此API

    FAQ

    返回
    顶部