C300-OpenAPI
  1. 集成案例
C300-OpenAPI
  • 使用指南
    • 快速开始(API & 事件订阅)
    • API 参考
    • 事件订阅参考
    • Webwidget使用说明
    • 认证 API
      • 创建 Token
      • 刷新 Token
    • 制造域 MFR
      • 基础数据
        • BOM
          • API
            • 创建 BOM
            • 删除 BOM
            • 更新 BOM
            • 查询 BOM
          • 事件
            • BOM 创建
            • BOM 删除
            • BOM 更新
            • BOM 审核通过
            • BOM 审核驳回
        • 标准工序
          • API
            • 更新标准工序
            • 查询工序
            • 分批查询工序
            • 创建标准工序
            • 删除标准工序
          • 事件
            • 标准工序创建
            • 标准工序删除
            • 标准工序更新
        • 工艺路线
          • API
            • 删除工艺路线
            • 创建工艺路线
            • 更新工艺路线
            • 上传工艺路线图纸信息
            • 查询工艺路线
          • 事件
            • 工艺路线创建
            • 工艺路线删除
            • 工艺路线更新
        • 生产小组
          • API
            • 查询小组
            • 创建生产小组
            • 分批查询小组
            • 更新生产小组
          • 事件
        • 工作中心
          • API
            • 创建工作中心
            • 删除工作中心
            • 更新工作中心
            • 查询工作中心
            • 分批查询工作中心
          • 事件
        • 生产流程
          • API
          • 事件
            • 生产流程创建
            • 生产流程删除
            • 生产流程更新
      • 生产单
        • API
          • 更新生产单
          • 创建生产单
          • 批量删除生产单
          • 查询计划用料
          • 分批查询计划用料
          • 查询生产单工序
          • 修改计划用料
          • 完成生产单
          • 作废生产单
          • 查询生产单
          • 分批查询生产单
          • 创建序列号
        • 事件
          • 生产单创建
          • 生产单删除
          • 生产单更新
          • 生产单作废
          • 生产单完成
          • 生产单审核通过
          • 生产单审核驳回
          • 生产单重审
          • 生产计划用料更新
          • 生产计划用料添加
          • 生产计划用料删除
          • 生产单计划排程
          • 生产单派发
          • 生产单工序派发
          • 生产单加入计划
      • 生产任务单
        • API
          • 查询生产任务单
          • 分批查询生产任务单
        • 事件
          • 生产任务流转
      • 生产领料单
        • API
          • 创建申请领料单
        • 事件
      • 生产备料出库任务
        • API
          • 更新生产备料出库任务
          • 查询生产备料出库任务
        • 事件
          • 生产备料出库任务创建
          • 生产备料出库任务删除
          • 生产备料出库任务更新
          • 生产备料出库任务审核通过
          • 生产备料出库任务审核驳回
          • 生产备料出库任务完成
      • 生产领料出库任务
        • API
          • 更新生产领料出库任务
        • 事件
      • 生产补料出库任务
        • API
          • 更新生产补料出库任务
        • 事件
      • 生产还料入库任务
        • API
          • 更新生产还料入库任务
          • 查询生产还料入库任务
        • 事件
          • 生产还料入库任务创建
          • 生产还料入库任务删除
          • 生产还料入库任务更新
          • 生产还料入库任务审核通过
          • 生产还料入库任务审核驳回
          • 生产还料入库任务完成
      • 生产入库任务
        • API
          • 查询生产入库任务
          • 更新生产入库任务
        • 事件
          • 生产入库任务创建
          • 生产入库任务删除
          • 生产入库任务更新
          • 生产入库任务完成
      • 生产报废入库任务
        • API
          • 更新生产报废入库任务
          • 完成生产报废入库任务
          • 查询报废入库
          • 分批查询报废入库
        • 事件
          • 生产报废入库任务创建
          • 生产报废入库任务删除
          • 生产报废入库任务更新
          • 生产报废入库任务完成
      • 生产报工记录
        • API
          • 删除生产报工记录
          • 创建生产报工记录
          • 查询报工记录
          • 分批查询报工记录
        • 事件
          • 生产报工记录创建
          • 生产报工记录删除
          • 生产报工记录更新
      • 委外管理
        • 委外采购单
          • API
            • 创建委外采购单
            • 更新委外采购单审核状态
            • 更新委外采购单
            • 查询委外采购单行
            • 分批查询委外采购单行
          • 事件
            • 委外采购单创建
            • 委外采购单删除
            • 委外采购单更新
            • 委外采购单审核通过
            • 委外采购单审核驳回
            • 委外采购单完成
            • 委外采购单作废
        • 委外收料单
          • API
            • 创建委外收料单
            • 创建并自动完成委外收料单
          • 事件
            • 委外收料单创建
            • 委外收料单删除
            • 委外收料单更新
            • 委外收料单审核通过
            • 委外收料单审核驳回
            • 委外收料单完成
            • 委外收料单作废
        • 委外备料出库任务
          • API
            • 更新委外备料出库任务
            • 确认委外备料出库任务
          • 事件
            • 委外备料出库任务创建
            • 委外备料出库任务删除
            • 委外备料出库任务更新
            • 委外备料出库任务完成
            • 委外备料出库任务作废
        • 委外入库任务
          • API
            • 更新委外入库任务
          • 事件
            • 生产委外入库任务创建
            • 生产委外入库任务删除
            • 生产委外入库任务更新
            • 生产委外入库任务完成
            • 生产委外入库任务作废
            • 库存委外入库任务创建
            • 库存委外入库任务删除
            • 库存委外入库任务更新
            • 库存委外入库任务完成
            • 库存委外入库任务作废
    • 质量域QLTY
      • 生产检验任务
        • 事件
          • 生产检验任务创建
          • 生产检验任务删除
          • 生产检验任务更新
      • 生产检验报工记录
        • API
          • 创建生产检验报工记录
          • 删除生产检验报工记录
          • 作废生产检验报工记录
          • 查询检验记录
          • 分批查询检验记录
          • 查询检验记录行
          • 分批查询检验记录行
        • 事件
          • 生产检验报工记录创建
          • 生产检验报工记录删除
          • 生产检验报工记录更新
      • 生产检验待处理不合格品单
        • 事件
          • 生产检验待处理不合格品单创建
          • 生产检验待处理不合格品单作废
      • 生产检验不合格品处理单
        • 事件
          • 生产检验不合格品处理单创建
          • 生产检验不合格品处理单删除
          • 生产检验不合格品处理单更新
          • 生产检验不合格品处理单审核通过
          • 生产检验不合格品处理单审核驳回
          • 生产检验不合格品处理单完成
          • 生产检验不合格品处理单作废
      • 收料待报检任务
        • 事件
          • 收料待报检任务创建
          • 收料待报检任务更新
          • 收料待报检任务作废
      • 收料检验单
        • API
          • 创建收料检验单
          • 作废收料检验单
          • 删除收料检验单
          • 更新收料检验单审核状态
        • 事件
      • 收料检验报工记录
        • 事件
          • 收料检验报工记录创建
          • 收料检验报工记录删除
      • 收料检待处理不合格品单
        • 事件
          • 收料检待处理不合格品单创建
          • 收料检待处理不合格品单作废
      • 收料检验不合格品处理单
        • 事件
          • 收料检验不合格品处理单创建
          • 收料检验不合格品处理单删除
          • 收料检验不合格品处理单更新
          • 收料检验不合格品处理单审核通过
          • 收料检验不合格品处理单审核驳回
          • 收料检验不合格品处理单完成
          • 收料检验不合格品处理单作废
      • 收料放行单
        • 事件
          • 收料放行单创建
          • 收料放行单删除
          • 收料放行单更新
          • 收料放行单审核通过
          • 收料放行单审核驳回
          • 收料放行单完成
          • 收料放行单作废
      • 收料检验库存申请单
        • 事件
          • 收料检验库存申请单创建
          • 收料检验库存申请单删除
          • 收料检验库存申请单更新
          • 收料检验库存申请单审核通过
          • 收料检验库存申请单审核驳回
          • 收料检验库存申请单完成
          • 收料检验库存申请单作废
      • 库存检验单
        • 事件
          • 库存检验单创建
          • 库存检验单删除
          • 库存检验单更新
          • 库存检验单审核通过
          • 库存检验单审核驳回
          • 库存检验单完成
          • 库存检验单作废
      • 库存检验不合格品处理单
        • 事件
          • 库存检验不合格品处理单创建
          • 库存检验不合格品处理单删除
          • 库存检验不合格品处理单更新
          • 库存检验不合格品处理单审核通过
          • 库存检验不合格品处理单审核驳回
          • 库存检验不合格品处理单完成
          • 库存检验不合格品处理单作废
    • 计划域PLN
      • 生产单计划
        • 事件
          • 生产单计划确认
      • 车间计划
        • 事件
          • 车间计划派发
          • 当前排产编辑
    • 供应链域 SC
      • 基础数据
        • 客户
          • API
            • 创建客户
            • 删除客户
            • 更新客户
            • 查询客户列表
            • 启用客户
            • 禁用客户
            • 查询客户分类列表
            • 查询企业地址
          • 事件
            • 客户创建
            • 客户删除
            • 客户更新
            • 客户禁用
            • 客户启用
            • 客户审核通过
            • 客户审核驳回
        • 客户分类
          • API
            • 创建客户分类
            • 删除客户分类
            • 更新客户分类
            • 查询客户分类列表
          • 事件
            • 客户分类创建
            • 客户分类删除
            • 客户分类更新
        • 供应商
          • API
            • 禁用供应商
            • 启用供应商
            • 创建供应商
            • 删除供应商
            • 查询供应商
            • 更新供应商
            • 分批查询供应商
          • 事件
            • 供应商创建
            • 供应商删除
            • 供应商更新
            • 供应商禁用
            • 供应商启用
            • 供应商审核通过
            • 供应商审核驳回
        • 供应商分类
          • API
            • 创建供应商分类
            • 删除供应商分类
            • 更新供应商分类
            • 查询供应商分类
            • 分批查询供应商分类
          • 事件
            • 供应商分类创建
            • 供应商分类删除
            • 供应商分类更新
        • 销售价目表
          • API
          • 事件
            • 销售价目表创建
            • 销售价目表删除
            • 销售价目表更新
            • 销售价目表审核通过
            • 销售价目表审核驳回
        • 采购价目表
          • API
          • 事件
            • 采购价目表创建
            • 采购价目表删除
            • 采购价目表更新
            • 采购价目表审核通过
            • 采购价目表审核驳回
        • 企业地址
          • API
            • 创建企业地址
            • 删除企业地址
            • 更新企业地址
            • 查询企业地址
          • 事件
      • 销售管理
        • 销售订单
          • API
            • 创建销售订单
            • 删除销售订单
            • 更新销售订单
            • 作废销售订单
            • 查询销售订单
            • 更新销售订单审核状态
            • 查询订单
          • 事件
            • 销售订单创建
            • 销售订单删除
            • 销售订单更新
            • 销售订单审核通过
            • 销售订单审核驳回
            • 销售订单完成
            • 销售订单作废
            • 销售订单加入计划
        • 发货单
          • API
            • 创建发货单
            • 删除发货单
            • 更新发货单
            • 作废发货单
            • 查询发货列表
          • 事件
            • 发货单创建
            • 发货单删除
            • 发货单更新
            • 发货单审核通过
            • 发货单审核驳回
            • 发货单完成
            • 发货单作废
        • 退货单
          • API
            • 创建退货单
            • 作废并删除退货单
          • 事件
            • 退货单创建
            • 退货单删除
            • 退货单更新
            • 退货单审核通过
            • 退货单审核驳回
            • 退货单完成
            • 退货单作废
        • 销售出库任务
          • API
            • 确认销售发货出库任务
          • 事件
            • 销售出库任务创建
            • 销售出库任务删除
            • 销售出库任务更新
            • 销售出库任务完成
            • 销售出库任务作废
        • 销售退货入库任务
          • API
            • 更新销售退货入库任务
          • 事件
            • 销售退货入库任务创建
            • 销售退货入库任务删除
            • 销售退货入库任务更新
            • 销售退货入库任务完成
            • 销售退货入库任务作废
      • 采购管理
        • 采购申请单
          • API
            • 查询采购申请列表
            • 新建采购申请
            • 编辑采购申请
            • 删除采购申请
          • 事件
            • 采购申请单作废
            • 采购申请单创建
            • 采购申请单更新
            • 采购申请单删除
            • 采购申请单审核驳回
            • 采购申请单审核通过
            • 采购申请单完成
        • 采购订单
          • API
            • 创建采购订单
            • 删除采购订单
            • 更新采购订单
            • 查询采购订单
            • 作废采购订单
            • 审核采购订单
            • 获取采购单分享链接
          • 事件
            • 采购订单创建
            • 采购订单删除
            • 采购订单更新
            • 采购订单作废
            • 采购订单审核通过
            • 采购订单审核驳回
            • 采购订单完成
        • 采购收料单
          • API
            • 创建采购收料单
            • 删除采购收料单
            • 修改采购收料单
            • 查询采购收料单
            • 作废采购收料单
          • 事件
            • 采购收料单创建
            • 采购收料单删除
            • 采购收料单更新
            • 采购收料单作废
            • 采购收料单审核通过
            • 采购收料单审核驳回
            • 采购收料单完成
        • 采购退料单
          • API
            • 作废采购退料出库任务
            • 删除采购退料出库任务
          • 事件
            • 采购退料单删除
            • 采购退料单创建
            • 采购退料单更新
            • 采购退料单审核驳回
            • 采购退料单审核通过
            • 采购退料单完成
            • 采购退料单作废
        • 采购入库任务
          • API
            • 更新采购入库任务
            • 撤销采购入库任务
          • 事件
            • 采购入库任务创建
            • 采购入库任务删除
            • 采购入库任务更新
            • 采购入库任务完成
            • 采购入库任务作废
            • 采购检验完入库任务创建
            • 采购检验完入库任务更新
            • 采购检验完入库任务完成
            • 采购检验完入库任务作废
        • 采购退料出库任务
          • API
            • 创建采购退料出库任务
            • 创建并自动完成采购退料出库任务
          • 事件
    • 厂内物流域 LOG
      • 库存任务
        • 查询还料入库任务
        • 查询备料任务
        • 确认生产入库任务
        • 确认备料出库任务
        • 确认领料出库任务
        • 确认补料出库任务
        • 创建领料申请
        • 确认还料入库任务
        • 确认生成报废任务
        • 确认库存申请入库任务
        • 确认库存申请出库任务
        • 确认移库任务
        • 确认销售发货出库任务
        • 确认销售退货入库任务
        • 完成报废入库
        • 确认生产委外入库
        • 查询生产入库任务
      • 基础数据
        • 物料
          • API
            • 删除物料单位
            • 分页物料查询
            • 创建物料
            • 创建物料单位
            • 更新物料单位
            • 更新物料
            • 批量创建物料
            • 删除物料
            • 启用物料
            • 禁用物料
            • 更新物料审核状态
            • 上传物料图纸
            • 分页查询查询物料列表
          • 事件
            • 物料创建
            • 物料删除
            • 物料更新
            • 物料审核通过
            • 物料审核驳回
            • 物料重审
            • 物料启用
            • 物料禁用
        • 物料分类
          • API
            • 删除物料分类
            • 创建物料分类
            • 更新物料分类
            • 查询物料分类
            • 分批查询物料分类
          • 事件
            • 物料分类创建
            • 物料分类删除
            • 物料分类更新
        • 单位
          • API
            • 查询单位
            • 分批查询单位
          • 事件
            • 单位创建
            • 单位删除
            • 单位更新
        • 规格
          • API
            • 删除规格
            • 创建规格
            • 更新规格
            • 查询规格
            • 分批查询规格
          • 事件
        • 仓库
          • API
            • 创建仓库
            • 删除仓库
            • 更新仓库
            • 查询仓库
            • 分批查询仓库
          • 事件
            • 仓库创建
            • 仓库删除
            • 仓库更新
            • 仓库启用
            • 仓库禁用
        • 库位
          • API
            • 创建库位
            • 查询库位
            • 分批查询库位
          • 事件
            • 库位创建
            • 库位删除
            • 库位更新
            • 默认库位设置
      • 库存申请单
        • API
          • 删除入库申请
          • 创建出库申请单
          • 创建移库申请单
          • 作废出库申请
          • 创建入库申请单
          • 作废入库申请
          • 删除出库申请
          • 创建并自动完成出库申请单
          • 创建并自动完成移库申请单
          • 查询出库申请单
          • 创建并自动完成入库申请单
          • 查询入库申请单
        • 事件
          • 申请出库单创建
          • 申请出库单删除
          • 申请出库单更新
          • 申请出库单审核通过
          • 申请出库单审核驳回
          • 申请出库单完成
          • 申请出库单作废
          • 申请入库单创建
          • 申请入库单删除
          • 申请入库单更新
          • 申请入库单审核通过
          • 申请入库单审核驳回
          • 申请入库单完成
          • 申请入库单作废
          • 申请移库单创建
          • 申请移库单删除
          • 申请移库单更新
          • 申请移库单审核通过
          • 申请移库单审核驳回
          • 申请移库单完成
          • 申请移库单作废
      • 申请出库任务
        • API
          • 更新申请出库任务
          • 查询出库申请列表
        • 事件
          • 申请出库任务创建
          • 申请出库任务删除
          • 申请出库任务更新
          • 申请出库任务完成
          • 申请出库任务作废
      • 申请入库任务
        • API
          • 更新申请入库任务
          • 查询入库申请列表
        • 事件
          • 申请入库任务创建
          • 申请入库任务删除
          • 申请入库任务更新
          • 申请入库任务完成
          • 申请入库任务作废
      • 直接移库任务
        • API
          • 移库出入库记录
          • 更新移库任务
        • 事件
          • 申请移库任务创建
          • 申请移库任务删除
          • 申请移库任务更新
          • 申请移库任务完成
          • 申请移库任务作废
      • 物料库存
        • API
          • 查询物料可用库存明细记录
          • 【删除】查询物料库存数量
          • 查询物料库存明细信息
          • 查询物料可用库存明细记录
          • 查询物料库存明细信息
        • 事件
      • 组装拆卸单
        • API
          • 查询组装拆卸单
        • 事件
          • 组装单创建
          • 组装单删除
          • 组装单更新
          • 组装单审核通过
          • 组装单审核驳回
          • 组装单完成
          • 组装单作废
          • 拆卸单创建
          • 拆卸单删除
          • 拆卸单更新
          • 拆卸单审核通过
          • 拆卸单审核驳回
          • 拆卸单完成
          • 拆卸单作废
      • 出入库记录
        • 事件
          • 出入库记录创建
          • 出入库记录撤销
    • 设备域EQUIP
      • 基础数据
        • 设备
          • API
            • 创建设备
            • 更新设备
            • 删除设备
            • 查询设备
          • 事件
            • 设备创建
            • 设备删除
            • 设备更新
            • 设备分类创建
            • 设备分类删除
            • 设备分类更新
      • IOT对接
        • 对接设备数据
    • 3Chat域
      • 智能体(Agent)
        • API
          • 发送消息
        • 事件
      • 渠道(Channel)
        • API
          • 发送消息
        • 事件
      • 流程(Flow)
        • API
          • Coze
      • 会话(Dialog)
        • API
          • 查询
        • 事件
          • 创建会话
      • 访客(Visitor)
        • API
          • 查询
          • 更新访客信息
        • 事件
          • 创建访客
          • 更新访客
      • 对话(Conversation)
        • API
          • 主动转人工服务
          • 查询
        • 事件
          • 创建对话
          • 更新对话
          • 再次加入对话
          • 转人工
    • 用户与租户域 USER
      • 员工
        • API
          • 创建员工
          • 更新员工
        • 事件
          • 员工创建
          • 员工删除
          • 员工更新
          • 员工启用
          • 员工禁用
          • 部门创建
          • 部门删除
          • 部门更新
      • 部门
        • API
          • 创建部门
          • 更新部门
        • 事件
    • 基础域DM
      • 文件管理
        • API
          • 上传文件
        • 事件
      • 低代码平台CPS
        • API
          • 查询表单详情
          • 查询表单列表
          • 保存或更新表单
          • 删除表单
      • 开发平台
        • API
          • 更新事件日志状态
    • 采购申请
  • 客户案例
    • 集成案例
      • MES与畅捷通T+无缝集成,破解业财数据割离难题
      • 电子组装行业——金蝶云星空ERP与新核云MES集成案
  1. 集成案例

