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

数据源系统:汤臣倍健营销云

汤臣倍健营销云融合集团资源与能力，实现线上线下渠道联通双赢，其全链路数字营销范本和思路可供全行业操盘手参考。汤臣倍健在危机之中创新机的企业“进化论”，打造全链路渠道营销中台

对接目标平台:SQL Server

SQL是英文StructuredQueryLanguage的缩写，意思为结构化查询语言。SQL语言的主要功能就是同各种数据库建立联系，进行沟通。按照ANSI(美国国家标准协会)的规定，SQL被作为关系型数据库管理系统的标准语言。SQLServer是由Microsoft开发和推广的关系数据库管理系统（RDBMS）。

数据接口配置

数据集成平台对应的配置汤臣倍健营销云与SQL Server的对接只要三步就能完成两个系统之间的数据对接。第一步根据汤臣倍健营销云的接口参数要求记录在轻易云集成平台。第二步配置汤臣倍健营销云与SQL Server之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

汤臣倍健营销云接口明细

API：/erp/api/order/query/saleReturnOrder
NAME：查询下级退货入库订单接口
METHOD：POST

请求参数

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

响应参数

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

SQL Server接口明细

调用接口：insert
接口名称：INSERT语句
方法：POST

请求参数

字段字段名称类型配置值 main_params主表参数object main_params.djbh单号编号string{{number}} main_params.djlx采购入库传CGC 销售退回传XHHstringXHH main_params.rq日期string{{auditTime date}} main_params.ontime时间string{{auditTime time}} main_params.wldwid单位内码string{{extCusCode}} main_params.hsje含税金额string{{itemList.taxlastmoney}} main_params.beizhu备注string{{remark}} main_params.webdjbh原始单号string{{othernumber}} main_params.extend_params_1扩展表参数arrayitemList main_params.extend_params_1.djbh单号string{{number}} main_params.extend_params_1.dj_sn序号string{{oSn}} main_params.extend_params_1.spid商品内码string_findCollection find spid from d76b64f9-f0e0-3436-a2d9-14c5579faa1b where spbh2={{extMaterialNo}} main_params.extend_params_1.ckid仓库编号string{{itemList.depotNo}} main_params.extend_params_1.pihao批号string{{itemList.lot}} main_params.extend_params_1.sxrq效期string{{itemList.exp}} main_params.extend_params_1.baozhiqi生产日期string{{itemList.mfg}} main_params.extend_params_1.shl数量数量大于0string{{itemList.opernumber}} main_params.extend_params_1.hshj含税价string{{itemList.taxunitprice}} main_params.extend_params_1.hsje含税金额string{{itemList.taxlastmoney}} main_params.extend_params_1.xgdjbh相关单号，如果退回，采购退等原来的单号string{{othernumber}} main_params.extend_params_1.recnum相关序号如果退回，采购退等对应明细的那个序号string{{oSn}} main_params.extend_params_1.hzid组织IDstring{{orgId}} main_params.extend_params_1.ckname仓库名称string{{tenantName}} main_params.extend_params_1.main_sql主SQL语句stringINSERT 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语句1stringINSERT 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语句接口