金蝶云星空对接打通奇门WMS-A物料查询接口与商品同步接口接口

对接源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:奇门WMS-A
淘系的相关仓储数据必须要通过奇门和外部数据进行对接例如:基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步
接口方案配置
通过轻易云系统数据集成平台新增创建集成方案,然后在数据源平台中选择对应的源平台为:金蝶云星空,并且选择对应的连接器(关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息)。选择对应的物料查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为奇门WMS-A,并且选择对应连接器。选择对应的商品同步接口接口作为数据写入动作,既可以完成第一步的数据对接配置;打破跨系统连接,让数据轻易互通成为现实。

金蝶云星空接口明细
- API:executeBillQuery
- NAME:物料查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FMasterId | id | FMasterId | |
FNumber | 编码 | FNumber | |
FName | 名称 | FName | |
FSpecification | 规格型号 | FSpecification | |
FMnemonicCode | 助记码 | FMnemonicCode | |
FOldNumber | 旧物料编码 | FOldNumber | |
FBARCODE | 条码 | FBARCODE | |
FDescription | 描述 | FDescription | |
FMaterialGroup_FNumber | 物料分组 | FMaterialGroup.FNumber | |
FErpClsID | 物料属性 | FErpClsID | |
FDocumentStatus | 数据状态 | FDocumentStatus | |
FForbidStatus | 禁用状态 | FForbidStatus | |
FBaseUnitId_FNumber | 基本单位.编码 | FBaseUnitId.FNumber | |
FCreateOrgId_FNumber | 创建组织 | FCreateOrgId.FNumber | |
FUseOrgId_FNumber | 使用组织 | FUseOrgId.FNumber | |
FIsInventory | 允许库存 | FIsInventory | |
FIsSale | 允许销售 | FIsSale | |
FIsAsset | 允许资产 | FIsAsset | |
FIsSubContract | 允许委外 | FIsSubContract | |
FIsProduce | 允许生产 | FIsProduce | |
FIsPurchase | 允许采购 | FIsPurchase | |
FStockId_FNumber | 仓库 | FStockId.FNumber | |
FPurchaseOrgId_FNumber | 采购组织.编码 | FPurchaseOrgId.FNumber | |
FPurchaseOrgId_FName | 采购组织 | FPurchaseOrgId.FName | |
FIsBatchManage | 启用批号管理 | FIsBatchManage | |
FIsKFPeriod | 启用保质期管理 | FIsKFPeriod | |
FIsSNManage | 启用序列号管理 | FIsSNManage | |
FSafeStock | 安全库存 | FSafeStock | |
FCategoryID | 存货类别 | FCategoryID | |
FExpPeriod | 保质期 | FExpPeriod | |
FOrderQty | 起订量 | FOrderQty | |
FMinQty | 最小批量 | FMinQty | |
FMaxQty | 最大批量 | FMaxQty | |
FDefaultVendor_FNumber | 默认供应商 | FDefaultVendor.FNumber | |
F_ora_Text | 香型 | F_ora_Text | |
F_ora_Text1 | 执行标准 | F_ora_Text1 | |
F_ora_Text2 | 生产企业 | F_ora_Text2 | |
F_ora_Text3 | 箱规 | F_ora_Text3 | |
FVarLeadTime | 变动提前期 | FVarLeadTime | |
FPlanBatchSplitQty | 拆分批量 | FPlanBatchSplitQty | |
FProduceBillType_FNumber | 生产类型 | FProduceBillType.FNumber | |
FPOBillTypeId_FNumber | 采购类型 | FPOBillTypeId.FNumber | |
FSubBillType_FNumber | 委外类型 | FSubBillType.FNumber | |
FGROSSWEIGHT | 毛重 | FGROSSWEIGHT | |
FNETWEIGHT | 净重 | FNETWEIGHT | |
FWEIGHTUNITID_FNumber | 重量单位 | FWEIGHTUNITID.FNumber | |
FLENGTH | 长 | FLENGTH | |
FWIDTH | 宽 | FWIDTH | |
FHEIGHT | 高 | FHEIGHT | |
FVOLUME | 体积 | FVOLUME | |
FWARRANTY | 保修期 | FWARRANTY | |
FSalePrice_CMK | 零售价 | FSalePrice_CMK | |
FVIPPrice_CMK | 会员价 | FVIPPrice_CMK | |
FPurPrice_CMK | 采购单价 | FPurPrice_CMK | |
FComBrandId_CMK_FNumber | 品牌 | FComBrandId_CMK.FNumber | |
Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
FilterString | 过滤条件 | FDOCUMENTSTATUS='C' and FUseOrgId.fnumber='100' and FApproveDate>='{{LAST_SYNC_TIME datetime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
FormId | 业务对象表单Id | BD_MATERIAL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
FMasterId | id | | |
FNumber | 编码 | | |
FName | 名称 | | |
FSpecification | 规格型号 | | |
FMnemonicCode | 助记码 | | |
FOldNumber | 旧物料编码 | | |
FBARCODE | 条码 | | |
FDescription | 描述 | | |
FMaterialGroup_FNumber | 物料分组 | | |
FErpClsID | 物料属性 | | |
FDocumentStatus | 数据状态 | | |
FForbidStatus | 禁用状态 | | |
FBaseUnitId_FNumber | 基本单位.编码 | | |
FCreateOrgId_FNumber | 创建组织 | | |
FUseOrgId_FNumber | 使用组织 | | |
FIsInventory | 允许库存 | | |
FIsSale | 允许销售 | | |
FIsAsset | 允许资产 | | |
FIsSubContract | 允许委外 | | |
FIsProduce | 允许生产 | | |
FIsPurchase | 允许采购 | | |
FStockId_FNumber | 仓库 | | |
FPurchaseOrgId_FNumber | 采购组织.编码 | | |
FPurchaseOrgId_FName | 采购组织 | | |
FIsBatchManage | 启用批号管理 | | |
FIsKFPeriod | 启用保质期管理 | | |
FIsSNManage | 启用序列号管理 | | |
FSafeStock | 安全库存 | | |
FCategoryID | 存货类别 | | |
FExpPeriod | 保质期 | | |
FOrderQty | 起订量 | | |
FMinQty | 最小批量 | | |
FMaxQty | 最大批量 | | |
FDefaultVendor_FNumber | 默认供应商 | | |
F_ora_Text | 香型 | | |
F_ora_Text1 | 执行标准 | | |
F_ora_Text2 | 生产企业 | | |
F_ora_Text3 | 箱规 | | |
FVarLeadTime | 变动提前期 | | |
FPlanBatchSplitQty | 拆分批量 | | |
FProduceBillType_FNumber | 生产类型 | | |
FPOBillTypeId_FNumber | 采购类型 | | |
FSubBillType_FNumber | 委外类型 | | |
FGROSSWEIGHT | 毛重 | | |
FNETWEIGHT | 净重 | | |
FWEIGHTUNITID_FNumber | 重量单位 | | |
FLENGTH | 长 | | |
FWIDTH | 宽 | | |
FHEIGHT | 高 | | |
FVOLUME | 体积 | | |
FWARRANTY | 保修期 | | |
FSalePrice_CMK | 零售价 | | |
FVIPPrice_CMK | 会员价 | | |
FPurPrice_CMK | 采购单价 | | |
FComBrandId_CMK_FNumber | 品牌 | | |
奇门WMS-A接口明细
- 接口:singleitem.synchronize
- 接口名称:商品同步接口
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
actionType | 操作类型 | string | 两种类型:add update |
warehouseCode | 仓库编码 | string | 统仓统配等无需ERP指定仓储编码的情况填OTHER |
ownerCode | 货主编码 | string | |
supplierCode | 供应商编码 | string | 该字段是WMS分配的商品编号;WMS如果分配了商品编码;则后续的商品操作都需要传该字段;如果WMS不使用;WMS可 以返回itemId=itemCode的值 |
supplierName | 供应商名称 | string | |
item | 商品信息 | array | |
item.itemCode | 商品编码 | string | |
item.itemId | 仓储系统商品编码 | string | |
item.goodsCode | 货号 | string | |
item.itemName | 商品名称 | string | |
item.shortName | 商品简称 | string | |
item.englishName | 英文名 | string | |
item.barCode | 条形码 | string | 可多个;用分号;隔开 |
item.skuProperty | 商品属性 | string | 如红色;XXL |
item.stockUnit | 商品计量单位 | string | |
item.length | 长 | string | 单位:厘米 |
item.width | 宽 | string | 单位:厘米 |
item.height | 高 | string | 单位:厘米 |
item.volume | 体积 | string | 单位:升 |
item.grossWeight | 毛重 | string | 单位:千克 |
item.netWeight | 净重 | string | 单位:千克 |
item.color | 颜色 | string | |
item.size | 尺寸 | string | |
item.title | 渠道中的商品标题 | string | |
item.categoryId | 商品类别ID | string | |
item.categoryName | 商品类别名称 | string | |
item.pricingCategory | 计价货类 | string | |
item.safetyStock | 安全库存 | string | |
item.itemType | 商品类型 | string | ZC=正常商品;FX=分销商品;ZH=组合商品;ZP=赠品;BC=包材;HC=耗材;FL=辅料;XN=虚拟品;FS=附属品;CC=残次品; OTHER=其它;只传英文编码 |
item.tagPrice | 吊牌价 | string | |
item.retailPrice | 零售价 | string | |
item.costPrice | 成本价 | string | |
item.purchasePrice | 采购价 | string | |
item.seasonCode | 季节编码 | string | |
item.seasonName | 季节名称 | string | |
item.brandCode | 品牌代码 | string | |
item.brandName | 品牌名称 | string | |
item.isSNMgmt | 是否需要串号管理 | string | Y/N ;默认为N |
item.productDate | 生产日期 | string | YYYY-MM-DD |
item.expireDate | 过期日期 | string | YYYY-MM-DD |
item.isShelfLifeMgmt | 是否需要保质期管理 | string | Y/N ;默认为N |
item.shelfLife | 保质期 | string | 单位:小时 |
item.rejectLifecycle | 保质期禁收天数 | string | |
item.lockupLifecycle | 保质期禁售天数 | string | |
item.adventLifecycle | 保质期临期预警天数 | string | |
item.isBatchMgmt | 是否需要批次管理 | string | Y/N ;默认为N |
item.batchCode | 批次代码 | string | |
item.batchRemark | 批次备注 | string | |
item.packCode | 包装代码 | string | |
item.pcs | 箱规 | string | |
item.originAddress | 商品的原产地 | string | |
item.approvalNumber | 批准文号 | string | |
item.isFragile | 是否易碎品 | string | Y/N ;默认为N |
item.isHazardous | 是否危险品 | string | Y/N ;默认为N |
item.remark | 备注 | string | |
item.createTime | 创建时间 | string | YYYY-MM-DD HH:MM:SS |
item.updateTime | 更新时间 | string | YYYY-MM-DD HH:MM:SS |
item.isValid | 是否有效 | string | Y/N ;默认为N |
item.isSku | 是否sku | string | Y/N ;默认为N |
item.packageMaterial | 商品包装材料类型 | string | |
item.supplierCode | temp | string | |
item.logisticsType | 销售配送方式 | string | 0=自配 1=菜鸟 |
item.isLiquid | 是否液体 | string | Y/N, 默认为N |
item.extendProps | 扩展属性 | string | |
系统集成总览
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:奇门WMS-A与金蝶云星空之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。
