汤臣倍健营销云和SQL Server接口打通对接实战|轻易云数据集成平台

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

接通系统：汤臣倍健营销云

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

对接目标平台:SQL Server

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

数据集成方案配置

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

汤臣倍健营销云接口明细

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

请求参数

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

响应参数

字段	名称	类型	描述
number	下级退货入库单号	string
othernumber	原始单号	string	营销云单号
opertime	业务日期	string
approverId	审批人id	string
linknumber	关联订单号	string	关联的源单号
organName	客户名	string
organid	客户id	string
contacts	发货人	string
phone	发货电话	string
shippingAddress	发货地址	string
sourceBillType	来源订单类型	string	211：下级退货订单
status	订单状态	string	0：未审核，1：已审核（已出库）
subtype	单据类型	string	212：下级退货入库单
tenantName	公司名称	string
type	出入库类型	string	-1：扣减库存，1：增加库存，0：不加不减
version	版本号	string
itemList	商品列表	array
itemList.id	明细行id	string
itemList.tenantId	公司id	string
itemList.createtime	创建时间	string
itemList.updateTime	更新时间	string
itemList.remark	备注	string
itemList.headerid	订单id	string
itemList.depotName	仓库名	string
itemList.depotNo	仓库编号	string
itemList.depotid	仓库id	string
itemList.materialName	产品名称	string
itemList.materialNumber	产品编码	string
itemList.materialid	产品id	string
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接口明细

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

请求参数

字段	名称	类型	描述
main_params	主表参数	object
main_params.djbh	单号编号	string
main_params.djlx	采购入库传CGC 销售退回传XHH	string
main_params.rq	日期	string
main_params.wldwid	单位内码	string
main_params.hsje	含税金额	string
main_params.beizhu	备注	string
main_params.webdjbh	原始单号	string
main_params.extend_params_1	扩展表参数	array
main_params.extend_params_1.djbh	单号	string
main_params.extend_params_1.dj_sn	序号	string
main_params.extend_params_1.spid	商品内码	string
main_params.extend_params_1.ckid	仓库编号	string
main_params.extend_params_1.pihao	批号	string
main_params.extend_params_1.sxrq	效期	string
main_params.extend_params_1.baozhiqi	生产日期	string
main_params.extend_params_1.shl	数量数量大于0	string
main_params.extend_params_1.hshj	含税价	string
main_params.extend_params_1.hsje	含税金额	string
main_params.extend_params_1.xgdjbh	相关单号，如果退回，采购退等原来的单号	string
main_params.extend_params_1.recnum	相关序号如果退回，采购退等对应明细的那个序号	string
main_params.extend_params_1.hzid	组织ID	string
main_params.extend_params_1.ckname	仓库名称	string
main_params.extend_params_1.main_sql	主SQL语句	string
main_params.extend_params_1.extend_sql_1	扩展SQL语句1	string

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。