金蝶云星空和金蝶云星空单据接口对接

来源系统:金蝶云星空

金蝶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

请求参数

接口字段字段名称预设值描述 FID实体主键FID FBillNo单据编号FBillNo FDOCUMENTSTATUS单据状态FDOCUMENTSTATUS FCreatorId创建人FCreatorId FAPPROVERID审核人FAPPROVERID FCreateDate创建日期FCreateDate FSETTLEORGID结算组织FSETTLEORGID.FNumber FApproveDate审核日期FApproveDate FSALEORGID销售组织FSALEORGID.FNumber FEXCHANGETYPE汇率类型FEXCHANGETYPE FRECEIVEAMOUNTFOR_H表头-应收金额FRECEIVEAMOUNTFOR_H FMAINBOOKCURID本位币FMAINBOOKCURID FRECEIVEAMOUNT_H表头-应收金额本位币FRECEIVEAMOUNT_H FCURRENCYID币别FCURRENCYID.FNumber FDATE业务日期FDATE FModifyDate修改日期FModifyDate FModifierId修改人FModifierId FEXCHANGERATE汇率FEXCHANGERATE FWRITTENOFFSTATUS核销状态FWRITTENOFFSTATUS FSALEERID销售员FSALEERID.FNumber FSALEGROUPID销售组FSALEGROUPID.FNumber FSALEDEPTID销售部门FSALEDEPTID.FNumber FBillTypeID单据类型FBillTypeID.FNumber FREALRECAMOUNTFOR表头-实收金额FREALRECAMOUNTFOR FREALRECAMOUNT_H表头-实收金额本位币FREALRECAMOUNT_H FACCOUNTSYSTEM会计核算体系FACCOUNTSYSTEM FCancelDate作废日期FCancelDate FCancelStatus作废状态FCancelStatus FCancellerId作废人FCancellerId FCONTACTUNITTYPE往来单位类型FCONTACTUNITTYPE FCONTACTUNIT往来单位FCONTACTUNIT.FNumber FPAYUNITTYPE付款单位类型FPAYUNITTYPE FPAYUNIT付款单位FPAYUNIT.FNumber FBUSINESSTYPE业务类型FBUSINESSTYPE FCreditCheckResult信用检查结果FCreditCheckResult FISINIT是否期初单据FISINIT FDepartment部门FDepartment FPAYORGID收款组织FPAYORGID.FNumber FIsSameOrg是否相同组织FIsSameOrg FSOURCESYSTEM来源系统FSOURCESYSTEM FCASHSALE现销FCASHSALE FSETTLECUR结算币别FSETTLECUR FSETTLERATE结算汇率FSETTLERATE FRECAMOUNTFOR收款金额FRECAMOUNTFOR FRECAMOUNT表头-收款金额本位币FRECAMOUNT FISB2CB2C业务FISB2C FWBSETTLENO流水号/对账码FWBSETTLENO FIsWriteOff是否转销FIsWriteOff FMatchMethodID核销方式FMatchMethodID FScanPoint扫描点FScanPoint FKDPAYNO金蝶支付流水号FKDPAYNO FREMARK备注FREMARK FTHIRDBILLNO第三方单据编号FTHIRDBILLNO FSETTLEMAINBOOKID结算本位币FSETTLEMAINBOOKID FSETTLEEXCHANGETYPE结算汇率类型FSETTLEEXCHANGETYPE FOUTCONTACTID转出往来单位FOUTCONTACTID FOUTCONTACTTYPE转出往来单位类型FOUTCONTACTTYPE FGYACCOUNTWATERID管易财务流水内码FGYACCOUNTWATERID FISCARRYRATE是否下推携带汇率到结算汇率FISCARRYRATE FPRESETBASE1预设基础资料字段1FPRESETBASE1 FPRESETBASE2预设基础资料字段2FPRESETBASE2 FPRESETASSISTANT1预设辅助资料字段1FPRESETASSISTANT1 FPRESETASSISTANT2预设辅助资料字段2FPRESETASSISTANT2 FPRESETTEXT1预设文本字段1FPRESETTEXT1 FPRESETTEXT2预设文本字段2FPRESETTEXT2 FISFROMSALORDER来源销售订单下推FISFROMSALORDER FVirIsSameAcctOrg是否同一核算组织FVirIsSameAcctOrg FSETTLETYPEID结算方式FSETTLETYPEID FSETTLERECAMOUNTFOR折后金额FSETTLERECAMOUNTFOR FSETTLEDISTAMOUNTFOR现金折扣FSETTLEDISTAMOUNTFOR FRECTOTALAMOUNTFOR表体-应收金额FRECTOTALAMOUNTFOR FSETTLERECAMOUNT折后金额本位币FSETTLERECAMOUNT FSETTLEDISTAMOUNT现金折扣本位币FSETTLEDISTAMOUNT FRECTOTALAMOUNT表体-应收金额本位币FRECTOTALAMOUNT FWRITTENOFFSTATUS_D表体明细-核销状态FWRITTENOFFSTATUS_D FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额FWRITTENOFFAMOUNTFOR_D FCOMMENT备注FCOMMENT FOPPOSITEBANKACCOUNT对方银行账号FOPPOSITEBANKACCOUNT FOPPOSITECCOUNTNAME对方账户名称FOPPOSITECCOUNTNAME FRECEIVEITEM预收销售订单FRECEIVEITEM FHANDLINGCHARGEFOR手续费FHANDLINGCHARGEFOR FHANDLINGCHARGE手续费本位币FHANDLINGCHARGE FREALRECAMOUNTFOR_D表体-实收金额FREALRECAMOUNTFOR_D FREALRECAMOUNT_D表体-实收金额本位币FREALRECAMOUNT_D FASSTOTALAMOUNTFOR关联总金额FASSTOTALAMOUNTFOR FRECEIVEITEMTYPE预收项目类型FRECEIVEITEMTYPE FSaleOrderID预收销售订单号内码FSaleOrderID FACCOUNTID我方银行账号FACCOUNTID.FNumber FOVERUNDERAMOUNTFOR长短款FOVERUNDERAMOUNTFOR FOPPOSITEBANKNAME对方开户行FOPPOSITEBANKNAME FSETTLENO结算号FSETTLENO FBLEND勾对FBLEND FPURPOSEID收款用途FPURPOSEID.FNumber FOVERUNDERAMOUNT长短款本位币FOVERUNDERAMOUNT FINNERACCOUNTID内部账号FINNERACCOUNTID FINNERACCOUNTNAME内部账户名称FINNERACCOUNTNAME FReFundAmount退款关联金额FReFundAmount FCashAccount现金账号FCashAccount FRECAMOUNTFOR_E收款金额FRECAMOUNTFOR_E FRECAMOUNT_E收款金额本位币FRECAMOUNT_E FPOSTDATE登账日期FPOSTDATE FISPOST是否登账FISPOST FMATERIALID物料编码FMATERIALID.FNumber FMATERIALNAME物料名称FMATERIALNAME FSALEORDERNO销售订单号FSALEORDERNO FMATERIALSEQ订单行号FMATERIALSEQ FORDERENTRYID销售订单明细内码FORDERENTRYID FTOPAYMENTAMOUNTFOR保证金转货款金额FTOPAYMENTAMOUNTFOR FWRITTENOFFAMOUNT已核销金额本位币FWRITTENOFFAMOUNT FNOTVERIFICATEAMOUNT未核销金额FNOTVERIFICATEAMOUNT FPRICEUNITID计价单位FPRICEUNITID FPrice含税单价FPrice FQty数量FQty FCOSTID费用项目FCOSTID.FNumber FCOSTDEPARTMENTID费用承担部门FCOSTDEPARTMENTID.FNumber FCOSTNAME费用项目名称FCOSTNAME FLinkRowId关联行IDFLinkRowId FSALEORDERBase销售订单（基础资料）FSALEORDERBase FRECEIVEBILLSRCENTRY_FEntryIDFRECEIVEBILLSRCENTRY_FEntryIDFRECEIVEBILLSRCENTRY_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业务对象表单IdAR_RECEIVEBILL必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

