金蝶云星空与金蝶云星空对接集成付款退款单查询打通付款退款单新增

数据源系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

对接目标系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据接口配置方案

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FAFTTAXTOTALAMOUNT应退金额FAFTTAXTOTALAMOUNT应退金额 FID实体主键FID实体主键 FSRCSETTLETYPEID结算方式FSRCSETTLETYPEID结算方式 FBillNo单据编号FBillNo单据编号 FDOCUMENTSTATUS单据状态FDOCUMENTSTATUS单据状态 FREALREFUNDAMOUNT_S本次退款金额FREALREFUNDAMOUNT_S本次退款金额 FCreaterId创建人FCreaterId创建人 FSRCBILLID源单内码FSRCBILLID源单内码 FSRCROWID源单行内码FSRCROWID源单行内码 FCreateDate创建日期FCreateDate创建日期 FSRCSEQ源单行号FSRCSEQ源单行号 FSETTLEORGID结算组织FSETTLEORGID.FNumber结算组织 FApproveDate审核日期FApproveDate审核日期 FPLANREFUNDAMOUNT计划退款金额FPLANREFUNDAMOUNT计划退款金额 FPURCHASEORGID采购组织FPURCHASEORGID.FNumber采购组织 FSRCCURRENCYID源单结算币别FSRCCURRENCYID.FNumber源单结算币别 FSOURCETYPE源单类型FSOURCETYPE源单类型 FEXCHANGETYPE汇率类型FEXCHANGETYPE汇率类型 FSRCBILLNO源单编号FSRCBILLNO源单编号 FMAINBOOKCURRID本位币FMAINBOOKCURRID本位币 FEXPIRY到期日FEXPIRY到期日 FREFUNDTOTALAMOUNT应退金额本位币FREFUNDTOTALAMOUNT应退金额本位币 FPAYPURPOSEID付款用途FPAYPURPOSEID.FNumber付款用途 FDATE业务日期FDATE业务日期 FSRCMATERIALID物料编码FSRCMATERIALID.FNumber物料编码 FCURRENCYID币别FCURRENCYID.FNumber币别 FModifyDate修改日期FModifyDate修改日期 FSRCPURCHASEORDERNO采购订单号FSRCPURCHASEORDERNO采购订单号 FModifierId修改人FModifierId修改人 FEXCHANGERATE汇率FEXCHANGERATE汇率 FSRCMATERIALSEQ采购订单行号FSRCMATERIALSEQ采购订单行号 FWRITTENOFFSTATUS核销状态FWRITTENOFFSTATUS核销状态 FSRCORDERENTRYID采购订单明细内码FSRCORDERENTRYID采购订单明细内码 FSRCPRICEUNITID计价单位FSRCPRICEUNITID计价单位 FBillTypeID单据类型FBillTypeID.FNumber单据类型 FSRCPRICE含税单价FSRCPRICE含税单价 FREFUNDTOTALAMOUNTFOR表头-应退金额FREFUNDTOTALAMOUNTFOR表头-应退金额 FPurchaserId采购员FPurchaserId采购员 FSRCQTY数量FSRCQTY数量 FEXPENSEDEPTID费用承担部门FEXPENSEDEPTID.FNumber费用承担部门 FPurchaserGroupId采购组FPurchaserGroupId采购组 FExpID费用项目FExpID费用项目 FPurchaseDeptId采购部门FPurchaseDeptId采购部门 FAPPROVERID审核人FAPPROVERID审核人 FTaxAmt税额FTaxAmt税额 FPREPAYORDERNO预付采购订单号FPREPAYORDERNO预付采购订单号 FREALREFUNDAMOUNTFOR表头-实退金额FREALREFUNDAMOUNTFOR表头-实退金额 FREALREFUNDAMOUNTMB本次退款金额本位币FREALREFUNDAMOUNTMB本次退款金额本位币 FREALREFUNDAMOUNT实退金额本位币FREALREFUNDAMOUNT实退金额本位币 FSETTLEAMOUNT结算金额FSETTLEAMOUNT结算金额 FACCOUNTSYSTEM会计核算体系FACCOUNTSYSTEM会计核算体系 FCancellerId作废人FCancellerId作废人 FCancelStatus作废状态FCancelStatus作废状态 FCancelDate作废日期FCancelDate作废日期 FCONTACTUNITTYPE往来单位类型FCONTACTUNITTYPE往来单位类型 FCONTACTUNIT往来单位FCONTACTUNIT.FNumber往来单位 FPAYUNITTYPE付款单位类型FPAYUNITTYPE付款单位类型 FPAYUNIT付款单位FPAYUNIT.FNumber付款单位 FSOURCESYSTEM来源系统FSOURCESYSTEM来源系统 FBUSINESSTYPE业务类型FBUSINESSTYPE业务类型 FISINIT是否期初单据FISINIT是否期初单据 FDepartment部门FDepartment.FNumber部门 FPAYORGID付款组织FPAYORGID.FNumber付款组织 FISSAMEORG是否相同组织FISSAMEORG是否相同组织 FSETTLECUR结算币别FSETTLECUR结算币别 FSETTLERATE结算汇率FSETTLERATE结算汇率 FREFUNDAMOUNTFOR_H退款金额FREFUNDAMOUNTFOR_H退款金额 FREFUNDAMOUNT_H表头-退款金额本位币FREFUNDAMOUNT_H表头-退款金额本位币 FIsWriteOff是否转销FIsWriteOff是否转销 FMatchMethodID核销方式FMatchMethodID核销方式 FScanPoint扫描点FScanPoint扫描点 FISFROMALLREFUND是否来源于整单退款FISFROMALLREFUND是否来源于整单退款 FREMARK备注FREMARK备注 FSETTLEMAINBOOKID结算本位币FSETTLEMAINBOOKID.FNumber结算本位币 FSETTLEEXCHANGETYPE结算汇率类型FSETTLEEXCHANGETYPE结算汇率类型 FTHIRDBILLNO第三方单据编号FTHIRDBILLNO第三方单据编号 FWBSETTLENO流水号FWBSETTLENO流水号 FGYACCOUNTWATERID管易财务流水内码FGYACCOUNTWATERID管易财务流水内码 FISCARRYRATE是否下推携带汇率到结算汇率FISCARRYRATE是否下推携带汇率到结算汇率 FGYSHOPNAME管易对应店铺FGYSHOPNAME管易对应店铺 FGYCUSTOMERID管易对应客户FGYCUSTOMERID管易对应客户 FPRESETBASE1预设基础资料字段1FPRESETBASE1预设基础资料字段1 FPRESETBASE2预设基础资料字段2FPRESETBASE2预设基础资料字段2 FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2预设辅助资料字段2 FPRESETTEXT1预设文本字段1FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2FPRESETTEXT2预设文本字段2 FSETTLETYPEID结算方式FSETTLETYPEID.FNumber结算方式 FREFUNDAMOUNTFOR表体-应退金额FREFUNDAMOUNTFOR表体-应退金额 FNOTE备注FNOTE备注 FWRITTENOFFSTATUS_D表体明细-核销状态FWRITTENOFFSTATUS_D表体明细-核销状态 FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额 FOPPOSITECCOUNTNAME对方账户名称FOPPOSITECCOUNTNAME对方账户名称 FOPPOSITEBANKACCOUNT对方银行账号FOPPOSITEBANKACCOUNT对方银行账号 FREFUNDAMOUNT应退金额本位币FREFUNDAMOUNT应退金额本位币 FHANDLINGCHARGEFOR手续费FHANDLINGCHARGEFOR手续费 FREALREFUNDAMOUNTFOR_D表体-实退金额FREALREFUNDAMOUNTFOR_D表体-实退金额 FHANDLINGCHARGE手续费本位币FHANDLINGCHARGE手续费本位币 FREALREFUNDAMOUNT_D实退金额本位币FREALREFUNDAMOUNT_D实退金额本位币 FACCOUNTID我方银行账号FACCOUNTID.FNumber我方银行账号 FACCOUNTNAME我方账户名称FACCOUNTNAME我方账户名称 FSETTLENO结算号FSETTLENO结算号 FBLEND勾对FBLEND勾对 FOPPOSITEBANKNAME对方开户行FOPPOSITEBANKNAME对方开户行 FPURPOSEID原付款用途FPURPOSEID原付款用途 FINNERACCOUNTID内部账号FINNERACCOUNTID内部账号 FINNERACCOUNTNAME内部账户名称FINNERACCOUNTNAME内部账户名称 FCOSTID费用项目FCOSTID.FNumber费用项目 FCashAccount现金账号FCashAccount现金账号 FREFUNDAMOUNTFOR_E退款金额FREFUNDAMOUNTFOR_E退款金额 FREFUNDAMOUNT_E退款金额本位币FREFUNDAMOUNT_E退款金额本位币 FPOSTDATE登账日期FPOSTDATE登账日期 FISPOST是否登账FISPOST是否登账 FPURCHASEORDERNO采购订单号FPURCHASEORDERNO采购订单号（预付订单号） FPURCHASEORDERID采购订单内码FPURCHASEORDERID采购订单内码 FMATERIALID物料编码FMATERIALID.FNumber物料编码 FMATERIALSEQ采购订单行号FMATERIALSEQ采购订单行号 FORDERENTRYID采购订单明细内码FORDERENTRYID采购订单明细内码 FPURCHASEORDERNUMBER采购订单编号FPURCHASEORDERNUMBER采购订单编号（按物料和订单收付） FPRICEUNITID计价单位FPRICEUNITID计价单位 FPRICE含税单价FPRICE含税单价 FQTY数量FQTY数量 FWRITTENOFFAMOUNT已核销金额本位币FWRITTENOFFAMOUNT已核销金额本位币 FGYSALEORDERNO管易销售订单号FGYSALEORDERNO管易销售订单号 FNOTVERIFICATEAMOUNT未核销金额FNOTVERIFICATEAMOUNT未核销金额 FEXPENSEDEPTID_E费用承担部门FEXPENSEDEPTID_E费用承担部门 FREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryID Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 TopRowCount返回总行数金蝶的查询分页参数 FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber FormId业务对象表单IdAP_REFUNDBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FAFTTAXTOTALAMOUNT应退金额应退金额 FID实体主键实体主键 FSRCSETTLETYPEID结算方式结算方式 FBillNo单据编号单据编号 FREALREFUNDAMOUNT_S本次退款金额本次退款金额 FDOCUMENTSTATUS单据状态单据状态 FSRCBILLID源单内码源单内码 FCreaterId创建人创建人 FCreateDate创建日期创建日期 FSRCROWID源单行内码源单行内码 FSETTLEORGID结算组织结算组织 FSRCSEQ源单行号源单行号 FPLANREFUNDAMOUNT计划退款金额计划退款金额 FApproveDate审核日期审核日期 FPURCHASEORGID采购组织采购组织 FSRCCURRENCYID源单结算币别源单结算币别 FEXCHANGETYPE汇率类型汇率类型 FSOURCETYPE源单类型源单类型 FMAINBOOKCURRID本位币本位币 FSRCBILLNO源单编号源单编号 FREFUNDTOTALAMOUNT应退金额本位币应退金额本位币 FEXPIRY到期日到期日 FDATE业务日期业务日期 FPAYPURPOSEID付款用途付款用途 FSRCMATERIALID物料编码物料编码 FCURRENCYID币别币别 FModifyDate修改日期修改日期 FModifierId修改人修改人 FSRCPURCHASEORDERNO采购订单号采购订单号 FEXCHANGERATE汇率汇率 FSRCMATERIALSEQ采购订单行号采购订单行号 FWRITTENOFFSTATUS核销状态核销状态 FSRCORDERENTRYID采购订单明细内码采购订单明细内码 FBillTypeID单据类型单据类型 FSRCPRICEUNITID计价单位计价单位 FSRCPRICE含税单价含税单价 FREFUNDTOTALAMOUNTFOR表头-应退金额表头-应退金额 FPurchaserId采购员采购员 FSRCQTY数量数量 FPurchaserGroupId采购组采购组 FEXPENSEDEPTID费用承担部门费用承担部门 FExpID费用项目费用项目 FPurchaseDeptId采购部门采购部门 FAPPROVERID审核人审核人 FTaxAmt税额税额 FPREPAYORDERNO预付采购订单号预付采购订单号 FREALREFUNDAMOUNTFOR表头-实退金额表头-实退金额 FREALREFUNDAMOUNT实退金额本位币实退金额本位币 FREALREFUNDAMOUNTMB本次退款金额本位币本次退款金额本位币 FSETTLEAMOUNT结算金额结算金额 FACCOUNTSYSTEM会计核算体系会计核算体系 FCancellerId作废人作废人 FCancelStatus作废状态作废状态 FCancelDate作废日期作废日期 FCONTACTUNITTYPE往来单位类型往来单位类型 FCONTACTUNIT往来单位往来单位 FPAYUNITTYPE付款单位类型付款单位类型 FPAYUNIT付款单位付款单位 FSOURCESYSTEM来源系统来源系统 FBUSINESSTYPE业务类型业务类型 FISINIT是否期初单据是否期初单据 FDepartment部门部门 FPAYORGID付款组织付款组织 FISSAMEORG是否相同组织是否相同组织 FSETTLECUR结算币别结算币别 FSETTLERATE结算汇率结算汇率 FREFUNDAMOUNTFOR_H退款金额退款金额 FREFUNDAMOUNT_H表头-退款金额本位币表头-退款金额本位币 FIsWriteOff是否转销是否转销 FMatchMethodID核销方式核销方式 FScanPoint扫描点扫描点 FISFROMALLREFUND是否来源于整单退款是否来源于整单退款 FREMARK备注备注 FSETTLEMAINBOOKID结算本位币结算本位币 FSETTLEEXCHANGETYPE结算汇率类型结算汇率类型 FTHIRDBILLNO第三方单据编号第三方单据编号 FWBSETTLENO流水号流水号 FGYACCOUNTWATERID管易财务流水内码管易财务流水内码 FISCARRYRATE是否下推携带汇率到结算汇率是否下推携带汇率到结算汇率 FGYSHOPNAME管易对应店铺管易对应店铺 FGYCUSTOMERID管易对应客户管易对应客户 FPRESETBASE1预设基础资料字段1预设基础资料字段1 FPRESETBASE2预设基础资料字段2预设基础资料字段2 FPRESETASSISTANT1预设辅助资料字段1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2预设辅助资料字段2 FPRESETTEXT1预设文本字段1预设文本字段1 FPRESETTEXT2预设文本字段2预设文本字段2 FSETTLETYPEID结算方式结算方式 FREFUNDAMOUNTFOR表体-应退金额表体-应退金额 FNOTE备注备注 FWRITTENOFFSTATUS_D表体明细-核销状态表体明细-核销状态 FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额表体明细-已核销金额 FOPPOSITECCOUNTNAME对方账户名称对方账户名称 FOPPOSITEBANKACCOUNT对方银行账号对方银行账号 FREFUNDAMOUNT应退金额本位币应退金额本位币 FHANDLINGCHARGEFOR手续费手续费 FREALREFUNDAMOUNTFOR_D表体-实退金额表体-实退金额 FHANDLINGCHARGE手续费本位币手续费本位币 FREALREFUNDAMOUNT_D实退金额本位币实退金额本位币 FACCOUNTID我方银行账号我方银行账号 FACCOUNTNAME我方账户名称我方账户名称 FSETTLENO结算号结算号 FBLEND勾对勾对 FOPPOSITEBANKNAME对方开户行对方开户行 FPURPOSEID原付款用途原付款用途 FINNERACCOUNTID内部账号内部账号 FINNERACCOUNTNAME内部账户名称内部账户名称 FCOSTID费用项目费用项目 FCashAccount现金账号现金账号 FREFUNDAMOUNTFOR_E退款金额退款金额 FREFUNDAMOUNT_E退款金额本位币退款金额本位币 FPOSTDATE登账日期登账日期 FISPOST是否登账是否登账 FPURCHASEORDERNO采购订单号采购订单号（预付订单号） FPURCHASEORDERID采购订单内码采购订单内码 FMATERIALID物料编码物料编码 FMATERIALSEQ采购订单行号采购订单行号 FORDERENTRYID采购订单明细内码采购订单明细内码 FPURCHASEORDERNUMBER采购订单编号采购订单编号（按物料和订单收付） FPRICEUNITID计价单位计价单位 FPRICE含税单价含税单价 FQTY数量数量 FWRITTENOFFAMOUNT已核销金额本位币已核销金额本位币 FGYSALEORDERNO管易销售订单号管易销售订单号 FNOTVERIFICATEAMOUNT未核销金额未核销金额 FEXPENSEDEPTID_E费用承担部门费用承担部门 FREFUNDBILLENTRY_FEntryIDFREFUNDBILLENTRY_FEntryID

