接口配置打通钉钉和金蝶云星空数据对接

接口配置打通钉钉和金蝶云星空数据对接

接入系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

接入系统：钉钉

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

数据集成方案配置

使用系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：金蝶云星空，然后选择对应的连接器。选择对应的付款单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为钉钉,并且选择对应连接器（关于钉钉的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的添加审批评论接口作为数据写入动作，既可以完成第一步的数据对接配置。

金蝶云星空接口明细

• API：executeBillQuery
• NAME：付款单查询
• METHOD：POST

请求参数

接口字段名称预设值 FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_FEntryIDFPAYBILLENTRY_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预设辅助资料字段1FPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 FPRESETBASE1预设基础资料字段1FPRESETBASE1 FPRESETBASE2预设基础资料字段2FPRESETBASE2 FVirIsSameAcctOrg是否同一核算组织FVirIsSameAcctOrg FSETTLETYPEID结算方式FSETTLETYPEID.FNumber FSETTLEPAYAMOUNTFOR折后金额FSETTLEPAYAMOUNTFOR FSETTLEDISTAMOUNTFOR现金折扣FSETTLEDISTAMOUNTFOR FPAYTOTALAMOUNTFOR表体-应付金额FPAYTOTALAMOUNTFOR FSETTLEPAYAMOUNT折后金额本位币FSETTLEPAYAMOUNT FSETTLEDISTAMOUNT现金折扣本位币FSETTLEDISTAMOUNT FPAYTOTALAMOUNT表体-应付金额本位币FPAYTOTALAMOUNT FWRITTENOFFSTATUS_D表体明细-核销状态FWRITTENOFFSTATUS_D FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额FWRITTENOFFAMOUNTFOR_D FOPPOSITEBANKACCOUNT对方银行账号FOPPOSITEBANKACCOUNT FCOMMENT备注FCOMMENT FOPPOSITECCOUNTNAME对方账户名称FOPPOSITECCOUNTNAME FPAYITEM采购订单FPAYITEM FHANDLINGCHARGEFOR手续费FHANDLINGCHARGEFOR FHANDLINGCHARGE手续费本位币FHANDLINGCHARGE FREALPAYAMOUNTFOR_D表体-实付金额FREALPAYAMOUNTFOR_D FREALPAYAMOUNT_D表体-实付金额本位币FREALPAYAMOUNT_D FASSTOTALAMOUNTFOR关联金额FASSTOTALAMOUNTFOR FPAYITEMTYPE预付项目类型FPAYITEMTYPE FPURCHASEORDERID采购订单IDFPURCHASEORDERID FACCOUNTID我方银行账号FACCOUNTID.FNumber FPAYACCOUNTNAME我方账户名称FPAYACCOUNTNAME FPAYBANKID我方开户行FPAYBANKID FOPPOSITEBANKNAME对方开户行FOPPOSITEBANKNAME FSETTLENO结算号FSETTLENO FBLEND勾对FBLEND FPURPOSEID付款用途FPURPOSEID.FNumber FOpenAddressRec开户行地址FOpenAddressRec FRecType收款类型FRecType FCNAPS联行号FCNAPS FBankTypeRec收款银行（作废）FBankTypeRec FProvince省（作废）FProvince FCity城市（作废）FCity FDistrict地区（作废）FDistrict FUrgent加急FUrgent FSubmitStatus提交银行状态FSubmitStatus FSubmitUser提交/撤销银行人FSubmitUser FSubmitBankTime提交/撤销银行时间FSubmitBankTime FBankStatus银行处理状态FBankStatus FBankCode银行状态码FBankCode FINNERACCOUNTID内部账号FINNERACCOUNTID FINNERACCOUNTNAME内部账户名称FINNERACCOUNTNAME FCOSTID费用项目FCOSTID.FNumber FRefundAmount退款关联金额FRefundAmount FCashAccount现金账号FCashAccount FPAYAMOUNTFOR_E付款金额FPAYAMOUNTFOR_E FPAYAMOUNT_E付款金额本位币FPAYAMOUNT_E FISPOST是否登账FISPOST FPOSTDATE登账日期FPOSTDATE FMATERIALID物料编码FMATERIALID.FNumber FMATERIALNAME物料名称FMATERIALNAME FPURCHASEORDERNO采购订单号FPURCHASEORDERNO FMATERIALSEQ采购订单行号FMATERIALSEQ FORDERENTRYID采购订单明细内码FORDERENTRYID FRuZhangType入账类型FRuZhangType FEBMSG银企处理详细信息FEBMSG FOVERSHORTAGEFOR长短款FOVERSHORTAGEFOR FOVERSHORTAGE长短款本位币FOVERSHORTAGE FEXPENSEDEPTID_E费用承担部门FEXPENSEDEPTID_E FPayType支付类型FPayType FPRICEUNITID计价单位FPRICEUNITID.FNumber FPRICE含税单价FPRICE FQTY数量FQTY FREFUNDQTY退款关联数量FREFUNDQTY FSwiftCodeSwiftCodeFSwiftCode FWRITTENOFFAMOUNT已核销金额本位币FWRITTENOFFAMOUNT FCHECKCODE流水号/对账码FCHECKCODE FTOPAYMENTAMOUNTFOR保证金转货款金额FTOPAYMENTAMOUNTFOR FTaxAmt税额FTaxAmt FNProvince省FNProvince FNCity城市FNCity FNDistrict地区FNDistrict FBankDetail银行网点FBankDetail FCountry国别FCountry FSignature签名FSignature FGYSALEORDERNO管易销售订单号FGYSALEORDERNO FReturnMsg错误码FReturnMsg FFinishTime付款完成时间FFinishTime FDistrictCode地区码FDistrictCode FBANKMSG银行状态描述FBANKMSG FResponseTme付款回调时间FResponseTme FRequestTime请求时间FRequestTime FCertType收款人证件类型FCertType FCertNum收款人证件号码FCertNum FBankInvoice银企开票FBankInvoice FNoteStatus电票状态FNoteStatus FNOTVERIFICATEAMOUNT未核销金额FNOTVERIFICATEAMOUNT FENTRYPREPAYORDERNO预付采购订单号FENTRYPREPAYORDERNO FIsInvoice已电票开票FIsInvoice FUnique行唯一标志FUnique FTransacType交易类型FTransacType FMessageInstruct电文指示FMessageInstruct FServiceLevel服务级别FServiceLevel FPayMethod付款方式FPayMethod FCNYPayMethodCNY付款方式FCNYPayMethod FExContractNo兑换合约号FExContractNo FCollectionCurr收款币别FCollectionCurr FCollectionAmount收款金额FCollectionAmount FReceiveBankBIC收款银行BICFReceiveBankBIC FReceiveBankCode收款银行代码FReceiveBankCode FReceiveBranchCode收款支行代码FReceiveBranchCode FServiceChargeBear手续费承担方FServiceChargeBear FServiceChargeNo手续费账号FServiceChargeNo FServiceChargeBank手续费账号银行FServiceChargeBank FServiceChargeCurr手续费币别FServiceChargeCurr FCNAPSNumCNAPSNumFCNAPSNum FCNYTransactType人民币交易种类FCNYTransactType FRMBPayMethod人民币付款方式FRMBPayMethod FByAgentBank通过代理行完成FByAgentBank FAgentBankAcnt代理行账号FAgentBankAcnt FAgentBankName代理行名称FAgentBankName FAgentBankArea代理行国家\地区FAgentBankArea FAgentSWIFTCodeSWIFT Code(代理行)FAgentSWIFTCode FAgentBankAddress代理行地址FAgentBankAddress FReceiveBankClear收款银行本地清算码FReceiveBankClear FReceiveBranchClear收款人本地清算分行代码FReceiveBranchClear FClearParameter清算要求参数FClearParameter FOtherPartyAdress对方地址FOtherPartyAdress FOtherPartyEmail对方邮箱FOtherPartyEmail FOverseaPay境外支付FOverseaPay FLinkRowId关联行IDFLinkRowId Limit最大行数{{PAGINATION_PAGE_SIZE}} StartRow开始行索引{{PAGINATION_START_ROW}} TopRowCount返回总行数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合 FormId业务对象表单IdAP_PAYBILL

