金蝶云星空和轻易云集成平台接口打通对接实战

对接源平台:金蝶云星空

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

集成系统:轻易云集成平台

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成

数据接口配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的销售退货查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为轻易云集成平台，并且选择对应连接器。选择对应的写入空操作接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。轻易云数据集成中台提供快速与各种业务系统进行连接的能力，可以将软件接口上线到平台轻松实现数百款应用软件的数据互通。也可以将轻易云的集成能力嵌入到您的软件系统中，将数百款软件的集成能力变成您产品的功能与卖点，扩展额外收入，提升客户成交率，成交金额与满意度。

金蝶云星空接口明细

调用接口：executeBillQuery
接口名称：销售退货查询
方法：POST

请求参数

字段字段名称类型配置值 FID实体主键StringFID FBillNo单据编号StringFBillNo FDocumentStatus单据状态StringFDocumentStatus FSaleOrgId销售组织StringFSaleOrgId FDate日期StringFDate FStockOrgId库存组织StringFStockOrgId FRetcustId退货客户StringFRetcustId FStockerGroupId库存组StringFStockerGroupId FStockerId仓管员StringFStockerId FStockDeptId库存部门StringFStockDeptId FSaleGroupId销售组StringFSaleGroupId FSaledeptid销售部门StringFSaledeptid FSalesManId销售员StringFSalesManId FSettleCustId结算方StringFSettleCustId FPayCustId付款方StringFPayCustId FCreatorId创建人StringFCreatorId FCreateDate创建日期StringFCreateDate FModifierId最后修改人StringFModifierId FModifyDate最后修改日期StringFModifyDate FApproverId审核人StringFApproverId FApproveDate审核日期StringFApproveDate FCancellerId作废人StringFCancellerId FCancelDate作废日期StringFCancelDate FCancelStatus作废状态StringFCancelStatus FBillTypeID单据类型StringFBillTypeID FReceiveCustId收货方StringFReceiveCustId FOwnerTypeIdHead货主类型StringFOwnerTypeIdHead FOwnerIdHead货主StringFOwnerIdHead FBussinessType业务类型StringFBussinessType FReturnReason退货原因StringFReturnReason FReceiveAddress收货方地址StringFReceiveAddress FHeadLocId交货地点StringFHeadLocId FCreditCheckResult信用检查结果StringFCreditCheckResult FTransferBizType跨组织业务类型StringFTransferBizType FCorrespondOrgId对应组织StringFCorrespondOrgId FReceiveCusContact收货方联系人StringFReceiveCusContact FIsInterLegalPerson组织间结算跨法人标识StringFIsInterLegalPerson FHeadNote备注StringFHeadNote FIsTotalServiceOrCost整单服务标识StringFIsTotalServiceOrCost FGenFromPOS_CMK零售单日结生成StringFGenFromPOS_CMK FBranchId销售门店StringFBranchId FSHOPNUMBER网店编码StringFSHOPNUMBER FGYDATE管易退货日期StringFGYDATE FSALECHANNEL销售渠道StringFSALECHANNEL FGYExpressNo管易物流单号StringFGYExpressNo Fentity明细信息ArrayFentity FENTRYID实体主键StringFENTRYID FMaterialId物料编码StringFMaterialId FMaterialName物料名称StringFMaterialName FMaterialModel规格型号StringFMaterialModel FMaterialType物料类别StringFMaterialType FUnitID库存单位StringFUnitID FMustqty应退数量StringFMustqty FRealQty实退数量StringFRealQty FStockId仓库StringFStockId FStockstatusId库存状态StringFStockstatusId FOwnerTypeId货主类型StringFOwnerTypeId FOwnerId货主StringFOwnerId FKeeperTypeId保管者类型StringFKeeperTypeId FKeeperId保管者StringFKeeperId FBOMIdBOM版本StringFBOMId FAuxpropId辅助属性StringFAuxpropId FProduceDate生产日期StringFProduceDate FExpiryDate有效期至StringFExpiryDate FBaseunitId基本单位StringFBaseunitId FBaseunitQty库存基本数量StringFBaseunitQty FAuxUnitId库存辅单位StringFAuxUnitId FAuxUnitQty库存辅单位数量StringFAuxUnitQty FCostPrice成本价（本位币）StringFCostPrice FEntryCostAmount总成本StringFEntryCostAmount FOrderNo订单单号StringFOrderNo FNote备注StringFNote FInvoicedQty关联应收数量（计价）StringFInvoicedQty FBaseInvoicedQty(作废)关联开票数量(基本单位)StringFBaseInvoicedQty FSumInvoicedQty累计应收数量（销售）StringFSumInvoicedQty FSumInvoicedAmt(作废)累计开票金额StringFSumInvoicedAmt FSumRecievedAmt累计收款金额StringFSumRecievedAmt FStockFlag库存更新标示StringFStockFlag FSrcBillTypeID源单类型StringFSrcBillTypeID FExpUnit保质期单位StringFExpUnit FExpPeriod保质期StringFExpPeriod FStocklocId仓位StringFStocklocId FF100001仓位StringFF100001 FMapId客户物料编码StringFMapId FMapName客户物料名称StringFMapName FLot批号StringFLot FReturnType退货类型StringFReturnType FBaseSumInvoicedQty(作废)累计开票数量(基本单位)StringFBaseSumInvoicedQty FCostAmount_LC总成本（本位币）StringFCostAmount_LC FPriceUnitId计价单位StringFPriceUnitId FPriceUnitQty计价数量StringFPriceUnitQty FPrice单价StringFPrice FTaxPrice含税单价StringFTaxPrice FTaxCombination税组合StringFTaxCombination FEntryTaxRate税率%StringFEntryTaxRate FPriceCoefficient价格系数StringFPriceCoefficient FSysPrice系统定价StringFSysPrice FLimitDownPrice最低限价StringFLimitDownPrice FBefDisAmt折前金额StringFBefDisAmt FBefDisAllAmt折前价税合计StringFBefDisAllAmt FDiscountRate折扣率%StringFDiscountRate FDiscount折扣额StringFDiscount FAmount金额StringFAmount FAmount_LC金额（本位币）StringFAmount_LC FEntryTaxAmount税额StringFEntryTaxAmount FTaxAmount_LC税额（本位币）StringFTaxAmount_LC FAllAmount价税合计StringFAllAmount FAllAmount_LC价税合计（本位币）StringFAllAmount_LC FIsFree是否赠品StringFIsFree FTaxNetPrice净价StringFTaxNetPrice FDeliveryDate退货日期StringFDeliveryDate FBaseARJoinQty关联应收数量（计价基本）StringFBaseARJoinQty FBFLowId业务流程StringFBFLowId FBASEARQTY累计应收数量（销售基本）StringFBASEARQTY FARJOINAMOUNT关联应收金额StringFARJOINAMOUNT FARAMOUNT累计应收金额StringFARAMOUNT FSalCostPrice销售成本价StringFSalCostPrice FSrcBillNo源单编号StringFSrcBillNo FSOBILLTYPEID订单类型StringFSOBILLTYPEID FSNUnitID序列号单位StringFSNUnitID FSNQty序列号单位数量StringFSNQty FMtoNo计划跟踪号StringFMtoNo FProjectNo项目编号StringFProjectNo FRefuseFlag拒收标志StringFRefuseFlag FISCONSUMESUM消耗汇总StringFISCONSUMESUM FExtAuxUnitId辅单位StringFExtAuxUnitId FExtAuxUnitQty实退数量（辅单位）StringFExtAuxUnitQty FInventoryQty当前库存StringFInventoryQty FPriceBaseQty计价基本数量StringFPriceBaseQty FSalUnitID销售单位StringFSalUnitID FSalUnitQty销售数量StringFSalUnitQty FSalBaseQty销售基本数量StringFSalBaseQty FQualifyType质量类型StringFQualifyType FSalBaseNum销售基本分子StringFSalBaseNum FStockBaseDen库存基本分母StringFStockBaseDen FStockBaseARJoinQty关联应收数量（库存基本）StringFStockBaseARJoinQty FSRCBIZUNITID携带的主业务单位StringFSRCBIZUNITID FEOwnerSupplierId明细货主供应商StringFEOwnerSupplierId FIsOverLegalOrg组织间结算跨法人标识StringFIsOverLegalOrg FESettleCustomerId明细结算组织客户StringFESettleCustomerId FSalBaseARJoinQty关联应收数量（销售基本）StringFSalBaseARJoinQty FPriceListEntry行价目表StringFPriceListEntry FARNOTJOINQTY未关联应收数量（计价单位）StringFARNOTJOINQTY FSOEntryId销售订单EntryIdStringFSOEntryId FIsReturnCheck退货检验StringFIsReturnCheck FRowType产品类型StringFRowType FParentMatId父项产品StringFParentMatId FRowId行标识StringFRowId FParentRowId父行标识StringFParentRowId FThirdEntryId管易订单单号StringFThirdEntryId FETHIRDBILLID第三方单据IDStringFETHIRDBILLID FETHIRDBILLNO第三方单据编号StringFETHIRDBILLNO FServiceContext服务上下文StringFServiceContext FProPrice门店供货价StringFProPrice FProAmount供货金额StringFProAmount FBarcode零售条形码StringFBarcode FGYFINSTATUS管易是否到账StringFGYFINSTATUS FGYFINDate管易到账时间StringFGYFINDate FPriceDiscount单价折扣StringFPriceDiscount FTailDiffFlag尾差处理标识StringFTailDiffFlag FWRITEOFFPRICEBASEQTY冲销数量(计价基本)StringFWRITEOFFPRICEBASEQTY FWRITEOFFSALEBASEQTY冲销数量(销售基本)StringFWRITEOFFSALEBASEQTY FWRITEOFFSTOCKBASEQTY冲销数量(库存基本)StringFWRITEOFFSTOCKBASEQTY FWRITEOFFAMOUNT冲销金额StringFWRITEOFFAMOUNT FSettleBySon按子项结算StringFSettleBySon FBOMEntryIdBOM分录内码StringFBOMEntryId F_out_id外部IDStringF_out_id F_out_no外部编码StringF_out_no F_out_type外部业务类型StringF_out_type F_ZHHB_Text开户单号StringF_ZHHB_Text FEntity_FENTRYIDFEntity_FENTRYIDstringFEntity_FENTRYID Limit最大行数string{{PAGINATION_PAGE_SIZE}} StartRow开始行索引string{{PAGINATION_START_ROW}} TopRowCount返回总行数int FilterString过滤条件stringFApproveDate>='{{LAST_SYNC_TIME dateTime}}' FieldKeys需查询的字段key集合array FormId业务对象表单IdstringSAL_RETURNSTOCK

响应参数

轻易云集成平台接口明细

接口：写入空操作
接口名称：写入空操作
接口方法：POST

数据对接效果

从API服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

金蝶云星空和轻易云集成平台接口打通对接实战