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

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

来源系统:金蝶云星空

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

对接目标平台:聚水潭

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

配置集成方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：采购退料查询，目标系统：聚水潭，目标系统 API采购退货上传。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：采购退料查询
• METHOD：POST

请求参数

接口字段名称预设值 FPURMRBENTRY_FEntryID明细信息IDFPURMRBENTRY_FEntryID FID实体主键FID FBillNo单据编号FBillNo FDocumentStatus单据状态FDocumentStatus FStockOrgId_FNumber退料组织FStockOrgId.FNumber FDate退料日期FDate FBillTypeID_FNumber单据类型FBillTypeID.FNumber FTAKEDELIVERYNO提货单号FTAKEDELIVERYNO FSupplierID_FNumber供应商FSupplierID.FNumber FDESCRIPTION备注FDESCRIPTION FCarrierID_FNumber承运商FCarrierID.FNumber FDELIVERYNO送货单号FDELIVERYNO FPurchaseOrgId_FNumber采购组织FPurchaseOrgId.FNumber FMRTYPE退料类型FMRTYPE FMRMODE退料方式FMRMODE FMRREASON退料原因FMRREASON FREPLENISHMODE补料方式FREPLENISHMODE FCreateDate创建日期FCreateDate FModifyDate最后修改日期FModifyDate FApproveDate审核日期FApproveDate FCreatorId创建人FCreatorId FApproverId审核人FApproverId FCancelerId作废人FCancelerId FCancelDate作废日期FCancelDate FCARRYNO运输单号FCARRYNO FCancelStatus作废状态FCancelStatus FACCEPTORID_FNumber接收方FACCEPTORID.FNumber FSettleId_FNumber结算方FSettleId.FNumber FBusinessType业务类型FBusinessType FAcceptAddress接收方地址FAcceptAddress FCHARGEID_FNumber收款方FCHARGEID.FNumber FAPSTATUS应付状态FAPSTATUS FTransferBizType跨组织业务类型FTransferBizType FCorrespondOrgId_FNumber对应组织FCorrespondOrgId.FNumber FSupplyOrderNo订单号FSupplyOrderNo FPayOrgId_FNumber付款组织FPayOrgId.FNumber FSettleOrgId_FNumber结算组织FSettleOrgId.FNumber FSETTLETYPEID_FNumber结算方式FSETTLETYPEID.FNumber FPAYCONDITIONID_FNumber付款条件FPAYCONDITIONID.FNumber FSettleCurrId_FNumber结算币别FSettleCurrId.FNumber FBILLTAXAMOUNT税额FBILLTAXAMOUNT FBILLCOSTAMOUNT总成本FBILLCOSTAMOUNT FBILLALLAMOUNT价税合计FBILLALLAMOUNT FEXCHANGETYPEID_FNumber汇率类型FEXCHANGETYPEID.FNumber FIsIncludedTax含税FIsIncludedTax FBillAmount金额FBillAmount FISGENFORIOS跨组织结算生成FISGENFORIOS FSettleSupplierID_FNumber结算组织供应商FSettleSupplierID.FNumber FISPRICEEXCLUDETAX价外税FISPRICEEXCLUDETAX FISINVOICEARLIER先到票后入库FISINVOICEARLIER FTHIRDSRCTYPE第三方来源FTHIRDSRCTYPE FTHIRDBILLID第三方单据IDFTHIRDBILLID FTHIRDBILLNO第三方单据编号FTHIRDBILLNO FMATERIALID_FNumber物料编码FMATERIALID.FNumber FMATERIALID_FBARCODE条码FMATERIALID.FBARCODE FREPLENISHQTY补料数量FREPLENISHQTY FKEAPAMTQTY扣款数量FKEAPAMTQTY FSTOCKID_FNumber仓库FSTOCKID.FNumber FStockStatusId库存状态FStockStatusId FNOTE备注FNOTE FProduceDate生产日期FProduceDate FEXPIRYDATE到期日FEXPIRYDATE FCONTRACTNO合同单号FCONTRACTNO FREQTRACENO需求跟踪号FREQTRACENO FORDERNO订单单号FORDERNO FPRICEUNITQTY计价数量FPRICEUNITQTY FCostPrice成本价FCostPrice FTAXPRICE含税单价FTAXPRICE FDISCOUNTRATE折扣率(%)FDISCOUNTRATE FTAXNETPRICE净价FTAXNETPRICE FENTRYCOSTAMOUNT总成本FENTRYCOSTAMOUNT FENTRYTAXRATE税率FENTRYTAXRATE FENTRYTAXAMOUNT税额FENTRYTAXAMOUNT FALLAMOUNT价税合计FALLAMOUNT FOWNERID_FNumber货主FOWNERID.FNumber FJOINQTY关联数量FJOINQTY FRMREALQTY实退数量FRMREALQTY FRMMUSTQTY应退数量FRMMUSTQTY FSTOCKLOCID仓位FSTOCKLOCID FSRCBillTypeId源单类型FSRCBillTypeId FSRCBillNo源单编号FSRCBillNo FLot_FNumber批号FLot.FNumber FPrice单价FPrice FAmount金额FAmount FDiscount折扣额FDiscount FBFLowId业务流程FBFLowId FSRCSeq源单行号FSRCSeq FMtoNo计划跟踪号FMtoNo FIsStock是否可库存FIsStock FGiveAway是否赠品FGiveAway FRowId行标识FRowId FParentRowId父行标识FParentRowId FBarcode零售条形码FBarcode Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FStockId.FGROUP='现货仓库' AND FISGENFORIOS != 1 FieldKeys需查询的字段key集合 FormId业务对象表单IdPUR_MRB

