金蝶云星空和管易云接口打通对接实战
对接系统金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
写入目标:管易云
金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。
数据接口配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将金蝶云星空、管易云之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：其他出库查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FOWNERID | 货主 | string |
| FSRCBILLNO | 源单编号 | string |
| FDate | 日期 | string |
| FSTOCKFLAG | 库存更新标志 | string |
| FProjectNo | 项目编号 | string |
| FBillNo | 单据编号 | string |
| FStockLocId | 仓位编码 | string |
| FSRCBILLTYPEID | 源单类型 | string |
| FSTOCKID_FNumber | 收货仓库 | string |
| FilterString | 过滤条件 | string |
| FEntity_FEntryID | FEntryID | string |
| FLOT_FInStockDate | 批号入库日期 | string |
| FStockOrgId_FNumber | 库存组织 | string |
| FDocumentStatus | 单据状态 | string |
| FormId | 业务对象表单Id | string |
| FNOTE | 备注 | string |
| FBillTypeID | 单据类型 | string |
| FLOT_FNumber | 批号 | string |
| FQty | 实收数量 | string |
| FEntryNote | 备注 | string |
| StartRow | 开始行索引 | string |
| FCMKBarCode | 零售条形码 | string |
| FJoinQty | 关联数量 | string |
| FAmount | 总成本 | string |
| FEXPIRYDATE | 有效期至 | string |
| FID | 实体主键 | string |
| FSTOCKSTATUSID | 库存状态 | string |
| FPRODUCEDATE | 生产日期 | string |
| TopRowCount | 返回总行数 | int |
| FMTONO | 计划跟踪号 | string |
| FieldKeys | 需查询的字段key集合 | array |
| FMATERIALID_FNumber | 物料编码 | string |
| Limit | 最大行数 | string |
| FPrice | 成本价 | string |
| FBOMID | BOM版本 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FEntity_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FNOTE | 备注 | string | |
| FMATERIALID_FNumber | 物料编码 | string | |
| FSTOCKID_FNumber | 收货仓库 | string | |
| FQty | 实收数量 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FBOMID | BOM版本 | string | |
| FPRODUCEDATE | 生产日期 | string | |
| FEXPIRYDATE | 有效期至 | string | |
| FMTONO | 计划跟踪号 | string | |
| FProjectNo | 项目编号 | string | |
| FSTOCKSTATUSID | 库存状态 | string | |
| FOWNERID | 货主 | string | |
| FSTOCKFLAG | 库存更新标志 | string | |
| FJoinQty | 关联数量 | string | |
| FSRCBILLTYPEID | 源单类型 | string | |
| FSRCBILLNO | 源单编号 | string | |
| FLOT_FInStockDate | 批号入库日期 | string | |
| FEntryNote | 备注 | string | |
| FStockLocId | 仓位编码 | string | |
| FCMKBarCode | 零售条形码 | string | |
| FLOT_FNumber | 批号 | string | |
管易云接口明细
- 调用接口：gy.erp.stock.other.out.add
- 接口名称：其他出库单新增完结接口
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| warehouse_code | 仓库代码 | string | {{FSTOCKID_FNumber}} |
| type | 出库类型代码 | string | |
| note | 备注 | string | 金蝶其他出库{{FBillNo}} |
| wms_bizcode | 第三方系统单号 | string | {{FBillNo}}{{FSTOCKID_FNumber}} |
| receiver_name | 收货人 | string | |
| receiver_mobile | 收货人手机 | string | |
| receiver_zip | 收货人邮编 | string | |
| receiver_address | 收货人地址 | string | |
| receiver_province | 收货人省名称 | string | |
| receiver_citye | 收货人市名称 | string | |
| receiver_district | 收货人区名称 | string | |
| details | 出库明细 | array | details |
| details.note | 备注 | string | |
| details.item_code | 商品代码 | string | {{details.FMATERIALID_FNumber}} |
| details.sku_code | 规格代码 | string | |
| details.barcode | 商品条码 | string | |
| details.location_code | 库位代码(库位名称） | string | |
| details.qty | 数量 | string | {{details.FQty}} |
| details.uniqueCode | 唯一码 | string | |
| details.batchNumber | 批次号 | string | |
| details.manufacturingDate | 生产日期 | string | |
| details.shelfLife | 有效期 | string | |
| details.stockDate | 入库日期 | string | |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| success | 成功与否 | string | |
| errorCode | 错误代码 | string | |
| subErrorCode | 子错误代码 | string | |
| errorDesc | 错误描述 | string | |
| subErrorDesc | 子错误描述 | string | |
| requestMethod | 请求方法 | string | |
| code | 其他出库单单据编号 | string | |
数据对接价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到管易云之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
