赛意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等等系统,都可以通过接口相互集成。
