金蝶云星空和赛意SMOM接口打通对接实战

数据源系统:金蝶云星空

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

目标系统:赛意SMOM

广州赛意信息科技股份有限公司（简称“赛意信息”），成立于2005年，2017年8月在深圳证券交易所挂牌上市（证券代码：300687），是深交所创业板第666家上市企业。

多系统对接方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：金蝶云星空的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：赛意SMOM，把获取的数据组装成目标系统需要的格式进行写入。数据管道ETL：构建一体化的数据融合平台。高级数据转换：支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：发货通知单查询
方法：POST

请求参数

字段字段名称类型配置值 FEntity_FEntryIDFEntity_FEntryIDstringFEntity_FEntryID FIDFIDstringFID FORDERNO销售订单号stringFORDERNO FBillNo单据编号stringFBillNo FDate日期stringFDate FCustomerID_Fnumber客户stringFCustomerID.Fnumber FSALEORGID_Fname销售组织stringFSALEORGID.Fname FSALEORGID_Fnumber销售组织编码stringFSALEORGID.Fnumber FMaterialID_Fnumber物料编码stringFMaterialID.Fnumber FMaterialID_Fname物料stringFMaterialID.Fname FQty销售数量stringFQty FTAXPRICE含税单价stringFTAXPRICE FStockID_Fnumber仓库编码stringFStockID.Fnumber FSalesManID销售员stringFSalesManID.FNumber FSalesMan销售员名称stringFSalesManID.FName FReceiverContactID收货联系人stringFReceiverContactID FReceiveAddress收货地址stringFReceiveAddress FLinkPhone收货联系电话stringFLinkPhone FDeliveryOrgID发货组织stringFDeliveryOrgID F_PFNB_KHSONO客户/商城订单号stringF_PFNB_KHSONO F_PFNB_Remarks发货要求stringF_PFNB_Remarks F_PFNB_JHYQ拣货要求stringF_PFNB_JHYQ FSaleDeptID销售部门stringFSaleDeptID FSettleCurrID结算币别stringFSettleCurrID F_PFNB_CheckBox11送货单需签回单stringF_PFNB_CheckBox11 F_PFNB_YPXYCRS样品需要承认书stringF_PFNB_YPXYCRS FCreateDate创建日期stringFCreateDate FCreatorId创建人stringFCreatorId F_PFNB_HTXYH合同协议号stringF_PFNB_HTXYH F_PFNB_CheckBox物料标签stringF_PFNB_CheckBox F_PFNB_CheckBox1盒装标签stringF_PFNB_CheckBox1 F_PFNB_CheckBox2外箱标签stringF_PFNB_CheckBox2 F_PFNB_CheckBox4需登录客户系统打客标stringF_PFNB_CheckBox4 F_PFNB_CheckBox3需提供快递单号stringF_PFNB_CheckBox3 F_PFNB_WMSFHJY启用WMS发货检验stringF_PFNB_WMSFHJY F_PFNB_Combo快递付款方式stringF_PFNB_Combo F_PFNB_SHFS送货方式stringF_PFNB_SHFS F_PFNB_Combo2快递公司stringF_PFNB_Combo2 FStockUnitID库存单位stringFStockUnitID FBillAllAmount价税合计stringFBillAllAmount FPrice单价stringFPrice FCostAmount金额stringFCostAmount FTaxRateId税率stringFTaxRateId FTaxAmount税额stringFTaxAmount FCustMatID客户原厂料号stringFCustMatID FCustMatName客户原厂名称stringFCustMatName F_PFNB_CUSTMODEL2客户原厂规格stringF_PFNB_CUSTMODEL2 F_PFNB_ZDYZ指定印字stringF_PFNB_ZDYZ FMaterialID_FErpClsID物料属性stringFMaterialID.FErpClsID F_PFNB_Combo1年份要求stringF_PFNB_Combo1 F_PFNB_GSLH公司料号stringF_PFNB_GSLH F_PFNB_WLTD物料替代stringF_PFNB_WLTD FJieDanCPNo接单产品料号stringFJieDanCPNo FJieDanCPName接单产品名称stringFJieDanCPName FJieDanCPModel接单产品规格stringFJieDanCPModel FJieDanCPNo_DW接单产品公司料号stringFJieDanCPNo_DW FJieDanCPModel_DW接单产品对外规格stringFJieDanCPModel_DW F_PFNB_KHNMBH客户内码编号stringF_PFNB_KHNMBH F_PFNB_KHCWH客户仓位号stringF_PFNB_KHCWH FPFNB_KCStatus客户合同备注stringFPFNB_KCStatus FBACKUPSTOCKID_Fnumber备货仓库stringFBACKUPSTOCKID.Fnumber Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFDocumentStatus='B' and FModifyDate>='2022-09-29 00:00:00' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSAL_DELIVERYNOTICE

响应参数

