金蝶云星空和管易云接口打通对接实战
接入系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接目标平台:管易云
金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司,公司于2008年成立,拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务,用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。
多系统对接方案配置
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为管易云,并且选择对应连接器(关于管易云的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的gy.erp.stock.other.in.add接口作为数据写入动作完成第一步的接口配置。
金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:采购入库查询
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| FInStockEntry_FEntryId | id | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 收料组织 | string | |
| FDate | 入库日期 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FOwnerTypeIdHead | 货主类型 | string | |
| FOwnerIdHead_FNumber | 货主 | string | |
| FDemandOrgId_FNumber | 需求组织 | string | |
| FPurchaseOrgId_FNumber | 采购组织 | string | |
| FSupplierId_FNumber | 供应商 | string | |
| FStockerGroupId_FNumber | 库存组 | string | |
| FStockDeptId_FNumber | 收料部门 | string | |
| FCreateDate | 创建日期 | string | |
| FCancelDate | 作废日期 | string | |
| FDeliveryBill | 送货单号 | string | |
| FTakeDeliveryBill | 提货单号 | string | |
| FApproveDate | 审核日期 | string | |
| FCancelStatus | 作废状态 | string | |
| FSupplyId_FNumber | 供货方 | string | |
| FSettleId_FNumber | 结算方 | string | |
| FChargeId_FNumber | 收款方 | string | |
| FBusinessType | 业务类型 | string | |
| FSupplyAddress | 供货方地址 | string | |
| FAPSTATUS | 应付状态 | string | |
| FTransferBizType | 跨组织业务类型 | string | |
| FDisassemblyFlag | 拆单新单标识 | string | |
| FConfirmDate | 确认日期 | string | |
| FConfirmStatus | 确认状态 | string | |
| FSplitBillType | 拆单类型 | string | |
| FPayOrgId_FNumber | 付款组织 | string | |
| FSettleOrgId_FNumber | 结算组织 | string | |
| FSettleCurrId_FNumber | 结算币别 | string | |
| FBillCost | 整单费用 | string | |
| FBillTaxAmount | 税额 | string | |
| FBillCostAmount | 总成本 | string | |
| FBillAllAmount | 价税合计 | string | |
| FSettleTypeId | 结算方式 | string | |
| FExchangeRate | 汇率 | string | |
| FLocalCurrId_FNumber | 本位币 | string | |
| FBillAmount | 金额 | string | |
| FIsIncludedTax | 含税 | string | |
| FOwnerCustomerID_FNumber | 货主客户 | string | |
| FSettleSupplierID_FNumber | 结算组织供应商 | string | |
| FISGENFORIOS | 跨组织结算生成 | string | |
| FISPRICEEXCLUDETAX | 价外税 | string | |
| FISINVOICEARLIER | 先到票后入库 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FStockId_FNumber | 仓库 | string | |
| FProduceDate | 生产日期 | string | |
| FNote | 备注 | string | |
| FSupplierLot | 供应商批号 | string | |
| FGrossWeight | 毛重 | string | |
| FNetWeight | 净重 | string | |
| FContractlNo | 合同单号 | string | |
| FReqTraceNo | 需求跟踪号 | string | |
| FMustQty | 应收数量 | string | |
| FRealQty | 实收数量 | string | |
| FSRCRowId | 源单行内码 | string | |
| FExpiryDate | 有效期至 | string | |
| FIsFree | 免费 | string | |
| FStockStatusId | 库存状态 | string | |
| FBOMId | BOM版本 | string | |
| FTaxPrice | 含税单价 | string | |
| FCostPrice | 成本价 | string | |
| FEntryTaxRate | 税率(%) | string | |
| FEntryTaxAmount | 税额 | string | |
| FDiscountRate | 折扣率(%) | string | |
| FPriceCoefficient | 价格系数 | string | |
| FPriceUnitQty | 计价数量 | string | |
| FTaxNetPrice | 净价 | string | |
| FEntryCostAmount | 总成本 | string | |
| FAllAmount | 价税合计 | string | |
| FStockFlag | 入库库存更新标志 | string | |
| FPOOrderNo | 订单单号 | string | |
| FEXPUnit | 保质期单位 | string | |
| FExpPeriod | 保质期 | string | |
| FSRCBILLTYPEID | 源单类型 | string | |
| FSRCBillNo | 源单编号 | string | |
| FINVOICEDQTY | 已开票数量 | string | |
| FBaseAPJoinQty | 关联应付数量(计价基本) | string | |
| FReceiveStockFlag | 收货库存更新标志 | string | |
| FProcessFee | 加工费 | string | |
| FMaterialCosts | 材料成本 | string | |
| FLOT_FNumber | 批号 | string | |
| FPrice | 单价 | string | |
| FAmount | 金额 | string | |
| FDiscount | 折扣额 | string | |
| FReturnJoinQty | 退料关联数量 | string | |
| FBFLowId | 业务流程 | string | |
| FGiveAway | 是否赠品 | string | |
| FWWInType | 入库类型 | string | |
| FRowId | 行标识 | string | |
| FLOT_FInStockDate | 批号入库日期 | 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 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| FInStockEntry_FEntryId | id | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDocumentStatus | 单据状态 | string | |
| FStockOrgId_FNumber | 收料组织 | string | |
| FDate | 入库日期 | string | |
| FBillTypeID_FNumber | 单据类型 | string | |
| FOwnerTypeIdHead | 货主类型 | string | |
| FOwnerIdHead_FNumber | 货主 | string | |
| FDemandOrgId_FNumber | 需求组织 | string | |
| FPurchaseOrgId_FNumber | 采购组织 | string | |
| FSupplierId_FNumber | 供应商 | string | |
| FStockerGroupId_FNumber | 库存组 | string | |
| FStockDeptId_FNumber | 收料部门 | string | |
| FCreateDate | 创建日期 | string | |
| FCancelDate | 作废日期 | string | |
| FDeliveryBill | 送货单号 | string | |
| FTakeDeliveryBill | 提货单号 | string | |
| FApproveDate | 审核日期 | string | |
| FCancelStatus | 作废状态 | string | |
| FSupplyId_FNumber | 供货方 | string | |
| FSettleId_FNumber | 结算方 | string | |
| FChargeId_FNumber | 收款方 | string | |
| FBusinessType | 业务类型 | string | |
| FSupplyAddress | 供货方地址 | string | |
| FAPSTATUS | 应付状态 | string | |
| FTransferBizType | 跨组织业务类型 | string | |
| FDisassemblyFlag | 拆单新单标识 | string | |
| FConfirmDate | 确认日期 | string | |
| FConfirmStatus | 确认状态 | string | |
| FSplitBillType | 拆单类型 | string | |
| FPayOrgId_FNumber | 付款组织 | string | |
| FSettleOrgId_FNumber | 结算组织 | string | |
| FSettleCurrId_FNumber | 结算币别 | string | |
| FBillCost | 整单费用 | string | |
| FBillTaxAmount | 税额 | string | |
| FBillCostAmount | 总成本 | string | |
| FBillAllAmount | 价税合计 | string | |
| FSettleTypeId | 结算方式 | string | |
| FExchangeRate | 汇率 | string | |
| FLocalCurrId_FNumber | 本位币 | string | |
| FBillAmount | 金额 | string | |
| FIsIncludedTax | 含税 | string | |
| FOwnerCustomerID_FNumber | 货主客户 | string | |
| FSettleSupplierID_FNumber | 结算组织供应商 | string | |
| FISGENFORIOS | 跨组织结算生成 | string | |
| FISPRICEEXCLUDETAX | 价外税 | string | |
| FISINVOICEARLIER | 先到票后入库 | string | |
| FMaterialId_FNumber | 物料编码 | string | |
| FStockId_FNumber | 仓库 | string | |
| FProduceDate | 生产日期 | string | |
| FNote | 备注 | string | |
| FSupplierLot | 供应商批号 | string | |
| FGrossWeight | 毛重 | string | |
| FNetWeight | 净重 | string | |
| FContractlNo | 合同单号 | string | |
| FReqTraceNo | 需求跟踪号 | string | |
| FMustQty | 应收数量 | string | |
| FRealQty | 实收数量 | string | |
| FSRCRowId | 源单行内码 | string | |
| FExpiryDate | 有效期至 | string | |
| FIsFree | 免费 | string | |
| FStockStatusId | 库存状态 | string | |
| FBOMId | BOM版本 | string | |
| FTaxPrice | 含税单价 | string | |
| FCostPrice | 成本价 | string | |
| FEntryTaxRate | 税率(%) | string | |
| FEntryTaxAmount | 税额 | string | |
| FDiscountRate | 折扣率(%) | string | |
| FPriceCoefficient | 价格系数 | string | |
| FPriceUnitQty | 计价数量 | string | |
| FTaxNetPrice | 净价 | string | |
| FEntryCostAmount | 总成本 | string | |
| FAllAmount | 价税合计 | string | |
| FStockFlag | 入库库存更新标志 | string | |
| FPOOrderNo | 订单单号 | string | |
| FEXPUnit | 保质期单位 | string | |
| FExpPeriod | 保质期 | string | |
| FSRCBILLTYPEID | 源单类型 | string | |
| FSRCBillNo | 源单编号 | string | |
| FINVOICEDQTY | 已开票数量 | string | |
| FBaseAPJoinQty | 关联应付数量(计价基本) | string | |
| FReceiveStockFlag | 收货库存更新标志 | string | |
| FProcessFee | 加工费 | string | |
| FMaterialCosts | 材料成本 | string | |
| FLOT_FNumber | 批号 | string | |
| FPrice | 单价 | string | |
| FAmount | 金额 | string | |
| FDiscount | 折扣额 | string | |
| FReturnJoinQty | 退料关联数量 | string | |
| FBFLowId | 业务流程 | string | |
| FGiveAway | 是否赠品 | string | |
| FWWInType | 入库类型 | string | |
| FRowId | 行标识 | string | |
| FLOT_FInStockDate | 批号入库日期 | string | |
管易云接口明细
- 接口:gy.erp.stock.other.in.add
- 接口名称:其他入库单新增完结接口
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| warehouse_code | 仓库代码 | string | |
| type | 入库类型代码 | string | |
| note | 备注 | string | |
| details | 入库明细 | array | |
| details.item_code | 商品代码 | string | |
| details.sku_code | 规格代码 | string | |
| details.barcode | 商品条码 | string | |
| details.qty | 数量 | string | |
| details.uniqueCode | 唯一码 | string | |
| details.batchNumber | 批次号 | string | |
| details.manufacturingDate | 生产日期 | string | |
| details.shelfLife | 有效期 | string | |
| details.stockDate | 入库日期 | string | |
| details.wms_bizcode | 第三方系统单号 | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| success | 成功与否 | string | |
| errorCode | 错误代码 | string | |
| subErrorCode | 子错误代码 | string | |
| errorDesc | 错误描述 | string | |
| subErrorDesc | 子错误描述 | string | |
| requestMethod | 请求方法 | string | |
| code | 其他入库单单据编号 | string | |
数据对接价值
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。
系统数据对接方案元数据代码