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

接通系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:聚水潭
聚水潭是SaaS协同平台、电商ERP软件。聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。
接口方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:金蝶云星空,源系统 API:委外领料查询,目标系统:聚水潭,目标系统 API新建其它出入库(新)。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:委外领料查询
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| Fentity_FEntryID | Fentity_FEntryID | string | Fentity_FEntryID |
| FBillNo | 单据编号 | string | FBillNo |
| FDocumentStatus | 单据状态 | string | FDocumentStatus |
| FApproverid_FName | 审核人名称 | string | FApproverid.FName |
| FApproveDate | 审核日期 | string | FApproveDate |
| FModifierId_FName | 修改人_名称 | string | FModifierId.FName |
| FCreateDate | 创建日期 | string | FCreateDate |
| FCreatorId_FName | 创建人名称 | string | FCreatorId.FName |
| FModifyDate | 修改日期 | string | FModifyDate |
| FCancelDate | 作废日期 | string | FCancelDate |
| FCANCELER_FName | 作废人_名称 | string | FCANCELER.FName |
| FCancelStatus | 作废状态 | string | FCancelStatus |
| FDescription | 备注 | string | FDescription |
| FBillType | 单据类型 | string | FBillType |
| FDate | 日期 | string | FDate |
| FSubOrgId_FName | 委外组织名称 | string | FSubOrgId.FName |
| FSubOrgId_FNumber | 委外组织_编码 | string | FSubOrgId.FNumber |
| FSupplierId_FName | 供应商名称 | string | FSupplierId.FName |
| FSupplierId_FNumber | 供应商_编码 | string | FSupplierId.FNumber |
| FOwnerTypeId | 货主类型 | string | FOwnerTypeId |
| FOwnerId | 货主 | string | FOwnerId |
| FCurrId_FName | 本位币名称 | string | FCurrId.FName |
| FCurrId_FNumber | 本位币_编码 | string | FCurrId.FNumber |
| FStockOrgId_FName | 发料组织名称 | string | FStockOrgId.FName |
| FStockOrgId_FNumber | 发料组织_编码 | string | FStockOrgId.FNumber |
| FTransferBizType_FName | 跨组织业务类型名称 | string | FTransferBizType.FName |
| FTransferBizType_FNumber | 跨组织业务类型_编码 | string | FTransferBizType.FNumber |
| FSTOCKERID_FName | 仓管员名称 | string | FSTOCKERID.FName |
| FPickerId_FName | 领料人_名称 | string | FPickerId.FName |
| FIsCrossTrade | 跨法人交易 | string | FIsCrossTrade |
| FVmiBusiness | VMI业务 | string | FVmiBusiness |
| FSourceType | 倒冲来源 | string | FSourceType |
| FIsOwnerTInclOrg | 货主含组织 | string | FIsOwnerTInclOrg |
| FInventoryDate | 库存刷新日期 | string | FInventoryDate |
| FMaterialId_FName | 物料编码名称 | string | FMaterialId.FName |
| FMaterialId_FNumber | 物料编码_编码 | string | FMaterialId.FNumber |
| FProduceDate | 生产日期 | string | FProduceDate |
| FExpiryDate | 有效期至 | string | FExpiryDate |
| FBomId_FName | BOM版本名称 | string | FBomId.FName |
| FBomId_FNumber | BOM版本_编码 | string | FBomId.FNumber |
| FUnitID_FName | 单位名称 | string | FUnitID.FName |
| FUnitID_FNumber | 单位_编码 | string | FUnitID.FNumber |
| FAllowOverQty | 可超发数量 | string | FAllowOverQty |
| FSelPrcdReturnQty | 退料选单数量 | string | FSelPrcdReturnQty |
| FKeeperTypeId | 保管者类型 | string | FKeeperTypeId |
| FKeeperId | 保管者 | string | FKeeperId |
| FStockFlag | 更新库存标志 | string | FStockFlag |
| FMTONO | 计划跟踪号 | string | FMTONO |
| FProjectNO | 项目编号 | string | FProjectNO |
| FStockStatusId_FName | 库存状态名称 | string | FStockStatusId.FName |
| FStockStatusId_FNumber | 库存状态_编码 | string | FStockStatusId.FNumber |
| FStockID_FName | 仓库名称 | string | FStockID.FName |
| FStockID_FNumber | 仓库_编码 | string | FStockID.FNumber |
| FOperID | 工序号 | string | FOperID |
| FProcessID_FName | 作业名称 | string | FProcessID.FName |
| FProcessID_FNumber | 作业_编码 | string | FProcessID.FNumber |
| FPrice | 成本价 | string | FPrice |
| FAmount | 总成本 | string | FAmount |
| FSrcBillType | 系统源单类型 | string | FSrcBillType |
| FSrcBillNo | 系统源单编号 | string | FSrcBillNo |
| FSrcInterId | 系统源单内码 | string | FSrcInterId |
| FSrcEntryId | 系统源单分录内码 | string | FSrcEntryId |
| FSrcEntrySeq | 系统源单行号 | string | FSrcEntrySeq |
| FSubReqId | 委外订单内码 | string | FSubReqId |
| FSubReqBillNo | 委外订单编号 | string | FSubReqBillNo |
| FSubReqEntryId | 委外订单分录内码 | string | FSubReqEntryId |
| FSubReqEntrySeq | 委外订单行号 | string | FSubReqEntrySeq |
| FPPbomBillNo | 委外用料清单编号 | string | FPPbomBillNo |
| FPPbomEntryId | 委外用料清单分录内码 | string | FPPbomEntryId |
| FBaseUnitId_FName | 基本单位名称 | string | FBaseUnitId.FName |
| FBaseUnitId_FNumber | 基本单位_编码 | string | FBaseUnitId.FNumber |
| FBaseAppQty | 基本单位申请数量 | string | FBaseAppQty |
| FBaseActualQty | 基本单位实发数量 | string | FBaseActualQty |
| FBaseAllowOverQty | 基本单位可超发数量 | string | FBaseAllowOverQty |
| FBaseSelPrcdReturnQty | 基本单位退料选单数量 | string | FBaseSelPrcdReturnQty |
| FStockUnitId_FName | 库存单位名称 | string | FStockUnitId.FName |
| FStockUnitId_FNumber | 库存单位_编码 | string | FStockUnitId.FNumber |
| FStockAppQty | 库存单位申请数量 | string | FStockAppQty |
| FStockAllowOverQty | 库存单位可超发数量 | string | FStockAllowOverQty |
| FStockSelPrcdReturnQty | 库存单位退料选单数量 | string | FStockSelPrcdReturnQty |
| FSecUnitId_FName | 辅助单位名称 | string | FSecUnitId.FName |
| FSecUnitId_FNumber | 辅助单位_编码 | string | FSecUnitId.FNumber |
| FSecActualQty | 辅助单位实发数量 | string | FSecActualQty |
| FSecAllowOverQty | 辅助单位可超发数量 | string | FSecAllowOverQty |
| FSecSelPrcdReturnQty | 辅助单位退料选单数量 | string | FSecSelPrcdReturnQty |
| FAppQty | 申请数量 | string | FAppQty |
| FActualQty | 实发数量 | string | FActualQty |
| FLot_FName | 批号名称 | string | FLot.FName |
| FLot_FNumber | 批号_编码 | string | FLot.FNumber |
| FParentOwnerTypeId | 产品货主类型 | string | FParentOwnerTypeId |
| FParentOwnerId | 产品货主 | string | FParentOwnerId |
| FSRCBIZBILLTYPE | 业务源单类型名称 | string | FSRCBIZBILLTYPE |
| FSRCBIZBILLNO | 业务源单编号 | string | FSRCBIZBILLNO |
| FSRCBIZINTERID | 业务源单内码 | string | FSRCBIZINTERID |
| FSRCBIZENTRYID | 业务源单分录内码 | string | FSRCBIZENTRYID |
| FSRCBIZENTRYSEQ | 业务源单行号 | string | FSRCBIZENTRYSEQ |
| FPickingStatus | 拣货状态 | string | FPickingStatus |
| FBFLowId | 业务流程 | string | FBFLowId |
| FParentMaterialId_FName | 产品编码_名称 | string | FParentMaterialId.FName |
| FParentMaterialId_FNumber | 产品编码编码 | string | FParentMaterialId.FNumber |
| FSNUnitID_FName | 序列号单位_名称 | string | FSNUnitID.FName |
| FSNUnitID_FNumber | 序列号单位编码 | string | FSNUnitID.FNumber |
| FSNQty | 序列号单位数量 | string | FSNQty |
| FReserveType | 预留类型 | string | FReserveType |
| FSettleOrgId_FName | 结算组织_名称 | string | FSettleOrgId.FName |
| FSettleOrgId_FNumber | 结算组织_编码 | string | FSettleOrgId.FNumber |
| FBaseStockActualQty | 主库存基本单位实发数量 | string | FBaseStockActualQty |
| FStockActualQty | 库存单位实发数量 | string | FStockActualQty |
| FConsome | 消耗汇总 | string | FConsome |
| FPMBillNo | 备料单编号 | string | FPMBillNo |
| FReqSrc | 需求来源 | string | FReqSrc |
| FReqBillNo | 需求单据 | string | FReqBillNo |
| FReqBillId | 需求单据内码 | string | FReqBillId |
| FReqEntrySeq | 需求单据行号 | string | FReqEntrySeq |
| FReqEntryId | 需求单据分录内码 | string | FReqEntryId |
| FPOOrderBillNo | 采购订单 | string | FPOOrderBillNo |
| FPOOrderSeq | 采购订单行号 | string | FPOOrderSeq |
| FGroupRow | 组别 | string | FGroupRow |
| FTransRetFormId | 转出退料单标识 | string | FTransRetFormId |
| FTransRetBillNo | 转出退料单号 | string | FTransRetBillNo |
| FTransRetId | 转出退料单内码 | string | FTransRetId |
| FTransRetEntryId | 转出退料单分录内码 | string | FTransRetEntryId |
| FTransRetEntrySeq | 转出退料单行号 | string | FTransRetEntrySeq |
| Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | int | |
| FilterString | 过滤条件 | string | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FStockID.FNumber IN ('11084916') AND FMaterialID.FIsSalseByNet=1 |
| FieldKeys | 需查询的字段key集合 | array | |
| FormId | 业务对象表单Id | string | SUB_PickMtrl |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
| Fentity_FEntryID | Fentity_FEntryID | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FApproverId_FName | 审核人名称 | string | |
| FApproveDate | 审核日期 | string | |
| FModifierId_FName | 修改人_名称 | string | |
| FCreateDate | 创建日期 | string | |
| FCreatorId_FName | 创建人名称 | string | |
| FModifyDate | 修改日期 | string | |
| FCancelDate | 作废日期 | string | |
| FCANCELER_FName | 作废人_名称 | string | |
| FCancelStatus | 作废状态 | string | |
| FDescription | 备注 | string | |
| FBillType | 单据类型 | string | |
| FDate | 日期 | string | |
| FSubOrgId_FName | 委外组织名称 | string | |
| FSubOrgId_FNumber | 委外组织_编码 | string | |
| FSupplierId_FName | 供应商名称 | string | |
| FSupplierId_FNumber | 供应商_编码 | string | |
| FOwnerTypeId | 货主类型 | string | |
| FOwnerId | 货主 | string | |
| FCurrId_FName | 本位币名称 | string | |
| FCurrId_FNumber | 本位币_编码 | string | |
| FStockOrgId_FName | 发料组织名称 | string | |
| FStockOrgId_FNumber | 发料组织_编码 | string | |
| FTransferBizType_FName | 跨组织业务类型名称 | string | |
| FTransferBizType_FNumber | 跨组织业务类型_编码 | string | |
| FSTOCKERID_FName | 仓管员名称 | string | |
| FPickerId_FName | 领料人_名称 | string | |
| FIsCrossTrade | 跨法人交易 | string | |
| FVmiBusiness | VMI业务 | string | |
| FSourceType | 倒冲来源 | string | |
| FIsOwnerTInclOrg | 货主含组织 | string | |
| FInventoryDate | 库存刷新日期 | string | |
| FMaterialId_FName | 物料编码名称 | string | |
| FMaterialId_FNumber | 物料编码_编码 | string | |
| FProduceDate | 生产日期 | string | |
| FExpiryDate | 有效期至 | string | |
| FBomId_FName | BOM版本名称 | string | |
| FBomId_FNumber | BOM版本_编码 | string | |
| FUnitID_FName | 单位名称 | string | |
| FUnitID_FNumber | 单位_编码 | string | |
| FAllowOverQty | 可超发数量 | string | |
| FSelPrcdReturnQty | 退料选单数量 | string | |
| FKeeperTypeId | 保管者类型 | string | |
| FKeeperId | 保管者 | string | |
| FStockFlag | 更新库存标志 | string | |
| FMTONO | 计划跟踪号 | string | |
| FProjectNO | 项目编号 | string | |
| FStockStatusId_FName | 库存状态名称 | string | |
| FStockStatusId_FNumber | 库存状态_编码 | string | |
| FStockID_FName | 仓库名称 | string | |
| FStockID_FNumber | 仓库_编码 | string | |
| FOperID | 工序号 | string | |
| FProcessID_FName | 作业名称 | string | |
| FProcessID_FNumber | 作业_编码 | string | |
| FPrice | 成本价 | string | |
| FAmount | 总成本 | string | |
| FSrcBillType | 系统源单类型 | string | |
| FSrcBillNo | 系统源单编号 | string | |
| FSrcInterId | 系统源单内码 | string | |
| FSrcEntryId | 系统源单分录内码 | string | |
| FSrcEntrySeq | 系统源单行号 | string | |
| FSubReqId | 委外订单内码 | string | |
| FSubReqBillNo | 委外订单编号 | string | |
| FSubReqEntryId | 委外订单分录内码 | string | |
| FSubReqEntrySeq | 委外订单行号 | string | |
| FPPbomBillNo | 委外用料清单编号 | string | |
| FPPbomEntryId | 委外用料清单分录内码 | string | |
| FBaseUnitId_FName | 基本单位名称 | string | |
| FBaseUnitId_FNumber | 基本单位_编码 | string | |
| FBaseAppQty | 基本单位申请数量 | string | |
| FBaseActualQty | 基本单位实发数量 | string | |
| FBaseAllowOverQty | 基本单位可超发数量 | string | |
| FBaseSelPrcdReturnQty | 基本单位退料选单数量 | string | |
| FStockUnitId_FName | 库存单位名称 | string | |
| FStockUnitId_FNumber | 库存单位_编码 | string | |
| FStockAppQty | 库存单位申请数量 | string | |
| FStockAllowOverQty | 库存单位可超发数量 | string | |
| FStockSelPrcdReturnQty | 库存单位退料选单数量 | string | |
| FSecUnitId_FName | 辅助单位名称 | string | |
| FSecUnitId_FNumber | 辅助单位_编码 | string | |
| FSecActualQty | 辅助单位实发数量 | string | |
| FSecAllowOverQty | 辅助单位可超发数量 | string | |
| FSecSelPrcdReturnQty | 辅助单位退料选单数量 | string | |
| FAppQty | 申请数量 | string | |
| FActualQty | 实发数量 | string | |
| FLot_FName | 批号名称 | string | |
| FLot_FNumber | 批号_编码 | string | |
| FParentOwnerTypeId | 产品货主类型 | string | |
| FParentOwnerId | 产品货主 | string | |
| FSRCBIZBILLTYPE | 业务源单类型名称 | string | |
| FSRCBIZBILLNO | 业务源单编号 | string | |
| FSRCBIZINTERID | 业务源单内码 | string | |
| FSRCBIZENTRYID | 业务源单分录内码 | string | |
| FSRCBIZENTRYSEQ | 业务源单行号 | string | |
| FPickingStatus | 拣货状态 | string | |
| FBFLowId | 业务流程 | string | |
| FParentMaterialId_FName | 产品编码_名称 | string | |
| FParentMaterialId_FNumber | 产品编码编码 | string | |
| FSNUnitID_FName | 序列号单位_名称 | string | |
| FSNUnitID_FNumber | 序列号单位编码 | string | |
| FSNQty | 序列号单位数量 | string | |
| FReserveType | 预留类型 | string | |
| FSettleOrgId_FName | 结算组织_名称 | string | |
| FSettleOrgId_FNumber | 结算组织_编码 | string | |
| FBaseStockActualQty | 主库存基本单位实发数量 | string | |
| FStockActualQty | 库存单位实发数量 | string | |
| FConsome | 消耗汇总 | string | |
| FPMBillNo | 备料单编号 | string | |
| FReqSrc | 需求来源 | string | |
| FReqBillNo | 需求单据 | string | |
| FReqBillId | 需求单据内码 | string | |
| FReqEntrySeq | 需求单据行号 | string | |
| FReqEntryId | 需求单据分录内码 | string | |
| FPOOrderBillNo | 采购订单 | string | |
| FPOOrderSeq | 采购订单行号 | string | |
| FGroupRow | 组别 | string | |
| FTransRetFormId | 转出退料单标识 | string | |
| FTransRetBillNo | 转出退料单号 | string | |
| FTransRetId | 转出退料单内码 | string | |
| FTransRetEntryId | 转出退料单分录内码 | string | |
| FTransRetEntrySeq | 转出退料单行号 | string | |
聚水潭接口明细
- API:jushuitan.otherinout.upload
- NAME:新建其它出入库(新)
- METHOD:POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| is_confirm | 是否自动确认单据 | true | 是否自动确认单据 |
| wms_co_id | 分仓编号 | 11084916 | 分仓编号 |
| type | 出入库类型: in是入库 out是出库 | out | 出入库类型: in是入库 out是出库 |
| external_id | 外部单号 | {{FBillNo}}WWLLout | 外部单号 |
| 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.FActualQty}} | 数量 |
| items.batch_id | 批次单号,系统中需开启相关配置 | {{items.FLot_FNumber}} | 批次单号,系统中需开启相关配置 |
| items.produced_date | 生产日期,系统中需开启相关配置 | {{items.FProduceDate}} | 生产日期,系统中需开启相关配置 |
| items.expiration_date | 有效期至,系统中需开启相关配置 | {{items.FExpiryDate}} | 有效期至,系统中需开启相关配置 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
| code | 非0失败 | | 非0失败 |
| msg | 错误描述 | | 错误描述 |
| data | 返回内容 | | 返回内容 |
| data.external_id | 外部单号 | | 外部单号 |
| data.io_id | 系统内部单号 | | 系统内部单号 |
数据对接价值
通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线,传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能,已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线,能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。