字段字段名称类型配置值 FEntity_FEntryIDFEntity_FEntryIDstringFEntity_FEntryID FIDFIDstringFID FORDERNO销售订单号stringFORDERNO FBillNo单据编号stringFBillNo FDate日期stringFDate FCustomerID_Fnumber客户stringFCustomerID.Fnumber FSALEORGID_Fname销售组织stringFSALEORGID.Fname FSALEORGID_Fnumber销售组织编码stringFSALEORGID.Fnumber FMaterialID_Fnumber物料编码stringFMaterialID.Fnumber FMaterialID_Fname物料stringFMaterialID.Fname FQty销售数量stringFQty FTAXPRICE含税单价stringFTAXPRICE FStockID_Fnumber仓库编码stringFStockID.Fnumber FSalesManID销售员stringFSalesManID.FNumber FSalesMan销售员名称stringFSalesManID.FName FReceiverContactID收货联系人stringFReceiverContactID FReceiveAddress收货地址stringFReceiveAddress FLinkPhone收货联系电话stringFLinkPhone FDeliveryOrgID发货组织stringFDeliveryOrgID F_PFNB_KHSONO客户/商城订单号stringF_PFNB_KHSONO F_PFNB_Remarks发货要求stringF_PFNB_Remarks F_PFNB_JHYQ拣货要求stringF_PFNB_JHYQ FSaleDeptID销售部门stringFSaleDeptID FSettleCurrID结算币别stringFSettleCurrID F_PFNB_CheckBox11送货单需签回单stringF_PFNB_CheckBox11 F_PFNB_YPXYCRS样品需要承认书stringF_PFNB_YPXYCRS FCreateDate创建日期stringFCreateDate FCreatorId创建人stringFCreatorId F_PFNB_HTXYH合同协议号stringF_PFNB_HTXYH F_PFNB_CheckBox物料标签stringF_PFNB_CheckBox F_PFNB_CheckBox1盒装标签stringF_PFNB_CheckBox1 F_PFNB_CheckBox2外箱标签stringF_PFNB_CheckBox2 F_PFNB_CheckBox4需登录客户系统打客标stringF_PFNB_CheckBox4 F_PFNB_CheckBox3需提供快递单号stringF_PFNB_CheckBox3 F_PFNB_WMSFHJY启用WMS发货检验stringF_PFNB_WMSFHJY F_PFNB_Combo快递付款方式stringF_PFNB_Combo F_PFNB_SHFS送货方式stringF_PFNB_SHFS F_PFNB_Combo2快递公司stringF_PFNB_Combo2 FStockUnitID库存单位stringFStockUnitID FBillAllAmount价税合计stringFBillAllAmount FPrice单价stringFPrice FCostAmount金额stringFCostAmount FTaxRateId税率stringFTaxRateId FTaxAmount税额stringFTaxAmount FCustMatID客户原厂料号stringFCustMatID FCustMatName客户原厂名称stringFCustMatName F_PFNB_CUSTMODEL2客户原厂规格stringF_PFNB_CUSTMODEL2 F_PFNB_ZDYZ指定印字stringF_PFNB_ZDYZ FMaterialID_FErpClsID物料属性stringFMaterialID.FErpClsID F_PFNB_Combo1年份要求stringF_PFNB_Combo1 F_PFNB_GSLH公司料号string F_PFNB_WLTD物料替代string FJieDanCPNo接单产品料号string FJieDanCPName接单产品名称string FJieDanCPNo_DW接单产品公司料号string FJieDanCPModel_DW接单产品对外规格string F_PFNB_KHNMBH客户内码编号string F_PFNB_KHCWH客户仓位号string FPFNB_KCStatus客户合同备注string FJieDanCPModel接单产品规格string FBACKUPSTOCKID_Fnumber备货仓库string

赛意SMOM接口明细

调用接口：SmomWebApiController.SaveShippingOrders
接口名称：保存发运单数据
方法：POST

请求参数

