金蝶云星空和马帮接口打通对接实战

金蝶云星空和马帮接口打通对接实战

源系统:金蝶云星空

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

对接目标平台:马帮

马帮ERP隶属于上海马帮科技有限公司，马帮ERP成立十余年，聚焦服务于各阶段、各领域的跨境电商从业者，为跨境卖家提供订单处理、商品库存管理、采购供应链管理，物流渠道管理、WMS仓储发货等全流程跨境电商解决方案管理软件。国内外团队800多人，跨境业务范围遍布全国20多个城市，已开通海外东南亚本地化服务。我们已经服务超20万家电商卖家，对接电商近100家主流平台、1000多家物流公司、多家跨境主流收款工具

系统对接接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的物料查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为马帮，并且选择对应连接器。选择对应的新增自建仓库接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：物料查询
• METHOD：POST

请求参数

接口字段字段名称预设值描述 FMATERIALID实体主键FMATERIALID FNumber编码FNumber FName名称FName FSpecification规格型号FSpecification 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 FMaxPOQty最大订货量FMaxPOQty FMinPOQty最小订货量FMinPOQty FIncreaseQty最小包装量FIncreaseQty FFixLeadTime固定提前期FFixLeadTime 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过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and ((FNumber not like '%LT%' and FCategoryID.FNumber='CHLB04_SYS') or (FMaterialGroup.FNumber='FX-') or (FMaterialGroup.FNumber='CX-'))示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdBD_MATERIAL必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FMATERIALID实体主键 FNumber编码 FName名称 FSpecification规格型号 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默认供应商 FMaxPOQty最大订货量 FMinPOQty最小订货量 FIncreaseQty最小包装量 FFixLeadTime固定提前期 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品牌

马帮接口明细

• 接口：stock-do-add-stock
• 接口名称：新增自建仓库
• 接口方法：POST

请求参数

字段名称类型描述 stockSku库存skustring库存sku salesSku主SKUstring主SKU nameCN商品名称，建议中文名称string商品名称，建议中文名称 nameEN备用商品名称，建议英文名称string备用商品名称，建议英文名称 status商品状态：1.自动创建2.待开发3.正常4.清仓5.停止销售string商品状态：1.自动创建2.待开发3.正常4.清仓5.停止销售 picture商品图片string商品图片 length长string长 width宽string宽 height高string高 weight重量string重量 originalSku原厂skustring原厂sku parentCategoryName一级目录名称string一级目录名称 declareEname申报英文名称string申报英文名称 declareName申报中文名称string申报中文名称 declareValue申报价值string申报价值 noLiquidCosmetic0:非液体,2:液体(化妆品),1:非液体(化妆品),3:液体(非化妆品)string0:非液体,2:液体(化妆品),1:非液体(化妆品),3:液体(非化妆品) declareCode报关编码string报关编码 purchasePrice最新采购价string最新采购价 brandName品牌名称string品牌名称 hasBattery带电池1.是2.否string带电池1.是2.否 isTort侵权1.是2.否string侵权1.是2.否 magnetic带磁1.是2.否string带磁1.是2.否 powder粉末1.是2.否string粉末1.是2.否 categoryName二级目录名称string二级目录名称 salePrice售价string售价 defaultCost统一成本价string统一成本价 remark商品备注string商品备注 purchaseRemark采购备注string采购备注 autoCreateSupplier供应商不存在，是否自动创建供应商，默认2不创建string供应商不存在，是否自动创建供应商，默认2不创建 buyerId采购员名称string采购员名称 artDesignerName美工名称string美工名称 developerName开发员名称string开发员名称 salesName销售员名称string销售员名称 creatorName创建员工string创建员工 warehouseData仓库信息json格式字符串array仓库信息json格式字符串 warehouseData.name仓库名称string warehouseData.stockCost仓库成本价string warehouseData.isDefault1:默认仓库2.非默认仓库string warehouseData.purchaseDays采购天数string warehouseData.minPurchaseQuantity最小采购数量string warehouseData.virtualSkus虚拟sku,多个英文分号隔开string虚拟sku,多个英文分号隔开 warehouseData.financial财务编码string财务编码 warehouseData.isGift是否是赠品1是2否string是否是赠品1是2否

数据对接价值

使用全界面可视化配置集成流，快速应对企业的集成需求使得金蝶云星空与马帮之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。