金蝶云星空和管易云接口打通对接实战
接入系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
接入系统:管易云
管易云是金蝶旗下专注提供电商企业管理软件服务的子品牌,先后开发了C-ERP、EC-OMS、EC-WMS、E店管家、BBC、B2B、B2C商城网站建设等产品和服务,涵盖电商业务全流程。
配置集成方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:金蝶云星空的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:管易云,把获取的数据组装成目标系统需要的格式进行写入。
金蝶云星空接口明细
- API:executeBillQuery
- NAME:其他出库查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FEntity_FEntryID | FEntryID | FEntity_FEntryID | |
FID | 实体主键 | FID | |
FBillNo | 单据编号 | FBillNo | |
FDocumentStatus | 单据状态 | FDocumentStatus | |
FStockOrgId_FNumber | 库存组织 | FStockOrgId.FNumber | |
FDate | 日期 | FDate | |
FBillTypeID | 单据类型 | FBillTypeID | |
FNOTE | 备注 | FNOTE | |
FMATERIALID_FNumber | 物料编码 | FMATERIALID.FNumber | |
FSTOCKID_FNumber | 收货仓库 | FSTOCKID.FNumber | |
FQty | 实收数量 | FQty | |
FPrice | 成本价 | FPrice | |
FAmount | 总成本 | FAmount | |
FBOMID | BOM版本 | FBOMID | |
FPRODUCEDATE | 生产日期 | FPRODUCEDATE | |
FEXPIRYDATE | 有效期至 | FEXPIRYDATE | |
FMTONO | 计划跟踪号 | FMTONO | |
FProjectNo | 项目编号 | FProjectNo | |
FSTOCKSTATUSID | 库存状态 | FSTOCKSTATUSID | |
FOWNERID | 货主 | FOWNERID | |
FSTOCKFLAG | 库存更新标志 | FSTOCKFLAG | |
FJoinQty | 关联数量 | FJoinQty | |
FSRCBILLTYPEID | 源单类型 | FSRCBILLTYPEID | |
FSRCBILLNO | 源单编号 | FSRCBILLNO | |
FLOT_FNumber | 批号 | FLOT.FNumber | |
FEntryNote | 备注 | FEntryNote | |
FCMKBarCode | 零售条形码 | FCMKBarCode | |
FLOT_FInStockDate | 批号入库日期 | FLOT.FInStockDate | |
Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式:FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
FormId | 业务对象表单Id | STK_MisDelivery | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
FEntity_FEntryID | FEntryID | | |
FID | 实体主键 | | |
FBillNo | 单据编号 | | |
FDocumentStatus | 单据状态 | | |
FStockOrgId_FNumber | 库存组织 | | |
FDate | 日期 | | |
FBillTypeID | 单据类型 | | |
FNOTE | 备注 | | |
FMATERIALID_FNumber | 物料编码 | | |
FSTOCKID_FNumber | 收货仓库 | | |
FQty | 实收数量 | | |
FPrice | 成本价 | | |
FAmount | 总成本 | | |
FBOMID | BOM版本 | | |
FPRODUCEDATE | 生产日期 | | |
FEXPIRYDATE | 有效期至 | | |
FMTONO | 计划跟踪号 | | |
FProjectNo | 项目编号 | | |
FSTOCKSTATUSID | 库存状态 | | |
FOWNERID | 货主 | | |
FSTOCKFLAG | 库存更新标志 | | |
FJoinQty | 关联数量 | | |
FSRCBILLTYPEID | 源单类型 | | |
FSRCBILLNO | 源单编号 | | |
FLOT_FInStockDate | 批号入库日期 | | |
FEntryNote | 备注 | | |
FCMKBarCode | 零售条形码 | | |
FLOT_FNumber | 批号 | | |
管易云接口明细
- API:gy.erp.stock.other.out.add
- NAME:其他出库单新增完结接口
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
warehouse_code | 仓库代码 | {{FSTOCKID_FNumber}} | 仓库代码 |
type | 出库类型代码 | | 出库类型代码 |
note | 备注 | 百世多利金蝶其他出库{{FBillNo}} | 出库类型代码 |
wms_bizcode | 第三方系统单号 | BSDL{{FBillNo}}{{FSTOCKID_FNumber}} | 第三方系统单号 |
receiver_name | 收货人 | | 收货人 |
receiver_mobile | 收货人手机 | | 收货人手机 |
receiver_zip | 收货人邮编 | | 收货人邮编 |
receiver_address | 收货人地址 | | 收货人地址 |
receiver_province | 收货人省名称 | | 收货人省名称 |
receiver_citye | 收货人市名称 | | 收货人市名称 |
receiver_district | 收货人区名称 | | 收货人区名称 |
details | 出库明细 | details | 出库明细 |
details.note | 备注 | | |
details.item_code | 商品代码 | {{details.FMATERIALID_FNumber}} | 商品代码与商品条码二者必选其一,当两者都提供时,以商品条码为准 |
details.sku_code | 规格代码 | | 有规格的商品此字段必填 |
details.barcode | 商品条码 | | 商品条码与商品代码二者必选其一,当两者都提供时,以商品条码为准 |
details.location_code | 库位代码(库位名称) | | 只有开启库位库存的仓库必填此字段,未开启库位库存的仓库不开启此字段 |
details.qty | 数量 | {{details.FQty}} | |
details.uniqueCode | 唯一码 | | 若当前商品为全程唯一码的商品,此参数必填 |
details.batchNumber | 批次号 | | 若当前商品为批次商品,此参数必填 |
details.manufacturingDate | 生产日期 | | 若当前商品为批次商品,此参数必填 |
details.shelfLife | 有效期 | | 若当前商品为批次商品,此参数必填 |
details.stockDate | 入库日期 | | 批次商品专用属性,参数选填。不填写时,程序默认当天 |
响应参数
接口字段 | 字段名称 | 预设值 | 描述 |
success | 成功与否 | | 成功与否 |
errorCode | 错误代码 | | 错误代码 |
subErrorCode | 子错误代码 | | 子错误代码 |
errorDesc | 错误描述 | | 错误描述 |
subErrorDesc | 子错误描述 | | 子错误描述 |
requestMethod | 请求方法 | | 请求方法 |
code | 其他出库单单据编号 | | 其他出库单单据编号 |
系统数据对接
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。