电子组装行业——金蝶云星空ERP与新核云MES集成案

1. 方案场景#

1.1 业务背景描述#

🔖
某电子组装企业,采用 “多品种、小批量” 的生产模式,对物料追溯、BOM管理及业财一体化有极高要求。其生产执行层深度使用新核云 MES 进行精细化管理,企业资源计划层则使用金蝶云星空 ERP。

1.2 客户痛点#

💡
数据不同源,维护成本高: 物料、BOM等基础数据需在ERP和MES中分别维护,重复录入工作量大,且极易出现两地数据不一致的情况,IT部门疲于奔命。
业务协同滞后: 工单、用料计划等业务单据依赖人工从ERP同步至MES,信息传递延迟且易出错,无法实现生产计划的快速下达与调整。
追溯链条断裂: ERP的批次/序列号管理策略无法直接穿透到生产现场,MES的丰富追溯数据(如供应商暗码、组件号)也难以回传至ERP,形成信息孤岛,质量追溯效率低下。

1.3 目标愿景#

💡
企业旨在通过系统集成,构建一套无缝衔接的数字化生产管理体系:
主数据统一:​ 实现物料、BOM等核心数据“一次创建,双向同步”,确保数据源唯一。
业务流自动:​ 生产工单及用料清单自动同步至MES,触发生产执行,打通计划与执行层。
追溯体系贯通:​ 建立从ERP到MES的完整正向与反向追溯链条,提升质量管控与客户响应能力。

