汤臣倍健营销云对接打通SQL Server查询下级退货入库订单接口接口与INSERT语句接口

对接源平台:汤臣倍健营销云

汤臣倍健创立于1995年，2002年系统地将膳食营养补充剂（VDS）引入中国非直销领域，2010年12月15日，汤臣倍健在深圳交易所创业板挂牌上市，并迅速成长为中国膳食营养补充剂领导品牌和标杆企业。2018年，汤臣倍健收购澳大利亚益生菌品牌Life-Space，同年5月，收购拜耳旗下具有80多年历史的儿童营养补充剂品牌Pentavite。欧睿数据显示，2020年汤臣倍健以10.3%的市场份额位居中国维生素与膳食补充剂行业第一位。汤臣倍健逐步发展为全球膳食营养补充剂行业领先者

接入系统：SQL Server

SQLServer数据库是Microsoft开发设计的一个关系数据库智能管理系统(RDBMS)，现在是全世界主流数据库之一；

数据对接方案

通过数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：汤臣倍健营销云，并且选择对应的连接器（关于汤臣倍健营销云的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询下级退货入库订单接口接口作为数据对接来源。然后再通过写入目标平台配置目标系统为SQL Server，并且选择对应连接器。选择对应的INSERT语句接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

汤臣倍健营销云接口明细

接口：/erp/api/order/query/saleReturnOrder
接口名称：查询下级退货入库订单接口
接口方法：POST

请求参数

字段名称类型描述 tenantId经销商idstring经销商id(必填,营销云id)如：34cc4109705e4c058b7b3b0352e57d31 yxyNumber营销云销售订单号string如：YD1215710122031701，传此参数时，其他时间状态等条件无效 number系统订单号string如：XOUT0000000293，传此参数时,其他时间状态等条件无效 status订单状态string0:未审核 1：已审核（已出库） beginTime开始时间stringtimeType为空或者0，基于创建时间查询，timeType为1，基于更新时间查询，格式：0000-00-00或0000-00-00 00:00:00，如果不传单号此字段必填 endTime结束时间stringtimeType为空或者0，基于创建时间查询，timeType为1，基于更新时间查询，格式：0000-00-00或0000-00-00 00:00:00，如果不传单号此字段必填 pageNo页码string默认1 pageSize每页条数string默认30 timeType时间段标志string查询时间段标识，0:创建时间（默认），1：最后更新时间

响应参数

字段名称类型描述 number下级退货入库单号string othernumber原始单号string营销云单号 opertime业务日期string approverId审批人idstring linknumber关联订单号string关联的源单号 organName客户名string organid客户idstring contacts发货人string phone发货电话string shippingAddress发货地址string sourceBillType来源订单类型string211：下级退货订单 status订单状态string0：未审核，1：已审核（已出库） subtype单据类型string212：下级退货入库单 tenantName公司名称string type出入库类型string-1：扣减库存，1：增加库存，0：不加不减 version版本号string itemList商品列表array itemList.id明细行idstring itemList.tenantId公司idstring itemList.createtime创建时间string itemList.updateTime更新时间string itemList.remark备注string itemList.headerid订单idstring itemList.depotName仓库名string itemList.depotNo仓库编号string itemList.depotid仓库idstring itemList.materialName产品名称string itemList.materialNumber产品编码string itemList.materialid产品idstring itemList.lot批次string itemList.mfg生产日期string itemList.exp到期日期string itemList.opernumber下单数量string真实出库数量 itemList.basicnumber基础数量string itemList.taxrate税率string itemList.taxunitprice含税单价string itemList.taxlastmoney价税合计string itemList.extMaterialNo外围系统产品编码string itemList.helpCode产品助记码string如：AA010302 itemList.extCusCode外围系统客户编码string如果在营销云有维护就有该字段

SQL Server接口明细

API：insert
NAME：INSERT语句
METHOD：POST

请求参数

接口字段字段名称预设值描述 main_params主表参数 main_params.djbh单号编号{{number}} main_params.djlx采购入库传CGC 销售退回传XHHXHH main_params.rq日期{{auditTime date}} main_params.ontime时间{{auditTime time}} main_params.wldwid单位内码{{extCusCode}} main_params.hsje含税金额{{itemList.taxlastmoney}} main_params.beizhu备注{{remark}} main_params.webdjbh原始单号{{othernumber}} main_params.extend_params_1扩展表参数itemList main_params.extend_params_1.djbh单号{{number}} main_params.extend_params_1.dj_sn序号{{oSn}} main_params.extend_params_1.spid商品内码_findCollection find spid from d76b64f9-f0e0-3436-a2d9-14c5579faa1b where spbh2={{extMaterialNo}} main_params.extend_params_1.ckid仓库编号{{itemList.depotNo}} main_params.extend_params_1.pihao批号{{itemList.lot}} main_params.extend_params_1.sxrq效期{{itemList.exp}} main_params.extend_params_1.baozhiqi生产日期{{itemList.mfg}} main_params.extend_params_1.shl数量数量大于0{{itemList.opernumber}} main_params.extend_params_1.hshj含税价{{itemList.taxunitprice}} main_params.extend_params_1.hsje含税金额{{itemList.taxlastmoney}} main_params.extend_params_1.xgdjbh相关单号，如果退回，采购退等原来的单号{{othernumber}} main_params.extend_params_1.recnum相关序号如果退回，采购退等对应明细的那个序号{{oSn}} main_params.extend_params_1.hzid组织ID{{orgId}} main_params.extend_params_1.ckname仓库名称{{tenantName}} main_params.extend_params_1.main_sql主SQL语句INSERT INTO gxkphz (djbh,djlx,rq,ontime,wldwid,hsje,beizhu,webdjbh) values ( :djbh,:djlx,:rq,:ontime,:wldwid,:hsje,:beizhu,:webdjbh) main_params.extend_params_1.extend_sql_1扩展SQL语句1INSERT INTO gxkpmx (djbh,dj_sn,spid,ckid,pihao,sxrq,baozhiqi,shl,hshj,hsje,xgdjbh,recnum,hzid,ckname) values ( :djbh,:dj_sn,:spid,:ckid,:pihao,:sxrq,:baozhiqi,:shl,:hshj,:hsje,:xgdjbh,:recnum,:hzid,:ckname)

系统对接概况

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

汤臣倍健营销云对接打通SQL Server查询下级退货入库订单接口接口与INSERT语句接口