汤臣倍健营销云和SQL Server集成接口设计

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

汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系，助力企业在自营平台、微信生态等全渠道上精准触达用户，自动化营销互动，实时反馈效果，真正实现营销数字化。

写入目标:SQL Server

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

数据接口配置

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

汤臣倍健营销云接口明细

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

请求参数

接口字段名称预设值 tenantId经销商idc0cdee4a7d744a199cccc3c8bf7ff3d9 yxyNumber营销云销售订单号 number系统订单号 status订单状态1 beginTime开始时间{{LAST_SYNC_TIME datetime}} endTime结束时间{{CURRENT_TIME datetime}} pageNo页码 pageSize每页条数 timeType时间段标志

响应参数

接口字段名称预设值 number下级退货入库单号 othernumber原始单号 opertime业务日期 approverId审批人id linknumber关联订单号 organName客户名 organid客户id contacts发货人 phone发货电话 shippingAddress发货地址 sourceBillType来源订单类型 status订单状态 subtype单据类型 tenantName公司名称 type出入库类型 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产品助记码 itemList.extCusCode外围系统客户编码

SQL Server接口明细

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

请求参数

字段字段名称类型配置值 main_params主表参数object main_params.djbh单号编号string{{number}} main_params.djlx采购入库传CGC 销售退回传XHHstringXHH main_params.rq日期string{{opertime date}} 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集成接口设计