2. 解决方案#

2.1 方案总览#

💡
基于新核云开放平台,该方案为客户搭建了一条从金蝶云星空ERP到新核云MES的 自动化数据通道。通过标准API接口实现基础数据同步,利用Webhook机制完成业务状态回传,构建了完整的双向数据流。该方案完美实现了主数据的单向同步与业务单据的双向实时联动.
具体数据流如下图所示:
image.png
注意:集成的时候 ERP 和 MES 的角色要分开。

2.2 方案优势#

💡
开箱即用,高效集成: 利用新核云开放平台提供的标准API与Webhook,无需从零开发,大幅降低集成复杂度和开发成本,缩短项目周期。
业务可配,灵活适配: 通过开放平台的配置能力,支持PE工程师、IT工程师、质量工程师等多角色协同参与MES生产基础数据维护,可灵活配置仓库、工序、质量方案等同步规则,轻松满足客户个性化的业务流程需求。
数据深度穿透,追溯无忧: 成功将ERP的物料追溯属性(批次/序列号)及行业特色字段(物料暗码、供应商暗码等)映射至MES自定义字段,构建了业界领先的深度追溯体系。
复杂业务处理能力强: 完美支持在制品改制单等复杂业务场景,能够处理多工序、多状态的在制品流转与改制需求,确保业务逻辑的完整性和准确性。

