汤臣倍健营销云和SQL Server接口打通对接实战

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

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

集成系统:SQL Server

SQLServer是Microsoft的关系数据库管理系统（RDBMS）。它是一个功能齐全的数据库，主要用于与竞争对手Oracle数据库（DB）和MySQL竞争。

系统对接接口配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的查询采购入库订单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为SQL Server,并且选择对应连接器（关于SQL Server的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的INSERT语句接口作为数据写入动作，既可以完成第一步的数据对接配置。

汤臣倍健营销云接口明细

调用接口：/erp/api/order/query/purInWarehsOrder
接口名称：查询采购入库订单接口
方法：POST

请求参数

字段字段名称类型配置值 tenantId经销商idstringbcf795d44109489f93c0560fa5d4bf0a yxyNumber营销云销售订单号string number系统订单号string status订单状态string1 beginTime开始时间string{{LAST_SYNC_TIME datetime}} endTime结束时间string{{CURRENT_TIME datetime}} pageNo页码string1 pageSize每页条数string30 timeType时间段标志string1

响应参数

字段字段名称类型配置值 number采购入库单号string yxyNumber营销云单号string saleOrderNo汤臣销售单号string easSaleissueOrderNo汤臣托运单号string othernumber外部单号唯一标识string opertime业务日期string approverId审批人idstring linknumber关联订单号string defaultnumber默认单号string organName供应商名称string organid供应商idstring sourceBillType来源订单类型string status订单状态string subtype单据类型string tenantName公司名称string type出入库类型string 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

SQL Server接口明细

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

请求参数

字段字段名称类型配置值 main_params主表参数object main_params.djbh单号编号string{{number}} main_params.djlx采购入库传CGC 销售退回传XHHstringCGC main_params.rq日期string{{opertime date}} main_params.ontime时间string{{auditTime time}} main_params.wldwid单位内码stringWLD00001903 main_params.hsje含税金额string{{itemList.taxlastmoney}} main_params.shouhr收货人string{{recvContact}} main_params.shhdz地址string{{recvAddr}} main_params.lxdh联系电话string{{recvTel}} main_params.beizhu备注string订单备注：{{remark}} main_params.webdjbh营销云单号string{{yxyNumber}} 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商品内码stringfindCollection 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_function {{itemList.taxlastmoney}}/{{itemList.opernumber}} main_params.extend_params_1.hsje含税金额string{{itemList.taxlastmoney}} main_params.extend_params_1.xgdjbh相关单号，如果退回，采购退等原来的单号string{{yxyNumber}} 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,shouhr,shhdz,lxdh,beizhu,webdjbh) values ( :djbh,:djlx,:rq,:ontime,:wldwid,:hsje,:shouhr,:shhdz,:lxdh,: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架构。