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

对接系统:金蝶云星空
金蝶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架构。

