金蝶云星空与钉钉对接集成付款单查询连通添加审批评论(传给金蝶后，回传钉钉提示（已审核）④)
对接源平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
对接目标系统:钉钉
钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。
数据集成方案配置
在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用
金蝶云星空接口明细
- API：executeBillQuery
- NAME：付款单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FPAYBILLENTRY_FEntryID | FPAYBILLENTRY_FEntryID | FPAYBILLENTRY_FEntryID | |
| FID | 实体主键 | FID | |
| FBillNo | 单据编号 | FBillNo | |
| FDOCUMENTSTATUS | 单据状态 | FDOCUMENTSTATUS | |
| FCreatorId | 创建人 | FCreatorId | |
| FAPPROVERID | 审核人 | FAPPROVERID | |
| FCreateDate | 创建日期 | FCreateDate | |
| FSETTLEORGID | 结算组织 | FSETTLEORGID.FNumber | |
| FApproveDate | 审核日期 | FApproveDate | |
| FPURCHASEORGID | 采购组织 | FPURCHASEORGID.FNumber | |
| FPAYTOTALAMOUNTFOR_H | 表头-应付金额 | FPAYTOTALAMOUNTFOR_H | |
| FCURRENCYID | 币别 | FCURRENCYID.FNumber | |
| FDATE | 业务日期 | FDATE | |
| FModifyDate | 修改日期 | FModifyDate | |
| FModifierId | 修改人 | FModifierId | |
| FWRITTENOFFSTATUS | 核销状态 | FWRITTENOFFSTATUS | |
| FBillTypeID | 单据类型 | FBillTypeID.FNumber | |
| FPURCHASERID | 采购员 | FPURCHASERID.FNumber | |
| FPURCHASERGROUPID | 采购组 | FPURCHASERGROUPID | |
| FPURCHASEDEPTID | 采购部门 | FPURCHASEDEPTID.FNumber | |
| FREALPAYAMOUNTFOR_H | 表头-实付金额 | FREALPAYAMOUNTFOR_H | |
| FACCOUNTSYSTEM | 会计核算体系 | FACCOUNTSYSTEM | |
| FCancellerId | 作废人 | FCancellerId | |
| FCancelStatus | 作废状态 | FCancelStatus | |
| FCancelDate | 作废日期 | FCancelDate | |
| FCONTACTUNITTYPE | 往来单位类型 | FCONTACTUNITTYPE | |
| FCONTACTUNIT | 往来单位 | FCONTACTUNIT.FNumber | |
| FRECTUNITTYPE | 收款单位类型 | FRECTUNITTYPE | |
| FRECTUNIT | 收款单位 | FRECTUNIT.FNumber | |
| FSOURCESYSTEM | 来源系统 | FSOURCESYSTEM | |
| FBUSINESSTYPE | 业务类型 | FBUSINESSTYPE | |
| FISINIT | 是否期初单据 | FISINIT | |
| FDepartment | 部门 | FDepartment.FNumber | |
| FPAYORGID | 付款组织 | FPAYORGID.FNumber | |
| FISSAMEORG | 是否相同组织 | FISSAMEORG | |
| FIsCredit | 是否信贷业务 | FIsCredit | |
| FSETTLERATE | 结算汇率 | FSETTLERATE | |
| FPAYAMOUNTFOR | 付款金额 | FPAYAMOUNTFOR | |
| FEXCHANGETYPE | 汇率类型 | FEXCHANGETYPE | |
| FMAINBOOKID | 本位币 | FMAINBOOKID | |
| FSETTLECUR | 结算币别 | FSETTLECUR | |
| FPAYTOTALAMOUNT_H | 表头-应付金额本位币 | FPAYTOTALAMOUNT_H | |
| FPAYAMOUNT | 表头-付款金额本位币 | FPAYAMOUNT | |
| FREALPAYAMOUNT_H | 表头-实付金额本位币 | FREALPAYAMOUNT_H | |
| FEXCHANGERATE | 汇率 | FEXCHANGERATE | |
| FScanPoint | 扫描点 | FScanPoint | |
| FIsWriteOff | 是否转销 | FIsWriteOff | |
| FMatchMethodID | 核销方式 | FMatchMethodID | |
| FREALPAY | 实报实付 | FREALPAY | |
| FREMARK | 备注 | FREMARK | |
| FBookingDate | 期望付款日期 | FBookingDate | |
| FTHIRDBILLNO | 第三方单据编号 | FTHIRDBILLNO | |
| FWBSETTLENO | 流水号 | FWBSETTLENO | |
| FSETTLEMAINBOOKID | 结算本位币 | FSETTLEMAINBOOKID | |
| FSETTLEEXCHANGETYPE | 结算汇率类型 | FSETTLEEXCHANGETYPE | |
| FISCASHPURCHASE | 现购 | FISCASHPURCHASE | |
| FOUTCONTACTID | 转出往来单位 | FOUTCONTACTID.FNumber | |
| FOUTCONTACTTYPE | 转出往来单位类型 | FOUTCONTACTTYPE | |
| FIsBorrow | 是否其他预付 | FIsBorrow | |
| FISFROMTRADEBANK | 来源交易明细 | FISFROMTRADEBANK | |
| FGYACCOUNTWATERID | 管易财务流水内码 | FGYACCOUNTWATERID | |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | FISCARRYRATE | |
| FGYSHOPNAME | 管易对应店铺 | FGYSHOPNAME | |
| FGYCUSTOMERID | 管易对应客户 | FGYCUSTOMERID | |
| FMoreReceive | 多收款人 | FMoreReceive | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | FPRESETASSISTANT1 | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | FPRESETASSISTANT2 | |
| FPRESETTEXT1 | 预设文本字段1 | FPRESETTEXT1 | |
| FPRESETTEXT2 | 预设文本字段2 | FPRESETTEXT2 | |
| FPRESETBASE1 | 预设基础资料字段1 | FPRESETBASE1 | |
| FPRESETBASE2 | 预设基础资料字段2 | FPRESETBASE2 | |
| FSRCBILLNO | 源单明细 | FSRCBILLNO | |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' and FDOCUMENTSTATUS='C' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | AP_PAYBILL | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FPAYBILLENTRY_FEntryID | FPAYBILLENTRY_FEntryID | | |
| FID | 实体主键 | | |
| FBillNo | 单据编号 | | |
| FDOCUMENTSTATUS | 单据状态 | | |
| FCreatorId | 创建人 | | |
| FAPPROVERID | 审核人 | | |
| FCreateDate | 创建日期 | | |
| FSETTLEORGID | 结算组织 | | |
| FApproveDate | 审核日期 | | |
| FPURCHASEORGID | 采购组织 | | |
| FPAYTOTALAMOUNTFOR_H | 表头-应付金额 | | |
| FCURRENCYID | 币别 | | |
| FDATE | 业务日期 | | |
| FModifyDate | 修改日期 | | |
| FModifierId | 修改人 | | |
| FWRITTENOFFSTATUS | 核销状态 | | |
| FBillTypeID | 单据类型 | | |
| FPURCHASERID | 采购员 | | |
| FPURCHASERGROUPID | 采购组 | | |
| FPURCHASEDEPTID | 采购部门 | | |
| FREALPAYAMOUNTFOR_H | 表头-实付金额 | | |
| FACCOUNTSYSTEM | 会计核算体系 | | |
| FCancellerId | 作废人 | | |
| FCancelStatus | 作废状态 | | |
| FCancelDate | 作废日期 | | |
| FCONTACTUNITTYPE | 往来单位类型 | | |
| FCONTACTUNIT | 往来单位 | | |
| FRECTUNITTYPE | 收款单位类型 | | |
| FRECTUNIT | 收款单位 | | |
| FSOURCESYSTEM | 来源系统 | | |
| FBUSINESSTYPE | 业务类型 | | |
| FISINIT | 是否期初单据 | | |
| FDepartment | 部门 | | |
| FPAYORGID | 付款组织 | | |
| FISSAMEORG | 是否相同组织 | | |
| FIsCredit | 是否信贷业务 | | |
| FSETTLERATE | 结算汇率 | | |
| FPAYAMOUNTFOR | 付款金额 | | |
| FEXCHANGETYPE | 汇率类型 | | |
| FMAINBOOKID | 本位币 | | |
| FSETTLECUR | 结算币别 | | |
| FPAYTOTALAMOUNT_H | 表头-应付金额本位币 | | |
| FPAYAMOUNT | 表头-付款金额本位币 | | |
| FREALPAYAMOUNT_H | 表头-实付金额本位币 | | |
| FEXCHANGERATE | 汇率 | | |
| FScanPoint | 扫描点 | | |
| FIsWriteOff | 是否转销 | | |
| FMatchMethodID | 核销方式 | | |
| FREALPAY | 实报实付 | | |
| FREMARK | 备注 | | |
| FBookingDate | 期望付款日期 | | |
| FTHIRDBILLNO | 第三方单据编号 | | |
| FWBSETTLENO | 流水号 | | |
| FSETTLEMAINBOOKID | 结算本位币 | | |
| FSETTLEEXCHANGETYPE | 结算汇率类型 | | |
| FISCASHPURCHASE | 现购 | | |
| FOUTCONTACTID | 转出往来单位 | | |
| FOUTCONTACTTYPE | 转出往来单位类型 | | |
| FIsBorrow | 是否其他预付 | | |
| FISFROMTRADEBANK | 来源交易明细 | | |
| FGYACCOUNTWATERID | 管易财务流水内码 | | |
| FISCARRYRATE | 是否下推携带汇率到结算汇率 | | |
| FGYSHOPNAME | 管易对应店铺 | | |
| FGYCUSTOMERID | 管易对应客户 | | |
| FMoreReceive | 多收款人 | | |
| FPRESETASSISTANT1 | 预设辅助资料字段1 | | |
| FPRESETASSISTANT2 | 预设辅助资料字段2 | | |
| FPRESETTEXT1 | 预设文本字段1 | | |
| FPRESETTEXT2 | 预设文本字段2 | | |
| FPRESETBASE1 | 预设基础资料字段1 | | |
| FPRESETBASE2 | 预设基础资料字段2 | | |
| FSRCBILLNO | 源单明细 | | |
钉钉接口明细
- API：topapi/process/instance/comment/add
- NAME：添加审批评论
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| request | 请求对象 | | |
| request.process_instance_id | 审批实例ID | _findCollection find id from a9138482-05d7-36b8-a20e-2f3bdb3f90fb where business_id={{FBillNo}} | 可通过调用获取审批实例ID列表接口获取。 |
| request.text | 评论的内容 | 已审核 | |
| request.comment_userid | 评论人的userid | 112018120420563028 | |
数据对接价值
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：钉钉与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
