从金蝶云星空到积加ERP通过接口配置打通数据

接通系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标平台:积加ERP
积加成立于2017年,是国内知名的跨境电商数字基础设施服务商,专注于为跨境电商卖家提供全闭环的电商解决方案。目前积加研发人员达200+,拥有多年行业技术、经验积累的团队,总部位于深圳,在长沙、广州、东莞、厦门、杭州、宁波等20多个城市均设有运营中心。自成立以来,积加以“懂行业、懂客户”的产品理念,基于对跨境电商行业底层逻辑的深刻理解,打造出业内更贴合卖家需求的产品,现有积加ERP-X版、积加M版。
配置集成方案
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:金蝶云星空接口:销售出库单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:积加ERP接口:创建其他出库单,通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:积加ERP写入的数据自动产生写入队列,通过运行概况,系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:销售出库单查询
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| FBillTypeID_FNumber | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| FDate | 日期 | string | 日期 |
| FSaleOrgId_FNumber | 销售组织 | string | 组织 |
| FCustomerID_FNumber | 客户 | string | 基础资料 |
| FBranchId_FNumber | 销售门店 | string | 基础资料 |
| FSaleDeptID_FNumber | 销售部门 | string | 基础资料 |
| FHeadLocationId_FNumber | 交货地点 | string | 基础资料 |
| FCorrespondOrgId_FNumber | 对应组织 | string | 组织 |
| FCarrierID_FNumber | 承运商 | string | 基础资料 |
| FCarriageNO | 运输单号 | string | 文本 |
| FSalesGroupID_FNumber | 销售组 | string | 基础资料 |
| FSalesManID_FNumber | 销售员 | string | 基础资料 |
| FThirdBillNo | 第三方单据编号 | string | 文本 |
| FStockOrgId_FNumber | 发货组织 | string | 组织 |
| FDeliveryDeptID_FNumber | 发货部门 | string | 基础资料 |
| FThirdBillId | 第三方单据平台单号 | string | 文本 |
| FLinkPhone | 联系电话 | string | 文本 |
| FLinkMan | 收货人姓名 | string | 文本 |
| FThirdSrcType | 第三方系统来源 | string | 下拉列表 |
| FStockerID_FNumber | 仓管员 | string | 基础资料 |
| FBussinessType | 业务类型 | string | 下拉列表 |
| FDocumentStatus | 单据状态 | string | 单据状态 |
| FNote | 备注 | string | 多行文本 |
| FReceiverID_FNumber | 收货方 | string | 基础资料 |
| FReceiveAddress | 收货方地址 | string | 文本 |
| FSettleID_FNumber | 结算方 | string | 基础资料 |
| FReceiverContactID_FNumber | 收货方联系人 | string | 基础资料 |
| FPayerID_FNumber | 付款方 | string | 基础资料 |
| FSettleOrgID_FNumber | 结算组织 | string | 组织 |
| FSettleTypeID_FNumber | 结算方式 | string | 基础资料 |
| FReceiptConditionID_FNumber | 收款条件 | string | 基础资料 |
| FOwnerIdHead_FNumber | 货主 | string | 多类别基础资料 |
| FBuyerNick | 会员名称 | string | 文本 |
| FReceiverAddress | 收货人地址 | string | 文本 |
| FReceiverName | 收货人 | string | 文本 |
| FReceiverMobile | 收货人手机 | string | 文本 |
| FReceiverCountry | 收货人国家 | string | 文本 |
| FReceiverState | 收货人省份 | string | 文本 |
| FReceiverCity | 收货人城市 | string | 文本 |
| FReceiverDistrict | 收货人地区 | string | 文本 |
| FReceiverPhone | 收货人电话 | string | 文本 |
| FSHOPNUMBER | 网店编码 | string | 文本 |
| FSALECHANNEL | 销售渠道 | string | 文本 |
| FVIPCODE | 会员编码 | string | 文本 |
| FCustMatID_FNumber | 客户物料编码 | string | 基础资料 |
| FMaterialID_FNumber | 物料编码 | string | 基础资料 |
| FBarcode | 零售条形码 | string | 文本 |
| FMustQty | 应发数量 | string | 数量 |
| FRealQty | 实发数量 | string | 数量 |
| FPrice | 单价 | string | 单价 |
| FTaxPrice | 含税单价 | string | 单价 |
| FIsFree | 是否赠品 | string | 复选框 |
| FLot | 批号 | string | 批次 |
| FProduceDate | 生产日期 | string | 日期 |
| FExpiryDate | 有效期至 | string | 日期 |
| FEntryTaxRate | 税率% | string | 小数 |
| FEntryTaxAmount | 税额 | string | 金额 |
| FAmount | 金额 | string | 金额 |
| FAllAmount | 价税合计 | string | 金额 |
| FStockID_FNumber | 仓库 | string | 基础资料 |
| FStockStatusID_FNumber | 库存状态 | string | 基础资料 |
| FMtoNo | 计划跟踪号 | string | 文本 |
| FEntrynote | 备注 | string | 文本 |
| FSrcType | 源单类型 | string | 源单类型 |
| FSrcBillNo | 源单编号 | string | 源单编号 |
| FSoorDerno | 订单单号 | string | 文本 |
| FDiscountRate | 折扣率% | string | 小数 |
| FDiscount | 折扣额 | string | 折扣额 |
| FPriceDiscount | 单价折扣 | string | 单价 |
| FSOEntryId | 销售订单EntryId | string | 整数 |
| FB2CORDERDETAILID | B2C订单明细Id | string | 整数 |
| FThirdEntryId | 管易订单单号 | string | 文本 |
| FETHIRDBILLID | 第三方单据ID | string | 文本 |
| FETHIRDBILLNO | 第三方单据编号 | string | 文本 |
| FGYFINDate | 管易到账时间 | 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 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| FBillTypeID_FNumber | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| FDate | 日期 | string | 日期 |
| FSaleOrgId_FNumber | 销售组织 | string | 组织 |
| FCustomerID_FNumber | 客户 | string | 基础资料 |
| FBranchId_FNumber | 销售门店 | string | 基础资料 |
| FSaleDeptID_FNumber | 销售部门 | string | 基础资料 |
| FHeadLocationId_FNumber | 交货地点 | string | 基础资料 |
| FCorrespondOrgId_FNumber | 对应组织 | string | 组织 |
| FCarrierID_FNumber | 承运商 | string | 基础资料 |
| FCarriageNO | 运输单号 | string | 文本 |
| FSalesGroupID_FNumber | 销售组 | string | 基础资料 |
| FSalesManID_FNumber | 销售员 | string | 基础资料 |
| FThirdBillNo | 第三方单据编号 | string | 文本 |
| FStockOrgId_FNumber | 发货组织 | string | 组织 |
| FDeliveryDeptID_FNumber | 发货部门 | string | 基础资料 |
| FThirdBillId | 第三方单据平台单号 | string | 文本 |
| FLinkPhone | 联系电话 | string | 文本 |
| FLinkMan | 收货人姓名 | string | 文本 |
| FThirdSrcType | 第三方系统来源 | string | 下拉列表 |
| FStockerID_FNumber | 仓管员 | string | 基础资料 |
| FBussinessType | 业务类型 | string | 下拉列表 |
| FDocumentStatus | 单据状态 | string | 单据状态 |
| FNote | 备注 | string | 多行文本 |
| FReceiverID_FNumber | 收货方 | string | 基础资料 |
| FReceiveAddress | 收货方地址 | string | 文本 |
| FSettleID_FNumber | 结算方 | string | 基础资料 |
| FReceiverContactID_FNumber | 收货方联系人 | string | 基础资料 |
| FPayerID_FNumber | 付款方 | string | 基础资料 |
| FSettleOrgID_FNumber | 结算组织 | string | 组织 |
| FSettleTypeID_FNumber | 结算方式 | string | 基础资料 |
| FReceiptConditionID_FNumber | 收款条件 | string | 基础资料 |
| FOwnerIdHead_FNumber | 货主 | string | 多类别基础资料 |
| FBuyerNick | 会员名称 | string | 文本 |
| FReceiverAddress | 收货人地址 | string | 文本 |
| FReceiverName | 收货人 | string | 文本 |
| FReceiverMobile | 收货人手机 | string | 文本 |
| FReceiverCountry | 收货人国家 | string | 文本 |
| FReceiverState | 收货人省份 | string | 文本 |
| FReceiverCity | 收货人城市 | string | 文本 |
| FReceiverDistrict | 收货人地区 | string | 文本 |
| FReceiverPhone | 收货人电话 | string | 文本 |
| FSHOPNUMBER | 网店编码 | string | 文本 |
| FSALECHANNEL | 销售渠道 | string | 文本 |
| FVIPCODE | 会员编码 | string | 文本 |
| FCustMatID_FNumber | 客户物料编码 | string | 基础资料 |
| FMaterialID_FNumber | 物料编码 | string | 基础资料 |
| FBarcode | 零售条形码 | string | 文本 |
| FMustQty | 应发数量 | string | 数量 |
| FRealQty | 实发数量 | string | 数量 |
| FPrice | 单价 | string | 单价 |
| FTaxPrice | 含税单价 | string | 单价 |
| FIsFree | 是否赠品 | string | 复选框 |
| FLot | 批号 | string | 批次 |
| FProduceDate | 生产日期 | string | 日期 |
| FExpiryDate | 有效期至 | string | 日期 |
| FEntryTaxRate | 税率% | string | 小数 |
| FEntryTaxAmount | 税额 | string | 金额 |
| FAmount | 金额 | string | 金额 |
| FAllAmount | 价税合计 | string | 金额 |
| FStockID_FNumber | 仓库 | string | 基础资料 |
| FStockStatusID_FNumber | 库存状态 | string | 基础资料 |
| FMtoNo | 计划跟踪号 | string | 文本 |
| FEntrynote | 备注 | string | 文本 |
| FSrcType | 源单类型 | string | 源单类型 |
| FSrcBillNo | 源单编号 | string | 源单编号 |
| FSoorDerno | 订单单号 | string | 文本 |
| FDiscountRate | 折扣率% | string | 小数 |
| FDiscount | 折扣额 | string | 折扣额 |
| FPriceDiscount | 单价折扣 | string | 单价 |
| FSOEntryId | 销售订单EntryId | string | 整数 |
| FB2CORDERDETAILID | B2C订单明细Id | string | 整数 |
| FThirdEntryId | 管易订单单号 | string | 文本 |
| FETHIRDBILLID | 第三方单据ID | string | 文本 |
| FETHIRDBILLNO | 第三方单据编号 | string | 文本 |
| FGYFINDate | 管易到账时间 | string | 长日期 |
积加ERP接口明细
- 调用接口:api/v2/warehouse/inbound/otherOut
- 接口名称:创建其他出库单
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| items | 详情 | array | |
| items.ableBadQuantity | 库存次品量 | string | |
| items.ableQuantity | 库存良品可用量 | string | |
| items.badQuantity | 不良品量 | string | |
| items.imageUrl | 图片URL | string | |
| items.locationId | 库位 | string | |
| items.memo | 备注 | string | |
| items.quantity | 数量 | string | |
| items.sku | SKU | string | |
| items.skuName | 产品名称 | string | |
| items.opType | 操作类型 | string | |
| items.子操作类型 | stockCountType | string | |
| items.type | 类型 | string | |
| items.warehouseId | 仓库id | string | |
系统打通概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
