从金蝶云星空到聚水潭通过接口集成数据

来源系统:金蝶云星空

金蝶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 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：聚水潭，把获取的数据组装成目标系统需要的格式进行写入。

金蝶云星空接口明细

API：executeBillQuery
NAME：退料申请查询
METHOD：POST

请求参数

接口字段名称预设值 FEntity_FEntryIDFEntity_FEntryIDFEntity_FEntryID FBillNo单据编号FBillNo FIDFIDFID FDocumentStatus单据状态FDocumentStatus FBillTypeID_Fnumber单据类型FBillTypeID.Fnumber FDate申请日期FDate FPURCHASEORGID_Fnumber采购组织FPURCHASEORGID.Fnumber FRMTYPE退料类型FRMTYPE FAPPORGID_Fnumber申请组织FAPPORGID.Fnumber FAPPDEPTID_Fnumber申请部门FAPPDEPTID.Fnumber FRMLOC退料地点FRMLOC FSUPPLIERID_Fnumber供应商FSUPPLIERID.Fnumber FRMMODE退料方式FRMMODE FREPLENISHMODE补料方式FREPLENISHMODE FCreatorId创建人FCreatorId FCreateDate创建日期FCreateDate FModifierId最后修改人FModifierId FModifyDate最后修改日期FModifyDate FAPPROVERID审核人FAPPROVERID FAPPROVEDATE审核日期FAPPROVEDATE FCANCELLERID作废人FCANCELLERID FCANCELDATE作废日期FCANCELDATE FCANCELSTATUS作废状态FCANCELSTATUS FBusinessType业务类型FBusinessType FRemarks备注FRemarks FRMREASON退料原因FRMREASON FRequireOrgId_Fnumber需求组织FRequireOrgId.Fnumber FCorrespondOrgId_Fnumber对应组织FCorrespondOrgId.Fnumber FConfirmerId确认人FConfirmerId FConfirmDate确认日期FConfirmDate FConfirmStatus确认状态FConfirmStatus FMATERIALID_Fnumber物料编码FMATERIALID.Fnumber FMaterialName物料名称FMaterialName FUOM规格型号FUOM FMaterialType存货类别FMaterialType FMRAPPQTY申请退料数量FMRAPPQTY FREPLENISHQTY补料数量FREPLENISHQTY FKEAPAMTQTY扣款数量FKEAPAMTQTY FMRJOINQTY退料关联数量FMRJOINQTY FMRQTY退料数量FMRQTY FNOTE_M备注FNOTE_M FBOMIDBOM版本FBOMID FPRICEQTY_F计价数量FPRICEQTY_F FPRICE_F单价FPRICE_F FPRICECOEFFICIENT_F价格系数FPRICECOEFFICIENT_F FDISCOUNTRATE_F折扣率FDISCOUNTRATE_F FDISCOUNT_F折扣额FDISCOUNT_F FTAXNETPRICE_F净价FTAXNETPRICE_F FAMOUNT_F退料金额FAMOUNT_F FALLAMOUNT_F退料含税金额FALLAMOUNT_F FAPPROVEPRICE_F含税单价FAPPROVEPRICE_F FSRCSEQ源单行号FSRCSEQ FCONTRACTNO合同单号FCONTRACTNO FORDERNO订单单号FORDERNO FREQTRACENO需求跟踪号FREQTRACENO FBASEUNITQTY库存基本数量FBASEUNITQTY FBASEUNITID退料申请基本单位FBASEUNITID FUNITID库存单位FUNITID FPRICEUNITID_F计价单位FPRICEUNITID_F FBASEMRJOINQTY退料关联数量（库存基本）FBASEMRJOINQTY FBASEMRQTY退料数量(基本单位)FBASEMRQTY FAUXPROPID辅助属性FAUXPROPID FSRCBILLNO源单编号FSRCBILLNO FSRCBILLTYPEID源单类型FSRCBILLTYPEID FREPLENISHAMOUNT补料金额FREPLENISHAMOUNT FKEAPAMTAMOUNT扣款金额FKEAPAMTAMOUNT FLot批号FLot FRMREASON_M退料原因FRMREASON_M FBFLowId业务流程FBFLowId FMtoNo计划跟踪号FMtoNo FGiveAway是否赠品FGiveAway FPriceBaseQty计价基本数量FPriceBaseQty FPURUNITID采购单位FPURUNITID FPurQty采购数量FPurQty FPurBaseQty采购基本数量FPurBaseQty FPURBASENUM采购基本分子FPURBASENUM FSTOCKBASEDEN库存基本分母FSTOCKBASEDEN FSRCBIZUNITID携带的主业务单位FSRCBIZUNITID FRETURNSTOCKJNBASEQTY退料关联数量（采购基本）FRETURNSTOCKJNBASEQTY FEntryTaxRate税率%FEntryTaxRate FENTRYPRICELISTID分录价目表FENTRYPRICELISTID FPOORDERENTRYID采购订单分录内码FPOORDERENTRYID FStockId_Fnumber仓库FStockId.Fnumber FISSYNTOTHIRD是否同步管易(GY)FISSYNTOTHIRD FRowType产品类型FRowType FPARENTMATID父项产品FPARENTMATID FPriceDiscount单价折扣FPriceDiscount FSTOCKLOCID仓位FSTOCKLOCID FPriLstEntryId价目表分录idFPriLstEntryId FEntity_Link_FFlowId业务流程图FEntity_Link_FFlowId FEntity_Link_FFlowLineId推进路线FEntity_Link_FFlowLineId FEntity_Link_FRuleId转换规则FEntity_Link_FRuleId FEntity_Link_FSTableId源单表内码FEntity_Link_FSTableId FEntity_Link_FSTableName源单表FEntity_Link_FSTableName FEntity_Link_FSBillId源单内码FEntity_Link_FSBillId FEntity_Link_FSId源单分录内码FEntity_Link_FSId FEntity_Link_FBASEUNITQTYOld原始携带量FEntity_Link_FBASEUNITQTYOld FEntity_Link_FBASEUNITQTY修改携带量FEntity_Link_FBASEUNITQTY FEntity_Link_FPurBaseQtyOld原始携带量FEntity_Link_FPurBaseQtyOld FEntity_Link_FPurBaseQty修改携带量FEntity_Link_FPurBaseQty FEntity_Link_FLnkTrackerId迁移图FEntity_Link_FLnkTrackerId FEntity_Link_FLnkSState上游状态FEntity_Link_FLnkSState FEntity_Link_FLnkAmount数量FLnkFEntity_Link_FLnkAmount Limit最大行数200 StartRow开始行索引 TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FPurchaseOrgId.FNumber ='100' FieldKeys需查询的字段key集合 FormId业务对象表单IdPUR_MRAPP

