钉钉与金蝶云星空对接集成付款单查询连通发起审批实例(官方)(金蝶付款申请单->钉钉报销 付款申请单查询 测试)
对接系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
目标系统:钉钉
钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
系统对接接口配置
通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为钉钉，并且选择对应连接器。选择好对应的topapi/processinstance/create接口作为数据写入动作完成第一步的接口配置。系统数据集成平台更加专注于数据集成与流程自动化的应用连接器，通过自研引擎，与各个平台或者服务完成对接，从而打通数据孤岛，实现数据的跨系统自由流转，让数据真正成为企业的核心生产力。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：付款单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| FPAYORGID | 付款组织 | string |
| FCreatorId | 创建人 | string |
| FPURCHASEDEPTID | 采购部门 | string |
| FCancelStatus | 作废状态 | string |
| FApproveDate | 审核日期 | string |
| FAPPROVERID | 审核人 | string |
| FPURCHASERGROUPID | 采购组 | string |
| StartRow | 开始行索引 | string |
| FilterString | 过滤条件 | string |
| Limit | 最大行数 | string |
| FCancelDate | 作废日期 | string |
| FSOURCESYSTEM | 来源系统 | string |
| FRECTUNIT | 收款单位 | string |
| FModifyDate | 修改日期 | string |
| FPAYAPPLYENTRY_FEntryID | FPAYAPPLYENTRY_FEntryID | string |
| FPURCHASEORGID | 采购组织 | string |
| FBillTypeID | 单据类型 | string |
| FSETTLEORGID | 结算组织 | string |
| FCreateDate | 创建日期 | string |
| FBUSINESSTYPE | 业务类型 | string |
| FCONTACTUNIT | 往来单位 | string |
| FCancellerId | 作废人 | string |
| FRECTUNITTYPE | 收款单位类型 | string |
| FACCOUNTSYSTEM | 会计核算体系 | string |
| FormId | 业务对象表单Id | string |
| FDATE | 业务日期 | string |
| FCONTACTUNITTYPE | 往来单位类型 | string |
| TopRowCount | 返回总行数 | int |
| FDOCUMENTSTATUS | 单据状态 | string |
| FBillNo | 单据编号 | string |
| FCURRENCYID | 币别 | string |
| FPURCHASERID | 采购员 | string |
| FieldKeys | 需查询的字段key集合 | array |
| FID | 实体主键 | string |
| FModifierId | 修改人 | string |
| FDepartment | 部门 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FPAYAPPLYENTRY_FEntryID | FPAYAPPLYENTRY_FEntryID | string | |
| FID | 实体主键 | string | |
| FBillNo | 单据编号 | string | |
| FDOCUMENTSTATUS | 单据状态 | string | |
| FCreatorId | 创建人 | string | |
| FAPPROVERID | 审核人 | string | |
| FCreateDate | 创建日期 | string | |
| FSETTLEORGID | 结算组织 | string | |
| FApproveDate | 审核日期 | string | |
| FPURCHASEORGID | 采购组织 | string | |
| FCURRENCYID | 币别 | string | |
| FDATE | 业务日期 | string | |
| FModifyDate | 修改日期 | string | |
| FModifierId | 修改人 | string | |
| FWRITTENOFFSTATUS | 核销状态 | string | |
| FBillTypeID | 单据类型 | string | |
| FPURCHASERID | 采购员 | string | |
| FPURCHASERGROUPID | 采购组 | string | |
| FPURCHASEDEPTID | 采购部门 | string | |
| FACCOUNTSYSTEM | 会计核算体系 | string | |
| FCancellerId | 作废人 | string | |
| FCancelStatus | 作废状态 | string | |
| FCancelDate | 作废日期 | string | |
| FCONTACTUNITTYPE | 往来单位类型 | string | |
| FCONTACTUNIT | 往来单位 | string | |
| FRECTUNITTYPE | 收款单位类型 | string | |
| FRECTUNIT | 收款单位 | string | |
| FSOURCESYSTEM | 来源系统 | string | |
| FBUSINESSTYPE | 业务类型 | 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 | |
| FVirIsSameAcctOrg | 是否同一核算组织 | string | |
| FSETTLETYPEID | 结算方式 | string | |
| FSETTLEPAYAMOUNTFOR | 折后金额 | string | |
| FSETTLEDISTAMOUNTFOR | 现金折扣 | string | |
| FPAYTOTALAMOUNTFOR | 表体-应付金额 | string | |
| FSETTLEPAYAMOUNT | 折后金额本位币 | string | |
| FSETTLEDISTAMOUNT | 现金折扣本位币 | string | |
| FPAYTOTALAMOUNT | 表体-应付金额本位币 | string | |
| FWRITTENOFFSTATUS_D | 表体明细-核销状态 | string | |
| FWRITTENOFFAMOUNTFOR_D | 表体明细-已核销金额 | string | |
| FOPPOSITEBANKACCOUNT | 对方银行账号 | string | |
| FCOMMENT | 备注 | string | |
| FOPPOSITECCOUNTNAME | 对方账户名称 | string | |
| FPAYITEM | 采购订单 | string | |
| FHANDLINGCHARGEFOR | 手续费 | string | |
| FHANDLINGCHARGE | 手续费本位币 | string | |
| FREALPAYAMOUNTFOR_D | 表体-实付金额 | string | |
| FREALPAYAMOUNT_D | 表体-实付金额本位币 | string | |
| FASSTOTALAMOUNTFOR | 关联金额 | string | |
| FPAYITEMTYPE | 预付项目类型 | string | |
| FPURCHASEORDERID | 采购订单ID | string | |
| FACCOUNTID | 我方银行账号 | string | |
| FPAYACCOUNTNAME | 我方账户名称 | string | |
| FPAYBANKID | 我方开户行 | string | |
| FOPPOSITEBANKNAME | 对方开户行 | string | |
| FSETTLENO | 结算号 | string | |
| FBLEND | 勾对 | string | |
| FPURPOSEID | 付款用途 | string | |
| FOpenAddressRec | 开户行地址 | string | |
| FRecType | 收款类型 | string | |
| FCNAPS | 联行号 | string | |
| FBankTypeRec | 收款银行（作废） | string | |
| FProvince | 省（作废） | string | |
| FCity | 城市（作废） | string | |
| FDistrict | 地区（作废） | string | |
| FUrgent | 加急 | string | |
| FSubmitStatus | 提交银行状态 | string | |
| FSubmitUser | 提交/撤销银行人 | string | |
| FSubmitBankTime | 提交/撤销银行时间 | string | |
| FBankStatus | 银行处理状态 | string | |
| FBankCode | 银行状态码 | string | |
| FINNERACCOUNTID | 内部账号 | string | |
| FINNERACCOUNTNAME | 内部账户名称 | string | |
| FCOSTID | 费用项目 | string | |
| FRefundAmount | 退款关联金额 | string | |
| FCashAccount | 现金账号 | string | |
| FPAYAMOUNTFOR_E | 付款金额 | string | |
| FPAYAMOUNT_E | 付款金额本位币 | string | |
| FISPOST | 是否登账 | string | |
| FPOSTDATE | 登账日期 | string | |
| FMATERIALID | 物料编码 | string | |
| FMATERIALNAME | 物料名称 | string | |
| FPURCHASEORDERNO | 采购订单号 | string | |
| FMATERIALSEQ | 采购订单行号 | string | |
| FORDERENTRYID | 采购订单明细内码 | string | |
| FRuZhangType | 入账类型 | string | |
| FEBMSG | 银企处理详细信息 | string | |
| FOVERSHORTAGEFOR | 长短款 | string | |
| FOVERSHORTAGE | 长短款本位币 | string | |
| FEXPENSEDEPTID_E | 费用承担部门 | string | |
| FPayType | 支付类型 | string | |
| FPRICEUNITID | 计价单位 | string | |
| FPRICE | 含税单价 | string | |
| FQTY | 数量 | string | |
| FREFUNDQTY | 退款关联数量 | string | |
| FSwiftCode | SwiftCode | string | |
| FWRITTENOFFAMOUNT | 已核销金额本位币 | string | |
| FCHECKCODE | 流水号/对账码 | string | |
| FTOPAYMENTAMOUNTFOR | 保证金转货款金额 | string | |
| FTaxAmt | 税额 | string | |
| FNProvince | 省 | string | |
| FNCity | 城市 | string | |
| FNDistrict | 地区 | string | |
| FBankDetail | 银行网点 | string | |
| FCountry | 国别 | string | |
| FSignature | 签名 | string | |
| FGYSALEORDERNO | 管易销售订单号 | string | |
| FReturnMsg | 错误码 | string | |
| FFinishTime | 付款完成时间 | string | |
| FDistrictCode | 地区码 | string | |
| FBANKMSG | 银行状态描述 | string | |
| FResponseTme | 付款回调时间 | string | |
| FRequestTime | 请求时间 | string | |
| FCertType | 收款人证件类型 | string | |
| FCertNum | 收款人证件号码 | string | |
| FBankInvoice | 银企开票 | string | |
| FNoteStatus | 电票状态 | string | |
| FNOTVERIFICATEAMOUNT | 未核销金额 | string | |
| FENTRYPREPAYORDERNO | 预付采购订单号 | string | |
| FIsInvoice | 已电票开票 | string | |
| FUnique | 行唯一标志 | string | |
| FTransacType | 交易类型 | string | |
| FMessageInstruct | 电文指示 | string | |
| FServiceLevel | 服务级别 | string | |
| FPayMethod | 付款方式 | string | |
| FCNYPayMethod | CNY付款方式 | string | |
| FExContractNo | 兑换合约号 | string | |
| FCollectionCurr | 收款币别 | string | |
| FCollectionAmount | 收款金额 | string | |
| FReceiveBankBIC | 收款银行BIC | string | |
| FReceiveBankCode | 收款银行代码 | string | |
| FReceiveBranchCode | 收款支行代码 | string | |
| FServiceChargeBear | 手续费承担方 | string | |
| FServiceChargeNo | 手续费账号 | string | |
| FServiceChargeBank | 手续费账号银行 | string | |
| FServiceChargeCurr | 手续费币别 | string | |
| FCNAPSNum | CNAPSNum | string | |
| FCNYTransactType | 人民币交易种类 | string | |
| FRMBPayMethod | 人民币付款方式 | string | |
| FByAgentBank | 通过代理行完成 | string | |
| FAgentBankAcnt | 代理行账号 | string | |
| FAgentBankName | 代理行名称 | string | |
| FAgentBankArea | 代理行国家\地区 | string | |
| FAgentSWIFTCode | SWIFT Code(代理行) | string | |
| FAgentBankAddress | 代理行地址 | string | |
| FReceiveBankClear | 收款银行本地清算码 | string | |
| FReceiveBranchClear | 收款人本地清算分行代码 | string | |
| FClearParameter | 清算要求参数 | string | |
| FOtherPartyAdress | 对方地址 | string | |
| FOtherPartyEmail | 对方邮箱 | string | |
| FOverseaPay | 境外支付 | string | |
| FLinkRowId | 关联行ID | string | |
钉钉接口明细
- API：topapi/processinstance/create
- NAME：发起审批实例(官方)
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| process_code | 审批流的唯一码 | |
| originator_user_id | 发起人 | |
| dept_id | 发起人所在部门 | -1 |
| form_component_values | 审批流表单参数 | |
| form_component_values.name | 单据编号编码 | 单据编号 |
| form_component_values.value | 单据编号数值 | |
| form_component_values.ext_name | 货款所属项目编码 | 货款所属项目 |
| form_component_values.ext_value | 货款所属项目数值 | 111 |
| form_component_values.name | 供应商名称编码 | 供应商名称 |
| form_component_values.value | 供应商名称数值 | |
| form_component_values.name | 付款时间编码 | 付款时间 |
| form_component_values.value | 付款时间数值 | |
| form_component_values.name | 收款人（公司名称）编码 | 收款人（公司名称） |
| form_component_values.value | 收款人（公司名称）数值 | |
| form_component_values.name | 收款账号编码 | 收款账号 |
| form_component_values.value | 收款账号数值 | |
系统数据集成价值
全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务，很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象，减少各业务系统间的维护成本，减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题，将企业数据平滑对接，减少信息竖井。
