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