响应参数

接口字段名称预设值 FPAYBILLENTRY_FEntryIDFPAYBILLENTRY_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 FVirIsSameAcctOrg是否同一核算组织 FSETTLETYPEID结算方式 FSETTLEPAYAMOUNTFOR折后金额 FSETTLEDISTAMOUNTFOR现金折扣 FPAYTOTALAMOUNTFOR表体-应付金额 FSETTLEPAYAMOUNT折后金额本位币 FSETTLEDISTAMOUNT现金折扣本位币 FPAYTOTALAMOUNT表体-应付金额本位币 FWRITTENOFFSTATUS_D表体明细-核销状态 FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额 FOPPOSITEBANKACCOUNT对方银行账号 FCOMMENT备注 FOPPOSITECCOUNTNAME对方账户名称 FPAYITEM采购订单 FHANDLINGCHARGEFOR手续费 FHANDLINGCHARGE手续费本位币 FREALPAYAMOUNTFOR_D表体-实付金额 FREALPAYAMOUNT_D表体-实付金额本位币 FASSTOTALAMOUNTFOR关联金额 FPAYITEMTYPE预付项目类型 FPURCHASEORDERID采购订单ID FACCOUNTID我方银行账号 FPAYACCOUNTNAME我方账户名称 FPAYBANKID我方开户行 FOPPOSITEBANKNAME对方开户行 FSETTLENO结算号 FBLEND勾对 FPURPOSEID付款用途 FOpenAddressRec开户行地址 FRecType收款类型 FCNAPS联行号 FBankTypeRec收款银行（作废） FProvince省（作废） FCity城市（作废） FDistrict地区（作废） FUrgent加急 FSubmitStatus提交银行状态 FSubmitUser提交/撤销银行人 FSubmitBankTime提交/撤销银行时间 FBankStatus银行处理状态 FBankCode银行状态码 FINNERACCOUNTID内部账号 FINNERACCOUNTNAME内部账户名称 FCOSTID费用项目 FRefundAmount退款关联金额 FCashAccount现金账号 FPAYAMOUNTFOR_E付款金额 FPAYAMOUNT_E付款金额本位币 FISPOST是否登账 FPOSTDATE登账日期 FMATERIALID物料编码 FMATERIALNAME物料名称 FPURCHASEORDERNO采购订单号 FMATERIALSEQ采购订单行号 FORDERENTRYID采购订单明细内码 FRuZhangType入账类型 FEBMSG银企处理详细信息 FOVERSHORTAGEFOR长短款 FOVERSHORTAGE长短款本位币 FEXPENSEDEPTID_E费用承担部门 FPayType支付类型 FPRICEUNITID计价单位 FPRICE含税单价 FQTY数量 FREFUNDQTY退款关联数量 FSwiftCodeSwiftCode FWRITTENOFFAMOUNT已核销金额本位币 FCHECKCODE流水号/对账码 FTOPAYMENTAMOUNTFOR保证金转货款金额 FTaxAmt税额 FNProvince省 FNCity城市 FNDistrict地区 FBankDetail银行网点 FCountry国别 FSignature签名 FGYSALEORDERNO管易销售订单号 FReturnMsg错误码 FFinishTime付款完成时间 FDistrictCode地区码 FBANKMSG银行状态描述 FResponseTme付款回调时间 FRequestTime请求时间 FCertType收款人证件类型 FCertNum收款人证件号码 FBankInvoice银企开票 FNoteStatus电票状态 FNOTVERIFICATEAMOUNT未核销金额 FENTRYPREPAYORDERNO预付采购订单号 FIsInvoice已电票开票 FUnique行唯一标志 FTransacType交易类型 FMessageInstruct电文指示 FServiceLevel服务级别 FPayMethod付款方式 FCNYPayMethodCNY付款方式 FExContractNo兑换合约号 FCollectionCurr收款币别 FCollectionAmount收款金额 FReceiveBankBIC收款银行BIC FReceiveBankCode收款银行代码 FReceiveBranchCode收款支行代码 FServiceChargeBear手续费承担方 FServiceChargeNo手续费账号 FServiceChargeBank手续费账号银行 FServiceChargeCurr手续费币别 FCNAPSNumCNAPSNum FCNYTransactType人民币交易种类 FRMBPayMethod人民币付款方式 FByAgentBank通过代理行完成 FAgentBankAcnt代理行账号 FAgentBankName代理行名称 FAgentBankArea代理行国家\地区 FAgentSWIFTCodeSWIFT Code(代理行) FAgentBankAddress代理行地址 FReceiveBankClear收款银行本地清算码 FReceiveBranchClear收款人本地清算分行代码 FClearParameter清算要求参数 FOtherPartyAdress对方地址 FOtherPartyEmail对方邮箱 FOverseaPay境外支付 FLinkRowId关联行ID

钉钉接口明细

• API：topapi/process/instance/comment/add
• NAME：添加审批评论
• METHOD：POST

请求参数

接口字段名称预设值 request请求对象202206170913000567996 request.process_instance_id审批实例IDPROC-C1D46DC7-ACB2-4B63-8C48-F644942F63E5 request.file文件 request.text评论的内容测试写入评论 request.comment_userid评论人的userid133726334231994775

系统对接概况

基于轻易云的连接器和数据服务能力，轻松实现供应链异构系统的“相互沟通”，通过数据应用自动化业务流程管理，全面管控供应链的每一环节。从要货、销售出库、退货入库、到盘点、调拨，无需人工参与，实时更新，自动化流转。通过快速连接金蝶云星空接口抽取数据后再自动分发到钉钉， 解放生产力，自动生成数据、并分发推送到业务应用，数据传递时效性提升10倍以上。