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

一、背景

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

二、系统定位与分工

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

三、数据对接架构

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

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

四、接口清单

五、核心对接场景

5.1 BOM主数据同步

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

关键字段映射：

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

5.2 生产工单全生命周期

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

5.3 成本核算数据回传

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

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

成本归集逻辑：

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

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

六、实施阶段划分