聚水潭和金蝶云星空单据接口对接
来源系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
写入目标:聚水潭
聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。
多系统对接方案配置
数据集成平台对应的配置金蝶云星空与聚水潭的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与聚水潭之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：库存查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | FID | string | |
| FStockId | 仓库编码 | string | |
| FMaterialId | 物料编码 | string | |
| FQty | 库存量 | string | |
| FBaseQty | 库存基本单位数量 | string | |
| FMaterialId_FName | 物料名称 | string | |
| FUpdateTime | 最后更新日期 | string | |
| FOwnerId | 货主ID | string | |
| FKeeperId | 保管者ID | string | |
| FStockOrgId | 库存组织ID | string | |
| FOwnerTypeId | 货主类型ID | string | |
| FStockId_FName | 仓库名称 | string | |
| FMaterialId_FIsExpParToFlot | 批号附属信息 | string | |
| FOwnerId_FNumber | 货主编码 | string | |
| FKeeperId_FNumber | 保管者编码 | string | |
| FStockOrgId_FNumber | 库存组织编码 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 日期 | string | |
| FStockStatusId | 库存状态 | string | |
| FLot | 批号 | string | |
| FLotProduceDate | FLotProduceDate | string | |
| FLotExpiryDate | FLotExpiryDate | string | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | FUpdateTime是库存的最近更新日期 |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FID | FID | string | |
| FStockId | 仓库编码 | string | |
| FMaterialId | 物料编码 | string | |
| FQty | 库存量 | string | |
| FBaseQty | 库存基本单位数量 | string | |
| FMaterialId_FName | 物料名称 | string | |
| FUpdateTime | 最后更新日期 | string | |
| FOwnerId | 货主ID | string | |
| FKeeperId | 保管者ID | string | |
| FStockOrgId | 库存组织ID | string | |
| FOwnerTypeId | 货主类型ID | string | |
| FStockId_FName | 仓库名称 | string | |
| FMaterialId_FSpecification | 物料的物料名称 | string | |
| FOwnerId_FNumber | 货主编码 | string | |
| FKeeperId_FNumber | 保管者编码 | string | |
| FStockOrgId_FNumber | 库存组织编码 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 生产日期 | string | |
| FStockStatusId | 库存状态 | string | |
| FLot | 批号 | string | |
| FLotProduceDate | FLotProduceDate | string | |
| FLotExpiryDate | FLotExpiryDate | string | |
| ProduceDate | ProduceDate | string | |
| ExpiryDate | ExpiryDate | string | |
聚水潭接口明细
- 接口：jushuitan.inventoryv2.upload
- 接口名称：新建盘点单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| wms_co_id | 默认主仓 | string | |
| type | 盘点类型 | string | |
| is_confirm | 是否确认 | string | |
| so_id | 外部单号 | string | |
| warehouse | 仓库 | string | 仓库;主仓=1，销退仓=2， 进货仓=3，次品仓 = 4 |
| remark | 备注 | string | |
| items | 商品明细 | array | |
| items.sku_id | 商品编码 | string | |
| items.qty | 数量 | string | |
| items.batch_id | 批次号 | string | |
| items.produced_date | 生产日期 | string | |
| items.expiration_date | 有效期 | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| code | 0代表成功 | string | |
| msg | 提示信息 | string | |
| datas | datas | array | |
| datas.id | ERP内部单号 | string | |
| datas.so_id | 接口传入外部单号 | string | |
| datas.success | success | string | |
系统集成总览
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