响应参数

接口字段名称预设值 FEntity_FEntryIDFEntity_FEntryID FBillNo单据编号 FIDFID FDocumentStatus单据状态 FBillTypeID_Fnumber单据类型 FDate申请日期 FPURCHASEORGID_Fnumber采购组织 FRMTYPE退料类型 FAPPORGID_Fnumber申请组织 FAPPDEPTID_Fnumber申请部门 FRMLOC退料地点 FSUPPLIERID_Fnumber供应商 FRMMODE退料方式 FREPLENISHMODE补料方式 FCreatorId创建人 FCreateDate创建日期 FModifierId最后修改人 FModifyDate最后修改日期 FAPPROVERID审核人 FAPPROVEDATE审核日期 FCANCELLERID作废人 FCANCELDATE作废日期 FCANCELSTATUS作废状态 FBusinessType业务类型 FRemarks备注 FRMREASON退料原因 FRequireOrgId_Fnumber需求组织 FCorrespondOrgId_Fnumber对应组织 FConfirmerId确认人 FConfirmDate确认日期 FConfirmStatus确认状态 FMATERIALID_Fnumber物料编码 FMaterialName物料名称 FUOM规格型号 FMaterialType存货类别 FMRAPPQTY申请退料数量 FREPLENISHQTY补料数量 FKEAPAMTQTY扣款数量 FMRJOINQTY退料关联数量 FMRQTY退料数量 FNOTE_M备注 FBOMIDBOM版本 FPRICEQTY_F计价数量 FPRICE_F单价 FPRICECOEFFICIENT_F价格系数 FDISCOUNTRATE_F折扣率 FDISCOUNT_F折扣额 FTAXNETPRICE_F净价 FAMOUNT_F退料金额 FALLAMOUNT_F退料含税金额 FAPPROVEPRICE_F含税单价 FSRCSEQ源单行号 FCONTRACTNO合同单号 FORDERNO订单单号 FREQTRACENO需求跟踪号 FBASEUNITQTY库存基本数量 FBASEUNITID退料申请基本单位 FUNITID库存单位 FPRICEUNITID_F计价单位 FBASEMRJOINQTY退料关联数量（库存基本） FBASEMRQTY退料数量(基本单位) FAUXPROPID辅助属性 FSRCBILLNO源单编号 FSRCBILLTYPEID源单类型 FREPLENISHAMOUNT补料金额 FKEAPAMTAMOUNT扣款金额 FLot批号 FRMREASON_M退料原因 FBFLowId业务流程 FMtoNo计划跟踪号 FGiveAway是否赠品 FPriceBaseQty计价基本数量 FPURUNITID采购单位 FPurQty采购数量 FPurBaseQty采购基本数量 FPURBASENUM采购基本分子 FSTOCKBASEDEN库存基本分母 FSRCBIZUNITID携带的主业务单位 FRETURNSTOCKJNBASEQTY退料关联数量（采购基本） FEntryTaxRate税率% FENTRYPRICELISTID分录价目表 FPOORDERENTRYID采购订单分录内码 FStockId_Fnumber仓库 FISSYNTOTHIRD是否同步管易(GY) FRowType产品类型 FPARENTMATID父项产品 FPriceDiscount单价折扣 FSTOCKLOCID仓位 FPriLstEntryId价目表分录id FEntity_Link_FFlowId业务流程图 FEntity_Link_FFlowLineId推进路线 FEntity_Link_FRuleId转换规则 FEntity_Link_FSTableId源单表内码 FEntity_Link_FSTableName源单表 FEntity_Link_FSBillId源单内码 FEntity_Link_FSId源单分录内码 FEntity_Link_FBASEUNITQTYOld原始携带量 FEntity_Link_FBASEUNITQTY修改携带量 FEntity_Link_FPurBaseQtyOld原始携带量 FEntity_Link_FPurBaseQty修改携带量 FEntity_Link_FLnkTrackerId迁移图 FEntity_Link_FLnkSState上游状态 FEntity_Link_FLnkAmount数量FLnk

聚水潭接口明细

接口：/open/jushuitan/purchaseout/upload
接口名称：采购退货上传
接口方法：POST

请求参数

字段名称类型 remark备注string is_confirm是否自动确认string external_id外部单号string items.produced_date生产日期string warehouse仓库编号string po_id采购单号string items.price单价string items.sku_id商品编码string items.qty数量string supplier_id供应商编号string items.batch_id批次单号string items商品集合array wms_co_id分仓编号string

系统对接概况

全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。