从金蝶云星空到管易云通过接口集成数据
对接源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
写入目标:管易云
管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌，先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务，涵盖电商业务全流程。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：调拨单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：管易云接口：其他出库单新增完结接口，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：管易云写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
金蝶云星空接口明细
- API：executeBillQuery
- NAME：调拨单查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillEntry_FEntryID | FEntryID | FBillEntry_FEntryID |
| FID | 实体主键 | FID |
| FBillNo | 单据编号 | FBillNo |
| FDocumentStatus | 单据状态 | FDocumentStatus |
| FStockOrgId_FNumber | 调入库存组织 | FStockOrgId.FNumber |
| FDate | 日期 | FDate |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber |
| FTransferBizType | 调拨类型 | FTransferBizType |
| FStockOutOrgId_FNumber | 调出库存组织 | FStockOutOrgId.FNumber |
| FTransferDirect | 调拨方向 | FTransferDirect |
| FNote | 备注 | FNote |
| FBizType | 业务类型 | FBizType |
| FSaleOrgId_FNumber | 销售组织 | FSaleOrgId.FNumber |
| FSettleOrgId_FNumber | 结算组织 | FSettleOrgId.FNumber |
| FCustID_FNumber | 对应客户 | FCustID.FNumber |
| FSUPPLIERID_FNumber | 对应供应商 | FSUPPLIERID.FNumber |
| FThirdSrcId | 第三方源单内码 | FThirdSrcId |
| FThirdSrcBillNo | 第三方源单编码 | FThirdSrcBillNo |
| FThirdSystem | 第三方系统 | FThirdSystem |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber |
| FLot_FNumber | 调出批号 | FLot.FNumber |
| FSrcStockId_FNumber | 调出仓库 | FSrcStockId.FNumber |
| FSrcStockLocId | 调出仓位 | FSrcStockLocId |
| FDestStockId_FNumber | 调入仓库 | FDestStockId.FNumber |
| FDestStockLocId | 调入仓位 | FDestStockLocId |
| FQty | 调拨数量 | FQty |
| FPrice | 成本价 | FPrice |
| FAmount | 总成本 | FAmount |
| FBomId | BOM版本 | FBomId |
| FProduceDate | 生产日期 | FProduceDate |
| FExpiryDate | 有效期至 | FExpiryDate |
| FMtoNo | 计划跟踪号 | FMtoNo |
| FSrcStockStatusId | 调出库存状态 | FSrcStockStatusId |
| FDestStockStatusId | 调入库存状态 | FDestStockStatusId |
| FOwnerId_FNumber | 调入货主 | FOwnerId.FNumber |
| FOwnerOutId_FNumber | 调出货主 | FOwnerOutId.FNumber |
| FSrcBillTypeId | 源单类型 | FSrcBillTypeId |
| FSrcSeq | 源单行号 | FSrcSeq |
| FOrderNo | 订单编号 | FOrderNo |
| FNoteEntry | 备注 | FNoteEntry |
| FSrcBillNo | 源单编号 | FSrcBillNo |
| FBFLowId | 业务流程 | FBFLowId |
| FConsignPrice | 单价 | FConsignPrice |
| FTaxPrice | 含税单价 | FTaxPrice |
| FTaxRate | 税率% | FTaxRate |
| FDestLot_FNumber | 调入批号 | FDestLot.FNumber |
| FQmEntryId | 库存请检单EntryId | FQmEntryId |
| FConvertEntryId | 库存状态转换EntryId | FConvertEntryId |
| FSOEntryId | 销售订单EntryId | FSOEntryId |
| FThirdSrcEntryId | 第三方源单分录编码 | FThirdSrcEntryId |
| FISFREE | 赠品 | FISFREE |
| FMaterialId_FBARCODE | 条码 | FMaterialId.FBARCODE |
| FLot_FInStockDate | 调出批号入库日 | FLot.FInStockDate |
| FDestLot_FInStockDate | 调入批号入库日 | FDestLot.FInStockDate |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| FieldKeys | 需查询的字段key集合 | |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FSrcStockId.F_ORA_TBDX = 1 and FMaterialId.FIsSalseByNet = 1 and FDestStockId <> FSrcStockId |
| FormId | 业务对象表单Id | STK_TransferDirect |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillEntry_FEntryID | FEntryID | |
| FID | 实体主键 | |
| FBillNo | 单据编号 | |
| FDocumentStatus | 单据状态 | |
| FStockOrgId_FNumber | 调入库存组织 | |
| FDate | 日期 | |
| FBillTypeID_FNumber | 单据类型 | |
| FTransferBizType | 调拨类型 | |
| FStockOutOrgId_FNumber | 调出库存组织 | |
| FTransferDirect | 调拨方向 | |
| FNote | 备注 | |
| FBizType | 业务类型 | |
| FSaleOrgId_FNumber | 销售组织 | |
| FSettleOrgId_FNumber | 结算组织 | |
| FCustID_FNumber | 对应客户 | |
| FSUPPLIERID_FNumber | 对应供应商 | |
| FThirdSrcId | 第三方源单内码 | |
| FThirdSrcBillNo | 第三方源单编码 | |
| FThirdSystem | 第三方系统 | |
| FMaterialId_FNumber | 物料编码 | |
| FLot_FNumber | 调出批号 | |
| FSrcStockId_FNumber | 调出仓库 | |
| FSrcStockLocId | 调出仓位 | |
| FDestStockId_FNumber | 调入仓库 | |
| FDestStockLocId | 调入仓位 | |
| FQty | 调拨数量 | |
| FPrice | 成本价 | |
| FAmount | 总成本 | |
| FBomId | BOM版本 | |
| FProduceDate | 生产日期 | |
| FExpiryDate | 有效期至 | |
| FMtoNo | 计划跟踪号 | |
| FSrcStockStatusId | 调出库存状态 | |
| FDestStockStatusId | 调入库存状态 | |
| FOwnerId_FNumber | 调入货主 | |
| FOwnerOutId_FNumber | 调出货主 | |
| FSrcBillTypeId | 源单类型 | |
| FSrcSeq | 源单行号 | |
| FOrderNo | 订单编号 | |
| FNoteEntry | 备注 | |
| FSrcBillNo | 源单编号 | |
| FBFLowId | 业务流程 | |
| FConsignPrice | 单价 | |
| FTaxPrice | 含税单价 | |
| FTaxRate | 税率% | |
| FDestLot_FNumber | 调入批号 | |
| FQmEntryId | 库存请检单EntryId | |
| FConvertEntryId | 库存状态转换EntryId | |
| FSOEntryId | 销售订单EntryId | |
| FThirdSrcEntryId | 第三方源单分录编码 | |
| FISFREE | 赠品 | |
| FMaterialId_FBARCODE | 条码 | |
| FLot_FInStockDate | 调出批号入库日 | |
| FDestLot_FInStockDate | 调入批号入库日 | |
管易云接口明细
- API：gy.erp.stock.other.out.add
- NAME：其他出库单新增完结接口
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| warehouse_code | 仓库代码 | {{FSrcStockId_FNumber}} |
| type | 出库类型代码 | |
| note | 备注 | 金蝶调拨出库{{FBillNo}}{{FSrcStockId_FNumber}} |
| wms_bizcode | 第三方系统单号 | {{FBillNo}}{{FSrcStockId_FNumber}} |
| receiver_name | 收货人 | |
| receiver_mobile | 收货人手机 | |
| receiver_zip | 收货人邮编 | |
| receiver_address | 收货人地址 | |
| receiver_province | 收货人省名称 | |
| receiver_citye | 收货人市名称 | |
| receiver_district | 收货人区名称 | |
| details | 出库明细 | details |
| details.note | 备注 | |
| details.item_code | 商品代码 | {{details.FMaterialId_FNumber}} |
| details.sku_code | 规格代码 | |
| details.barcode | 商品条码 | |
| details.location_code | 库位代码(库位名称） | |
| details.qty | 数量 | {{details.FQty}} |
| details.uniqueCode | 唯一码 | |
| details.batchNumber | 批次号 | |
| details.manufacturingDate | 生产日期 | |
| details.shelfLife | 有效期 | |
| details.stockDate | 入库日期 | |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| success | 成功与否 | |
| errorCode | 错误代码 | |
| subErrorCode | 子错误代码 | |
| errorDesc | 错误描述 | |
| subErrorDesc | 子错误描述 | |
| requestMethod | 请求方法 | |
| code | 其他出库单单据编号 | |
数据对接效果
全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。