金蝶云星空接口明细

接口：batchSave
接口名称：付款退款单新增
接口方法：POST

请求参数

字段名称类型描述 FBillNo单据编号string FSETTLEORGID结算组织string FEXCHANGETYPE汇率类型string FDATE业务日期string FCURRENCYID币别string FBillTypeID单据类型string FCONTACTUNITTYPE往来单位类型string FCONTACTUNIT往来单位string FPAYUNITTYPE付款单位类型string FPAYUNIT付款单位string FBUSINESSTYPE业务类型string FDepartment部门string FPAYORGID付款组织string FSETTLECUR结算币别string FREMARK备注string FREFUNDBILLENTRY退款单明细array FREFUNDBILLENTRY.FSETTLETYPEID结算方式string FREFUNDBILLENTRY.FREFUNDAMOUNTFOR表体-应退金额string FREFUNDBILLENTRY.FNOTE备注string FREFUNDBILLENTRY.FACCOUNTID我方银行账号string FREFUNDBILLENTRY.FPURPOSEID原付款用途string FREFUNDBILLENTRY.FREFUNDAMOUNTFOR_E退款金额string FREFUNDBILLENTRY.FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder FREFUNDBILLENTRY.Operation执行的操作string FREFUNDBILLENTRY.IsAutoSubmitAndAudit提交并审核bool FREFUNDBILLENTRY.IsVerifyBaseDataField验证基础资料bool是否验证所有的基础资料有效性，布尔类，默认false（非必录）

数据对接效果

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。