金蝶云星空与聚水潭对接集成委外领料查询连通新建其它出入库(新)(委外领料单对接其他出库单)

对接系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:聚水潭
聚水潭成立于2014年,创始人兼CEO骆海东拥有近三十年传统及电商ERP的研发和实施部署经验。聚水潭创建之初,以电商SaaSERP切入市场,凭借出色的产品和服务,快速获得市场的肯定。随着客户需求的不断变化,如今聚水潭已经发展成为以SaaSERP为核心,集多种商家服务为一体的SaaS协同平台。经过8年多的发展,公司员工从2014年成立之初的9人增加到现在近4000人。聚水潭已在全国设立了超过100个线下服务网点,服务范围覆盖超过400个城镇,为客户提供及时、周到和专业的服务。
数据对接方案
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:金蝶云星空的接口参数设置,以及设定好目标平台:聚水潭的映射,即可启动方案进行测试


金蝶云星空接口明细
- 调用接口: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 | 系统内部单号 | | 系统内部单号 |
系统对接概况
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到聚水潭之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。