3. 集成方式#

3.1 核心集成点#

基础数据同步业务单据流转
物料分类与库存单位普通生产单全流程自动化(从创建到齐套分析再到计划排产)
物料信息库与物料编码返工单特殊处理流程
BOM数据(从PLM到ERP再到MES)在制品改制单复杂业务逻辑处理
仓库信息生产工单状态同步与回传
供应商暗码与物料暗码

3.2 集成步骤#

基础数据同步;#

基础数据从金蝶云星空ERP向新核云MES单向同步,确保MES以ERP为唯一数据源头。同步过程由ERP端事件触发,通过调用新核云开放平台API完成。
1.
物料同步:​
触发条件:​ 金蝶云星空ERP中物料主数据发生创建、修改或审核通过事件。
动作描述:​ ERP系统监听物料变化事件,自动调用新核云开放平台的物料相关 API,将物料信息(包括物料编码、名称、规格型号、库存单位、分类等)同步至MES。同步时需处理字段映射(如ERP的“物料编码”映射至MES的“物料号”)和单位换算。
实现要点:​ 确保数据唯一性,避免重复同步;支持增量同步,通过时间戳或版本号管理变更。
2.
BOM(物料清单)同步:​
触发条件:​ 金蝶云星空ERP中BOM数据审核通过或发生变更(BOM通常从PLM系统流转至ERP)。
动作描述:​ ERP调用新核云开放平台的BOM API(如POST /api/boms),将BOM数据(包括父项物料、子项物料、用量、替代料信息等)同步至MES。同步时需处理多级BOM结构和版本控制。
实现要点:​ 字段映射包括BOM编号、物料关系、损耗率;递归同步子项BOM,确保结构完整。
以下是BOM数据同步的代码示例:
3.
其他基础数据同步:
仓库信息同步: ERP中仓库创建或变更时,通过API同步至MES,确保仓库主数据一致。
以下是仓库信息同步代码示例:

