聚水潭对接打通金蝶云星空采购退货查询接口与[标准][采购退货单新增]-v2接口|轻易云数据集成平台

聚水潭对接打通金蝶云星空采购退货查询接口与[标准][采购退货单新增]-v2接口

接通系统：聚水潭

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

对接目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

配置集成方案

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

聚水潭接口明细

接口：/open/purchaseout/query
接口名称：采购退货查询
接口方法：POST

请求参数

字段	名称	类型	描述
page_index	开始页码	string	第几页，从第一页开始，默认1
page_size	每页条数	string	每页多少条，默认30，最大50
modified_begin	修改开始时间	string	修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	修改结束时间	string	修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
so_ids	线上订单号	string	指定线上订单号，和时间段不能同时为空
status	单据状态	string	单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废

响应参数

字段	名称	类型	描述
io_id	退货单号	string	退货单号
io_date	单据日期	string	单据日期
status	状态	string	状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废
so_id	线上单号	string	线上单号
f_status	财务状态	string	财务状态，WaitConfirm=待审核，Confirmed=待审核
warehouse	仓库名	string	仓库名
receiver_name	收货人/供应商名称	string	收货人/供应商名称
receiver_mobile	收货电话	string	收货电话
receiver_state	收货状态	string	收货状态
receiver_city	市	string	市
receiver_district	区	string	区
receiver_address	地址	string	地址
wh_id	仓库编号	string	仓库编号，1=主仓，2=销退仓，3=进货仓，4=次品仓
remark	备注	string	备注
modified	修改时间	string	修改时间
po_id	采购单号	string	采购单号
wms_co_id	分仓编号	string	分仓编号
seller_id	供应商ID	string	供应商ID
labels	标记\|多标签	string	标记多标签
logistics_company	物流公司	string	物流公司
lc_id	物流公司编号	string	物流公司编号
l_id	物流单号	string	物流单号
archived	财务审核日期	string	财务审核日期
creator_name	创建人	string	创建人
items	商品合集	array
items.ioi_id	明细id	string	明细id
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.remark	备注	string	备注
items.io_id	退货单号	string	退货单号
items.co_id	公司编号	string	公司编号
items.batchs	批次集合	array
items.batchs.batch_no	批次号	string	批次号
items.batchs.product_date	批次日期	string	批次日期
items.batchs.code	错误码，0代表成功	string	错误码，0代表成功
items.batchs.issuccess	是否成功，true代表成功	string	是否成功，true代表成功
items.batchs.msg	执行描述	string	执行描述

金蝶云星空接口明细

接口：batchSave
接口名称：[标准][采购退货单新增]-v2
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	单据编号	string	单据编号
FDate	退料日期	string	日期
FSupplierID	供应商	string	基础资料
FStockOrgId	退料组织	string	组织
FSettleOrgId	结算组织	string	组织
FSettleCurrId	结算币别	string	基础资料
FPayOrgId	付款组织	string	组织
FOwnerTypeIdHead	货主类型	string	多类别基础资料列表
FOwnerIdHead	货主	string	多类别基础资料
FPURMRBENTRY	明细信息	array	明细信息
FPURMRBENTRY.FMATERIALID	物料编码	string	基础资料
FPURMRBENTRY.FRMREALQTY	实退数量	string	数量
FPURMRBENTRY.FSTOCKID	仓库	string	基础资料
FPURMRBENTRY.FNOTE	备注	string	文本
FPURMRBENTRY.FGiveAway	是否赠品	string	复选框
FPURMRBENTRY.FOWNERID	货主	string	多类别基础资料
FPURMRBENTRY.FOWNERTYPEID	货主类型	string	多类别基础资料列表
FPURMRBENTRY.FTAXPRICE	含税单价	string	单价
FPURMRBENTRY.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FPURMRBENTRY.Operation	执行的操作	string
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	bool
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.SubSystemId	系统模块	string	默认仓库模块

系统对接总览

使用全界面可视化配置集成流，快速应对企业的集成需求使得聚水潭与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。