聚水潭对接打通金蝶云星空采购退货查询接口与采购退货新增接口对接源平台:聚水潭聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年，创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初，以电商SaaSERP切入市场，凭借出色的产品和服务，快速获得市场的肯定。对接目标平台:金蝶云星空金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。接口方案配置使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：聚水潭，然后选择对应的连接器。选择对应的采购退货查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的采购退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置。聚水潭接口明细调用接口： purchaseout.query 接口名称：采购退货查询方法： POST 请求参数字段字段名称类型配置值 page_index 开始页码 string 1 page_size 每页条数 string {{PAGINATION_PAGE_SIZE}} modified_begin 修改开始时间 string {{LAST_SYNC_TIME datetime}} modified_end 修改结束时间 string {{CURRENT_TIME datetime}} so_ids 线上订单号 string status 单据状态 string Confirmed 响应参数字段字段名称类型配置值 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 仓库编号 string 1 modified 修改时间 string po_id 采购单号 string wms_co_id 分仓编号 string seller_id 供应商ID string 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 明细id string 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 业务对象表单Id PUR_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组织及交付能力。

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

小群青V

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

对接源平台:聚水潭

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

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

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

接口方案配置

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

聚水潭接口明细

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

请求参数

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

响应参数

字段	字段名称	类型	配置值
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	仓库编号	string	1
modified	修改时间	string
po_id	采购单号	string
wms_co_id	分仓编号	string
seller_id	供应商ID	string
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	明细id	string
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	业务对象表单Id	PUR_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组织及交付能力。