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

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

来源系统:汤臣倍健营销云

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

目标系统:SQL Server

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

数据接口配置

异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取汤臣倍健营销云的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到SQL Server中。轻易云集成平台的可视化配置轻松实现。通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。

汤臣倍健营销云接口明细

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

请求参数

字段名称类型 number系统订单号string yxyNumber营销云销售订单号string tenantId经销商idstring timeType时间段标志string status订单状态string pageNo页码string beginTime开始时间string endTime结束时间string pageSize每页条数string

响应参数

字段名称类型描述 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服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。