汤臣倍健营销云和SQL Server接口打通对接实战
源系统:汤臣倍健营销云
汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系，助力企业在自营平台、微信生态等全渠道上精准触达用户，自动化营销互动，实时反馈效果，真正实现营销数字化。
对接目标系统:SQL Server
SQLServer数据库是Microsoft开发设计的一个关系数据库智能管理系统(RDBMS)，现在是全世界主流数据库之一；
配置集成方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：汤臣倍健营销云的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：SQL Server，把获取的数据组装成目标系统需要的格式进行写入。
汤臣倍健营销云接口明细
- 调用接口：/erp/api/order/query/purInWarehsOrder
- 接口名称：查询采购入库订单接口
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| tenantId | 经销商id | string | d4f5ddb3c6584af7980904b63bee33ce |
| yxyNumber | 营销云销售订单号 | string | |
| number | 系统订单号 | string | |
| status | 订单状态 | string | 1 |
| beginTime | 开始时间 | string | {{LAST_SYNC_TIME datetime}} |
| endTime | 结束时间 | string | {{CURRENT_TIME datetime}} |
| pageNo | 页码 | string | 1 |
| pageSize | 每页条数 | string | 30 |
| timeType | 时间段标志 | string | 1 |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| number | 采购入库单号 | string | |
| yxyNumber | 营销云单号 | string | |
| saleOrderNo | 汤臣销售单号 | string | |
| easSaleissueOrderNo | 汤臣托运单号 | string | |
| othernumber | 外部单号唯一标识 | string | |
| opertime | 业务日期 | string | |
| approverId | 审批人id | string | |
| linknumber | 关联订单号 | string | |
| defaultnumber | 默认单号 | string | |
| organName | 供应商名称 | string | |
| organid | 供应商id | 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.remark | 备注 | 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.ontime | 时间 | string | |
| main_params.wldwid | 单位内码 | string | |
| main_params.hsje | 含税金额 | string | |
| main_params.shouhr | 收货人 | string | |
| main_params.shhdz | 地址 | string | |
| main_params.lxdh | 联系电话 | 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 | |
系统数据对接
数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。
