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_1	1:1扩展子表参数		1:1扩展子表参数
main_params.extend_params_1.id	主表ID	:id	子表与主表的外键关联字段
main_params.extend_params_1.extend_params_2	1: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_1	1:1查询子表语句	select * from sale_order_ext where id = :id	使用 :id 格式与扩展参数字段进行对应
main_params.extend_params_1.extend_params_2.extend_sql_2	1: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	业务对象表单Id	SAL_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资产的可插拔、可复用、可组成。