金蝶云星空与聚水潭对接集成委外领料查询连通新建其它出入库(新)(委外领料单对接其他出库单)
源系统:金蝶云星空
金蝶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 | 单据编号 |
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 | VMI业务 |
FSourceType | 倒冲来源 | string | 倒冲来源 |
FIsOwnerTInclOrg | 货主含组织 | string | 货主含组织 |
FInventoryDate | 库存刷新日期 | string | 库存刷新日期 |
FMaterialId_FName | 物料编码_名称 | string | 物料编码_名称 |
FMaterialId_FNumber | 物料编码_编码 | string | 物料编码_编码 |
FProduceDate | 生产日期 | string | 生产日期 |
FExpiryDate | 有效期至 | string | 有效期至 |
FBomId_FName | BOM版本_名称 | string | BOM版本_名称 |
FBomId_FNumber | BOM版本_编码 | string | BOM版本_编码 |
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 | 转出退料单行号 |
Limit | 最大行数 | string | 金蝶的查询分页参数 |
StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
响应参数
字段 | 名称 | 类型 | 描述 |
Fentity_FEntryID | Fentity_FEntryID | string | Fentity_FEntryID |
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 | VMI业务 |
FSourceType | 倒冲来源 | string | 倒冲来源 |
FIsOwnerTInclOrg | 货主含组织 | string | 货主含组织 |
FInventoryDate | 库存刷新日期 | string | 库存刷新日期 |
FMaterialId_FName | 物料编码_名称 | string | 物料编码_名称 |
FMaterialId_FNumber | 物料编码_编码 | string | 物料编码_编码 |
FProduceDate | 生产日期 | string | 生产日期 |
FExpiryDate | 有效期至 | string | 有效期至 |
FBomId_FName | BOM版本_名称 | string | BOM版本_名称 |
FBomId_FNumber | BOM版本_编码 | string | BOM版本_编码 |
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 | 转出退料单行号 |
聚水潭接口明细
- 接口:jushuitan.otherinout.upload
- 接口名称:新建其它出入库(新)
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
is_confirm | 是否自动确认单据 | string | 是否自动确认单据 |
wms_co_id | 分仓编号 | string | 分仓编号 |
type | 出入库类型: in是入库 out是出库 | string | 出入库类型: in是入库 out是出库 |
external_id | 外部单号 | string | 外部单号 |
warehouse | 主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 | string | 主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 |
drp_co_name | 出库类型 | string | 出库类型 |
receiver_name | 收件人姓名 | string | 收件人姓名 |
receiver_mobile | 收件人手机号 | string | 收件人手机号 |
receiver_state | 收件地址省 | string | 收件地址省 |
receiver_city | 收件地址市 | string | 收件地址市 |
receiver_district | 收件地址区|县 | string | 收件地址区 县 |
receiver_address | 收件详细地址 | string | 收件详细地址 |
items | 商品列表 | array | 商品列表 |
items.remark | 备注 | string | 备注 |
items.sku_id | 商品编码 | string | 商品编码 |
items.qty | 数量 | string | 数量 |
items.batch_id | 批次单号,系统中需开启相关配置 | string | 批次单号,系统中需开启相关配置 |
items.produced_date | 生产日期,系统中需开启相关配置 | string | 生产日期,系统中需开启相关配置 |
items.expiration_date | 有效期至,系统中需开启相关配置 | string | 有效期至,系统中需开启相关配置 |
响应参数
字段 | 名称 | 类型 | 描述 |
code | 非0失败 | string | 非0失败 |
msg | 错误描述 | string | 错误描述 |
data | 返回内容 | array | 返回内容 |
data.external_id | 外部单号 | string | 外部单号 |
data.io_id | 系统内部单号 | string | 系统内部单号 |
系统数据集成价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到聚水潭之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。
系统数据对接方案元数据代码