# 返利中心页面流程

写代码以本文为准。

---

## 环境

- 地址：`http://192.168.170.144:8001`
- 菜单：采购协议管理
- 登录账号走本机 `rpa_rebate/.env`
- 合同号用合同系统号，例：`035012026101035440`
- 细单货品：点「货品编码」三个点，弹窗里用表 3 / 接口 3 的 `goodsId` 搜
- 计划员：先点进选择框，默认选「廖建琦」，不要选计划员 ID。后期再改回订单中心计划员
- 联系人：选择框，选第二条「苏文辉」
- 承付模式：方案「下月 N 号结」
- 承付参数：总单、细单都填 `25`（vxe 数字框，键盘输入）
- 协议开始、协议结束：当天
- 细单备注 = 订单号（`oms_id`）
- 特定补偿预估值 = 0
- 进货补偿预估值 = 0
- 搜不到合同：不重录合同，留给下一班
- 送审成功才写表 4：`actionCode=2`、`agreementStatus=1`，带上 **协议总单ID** / **协议细单ID**

---

## 整班顺序

1. 打开返利中心，登录，进采购协议管理
2. 按合同号查号，表里出现该号才算搜到
3. 勾中该合同已有总单（审批通过后返利中心已有一条，不要点新增总单）
4. 补总单必填（卡片仍在「编辑」）→ 总单工具栏保存 → 再点卡片「确认 Ctrl + Enter」→ 读「协议总单ID」
5. 该总单下多次点细单「新增」，按货品 ID 搜品种；每条卡片点货品卡「确认 Ctrl + Enter」落到货品表；**所有细单都确认完再点货品工具栏保存**
6. 总单工具栏点送审（细单必须已保存）
7. 送审成功才落表 4。同一合同一组一个结果。

细单只走页面「新增 + 货品编码三个点 + 按货品ID搜」。Excel 下模板上传不做。班次入口 `run_batch.py`。

---

## 1 查号

1. 打开查询
2. 合同编号填合同系统号
3. 点查询
4. 关查询弹层用 **X / Esc**，不要点「取消」（会清掉合同编号筛选）
5. 总单表 `.table-show` 里「合同编号」列等于该号，点左侧固定列勾选框
6. 禁止拿第一行，禁止拿 `CG-` 号凑合
7. 勾中总单后，货品区才出「新增」
8. 表里出现该合同号才算搜到；输入框回显不算

合同审批通过后，返利中心已经有一条总单，直接在那条上操作，不要新增总单。打开后仍要补表头必填；供应商要点三个点进选择框。

---

## 2 总单

1. 先按合同编号勾中总单行
2. 打开总单：点「编辑」或双击行，哪个方便用哪个。不要点「新增」总单
3. 带星号都要填
4. 供应商：点「供应商编码」三个点，打开选择框，用表 3 的 `supplier_mdm_code` 搜，对上编码那一列，确认选中。选中后会带出供应商名称、返利单位等，不要手填这些带出项。名称和编码不要填反
5. 选对供应商时不应弹出「货源选择」；若弹出，停下问
6. 计划员：进选择框，先默认选「廖建琦」，不要选计划员 ID。后期再改
7. 联系人：进选择框，选第二条「苏文辉」
8. 采购结算方式：可筛选下拉，先输入「电汇」，再精确点「电汇」，不要点「电汇—非直联」
9. 承付模式：「下月N号结」。承付参数填 `25`（数字框，键盘输入；不要填「以销售定结」）
10. 卡片还在「编辑」时点总单工具栏「保存」，再点卡片「确认 Ctrl + Enter」。先确认会把卡收回表格，保存落不到库
11. 保存后总单号认 **协议总单ID**

### 2.1 总单字段

| 页面字段 | 怎么填 | 从哪来 |
| --- | --- | --- |
| 供应商编码 | 三个点打开选择框，用 `supplier_mdm_code` 搜，确认选中那条 | 表 3 |
| 供应商名称 | 不填，选供应商后带出 | 带出 |
| 返利单位编码 | 不填，选供应商后带出 | 带出 |
| 计划员 | 选择框先选「廖建琦」，不要选计划员 ID；后期再改 | 本账号，后期改 |
| 联系人 | 选择框选第二条「苏文辉」 | 页面选项 |
| 返利合约 | 「否」 | 写死 |
| 采购结算方式 | 「电汇」，精确点中 | 写死 |
| 承付模式 | 「下月N号结」 | 方案 |
| 承付参数 | `25` | 写死 |
| 协议开始日期 | 当天 | 写死 |
| 协议结束日期 | 当天 | 写死 |

---

## 3 细单

