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

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

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

汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系，助力企业在自营平台、微信生态等全渠道上精准触达用户，自动化营销互动，实时反馈效果，真正实现营销数字化。

集成系统:SQL Server

SQL是英文StructuredQueryLanguage的缩写，意思为结构化查询语言。SQL语言的主要功能就是同各种数据库建立联系，进行沟通。按照ANSI(美国国家标准协会)的规定，SQL被作为关系型数据库管理系统的标准语言。SQLServer是由Microsoft开发和推广的关系数据库管理系统（RDBMS）。

数据接口配置

数据集成平台对应的配置汤臣倍健营销云与SQL Server的对接只要三步就能完成两个系统之间的数据对接。第一步根据汤臣倍健营销云的接口参数要求记录在轻易云集成平台。第二步配置汤臣倍健营销云与SQL Server之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

汤臣倍健营销云接口明细

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

请求参数

字段名称类型描述 tenantId经销商idstring经销商id(必填,营销云id)如：34cc4109705e4c058b7b3b0352e57d31 yxyNumber营销云销售订单号string如：YD1215710122031701，传此参数时，其他时间状态等条件无效 number系统订单号string如：XOUT0000000293，传此参数时,其他时间状态等条件无效 status订单状态string0:未审核 1：已审核（已出库） beginTime开始时间stringtimeType为空或者0，基于创建时间查询，timeType为1，基于更新时间查询，格式：0000-00-00或0000-00-00 00:00:00，如果不传单号此字段必填 endTime结束时间stringtimeType为空或者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审批人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接口明细

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

请求参数

字段字段名称类型配置值 main_params主表参数object main_params.djbh单号编号string{{number}} main_params.djlx采购入库传CGC 销售退回传XHHstringXHH main_params.rq日期string{{auditTime date}} main_params.ontime时间string{{auditTime time}} main_params.wldwid单位内码string{{extCusCode}} main_params.hsje含税金额string{{itemList.taxlastmoney}} main_params.beizhu备注string{{remark}} main_params.webdjbh原始单号string{{othernumber}} main_params.extend_params_1扩展表参数arrayitemList main_params.extend_params_1.djbh单号string{{number}} main_params.extend_params_1.dj_sn序号string{{oSn}} main_params.extend_params_1.spid商品内码string_findCollection find spid from d76b64f9-f0e0-3436-a2d9-14c5579faa1b where spbh2={{extMaterialNo}} main_params.extend_params_1.ckid仓库编号string{{itemList.depotNo}} main_params.extend_params_1.pihao批号string{{itemList.lot}} main_params.extend_params_1.sxrq效期string{{itemList.exp}} main_params.extend_params_1.baozhiqi生产日期string{{itemList.mfg}} main_params.extend_params_1.shl数量 数量大于0string{{itemList.opernumber}} main_params.extend_params_1.hshj含税价string{{itemList.taxunitprice}} main_params.extend_params_1.hsje含税金额string{{itemList.taxlastmoney}} main_params.extend_params_1.xgdjbh相关单号，如果退回，采购退 等原来的单号string{{othernumber}} main_params.extend_params_1.recnum相关序号 如果退回，采购退 等对应明细的那个序号string{{oSn}} main_params.extend_params_1.hzid组织IDstring{{orgId}} main_params.extend_params_1.ckname仓库名称string{{tenantName}} main_params.extend_params_1.main_sql主SQL语句stringINSERT 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语句1stringINSERT 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)

数据对接价值

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。