金蝶云星空与旺店通·企业奇门对接集成销售退货查询打通创建退货入库单

接入系统：金蝶云星空

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

对接目标系统:旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

多系统对接方案配置

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的销售退货查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为旺店通·企业奇门，并且选择对应连接器。选择对应的创建退货入库单接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

API：executeBillQuery
NAME：销售退货查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 FID实体主键FID FBillNo单据编号FBillNo FDocumentStatus单据状态FDocumentStatus FSaleOrgId销售组织FSaleOrgId FDate日期FDate FStockOrgId库存组织FStockOrgId FRetcustId退货客户FRetcustId FStockerGroupId库存组FStockerGroupId FStockerId仓管员FStockerId FStockDeptId库存部门FStockDeptId FSaleGroupId销售组FSaleGroupId FSaledeptid销售部门FSaledeptid FSalesManId销售员FSalesManId FSettleCustId结算方FSettleCustId FPayCustId付款方FPayCustId FCreatorId创建人FCreatorId FCreateDate创建日期FCreateDate FModifierId最后修改人FModifierId FModifyDate最后修改日期FModifyDate FApproverId审核人FApproverId FApproveDate审核日期FApproveDate FCancellerId作废人FCancellerId FCancelDate作废日期FCancelDate FCancelStatus作废状态FCancelStatus FBillTypeID单据类型FBillTypeID FReceiveCustId收货方FReceiveCustId FOwnerTypeIdHead货主类型FOwnerTypeIdHead FOwnerIdHead货主FOwnerIdHead FBussinessType业务类型FBussinessType FReturnReason退货原因FReturnReason FReceiveAddress收货方地址FReceiveAddress FHeadLocId交货地点FHeadLocId FCreditCheckResult信用检查结果FCreditCheckResult FTransferBizType跨组织业务类型FTransferBizType FCorrespondOrgId对应组织FCorrespondOrgId FReceiveCusContact收货方联系人FReceiveCusContact FIsInterLegalPerson组织间结算跨法人标识FIsInterLegalPerson FHeadNote备注FHeadNote FIsTotalServiceOrCost整单服务标识FIsTotalServiceOrCost FGenFromPOS_CMK零售单日结生成FGenFromPOS_CMK FBranchId销售门店FBranchId FSHOPNUMBER网店编码FSHOPNUMBER FGYDATE管易退货日期FGYDATE FSALECHANNEL销售渠道FSALECHANNEL FGYExpressNo管易物流单号FGYExpressNo Fentity明细信息 Fentity.FENTRYID实体主键FENTRYID Fentity.FMaterialId物料编码FMaterialId Fentity.FMaterialName物料名称FMaterialName Fentity.FMaterialModel规格型号FMaterialModel Fentity.FMaterialType物料类别FMaterialType Fentity.FUnitID库存单位FUnitID Fentity.FMustqty应退数量FMustqty Fentity.FRealQty实退数量FRealQty Fentity.FStockId仓库FStockId Fentity.FStockstatusId库存状态FStockstatusId Fentity.FOwnerTypeId货主类型FOwnerTypeId Fentity.FOwnerId货主FOwnerId Fentity.FKeeperTypeId保管者类型FKeeperTypeId Fentity.FKeeperId保管者FKeeperId Fentity.FBOMIdBOM版本FBOMId Fentity.FAuxpropId辅助属性FAuxpropId Fentity.FProduceDate生产日期FProduceDate Fentity.FExpiryDate有效期至FExpiryDate Fentity.FBaseunitId基本单位FBaseunitId Fentity.FBaseunitQty库存基本数量FBaseunitQty Fentity.FAuxUnitId库存辅单位FAuxUnitId Fentity.FAuxUnitQty库存辅单位数量FAuxUnitQty Fentity.FCostPrice成本价（本位币）FCostPrice Fentity.FEntryCostAmount总成本FEntryCostAmount Fentity.FOrderNo订单单号FOrderNo Fentity.FNote备注FNote Fentity.FInvoicedQty关联应收数量（计价）FInvoicedQty Fentity.FBaseInvoicedQty(作废)关联开票数量(基本单位)FBaseInvoicedQty Fentity.FSumInvoicedQty累计应收数量（销售）FSumInvoicedQty Fentity.FSumInvoicedAmt(作废)累计开票金额FSumInvoicedAmt Fentity.FSumRecievedAmt累计收款金额FSumRecievedAmt Fentity.FStockFlag库存更新标示FStockFlag Fentity.FSrcBillTypeID源单类型FSrcBillTypeID Fentity.FExpUnit保质期单位FExpUnit Fentity.FExpPeriod保质期FExpPeriod Fentity.FStocklocId仓位FStocklocId Fentity.FF100001仓位FF100001 Fentity.FMapId客户物料编码FMapId Fentity.FMapName客户物料名称FMapName Fentity.FLot批号FLot Fentity.FReturnType退货类型FReturnType Fentity.FBaseSumInvoicedQty(作废)累计开票数量(基本单位)FBaseSumInvoicedQty Fentity.FCostAmount_LC总成本（本位币）FCostAmount_LC Fentity.FPriceUnitId计价单位FPriceUnitId Fentity.FPriceUnitQty计价数量FPriceUnitQty Fentity.FPrice单价FPrice Fentity.FTaxPrice含税单价FTaxPrice Fentity.FTaxCombination税组合FTaxCombination Fentity.FEntryTaxRate税率%FEntryTaxRate Fentity.FPriceCoefficient价格系数FPriceCoefficient Fentity.FSysPrice系统定价FSysPrice Fentity.FLimitDownPrice最低限价FLimitDownPrice Fentity.FBefDisAmt折前金额FBefDisAmt Fentity.FBefDisAllAmt折前价税合计FBefDisAllAmt Fentity.FDiscountRate折扣率%FDiscountRate Fentity.FDiscount折扣额FDiscount Fentity.FAmount金额FAmount Fentity.FAmount_LC金额（本位币）FAmount_LC Fentity.FEntryTaxAmount税额FEntryTaxAmount Fentity.FTaxAmount_LC税额（本位币）FTaxAmount_LC Fentity.FAllAmount价税合计FAllAmount Fentity.FAllAmount_LC价税合计（本位币）FAllAmount_LC Fentity.FIsFree是否赠品FIsFree Fentity.FTaxNetPrice净价FTaxNetPrice Fentity.FDeliveryDate退货日期FDeliveryDate Fentity.FBaseARJoinQty关联应收数量（计价基本）FBaseARJoinQty Fentity.FBFLowId业务流程FBFLowId Fentity.FBASEARQTY累计应收数量（销售基本）FBASEARQTY Fentity.FARJOINAMOUNT关联应收金额FARJOINAMOUNT Fentity.FARAMOUNT累计应收金额FARAMOUNT Fentity.FSalCostPrice销售成本价FSalCostPrice Fentity.FSrcBillNo源单编号FSrcBillNo Fentity.FSOBILLTYPEID订单类型FSOBILLTYPEID Fentity.FSNUnitID序列号单位FSNUnitID Fentity.FSNQty序列号单位数量FSNQty Fentity.FMtoNo计划跟踪号FMtoNo Fentity.FProjectNo项目编号FProjectNo Fentity.FRefuseFlag拒收标志FRefuseFlag Fentity.FISCONSUMESUM消耗汇总FISCONSUMESUM Fentity.FExtAuxUnitId辅单位FExtAuxUnitId Fentity.FExtAuxUnitQty实退数量（辅单位）FExtAuxUnitQty Fentity.FInventoryQty当前库存FInventoryQty Fentity.FPriceBaseQty计价基本数量FPriceBaseQty Fentity.FSalUnitID销售单位FSalUnitID Fentity.FSalUnitQty销售数量FSalUnitQty Fentity.FSalBaseQty销售基本数量FSalBaseQty Fentity.FQualifyType质量类型FQualifyType Fentity.FSalBaseNum销售基本分子FSalBaseNum Fentity.FStockBaseDen库存基本分母FStockBaseDen Fentity.FStockBaseARJoinQty关联应收数量（库存基本）FStockBaseARJoinQty Fentity.FSRCBIZUNITID携带的主业务单位FSRCBIZUNITID Fentity.FEOwnerSupplierId明细货主供应商FEOwnerSupplierId Fentity.FIsOverLegalOrg组织间结算跨法人标识FIsOverLegalOrg Fentity.FESettleCustomerId明细结算组织客户FESettleCustomerId Fentity.FSalBaseARJoinQty关联应收数量（销售基本）FSalBaseARJoinQty Fentity.FPriceListEntry行价目表FPriceListEntry Fentity.FARNOTJOINQTY未关联应收数量（计价单位）FARNOTJOINQTY Fentity.FSOEntryId销售订单EntryIdFSOEntryId Fentity.FIsReturnCheck退货检验FIsReturnCheck Fentity.FRowType产品类型FRowType Fentity.FParentMatId父项产品FParentMatId Fentity.FRowId行标识FRowId Fentity.FParentRowId父行标识FParentRowId Fentity.FThirdEntryId管易订单单号FThirdEntryId Fentity.FETHIRDBILLID第三方单据IDFETHIRDBILLID Fentity.FETHIRDBILLNO第三方单据编号FETHIRDBILLNO Fentity.FServiceContext服务上下文FServiceContext Fentity.FProPrice门店供货价FProPrice Fentity.FProAmount供货金额FProAmount Fentity.FBarcode零售条形码FBarcode Fentity.FGYFINSTATUS管易是否到账FGYFINSTATUS Fentity.FGYFINDate管易到账时间FGYFINDate Fentity.FPriceDiscount单价折扣FPriceDiscount Fentity.FTailDiffFlag尾差处理标识FTailDiffFlag Fentity.FWRITEOFFPRICEBASEQTY冲销数量(计价基本)FWRITEOFFPRICEBASEQTY Fentity.FWRITEOFFSALEBASEQTY冲销数量(销售基本)FWRITEOFFSALEBASEQTY Fentity.FWRITEOFFSTOCKBASEQTY冲销数量(库存基本)FWRITEOFFSTOCKBASEQTY Fentity.FWRITEOFFAMOUNT冲销金额FWRITEOFFAMOUNT Fentity.FSettleBySon按子项结算FSettleBySon Fentity.FBOMEntryIdBOM分录内码FBOMEntryId Fentity.F_out_id外部IDF_out_id Fentity.F_out_no外部编码F_out_no Fentity.F_out_type外部业务类型F_out_type Fentity.F_ZHHB_Text开户单号F_ZHHB_Text Fentity.Limit最大行数{{PAGINATION_PAGE_SIZE}}金蝶的查询分页参数 Fentity.StartRow开始行索引{{PAGINATION_START_ROW}}金蝶的查询分页参数 Fentity.TopRowCount返回总行数金蝶的查询分页参数 Fentity.FilterString过滤条件FApproveDate>='{{LAST_SYNC_TIME dateTime}}'示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= Fentity.FieldKeys需查询的字段key集合金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber Fentity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder

