从金蝶云星空到金蝶云星空通过接口配置打通数据

对接系统金蝶云星空

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

接通系统：金蝶云星空

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

系统对接接口配置

在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用

金蝶云星空接口明细

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

响应参数

金蝶云星空接口明细

API：batchSave
NAME：销售退货新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型XSTHD01_SYS单据类型 FBillNo单据编号单据编号 FSaleOrgId销售组织组织 FDate日期日期 FStockOrgId库存组织组织 FRetcustId退货客户基础资料 FSaledeptid销售部门基础资料 FSettleCurrId结算币别基础资料 FBranchId销售门店基础资料 FReturnReason退货原因单选辅助资料列表 FCorrespondOrgId对应组织组织 FStockDeptId库存部门基础资料 FHeadNote备注多行文本 FPayCustId付款方基础资料 FEntity明细信息 FEntity.FMaterialId物料编码基础资料 FEntity.FBarcode零售条形码文本 FEntity.FRealQty实退数量数量 FEntity.FPrice单价单价 FEntity.FTaxPrice含税单价单价 FEntity.FIsFree是否赠品复选框 FEntity.FEntryTaxRate税率%小数 FEntity.FReturnType退货类型单选辅助资料列表 FEntity.FOwnerTypeId货主类型多类别基础资料列表 FEntity.FOwnerId货主多类别基础资料 FEntity.FStockId仓库基础资料 FEntity.FStocklocId仓位维度关联字段 FEntity.FLot批号批次 FEntity.FDeliveryDate退货日期长日期 FEntity.FNote备注文本 FEntity.FEntity_Link关联关系表 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织组织 FEntity.SubHeadEntity.FSettleTypeId结算方式基础资料 FEntity.SubHeadEntity.FEntity_Link_FRuleId转换规则OutStock-SalReturnStock FEntity.SubHeadEntity.FEntity_Link_FSTableName源单表T_SAL_OUTSTOCKENTRY FEntity.SubHeadEntity.FEntity_Link_FSBillId源单内码 FEntity.SubHeadEntity.FEntity_Link_FSId源单分录内码 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId系统模块21默认仓库模块

数据对接价值

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

从金蝶云星空到金蝶云星空通过接口配置打通数据