普通签证订单的申请人进度推进接口,用于商家代用户填写申请人基本信息 或 推进单个申请人的签证进度。
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
applicant_infos | NormalVisaApplicantInfo [] | 可选 |
|
特殊必填,申请人基本信息(证件号,姓名,手机号)列表。当operType为1或2或4时必填 | |||||||||||||
|
|||||||||||||||||
applicant_op | NormalVisaApplicantOperation | 可选 | 特殊必填,签证申请人进度推进操作(目前只支持对单个申请人状态进行推进)。当operType为3时必填 | ||||||||||||||
|
|||||||||||||||||
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 [] | 可选 |
|
特殊必填,更多材料 | |||||||||||||
|
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
update_result | Boolean | true | 申请人状态更新是否成功 |
applicants | NormalVisaApplicantInfo [] | 该订单上已经上传的申请人列表信息 | |
|
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 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 | 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\"}" ); obj4.setSignResult( "10" ); 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()); |
1 2 3 4 5 6 7 8 9 | < 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 > |
1 2 3 4 5 6 | < 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 | 当前订单有未处理完的退款单 | 当前订单有未处理完的退款单,请确认当前订单未处理完的退款单后,再调用该接口。 |