接口配置打通赛意SMOM和金蝶云星空数据对接

源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接系统:赛意SMOM
广州赛意信息科技股份有限公司(简称“赛意信息”),成立于2005年,2017年8月在深圳证券交易所挂牌上市(证券代码:300687),是深交所创业板第666家上市企业。
接口方案配置
通过系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为赛意SMOM,并且选择对应连接器。选择好对应的InfWebApiController.SaveShippingOrders接口作为数据写入动作完成第一步的接口配置。通过该系统数据集成平台的能力,可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成,并且每周都在增加新的应用系统接入。


金蝶云星空接口明细
- API:executeBillQuery
- NAME:销售出库单查询
- METHOD:POST
请求参数
| 接口字段 | 名称 | 预设值 |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber |
| FBillNo | 单据编号 | FBillNo |
| FDate | 日期 | FDate |
| FSaleOrgId_FNumber | 销售组织 | FSaleOrgId.FNumber |
| FCustomerID_FNumber | 客户 | FCustomerID.FNumber |
| FCarriageNO | 运输单号 | FCarriageNO |
| FStockOrgId_FNumber | 发货组织 | FStockOrgId.FNumber |
| FLinkPhone | 联系电话 | FLinkPhone |
| FLinkMan | 收货人姓名 | FLinkMan |
| FReceiveAddress | 收货方地址 | FReceiveAddress |
| FSettleTypeID_FNumber | 结算方式 | FSettleTypeID.FNumber |
| FReceiverAddress | 收货人地址 | FReceiverAddress |
| FReceiverMobile | 收货人手机 | FReceiverMobile |
| FReceiverCountry | 收货人国家 | FReceiverCountry |
| FReceiverState | 收货人省份 | FReceiverState |
| FReceiverCity | 收货人城市 | FReceiverCity |
| FReceiverDistrict | 收货人地区 | FReceiverDistrict |
| FReceiverPhone | 收货人电话 | FReceiverPhone |
| FSHOPNUMBER | 网店编码 | FSHOPNUMBER |
| FSALECHANNEL | 销售渠道 | FSALECHANNEL |
| FVIPCODE | 会员编码 | FVIPCODE |
| FCustMatID_FNumber | 客户物料编码 | FCustMatID.FNumber |
| FMaterialID_FNumber | 物料编码 | FMaterialID.FNumber |
| FBarcode | 零售条形码 | FBarcode |
| FMustQty | 应发数量 | FMustQty |
| FRealQty | 实发数量 | FRealQty |
| FPrice | 单价 | FPrice |
| FTaxPrice | 含税单价 | FTaxPrice |
| FIsFree | 是否赠品 | FIsFree |
| FLot | 批号 | FLot |
| FProduceDate | 生产日期 | FProduceDate |
| FExpiryDate | 有效期至 | FExpiryDate |
| FEntryTaxRate | 税率% | FEntryTaxRate |
| FEntryTaxAmount | 税额 | FEntryTaxAmount |
| FAmount | 金额 | FAmount |
| FAllAmount | 价税合计 | FAllAmount |
| FStockID_FNumber | 仓库 | FStockID.FNumber |
| FStockStatusID_FNumber | 库存状态 | FStockStatusID.FNumber |
| FMtoNo | 计划跟踪号 | FMtoNo |
| FEntrynote | 备注 | FEntrynote |
| FSrcType | 源单类型 | FSrcType |
| FSrcBillNo | 源单编号 | FSrcBillNo |
| FSoorDerno | 订单单号 | FSoorDerno |
| FDiscountRate | 折扣率% | FDiscountRate |
| FDiscount | 折扣额 | FDiscount |
| FPriceDiscount | 单价折扣 | FPriceDiscount |
| FSOEntryId | 销售订单EntryId | FSOEntryId |
| FB2CORDERDETAILID | B2C订单明细Id | FB2CORDERDETAILID |
| FThirdEntryId | 管易订单单号 | FThirdEntryId |
| FETHIRDBILLID | 第三方单据ID | FETHIRDBILLID |
| FETHIRDBILLNO | 第三方单据编号 | FETHIRDBILLNO |
| FGYFINDate | 管易到账时间 | FGYFINDate |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | SAL_OUTSTOCK |
响应参数
| 接口字段 | 名称 | 预设值 |
| FBillTypeID_FNumber | 单据类型 | |
| FBillNo | 单据编号 | |
| FDate | 日期 | |
| FSaleOrgId_FNumber | 销售组织 | |
| FCustomerID_FNumber | 客户 | |
| FBranchId_FNumber | 销售门店 | |
| FSaleDeptID_FNumber | 销售部门 | |
| FHeadLocationId_FNumber | 交货地点 | |
| FCorrespondOrgId_FNumber | 对应组织 | |
| FCarrierID_FNumber | 承运商 | |
| FCarriageNO | 运输单号 | |
| FSalesGroupID_FNumber | 销售组 | |
| FSalesManID_FNumber | 销售员 | |
| FThirdBillNo | 第三方单据编号 | |
| FStockOrgId_FNumber | 发货组织 | |
| FDeliveryDeptID_FNumber | 发货部门 | |
| FThirdBillId | 第三方单据平台单号 | |
| FLinkPhone | 联系电话 | |
| FLinkMan | 收货人姓名 | |
| FThirdSrcType | 第三方系统来源 | |
| FStockerID_FNumber | 仓管员 | |
| FBussinessType | 业务类型 | |
| FDocumentStatus | 单据状态 | |
| FNote | 备注 | |
| FReceiverID_FNumber | 收货方 | |
| FReceiveAddress | 收货方地址 | |
| FSettleID_FNumber | 结算方 | |
| FReceiverContactID_FNumber | 收货方联系人 | |
| FPayerID_FNumber | 付款方 | |
| FSettleOrgID_FNumber | 结算组织 | |
| FSettleTypeID_FNumber | 结算方式 | |
| FReceiptConditionID_FNumber | 收款条件 | |
| FOwnerIdHead_FNumber | 货主 | |
| FBuyerNick | 会员名称 | |
| FReceiverAddress | 收货人地址 | |
| FReceiverName | 收货人 | |
| FReceiverMobile | 收货人手机 | |
| FReceiverCountry | 收货人国家 | |
| FReceiverState | 收货人省份 | |
| FReceiverCity | 收货人城市 | |
| FReceiverDistrict | 收货人地区 | |
| FReceiverPhone | 收货人电话 | |
| FSHOPNUMBER | 网店编码 | |
| FSALECHANNEL | 销售渠道 | |
| FVIPCODE | 会员编码 | |
| FCustMatID_FNumber | 客户物料编码 | |
| FMaterialID_FNumber | 物料编码 | |
| FBarcode | 零售条形码 | |
| FMustQty | 应发数量 | |
| FRealQty | 实发数量 | |
| FPrice | 单价 | |
| FTaxPrice | 含税单价 | |
| FIsFree | 是否赠品 | |
| FLot | 批号 | |
| FProduceDate | 生产日期 | |
| FExpiryDate | 有效期至 | |
| FEntryTaxRate | 税率% | |
| FEntryTaxAmount | 税额 | |
| FAmount | 金额 | |
| FAllAmount | 价税合计 | |
| FStockID_FNumber | 仓库 | |
| FStockStatusID_FNumber | 库存状态 | |
| FMtoNo | 计划跟踪号 | |
| FEntrynote | 备注 | |
| FSrcType | 源单类型 | |
| FSrcBillNo | 源单编号 | |
| FSoorDerno | 订单单号 | |
| FDiscountRate | 折扣率% | |
| FDiscount | 折扣额 | |
| FPriceDiscount | 单价折扣 | |
| FSOEntryId | 销售订单EntryId | |
| FB2CORDERDETAILID | B2C订单明细Id | |
| FThirdEntryId | 管易订单单号 | |
| FETHIRDBILLID | 第三方单据ID | |
| FETHIRDBILLNO | 第三方单据编号 | |
| FGYFINDate | 管易到账时间 | |
| FReceiverName | 收货人 | |
赛意SMOM接口明细
- 调用接口:SmomWebApiController.SaveShippingOrders
- 接口名称:保存发运单数据
- 方法:POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
| No | 编码 | string | {{FBillNo}} |
| ErpId | ErpId | string | |
| OrderType | 订单类型 | string | 73 |
| ShippingWareHouseCode | 发货仓库代码 | string | {{details.FStockID_Fnumber}} |
| DeliveryDate | 发货日期 | datetime | {{FDate}} |
| ShippingDate | 装运日期 | datetime | 0001-01-01T00:00:00+08:00 |
| 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 | 详情 | array | details |
| DetailList.ShippingOrderNo | 发货订单号 | string | {{FBillNo}} |
| DetailList.LineNo | 行号 | string | {{details.FEntity_FEntryID}} |
| DetailList.ItemCode | 物料编码 | string | {{details.FMaterialID_Fnumber}} |
| DetailList.ExpectQty | 预计数量 | string | {{FQty}} |
| DetailList.ErpId | ErpId | string | |
| DetailList.OrderNo | 订单编码 | string | |
| DetailList.InvoiceNo | 发票代码 | string | |
| DetailList.PoNo | 订单号 | string | |
| DetailList.PoDetailLineNo | 采购订单明细行编号 | string | {{details.FEntity_FEntryID}} |
| DetailList.AppointStorageLocationCode | 指定存储位置代码 | string | |
| DetailList.AppointLotCode | AppointLotCode | string | |
| DetailList.OrderState | 订单状态 | string | |
| DetailList.Volume | 体积 | string | |
| DetailList.Weight | 重量 | string | |
| DetailList.Amount | 金额 | string | |
| DetailList.ErpKey | ErpKey | string | |
| DetailList.Code | 编码 | string | |
| DetailList.Name | 名称 | string | |
| DetailList.Infkey | Infkey | string | |
| DetailList.IsDelete | 是否删除 | string | false |
| DetailList.LastUpdateDate | 上次更新日期 | datetime | 0001-01-01T00:00:00+08:00 |
| DetailList.WarehouseCode | 发货仓库编码 | string | {{details.FStockID_Fnumber}} |
| DetailList.Thatokid | 明细id | string | {{details.FEntity_FEntryID}} |
| DetailList.AppointLpn | AppointLpn | string | |
| DetailList.ErpKey | ErpKey | string | |
| DetailList.Code | 编码 | string | {{FBillNo}} |
| DetailList.Name | 名称 | string | |
| DetailList.Infkey | Infkey | string | |
| DetailList.IsDelete | 是否删除 | string | false |
| DetailList.LastUpdateDate | 上次更新日期 | datetime | 0001-01-01T00:00:00+08:00 |
| DetailList.TransactionCode | 单据小类 | string | FHTZD01_SYS |
| DetailList.Headid | 表头 | string | {{FID}} |
系统对接概况
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与赛意SMOM之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。


