金蝶K3-WISE与黑湖MES对接集成查询销售订单打通导入销售订单
接入系统:金蝶K3-WISE
金蝶K/3WISE是一款面向成长型企业,适应企业在快速成长过程中业务与管理的不断变化的信息化平台,实现云服务、ERP、物联网的融合,帮助企业从信息化建设到构建企业工业互联网与数字化管理平台。
对接目标系统:黑湖MES
黑湖智造以“制造协同”为核心场景,利用实时数据打通工厂内、跨工厂、供应链的业务节点,驱动整体协作效率的提升。过去四年,随着行业场景和客户数量的激增,黑湖智造在“制造协同”的基础上沉淀了大量的用户增值需求,并启动了技术升级计划,在PaaS和SaaS之间构建一层应用级的平台,帮助工业企业深度挖掘数据利用价值和开发延展性应用,打造一个入口级的工业协同平台。
数据接口配置方案
使用轻易云系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:金蝶K3-WISE,然后选择对应的连接器。选择对应的查询销售订单作为数据对接来源。然后再通过写入目标平台配置目标系统为黑湖MES,并且选择对应连接器(关于黑湖MES的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的导入销售订单接口作为数据写入动作,既可以完成第一步的数据对接配置。
金蝶K3-WISE接口明细
- 接口:SO/GetList
- 接口名称:查询销售订单
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| FPrintCount | 打印次数 | string | |
| FCancellation | 作废标志 | string | |
| FClassTypeID | 单据类型 | string | |
| FEnterpriseID | 发送企业 | string | |
| FSendStatus | 发送标志 | string | |
| FStatus | 审核标志 | string | |
| Fdate | 日期 | string | |
| FCustID | 购货单位 | string | |
| FSettleDate | 结算日期 | string | |
| FImport | 引入标志 | string | |
| FAreaPS | 销售范围 | string | |
| FSettleID | 结算方式 | string | |
| FRelateBrID | 订货机构 | string | |
| FPOOrdBillNo | 分销订单号 | string | |
| FSaleStyle | 销售方式 | string | |
| FTransitAheadTime | 运输提前期 | string | |
| FTranType | 事务类型 | string | |
| FBrID | 制单机构 | string | |
| FExchangeRate | 汇率 | string | |
| FFetchStyle | 交货方式 | string | |
| FFetchAdd | 交货地点 | string | |
| FExplanation | 摘要 | string | |
| FCurrencyID | 币 别 | string | |
| FSelBillNo | 选单号 | string | |
| FBillNo | 编 号 | string | |
| FSelTranType | 源单类型 | string | |
| FBrNo | 分支机构代码 | string | |
| FCustAddress | 客户地点: | string | |
| FExchangeRateType | 汇率类型 | string | |
| FPlanCategory | 计划类别 | string | |
| FCheckerID | 审核人 | string | |
| FCheckDate | 审核日期 | string | |
| FDeptID | 部门 | string | |
| FEmpID | 业务员 | string | |
| FMangerID | 主管 | string | |
| FBillerID | 制单 | string | |
| FManageType | 保税监管类型 | string | |
| FValidaterName | 确认人 | string | |
| FSysStatus | 系统设置 | string | |
| FConsignee | 收 货 方 | string | |
| FVersionNo | 版本号 | string | |
| FChangeDate | 变更日期 | string | |
| FChangeUser | 变更人 | string | |
| FChangeCauses | 变更原因 | string | |
| FChangeMark | 变更标志 | string | |
| FATPDeduct | 是否冲减 | string | |
| FEntryID2 | 行号 | string | |
| FOutSourceEntryID | 发送分录 | string | |
| FOutSourceInterID | 发送内码 | string | |
| FOutSourceTranType | 发送类型 | string | |
| FMapNumber | 对应代码 | string | |
| FMapName | 对应名称 | string | |
| FItemID | 产品代码 | string | |
| FItemName | 产品名称 | string | |
| FItemModel | 规格型号 | string | |
| FAuxPropID | 辅助属性 | string | |
| FBaseUnit | 基本单位名称 | string | |
| FQty | 基本单位数量 | string | |
| FUnitID | 单位 | string | |
| Fauxqty | 数量 | string | |
| FSecUnitID | 辅助单位 | string | |
| FSecCoefficient | 换算率 | string | |
| FSecQty | 辅助数量 | string | |
| Fauxprice | 单价 | string | |
| FAuxTaxPrice | 含税单价 | string | |
| Famount | 金额 | string | |
| FCess | 税率(%) | string | |
| FBrNo2 | 分支机构代码 | string | |
| FTaxRate | 折扣率(%) | string | |
| FUniDiscount | 单位折扣额 | string | |
| FTaxAmount | 折扣额 | string | |
| FAuxPriceDiscount | 实际含税单价 | string | |
| FTaxAmt | 销项税额 | string | |
| FAllAmount | 价税合计 | string | |
| FTranLeadTime | 运输提前期 | string | |
| FInForecast | 是否预测内 | string | |
| FDate1 | 交货日期 | string | |
| Fnote | 备注 | string | |
| FCommitQty | 基本单位关联数量 | string | |
| FAuxCommitQty | 关联数量 | string | |
| FSecCommitQty | 辅助单位关联数量 | string | |
| FSecStockQty | 辅助单位出库数量 | string | |
| FStockQty | 基本单位出库数量 | string | |
| FAuxStockQty | 出库数量 | string | |
| FPlanMode | 计划模式 | string | |
| FMTONo | 计划跟踪号 | string | |
| FBomInterID | 客户BOM | string | |
| FCostObjectID | 成本对象 | string | |
| FAdviceConsignDate | 建议交货日期 | string | |
| FLockFlag | 锁库标志 | string | |
| FSourceBillNo | 源单单号 | string | |
| FSourceTranType | 源单类型 | string | |
| FBOMCategory | BOM类别 | string | |
| FSourceInterId | 源单内码 | string | |
| FOrderBOMInterID | 订单BOM内码 | string | |
| FSourceEntryID | 源单分录 | string | |
| FOrderBOMStatus | 订单BOM状态 | string | |
| FContractBillNo | 合同单号 | string | |
| FContractInterID | 合同内码 | string | |
| FContractEntryID | 合同分录 | string | |
| FAuxQtyInvoice | 开票数量 | string | |
| FSecInvoiceQty | 辅助单位开票数量 | string | |
| FQtyInvoice | 基本单位开票数量 | string | |
| FSecCommitInstall | 辅助单位组装数量 | string | |
| FCommitInstall | 基本单位组装数量 | string | |
| FAuxCommitInstall | 组装数量 | string | |
| FAuxPropCls | 辅助属性类别 | string | |
| FAllStdAmount | 价税合计(本位币) | string | |
| FMrpLockFlag | MRP计算标记 | string | |
| FHaveMrp | MRP是否计算标记 | string | |
| FReceiveAmountFor_Commit | 收款关联金额 | string | |
| FOrderBillNo | 客户订单号 | string | |
| FOrderEntryID | 订单行号 | string | |
| Top | 当前记录数 | string | 金蝶的查询分页参数 |
| PageSize | 每页条数 | string | 金蝶的查询分页参数 |
| PageIndex | 开始行索引 | string | 金蝶的查询分页参数 |
| Filter | 过滤条件 | string | 需要先去k3增加自定义字段示例写法 [Fdate]>='{{LAST_SYNC_TIME dateTime}}' |
| Fields | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| SelectPage | SelectPage | string | |
响应参数
| 字段 | 名称 | 类型 | 描述 |
| FPrintCount | 打印次数 | string | |
| FCancellation | 作废标志 | string | |
| FClassTypeID | 单据类型 | string | |
| FEnterpriseID | 发送企业 | string | |
| FSendStatus | 发送标志 | string | |
| FStatus | 审核标志 | string | |
| Fdate | 日期 | string | |
| FCustID | 购货单位 | string | |
| FSettleDate | 结算日期 | string | |
| FImport | 引入标志 | string | |
| FAreaPS | 销售范围 | string | |
| FSettleID | 结算方式 | string | |
| FRelateBrID | 订货机构 | string | |
| FPOOrdBillNo | 分销订单号 | string | |
| FSaleStyle | 销售方式 | string | |
| FTransitAheadTime | 运输提前期 | string | |
| FTranType | 事务类型 | string | |
| FBrID | 制单机构 | string | |
| FExchangeRate | 汇率 | string | |
| FFetchStyle | 交货方式 | string | |
| FFetchAdd | 交货地点 | string | |
| FExplanation | 摘要 | string | |
| FCurrencyID | 币 别 | string | |
| FSelBillNo | 选单号 | string | |
| FBillNo | 编 号 | string | |
| FSelTranType | 源单类型 | string | |
| FBrNo | 分支机构代码 | string | |
| FCustAddress | 客户地点: | string | |
| FExchangeRateType | 汇率类型 | string | |
| FPlanCategory | 计划类别 | string | |
| FCheckerID | 审核人 | string | |
| FCheckDate | 审核日期 | string | |
| FDeptID | 部门 | string | |
| FEmpID | 业务员 | string | |
| FMangerID | 主管 | string | |
| FBillerID | 制单 | string | |
| FManageType | 保税监管类型 | string | |
| FValidaterName | 确认人 | string | |
| FSysStatus | 系统设置 | string | |
| FConsignee | 收 货 方 | string | |
| FVersionNo | 版本号 | string | |
| FChangeDate | 变更日期 | string | |
| FChangeUser | 变更人 | string | |
| FChangeCauses | 变更原因 | string | |
| FChangeMark | 变更标志 | string | |
| FATPDeduct | 是否冲减 | string | |
| FEntryID2 | 行号 | string | |
| FOutSourceEntryID | 发送分录 | string | |
| FOutSourceInterID | 发送内码 | string | |
| FOutSourceTranType | 发送类型 | string | |
| FMapNumber | 对应代码 | string | |
| FMapName | 对应名称 | string | |
| FItemID | 产品代码 | string | |
| FItemName | 产品名称 | string | |
| FItemModel | 规格型号 | string | |
| FAuxPropID | 辅助属性 | string | |
| FBaseUnit | 基本单位名称 | string | |
| FQty | 基本单位数量 | string | |
| FUnitID | 单位 | string | |
| Fauxqty | 数量 | string | |
| FSecUnitID | 辅助单位 | string | |
| FSecCoefficient | 换算率 | string | |
| FSecQty | 辅助数量 | string | |
| Fauxprice | 单价 | string | |
| FAuxTaxPrice | 含税单价 | string | |
| Famount | 金额 | string | |
| FCess | 税率(%) | string | |
| FBrNo2 | 分支机构代码 | string | |
| FTaxRate | 折扣率(%) | string | |
| FUniDiscount | 单位折扣额 | string | |
| FTaxAmount | 折扣额 | string | |
| FAuxPriceDiscount | 实际含税单价 | string | |
| FTaxAmt | 销项税额 | string | |
| FAllAmount | 价税合计 | string | |
| FTranLeadTime | 运输提前期 | string | |
| FInForecast | 是否预测内 | string | |
| FDate1 | 交货日期 | string | |
| Fnote | 备注 | string | |
| FCommitQty | 基本单位关联数量 | string | |
| FAuxCommitQty | 关联数量 | string | |
| FSecCommitQty | 辅助单位关联数量 | string | |
| FSecStockQty | 辅助单位出库数量 | string | |
| FStockQty | 基本单位出库数量 | string | |
| FAuxStockQty | 出库数量 | string | |
| FPlanMode | 计划模式 | string | |
| FMTONo | 计划跟踪号 | string | |
| FBomInterID | 客户BOM | string | |
| FCostObjectID | 成本对象 | string | |
| FAdviceConsignDate | 建议交货日期 | string | |
| FLockFlag | 锁库标志 | string | |
| FSourceBillNo | 源单单号 | string | |
| FSourceTranType | 源单类型 | string | |
| FBOMCategory | BOM类别 | string | |
| FSourceInterId | 源单内码 | string | |
| FOrderBOMInterID | 订单BOM内码 | string | |
| FSourceEntryID | 源单分录 | string | |
| FOrderBOMStatus | 订单BOM状态 | string | |
| FContractBillNo | 合同单号 | string | |
| FContractInterID | 合同内码 | string | |
| FContractEntryID | 合同分录 | string | |
| FAuxQtyInvoice | 开票数量 | string | |
| FSecInvoiceQty | 辅助单位开票数量 | string | |
| FQtyInvoice | 基本单位开票数量 | string | |
| FSecCommitInstall | 辅助单位组装数量 | string | |
| FCommitInstall | 基本单位组装数量 | string | |
| FAuxCommitInstall | 组装数量 | string | |
| FAuxPropCls | 辅助属性类别 | string | |
| FAllStdAmount | 价税合计(本位币) | string | |
| FMrpLockFlag | MRP计算标记 | string | |
| FHaveMrp | MRP是否计算标记 | string | |
| FReceiveAmountFor_Commit | 收款关联金额 | string | |
| FOrderBillNo | 客户订单号 | string | |
| FOrderEntryID | 订单行号 | string | |
黑湖MES接口明细
- 接口:openapi/v1/order/purchase_order/import
- 接口名称:导入销售订单
- 接口方法:POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| purchaseOrderCode | 销售订单号 | string | |
| customerName | 客户名称 | string | |
| materialList | 物料行信息 | array | |
| materialList.targetDate | 交货日期 | string | 2021-02-21短日期 |
| materialList.materialCode | 物料代码 | string | |
| materialList.amount | 数量 | string | |
| materialList.unitName | 单位 | string | |
| materialList.remark | 备注 | string | |
| materialList.array | array | string | |
系统数据集成价值
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统,实现流程端到端打通,复用已有的业务系统能力,让集成架构、服务关系更清晰 使用统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。
系统数据对接方案元数据代码