金蝶云星空对接打通管易云盘盈单查询接口与其他入库单新增完结接口接口
数据源系统:金蝶云星空
金蝶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 | 单据类型 | FBillTypeID | |
| FStockerId | 仓管员 | FStockerId | |
| FCreatorId | 创建人 | FCreatorId | |
| FCreateDate | 创建日期 | FCreateDate | |
| FModifierId | 最后修改人 | FModifierId | |
| FModifyDate | 最后修改日期 | FModifyDate | |
| FApproverId | 审核人 | FApproverId | |
| FApproveDate | 审核日期 | FApproveDate | |
| FNoteHead | 备注 | FNoteHead | |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber | |
| FUnitID | 单位 | FUnitID | |
| FAcctQty | 账存数量 | FAcctQty | |
| FCountQty | 盘点数量 | FCountQty | |
| FGainQty | 盘盈数量 | FGainQty | |
| FStockId_FNumber | 仓库 | FStockId.FNumber | |
| FStockStatusId | 库存状态 | FStockStatusId | |
| FOwnerid_FNumber | 货主 | FOwnerid.FNumber | |
| FPrice | 成本价 | FPrice | |
| FAmount | 总成本 | FAmount | |
| Fnote | 备注 | Fnote | |
| FBomId | BOM版本 | FBomId | |
| FMtoNo | 计划跟踪号 | FMtoNo | |
| FStockFlag | 库存更新标识 | FStockFlag | |
| FStockLocId | 仓位编码 | FStockLocId.FF100001.fnumber | |
| FLOT_FNumber | 批号 | FLOT.FNumber | |
| FBusinessDate | 入库日期 | FBusinessDate | |
| FCMKBarCode | 零售条形码 | FCMKBarCode | |
| FLOT_FInStockDate | 批号入库日期 | FLOT.FInStockDate | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | STK_StockCountGain | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | | |
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDocumentStatus | 单据状态 | | |
| FStockOrgId_FNumber | 库存组织 | | |
| FDate | 日期 | | |
| FBillTypeID | 单据类型 | | |
| FStockerId | 仓管员 | | |
| FCreatorId | 创建人 | | |
| FCreateDate | 创建日期 | | |
| FModifierId | 最后修改人 | | |
| FModifyDate | 最后修改日期 | | |
| FApproverId | 审核人 | | |
| FApproveDate | 审核日期 | | |
| FNoteHead | 备注 | | |
| FMaterialId_FNumber | 物料编码 | | |
| FUnitID | 单位 | | |
| FAcctQty | 账存数量 | | |
| FCountQty | 盘点数量 | | |
| FGainQty | 盘盈数量 | | |
| FStockId_FNumber | 仓库 | | |
| FStockStatusId | 库存状态 | | |
| FOwnerid_FNumber | 货主 | | |
| FPrice | 成本价 | | |
| FAmount | 总成本 | | |
| Fnote | 备注 | | |
| FBomId | BOM版本 | | |
| FMtoNo | 计划跟踪号 | | |
| FStockFlag | 库存更新标识 | | |
| FStockLocId | 仓位编码 | | |
| FLOT_FNumber | 批号 | | |
| FBusinessDate | 入库日期 | | |
| FCMKBarCode | 零售条形码 | | |
| FLOT_FInStockDate | 批号入库日期 | | |
管易云接口明细
- 调用接口：gy.erp.stock.other.in.add
- 接口名称：其他入库单新增完结接口
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| warehouse_code | 仓库代码 | string | {{FStockId_FNumber}} |
| type | 入库类型代码 | string | |
| note | 备注 | string | 金蝶盘盈单{{FBillNo}} |
| details | 入库明细 | array | details |
| details.item_code | 商品代码 | string | {{details.FMaterialId_FNumber}} |
| details.sku_code | 规格代码 | string | |
| details.barcode | 商品条码 | string | |
| details.qty | 数量 | string | {{details.FGainQty}} |
| details.uniqueCode | 唯一码 | string | |
| details.batchNumber | 批次号 | string | |
| details.manufacturingDate | 生产日期 | string | |
| details.shelfLife | 有效期 | string | |
| details.stockDate | 入库日期 | string | |
| details.wms_bizcode | 第三方系统单号 | string | yajj{{FBillNo}} |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| success | 成功与否 | string | |
| errorCode | 错误代码 | string | |
| subErrorCode | 子错误代码 | string | |
| errorDesc | 错误描述 | string | |
| subErrorDesc | 子错误描述 | string | |
| requestMethod | 请求方法 | string | |
| code | 其他入库单单据编号 | string | |
系统集成总览
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