响应参数

旺店通·企业奇门接口明细

接口：batchSave
接口名称：创建退货入库单
接口方法：POST

请求参数

字段名称类型描述 FBillTypeID单据类型string单据类型 FBillNo单据编号string单据编号 FSaleOrgId销售组织string组织 FDate日期string日期 FStockOrgId库存组织string组织 FRetcustId退货客户string基础资料 FSaledeptid销售部门string基础资料 FHeadNote备注string多行文本 FEntity明细信息array FEntity.FMaterialId物料编码string基础资料 FEntity.FBarcode零售条形码string文本 FEntity.FRealQty实退数量string数量 FEntity.FAllAmount价税合计string单价 FEntity.FIsFree是否赠品string复选框 FEntity.FEntryTaxRate税率%string小数 FEntity.FReturnType退货类型string单选辅助资料列表 FEntity.FOwnerTypeId货主类型string多类别基础资料列表 FEntity.FOwnerId货主string多类别基础资料 FEntity.FStockId仓库string基础资料 FEntity.FStocklocId仓位string维度关联字段 FEntity.FLot批号string批次 FEntity.FDeliveryDate退货日期string长日期 FEntity.FNote备注string文本 FEntity.FSRCTYPE源单类型string FEntity.FSRCBillNo源单编号string FEntity.FSoorDerno订单单号string文本 FEntity.FEntity_Link关联关系表array FEntity.FEntity_Link.FEntity_Link_FRuleId转换规则string FEntity.FEntity_Link.FEntity_Link_FSTableName源单表string FEntity.FEntity_Link.FEntity_Link_FSBillId源单内码string FEntity.FEntity_Link.FEntity_Link_FSId源单分录内码string FEntity.SubHeadEntity财务信息object FEntity.SubHeadEntity.FSettleOrgId结算组织string组织 FEntity.SubHeadEntity.FSettleCurrId结算币别string基础资料 FEntity.SubHeadEntity.FormId业务对象表单Idstring必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作string FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核bool FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料bool是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId系统模块string默认仓库模块

系统对接概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到旺店通·企业奇门之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

金蝶云星空与旺店通·企业奇门对接集成销售退货查询打通创建退货入库单