306 lines
16 KiB
Markdown
306 lines
16 KiB
Markdown
# 福建洁达采购合同全链条自动化设计说明
|
||
|
||
| 项目 | 内容 |
|
||
| --- | --- |
|
||
| 文档名称 | 福建洁达采购合同全链条自动化设计说明 |
|
||
| 版本 | V1.1 |
|
||
| 日期 | 2026-09-12 |
|
||
| 适用范围 | 福建广药洁达医药有限公司采购合同、返利中心录入及相关选品作业 |
|
||
| 依据 | 《福建洁达采购合同全链条 RPA 自动化录入流程》《采购平台选品条件优先项》（2026-09-02）《合同返利系统字段映射》（2026-09-11） |
|
||
| 配套文档 | 《福建洁达四流程技术实现说明》 |
|
||
|
||
---
|
||
|
||
## 1. 概述
|
||
|
||
本方案在现有状态中心与 RPA 执行体系上，将采购作业拆为四条可独立启动的流程：选品采购、订单对码、合同录入、返利录入。
|
||
|
||
页面操作仍由 RPA 完成。**四条流程启动后的第一步，均由状态中心调用订单中心接口取数（或回写），写入 RPA 数据库并标记处理状态；接口未成功返回前，RPA 不得打开下游系统页面。** 操作人员可在状态中心启动作业、查看进度与业务数据，亦可按约定时间自动触发。
|
||
|
||
四条流程独立启动、独立失败、独立重跑，互不占用同一执行会话。同一笔业务单据的数据仍按「选品 → 对码 → 合同 → 返利」顺序衔接；前置数据未就绪时，后续流程不予执行，并记录原因。
|
||
|
||
---
|
||
|
||
## 2. 建设目标
|
||
|
||
1. 提供统一操作入口：状态中心可分别启动四条流程，或按计划定时运行。
|
||
2. 保证过程可见：每条作业的执行状态、当前环节、责任角色、业务数据及失败原因可在状态中心查询。
|
||
3. 保证数据可追溯：订单中心接口数据先落入 RPA 库，记录待处理、成功、失败等状态，支持失败重拉与按单重跑。
|
||
4. 保证规则可落地：选品按已确认的优先项执行；合同、返利按字段映射表填写，不自行推断未提供的字段。
|
||
5. 控制操作风险：商城付款、未尽调客户的合同填报，均不由机器人自动完成。
|
||
|
||
---
|
||
|
||
## 3. 总体方案
|
||
|
||
```
|
||
状态中心（启动 / 监控 / 待办）
|
||
│
|
||
│ 每条流程启动后，先调订单中心接口
|
||
▼
|
||
订单中心 ──读取──► 销售总单 / 客户主数据 / 货品 / 计划员 / 账期
|
||
◄──回写── 对码结果
|
||
│
|
||
▼
|
||
RPA 数据库（带处理状态：待处理 / 成功 / 失败）
|
||
│
|
||
│ 仅 STATUS=就绪 时，RPA 才点页面
|
||
▼
|
||
1号药城 / 药帮忙 / 合同系统 / 返利中心
|
||
```
|
||
|
||
| 流程 | 业务内容 | 建议运行时点 |
|
||
| --- | --- | --- |
|
||
| 选品采购 | 读取订单中心销售总单，在 1 号药城、药帮忙按规则选品，生成待复核清单 | 销售订单产生之后 |
|
||
| 订单对码 | 将选品结果或手工单字段写入订单中心对码表 | 选品完成，或手工单到达之后 |
|
||
| 合同录入 | 按字段映射填写合同系统 | 对码完成，且客户已尽调 |
|
||
| 返利录入 | 按合同号填写返利中心总单与细单 | 合同编号已生成 |
|
||
|
||
启动某一流程仅处理该流程范围内的任务，不强制四条连续一次跑完。某流程缺少必要数据或处于人工待办时，系统停留在该流程并写明原因，不向下游系统提交空数据。
|
||
|
||
---
|
||
|
||
## 4. 订单中心接口
|
||
|
||
订单中心是本方案的**唯一业务数据源**。合同系统、返利中心页面上由 RPA 填写、且映射表标注「从订单中心获取」的字段，一律经本接口取得，禁止从商城页面抄写，禁止在 RPA 脚本中写死。
|
||
|
||
调用原则：
|
||
|
||
1. **只由状态中心调用。** RPA 不直连订单中心。状态中心将结果写入 RPA 库后，机器人只读本地就绪数据。
|
||
2. **先接口、后页面。** 接口失败、超时、缺必填字段，本流程记失败并停止，不打开 1 号药城、合同系统或返利中心。
|
||
3. **原文留存。** 每次响应写入 RPA 库（含原始报文），状态中心可查，便于对账与重拉。
|
||
4. **按单幂等。** 同一业务键重复启动不重复插入成功数据；失败允许按同一键重拉。
|
||
|
||
正式 URL、鉴权、报文格式由订单中心提供后锁定。本节先按业务能力列出必须具备的接口；能力未齐备前，对应流程不得对生产系统写入。
|
||
|
||
### 4.1 接口清单与调用时点
|
||
|
||
| 序号 | 接口能力 | 方向 | 调用流程 | 调用时点 | 失败后果 |
|
||
| --- | --- | --- | --- | --- | --- |
|
||
| A | 销售总单查询 | 读 | 选品 | 选品启动后、上商城之前 | 选品停止，不上 1 号药城 / 药帮忙 |
|
||
| B | 销售明细查询 | 读 | 选品 | 紧接 A，按总单取行 | 同 A；无批准文号的行单独失败，不阻断其他行 |
|
||
| C | 对码结果回写 | 写 | 对码 | 选品完成或手工单识别之后 | 对码失败；合同不得启动 |
|
||
| D | 对码商家与货品查询 | 读 | 对码 / 合同 | 回写成功后，取客户名称、货品编码等 | 合同不得启动 |
|
||
| E | 客户主数据查询 | 读 | 合同 | 合同启动后、打开合同系统之前 | 合同停止；不填报 |
|
||
| F | 合同货品明细查询 | 读 | 合同 | 与 E 一并发起 | 同 E；缺货品行则本单失败 |
|
||
| G | 计划员与采购员对照查询 | 读 | 返利 | 返利启动后、打开返利中心之前 | 返利停止；不猜测计划员 |
|
||
| H | 返利源数据查询 | 读 | 返利 | 与 G 一并发起 | 缺供应商编码、订单号或货源细单号则本单失败 |
|
||
|
||
### 4.2 各接口必须返回的字段
|
||
|
||
字段名称以订单中心正式文档为准。下表为业务含义，来源为流程图及《合同返利系统字段映射》。
|
||
|
||
**A 销售总单查询**
|
||
|
||
入参：订单日期（默认前一日），可选供应商名称。
|
||
出参（每张总单）：销售总单号、订单日期、客户（商家）名称、客户编码、来源、总金额。
|
||
|
||
**B 销售明细查询**
|
||
|
||
入参：销售总单号。
|
||
出参（每行）：订单号、批准文号、通用名、规格、生产厂家、采购数量、**销售价格**（选品计算 5% 毛利的基准，不得用采购价替代）、平台商品编码（如有）。
|
||
|
||
无批准文号、无销售价格的行标记失败，不进入商城查询。
|
||
|
||
**C 对码结果回写**
|
||
|
||
入参：订单号或销售明细行标识，以及待写入对码表的字段（品名、规格、厂家、批准文号、数量、选品后的货品信息等）。
|
||
出参：写入是否成功。
|
||
说明：对应流程图「提取需要字段数据，传到订单中心对码功能数据表」。此为写接口，与查询分开。
|
||
|
||
**D 对码商家与货品查询**
|
||
|
||
入参：客户（商家）标识、货品匹配条件。
|
||
出参：客户名称、客户编码；货品编码、货品名称、注册证号、规格、单位。
|
||
说明：合同系统「客户名称」对照此处填写，不以商城店铺名为准。
|
||
|
||
**E 客户主数据查询**
|
||
|
||
入参：客户编码或客户名称。
|
||
出参：
|
||
|
||
| 字段 | 用途 |
|
||
| --- | --- |
|
||
| 客户名称、客户编码 | 合同「客户名称」 |
|
||
| 客户类型（预付 / 账期） | 预付：合同版本「我司定制」、预付款「是」、付款期限 1 天；账期：合同版本「非格式合同」、预付款「否」、付款期限取账期天数 |
|
||
| 账期天数 | 仅账期客户必填；映射表要求订单中心具备该维护功能 |
|
||
| 合同签订日期、开始日期、结束日期 | 合同对应日期字段 |
|
||
| 尽调状态（如订单中心有维护） | 未尽调则本份合同跳过并邮件通知采购员。若尽调仅在合同系统回显，则本字段改为页面读取，须在接口说明书中明确 |
|
||
|
||
**F 合同货品明细查询**
|
||
|
||
入参：销售总单号或订单号。
|
||
出参（每行）：货品编码、货品名称、注册证号、规格、单位、数量、单价。
|
||
说明：用于合同明细导入模板。数量、单价取订单中心，不取商城实时价。
|
||
|
||
**G 计划员与采购员对照查询**
|
||
|
||
入参：计划员或采购员。可按全量或按供应商查询。
|
||
出参：计划员、对应采购员。
|
||
说明：映射表注明「订单中心需要有计划员和采购员的对应关系」。无对照则返利总单「计划员」无法填写。
|
||
|
||
**H 返利源数据查询**
|
||
|
||
入参：合同号或销售总单号。
|
||
出参：供应商编码、返利单位编码、计划员、订单号、货源细单号；以及细单行的货品编码、数量、含税协议单价。
|
||
说明：返利细单「细单备注」填订单号，「货源细单 ID」填货源细单号，二者均须订单中心给出。
|
||
|
||
### 4.3 调用顺序（按一笔业务）
|
||
|
||
```
|
||
选品启动
|
||
① 调 A、B → 写入销售总单/明细（就绪） → 再上商城查价
|
||
A/B 失败 → 选品失败，不上商城
|
||
|
||
对码启动
|
||
② 调 C 回写对码表 → 调 D 取客户与货品编码 → 就绪后方可合同
|
||
C/D 失败 → 对码失败，合同入口拒绝启动
|
||
|
||
合同启动
|
||
③ 调 E、F → 客户类型/账期/日期/货品行就绪 → 再打开合同系统
|
||
必填缺失 → 合同失败，不填报
|
||
未尽调 → 本单跳过，邮件通知，处理下一单
|
||
|
||
返利启动
|
||
④ 调 G、H → 计划员对照与细单源数据就绪 → 再打开返利中心
|
||
必填缺失 → 返利失败，不猜测字段
|
||
```
|
||
|
||
四条流程仍可分时、分别启动；上述顺序约束的是**同一业务键上的数据依赖**，不是强制一次连续跑完四条。
|
||
|
||
### 4.4 失败与重试
|
||
|
||
| 情形 | 处理 |
|
||
| --- | --- |
|
||
| 网络超时、服务不可用 | 本流程失败，可重拉接口；不启动 RPA |
|
||
| 返回成功但缺必填字段 | 本单失败，记录缺失字段名称；不启动 RPA |
|
||
| 部分明细行缺批准文号或销售价格 | 仅该行失败，其余行继续 |
|
||
| 对码回写失败 | 对码失败；合同、返利不得启动 |
|
||
| 客户未尽调 | 本合同跳过（不算接口失败），发邮件，继续下一客户 |
|
||
| 计划员对照不存在 | 返利失败，不使用默认计划员 |
|
||
|
||
重拉只覆盖失败数据，已成功入库的记录不得覆盖。
|
||
|
||
### 4.5 需订单中心确认的事项
|
||
|
||
1. 上表 A–H 的正式地址、鉴权方式、测试与生产环境。
|
||
2. 客户类型、账期天数、计划员与采购员对照、货源细单号是否已有维护功能与查询接口（映射表已提出，当前文档未提供接口说明）。
|
||
3. 尽调状态以订单中心为准，或以合同系统选择客户后的回显为准。
|
||
4. 对码功能数据表的写入接口是否已经开放；未开放则对码流程无法闭环。
|
||
|
||
未确认前，状态中心可用测试数据验证「调用 → 入库 → 状态中心可见」链路，不对生产订单中心与生产合同系统写入。
|
||
|
||
---
|
||
|
||
## 5. 流程说明
|
||
|
||
### 5.1 选品采购
|
||
|
||
调用接口 A、B，取得销售总单及明细后，按批准文号检索 1 号药城、药帮忙商品，依据第 6 节规则筛选。筛选结果形成待复核清单，由采购人员确认后再付款。机器人不执行支付操作。
|
||
|
||
已完成的商城登录与按文号查询能力纳入本流程复用，查询结果改为写入 RPA 库及状态中心，不再以桌面表格作为唯一产出。
|
||
|
||
### 5.2 订单对码
|
||
|
||
调用接口 C，将选品结果或 DocAgent 识别的手工单字段写入订单中心对码功能数据表；再调用接口 D，取得客户名称与货品编码。合同系统中的「客户名称」以接口 D 为准。
|
||
|
||
### 5.3 合同录入
|
||
|
||
调用接口 E、F 取得客户主数据与货品明细后，依据《合同返利系统字段映射》填写合同系统。录入方式分为系统自动生成、RPA 填写、无需填写三类；RPA 仅处理标注为「RPA」的字段。
|
||
|
||
客户未完成主体尽调时：向采购员发送邮件，本份合同跳过，继续处理后续合同，不中断整批作业。
|
||
|
||
客户类型为预付时：合同版本类型取「我司定制」，是否预付款为「是」，付款期限为 1 天。
|
||
客户类型为账期时：合同版本类型取「非格式合同」，是否预付款为「否」，付款期限取接口 E 返回的账期天数。
|
||
|
||
### 5.4 返利录入
|
||
|
||
调用接口 G、H 取得计划员对照与返利源数据后，按合同号查询采购协议，填写总单必填项并导入细单。提交失败转为人工处理，不循环强行提交。
|
||
|
||
---
|
||
|
||
## 6. 选品规则
|
||
|
||
规则依据《采购平台选品条件优先项》（2026-09-02）。下列第 1 至 4 项须同时满足，再比较仓库距离。销售价格以订单中心接口 B 为准。
|
||
|
||
1. **自营仓**：仅在已勾选的自营仓范围内选择。
|
||
2. **价格**：与销售价格比较，毛利不低于 5%。
|
||
3. **有效期**：大于等于 12 个月。
|
||
4. **库存**：库存数量不低于本单采购数量。
|
||
5. **仓库距离**：在满足以上条件后，按下列自营仓顺序优先选择距离较近的仓库：
|
||
|
||
1. 广东壹号药业有限公司
|
||
2. 昆山亿方药业有限公司
|
||
3. 湖北亿昊药业有限公司
|
||
4. 天津壹号药业有限公司
|
||
5. 重庆亿昊药业有限公司
|
||
6. 重庆壹号医药有限公司
|
||
7. 湖南壹号药业股份有限公司
|
||
8. 辽宁亿昊药业有限公司
|
||
9. 河南壹号医药有限公司
|
||
10. 甘肃壹号云医药有限责任公司企业店
|
||
11. 陕西壹号药业有限公司
|
||
|
||
现有商城查价程序实现了双平台登录与按批准文号取价，可作为选品流程的查询能力复用。该程序现行过滤逻辑与上述规则存在差异，上线口径以本节为准：
|
||
|
||
| 现有查价程序 | 本方案采用规则 |
|
||
| --- | --- |
|
||
| 按采购价格上下浮动 10% 过滤 | 相对销售价格，毛利不低于 5% |
|
||
| 未限定自营仓范围 | 仅在上述 11 家自营仓内选择 |
|
||
| 未校验库存是否覆盖采购数量 | 库存须大于等于采购数量 |
|
||
| 结果输出至本地表格 | 结果写入 RPA 库，并在状态中心展示 |
|
||
|
||
---
|
||
|
||
## 7. 合同与返利录入口径
|
||
|
||
字段来源、录入方式以《合同返利系统字段映射》（2026-09-11）为准。凡标注「从订单中心获取」的字段，取值路径见第 4 节，缺项不得提交。
|
||
|
||
合同、返利中标注为默认值的字段（如结算类型「收支双向」、付款方式「电汇」、税率 0.13、承付模式及参数等）按映射表执行，不在运行时另行解释。
|
||
|
||
---
|
||
|
||
## 8. 运行监控
|
||
|
||
状态中心提供以下可见信息：
|
||
|
||
- 当日四条流程的执行数量，以及成功、失败、等待人工处理的分布
|
||
- 单笔作业的当前环节与责任角色
|
||
- 订单中心各接口最近一次调用时间、成功或失败、缺失字段
|
||
- 选品候选、毛利是否达标、选用自营仓
|
||
- 合同关键字段（客户名称、金额、日期、尽调结果）
|
||
- 返利总单编号、细单导入结果
|
||
- 失败原因及是否允许按本流程重跑
|
||
|
||
接口数据写入 RPA 测试库，并标记处理状态（待处理 / 处理中 / 成功 / 失败 / 跳过）。状态中心同步展示，作为业务查询与问题定位的依据。
|
||
|
||
---
|
||
|
||
## 9. 本期范围
|
||
|
||
**本期包含**
|
||
|
||
- 四条流程的独立启动、定时启动与状态查询
|
||
- 订单中心接口 A–H 的调用、入库与失败停机
|
||
- 选品查询能力与优先项规则落地
|
||
- 合同、返利按映射表自动填写
|
||
|
||
**本期不包含**
|
||
|
||
- 机器人自动完成商城支付
|
||
- 对未尽调客户自动填写并提交合同
|
||
- 将四条流程拆成互不共享状态的独立工具
|
||
- 在订单中心正式接口就绪前对生产系统写入
|
||
|
||
流程图未包含 M5 采购订单。若现场仍需 M5 作业，另行立项，不纳入本四条流程。
|
||
|
||
---
|
||
|
||
## 10. 待确认事项
|
||
|
||
1. 四条流程采用统一状态中心入口、分别启动；允许只运行其中一条。
|
||
2. 选品正式规则以第 6 节为准；现有查价程序仅复用登录与查询能力。
|
||
3. 订单中心按第 4.5 节提供接口说明书，并确认客户类型、账期天数、计划员对照、货源细单号、对码回写、尽调来源。未齐备前，合同与返利不得按缺省猜测值提交。
|
||
|
||
上述事项确认后，按《福建洁达四流程技术实现说明》实施。实施顺序为：先完成订单中心取数入库与状态中心可见，再接入选品、合同与返利。
|