# 福建洁达采购合同全链条自动化设计说明 | 项目 | 内容 | | --- | --- | | 文档名称 | 福建洁达采购合同全链条自动化设计说明 | | 版本 | 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 节提供接口说明书，并确认客户类型、账期天数、计划员对照、货源细单号、对码回写、尽调来源。未齐备前，合同与返利不得按缺省猜测值提交。 上述事项确认后，按《福建洁达四流程技术实现说明》实施。实施顺序为：先完成订单中心取数入库与状态中心可见，再接入选品、合同与返利。