汤臣倍健营销云和SQL Server接口打通对接实战
接入系统：汤臣倍健营销云
汤臣倍健营销云融合集团资源与能力，实现线上线下渠道联通双赢，其全链路数字营销范本和思路可供全行业操盘手参考。汤臣倍健在危机之中创新机的企业“进化论”，打造全链路渠道营销中台
对接目标系统:SQL Server
SQLServer数据库是Microsoft开发设计的一个关系数据库智能管理系统(RDBMS)，现在是全世界主流数据库之一；
配置集成方案
使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的查询下级退货入库订单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为SQL Server,并且选择对应连接器（关于SQL Server的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的INSERT语句接口作为数据写入动作，既可以完成第一步的数据对接配置。
汤臣倍健营销云接口明细
- 调用接口：/erp/api/order/query/saleReturnOrder
- 接口名称：查询下级退货入库订单接口
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| tenantId | 经销商id | string | c0cdee4a7d744a199cccc3c8bf7ff3d9 |
| yxyNumber | 营销云销售订单号 | string | |
| number | 系统订单号 | string | |
| status | 订单状态 | string | 1 |
| beginTime | 开始时间 | string | {{LAST_SYNC_TIME datetime}} |
| endTime | 结束时间 | string | {{CURRENT_TIME datetime}} |
| pageNo | 页码 | string | |
| pageSize | 每页条数 | string | |
| timeType | 时间段标志 | string | |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| number | 下级退货入库单号 | string | |
| othernumber | 原始单号 | string | |
| opertime | 业务日期 | string | |
| approverId | 审批人id | string | |
| linknumber | 关联订单号 | string | |
| organName | 客户名 | string | |
| organid | 客户id | string | |
| contacts | 发货人 | string | |
| phone | 发货电话 | string | |
| shippingAddress | 发货地址 | string | |
| sourceBillType | 来源订单类型 | string | |
| status | 订单状态 | string | |
| subtype | 单据类型 | string | |
| tenantName | 公司名称 | string | |
| type | 出入库类型 | string | |
| 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 | |
| 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资产的可插拔、可复用、可组成。
