系统数据集成方案

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

对接源平台:金蝶云星空

接通系统：钉钉

数据集成方案配置

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

金蝶云星空接口明细

• 接口：executeBillQuery
• 接口名称：付款单查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
FPAYBILLENTRY_FEntryID	FPAYBILLENTRY_FEntryID	string
FID	实体主键	string
FBillNo	单据编号	string
FDOCUMENTSTATUS	单据状态	string
FCreatorId	创建人	string
FAPPROVERID	审核人	string
FCreateDate	创建日期	string
FSETTLEORGID	结算组织	string
FApproveDate	审核日期	string
FPURCHASEORGID	采购组织	string
FPAYTOTALAMOUNTFOR_H	表头-应付金额	string
FCURRENCYID	币别	string
FDATE	业务日期	string
FModifyDate	修改日期	string
FModifierId	修改人	string
FWRITTENOFFSTATUS	核销状态	string
FBillTypeID	单据类型	string
FPURCHASERID	采购员	string
FPURCHASERGROUPID	采购组	string
FPURCHASEDEPTID	采购部门	string
FREALPAYAMOUNTFOR_H	表头-实付金额	string
FACCOUNTSYSTEM	会计核算体系	string
FCancellerId	作废人	string
FCancelStatus	作废状态	string
FCancelDate	作废日期	string
FCONTACTUNITTYPE	往来单位类型	string
FCONTACTUNIT	往来单位	string
FRECTUNITTYPE	收款单位类型	string
FRECTUNIT	收款单位	string
FSOURCESYSTEM	来源系统	string
FBUSINESSTYPE	业务类型	string
FISINIT	是否期初单据	string
FDepartment	部门	string
FPAYORGID	付款组织	string
FISSAMEORG	是否相同组织	string
FIsCredit	是否信贷业务	string
FSETTLERATE	结算汇率	string
FPAYAMOUNTFOR	付款金额	string
FEXCHANGETYPE	汇率类型	string
FMAINBOOKID	本位币	string
FSETTLECUR	结算币别	string
FPAYTOTALAMOUNT_H	表头-应付金额本位币	string
FPAYAMOUNT	表头-付款金额本位币	string
FREALPAYAMOUNT_H	表头-实付金额本位币	string
FEXCHANGERATE	汇率	string
FScanPoint	扫描点	string
FIsWriteOff	是否转销	string
FMatchMethodID	核销方式	string
FREALPAY	实报实付	string
FREMARK	备注	string
FBookingDate	期望付款日期	string
FTHIRDBILLNO	第三方单据编号	string
FWBSETTLENO	流水号	string
FSETTLEMAINBOOKID	结算本位币	string
FSETTLEEXCHANGETYPE	结算汇率类型	string
FISCASHPURCHASE	现购	string
FOUTCONTACTID	转出往来单位	string
FOUTCONTACTTYPE	转出往来单位类型	string
FIsBorrow	是否其他预付	string
FISFROMTRADEBANK	来源交易明细	string
FGYACCOUNTWATERID	管易财务流水内码	string
FISCARRYRATE	是否下推携带汇率到结算汇率	string
FGYSHOPNAME	管易对应店铺	string
FGYCUSTOMERID	管易对应客户	string
FMoreReceive	多收款人	string
FPRESETASSISTANT1	预设辅助资料字段1	string
FPRESETASSISTANT2	预设辅助资料字段2	string
FPRESETTEXT1	预设文本字段1	string
FPRESETTEXT2	预设文本字段2	string
FPRESETBASE1	预设基础资料字段1	string
FPRESETBASE2	预设基础资料字段2	string
FSRCBILLNO	源单明细	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如:PUR_PurchaseOrder

响应参数

