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

对接系统汤臣倍健营销云

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

集成系统:SQL Server

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

接口方案配置

通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的/erp/api/order/query/saleReturnOrder作为数据对接来源。然后再写入目标平台配置目标系统为SQL Server，并且选择对应连接器。选择好对应的insert接口作为数据写入动作完成第一步的接口配置。

汤臣倍健营销云接口明细

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

请求参数

接口字段字段名称预设值描述 tenantId经销商idc0cdee4a7d744a199cccc3c8bf7ff3d9经销商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接口明细

API：insert
NAME：INSERT语句
METHOD：POST

请求参数

接口字段字段名称预设值描述 main_params主表参数 main_params.djbh单号编号{{number}} main_params.djlx采购入库传CGC 销售退回传XHHXHH main_params.rq日期{{opertime date}} 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服务总线层面解决企业烟囱式业务系统集成现状相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。