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

对接源平台:赛意SMOM

赛意信息已经发展成为国内企业数字化服务领域最具发展潜力的领军企业之一，聚焦于工业互联网、智能制造、新一代信息技术、数字化转型等领域的技术与商业模式应用，为企业提供高端软件咨询、实施及集成服务，形成面向通讯、电子、家电、家居等23个重点行业和11条业务线的产品和解决方案。

集成系统:金蝶云星空

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

数据集成方案配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：赛意SMOM，然后选择对应的连接器。选择对应的查询发运单数据作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的销售退货新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

赛意SMOM接口明细

• 调用接口：SmomWebApiController.GetAsn
• 接口名称：查询发运单数据
• 方法：POST

请求参数

字段	字段名称	类型	配置值
AsnNo	单据编号	string
StartTime	开始修改时间	string	{{LAST_SYNC_TIME datetime}}
EndTime	结束修改时间	string	{{CURRENT_TIME datetime}}
State	单据头状态	string	10
OrderType	单据大类	string	40
TransactionCode	单据小类	string	THTZD01_SYS
DetailedStartTime	明细修改开始时间	string
DetailedEndTime	明细修改结束时间	string
InspectionResults	质检结果	string	true

响应参数

字段	字段名称	类型	配置值
NO	单据编号	string
ShippingWareHouseCode	仓库	string
EnterpriseCode	部门	string
CustomerCode	客户	string
SupplierCode	供应商	string
Remark	备注	string
Headid	表头ID	string
DetailList	明细信息	array
DetailList.LineNo	行号	string
DetailList.ItemCode	物料	string
DetailList.ExpectQty	数量	string
DetailList.WarehouseCode	仓库	string
DetailList.Thatokid	明细ID	string

金蝶云星空接口明细

• API：batchSave
• NAME：销售退货新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	XSTHD01_SYS	单据类型
FBillNo	单据编号	{{outAsnDatas.No}}	单据编号
FSaleOrgId	销售组织	function left("{{outAsnDatas.No}}",2)	组织
FDate	日期	{{outAsnDatas.DeliveryDate}}	日期
FStockOrgId	库存组织	_function left("{{outAsnDatas.No}}",2)	组织
FRetcustId	退货客户	{{outAsnDatas.CustomerCode}}	基础资料
FSaledeptid	销售部门		基础资料
FSettleCurrId	结算币别		基础资料
FBranchId	销售门店		基础资料
FReturnReason	退货原因		单选辅助资料列表
FCorrespondOrgId	对应组织		组织
FStockDeptId	库存部门		基础资料
FHeadNote	备注		多行文本
FPayCustId	付款方		基础资料
FEntity	明细信息	outAsnDatas.DetailList
FEntity.FMaterialId	物料编码	{{ItemCode}}	基础资料
FEntity.FBarcode	零售条形码		文本
FEntity.FRealQty	实退数量	{{ActualQty}}	数量
FEntity.FPrice	单价		单价
FEntity.FTaxPrice	含税单价		单价
FEntity.FIsFree	是否赠品		复选框
FEntity.FEntryTaxRate	税率%		小数
FEntity.FReturnType	退货类型		单选辅助资料列表
FEntity.FOwnerTypeId	货主类型		多类别基础资料列表
FEntity.FOwnerId	货主	function left("{{outAsnDatas.No}}",2)	多类别基础资料
FEntity.FStockId	仓库	{{WarehouseCode}}	基础资料
FEntity.FStocklocId	仓位		维度关联字段
FEntity.FLot	批号		批次
FEntity.FDeliveryDate	退货日期		长日期
FEntity.FNote	备注		文本
FEntity.FEntity_Link	关联关系表	outAsnDatas.DetailList
FEntity.FEntity_Link.FEntity_Link_FRuleId	转换规则	SalReturnNotice-SalReturnStock
FEntity.FEntity_Link.FEntity_Link_FSTableName	源单表	T_SAL_RETURNNOTICEENTRY
FEntity.FEntity_Link.FEntity_Link_FSBillId	源单内码	_findCollection find FID from 88f85e32-bef8-3bd4-ac5c-15581a851ec3 where FBillNo={{outAsnDatas.No}}
FEntity.FEntity_Link.FEntity_Link_FSId	源单分录内码	findCollection find FEntity_FENTRYID from 88f85e32-bef8-3bd4-ac5c-15581a851ec3 where FBillNo={{outAsnDatas.No}} FMaterialId={{ItemCode}}
FEntity.SubHeadEntity	财务信息
FEntity.SubHeadEntity.FSettleOrgId	结算组织	_function left("{{outAsnDatas.No}}",2)	组织
FEntity.SubHeadEntity.FSettleTypeId	结算方式	10	基础资料
FEntity.SubHeadEntity.FormId	业务对象表单Id	SAL_RETURNSTOCK	必须填写金蝶的表单ID如 UR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	Save
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	true
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	21	默认仓库模块

系统对接概况

使用全界面可视化配置集成流，快速应对企业的集成需求使得赛意SMOM与金蝶云星空之间的数据接口一站式的快速集成能力，构建企业数据通道，解决数据孤岛问题。快速构建企业元数据标准、主数据标准、业财数据标准，完成数据的采集、统一、分发、清洗、归集等，帮助企业建立高质量的数据中台。目前轻易云平台已经支持300+系统，同时具备快速适配新系统的能力，集成海量接口数据。无论是对接ERP还是MES、OA、CRM、WMS、OMS等等系统，都可以通过接口相互集成。