金蝶云星空和道一云·七巧接口打通对接实战

对接源平台:金蝶云星空

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

集成系统:道一云·七巧

道一云七巧低代码平台是业内少有的深扎在企业微信/微信生态集成中，提供SaaS/私有云/混合云多种协同办公解决方案的厂商。

接口方案配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取金蝶云星空的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到道一云·七巧中。轻易云集成平台的可视化配置轻松实现。

金蝶云星空接口明细

• API：executeBillQuery

• NAME：物料查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FMasterId	id	FMasterId
FNumber	编码	FNumber
FName	名称	FName
FSpecification	规格型号	FSpecification
FMnemonicCode	助记码	FMnemonicCode
FOldNumber	旧物料编码	FOldNumber
FBARCODE	条码	FBARCODE
FDescription	描述	FDescription
FMaterialGroup_FNumber	物料分组	FMaterialGroup.FNumber
FErpClsID	物料属性	FErpClsID
FDocumentStatus	数据状态	FDocumentStatus
FForbidStatus	禁用状态	FForbidStatus
FBaseUnitId_FNumber	基本单位.编码	FBaseUnitId.FNumber
FCreateOrgId_FNumber	创建组织	FCreateOrgId.FNumber
FUseOrgId_FNumber	使用组织	FUseOrgId.FNumber
FIsInventory	允许库存	FIsInventory
FIsSale	允许销售	FIsSale
FIsAsset	允许资产	FIsAsset
FIsSubContract	允许委外	FIsSubContract
FIsProduce	允许生产	FIsProduce
FIsPurchase	允许采购	FIsPurchase
FStockId_FNumber	仓库	FStockId.FNumber
FPurchaseOrgId_FNumber	采购组织.编码	FPurchaseOrgId.FNumber
FPurchaseOrgId_FName	采购组织	FPurchaseOrgId.FName
FIsBatchManage	启用批号管理	FIsBatchManage
FIsKFPeriod	启用保质期管理	FIsKFPeriod
FIsSNManage	启用序列号管理	FIsSNManage
FSafeStock	安全库存	FSafeStock
FCategoryID	存货类别	FCategoryID
FExpPeriod	保质期	FExpPeriod
FOrderQty	起订量	FOrderQty
FMinQty	最小批量	FMinQty
FMaxQty	最大批量	FMaxQty
FDefaultVendor_FNumber	默认供应商	FDefaultVendor.FNumber
FMaxPOQty	最大订货量	FMaxPOQty
FMinPOQty	最小订货量	FMinPOQty
FIncreaseQty	最小包装量	FIncreaseQty
FFixLeadTime	固定提前期	FFixLeadTime
FVarLeadTime	变动提前期	FVarLeadTime
FPlanBatchSplitQty	拆分批量	FPlanBatchSplitQty
FProduceBillType_FNumber	生产类型	FProduceBillType.FNumber
FPOBillTypeId_FNumber	采购类型	FPOBillTypeId.FNumber
FSubBillType_FNumber	委外类型	FSubBillType.FNumber
FGROSSWEIGHT	毛重	FGROSSWEIGHT
FNETWEIGHT	净重	FNETWEIGHT
FWEIGHTUNITID_FNumber	重量单位	FWEIGHTUNITID.FNumber
FLENGTH	长	FLENGTH
FWIDTH	宽	FWIDTH
FHEIGHT	高	FHEIGHT
FVOLUME	体积	FVOLUME
FWARRANTY	保修期	FWARRANTY
FSalePrice_CMK	零售价	FSalePrice_CMK
FVIPPrice_CMK	会员价	FVIPPrice_CMK
FPurPrice_CMK	采购单价	FPurPrice_CMK
FComBrandId_CMK_FNumber	品牌	FComBrandId_CMK.FNumber
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	BD_MATERIAL	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
FMasterId	id
FNumber	编码
FName	名称
FSpecification	规格型号
FMnemonicCode	助记码
FOldNumber	旧物料编码
FBARCODE	条码
FDescription	描述
FMaterialGroup_FNumber	物料分组
FErpClsID	物料属性
FDocumentStatus	数据状态
FForbidStatus	禁用状态
FBaseUnitId_FNumber	基本单位.编码
FCreateOrgId_FNumber	创建组织
FUseOrgId_FNumber	使用组织
FIsInventory	允许库存
FIsSale	允许销售
FIsAsset	允许资产
FIsSubContract	允许委外
FIsProduce	允许生产
FIsPurchase	允许采购
FStockId_FNumber	仓库
FPurchaseOrgId_FNumber	采购组织.编码
FPurchaseOrgId_FName	采购组织
FIsBatchManage	启用批号管理
FIsKFPeriod	启用保质期管理
FIsSNManage	启用序列号管理
FSafeStock	安全库存
FCategoryID	存货类别
FExpPeriod	保质期
FOrderQty	起订量
FMinQty	最小批量
FMaxQty	最大批量
FDefaultVendor_FNumber	默认供应商
FMaxPOQty	最大订货量
FMinPOQty	最小订货量
FIncreaseQty	最小包装量
FFixLeadTime	固定提前期
FVarLeadTime	变动提前期
FPlanBatchSplitQty	拆分批量
FProduceBillType_FNumber	生产类型
FPOBillTypeId_FNumber	采购类型
FSubBillType_FNumber	委外类型
FGROSSWEIGHT	毛重
FNETWEIGHT	净重
FWEIGHTUNITID_FNumber	重量单位
FLENGTH	长
FWIDTH	宽
FHEIGHT	高
FVOLUME	体积
FWARRANTY	保修期
FSalePrice_CMK	零售价
FVIPPrice_CMK	会员价
FPurPrice_CMK	采购单价
FComBrandId_CMK_FNumber	品牌

道一云·七巧接口明细

• 调用接口：/plus/cgi-bin/open/applications/{applicationId}/forms/{formModelId}

• 接口名称：新增七巧表单

• 方法：POST

请求参数

字段	字段名称	类型	配置值
客户编码	客户编码	string	客户编码8
客户名称	客户名称	string	客户名称8
联系人	联系人	array
联系人.客户名称	客户名称	string
联系人.姓名	姓名	string	姓名8
联系人.手机号码	手机号码	string	手机号码8
联系人.applicationId	应用id	string	c0ba4a9d89c74d65a4bedf9a320a7985
联系人.formModelId	表单id	string	eb77f6a118fe41698fcf3a87acf94a96
联系人.id	id	string
联系人.version	版本	string
联系人.loginUserId	操作用户id	string	dcb09269264708c43b135ed193212571
联系人.joinFormModelKeys	子表关联外键	string	联系人:客户名称

系统集成总览

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。