钉钉和金蝶云星空单据接口对接

源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

集成系统:钉钉

钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。

数据接口配置方案

数据集成平台对应的配置金蝶云星空与钉钉的对接只要三步就能完成两个系统之间的数据对接。第一步根据金蝶云星空的接口参数要求记录在轻易云集成平台。第二步配置金蝶云星空与钉钉之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

金蝶云星空接口明细

• 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	品牌

钉钉接口明细

• API：topapi/processinstance/create

• NAME：发起审批实例(自建)

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
process_code	审批流的唯一码	PROC-AC975DA3-9E35-4091-94A1-B9B78291AEB3	process_code在审批流程编辑页面的URL网址中获取。
originator_user_id	发起人	manager7748	审批实例发起人的userid。
dept_id	发起人所在部门	-1	发起人所在的部门，如果发起人属于根部门，传-1。
form_component_values	审批流表单参数
form_component_values.物料编码
form_component_values.物料名称		{{FName}}
form_component_values.规格型号		{{FSpecification}}

数据对接效果

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