业务单据流转;#

业务单据涉及双向数据流,确保ERP与MES之间的业务协同。以下步骤覆盖生产单同步、状态回传及辅助单据集成,提供两种生产单同步方案以适应不同业务场景。
1.
生产单同步:
生产单同步支持两种方案,企业可根据业务实时性要求选择其一或组合使用。
方案一:分步同步(先工单后用料清单)
步骤1: 生产订单同步
触发条件: 金蝶云星空ERP中生产订单创建。
动作描述: ERP调用新核云开放平台的生产工单API,将生产订单基础数据(如单号、产品、计划数量、计划时间)首次同步至MES,在MES中生成对应的生产任务。
实现要点: 工单同步后,MES自动进行齐套分析预备;字段映射需确保工单状态对应(如ERP的“已发布”映射至MES的“待生产”)。
步骤2: 用料清单同步
触发条件: ERP中为上述生产订单生成详细的用料清单(领料计划)。
动作描述: ERP再次调用新核云API(如工单更新接口),用用料清单明细(包括物料、用量、替代料)更新MES中已存在的对应生产任务,完善齐套信息。
实现要点: 通过工单号关联两次调用,确保数据一致性;用料清单同步可触发MES的领料任务生成。
适用场景: 适用于生产订单和用料清单分阶段生成的业务,实时性要求高,但需两次API调用。
以下是示例代码:
方案二:一次性同步(工单与用料清单整合)​
触发条件:​ ERP中生产订单及用料清单均已就绪。
动作描述:​ ERP将生产单信息与用料清单整合为一个完整的数据包,通过一次API调用同步至MES,直接生成带齐套明细的生产任务。
实现要点:​ 数据包需包含工单基本信息和用料明细;MES侧一次性处理齐套分析,减少交互次数。
适用场景:​ 适用于生产数据准备完整的场景,简化流程,提升效率。
企业可结合方案一和方案二,例如初始化时使用方案二批量同步,日常变更使用方案一实时同步。
2.
生产工单状态同步与回传:
触发条件: 新核云MES中生产工单状态发生变化(如开始生产、完工、暂停)。
动作描述: 通过新核云开放平台的Webhook机制,订阅MES工单状态事件。当状态变化时,自动将状态信息(工单号、当前状态、更新时间)推送至金蝶云星空ERP,更新ERP工单状态。
实现要点: 配置Webhook回调URL指向ERP系统;处理状态映射(如MES的“完工”对应ERP的“已完成”);支持复杂状态(如返工单)。
3.
入库任务同步:
触发条件: 新核云MES中生产完成,执行入库操作(如成品入库)。
动作描述: MES调用新核云开放平台的API(如POST /api/inbound-tasks),将入库结果(入库单号、物料、数量、批次号)实时同步回ERP,更新ERP库存。
实现要点: 确保入库单与ERP单据匹配;支持序列号或批次追溯。
4.
领料单集成:
触发条件: 金蝶云星空ERP中生成领料单(基于生产工单),或新核云MES中生成生产领料任务。
动作描述: 领料单从ERP同步至MES,但需确保MES中对应生产领料任务已存在。通常,在MES领料任务生成时,调用ERP API获取领料单信息;或ERP在领料单创建时调用MES API,但先验证任务存在。
实现要点: 前提是MES生产工单已创建且齐套;字段映射包括领料单号、物料、数量;处理物料短缺异常。
5.
其他业务单据集成:
其他入库单同步: ERP端的采购入库等单据,通过API同步至MES的“其他入库”单据,逻辑类似入库任务同步。
复杂业务处理: 对于在制品改制单等复杂场景,通过定制API调用处理多工序流转,确保业务逻辑完整。

