---
schema: "hl-changelog/v2"
ticket: "8515"
title: "供应商注册提交：未绑定企业微信的管理员立即返回 395020"
consumer: "admin"
author: "lc(GIT)"
change_type: "修改接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "not_required"
frontend_owner: ""
frontend_ref: ""
target_release: ""
verified_at: ""
status_note: "只新增一种失败返回，前端按现有方式展示 message 即可"
updated_at: "2026-09-29"
base: "dev-v3"
---

# 供应商: 注册提交未绑定企业微信时立即返回失败

> **服务**: hl-resource-service
> **PR**: #8535
> **Issue**: #8515
> **日期**: 2026-09-29
> **影响范围**: 管理端供应商「提交审批」（注册审批）

---

## ⚠️ 关键变化

- 以前：未绑定企业微信的管理员提交注册审批，接口先返回成功、供应商转「注册审核中」，随后后台建企业微信审批单失败，审批记录落「建单失败」，自动重提 4 次后才退回草稿。
- 现在：注册审批走企业微信时，接口当场返回 `395020`「当前账号未绑定企业微信，请先绑定企业微信后再提交」，供应商保持提交前状态，不产生审批记录，也不自动重提。

---

## 二、变更接口清单

| # | 接口 | 方法 | 路径 | 变更类型 | 说明 |
|---|------|------|------|----------|------|
| 1 | 提交供应商注册审批 | POST | `/admin/supplier/items/{supplierId}/submit` | 新增一种失败返回 | 提交人未绑定企业微信时返回 395020 |

---

## 三、接口详情

### 1. 提交供应商注册审批 `POST /admin/supplier/items/{supplierId}/submit`

**VO**: `SupplierSubmitReqVO` → `SupplierApprovalCommandRespVO`

#### 使用场景

管理员把草稿供应商提交注册审批。

#### 入参

| 字段 | 位置 | 类型 | 必填 | 约束 | 说明 |
|------|------|------|------|------|------|
| supplierId | Path | Long | ✅ | 正整数 | 草稿供应商 ID |
| expectedUpdateTime | Body | String | ✅ | `yyyy-MM-dd HH:mm:ss` | 乐观锁，取详情里的 updateTime |
| 其余注册资料字段 | Body | - | - | 同现有提交接口 | 本次未改 |

#### 出参 `Result<SupplierApprovalCommandRespVO>`

| 字段 | 类型 | 说明 |
|------|------|------|
| approvalLogId | String | 审批记录 ID |
| requestNo | String | 幂等请求号 |
| provider | String | 审批方式，企业微信为 `WECOM` |
| approvalStatus | String | 审批状态，提交后为 `PENDING` |
| approvalStatusName | String | 审批状态中文名 |
| spNo | String | 企业微信审批单号，异步建单完成前为空 |
| syncStatus | String | 同步状态 |
| submittedAt | String | 提交时间 |

本次出参不变。

#### 请求示例

```json
{
  "expectedUpdateTime": "2026-09-29 17:30:00",
  "fullName": "额尔古纳市室韦镇界河木刻楞民宿有限公司"
}
```

#### 响应示例

```json
{
  "code": 200,
  "message": "成功",
  "data": {
    "approvalLogId": "2104890000000000001",
    "provider": "WECOM",
    "approvalStatus": "PENDING",
    "approvalStatusName": "审核中",
    "syncStatus": "REQUESTING"
  },
  "success": true
}
```

#### 空数据 / 降级响应

本接口没有空数据。用户服务暂不可用、查不到提交人时不拦截，照原流程进入审批，由后台建单时再检查绑定。

```json
{ "code": 200, "data": { "provider": "WECOM", "approvalStatus": "PENDING" }, "success": true }
```

#### 错误响应

```json
{
  "code": 395020,
  "message": "当前账号未绑定企业微信，请先绑定企业微信后再提交",
  "success": false,
  "data": null
}
```