接口字段字段名称预设值描述 FID实体主键 FBillNo单据编号 FDOCUMENTSTATUS单据状态 FCreatorId创建人 FAPPROVERID审核人 FCreateDate创建日期 FSETTLEORGID结算组织 FApproveDate审核日期 FSALEORGID销售组织 FEXCHANGETYPE汇率类型 FRECEIVEAMOUNTFOR_H表头-应收金额 FMAINBOOKCURID本位币 FRECEIVEAMOUNT_H表头-应收金额本位币 FCURRENCYID币别 FDATE业务日期 FModifyDate修改日期 FModifierId修改人 FEXCHANGERATE汇率 FWRITTENOFFSTATUS核销状态 FSALEERID销售员 FSALEGROUPID销售组 FSALEDEPTID销售部门 FBillTypeID单据类型 FREALRECAMOUNTFOR表头-实收金额 FREALRECAMOUNT_H表头-实收金额本位币 FACCOUNTSYSTEM会计核算体系 FCancelDate作废日期 FCancelStatus作废状态 FCancellerId作废人 FCONTACTUNITTYPE往来单位类型 FCONTACTUNIT往来单位 FPAYUNITTYPE付款单位类型 FPAYUNIT付款单位 FBUSINESSTYPE业务类型 FCreditCheckResult信用检查结果 FISINIT是否期初单据 FDepartment部门 FPAYORGID收款组织 FIsSameOrg是否相同组织 FSOURCESYSTEM来源系统 FCASHSALE现销 FSETTLECUR结算币别 FSETTLERATE结算汇率 FRECAMOUNTFOR收款金额 FRECAMOUNT表头-收款金额本位币 FISB2CB2C业务 FWBSETTLENO流水号/对账码 FIsWriteOff是否转销 FMatchMethodID核销方式 FScanPoint扫描点 FKDPAYNO金蝶支付流水号 FREMARK备注 FTHIRDBILLNO第三方单据编号 FSETTLEMAINBOOKID结算本位币 FSETTLEEXCHANGETYPE结算汇率类型 FOUTCONTACTID转出往来单位 FOUTCONTACTTYPE转出往来单位类型 FGYACCOUNTWATERID管易财务流水内码 FISCARRYRATE是否下推携带汇率到结算汇率 FPRESETBASE1预设基础资料字段1 FPRESETBASE2预设基础资料字段2 FPRESETASSISTANT1预设辅助资料字段1 FPRESETASSISTANT2预设辅助资料字段2 FPRESETTEXT1预设文本字段1 FPRESETTEXT2预设文本字段2 FISFROMSALORDER来源销售订单下推 FVirIsSameAcctOrg是否同一核算组织 FSETTLETYPEID结算方式 FSETTLERECAMOUNTFOR折后金额 FSETTLEDISTAMOUNTFOR现金折扣 FRECTOTALAMOUNTFOR表体-应收金额 FSETTLERECAMOUNT折后金额本位币 FSETTLEDISTAMOUNT现金折扣本位币 FRECTOTALAMOUNT表体-应收金额本位币 FWRITTENOFFSTATUS_D表体明细-核销状态 FWRITTENOFFAMOUNTFOR_D表体明细-已核销金额 FCOMMENT备注 FOPPOSITEBANKACCOUNT对方银行账号 FOPPOSITECCOUNTNAME对方账户名称 FRECEIVEITEM预收销售订单 FHANDLINGCHARGEFOR手续费 FHANDLINGCHARGE手续费本位币 FREALRECAMOUNTFOR_D表体-实收金额 FREALRECAMOUNT_D表体-实收金额本位币 FASSTOTALAMOUNTFOR关联总金额 FRECEIVEITEMTYPE预收项目类型 FSaleOrderID预收销售订单号内码 FACCOUNTID我方银行账号 FOVERUNDERAMOUNTFOR长短款 FOPPOSITEBANKNAME对方开户行 FSETTLENO结算号 FBLEND勾对 FPURPOSEID收款用途 FOVERUNDERAMOUNT长短款本位币 FINNERACCOUNTID内部账号 FINNERACCOUNTNAME内部账户名称 FReFundAmount退款关联金额 FCashAccount现金账号 FRECAMOUNTFOR_E收款金额 FRECAMOUNT_E收款金额本位币 FPOSTDATE登账日期 FISPOST是否登账 FMATERIALID物料编码 FMATERIALNAME物料名称 FSALEORDERNO销售订单号 FMATERIALSEQ订单行号 FORDERENTRYID销售订单明细内码 FTOPAYMENTAMOUNTFOR保证金转货款金额 FWRITTENOFFAMOUNT已核销金额本位币 FNOTVERIFICATEAMOUNT未核销金额 FPRICEUNITID计价单位 FPrice含税单价 FQty数量 FCOSTID费用项目 FCOSTDEPARTMENTID费用承担部门 FCOSTNAME费用项目名称 FLinkRowId关联行ID FSALEORDERBase销售订单（基础资料） FRECEIVEBILLSRCENTRY_FEntryIDFRECEIVEBILLSRCENTRY_FEntryID

