金蝶云星空和聚水潭接口打通对接实战

对接源平台:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

接通系统：聚水潭

聚水潭SaaSERP于2014年4月上线，目前累计超过2.5万商家注册使用，成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天，聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单，超过了淘宝对ERP系统吞吐量极限要求的16倍，成为行业里的新标杆。截止目前，聚水潭客户已超2.5万家，其中有南极人、POVOS奔腾，恒源祥，柚子美衣，洁丽雅，FLYCO飞科，波司登，满速，欧丝璐等，并与知名电商圈“老A电商学院”达成深度合作。

数据接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到聚水潭中。轻易云集成平台的可视化配置轻松实现。

金蝶云星空接口明细

API：executeBillQuery
NAME：委外领料查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 Fentity_FEntryIDFentity_FEntryIDFentity_FEntryIDFentity_FEntryID FBillNo单据编号FBillNo单据编号 FDocumentStatus单据状态FDocumentStatus单据状态 FApproverid_FName审核人名称FApproverid.FName审核人_名称 FApproveDate审核日期FApproveDate审核日期 FModifierId_FName修改人名称FModifierId.FName修改人_名称 FCreateDate创建日期FCreateDate创建日期 FCreatorId_FName创建人名称FCreatorId.FName创建人_名称 FModifyDate修改日期FModifyDate修改日期 FCancelDate作废日期FCancelDate作废日期 FCANCELER_FName作废人名称FCANCELER.FName作废人_名称 FCancelStatus作废状态FCancelStatus作废状态 FDescription备注FDescription备注 FBillType单据类型FBillType单据类型 FDate日期FDate日期 FSubOrgId_FName委外组织名称FSubOrgId.FName委外组织_名称 FSubOrgId_FNumber委外组织编码FSubOrgId.FNumber委外组织_编码 FSupplierId_FName供应商名称FSupplierId.FName供应商_名称 FSupplierId_FNumber供应商编码FSupplierId.FNumber供应商_编码 FOwnerTypeId货主类型FOwnerTypeId货主类型 FOwnerId货主FOwnerId货主 FCurrId_FName本位币名称FCurrId.FName本位币_名称 FCurrId_FNumber本位币编码FCurrId.FNumber本位币_编码 FStockOrgId_FName发料组织名称FStockOrgId.FName发料组织_名称 FStockOrgId_FNumber发料组织编码FStockOrgId.FNumber发料组织_编码 FTransferBizType_FName跨组织业务类型名称FTransferBizType.FName跨组织业务类型_名称 FTransferBizType_FNumber跨组织业务类型编码FTransferBizType.FNumber跨组织业务类型_编码 FSTOCKERID_FName仓管员名称FSTOCKERID.FName仓管员_名称 FPickerId_FName领料人名称FPickerId.FName领料人_名称 FIsCrossTrade跨法人交易FIsCrossTrade跨法人交易 FVmiBusinessVMI业务FVmiBusinessVMI业务 FSourceType倒冲来源FSourceType倒冲来源 FIsOwnerTInclOrg货主含组织FIsOwnerTInclOrg货主含组织 FInventoryDate库存刷新日期FInventoryDate库存刷新日期 FMaterialId_FName物料编码名称FMaterialId.FName物料编码_名称 FMaterialId_FNumber物料编码编码FMaterialId.FNumber物料编码_编码 FProduceDate生产日期FProduceDate生产日期 FExpiryDate有效期至FExpiryDate有效期至 FBomId_FNameBOM版本名称FBomId.FNameBOM版本_名称 FBomId_FNumberBOM版本编码FBomId.FNumberBOM版本_编码 FUnitID_FName单位名称FUnitID.FName单位_名称 FUnitID_FNumber单位编码FUnitID.FNumber单位_编码 FAllowOverQty可超发数量FAllowOverQty可超发数量 FSelPrcdReturnQty退料选单数量FSelPrcdReturnQty退料选单数量 FKeeperTypeId保管者类型FKeeperTypeId保管者类型 FKeeperId保管者FKeeperId保管者 FStockFlag更新库存标志FStockFlag更新库存标志 FMTONO计划跟踪号FMTONO计划跟踪号 FProjectNO项目编号FProjectNO项目编号 FStockStatusId_FName库存状态名称FStockStatusId.FName库存状态_名称 FStockStatusId_FNumber库存状态编码FStockStatusId.FNumber库存状态_编码 FStockID_FName仓库名称FStockID.FName仓库_名称 FStockID_FNumber仓库编码FStockID.FNumber仓库_编码 FOperID工序号FOperID工序号 FProcessID_FName作业名称FProcessID.FName作业_名称 FProcessID_FNumber作业编码FProcessID.FNumber作业_编码 FPrice成本价FPrice成本价 FAmount总成本FAmount总成本 FSrcBillType系统源单类型FSrcBillType系统源单类型 FSrcBillNo系统源单编号FSrcBillNo系统源单编号 FSrcInterId系统源单内码FSrcInterId系统源单内码 FSrcEntryId系统源单分录内码FSrcEntryId系统源单分录内码 FSrcEntrySeq系统源单行号FSrcEntrySeq系统源单行号 FSubReqId委外订单内码FSubReqId委外订单内码 FSubReqBillNo委外订单编号FSubReqBillNo委外订单编号 FSubReqEntryId委外订单分录内码FSubReqEntryId委外订单分录内码 FSubReqEntrySeq委外订单行号FSubReqEntrySeq委外订单行号 FPPbomBillNo委外用料清单编号FPPbomBillNo委外用料清单编号 FPPbomEntryId委外用料清单分录内码FPPbomEntryId委外用料清单分录内码 FBaseUnitId_FName基本单位名称FBaseUnitId.FName基本单位_名称 FBaseUnitId_FNumber基本单位编码FBaseUnitId.FNumber基本单位_编码 FBaseAppQty基本单位申请数量FBaseAppQty基本单位申请数量 FBaseActualQty基本单位实发数量FBaseActualQty基本单位实发数量 FBaseAllowOverQty基本单位可超发数量FBaseAllowOverQty基本单位可超发数量 FBaseSelPrcdReturnQty基本单位退料选单数量FBaseSelPrcdReturnQty基本单位退料选单数量 FStockUnitId_FName库存单位名称FStockUnitId.FName库存单位_名称 FStockUnitId_FNumber库存单位编码FStockUnitId.FNumber库存单位_编码 FStockAppQty库存单位申请数量FStockAppQty库存单位申请数量 FStockAllowOverQty库存单位可超发数量FStockAllowOverQty库存单位可超发数量 FStockSelPrcdReturnQty库存单位退料选单数量FStockSelPrcdReturnQty库存单位退料选单数量 FSecUnitId_FName辅助单位名称FSecUnitId.FName辅助单位_名称 FSecUnitId_FNumber辅助单位编码FSecUnitId.FNumber辅助单位_编码 FSecActualQty辅助单位实发数量FSecActualQty辅助单位实发数量 FSecAllowOverQty辅助单位可超发数量FSecAllowOverQty辅助单位可超发数量 FSecSelPrcdReturnQty辅助单位退料选单数量FSecSelPrcdReturnQty辅助单位退料选单数量 FAppQty申请数量FAppQty申请数量 FActualQty实发数量FActualQty实发数量 FLot_FName批号名称FLot.FName批号_名称 FLot_FNumber批号编码FLot.FNumber批号_编码 FParentOwnerTypeId产品货主类型FParentOwnerTypeId产品货主类型 FParentOwnerId产品货主FParentOwnerId产品货主 FSRCBIZBILLTYPE业务源单类型名称FSRCBIZBILLTYPE业务源单类型_名称 FSRCBIZBILLNO业务源单编号FSRCBIZBILLNO业务源单编号 FSRCBIZINTERID业务源单内码FSRCBIZINTERID业务源单内码 FSRCBIZENTRYID业务源单分录内码FSRCBIZENTRYID业务源单分录内码 FSRCBIZENTRYSEQ业务源单行号FSRCBIZENTRYSEQ业务源单行号 FPickingStatus拣货状态FPickingStatus拣货状态 FBFLowId业务流程FBFLowId业务流程 FParentMaterialId_FName产品编码名称FParentMaterialId.FName产品编码_名称 FParentMaterialId_FNumber产品编码编码FParentMaterialId.FNumber产品编码_编码 FSNUnitID_FName序列号单位名称FSNUnitID.FName序列号单位_名称 FSNUnitID_FNumber序列号单位编码FSNUnitID.FNumber序列号单位_编码 FSNQty序列号单位数量FSNQty序列号单位数量 FReserveType预留类型FReserveType预留类型 FSettleOrgId_FName结算组织名称FSettleOrgId.FName结算组织_名称 FSettleOrgId_FNumber结算组织编码FSettleOrgId.FNumber结算组织_编码 FBaseStockActualQty主库存基本单位实发数量FBaseStockActualQty主库存基本单位实发数量 FStockActualQty库存单位实发数量FStockActualQty库存单位实发数量 FConsome消耗汇总FConsome消耗汇总 FPMBillNo备料单编号FPMBillNo备料单编号 FReqSrc需求来源FReqSrc需求来源 FReqBillNo需求单据FReqBillNo需求单据 FReqBillId需求单据内码FReqBillId需求单据内码 FReqEntrySeq需求单据行号FReqEntrySeq需求单据行号 FReqEntryId需求单据分录内码FReqEntryId需求单据分录内码 FPOOrderBillNo采购订单FPOOrderBillNo采购订单 FPOOrderSeq采购订单行号FPOOrderSeq采购订单行号 FGroupRow组别FGroupRow组别 FTransRetFormId转出退料单标识FTransRetFormId转出退料单标识 FTransRetBillNo转出退料单号FTransRetBillNo转出退料单号 FTransRetId转出退料单内码FTransRetId转出退料单内码 FTransRetEntryId转出退料单分录内码FTransRetEntryId转出退料单分录内码 FTransRetEntrySeq转出退料单行号FTransRetEntrySeq转出退料单行号 Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FStockID.FNumber IN ('11084916') AND FMaterialID.FIsSalseByNet=1示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdSUB_PickMtrl必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 Fentity_FEntryIDFentity_FEntryIDFentity_FEntryID FBillNo单据编号单据编号 FDocumentStatus单据状态单据状态 FApproverId_FName审核人名称审核人_名称 FApproveDate审核日期审核日期 FModifierId_FName修改人名称修改人_名称 FCreateDate创建日期创建日期 FCreatorId_FName创建人名称创建人_名称 FModifyDate修改日期修改日期 FCancelDate作废日期作废日期 FCANCELER_FName作废人名称作废人_名称 FCancelStatus作废状态作废状态 FDescription备注备注 FBillType单据类型单据类型 FDate日期日期 FSubOrgId_FName委外组织名称委外组织_名称 FSubOrgId_FNumber委外组织编码委外组织_编码 FSupplierId_FName供应商名称供应商_名称 FSupplierId_FNumber供应商编码供应商_编码 FOwnerTypeId货主类型货主类型 FOwnerId货主货主 FCurrId_FName本位币名称本位币_名称 FCurrId_FNumber本位币编码本位币_编码 FStockOrgId_FName发料组织名称发料组织_名称 FStockOrgId_FNumber发料组织编码发料组织_编码 FTransferBizType_FName跨组织业务类型名称跨组织业务类型_名称 FTransferBizType_FNumber跨组织业务类型编码跨组织业务类型_编码 FSTOCKERID_FName仓管员名称仓管员_名称 FPickerId_FName领料人名称领料人_名称 FIsCrossTrade跨法人交易跨法人交易 FVmiBusinessVMI业务VMI业务 FSourceType倒冲来源倒冲来源 FIsOwnerTInclOrg货主含组织货主含组织 FInventoryDate库存刷新日期库存刷新日期 FMaterialId_FName物料编码名称物料编码_名称 FMaterialId_FNumber物料编码编码物料编码_编码 FProduceDate生产日期生产日期 FExpiryDate有效期至有效期至 FBomId_FNameBOM版本名称BOM版本_名称 FBomId_FNumberBOM版本编码BOM版本_编码 FUnitID_FName单位名称单位_名称 FUnitID_FNumber单位编码单位_编码 FAllowOverQty可超发数量可超发数量 FSelPrcdReturnQty退料选单数量退料选单数量 FKeeperTypeId保管者类型保管者类型 FKeeperId保管者保管者 FStockFlag更新库存标志更新库存标志 FMTONO计划跟踪号计划跟踪号 FProjectNO项目编号项目编号 FStockStatusId_FName库存状态名称库存状态_名称 FStockStatusId_FNumber库存状态编码库存状态_编码 FStockID_FName仓库名称仓库_名称 FStockID_FNumber仓库编码仓库_编码 FOperID工序号工序号 FProcessID_FName作业名称作业_名称 FProcessID_FNumber作业编码作业_编码 FPrice成本价成本价 FAmount总成本总成本 FSrcBillType系统源单类型系统源单类型 FSrcBillNo系统源单编号系统源单编号 FSrcInterId系统源单内码系统源单内码 FSrcEntryId系统源单分录内码系统源单分录内码 FSrcEntrySeq系统源单行号系统源单行号 FSubReqId委外订单内码委外订单内码 FSubReqBillNo委外订单编号委外订单编号 FSubReqEntryId委外订单分录内码委外订单分录内码 FSubReqEntrySeq委外订单行号委外订单行号 FPPbomBillNo委外用料清单编号委外用料清单编号 FPPbomEntryId委外用料清单分录内码委外用料清单分录内码 FBaseUnitId_FName基本单位名称基本单位_名称 FBaseUnitId_FNumber基本单位编码基本单位_编码 FBaseAppQty基本单位申请数量基本单位申请数量 FBaseActualQty基本单位实发数量基本单位实发数量 FBaseAllowOverQty基本单位可超发数量基本单位可超发数量 FBaseSelPrcdReturnQty基本单位退料选单数量基本单位退料选单数量 FStockUnitId_FName库存单位名称库存单位_名称 FStockUnitId_FNumber库存单位编码库存单位_编码 FStockAppQty库存单位申请数量库存单位申请数量 FStockAllowOverQty库存单位可超发数量库存单位可超发数量 FStockSelPrcdReturnQty库存单位退料选单数量库存单位退料选单数量 FSecUnitId_FName辅助单位名称辅助单位_名称 FSecUnitId_FNumber辅助单位编码辅助单位_编码 FSecActualQty辅助单位实发数量辅助单位实发数量 FSecAllowOverQty辅助单位可超发数量辅助单位可超发数量 FSecSelPrcdReturnQty辅助单位退料选单数量辅助单位退料选单数量 FAppQty申请数量申请数量 FActualQty实发数量实发数量 FLot_FName批号名称批号_名称 FLot_FNumber批号编码批号_编码 FParentOwnerTypeId产品货主类型产品货主类型 FParentOwnerId产品货主产品货主 FSRCBIZBILLTYPE业务源单类型名称业务源单类型_名称 FSRCBIZBILLNO业务源单编号业务源单编号 FSRCBIZINTERID业务源单内码业务源单内码 FSRCBIZENTRYID业务源单分录内码业务源单分录内码 FSRCBIZENTRYSEQ业务源单行号业务源单行号 FPickingStatus拣货状态拣货状态 FBFLowId业务流程业务流程 FParentMaterialId_FName产品编码名称产品编码_名称 FParentMaterialId_FNumber产品编码编码产品编码_编码 FSNUnitID_FName序列号单位名称序列号单位_名称 FSNUnitID_FNumber序列号单位编码序列号单位_编码 FSNQty序列号单位数量序列号单位数量 FReserveType预留类型预留类型 FSettleOrgId_FName结算组织名称结算组织_名称 FSettleOrgId_FNumber结算组织编码结算组织_编码 FBaseStockActualQty主库存基本单位实发数量主库存基本单位实发数量 FStockActualQty库存单位实发数量库存单位实发数量 FConsome消耗汇总消耗汇总 FPMBillNo备料单编号备料单编号 FReqSrc需求来源需求来源 FReqBillNo需求单据需求单据 FReqBillId需求单据内码需求单据内码 FReqEntrySeq需求单据行号需求单据行号 FReqEntryId需求单据分录内码需求单据分录内码 FPOOrderBillNo采购订单采购订单 FPOOrderSeq采购订单行号采购订单行号 FGroupRow组别组别 FTransRetFormId转出退料单标识转出退料单标识 FTransRetBillNo转出退料单号转出退料单号 FTransRetId转出退料单内码转出退料单内码 FTransRetEntryId转出退料单分录内码转出退料单分录内码 FTransRetEntrySeq转出退料单行号转出退料单行号