3.4 开发者资源#

💡
本方案为新核云开放平台与主流ERP集成的典范,您可参考以下资源快速启动开发:
新核云Webhook事件订阅文档(用于MES业务数据回传ERP)
新核云Open API文档(用于接收ERP数据写入MES)
金蝶云星空开放平台接口文档
本文档提及的示例代码

4. 客户价值总结#

🔎
该集成方案的成功落地,为电子组装行业提供了系统集成的标准范式:
对客户而言: 实现了 “ERP计划- MES执行” 的高效闭环,消除了信息孤岛,提升了生产效率和数据准确性,为精益管理和数字化升级奠定了坚实基础。
对新核云开放平台而言: 验证了平台作为 “制造业系统连接器” 的强大能力,积累了与金蝶等国内头部ERP集成的宝贵经验,该方案可快速复用于同类客户。
对行业而言: 为多品种、小批量的离散制造企业提供了 低成本、高效益、快交付 的业财一体化最佳实践,极具借鉴和推广价值。

5. 方案咨询#

📞 如果您也正面临金蝶ERP与新核云MES集成,或与其他系统打通的挑战,新核云开放平台为您提供了成熟、可靠 的解决方案。
您是业务负责人/企业管理者?
欢迎联系我们的解决方案专家,为您量身定制集成方案,评估业务价值。
联系电话: +(86) 400-164-1521 | 邮箱: contact@xinheyun.com
您是开发者、技术经理或系统集成商?
立即免费注册为新核云开发者,获取API密钥,探索所有开放能力,快速启动您的集成项目!
欢迎前往 新核云社区——开放平台板块交流技术问题、分享集成心得!
修改于 2025-09-29 09:00:15
上一页
MES与畅捷通T+无缝集成,破解业财数据割离难题
Built with