SQL Server和汤臣倍健营销云单据接口对接

对接源平台:汤臣倍健营销云

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

接通系统：SQL Server

SQLServer是Microsoft的关系数据库管理系统（RDBMS）。它是一个功能齐全的数据库，主要用于与竞争对手Oracle数据库（DB）和MySQL竞争。

数据接口配置

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

汤臣倍健营销云接口明细

API：/erp/api/order/query/purInWarehsOrder
NAME：查询采购入库订单接口
METHOD：POST

请求参数

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

响应参数

接口字段字段名称预设值描述 number采购入库单号 yxyNumber营销云单号营销云单号 saleOrderNo汤臣销售单号汤臣销售单号 easSaleissueOrderNo汤臣托运单号托运单号 othernumber外部单号唯一标识托运单号+公司id的hashCode opertime业务日期 approverId审批人id linknumber关联订单号关联的源单号 defaultnumber默认单号 organName供应商名称 organid供应商id sourceBillType来源订单类型100：采购订单 status订单状态0：未审核，1：已审核（已出库） subtype单据类型101：采购入库单 tenantName公司名称 type出入库类型-1：扣减库存，1：增加库存，0：不加不减 version版本号 itemList商品列表 itemList.id明细行id itemList.tenantId公司id itemList.createtime创建时间 itemList.updateTime更新时间 itemList.remark备注 itemList.headerid订单id itemList.depotName仓库名 itemList.depotNo仓库编号 itemList.depotid仓库id itemList.materialName产品名称 itemList.materialNumber产品编码 itemList.materialid产品id itemList.lot批次 itemList.mfg生产日期 itemList.exp到期日期 itemList.opernumber下单数量真实出库数量 itemList.basicnumber基础数量 itemList.taxrate税率 itemList.taxunitprice含税单价 itemList.taxlastmoney价税合计 itemList.extMaterialNo外围系统产品编码 itemList.helpCode产品助记码如：AA010302

SQL Server接口明细

API：insert
NAME：INSERT语句
METHOD：POST

请求参数

接口字段字段名称预设值描述 main_params主表参数 main_params.djbh单号编号{{number}} main_params.djlx采购入库传CGC 销售退回传XHHCGC main_params.rq日期{{opertime date}} main_params.ontime时间{{auditTime time}} main_params.wldwid单位内码WLD00000927 main_params.hsje含税金额{{itemList.taxlastmoney}} main_params.shouhr收货人{{recvContact}} main_params.shhdz地址{{recvAddr}} main_params.lxdh联系电话{{recvTel}} main_params.beizhu备注订单备注：{{remark}} main_params.webdjbh营销云单号{{yxyNumber}} 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含税价_function {{itemList.taxlastmoney}}/{{itemList.opernumber}} main_params.extend_params_1.hsje含税金额{{itemList.taxlastmoney}} main_params.extend_params_1.xgdjbh相关单号，如果退回，采购退等原来的单号{{yxyNumber}} 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,shouhr,shhdz,lxdh,beizhu,webdjbh) values ( :djbh,:djlx,:rq,:ontime,:wldwid,:hsje,:shouhr,:shhdz,:lxdh,: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)

系统集成总览

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