聚水潭接口明细

调用接口：jushuitan.otherinout.upload
接口名称：新建其它出入库（新）
方法：POST

请求参数

字段字段名称类型配置值 is_confirm是否自动确认单据stringtrue wms_co_id分仓编号string11084916 type出入库类型: in是入库 out是出库stringout external_id外部单号string{{FBillNo}}WWLLout warehouse主仓=1，销退仓=2，进货仓=3，次品仓 = 4string1 drp_co_name出库类型string金蝶委外领料单对接 receiver_name收件人姓名string receiver_mobile收件人手机号string receiver_state收件地址省string receiver_city收件地址市string receiver_district收件地址区县string receiver_address收件详细地址string items商品列表arrayitems items.remark备注string items.sku_id商品编码string{{items.FMaterialId_FNumber}} items.qty数量string{{items.FActualQty}} items.batch_id批次单号，系统中需开启相关配置string{{items.FLot_FNumber}} items.produced_date生产日期，系统中需开启相关配置string{{items.FProduceDate}} items.expiration_date有效期至，系统中需开启相关配置string{{items.FExpiryDate}}

响应参数

字段字段名称类型配置值 code非0失败string msg错误描述string data返回内容array data.external_id外部单号string data.io_id系统内部单号string

数据对接效果

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。

金蝶云星空和聚水潭接口打通对接实战