1. 必须先勾中总单，货品区才出「新增」
2. 点货品「新增」（同一合同多行：每行点一次新增）
3. 细单「货品编码」字段点三个点，打开货品选择
4. 弹窗里用 **货品ID** 搜表 3 的 `goods_id`（不要用 opcode / 货品编码搜）
5. 先点行里的单选 `.vxe-cell--radio`，再点弹窗底「确 定」
6. 数量、含税协议单价、无税单价按表 3 填
7. 细单备注 = 订单号；特定补偿 = 0
8. 承付模式：下月N号结；承付参数 `25`
9. 采购结算方式：先输入「电汇」再精确点「电汇」
10. 关税税率不填。货源细单ID 本期不填（下一会话：按总单联系人对货源，搜不到整组报错返回）。进货补偿预估值确认时报必填，填 0
11. 细单开始 / 结束日期先用系统默认；保存报错再看
12. 每条卡片填完点标题栏「确认 Ctrl + Enter」，行才落到货品表。不要点「返回表格」代替确认
13. **三条都确认完，再点货品工具栏「保存」**（新增旁边那颗，不要点总单工具栏保存）。保存时若弹出确认，再点确认。不要每条都点工具栏保存
14. 提示「总单供应商为空」时，先回总单把供应商补上，再继续细单

表 3 没有「无税单价」列，只有 `unit_price`（含税）和 `purchase_tax_rate`。无税单价按 `含税 ÷ (1+税率)` 算；税率用该行 `purchase_tax_rate`，空则 `0.13`。

### 3.1 细单字段

| 页面字段 | 怎么填 | 从哪来 |
| --- | --- | --- |
| 货品编码 | 三个点打开选择框，用货品ID搜 | 表 3 `goods_id` |
| 数量 | 手填 | 表 3 `qty` |
| 含税协议单价 | 手填 | 表 3 `unit_price` |
| 无税单价 | 手填 | 表 3：`unit_price / (1 + purchase_tax_rate)` |
| 税率 | 表 3 `purchase_tax_rate`，空则 `0.13` | 表 3 |
| 关税税率 | 不填 | — |
| 承付模式 | 「下月N号结」 | 方案 |
| 承付参数 | `25` | 写死 |
| 采购结算方式 | 「电汇」，精确点中 | 写死 |
| 细单开始日期 | 系统默认，报错再看 | 页面 |
| 细单结束日期 | 系统默认，报错再看 | 页面 |
| 特定补偿预估值 | `0` | 写死 |
| 进货补偿预估值 | 页面确认时报必填，填 `0` | 写死 |
| 细单备注 | 订单号 | 表 3 `oms_id` |
| 货源细单ID | 本期不填。下一会话：总单联系人同一货源；三个点搜不到则整组报错返回 | — |

---

## 4 送审

1. 总单、细单都保存完再送审；未保存细单不能送审
2. 送审按钮在 **总单工具栏**
3. 点「送审」；有确认框就确定
4. 送审成功才插表 4 协议行
5. 总单号认 **协议总单ID**，细单号认 **协议细单ID**。列表上一时看不见，再点一次查询

---

## 5 落表（班次，不改页面）

- 领表 4：`action_code=1 AND contract_status=1`（合同班起草、尚未回成功）
- 领表 3：`contract_entry_status=0` 且已有 `contractNo` 的只录协议行
- 领取时表 4 盖「查号中」，表 3 `process_status` 0→3
- 崩溃停戳：改回「合同班」/ `0` 再跑
- 搜到并送审成功：起草行 `contract_status=2`；同一合同每个 `oms_id` 插同一套 `action_code=2`、`agreement_status=1`，带协议总单ID / 协议细单ID；`push_status=0`。一组一个结果，不按行拆成功/失败
- 搜不到：戳改回「合同班」，表 3 改回 `0`，不插协议行
- 不推接口 4，不改 `push_status`

---

## 6 不要做

- 不要点查询弹层的「取消」
- 不要拿第一行或 `CG-` 号当总单
- 不要新增总单（审批通过后已有一条）
- 不要选计划员 ID；现阶段选「廖建琦」
- 供应商选择框里不要把名称和编码填反；用 `supplier_mdm_code` 搜编码
- 不要用 opcode / 货品编码在返利中心搜品种；用货品ID
- 结算不要点到「电汇—非直联」
- 细单不要点总单工具栏的保存
- 不要每条细单都点工具栏保存；卡片「确定」落到表后再统一保存
- 不要把承付参数填成「以销售定结」；总单、细单都填 `25`
- 不要做 Excel 导入
- 不要按行拆同一合同的成功/失败；一组一个结果
- 不要点总单卡片的「确认」去当细单确认；细单只点货品卡片「确认 Ctrl + Enter」
- 搜不到不要重录合同
- 浏览器卡住时不要关，停下问
- 计划员三个点打开的「货源选择」是选人弹层，要按住再搜「廖建琦」；适配器默认关货源层时计划员选不了