一、背景定制生产企业的业务特点是按订单组织生产，每个订单的物料清单（BOM）往往存在差异，变更频率较高。在实际运营中，生产执行系统与财务管理系统之间的数据通常处于割裂状态：车间现场通过黑湖小工单进行报工、领料等操作，而财务成本核算依赖金蝶云星辰完成。两套系统独立运行，导致生产数据需要人工二次录入财务系统，存在数据滞后、录入误差以及成本核算周期过长等问题。二、系统定位与分工层级系统核心职能生产执行层黑湖小工单工单创建与下发、工序级管控、现场数据采集、实时报工、物料消耗记录、委外进度跟踪财务管理层金蝶云星辰 BOM主数据管理、生产任务单管理、生产成本核算（分批法）、库存账务处理、财务凭证生成两套系统通过数据集成平台进行API对接，实现生产数据向财务系统的自动回传。三、数据对接架构对接围绕五条核心数据流展开，采用RESTful API + JSON数据格式，支持实时同步与定时批量同步两种模式。序号数据流方向业务内容 ① 金蝶云星辰 → 黑湖小工单 BOM主数据同步 ② 金蝶云星辰 → 黑湖小工单生产任务单（工单）下达 ③ 黑湖小工单 → 金蝶云星辰报工数据回传 ④ 黑湖小工单 → 金蝶云星辰领料/退料数据回传 ⑤ 黑湖小工单 → 金蝶云星辰产品入库数据回传认证方式：OAuth 2.0 令牌认证。黑湖侧采用AppKey + AppSecret，金蝶侧采用Client ID + Client Secret。四、接口清单数据流黑湖小工单 OpenAPI 金蝶云星辰 2.0 API BOM同步接收BOM数据（ mbomVersion 字段必填， materialCode 必填）物料清单查询/保存（BOM版本、子项明细、工艺路线）工单下达 openapi/v1/work_order/import (POST) 生产任务单查询（任务单编号、产品、数量、计划时间）报工回传 /api/dytin/external/output/queryList 生产汇报单/产品入库单（完工数量、良品/不良品、实际工时）领料回传 erp/v1/erp/manufacture/in_storage_record 生产领料单/退料单（物料编码、领用数量、仓库）入库回传 delivery_request/procure_order 产品入库单/退库单（入库数量、批次、成本归集）成本核算报工数据聚合（工时、产量、不良品汇总）生产成本核算（分批法、费用分摊、凭证生成）五、核心对接场景 5.1 BOM主数据同步金蝶云星辰作为BOM主数据源，维护物料清单、多级BOM、工艺路线及BOP工位关系。BOM新增或变更时，通过接口自动同步至黑湖小工单。关键字段映射：金蝶云星辰字段黑湖小工单字段 FNumber （物料编码） materialCode BOM版本号 mbomVersion 工序编号/工位 processCode / workStation 订单BOM模式：定制生产场景下，支持按客户订单单独创建BOM版本，每个订单关联独立BOM，满足"一单一款"的生产需求。BOM修改自动触发版本变更，历史版本保留可追溯。 5.2 生产工单全生命周期工单下达：金蝶云星辰的生产任务单自动同步为黑湖小工单的计划工单，携带BOM版本、计划数量、计划起止时间等信息。工单执行：车间通过黑湖小工单进行工序级管控，包括任务分配、扫码报工、现场数据采集、图纸查看、工时记录。工单关闭：黑湖小工单将实际完工数量、良品/不良品明细、实际工时回传至金蝶云星辰，触发成本核算。 5.3 成本核算数据回传金蝶云星辰采用分批法按生产订单归集成本，与定制生产"一单一款"模式匹配。回传的数据包括：报工数据：产量、工时、不良品数量领料数据：物料消耗、退料、损耗差异入库数据：完工数量、退库、检验结果成本归集逻辑：直接材料成本：BOM标准用量与实际领料差异分摊直接人工成本：报工实际工时 × 工时费率制造费用：按预设基准（如工时比例）分摊核算结果自动生成财务凭证。六、实施阶段划分阶段周期工作内容里程碑基础对接第1-2周 API连接测试、基础资料同步（物料、工序）、BOM单向同步验证 BOM成功同步业务贯通第3-4周生产任务单同步、报工数据回传、领料入库回传、车间闭环验证工单闭环运转成本闭环第5-6周生产成本核算对接、成本差异分析、凭证自动生成、财务数据验证成本精准核算优化运维第7-8周 BOM变更流程优化、异常处理机制完善、用户培训、运维手册交付系统正式上线

黑湖小工单与金蝶云星辰生产管理对接技术说明

卢剑航

一、背景

