金蝶云星空和聚水潭单据接口对接

接通系统:聚水潭
聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。随着客户需求的不断变化,如今聚水潭已经发展成为以SaaSERP为核心,集多种商家服务为一体的SaaS协同平台。经过8年多的发展,公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点,服务范围覆盖超过400个城镇,为客户提供及时、周到和专业的服务。
接通系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置方案
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则,例如取数就要根据查询接口获取聚水潭的数据,并且根据对应的条件进行取数,目标系统就必须根据目标系统的格式,以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。


聚水潭接口明细
- 接口:allocate.query
- 接口名称:调拨单查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
modified_begin | 修改开始时间 | string | 修改起始时间,和结束时间必须同时存在,时间间隔不能超过七天,与线上单号不能同时为空 |
modified_end | 修改结束时间 | string | 修改结束时间,和起始时间必须同时存在,时间间隔不能超过七天,与线上单号不能同时为空 |
so_ids | 线上单号 | string | 指定线上订单号,和时间段不能同时为空 |
page_index | 开始页码 | string | 第几页,从第一页开始,默认1 |
page_size | 每页条数 | string | 每页多少条,默认30,最大50 |
响应参数
字段 | 名称 | 类型 | 描述 |
items | 商品集合 | array | 商品集合 |
items.ioi_id | 子单号 | string | 子单号 |
items.sku_id | 商品编码 | array | 商品编码 |
items.qty | 数量 | string | 数量 |
items.name | 商品名称 | string | 商品名称 |
items.properties_value | 颜色及规格 | string | 颜色及规格 |
items.io_id | 调拨单号 | string | 调拨单号 |
items.wms_co_id | 分仓编号,调拨出为发起方,调拨入为接收方 | string | 分仓编号,调拨出为发起方,调拨入为接收方 |
items.io_date | 单据日期 | string | 单据日期 |
items.batchs | 批次集合 | array | |
items.batchs.sku_id | 批次号 | string | 批次号 |
items.batchs.sku_id | 商品编码 | string | 批次号 |
items.batchs.qty | 数量 | string | 批次号 |
items.batchs.product_date | 批次日期 | string | 批次日期 |
items.batchs.supplier_id | 供应商编号 | string | 供应商编号 |
items.batchs.supplier_name | 供应商名称 | string | 供应商名称 |
items.batchs.modified | 修改时间 | string | 修改时间 |
items.batchs.status | 单据状态 | string | 单据状态:Creating:草拟,OuterConfirming:待审核,WaitConfirm:待发货,Confirmed:完成,Archive:归档,Cancelled:取消,Delete:作废 |
items.batchs.warehouse | 调拨出仓库名称 | string | 调拨出仓库名称 |
items.batchs.link_warehouse | 调拨入仓库名称 | string | 调拨入仓库名称 |
items.batchs.f_status | 财务状态 | string | 财务状态 Archive:归档,modifing:变更,WaitConfirm:待审核,Confirmed:已审核,Cancelled:取消,Delete:作废 |
items.batchs.type | 调拨类型 | string | 调拨类型 |
items.batchs.wh_id | 调拨出仓库编号 | string | 调拨出仓库编号;主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 |
items.batchs.link_wh_id | 调拨入仓库编号 | string | 调拨入仓库编号;主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 |
items.batchs.link_wms_co_id | 调拨入分仓编号,调拨出为接收方,调拨入为发起方 | string | 调拨入分仓编号,调拨出为接收方,调拨入为发起方 |
items.batchs.link_io_id | 调拨入关联单号 | string | 调拨入关联单号 |
items.batchs.so_id | 线上单号 | string | 线上单号 |
items.batchs.remark | 备注 | string | 备注 |
items.batchs.creator_name | 创建人 | string | 创建人 |
金蝶云星空接口明细
- API:batchSave
- NAME:调拨单新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillNo | 单据编号 | {{io_id}} | 单据编号 |
FBillTypeID | 单据类型 | ZJDB01_SYS | 单据类型 |
FBizType | 业务类型 | NORMAL | 下拉列表 |
FTransferDirect | 调拨方向 | GENERAL | 下拉列表 |
FTransferBizType | 调拨类型 | InnerOrgTransfer | 下拉列表 |
FStockOutOrgId | 调出库存组织 | 101 | 组织 |
FOwnerTypeOutIdHead | 调出货主类型 | BD_OwnerOrg | 多类别基础资料列表 |
FOwnerOutIdHead | 调出货主 | 101 | 多类别基础资料 |
FStockOrgId | 调入库存组织 | 101 | 组织 |
FDate | 日期 | {{io_date}} | 日期 |
FNote | 备注 | {{remark}} | 多行文本 |
FBillEntry | 明细信息 | items | 1 |
FBillEntry.FMaterialId | 物料编码 | {{items.sku_id}} | 基础资料 |
FBillEntry.FCMKBarCode | 零售条形码 | | 文本 |
FBillEntry.FQty | 调拨数量 | {{items.qty}} | 数量 |
FBillEntry.FLot | 调出批号 | | 批次 |
FBillEntry.FProduceDate | 生产日期 | | 批次 |
FBillEntry.FSrcStockId | 调出仓库 | {{wms_co_id}} | 基础资料 |
FBillEntry.FDestStockId | 调入仓库 | {{link_wms_co_id}} | 基础资料 |
FBillEntry.FNoteEntry | 备注 | | 多行文本 |
FBillEntry.FISFREE | 赠品 | | 复选框 |
FBillEntry.FormId | 业务对象表单Id | STK_TransferDirect | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FBillEntry.IsAutoSubmitAndAudit | 提交并审核 | false | |
FBillEntry.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FBillEntry.Operation | 执行的操作 | Save | |
系统对接总览
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
