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

源系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
写入目标:赛意SMOM
广州赛意信息科技股份有限公司(简称“赛意信息”),成立于2005年,2017年8月在深圳证券交易所挂牌上市(证券代码:300687),是深交所创业板第666家上市企业。
接口方案配置
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为赛意SMOM,并且选择对应连接器(关于赛意SMOM的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的InfWebApiController.SaveShippingOrders接口作为数据写入动作完成第一步的接口配置。

金蝶云星空接口明细
- 接口:executeBillQuery
- 接口名称:销售出库单查询
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
FBillTypeID_FNumber | 单据类型 | string | 单据类型 |
FBillNo | 单据编号 | string | 单据编号 |
FDate | 日期 | string | 日期 |
FSaleOrgId_FNumber | 销售组织 | string | 组织 |
FCustomerID_FNumber | 客户 | string | 基础资料 |
FCarriageNO | 运输单号 | string | 文本 |
FStockOrgId_FNumber | 发货组织 | string | 组织 |
FLinkPhone | 联系电话 | string | 文本 |
FLinkMan | 收货人姓名 | string | 文本 |
FReceiveAddress | 收货方地址 | string | 文本 |
FSettleTypeID_FNumber | 结算方式 | string | 基础资料 |
FReceiverAddress | 收货人地址 | string | 文本 |
FReceiverMobile | 收货人手机 | string | 文本 |
FReceiverCountry | 收货人国家 | string | 文本 |
FReceiverState | 收货人省份 | string | 文本 |
FReceiverCity | 收货人城市 | string | 文本 |
FReceiverDistrict | 收货人地区 | string | 文本 |
FReceiverPhone | 收货人电话 | string | 文本 |
FSHOPNUMBER | 网店编码 | string | 文本 |
FSALECHANNEL | 销售渠道 | string | 文本 |
FVIPCODE | 会员编码 | string | 文本 |
FCustMatID_FNumber | 客户物料编码 | string | 基础资料 |
FMaterialID_FNumber | 物料编码 | string | 基础资料 |
FBarcode | 零售条形码 | string | 文本 |
FMustQty | 应发数量 | string | 数量 |
FRealQty | 实发数量 | string | 数量 |
FPrice | 单价 | string | 单价 |
FTaxPrice | 含税单价 | string | 单价 |
FIsFree | 是否赠品 | string | 复选框 |
FLot | 批号 | string | 批次 |
FProduceDate | 生产日期 | string | 日期 |
FExpiryDate | 有效期至 | string | 日期 |
FEntryTaxRate | 税率% | string | 小数 |
FEntryTaxAmount | 税额 | string | 金额 |
FAmount | 金额 | string | 金额 |
FAllAmount | 价税合计 | string | 金额 |
FStockID_FNumber | 仓库 | string | 基础资料 |
FStockStatusID_FNumber | 库存状态 | string | 基础资料 |
FMtoNo | 计划跟踪号 | string | 文本 |
FEntrynote | 备注 | string | 文本 |
FSrcType | 源单类型 | string | 源单类型 |
FSrcBillNo | 源单编号 | string | 源单编号 |
FSoorDerno | 订单单号 | string | 文本 |
FDiscountRate | 折扣率% | string | 小数 |
FDiscount | 折扣额 | string | 折扣额 |
FPriceDiscount | 单价折扣 | string | 单价 |
FSOEntryId | 销售订单EntryId | string | 整数 |
FB2CORDERDETAILID | B2C订单明细Id | string | 整数 |
FThirdEntryId | 管易订单单号 | string | 文本 |
FETHIRDBILLID | 第三方单据ID | string | 文本 |
FETHIRDBILLNO | 第三方单据编号 | string | 文本 |
FGYFINDate | 管易到账时间 | string | 长日期 |
FEntity_FENTRYID | FEntity_FENTRYID | string | |
Limit | 最大行数 | string | 金蝶的查询分页参数 |
StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
字段 | 名称 | 类型 | 描述 |
FBillTypeID_FNumber | 单据类型 | string | 单据类型 |
FBillNo | 单据编号 | string | 单据编号 |
FDate | 日期 | string | 日期 |
FSaleOrgId_FNumber | 销售组织 | string | 组织 |
FCustomerID_FNumber | 客户 | string | 基础资料 |
FCarriageNO | 运输单号 | string | 文本 |
FStockOrgId_FNumber | 发货组织 | string | 组织 |
FLinkPhone | 联系电话 | string | 文本 |
FLinkMan | 收货人姓名 | string | 文本 |
FReceiveAddress | 收货方地址 | string | 文本 |
FSettleTypeID_FNumber | 结算方式 | string | 基础资料 |
FReceiverAddress | 收货人地址 | string | 文本 |
FReceiverMobile | 收货人手机 | string | 文本 |
FReceiverCountry | 收货人国家 | string | 文本 |
FReceiverState | 收货人省份 | string | 文本 |
FReceiverCity | 收货人城市 | string | 文本 |
FReceiverDistrict | 收货人地区 | string | 文本 |
FReceiverPhone | 收货人电话 | string | 文本 |
FSHOPNUMBER | 网店编码 | string | 文本 |
FSALECHANNEL | 销售渠道 | string | 文本 |
FVIPCODE | 会员编码 | string | 文本 |
FCustMatID_FNumber | 客户物料编码 | string | 基础资料 |
FMaterialID_FNumber | 物料编码 | string | 基础资料 |
FBarcode | 零售条形码 | string | 文本 |
FMustQty | 应发数量 | string | 数量 |
FRealQty | 实发数量 | string | 数量 |
FPrice | 单价 | string | 单价 |
FTaxPrice | 含税单价 | string | 单价 |
FIsFree | 是否赠品 | string | 复选框 |
FLot | 批号 | string | 批次 |
FProduceDate | 生产日期 | string | 日期 |
FExpiryDate | 有效期至 | string | 日期 |
FEntryTaxRate | 税率% | string | 小数 |
FEntryTaxAmount | 税额 | string | 金额 |
FAmount | 金额 | string | 金额 |
FAllAmount | 价税合计 | string | 金额 |
FStockID_FNumber | 仓库 | string | 基础资料 |
FStockStatusID_FNumber | 库存状态 | string | 基础资料 |
FMtoNo | 计划跟踪号 | string | 文本 |
FEntrynote | 备注 | string | 文本 |
FSrcType | 源单类型 | string | 源单类型 |
FSrcBillNo | 源单编号 | string | 源单编号 |
FSoorDerno | 订单单号 | string | 文本 |
FDiscountRate | 折扣率% | string | 小数 |
FDiscount | 折扣额 | string | 折扣额 |
FPriceDiscount | 单价折扣 | string | 单价 |
FSOEntryId | 销售订单EntryId | string | 整数 |
FB2CORDERDETAILID | B2C订单明细Id | string | 整数 |
FThirdEntryId | 管易订单单号 | string | 文本 |
FETHIRDBILLID | 第三方单据ID | string | 文本 |
FETHIRDBILLNO | 第三方单据编号 | string | 文本 |
FGYFINDate | 管易到账时间 | string | 长日期 |
FEntity_FENTRYID | FEntity_FENTRYID | string | |
赛意SMOM接口明细
- 接口:SmomWebApiController.SaveShippingOrders
- 接口名称:保存发运单数据
- 接口方法:POST
请求参数
字段 | 名称 | 类型 | 描述 |
No | 编码 | string | |
ErpId | ErpId | string | |
OrderType | 订单类型 | string | |
ShippingWareHouseCode | 发货仓库代码 | string | |
DeliveryDate | 发货日期 | datetime | |
ShippingDate | 装运日期 | datetime | |
Contacts | 联系人 | string | |
ContactNumber | 联系电话 | string | |
Connecter | 连接器 | string | |
Address | 地址 | string | |
CustomerCode | 客户编码 | string | |
EnterpriseCode | 企业代码 | string | |
SupplierCode | 供应商编码 | string | |
TransportCompany | 运输公司 | string | |
TransportNo | 运输编码 | string | |
OrderState | 订单状态 | string | |
PriorityType | 优先级 | string | |
CancelReason | 取消原因 | string | |
Remark | 备注 | string | |
DetailList | 详情 | array | |
DetailList.ShippingOrderNo | 发货订单号 | string | |
DetailList.LineNo | 行号 | string | |
DetailList.ItemCode | 物料编码 | string | |
DetailList.ExpectQty | 预计数量 | string | |
DetailList.ErpId | ErpId | string | |
DetailList.OrderNo | 订单编码 | string | |
DetailList.InvoiceNo | 发票代码 | string | |
DetailList.PoNo | 订单号 | string | |
DetailList.PoDetailLineNo | 采购订单明细行编号 | string | |
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 | |
DetailList.LastUpdateDate | 上次更新日期 | datetime | |
DetailList.ErpKey | ErpKey | string | |
系统对接总览
通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与赛意SMOM之间的数据接口,使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具,基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎,通过可视化配置,快速实现客户灵活多变的动态集成需求,让集成开发简单、执行过程可靠、问题风险可控。
