金蝶云星空和网店管家接口打通对接实战
对接系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标平台:网店管家
多系统对接方案配置
通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的盘盈单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为网店管家，并且选择对应连接器。选择对应的创建入库单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：盘盈单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FStockerId | 仓管员 | string | |
| FCreatorId | 创建人 | string | |
| FCreateDate | 创建日期 | string | |
| FModifierId | 最后修改人 | string | |
| FModifyDate | 最后修改日期 | string | |
| FApproverId | 审核人 | string | |
| FApproveDate | 审核日期 | string | |
| FNoteHead | 备注 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FUnitID | 单位 | string | |
| FAcctQty | 账存数量 | string | |
| FCountQty | 盘点数量 | string | |
| FGainQty | 盘盈数量 | string | |
| FStockId_FNumber | 仓库 | string | |
| FStockStatusId | 库存状态 | string | |
| FOwnerid_FNumber | 货主 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| Fnote | 备注 | string | |
| FBomId | BOM版本 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FStockFlag | 库存更新标识 | string | |
| FStockLocId | 仓位 | string | |
| FLOT | 批号 | string | |
| FBusinessDate | 入库日期 | string | |
| FCMKBarCode | 零售条形码 | string | |
| FBARCODE | 条码 | string | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillEntry_FEntryID | FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 库存组织 | string | |
| FDate | 日期 | string | |
| FBillTypeID | 单据类型 | string | |
| FStockerId | 仓管员 | string | |
| FCreatorId | 创建人 | string | |
| FCreateDate | 创建日期 | string | |
| FModifierId | 最后修改人 | string | |
| FModifyDate | 最后修改日期 | string | |
| FApproverId | 审核人 | string | |
| FApproveDate | 审核日期 | string | |
| FNoteHead | 备注 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FUnitID | 单位 | string | |
| FAcctQty | 账存数量 | string | |
| FCountQty | 盘点数量 | string | |
| FGainQty | 盘盈数量 | string | |
| FStockId_FNumber | 仓库 | string | |
| FStockStatusId | 库存状态 | string | |
| FOwnerid_FNumber | 货主 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| Fnote | 备注 | string | |
| FBomId | BOM版本 | string | |
| FMtoNo | 计划跟踪号 | string | |
| FStockFlag | 库存更新标识 | string | |
| FStockLocId | 仓位 | string | |
| FLOT | 批号 | string | |
| FBusinessDate | 入库日期 | string | |
| FCMKBarCode | 零售条形码 | string | |
| FBARCODE | 条码 | string | |
网店管家接口明细
- 接口：wdgj.stockin.create
- 接口名称：创建入库单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| providerno | 供应商编码 | String | 供应商编码 |
| warehouseno | 仓库编码 | String | 仓库编码 |
| operater | 操作员 | String | 操作员 |
| remark | 备注 | String | 备注 |
| operationtype | 操作类型 | String | 操作类型 2 采购入库 3退货入库 5库存盘点 9调拨入库 10 生产入库 0 其它入库 |
| summary | 摘要 | String | 摘要 |
| stockno | 入库单号 | String | 入库单号 |
| keytype | keytype | String | 货品主键类型 1：货品编号和规格名称，2：goodsid和specid，3;条码+附加码 |
| thecause | 入库原因 | String | 0：其它入库时有效（默认 “其它入库”） |
| goodslist | 货品信息 | array | 货品信息 |
| goodslist.goodsno | 货品编号 | String | 货品编号 |
| goodslist.barcode | 条码+附加码 | String | 条码+附加码 |
| goodslist.goodscount | 数量 | String | 数量 |
| goodslist.remark | 备注 | String | 备注 |
| goodslist.goodsid | 货品id | String | 货品id |
| goodslist.specid | 规格id | String | 规格id |
| goodslist.specname | 规格名 | string | 规格名 |
| goodslist.price | 价格 | String | 价格 |
| goodslist.thecause | 入库原因 | string | |
| goodslist.isautocheck | isautocheck | String | 0 创建入库单不自动审核（根据管家的配置审核）， 1 创建入库单自动审核（无视管家的自动审核的配置） |
数据对接价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到网店管家之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
