MySQL与金蝶云星空对接集成执行查询语句-v2打通销售退货新增V1

数据源系统:MySQL

mysql是一个关系数据库管理系统（RDBMS），所谓的关系型数据库，是建立在关系模型基础上的数据库，借助于集合代数等数学概念和方法来处理数据库中的数据。

目标系统:金蝶云星空

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

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：MySQL接口：执行查询语句-v2通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：销售退货新增V1，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

MySQL接口明细

API：select
NAME：执行查询语句-v2
METHOD：SQL

请求参数

接口字段字段名称预设值描述 main_params主参数对应主查询语句内的动态参数对象 main_params.limit返回的记录数100你可以使用 LIMIT 属性来设定返回的记录数。 main_params.offset数据偏移量你可以通过OFFSET指定SELECT语句开始查询的数据偏移量。默认情况下偏移量为0。 main_params.created_at创建时间2020-01-01 11:00:00时间参数，非必要的 main_params.extend_params_11:1扩展子表参数1:1扩展子表参数 main_params.extend_params_1.id主表ID:id子表与主表的外键关联字段 main_params.extend_params_1.extend_params_21:N扩展子表参数1:N扩展子表参数 main_params.extend_params_1.extend_params_2.id主键ID:id子表与主表的外键关联字段 main_params.extend_params_1.extend_params_2.main_sql主查询语句select * from sale_order where created_at >= :created_at limit :limit offset :offset使用 :created_at 格式与主参数字段进行对应 main_params.extend_params_1.extend_params_2.extend_sql_11:1查询子表语句select * from sale_order_ext where id = :id使用 :id 格式与扩展参数字段进行对应 main_params.extend_params_1.extend_params_2.extend_sql_21:N查询子表语句select * from sale_order_detail where order_id = :id使用 :id 格式与扩展参数字段进行对应

响应参数

接口字段字段名称预设值描述 id主键ID主键ID no订单编码订单编码 shop店铺名称店铺名称 platform所属平台所属平台 is_online是否线上是否线上 salesman销售员销售员 department所属部门所属部门 extend_sql_1订单子表订单子表 extend_sql_1.id订单主键订单主键 extend_sql_1.recipient收件人收件人 extend_sql_1.mobile电话电话 extend_sql_1.is_vip是否VIP是否VIP extend_sql_1.buyer_message买家留言买家留言 extend_sql_1.address地址地址 extend_sql_1.extend_sql_2订单明细订单明细 extend_sql_1.extend_sql_2.price单价单价 extend_sql_1.extend_sql_2.tax_rate税率税率 extend_sql_1.extend_sql_2.id订单主键订单主键 extend_sql_1.extend_sql_2.sku商品商品 extend_sql_1.extend_sql_2.sku_category商品分类商品分类 extend_sql_1.extend_sql_2.sku_spec商品规格商品规格 extend_sql_1.extend_sql_2.order_id订单号订单号 extend_sql_1.extend_sql_2.tax税额税额 extend_sql_1.extend_sql_2.full_amount价税合计价税合计 extend_sql_1.extend_sql_2.weight重量重量 extend_sql_1.extend_sql_2.tax_price含税价含税价 extend_sql_1.extend_sql_2.num数量数量 extend_sql_1.extend_sql_2.amount金额金额

金蝶云星空接口明细

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

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型XSTHD01_SYS单据类型 FBillNo单据编号单据编号 FSaleOrgId销售组织销售组织 FDate日期日期 FStockOrgId库存组织库存组织 FRetcustId退货客户退货客户 FSettleCurrId结算币别结算币别 FHeadNote备注备注 FEntity明细信息明细信息 FEntity.FMaterialId物料编码物料编码 FEntity.FRealQty实退数量实退数量 FEntity.FPrice单价单价 FEntity.FTaxPrice含税单价含税单价 FEntity.FIsFree是否赠品是否赠品 FEntity.FEntryTaxRate税率%税率% FEntity.FReturnType退货类型THLX01_SYS退货类型 FEntity.FOwnerTypeId货主类型BD_OwnerOrg货主类型 FEntity.FOwnerId货主货主 FEntity.FStockId仓库仓库 FEntity.FSrcBillTypeID源单类型源单类型 FEntity.FSrcBillNo源单编号源单编号 FEntity.FLot批次号批次号 FEntity.FProduceDate生产日期生产日期 FEntity.FExpiryDate有效期至有效期至 FEntity.SubHeadEntity财务信息财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织结算组织 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作BatchSave执行的操作 FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true提交并审核 FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录）

系统对接总览

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

MySQL与金蝶云星空对接集成执行查询语句-v2打通销售退货新增V1