接口配置打通聚水潭和金蝶云星空数据对接

对接系统金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标平台:聚水潭

聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。随着客户需求的不断变化，如今聚水潭已经发展成为以SaaSERP为核心，集多种商家服务为一体的SaaS协同平台。经过8年多的发展，公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点，服务范围覆盖超过400个城镇，为客户提供及时、周到和专业的服务。

数据对接方案

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的盘盈单查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为聚水潭，并且选择对应连接器。选择对应的新建其它出入库（新）接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：盘盈单查询
方法：POST

请求参数

字段字段名称类型配置值 FBillEntry_FEntryIDFEntryIDstringFBillEntry_FEntryID FID实体主键stringFID FBillNo单据编号stringFBillNo FDocumentStatus单据状态stringFDocumentStatus FStockOrgId_FNumber库存组织stringFStockOrgId.FNumber FDate日期stringFDate FBillTypeID单据类型stringFBillTypeID FStockerId仓管员stringFStockerId FCreatorId创建人stringFCreatorId FCreateDate创建日期stringFCreateDate FModifierId最后修改人stringFModifierId FModifyDate最后修改日期stringFModifyDate FApproverId审核人stringFApproverId FApproveDate审核日期stringFApproveDate FNoteHead备注stringFNoteHead FMaterialId_FNumber物料编码stringFMaterialId.FNumber FUnitID单位stringFUnitID FAcctQty账存数量stringFAcctQty FCountQty盘点数量stringFCountQty FGainQty盘盈数量stringFGainQty FStockId_FNumber仓库stringFStockId.FNumber FStockStatusId库存状态stringFStockStatusId FOwnerid_FNumber货主stringFOwnerid.FNumber FPrice成本价stringFPrice FAmount总成本stringFAmount Fnote备注stringFnote FBomIdBOM版本stringFBomId FMtoNo计划跟踪号stringFMtoNo FStockFlag库存更新标识stringFStockFlag FStockLocId仓位stringFStockLocId FLOT批号stringFLOT FBusinessDate入库日期stringFBusinessDate FCMKBarCode零售条形码stringFCMKBarCode FMATERIALID_FBARCODE商品条码stringFMATERIALID.FBARCODE Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}'AND FDocumentStatus = 'C' AND FStockId.FNumber IN ('A9') FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSTK_StockCountGain

响应参数

字段字段名称类型配置值 FBillEntry_FEntryIDFEntryIDstring 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 FBomIdBOM版本string FMtoNo计划跟踪号string FStockFlag库存更新标识string FStockLocId仓位string FLOT批号string FBusinessDate入库日期string FCMKBarCode零售条形码string FMATERIALID_FBARCODE商品条码string

聚水潭接口明细

API：jushuitan.otherinout.upload
NAME：新建其它出入库（新）
METHOD：POST

请求参数

接口字段名称预设值 is_confirm是否自动确认单据true wms_co_id分仓编号 type出入库类型: in是入库 out是出库in external_id外部单号{{FBillNo}}{{FBillEntry_FEntryID}}Panin warehouse主仓=1，销退仓=2，进货仓=3，次品仓 = 41 drp_co_name出库类型 receiver_name收件人姓名 receiver_mobile收件人手机号 receiver_state收件地址省 receiver_city收件地址市 receiver_district收件地址区县 receiver_address收件详细地址 items商品列表items items.remark备注 items.sku_id商品编码{{items.FMaterialId_FNumber}} items.qty数量{{items.FGainQty}} items.batch_id批次单号，系统中需开启相关配置 items.produced_date生产日期，系统中需开启相关配置 items.expiration_date有效期至，系统中需开启相关配置

响应参数

接口字段名称预设值 code非0失败 msg错误描述 data返回内容 data.external_id外部单号 data.io_id系统内部单号

数据对接效果

采集并引入全业务、多终端、多形态的数据，经过处理以及对应平台接口的数据结构适配，形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施，将沉淀的业务数据进入到平台进行体系化的加工，再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。