金蝶云星空对接打通微盟物料查询接口与添加在售商品v2接口

对接源平台:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
集成系统:微盟
微盟,香港主板上市企业(股票代码:2013.HK),成立于2013年,致力于为商家打造去中心化的数字化转型SaaS产品及全链路增长服务,助力商家经营可持续增长
数据接口配置方案
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程,将金蝶云星空、微盟之间接口数据联通,支持数据在线预览、数据集成流程全过程调试,Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能,用户通过可视化的拖、拽即可完成数据处理逻辑,将数据加工处理后分发到下游业务系统或其他异构存储中。

金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:物料查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FMATERIALID | 实体主键 | string | |
FNumber | 编码 | string | |
FName | 名称 | string | |
FSpecification | 规格型号 | 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 | |
FMaxPOQty | 最大订货量 | string | |
FMinPOQty | 最小订货量 | string | |
FIncreaseQty | 最小包装量 | string | |
FFixLeadTime | 固定提前期 | 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 | |
F_BCYS_SalePrice | 销售单价 | 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如😛UR_PurchaseOrder |
响应参数
字段 | 名称 | 类型 | 描述 |
FMATERIALID | 实体主键 | string | |
FNumber | 编码 | string | |
FName | 名称 | string | |
FSpecification | 规格型号 | 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 | |
FMaxPOQty | 最大订货量 | string | |
FMinPOQty | 最小订货量 | string | |
FIncreaseQty | 最小包装量 | string | |
FFixLeadTime | 固定提前期 | 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 | |
F_BCYS_SalePrice | 销售单价 | string | |
微盟接口明细
- API:/apigw/weimob_shop/v2.0/goods/create
- NAME:添加在售商品v2
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
basicInfo | 基础信息 | 1 | 基础信息 |
basicInfo.vid | 组织结构节点 ID | 6001341397926 | 组织结构节点 ID。组织的唯一标识,是 创建组织 时自动生成的 ID,也可以通过 bos/organization/getList 接口获取该 ID。 |
basicInfo.categoryId | 商品类目 ID | 28 | 商品类目 ID。可以通过 weimob_shop/goods/category/getList接口获取该 ID。 |
basicInfo.deductStockType | 商品库存减扣方式 | 1 | 商品库存减扣方式。方式包括:1-下单减扣;2-支付减扣。 |
basicInfo.defaultImageUrl | 默认图片 | https://image-c-dev.weimobwmc.com/qa-saas-wxbiz/fddd8d46142346d38742d95d7ac96159.jpeg|默认图片 |
basicInfo.goodsImageUrl | 图片 | https://image-c-dev.weimobwmc.com/qa-saas-wxbiz/fddd8d46142346d38742d95d7ac96159.jpeg | |
basicInfo.goodsTemplateId | 商品模板 ID | 1192643231302 | 商品模板 ID。可以通过 weimob_shop/goods/goodtemplate/getList 接口获取该 ID。 |
basicInfo.goodsType | 商品类型 | 1 | 商品类型。类型包括:1-普通商品;2-虚拟商品。 |
basicInfo.initSales | 初始销量 | | 初始销量 |
basicInfo.isCanSell | 商品是否可售 | false | 商品是否可售。false-禁售;true-可售。 |
basicInfo.isMultiSku | 商品是否多规格 | false | 商品是否多规格。 false-单规格;true-多规格。 |
basicInfo.isOnline | 商品是否上架 | false | 商品是否上架。false-下架;true 上架。 |
basicInfo.limitSwitch | 限购开关 | false | 限购开关。false-关闭; true-开启。 |
basicInfo.outerGoodsCode | 商品编码 | {{FNumber}} | 商品编码 |
basicInfo.performanceWay | 履约方式 | 1 | 履约方式 |
basicInfo.performanceWay.deliveryList | 配送方式 | | 配送方式。配送方式与商品类型关联,普通实物商品:只能设置商家配送、同城限时达、到底自提。 虚拟商品:只能设置无需物流配送方式。 |
basicInfo.performanceWay.deliveryList.deliveryId | 配送方式 ID | 2992582 | 配送方式 ID。可以通过 weimob_shop/fulfill/goods/fulfilltype/getList 接口获取该 ID。 |
basicInfo.performanceWay.deliveryList.deliveryNodeShipId | 配送方式关系节点 ID | 2903807 | 配送方式关系节点 ID。可以通过 weimob_shop/fulfill/goods/fulfilltype/getList 接口获取该 ID。 |
basicInfo.performanceWay.deliveryList.deliveryType | 配送类型 | 1 | 配送类型。类型包括:1-商家配送;2-同城限时达;3-到店自提;4-门店交易;5-无需物流;6-门店自助。 |
basicInfo.performanceWay.deliveryList.templateId | 配送模板 ID | 10000939907 | 配送模板 ID |
basicInfo.performanceWay.skuList | 商品规格 SKU 列表 | | 商品规格 SKU 列表 |
basicInfo.performanceWay.skuList.skuStockNum | SKU 库存数量 | {{FOrderQty}} | SKU 库存数量 |
basicInfo.performanceWay.skuList.outerSkuCode | 商家编码 | {{FNumber}} | 商家编码 |
basicInfo.performanceWay.skuList.salePrice | 销售价 | {{F_BCYS_SalePrice}} | 销售价 |
basicInfo.performanceWay.skuList.subGoodsType | 商品子类型 | 101 | 商品子类型。类型包括:101-普通商品;102-海淘商品;103-无需物流实物商品;201-普通虚拟商品;202-付费卷虚拟商品。 |
basicInfo.performanceWay.skuList.title | 商品名称 | {{FName}} | 商品名称 |
basicInfo.performanceWay.skuList.wid | 商户 ID | 4001049478926 | 商户 ID |
basicInfo.performanceWay.skuList.unifiedCyclePurchaseInfoList | 周期购信息 | | |
basicInfo.performanceWay.skuList.unifiedCyclePurchaseInfoList.cycleStockNum | 可售库存 | {{FOrderQty}} | |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
primaryWriteback | 主键回写 | | |
primaryWriteback.skuId | skuId | {{data.skuList.0.skuId}} | |
primaryWriteback.goodsId | 商品id | {{data.goodsId}} | |
primaryWriteback.outerSkuCode | outerSkuCode | {{data.skuList.0.outerSkuCode}} | |
系统数据集成价值
全面支持数据集成操作可视化、拖拽流式开发,无代码完成多套异构系统集成,降低使用门槛,提升交付速度。特别是在面向金蝶云星空、微盟间API接口集成时,通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理,帮助企业洞察运营状况,进一步优化流程,提高企业商业价值。基于Web图形界面,通过拖拽、连接、配置完成流程设计,数据整合和集成,高效打通业务系统,通过面向运营的统计报表,直观查看API各项指标,实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理,将业务以API的方式对外开放,实现业务创新、能力输出。