响应参数

接口字段名称预设值 FPURMRBENTRY_FEntryID明细信息ID FID实体主键 FBillNo单据编号 FDocumentStatus单据状态 FStockOrgId_FNumber退料组织 FDate退料日期 FBillTypeID_FNumber单据类型 FTAKEDELIVERYNO提货单号 FSupplierID_FNumber供应商 FDESCRIPTION备注 FCarrierID_FNumber承运商 FDELIVERYNO送货单号 FPurchaseOrgId_FNumber采购组织 FMRTYPE退料类型 FMRMODE退料方式 FMRREASON退料原因 FREPLENISHMODE补料方式 FCreateDate创建日期 FModifyDate最后修改日期 FApproveDate审核日期 FCreatorId创建人 FApproverId审核人 FCancelerId作废人 FCancelDate作废日期 FCARRYNO运输单号 FCancelStatus作废状态 FACCEPTORID_FNumber接收方 FSettleId_FNumber结算方 FBusinessType业务类型 FAcceptAddress接收方地址 FCHARGEID_FNumber收款方 FAPSTATUS应付状态 FTransferBizType跨组织业务类型 FCorrespondOrgId_FNumber对应组织 FSupplyOrderNo订单号 FPayOrgId_FNumber付款组织 FSettleOrgId_FNumber结算组织 FSETTLETYPEID_FNumber结算方式 FPAYCONDITIONID_FNumber付款条件 FSettleCurrId_FNumber结算币别 FBILLTAXAMOUNT税额 FBILLCOSTAMOUNT总成本 FBILLALLAMOUNT价税合计 FEXCHANGETYPEID_FNumber汇率类型 FIsIncludedTax含税 FBillAmount金额 FISGENFORIOS跨组织结算生成 FSettleSupplierID_FNumber结算组织供应商 FISPRICEEXCLUDETAX价外税 FISINVOICEARLIER先到票后入库 FTHIRDSRCTYPE第三方来源 FTHIRDBILLID第三方单据ID FTHIRDBILLNO第三方单据编号 FMATERIALID_FNumber物料编码 FMATERIALID_FBARCODE条码 FREPLENISHQTY补料数量 FKEAPAMTQTY扣款数量 FSTOCKID_FNumber仓库 FStockStatusId库存状态 FNOTE备注 FProduceDate生产日期 FEXPIRYDATE到期日 FCONTRACTNO合同单号 FREQTRACENO需求跟踪号 FORDERNO订单单号 FPRICEUNITQTY计价数量 FCostPrice成本价 FTAXPRICE含税单价 FDISCOUNTRATE折扣率(%) FTAXNETPRICE净价 FENTRYCOSTAMOUNT总成本 FENTRYTAXRATE税率 FENTRYTAXAMOUNT税额 FALLAMOUNT价税合计 FOWNERID_FNumber货主 FJOINQTY关联数量 FRMREALQTY实退数量 FRMMUSTQTY应退数量 FSTOCKLOCID仓位 FSRCBillTypeId源单类型 FSRCBillNo源单编号 FLot_FNumber批号 FPrice单价 FAmount金额 FDiscount折扣额 FBFLowId业务流程 FSRCSeq源单行号 FMtoNo计划跟踪号 FIsStock是否可库存 FGiveAway是否赠品 FRowId行标识 FParentRowId父行标识 FBarcode零售条形码

聚水潭接口明细

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

请求参数

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

系统对接总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。