180 lines
9.2 KiB
Markdown
180 lines
9.2 KiB
Markdown
# 返利中心页面流程
|
||
|
||
写代码以本文为准。
|
||
|
||
---
|
||
|
||
## 环境
|
||
|
||
- 地址：`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 本期不填。弹层按**总单联系人**过滤（现「苏文辉」），不是全局按号搜；表 3 `goods_source_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 AND process_status=0`（合同已起草、尚未回成功）。同一合同号整组领
|
||
- 领表 3：`contract_entry_status=0` 且已有 `contractNo` 的只录协议行
|
||
- 领取时表 4、表 3 的 `process_status` 都是 0→3。`create_user_name` / `update_user_name` 固定「系统管理员」
|
||
- 崩溃停在 3：改回 `0` 再跑
|
||
- 搜到并送审成功：起草行 `contract_status=2`、`process_status=1`；同一合同每个 `oms_id` 插同一套 `action_code=2`、`agreement_status=1`，带协议总单ID / 协议细单ID；`push_status=0`。一组一个结果，不按行拆成功/失败
|
||
- 搜不到：表 4 `process_status` 改回 `0`，表 3 改回 `0`，不插协议行
|
||
- 不推接口 4，不改 `push_status`
|
||
|
||
---
|
||
|
||
## 6 不要做
|
||
|
||
- 不要点查询弹层的「取消」
|
||
- 不要拿第一行或 `CG-` 号当总单
|
||
- 不要新增总单（审批通过后已有一条）
|
||
- 不要选计划员 ID；现阶段选「廖建琦」
|
||
- 供应商选择框里不要把名称和编码填反；用 `supplier_mdm_code` 搜编码
|
||
- 不要用 opcode / 货品编码在返利中心搜品种；用货品ID
|
||
- 结算不要点到「电汇—非直联」
|
||
- 细单不要点总单工具栏的保存
|
||
- 不要每条细单都点工具栏保存；卡片「确定」落到表后再统一保存
|
||
- 不要把承付参数填成「以销售定结」；总单、细单都填 `25`
|
||
- 不要做 Excel 导入
|
||
- 不要按行拆同一合同的成功/失败；一组一个结果
|
||
- 不要点总单卡片的「确认」去当细单确认；细单只点货品卡片「确认 Ctrl + Enter」
|
||
- 搜不到不要重录合同
|
||
- 浏览器卡住时不要关，停下问
|
||
- 计划员三个点打开的「货源选择」是选人弹层，要按住再搜「廖建琦」；适配器默认关货源层时计划员选不了
|
||
- 货源跟联系人，不跟计划员。细单货源弹层只出苏文辉名下货源
|
||
|
||
---
|
||
|
||
## 7 本期不填 / 后期再改
|
||
|
||
| 项 | 现在 | 以后 |
|
||
| --- | --- | --- |
|
||
| 货源细单ID | 不填 | 三个点按联系人过滤搜表 3 号；空则整组失败 |
|
||
| 计划员 | 廖建琦 | 改回表 3 `planner_name` |
|
||
| 口 2 / 口 4 HTTP、M5、药帮忙支付 | 不做 | 不在本包 |
|