聚水潭对接打通金蝶云星空采购退货查询接口与采购退货新增接口

聚水潭对接打通金蝶云星空采购退货查询接口与采购退货新增接口

对接源平台:聚水潭

聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。

对接目标平台:金蝶云星空

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

接口方案配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：聚水潭，然后选择对应的连接器。选择对应的采购退货查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的采购退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

聚水潭接口明细

• 调用接口：purchaseout.query
• 接口名称：采购退货查询
• 方法：POST

请求参数

字段字段名称类型配置值 page_index开始页码string1 page_size每页条数string{{PAGINATION_PAGE_SIZE}} modified_begin修改开始时间string{{LAST_SYNC_TIME datetime}} modified_end修改结束时间string{{CURRENT_TIME datetime}} so_ids线上订单号string status单据状态stringConfirmed

响应参数

字段字段名称类型配置值 io_date单据日期string status状态string so_id线上单号string f_status财务状态string warehouse仓库名string receiver_name收货人/供应商名称string receiver_mobile收货电话string receiver_state收货状态string receiver_city市string receiver_district区string receiver_address地址string wh_id仓库编号string1 modified修改时间string po_id采购单号string wms_co_id分仓编号string seller_id供应商IDstring labels标记多标签string logistics_company物流公司string lc_id物流公司编号string l_id物流单号string archived财务审核日期string creator_name创建人string items商品合集array items.io_id退货单号string items.remark备注string items.ioi_id明细idstring items.sku_id商品编码string items.name商品名称string items.properties_value属性string items.qty数量string items.cost_price单价string items.cost_amount金额string items.i_id款式编码string items.co_id公司编号string items.batchs批次集合array items.batchs.batch_no批次号string items.batchs.product_date批次日期string items.batchs.code错误码，0代表成功string items.batchs.issuccess是否成功，true代表成功string items.batchs.msg执行描述string items.batchs.io_id退货单号string

金蝶云星空接口明细

• API：batchSave
• NAME：采购退货新增
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FBILLTYPEID单据类型TLD01_SYS FStockOrgId退料组织100组织 FBillNo单据编号{{io_id}}单据编号 FDate退料日期{{io_date}}日期 FSupplierID供应商{{seller_id}}基础资料 FMRTYPE退料类型B下拉列表 FMRDeptId退料部门基础资料 FDESCRIPTION备注多行文本 FSettleOrgId结算组织100组织 FSettleCurrId结算币别PRE001基础资料 FPayOrgId付款组织100组织 FOwnerTypeIdHead货主类型BD_OwnerOrg多类别基础资料列表 FOwnerIdHead货主100多类别基础资料 FPURMRBENTRY明细信息items明细信息 FPURMRBENTRY.FMATERIALID物料编码{{items.sku_id}}基础资料 FPURMRBENTRY.FRMREALQTY实退数量{{items.qty}}数量 FPURMRBENTRY.FSTOCKID仓库1基础资料 FPURMRBENTRY.FNOTE备注文本 FPURMRBENTRY.FPrice单价单价 FPURMRBENTRY.FGiveAway是否赠品复选框 FPURMRBENTRY.FOWNERTYPEID货主类型BD_OwnerOrg多类别基础资料列表 FPURMRBENTRY.FOWNERID货主100多类别基础资料 FPURMRBENTRY.FENTRYTAXRATE税率小数 FPURMRBENTRY.FTAXPRICE含税单价{{items.cost_price}}单价 FPURMRBENTRY.FormId业务对象表单IdPUR_MRB必须填写金蝶的表单ID如😛UR_PurchaseOrder FPURMRBENTRY.Operation执行的操作batchSave FPURMRBENTRY.IsAutoSubmitAndAudit提交并审核false FPURMRBENTRY.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FPURMRBENTRY.SubSystemId系统模块21默认仓库模块

系统对接概况

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