金蝶云星空和管易云接口打通对接实战

对接系统金蝶云星空

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

接通系统：管易云

金蝶管易云是金蝶集团旗下以电商和新零售为核心业务的子公司，公司于2008年成立，拥有从事电商及新零售业务相关专业知识工作者超过1000人。为伊利、网易有道、东阿阿胶、金龙鱼、海康、科大讯飞等超过110000家企业客户提供专业服务，用户数超过100万人。金蝶管易云与淘宝、天猫、京东、拼多多、抖音等超过150+主流电商平台建立合作关系。

数据集成方案配置

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区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
FBaseQty	实收基本单位数量	FBaseQty
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
FStockLocId	仓位	FStockLocId
FCMKBarCode	零售条形码	FCMKBarCode
FMaterialId_FPurchaseUnitId_FConvertDenominator	FMaterialId_FPurchaseUnitId_FConvertDenominator
FMaterialId_FPurchaseUnitId_FConvertNumerator	FMaterialId_FPurchaseUnitId_FConvertNumerator
FRemainInStockQty	采购单位数量
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FSTOCKID.FNumber IN ('04SP','01SP','04DS','06DS','01DS','101SP','101DS')	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	STK_MISCELLANEOUS	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
FEntity_FEntryID	FEntryID
FID	实体主键
FBillNo	单据编号
FDocumentStatus	单据状态
FStockOrgId_FNumber	库存组织
FDate	日期
FBillTypeID	单据类型
FNOTE	备注
FMATERIALID_FNumber	物料编码
FSTOCKID_FNumber	收货仓库
FBaseQty	实收基本单位数量
FPrice	成本价
FAmount	总成本
FBOMID	BOM版本
FPRODUCEDATE	生产日期
FEXPIRYDATE	有效期至
FMTONO	计划跟踪号
FProjectNo	项目编号
FSTOCKSTATUSID	库存状态
FOWNERID	货主
FSTOCKFLAG	库存更新标志
FJoinQty	关联数量
FSRCBILLTYPEID	源单类型
FSRCBILLNO	源单编号
FLOT_FNumber	批号
FEntryNote	备注
FStockLocId	仓位
FCMKBarCode	零售条形码
FMaterialId_FPurchaseUnitId_FConvertDenominator	FMaterialId_FPurchaseUnitId_FConvertDenominator
FMaterialId_FPurchaseUnitId_FConvertNumerator	FMaterialId_FPurchaseUnitId_FConvertNumerator
FRemainInStockQty	采购单位数量

管易云接口明细

• 调用接口：gy.erp.stock.other.in.add
• 接口名称：其他入库单新增完结接口
• 方法：POST

请求参数

字段	字段名称	类型	配置值
warehouse_code	仓库代码	string	{{FSTOCKID_FNumber}}
type	入库类型代码	string
note	备注	string	{{FBillNo}}金蝶其他入库
details	入库明细	array	details
details.item_code	商品代码	string	{{details.FMATERIALID_FNumber}}
details.sku_code	规格代码	string
details.barcode	商品条码	string
details.qty	数量	string	{{details.FRemainInStockQty}}
details.uniqueCode	唯一码	string
details.batchNumber	批次号	string	{{details.FLOT_FNumber}}
details.manufacturingDate	生产日期	string	function case when '{{details.FPRODUCEDATE datetime}}'='' then '2022-01-01 00:00:00' else '{{details.FPRODUCEDATE datetime}}' end
details.shelfLife	有效期	string	_function ifnull(timestampdiff(day,'{{details.FPRODUCEDATE date}}','{{details.FEXPIRYDATE date}}'),3650)
details.stockDate	入库日期	string	2017-01-01 00:00:00
details.wms_bizcode	第三方系统单号	string	{{FSTOCKID_FNumber}}{{FBillNo}}

响应参数

字段	字段名称	类型	配置值
success	成功与否	string
errorCode	错误代码	string
subErrorCode	子错误代码	string
errorDesc	错误描述	string
subErrorDesc	子错误描述	string
requestMethod	请求方法	string
code	其他入库单单据编号	string

系统数据集成价值

通过数据集成平台可视化的快速配置调用接口打通金蝶云星空与管易云之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。