金蝶云星空与聚水潭对接集成销售退货查询连通新建其它出入库（新）(线下销售退货对接聚水潭其他入库)
对接源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标平台:聚水潭
聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。
多系统对接方案配置
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为聚水潭，并且选择对应连接器（关于聚水潭的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的jushuitan.otherinout.upload接口作为数据写入动作完成第一步的接口配置。
金蝶云星空接口明细
- 调用接口：executeBillQuery
- 接口名称：销售退货查询
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| FID | FID | string | FID |
| FBillNo | 单据编码 | string | FBillNo |
| FDate | 单据日期 | string | FDate |
| FSaleOrgId_FNumber | 销售组织 | string | FSaleOrgId.FNumber |
| FRetcustId_FNumber | 退货客户 | string | FRetcustId.FNumber |
| SubHeadEntity_FEntryId | SubHeadEntity_FEntryId | string | SubHeadEntity_FEntryId |
| FMaterialId_FNumber | 物料编码 | string | FMaterialId.FNumber |
| FStockId_FNumber | 仓库编码 | string | FStockId.FNumber |
| FRealQty | 实退数量 | string | FRealQty |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | SAL_RETURNSTOCK |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|---|---|---|
| FID | FID | string | |
| FBillNo | 单据编码 | string | |
| FDate | 单据日期 | string | |
| FSaleOrgId_FNumber | 销售组织 | string | |
| FRetcustId_FNumber | 退货客户 | string | |
| SubHeadEntity_FEntryId | SubHeadEntity_FEntryId | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FStockId_FNumber | 仓库编码 | string | |
| FRealQty | 实退数量 | string |
聚水潭接口明细
- API：jushuitan.otherinout.upload
- NAME：新建其它出入库（新）
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 | |
|---|---|---|---|---|
| is_confirm | 是否自动确认单据 | true | 是否自动确认单据 | |
| wms_co_id | 分仓编号 | 分仓编号 | ||
| type | 出入库类型: in是入库 out是出库 | in | 出入库类型: in是入库 out是出库 | |
| external_id | 外部单号 | {{FBillNo}}{{SubHeadEntity_FEntryId}}XStuiin | 外部单号 | |
| warehouse | 主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 | 1 | 主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 | |
| drp_co_name | 出库类型 | 出库类型 | ||
| receiver_name | 收件人姓名 | 收件人姓名 | ||
| receiver_mobile | 收件人手机号 | 收件人手机号 | ||
| receiver_state | 收件地址省 | 收件地址省 | ||
| receiver_city | 收件地址市 | 收件地址市 | ||
| receiver_district | 收件地址区 | 县 | 收件地址区 县 | |
| receiver_address | 收件详细地址 | 收件详细地址 | ||
| items | 商品列表 | items | 商品列表 | |
| items.remark | 备注 | 备注 | ||
| items.sku_id | 商品编码 | {{items.FMaterialId_FNumber}} | 商品编码 | |
| items.qty | 数量 | {{items.FRealQty}} | 数量 | |
| items.batch_id | 批次单号，系统中需开启相关配置 | 批次单号，系统中需开启相关配置 | ||
| items.produced_date | 生产日期，系统中需开启相关配置 | 生产日期，系统中需开启相关配置 | ||
| items.expiration_date | 有效期至，系统中需开启相关配置 | 有效期至，系统中需开启相关配置 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| code | 非0失败 | 非0失败 | |
| msg | 错误描述 | 错误描述 | |
| data | 返回内容 | 返回内容 | |
| data.external_id | 外部单号 | 外部单号 | |
| data.io_id | 系统内部单号 | 系统内部单号 |
系统数据集成价值
通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接金蝶云星空和聚水潭，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。
