Katana云制造集成金蝶云星空解决方案
更新: 9/22/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Katana 云制造（Cloud Manufacturing） |  | 金蝶云星空 ERP |
Katana 是一款面向中小型制造企业、带自建产线的 DTC 品牌的云端制造 ERP（MRP），覆盖产品与变体、物料与 BOM（配方）、销售订单、采购订单、制造订单（生产工单）、库存（多仓库存）等核心制造场景。这类企业通常把生产执行与库存放在 Katana，而把财务核算、应收应付、总账放在金蝶云星空。
当两套系统割裂运行时，企业普遍遇到以下问题：
- 生产完工不进财务：Katana 的制造订单（Manufacturing Order）完工后，产品入库与材料成本无法自动进入金蝶，成本核算滞后、手工补录易错。
- 销售订单与应收脱节：Katana 销售订单（含多币种、客户、商品行）未同步金蝶，财务无法及时确认收入与应收。
- 库存账实不符：Katana 多仓库存（stock items）变动（入库、调整、调拨）不同步金蝶存货，导致账实差异、盘点困难。
- 采购未进应付：Katana 采购订单与到货不进金蝶，供应商应付与资金计划脱节。
- 双系统重复录单：计划员在 Katana 录一次、财务在金蝶再录一次，效率低且口径不一致。
通过成集云 iPaaS 数据集成平台，将 Katana 开放 API（Bearer Token，Base https://api.katanamrp.com/v1）与金蝶云星空 OpenAPI 打通，构建"基础资料 + 销售 / 采购 / 生产 / 库存"的自动化同步链路，实现生产制造与财务核算的真正一体化。
解决方案
基于成集云数据集成平台，预置 Katana 与金蝶云星空的连接器。Katana 侧通过 API Key（Bearer Token）授权访问其 REST API，金蝶侧通过开放平台 AppKey/AppSecret 授权。再以可视化编排配置"产品 / 物料主数据同步、客户供应商同步、销售订单转应收、采购订单转应付、制造订单完工入库、库存实时同步"等自动任务，结合 Katana Webhook（订单创建 / 更新 / 删除、库存变动）实现近实时触发，把制造侧业务自动落地到金蝶财务单据。
业务流程
一、基础资料同步流程
1. 产品 / 物料主数据同步
Katana 的 products / materials（含变体 variant）是制造与核算的基础，成集云将其同步为金蝶的物料档案。
2. 客户 / 供应商主数据同步
Katana 的客户（销售侧）与供应商（采购侧）同步为金蝶客户与供应商档案，保证往来单位一致。
二、业务单据同步流程
3. 销售订单转销售订单 / 应收
Katana sales_orders（含 customer_id、sales_order_rows[variant_id, quantity, price_per_unit]、币种 currency 与折算率 conversion_rate、状态）同步为金蝶销售订单与应收单。
4. 采购订单转采购订单 / 应付
Katana purchase_orders（供应商、物料、数量、金额）同步为金蝶采购订单与应付单，支撑供应商对账与资金计划。
5. 制造订单完工入库与成本核算
Katana manufacturing_orders 状态变为 DONE（完工）时，成集云触发金蝶产品入库单，并按 BOM 归集材料成本，完成生产成本核算。
6. 库存实时同步
Katana stock_items（多地点、库存数量、库存调整与调拨）变动实时同步金蝶存货余额，保持账实一致。
对接说明
一、基础资料同步（Katana → 金蝶）
| Katana 字段 | 金蝶字段 | 说明 |
|---|---|---|
products / materials（id / variant_id / SKU） | 物料编码 / 名称 / 规格 | SKU 作为唯一键 |
materials（BOM / 配方） | 物料清单（BOM） | 支撑成本核算 |
客户（customer_id 关联） | 客户档案 | |
| 供应商（采购侧） | 供应商档案 |
二、业务单据同步（Katana → 金蝶）
- 销售订单 → 销售订单 / 应收单：
sales_order_rows的variant_id、quantity、price_per_unit映射金蝶销售订单行；currency+conversion_rate处理多币种与本位币折算；status（NOT_SHIPPED / PACKED / DELIVERED）映射订单状态。 - 采购订单 → 采购订单 / 应付单：供应商、物料、数量、金额映射，支撑三单匹配。
- 制造订单完工 → 生产入库 / 成本：
status=DONE触发产品入库，并按materialsBOM 归集材料成本，生成成本凭证。 - 库存 → 存货余额：
stock_items按location_id分仓同步，库存调整 / 调拨实时回写。
三、同步规则与过滤条件
- 触发方式：主数据（产品 / 物料 / 客户 / 供应商）按
updated_at定时增量拉取；销售订单、制造订单、库存变动通过 Katana Webhook（order created / updated / deleted、stock changed）近实时触发。 - 去重主键：各单据以 Katana 对象
id去重（如sales_order.id、manufacturing_order.id），避免重复建单。 - 币种折算：以
conversion_rate/conversion_date折算本位币，保证财务口径一致。 - 异常处理：API Key 失效（401）自动告警并暂停，支持按时间窗口补拉历史数据。
- 权限：Katana API 需 Professional 及以上套餐并生成 API Key，密钥仅在服务端（成集云）保存，不落地前端。
业务价值
- 生产—财务一体化：制造订单完工自动进金蝶入库与成本核算，财务月结不再等生产手工报工。
- 库存账实一致：多仓库存实时同步金蝶，盘点差异显著下降，资金占用更透明。
- 应收应付自动：销售 / 采购订单自动生成应收 / 应付，供应商与客户对账效率大幅提升。
- 消除重复录单：计划与财务各录一次的历史被打破，数据口径统一，人力成本下降。
- 多币种与全球化：
conversion_rate自动折算本位币，支撑出海制造企业的跨境核算。
接口文档
- Katana API 开发者门户（Getting Started / OpenAPI）：https://developer.katanamrp.com/
- Katana API 对象参考（Sales Order / Product / Stock / Manufacturing Order）：https://developer.katanamrp.com/reference/
- 金蝶云星空开放 API 文档（开放平台）