定制生产企业的业务特点是按订单组织生产，每个订单的物料清单（BOM）往往存在差异，变更频率较高。在实际运营中，生产执行系统与财务管理系统之间的数据通常处于割裂状态：车间现场通过黑湖小工单进行报工、领料等操作，而财务成本核算依赖金蝶云星辰完成。两套系统独立运行，导致生产数据需要人工二次录入财务系统，存在数据滞后、录入误差以及成本核算周期过长等问题。

二、系统定位与分工

层级	系统	核心职能
生产执行层	黑湖小工单	工单创建与下发、工序级管控、现场数据采集、实时报工、物料消耗记录、委外进度跟踪
财务管理层	金蝶云星辰	BOM主数据管理、生产任务单管理、生产成本核算（分批法）、库存账务处理、财务凭证生成

两套系统通过数据集成平台进行API对接，实现生产数据向财务系统的自动回传。

三、数据对接架构

对接围绕五条核心数据流展开，采用RESTful API + JSON数据格式，支持实时同步与定时批量同步两种模式。

序号	数据流方向	业务内容
①	金蝶云星辰 → 黑湖小工单	BOM主数据同步
②	金蝶云星辰 → 黑湖小工单	生产任务单（工单）下达
③	黑湖小工单 → 金蝶云星辰	报工数据回传
④	黑湖小工单 → 金蝶云星辰	领料/退料数据回传
⑤	黑湖小工单 → 金蝶云星辰	产品入库数据回传

认证方式：OAuth 2.0 令牌认证。黑湖侧采用AppKey + AppSecret，金蝶侧采用Client ID + Client Secret。

四、接口清单

数据流	黑湖小工单 OpenAPI	金蝶云星辰 2.0 API
BOM同步	接收BOM数据（`mbomVersion`字段必填，`materialCode`必填）	物料清单查询/保存（BOM版本、子项明细、工艺路线）
工单下达	`openapi/v1/work_order/import` (POST)	生产任务单查询（任务单编号、产品、数量、计划时间）
报工回传	`/api/dytin/external/output/queryList`	生产汇报单/产品入库单（完工数量、良品/不良品、实际工时）
领料回传	`erp/v1/erp/manufacture/in_storage_record`	生产领料单/退料单（物料编码、领用数量、仓库）
入库回传	`delivery_request/procure_order`	产品入库单/退库单（入库数量、批次、成本归集）
成本核算	报工数据聚合（工时、产量、不良品汇总）	生产成本核算（分批法、费用分摊、凭证生成）

五、核心对接场景

5.1 BOM主数据同步

金蝶云星辰作为BOM主数据源，维护物料清单、多级BOM、工艺路线及BOP工位关系。BOM新增或变更时，通过接口自动同步至黑湖小工单。

关键字段映射：

金蝶云星辰字段	黑湖小工单字段
`FNumber`（物料编码）	`materialCode`
BOM版本号	`mbomVersion`
工序编号/工位	`processCode` / `workStation`

订单BOM模式：
定制生产场景下，支持按客户订单单独创建BOM版本，每个订单关联独立BOM，满足"一单一款"的生产需求。BOM修改自动触发版本变更，历史版本保留可追溯。

5.2 生产工单全生命周期

工单下达：金蝶云星辰的生产任务单自动同步为黑湖小工单的计划工单，携带BOM版本、计划数量、计划起止时间等信息。
工单执行：车间通过黑湖小工单进行工序级管控，包括任务分配、扫码报工、现场数据采集、图纸查看、工时记录。
工单关闭：黑湖小工单将实际完工数量、良品/不良品明细、实际工时回传至金蝶云星辰，触发成本核算。

5.3 成本核算数据回传

金蝶云星辰采用分批法按生产订单归集成本，与定制生产"一单一款"模式匹配。回传的数据包括：

报工数据：产量、工时、不良品数量
领料数据：物料消耗、退料、损耗差异
入库数据：完工数量、退库、检验结果

成本归集逻辑：

直接材料成本：BOM标准用量与实际领料差异分摊
直接人工成本：报工实际工时 × 工时费率
制造费用：按预设基准（如工时比例）分摊

核算结果自动生成财务凭证。

六、实施阶段划分

阶段	周期	工作内容	里程碑
基础对接	第1-2周	API连接测试、基础资料同步（物料、工序）、BOM单向同步验证	BOM成功同步
业务贯通	第3-4周	生产任务单同步、报工数据回传、领料入库回传、车间闭环验证	工单闭环运转
成本闭环	第5-6周	生产成本核算对接、成本差异分析、凭证自动生成、财务数据验证	成本精准核算
优化运维	第7-8周	BOM变更流程优化、异常处理机制完善、用户培训、运维手册交付	系统正式上线