字段字段名称类型配置值 No单据号string{{FBillNo}} ErpIdErpIdstring OrderType单据大类string73 ShippingWareHouseCode发货仓库代码string{{details.FStockID_Fnumber}} DeliveryDate发货日期datetime{{FDate}} ShippingDate装运日期datetime{{FDate}} Contacts收货联系人string ContactNumber收货联系电话string Connecter连接器string Address收货地址string CustomerCode客户编码string{{FCustomerID_Fnumber}} EnterpriseCode企业代码string SupplierCode供应商编码string TransportCompany运输公司string TransportNo运输编码string OrderState订单状态string PriorityType优先级string CancelReason取消原因string Remark备注string DetailList详情arraydetails DetailList.ShippingOrderNo发货订单号string{{FBillNo}} DetailList.LineNo行号string{{details.FEntity_FEntryID}} DetailList.ItemCode物料编码string{{details.FMaterialID_Fnumber}} DetailList.ExpectQty预计数量string{{FQty}} DetailList.ErpIdErpIdstring DetailList.OrderNo订单编码string DetailList.InvoiceNo发票代码string DetailList.PoNo订单号string DetailList.PoDetailLineNo采购订单明细行编号string{{details.FEntity_FEntryID}} DetailList.AppointStorageLocationCode指定存储位置代码string DetailList.AppointLotCodeAppointLotCodestring DetailList.OrderState订单状态string DetailList.Volume体积string DetailList.Weight重量string DetailList.Amount金额string DetailList.ErpKeyErpKeystring DetailList.Code编码string DetailList.Name名称string DetailList.InfkeyInfkeystring DetailList.IsDelete是否删除stringfalse DetailList.LastUpdateDate上次更新日期datetime0001-01-01T00:00:00+08:00 DetailList.WarehouseCode发货仓库编码string{{details.FStockID_Fnumber}} DetailList.Thatokid明细IDstring{{details.FEntity_FEntryID}} DetailList.CustomerOrderNumber客户订单号string DetailList.CustomerOrderLine客户订单行string DetailList.CustomerOri客户原厂编码string DetailList.CustomerOriginalFactoryName客户原厂名称string DetailList.CustomerOriginalModels客户原厂规格型号string DetailList.ThatokIdERP行号string DetailList.SpecifyPrint指定印字string DetailList.SourceDocNo源单单号string DetailList.TotalInclTax价税合计string DetailList.UnitPriceIncludingTax含税单价string DetailList.UnitPrice单价string DetailList.MaterialSubstitution物料替代string{{F_PFNB_WLTD}} DetailList.ItemNoOrderReceivingProduct接单产品料号string{{FJieDanCPNo}} DetailList.NameOrderReceivingProduct接单产品名称string{{FJieDanCPName}} DetailList.ProductSpecificationsForReceivingOrders接单产品规格string{{FJieDanCPModel}} DetailList.ForeignOrdersProductsSpecifications接单产品对外规格string{{FJieDanCPModel_DW}} DetailList.OrderReceivingProductCompany接单产品公司料号string{{FJieDanCPNo_DW}} DetailList.CustomerInternalCodeNo客户内码编号string{{details.F_PFNB_KHNMBH}} DetailList.CustomerPositionNumber客户仓位号string{{details.F_PFNB_KHCWH}} DetailList.CustomerContractRemarks客户合同备注string{{details.FPFNB_KCStatus}} DetailList.ErpKeyErpKeystring DetailList.Code编码string{{FBillNo}} DetailList.Name名称string DetailList.InfkeyInfkeystring DetailList.IsDelete是否删除stringfalse DetailList.LastUpdateDate上次更新日期datetime0001-01-01T00:00:00+08:00 DetailList.TransactionCode单据小类stringFHTZD01_SYS DetailList.Headid表头IDstring{{FID}} DetailList.ShippingCompanyName发货公司名称string DetailList.CustomerOrderNumber客户订单号string DetailList.DeliveryRequirements发货要求string DetailList.PickingRequirements拣货要求string DetailList.Salesman业务员string DetailList.Currency币种string DetailList.NeedToSignBack是否签回单stringfunction case {{F_PFNB_CheckBox11}} when '0' then 'flase' when '1' then 'true' end DetailList.SamplesNeedAcknowledgement样品需要承认书string_function case {{F_PFNB_YPXYCRS}} when '0' then 'flase' when '1' then 'true' end DetailList.OrderMakingTime制单时间string DetailList.SinglePlayer制单人string DetailList.CustomerMallOrderNo客户/商城订单号string DetailList.ContractAgreementNo合同协议号string DetailList.ItemLabe物料标签string{{F_PFNB_CheckBox}} DetailList.BoxLabel盒装标签stringfunction case {{F_PFNB_CheckBox1}} when '0' then 'flase' when '1' then 'true' end DetailList.CartonLabel外箱标签string_function case {{F_PFNB_CheckBox2}} when '0' then 'flase' when '1' then 'true' end DetailList.PlayGuestLoginCustomerSystem需登录客户系统打客标stringfunction case {{F_PFNB_CheckBox4}} when '0' then 'flase' when '1' then 'true' end DetailList.ExpressNumberRequir需提供快递单号string_function case {{F_PFNB_CheckBox3}} when '0' then 'flase' when '1' then 'true' end DetailList.DeliveryNoteToBeSignedBack送货单需签回单stringfunction case {{F_PFNB_CheckBox11}} when '0' then 'flase' when '1' then 'true' end DetailList.EnableWMSDeliveryInspection启用WMS发货检验string_function case {{F_PFNB_WMSFHJY}} when '0' then 'flase' when '1' then 'true' end DetailList.ExpressPaymentMethod快递付款方式string{{F_PFNB_Combo}} DetailList.Express快递string DetailList.DeliveryMethod送货方式string DetailList.TaxRate税率string DetailList.YearRequirement年份要求string{{F_PFNB_Combo1}}

响应参数

字段字段名称类型配置值 primaryWritebackprimaryWritebackobject primaryWriteback.IdIdstring{{Result.SuccessCount}} primaryWriteback.FIDFIDstring{{Result.SuccessCount}} primaryWriteback.WritebackWritebackstring{{Result.SuccessCount}} primaryWriteback.callBackStrategy回写方案object primaryWriteback.callBackStrategy.strategyId方案IDstring917ee9b6-44c4-38b8-92b6-9607354437a0 primaryWriteback.callBackStrategy.FIDFIDstring{{FNote}} primaryWriteback.callBackStrategy.WritebackWritebackstring{{FNote}}

数据对接效果

大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。

金蝶云星空和赛意SMOM接口打通对接实战