奇门WMS-A和金蝶云星空单据接口对接
对接系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标平台:奇门WMS-A
奇门WMS是针对菜鸟WMS、天猫国际保税仓、其它WMS系统(如:百世云仓、巨沃WMS、递四方、中仓仓储等第三方仓储WMS系统),进行对接与管理的模块。奇门WMS包含:基本信息配置、商品同步、商品对照、商品区域销售设置、渠道库存管理、库存同步设置、手动同步库存、仓库对照、供应商对照、采购订单、采购退货出库单、发货单列表、退货单列表、调拨单列表、仓内加工单、其他出库单、其他入库单、B2B出库单、接口日志查询、前后端商品映射关系同步
系统对接接口配置
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为奇门WMS-A,并且选择对应连接器(关于奇门WMS-A的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的taobao.qimen.singleitem.synchronize接口作为数据写入动作完成第一步的接口配置。
金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:物料查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FMasterId | id | string | |
FNumber | 编码 | string | |
FName | 名称 | string | |
FSpecification | 规格型号 | string | |
FMnemonicCode | 助记码 | string | |
FOldNumber | 旧物料编码 | string | |
FBARCODE | 条码 | string | |
FDescription | 描述 | string | |
FMaterialGroup_FNumber | 物料分组 | string | |
FErpClsID | 物料属性 | string | |
FDocumentStatus | 数据状态 | string | |
FForbidStatus | 禁用状态 | string | |
FBaseUnitId_FNumber | 基本单位.编码 | string | |
FCreateOrgId_FNumber | 创建组织 | string | |
FUseOrgId_FNumber | 使用组织 | string | |
FIsInventory | 允许库存 | string | |
FIsSale | 允许销售 | string | |
FIsAsset | 允许资产 | string | |
FIsSubContract | 允许委外 | string | |
FIsProduce | 允许生产 | string | |
FIsPurchase | 允许采购 | string | |
FStockId_FNumber | 仓库 | string | |
FPurchaseOrgId_FNumber | 采购组织.编码 | string | |
FPurchaseOrgId_FName | 采购组织 | string | |
FIsBatchManage | 启用批号管理 | string | |
FIsKFPeriod | 启用保质期管理 | string | |
FIsSNManage | 启用序列号管理 | string | |
FSafeStock | 安全库存 | string | |
FCategoryID | 存货类别 | string | |
FExpPeriod | 保质期 | string | |
FOrderQty | 起订量 | string | |
FMinQty | 最小批量 | string | |
FMaxQty | 最大批量 | string | |
FDefaultVendor_FNumber | 默认供应商 | string | |
F_ora_Text | 香型 | string | |
F_ora_Text1 | 执行标准 | string | |
F_ora_Text2 | 生产企业 | string | |
F_ora_Text3 | 箱规 | string | |
FVarLeadTime | 变动提前期 | string | |
FPlanBatchSplitQty | 拆分批量 | string | |
FProduceBillType_FNumber | 生产类型 | string | |
FPOBillTypeId_FNumber | 采购类型 | string | |
FSubBillType_FNumber | 委外类型 | string | |
FGROSSWEIGHT | 毛重 | string | |
FNETWEIGHT | 净重 | string | |
FWEIGHTUNITID_FNumber | 重量单位 | string | |
FLENGTH | 长 | string | |
FWIDTH | 宽 | string | |
FHEIGHT | 高 | string | |
FVOLUME | 体积 | string | |
FWARRANTY | 保修期 | string | |
FSalePrice_CMK | 零售价 | string | |
FVIPPrice_CMK | 会员价 | string | |
FPurPrice_CMK | 采购单价 | string | |
FComBrandId_CMK_FNumber | 品牌 | 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 |
响应参数
字段 | 名称 | 类型 | 描述 |
FMasterId | id | string | |
FNumber | 编码 | string | |
FName | 名称 | string | |
FSpecification | 规格型号 | string | |
FMnemonicCode | 助记码 | string | |
FOldNumber | 旧物料编码 | string | |
FBARCODE | 条码 | string | |
FDescription | 描述 | string | |
FMaterialGroup_FNumber | 物料分组 | string | |
FErpClsID | 物料属性 | string | |
FDocumentStatus | 数据状态 | string | |
FForbidStatus | 禁用状态 | string | |
FBaseUnitId_FNumber | 基本单位.编码 | string | |
FCreateOrgId_FNumber | 创建组织 | string | |
FUseOrgId_FNumber | 使用组织 | string | |
FIsInventory | 允许库存 | string | |
FIsSale | 允许销售 | string | |
FIsAsset | 允许资产 | string | |
FIsSubContract | 允许委外 | string | |
FIsProduce | 允许生产 | string | |
FIsPurchase | 允许采购 | string | |
FStockId_FNumber | 仓库 | string | |
FPurchaseOrgId_FNumber | 采购组织.编码 | string | |
FPurchaseOrgId_FName | 采购组织 | string | |
FIsBatchManage | 启用批号管理 | string | |
FIsKFPeriod | 启用保质期管理 | string | |
FIsSNManage | 启用序列号管理 | string | |
FSafeStock | 安全库存 | string | |
FCategoryID | 存货类别 | string | |
FExpPeriod | 保质期 | string | |
FOrderQty | 起订量 | string | |
FMinQty | 最小批量 | string | |
FMaxQty | 最大批量 | string | |
FDefaultVendor_FNumber | 默认供应商 | string | |
F_ora_Text | 香型 | string | |
F_ora_Text1 | 执行标准 | string | |
F_ora_Text2 | 生产企业 | string | |
F_ora_Text3 | 箱规 | string | |
FVarLeadTime | 变动提前期 | string | |
FPlanBatchSplitQty | 拆分批量 | string | |
FProduceBillType_FNumber | 生产类型 | string | |
FPOBillTypeId_FNumber | 采购类型 | string | |
FSubBillType_FNumber | 委外类型 | string | |
FGROSSWEIGHT | 毛重 | string | |
FNETWEIGHT | 净重 | string | |
FWEIGHTUNITID_FNumber | 重量单位 | string | |
FLENGTH | 长 | string | |
FWIDTH | 宽 | string | |
FHEIGHT | 高 | string | |
FVOLUME | 体积 | string | |
FWARRANTY | 保修期 | string | |
FSalePrice_CMK | 零售价 | string | |
FVIPPrice_CMK | 会员价 | string | |
FPurPrice_CMK | 采购单价 | string | |
FComBrandId_CMK_FNumber | 品牌 | string | |
奇门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层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到奇门WMS-A之间数据集成;通过API连接各业务系统,复用已有的业务系统能力,让集成架构、服务关系更清晰。使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升复用率和价值。全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+,快速对接各种API接口,实现云上云下的互联互通。将SaaS和本地业务系统联接起来,打破时间与空间界限,打通原有核心数据及SaaS应用,构建可平滑演进的企业IT架构。
系统数据对接方案元数据代码