16 KiB

Raw Blame History

福建洁达采购合同全链条自动化设计说明

项目	内容
文档名称	福建洁达采购合同全链条自动化设计说明
版本	V1.1
日期	2026-09-12
适用范围	福建广药洁达医药有限公司采购合同、返利中心录入及相关选品作业
依据	《福建洁达采购合同全链条 RPA 自动化录入流程》《采购平台选品条件优先项》（2026-09-02）《合同返利系统字段映射》（2026-09-11）
配套文档	《福建洁达四流程技术实现说明》

1. 概述

本方案在现有状态中心与 RPA 执行体系上，将采购作业拆为四条可独立启动的流程：选品采购、订单对码、合同录入、返利录入。

页面操作仍由 RPA 完成。四条流程启动后的第一步，均由状态中心调用订单中心接口取数（或回写），写入 RPA 数据库并标记处理状态；接口未成功返回前，RPA 不得打开下游系统页面。操作人员可在状态中心启动作业、查看进度与业务数据，亦可按约定时间自动触发。

四条流程独立启动、独立失败、独立重跑，互不占用同一执行会话。同一笔业务单据的数据仍按「选品 → 对码 → 合同 → 返利」顺序衔接；前置数据未就绪时，后续流程不予执行，并记录原因。

2. 建设目标

提供统一操作入口：状态中心可分别启动四条流程，或按计划定时运行。
保证过程可见：每条作业的执行状态、当前环节、责任角色、业务数据及失败原因可在状态中心查询。
保证数据可追溯：订单中心接口数据先落入 RPA 库，记录待处理、成功、失败等状态，支持失败重拉与按单重跑。
保证规则可落地：选品按已确认的优先项执行；合同、返利按字段映射表填写，不自行推断未提供的字段。
控制操作风险：商城付款、未尽调客户的合同填报，均不由机器人自动完成。

3. 总体方案

状态中心（启动 / 监控 / 待办）
        │
        │  每条流程启动后，先调订单中心接口
        ▼
订单中心  ──读取──►  销售总单 / 客户主数据 / 货品 / 计划员 / 账期
        ◄──回写──   对码结果
        │
        ▼
RPA 数据库（带处理状态：待处理 / 成功 / 失败）
        │
        │  仅 STATUS=就绪 时，RPA 才点页面
        ▼
1号药城 / 药帮忙 / 合同系统 / 返利中心

流程	业务内容	建议运行时点
选品采购	读取订单中心销售总单，在 1 号药城、药帮忙按规则选品，生成待复核清单	销售订单产生之后
订单对码	将选品结果或手工单字段写入订单中心对码表	选品完成，或手工单到达之后
合同录入	按字段映射填写合同系统	对码完成，且客户已尽调
返利录入	按合同号填写返利中心总单与细单	合同编号已生成

启动某一流程仅处理该流程范围内的任务，不强制四条连续一次跑完。某流程缺少必要数据或处于人工待办时，系统停留在该流程并写明原因，不向下游系统提交空数据。

4. 订单中心接口

订单中心是本方案的唯一业务数据源。合同系统、返利中心页面上由 RPA 填写、且映射表标注「从订单中心获取」的字段，一律经本接口取得，禁止从商城页面抄写，禁止在 RPA 脚本中写死。

调用原则：

只由状态中心调用。 RPA 不直连订单中心。状态中心将结果写入 RPA 库后，机器人只读本地就绪数据。
先接口、后页面。 接口失败、超时、缺必填字段，本流程记失败并停止，不打开 1 号药城、合同系统或返利中心。
原文留存。 每次响应写入 RPA 库（含原始报文），状态中心可查，便于对账与重拉。
按单幂等。 同一业务键重复启动不重复插入成功数据；失败允许按同一键重拉。

正式 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 需订单中心确认的事项

上表 A–H 的正式地址、鉴权方式、测试与生产环境。
客户类型、账期天数、计划员与采购员对照、货源细单号是否已有维护功能与查询接口（映射表已提出，当前文档未提供接口说明）。
尽调状态以订单中心为准，或以合同系统选择客户后的回显为准。
对码功能数据表的写入接口是否已经开放；未开放则对码流程无法闭环。

未确认前，状态中心可用测试数据验证「调用 → 入库 → 状态中心可见」链路，不对生产订单中心与生产合同系统写入。

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 为准。

自营仓：仅在已勾选的自营仓范围内选择。
价格：与销售价格比较，毛利不低于 5%。
有效期：大于等于 12 个月。
库存：库存数量不低于本单采购数量。
仓库距离：在满足以上条件后，按下列自营仓顺序优先选择距离较近的仓库：
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. 待确认事项

四条流程采用统一状态中心入口、分别启动；允许只运行其中一条。
选品正式规则以第 6 节为准；现有查价程序仅复用登录与查询能力。
订单中心按第 4.5 节提供接口说明书，并确认客户类型、账期天数、计划员对照、货源细单号、对码回写、尽调来源。未齐备前，合同与返利不得按缺省猜测值提交。

上述事项确认后，按《福建洁达四流程技术实现说明》实施。实施顺序为：先完成订单中心取数入库与状态中心可见，再接入选品、合同与返利。

16 KiB Raw Blame History Unescape Escape