字段	名称	类型	描述
FPAYBILLENTRY_FEntryID	FPAYBILLENTRY_FEntryID	string
FID	实体主键	string
FBillNo	单据编号	string
FDOCUMENTSTATUS	单据状态	string
FCreatorId	创建人	string
FAPPROVERID	审核人	string
FCreateDate	创建日期	string
FSETTLEORGID	结算组织	string
FApproveDate	审核日期	string
FPURCHASEORGID	采购组织	string
FPAYTOTALAMOUNTFOR_H	表头-应付金额	string
FCURRENCYID	币别	string
FDATE	业务日期	string
FModifyDate	修改日期	string
FModifierId	修改人	string
FWRITTENOFFSTATUS	核销状态	string
FBillTypeID	单据类型	string
FPURCHASERID	采购员	string
FPURCHASERGROUPID	采购组	string
FPURCHASEDEPTID	采购部门	string
FREALPAYAMOUNTFOR_H	表头-实付金额	string
FACCOUNTSYSTEM	会计核算体系	string
FCancellerId	作废人	string
FCancelStatus	作废状态	string
FCancelDate	作废日期	string
FCONTACTUNITTYPE	往来单位类型	string
FCONTACTUNIT	往来单位	string
FRECTUNITTYPE	收款单位类型	string
FRECTUNIT	收款单位	string
FSOURCESYSTEM	来源系统	string
FBUSINESSTYPE	业务类型	string
FISINIT	是否期初单据	string
FDepartment	部门	string
FPAYORGID	付款组织	string
FISSAMEORG	是否相同组织	string
FIsCredit	是否信贷业务	string
FSETTLERATE	结算汇率	string
FPAYAMOUNTFOR	付款金额	string
FEXCHANGETYPE	汇率类型	string
FMAINBOOKID	本位币	string
FSETTLECUR	结算币别	string
FPAYTOTALAMOUNT_H	表头-应付金额本位币	string
FPAYAMOUNT	表头-付款金额本位币	string
FREALPAYAMOUNT_H	表头-实付金额本位币	string
FEXCHANGERATE	汇率	string
FScanPoint	扫描点	string
FIsWriteOff	是否转销	string
FMatchMethodID	核销方式	string
FREALPAY	实报实付	string
FREMARK	备注	string
FBookingDate	期望付款日期	string
FTHIRDBILLNO	第三方单据编号	string
FWBSETTLENO	流水号	string
FSETTLEMAINBOOKID	结算本位币	string
FSETTLEEXCHANGETYPE	结算汇率类型	string
FISCASHPURCHASE	现购	string
FOUTCONTACTID	转出往来单位	string
FOUTCONTACTTYPE	转出往来单位类型	string
FIsBorrow	是否其他预付	string
FISFROMTRADEBANK	来源交易明细	string
FGYACCOUNTWATERID	管易财务流水内码	string
FISCARRYRATE	是否下推携带汇率到结算汇率	string
FGYSHOPNAME	管易对应店铺	string
FGYCUSTOMERID	管易对应客户	string
FMoreReceive	多收款人	string
FPRESETASSISTANT1	预设辅助资料字段1	string
FPRESETASSISTANT2	预设辅助资料字段2	string
FPRESETTEXT1	预设文本字段1	string
FPRESETTEXT2	预设文本字段2	string
FPRESETBASE1	预设基础资料字段1	string
FPRESETBASE2	预设基础资料字段2	string
FSRCBILLNO	源单明细	string

钉钉接口明细

• 接口：topapi/process/instance/comment/add
• 接口名称：添加审批评论
• 接口方法：POST

请求参数

字段	名称	类型	描述
request	请求对象	object
request.process_instance_id	审批实例ID	string	可通过调用获取审批实例ID列表接口获取。
request.text	评论的内容	string
request.comment_userid	评论人的userid	string

系统打通概况

异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案，可以满足客户的实际业务需求，推动软件工程的规范化，使开发人员遵循统一的概要设计开发实现，降低系统实现的风险，做到系统设计资料的规范性与全面性，以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。

系统数据对接方案元数据代码