金蝶云星空和聚水潭接口打通对接实战

金蝶云星空和聚水潭接口打通对接实战

数据源系统:金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

写入目标:聚水潭

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

系统对接接口配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：聚水潭，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

• 调用接口：executeBillQuery
• 接口名称：组装拆卸单查询(成品)
• 方法：POST

请求参数

字段字段名称类型配置值 FID实体主键stringFID FEntity_FEntryID分录主键stringFEntity_FEntryID FBillNo单据编号stringFBillNo FDocumentStatus单据状态stringFDocumentStatus FStockOrgId_FNumber库存组织stringFStockOrgId.FNumber FDate日期stringFDate FBillTypeID_FNumber单据类型stringFBillTypeID.FNumber FOwnerIdHead_FNumber成品货主stringFOwnerIdHead.FNumber FAffairType事务类型stringFAffairType FEE费用stringFEE FDeptID_FNumber部门stringFDeptID.FNumber FNote备注stringFNote FSubProOwnerIdH_FNumber子件货主stringFSubProOwnerIdH.FNumber FRowType行类型stringFRowType FMaterialID_FNumber物料编码stringFMaterialID.FNumber FUnitID单位stringFUnitID FQty数量stringFQty Fee_ETY费用stringFee_ETY FStockID_FNumber仓库stringFStockID.FNumber FStockStatusID库存状态stringFStockStatusID FDescription备注stringFDescription FMTONO计划跟踪号stringFMTONO FProjectNo项目编号stringFProjectNo FOwnerTypeID货主类型stringFOwnerTypeID FOwnerID_FNumber货主stringFOwnerID.FNumber FKeeperTypeID保管者类型stringFKeeperTypeID FKeeperID_FNumber保管者stringFKeeperID.FNumber FBomIDBOM版本stringFBomID FProduceDate生产日期stringFProduceDate FEXPIRYDATE有效期至stringFEXPIRYDATE FPrice成本价stringFPrice FAmount总成本stringFAmount FStockFlag已更新库存stringFStockFlag FStockLocId仓位stringFStockLocId FLOT批号stringFLOT FSrcBillTypeId源单类型stringFSrcBillTypeId FSrcBillNo源单编号stringFSrcBillNo FInstockDate入库日期stringFInstockDate Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSTK_AssembledApp

响应参数

字段字段名称类型配置值 FID实体主键string FEntity_FEntryID分录主键string FBillNo单据编号string FDocumentStatus单据状态string FStockOrgId_FNumber库存组织string FDate日期string FBillTypeID_FNumber单据类型string FOwnerIdHead_FNumber成品货主string FAffairType事务类型string FEE费用string FDeptID_FNumber部门string FNote备注string FSubProOwnerIdH_FNumber子件货主string FRowType行类型string FMaterialID_FNumber物料编码string FUnitID单位string FQty数量string Fee_ETY费用string FStockID_FNumber仓库string FStockStatusID库存状态string FDescription备注string FMTONO计划跟踪号string FProjectNo项目编号string FOwnerTypeID货主类型string FOwnerID_FNumber货主string FKeeperTypeID保管者类型string FKeeperID_FNumber保管者string FBomIDBOM版本string FProduceDate生产日期string FEXPIRYDATE有效期至string FPrice成本价string FAmount总成本string FStockFlag已更新库存string FStockLocId仓位string FLOT批号string FSrcBillTypeId源单类型string FSrcBillNo源单编号string FInstockDate入库日期string

聚水潭接口明细

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

请求参数

接口字段字段名称预设值描述 is_confirm是否自动确认单据1是否自动确认单据 wms_co_id分仓编号{{FStockID_FNumber}}分仓编号 type出入库类型: in是入库 out是出库out出入库类型: in是入库 out是出库 external_id外部单号{{FBillNo}}CXout外部单号 warehouse主仓=1，销退仓=2， 进货仓=3，次品仓 = 41主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 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.FQty}}数量 items.batch_id批次单号，系统中需开启相关配置批次单号，系统中需开启相关配置 items.produced_date生产日期，系统中需开启相关配置生产日期，系统中需开启相关配置 items.expiration_date有效期至，系统中需开启相关配置有效期至，系统中需开启相关配置

响应参数

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

系统对接总览

全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：聚水潭与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。