聚水潭与金蝶云星空对接集成采购退货查询打通采购退货新增
对接源平台:聚水潭
聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。
集成系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取聚水潭的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
聚水潭接口明细
- API：purchaseout.query
- NAME：采购退货查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| page_index | 开始页码 | 1 | 第几页，从第一页开始，默认1 |
| page_size | 每页条数 | {{PAGINATION_PAGE_SIZE}} | 每页多少条，默认30，最大50 |
| modified_begin | 修改开始时间 | {{LAST_SYNC_TIME datetime}} | 修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 |
| modified_end | 修改结束时间 | {{CURRENT_TIME datetime}} | 修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 |
| so_ids | 线上订单号 | | 指定线上订单号，和时间段不能同时为空 |
| status | 单据状态 | Confirmed | 单据状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| io_date | 单据日期 | | 单据日期 |
| status | 状态 | | 状态，Confirmed=生效，WaitConfirm待审核，Creating=草拟，Archive=归档，Cancelled=作废 |
| so_id | 线上单号 | | 线上单号 |
| io_id | 退货单号 | | 退货单号 |
| f_status | 财务状态 | | 财务状态，WaitConfirm=待审核，Confirmed=待审核 |
| warehouse | 仓库名 | | 仓库名 |
| receiver_name | 收货人/供应商名称 | | 收货人/供应商名称 |
| receiver_mobile | 收货电话 | | 收货电话 |
| receiver_state | 收货状态 | | 收货状态 |
| receiver_city | 市 | | 市 |
| receiver_district | 区 | | 区 |
| receiver_address | 地址 | | 地址 |
| wh_id | 仓库编号 | | 仓库编号，1=主仓，2=销退仓，3=进货仓，4=次品仓 |
| modified | 修改时间 | | 修改时间 |
| po_id | 采购单号 | | 采购单号 |
| wms_co_id | 分仓编号 | | 分仓编号 |
| seller_id | 供应商ID | | 供应商ID |
| labels | 标记 | 多标签 | | 标记 多标签 |
| logistics_company | 物流公司 | | 物流公司 |
| lc_id | 物流公司编号 | | 物流公司编号 |
| l_id | 物流单号 | | 物流单号 |
| archived | 财务审核日期 | | 财务审核日期 |
| creator_name | 创建人 | | 创建人 |
| items | 商品合集 | | |
| items.io_id | 退货单号 | | 退货单号 |
| items.remark | 备注 | | 备注 |
| items.ioi_id | 明细id | | 明细id |
| items.sku_id | 商品编码 | | 商品编码 |
| items.name | 商品名称 | | 商品名称 |
| items.properties_value | 属性 | | 属性 |
| items.qty | 数量 | | 数量 |
| items.cost_price | 单价 | | 单价 |
| items.cost_amount | 金额 | | 金额 |
| items.i_id | 款式编码 | | 款式编码 |
| items.co_id | 公司编号 | | 公司编号 |
| items.batchs | 批次集合 | | |
| items.batchs.batch_no | 批次号 | | 批次号 |
| items.batchs.product_date | 批次日期 | | 批次日期 |
| items.batchs.code | 错误码，0代表成功 | | 错误码，0代表成功 |
| items.batchs.issuccess | 是否成功，true代表成功 | | 是否成功，true代表成功 |
| items.batchs.msg | 执行描述 | | 执行描述 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：采购退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBILLTYPEID | 单据类型 | string | |
| FStockOrgId | 退料组织 | string | 组织 |
| FBillNo | 单据编号 | string | 单据编号 |
| FDate | 退料日期 | string | 日期 |
| FSupplierID | 供应商 | string | 基础资料 |
| FMRTYPE | 退料类型 | string | 下拉列表 |
| FDESCRIPTION | 备注 | 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.FPrice | 单价 | string | 单价 |
| FPURMRBENTRY.FGiveAway | 是否赠品 | string | 复选框 |
| FPURMRBENTRY.FOWNERTYPEID | 货主类型 | string | 多类别基础资料列表 |
| FPURMRBENTRY.FOWNERID | 货主 | string | 多类别基础资料 |
| FPURMRBENTRY.FENTRYTAXRATE | 税率 | string | 小数 |
| FPURMRBENTRY.FTAXPRICE | 含税单价 | string | 单价 |
| FPURMRBENTRY.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FPURMRBENTRY.Operation | 执行的操作 | string | |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FPURMRBENTRY.SubSystemId | 系统模块 | string | 默认仓库模块 |
系统对接概况
基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接聚水潭接口抽取数据后再自动分发到金蝶云星空， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。
