同步签证申请单
同步签证申请单
- 本接口用于将企业自有审批系统中的签证申请单同步至差旅平台，同租户下申请单号不可重复，且仅接受已审批通过的申请单，待审批状态的申请单请勿同步。
- 如需变更已同步的申请单，可再次调用本接口，系统将按单号对全部信息进行覆盖更新，每次同步需传全量数据，不支持增量同步。
- 对于申请人及办签人中的企业员工，需确保其已在慧通系统中维护并处于有效状态，外部客户不校验。
- 申请单中的受益信息（包括部门、项目及成本中心）系统不会自动创建，也不校验其是否存在，调用方需自行保证相关信息的准确性。
基本信息
请求方式：POST
请求地址：/napi/enterprise/approval/visa/sync
请求参数定义
| 参数名 | 参数说明 | 必选 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| msgId | 消息id | Y | String | 128 | 1000120150511190411000001 | 企业编码+消息方向+YYYYMMDDHHMMSS+NNNNNN |
| corpCode | 企业账号 | Y | String | 50 | 1000 | 企业账号 |
| tenantUserId | 租户用户id | Y | String | 200 | HW_000001 | 申请人租户用户id |
| outApprovalNo | 外部审批单号 | Y | String | 128 | HW20230423154622 | 企业自有审批单号 |
| applyTime | 申请时间 | N | String | 14 | 20241123154622 | yyyyMMddHHmmss，默认当前时间 |
| approveTime | 审批时间 | N | String | 14 | 20241123164622 | yyyyMMddHHmmss，默认当前时间 |
| remark | 出访详情说明 | N | String | 1000 | 客户现场签证 | |
| extendInfo | 扩展字段 | N | String | 5120 | {"字段1":"值1"} | 扩展字段-JsonObject |
| travellerList | 办签人列表 | Y | [VisaTraveller] | 1 | 当前仅限1人 | |
| destinationList | 目的国家列表 | Y | [VisaDestination] | 1 | 当前仅限1个 | |
| visaType | 签证类型 | Y | String | 50 | BUSINESS | TRANSIT:过境签 JINMEN:入金签 FAMILY:探亲访友签 MEDICAL:医疗签 WORK:工作签 TOURIST:旅游签 BUSINESS:商务签 STUDENT:留学签 VISIT:访问签 EXHIBITION:展会签 RE_ENTRY:再入境签 ETA:ETA |
| serviceTypeList | 服务列表 | N | [String] | 20 | ["URGENT"] | URGENT:加急 |
| benefitList | 受益信息 | N | [VisaBenefit] | 200 |
VisaTraveller
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| tenantUserId | 租户用户id | N | String | 200 | HW_000001 | 企业员工必填，外部客户不填 |
| name | 姓名 | Y | String | 100 | 李某 | |
| extendInfo | 扩展信息 | N | String | 5120 | {"data":"123"} | JSON串，企业定制扩展信息 |
VisaDestination
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| countryId | 国家/地区ID | Y | String | 3 | 156 | Itravel系统国家码 |
| beginDate | 出行开始日期 | Y | String | 8 | 20241123 | yyyyMMdd |
| endDate | 出行结束日期 | Y | String | 8 | 20241223 | yyyyMMdd |
VisaBenefit
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| benefitType | 受益类型 | Y | String | 50 | COST_CENTER | COST_CENTER:成本中心 PROJECT:项目 DEPARTMENT:部门 |
| costcenterCode | 成本中心编码 | N | String | 200 | 5678 | |
| costcenterName | 成本中心名称 | N | String | 200 | ||
| projectCode | 项目编码 | N | String | 200 | 1234 | |
| projectName | 项目名称 | N | String | 200 | ||
| departmentNo | 部门编号 | N | String | 50 | 1234 | |
| departmentName | 部门名称 | N | String | 200 | ||
| percentage | 分摊比例 | Y | String | 3 | 50 | 1-100的整型数字，所有受益分摊比例相加必须等于100 |
| extendInfo | 扩展信息 | N | String | 5120 | {"data":"123"} | JSON串，企业定制扩展信息 |
响应参数定义
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| resultCode | 返回码 | Y | String | 0 | 0表示成功，其他值为失败。 | |
| description | 描述 | Y | String | 操作成功 | 描述信息，出错时为错误信息即错误原因。 | |
| data | 数据 | N | Result |
Result
| 参数名 | 参数说明 | 必填 | 参数类型 | 长度 | 值举例 | 备注 |
|---|---|---|---|---|---|---|
| approvalNo | 慧通审批单号 | Y | String | 12 | TA0612179607 |
样例
请求
{
"msgId": "0008120260618071248283828",
"corpCode": "0008",
"tenantUserId": "26215236521",
"outApprovalNo": "VISA20260618001",
"applyTime": "20260618100000",
"approveTime": "20260618110000",
"remark": "赴日商务签证",
"extendInfo": "{\"responsibilityCenter\":\"001\",\"responsibilityCode\":\"002\"}",
"travellerList": [
{
"tenantUserId": "HW_000001",
"name": "李某",
"extendInfo": "{\"certNo\":\"E12345678\"}"
}
],
"destinationList": [
{
"countryId": "392",
"beginDate": "20260701",
"endDate": "20260715"
}
],
"visaType": "BUSINESS",
"serviceTypeList": ["URGENT"],
"benefitList": [
{
"benefitType": "COST_CENTER",
"costcenterCode": "5678",
"costcenterName": "成本中心A",
"departmentNo": "cc123",
"departmentName": "部门A",
"percentage": "100"
}
]
}
返回
{
"resultCode": "0",
"description": "操作成功",
"data": {
"approvalNo": "TA0612179607"
}
}