金蝶云星空接口明细

调用接口：batchSave
接口名称：收款单新增
方法：POST

请求参数

字段字段名称类型配置值 FBillNo单据编号string{{FBillNo}}测试 FDOCUMENTSTATUS单据状态string{{FDOCUMENTSTATUS}} FSETTLEORGID结算组织string{{FSETTLEORGID}} FEXCHANGETYPE汇率类型stringHLTX01_SYS FCURRENCYID币别string{{FCURRENCYID}} FDATE业务日期string2022-04-18 00:16:23 FBillTypeID单据类型stringSKDLX02_SYS FCancelStatus作废状态string{{FCancelStatus}} FCONTACTUNITTYPE往来单位类型string{{FCONTACTUNITTYPE}} FCONTACTUNIT往来单位string{{FCONTACTUNIT}} FPAYUNITTYPE付款单位类型string{{FPAYUNITTYPE}} FPAYUNIT付款单位string{{FPAYUNIT}} FBUSINESSTYPE业务类型string{{FBUSINESSTYPE}} FPAYORGID收款组织string{{FPAYORGID}} FSETTLECUR结算币别stringPRE001 FRECEIVEBILLENTRY收款单明细array FRECEIVEBILLENTRY.FSETTLETYPEID结算方式stringJSFS01_SYS FRECEIVEBILLENTRY.FRECTOTALAMOUNTFOR表体-应收金额string{{FRECTOTALAMOUNTFOR}} FRECEIVEBILLENTRY.FACCOUNTID我方银行账号string{{FACCOUNTID}} FRECEIVEBILLENTRY.FPURPOSEID收款用途string{{FPURPOSEID}} FRECEIVEBILLENTRY.FPOSTDATE1登账日期string FRECEIVEBILLENTRY.FormId业务对象表单IdstringAR_RECEIVEBILL FRECEIVEBILLENTRY.Operation执行的操作stringBatchSave FRECEIVEBILLENTRY.IsAutoSubmitAndAudit提交并审核booltrue FRECEIVEBILLENTRY.IsVerifyBaseDataField验证基础资料boolfalse

系统集成总览

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向金蝶云星空、金蝶云星空间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。

金蝶云星空和金蝶云星空单据接口对接