轻易云
注册体验

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

1 条评论

一、背景

定制生产企业的业务特点是按订单组织生产，每个订单的物料清单（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 生产工单全生命周期

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

5.3 成本核算数据回传

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

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

成本归集逻辑：

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

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

六、实施阶段划分

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

论坛热帖