金蝶云星空对接打通钉钉付款申请单查询接口与发起审批实例(官方)接口
接入系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接系统：钉钉
钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。
数据接口配置
通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：付款申请单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：钉钉接口：发起审批实例(官方)，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：钉钉写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
金蝶云星空接口明细
- API：executeBillQuery
- NAME：付款申请单查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillNo | 单据编号 | FBillNo |
| FSETTLEORGID | 结算组织 | FSETTLEORGID.fname |
| FCONTACTUNIT | 往来单位 | FCONTACTUNIT.fname |
| FCREATEDATE | 创建日期 | FCREATEDATE |
| FPAYAMOUNTFOR_H | 应付金额 | FPAYAMOUNTFOR_H |
| F_VAOJ_FQR | 发起人 | F_VAOJ_FQR.fname |
| FEACHBANKACCOUNT | 对方银行账号 | FEACHBANKACCOUNT |
| FEACHCCOUNTNAME | 对方账户名称 | FEACHCCOUNTNAME |
| FBILLTYPEID | 单据类型 | FBILLTYPEID.Fnumber |
| FDATE | 申请日期 | FDATE |
| FCONTACTUNITTYPE | 往来单位类型 | FCONTACTUNITTYPE |
| FRECTUNITTYPE | 收款单位类型 | FRECTUNITTYPE |
| FRECTUNIT | 收款单位 | FRECTUNIT.fname |
| FPAYORGID | 付款组织 | FPAYORGID.fname |
| FAPPLYORGID | 申请组织 | FAPPLYORGID.fname |
| FSETTLETYPEID | 结算方式 | FSETTLETYPEID |
| FSOURCETYPE | 源单类型 | FSOURCETYPE |
| FPAYPURPOSEID | 付款用途 | FPAYPURPOSEID |
| FENDDATE | 到期日 | FENDDATE |
| FEXPECTPAYDATE | 期望付款日期 | FEXPECTPAYDATE |
| FPAYAMOUNTFOR | 应付金额 | FPAYAMOUNTFOR |
| FEACHBANKACCOUNT | 对方银行账号 | FEACHBANKACCOUNT |
| FAPPLYAMOUNTFOR | 申请付款金额 | FAPPLYAMOUNTFOR |
| FUnpaidAmount | 未付款金额 | FUnpaidAmount |
| FEACHCCOUNTNAME | 对方账户名称 | FEACHCCOUNTNAME |
| FQTY | 数量 | FQTY |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | CN_PAYAPPLY |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| FBillNo | 单据编号 | |
| FSETTLEORGID | 结算组织 | |
| FCONTACTUNIT | 往来单位 | |
| FCREATEDATE | 创建日期 | |
| FPAYAMOUNTFOR_H | 应付金额 | |
| F_VAOJ_FQR | 发起人 | |
| FPAYAPPLYENTRY_FEntryID | FPAYAPPLYENTRY_FEntryID | |
| FEACHBANKACCOUNT | 对方银行账号 | |
| FEACHCCOUNTNAME | 对方账户名称 | |
| FBILLTYPEID | 单据类型 | |
| FDATE | 申请日期 | |
| FCONTACTUNITTYPE | 往来单位类型 | |
| FRECTUNITTYPE | 收款单位类型 | |
| FRECTUNIT | 收款单位 | |
| FPAYORGID | 付款组织 | |
| FAPPLYORGID | 申请组织 | |
| FSETTLETYPEID | 结算方式 | |
| FSOURCETYPE | 源单类型 | |
| FPAYPURPOSEID | 付款用途 | |
| FENDDATE | 到期日 | |
| FEXPECTPAYDATE | 期望付款日期 | |
| FPAYAMOUNTFOR | 应付金额 | |
| FEACHBANKACCOUNT | 对方银行账号 | |
| FAPPLYAMOUNTFOR | 申请付款金额 | |
| FUnpaidAmount | 未付款金额 | |
| FEACHCCOUNTNAME | 对方账户名称 | |
| FQTY | 数量 | |
钉钉接口明细
- API：topapi/processinstance/create
- NAME：发起审批实例(官方)
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| process_code | 审批流的唯一码 | PROC-C1D46DC7-ACB2-4B63-8C48-F644942F63E5 |
| originator_user_id | 发起人 | _findCollection find user_id from 5933ad08-2f0e-36cb-9f21-0ece37832875 where name={{F_VAOJ_FQR}} |
| dept_id | 发起人所在部门 | -1 |
| form_component_values | 审批流表单参数 | |
| form_component_values.单据编号 |
| form_component_values.货款所属项目 | | {{FSETTLEORGID}} |
| form_component_values.供应商名称 |
| form_component_values.付款时间 | | {{FCREATEDATE date}} |
| form_component_values.货款属性 |
| form_component_values.付款金额（元） | | {{FPAYAMOUNTFOR_H}} |
| form_component_values.收款人（公司名称） |
| form_component_values.收款账号 | | {{FEACHBANKACCOUNT}} |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| primaryWriteback | 回写参数 | |
| primaryWriteback.code | code | {{process_instance_id}} |
系统对接总览
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：钉钉与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