#### 业务边界

- 校验顺序：登录与写权限 → 企业微信绑定 → 信用定级权限（请求带信用定级时）→ 资料校验 → 重名确认 → 进入审批。没有基础写权限时仍先返回原有权限错误；带信用定级但没有该权限、又未绑定企业微信时，先返回 395020。
- 「未绑定」指提交人管理员账号上的企业微信 ID 为空。
- 只在资源服务启动时按企业微信审批装配（`supplier.approval.provider=WECOM`）时校验；本地自动审批模式不校验。
- 查不到管理员或用户服务暂不可用时不拦截，照原流程进入审批，由后台建单时再检查绑定。
- 返回 395020 时零写入：供应商状态、资料、审批记录、变更记录都不变，也不会自动重提。

---

## 四、契约约束与正确调用方式

### ✅ 正确 / ❌ 错误调用对照

| 场景 | 结果 |
|------|------|
| ✅ 已绑定企业微信的管理员提交 | 200，进入注册审核中 |
| ❌ 未绑定企业微信的管理员提交 | 395020，供应商保持原状态 |

请求体不变，没有新增或删除字段。管理员先在账号上绑定企业微信，再重新提交即可。

---

## 五、数据库行为

| 场景 | 供应商状态 | 审批记录 | 变更记录 |
|------|-----------|----------|----------|
| 未绑定，返回 395020 | 不变 | 不新增 | 不新增 |
| 已绑定，提交成功 | 注册审核中 | 新增一条 | 同改前 |

---

## 六、边界行为

- 已绑定企业微信的管理员：流程不变，照常进入注册审核中并创建企业微信审批单。
- 提交后才解绑的：仍由后台建单时的检查拦下（原有「建单失败」逻辑不变）。

## 六.6、修改前后对比

### 行为级对比

| 行为 | 改前 | 改后 |
|------|------|------|
| 未绑定企业微信的管理员提交注册审批 | 返回成功，随后落「建单失败」并自动重提，约 2 分钟后退回草稿 | 当场返回 395020，供应商保持原状态 |
| 已绑定企业微信的管理员提交注册审批 | 进入注册审核中 | 不变 |

## 六.7、影响评估

- **是否破坏向后兼容**: 否（只新增一种失败返回）
- **前端是否必须同步上线**: 否
- **前端 workaround 清理点**: 无

## 七、不影响范围

- **仅影响**: 供应商注册「提交审批」接口
- **零影响**:
  - 供应商状态变更审批（暂停、拉黑等）、合作中资料变更审批
  - 用户服务建企业微信审批单的原有检查
  - 395020 在状态变更审批中的原有文案「当前账号未绑定企业微信」

---

## 八、测试环境已验证

TEST 已部署合并提交 `41bc1be10`，经 Gateway 实测：

```
管理员未绑定企业微信 → POST /admin/supplier/items/{SUP260106}/submit → 395020「当前账号未绑定企业微信，请先绑定企业微信后再提交」，约 3 秒返回 ✓
被拦后：供应商仍为草稿、资料未改写、审批记录和变更记录都不新增，130 秒后仍无自动重提 ✓
管理员已绑定企业微信 → POST /admin/supplier/items/{SUP260103}/submit → 200，provider=WECOM，进入注册审核中并生成企业微信审批单 ✓
```

---

## 十、相关文档

- 关联 Issue: [wx/HL#8515](https://git.1814.love/wx/HL/issues/8515)
- 关联 PR: [wx/HL#8535](https://git.1814.love/wx/HL/pulls/8535)

## 关联 / 联系人

### 链接

- **Issue**: [#8515](https://git.1814.love/wx/HL/issues/8515)
- **PR**: [#8535](https://git.1814.love/wx/HL/pulls/8535)
- **Merge commit**: [41bc1be10](https://git.1814.love/wx/HL/commit/41bc1be10)

### 联系人

- **后端负责人**: @lc