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

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

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

接通系统：SQL Server

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

配置集成方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的小B-新版订单组合查询作为数据对接来源。然后再写入目标平台配置目标系统为SQL Server，并且选择对应连接器（关于SQL Server的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的insert接口作为数据写入动作完成第一步的接口配置。

汤臣倍健营销云接口明细

接口：/api/openapi/v1/erp/order/honour/agreement/header
接口名称：小B-新版订单组合查询
接口方法：POST

请求参数

字段名称类型描述 orgId组织IDstring page页码string id订单idstring applyerId要货方idstring supplierId供货方idstring no订单号string distributionType分销类型string distributorId分销商idstring orderStatus订单状态string createDt创建时间string orderTypeCode订单类型,如普通订单、直运销售string isDeliveryFreezed是否暂停发货string relatedApplyerId关联交易经销商idstring saleDistribution销售渠道string disApplyerId分销商idstring startDt订单时间（开始）string endDt订单时间（结束）string appStartDt审批时间（开始）string appEndDt审批时间（结束）string lastStartDt最后修改时间（开始）string lastEndDt最后修改时间（结束）string nature单据类型1订单、2退货string

响应参数

字段名称类型描述 applyerId要货方idstring supplierId供货方idstring no订单号string distributionType分销类型string distributorId分销商idstring orgId订单组织string orderStatus订单状态string createDt创建时间string contractNo合同编号string isReport是否随批报告string predictArriveDt预计到货日期string deliveryLevelCode发货优先级string orderTypeCode订单类型,如普通订单、直运销售string isDeliveryFreezed是否暂停发货string taxCode税码string areaCode区域idstring currencyCode币种string settlementModeCode结算方式string deliveryCode交货方式string isCreditManaged是否信用暂挂string salesman订单销售人员string relatedApplyerId关联交易经销商idstring saleDistribution销售渠道string nature订单分类，如要货单、退货单string actGiftQuantity实际审批数量string giftQuantity赠品数量string province省份string city城市string county县城string newExchangeOrder是否新的积分订单绑定方式（婴童特殊要求，值为1是，没有值或0为否）string contacts收货联系人string phone收货联系人电话string storagePlace仓库归属地string shippingAddress收货地址string expectDate预计到达天数string disApplyerId分销商idstring freeGiftTotal免费赠品余量string discountTotalMoney产品折让总额string returnedMoney应退金额string retunsOvertopMoney退货超额金额string remainMoney折让后金额string fineMoney罚金金额string totalMoney总金额string netDiscountTotalMoney网络品&赠品折让总额string netDiscountCanuseMoney网络品(产品)使用网络品&赠品可用总额string netDiscountMoney网络品(产品)实际使用网络品&赠品折让金额string netGiftDiscountCanuseMoney赠品使用网络品&赠品可用总额string netGiftDiscountMoney赠品实际使用网络品&赠品折让金额string fullDiscountTotalMoney全品折让总额string fullDiscountCanuseMoney产品使用全品可用总额string fullDiscountMoney产品实际使用全品折让金额string fullGiftDiscountCanuseMoney赠品使用全品可用总额string fullGiftDiscountMoney赠品实际使用全品折让金额string retunsFullyMoney全额退款金额string orderContacts订单联系人string orderPhone订单联系人电话string orderDt订单时间string approveDt审批时间string lastUpdateDt最后更新时间string clientAppNo经销商外围系统编码string partnerName经销商名称string orgName租户名称string details明细array details.id明细Idstring details.discountMoney折扣后金额string details.quantity下单数量string details.productId产品idstring details.productName产品名称string details.productNo产品编码string details.spec规格string details.unitCode单位string details.minUnit包装数string details.basePrice统一价string details.price供货价string details.actQuantity审批数量string details.money金额string details.type类型string details.isFree是否免费string details.discountAmount折扣额string details.discountPrice折扣后单价string details.discountRate折扣率string details.itemDiscountMoney普通行折让string details.itemFullDiscountMoney全品行折让string details.itemNetDiscountMoney网络品&赠品行折让string details.easNo产品长编码string details.extNo产品外围编码string details.batchNum产品批次号string

SQL Server接口明细

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

请求参数

字段字段名称类型配置值 main_params主表参数object main_params.djbh订单单号string{{no}} main_params.dj_sn订单明细序号string{{bfn_line}} main_params.spid商品IDstring_findCollection find spid from d76b64f9-f0e0-3436-a2d9-14c5579faa1b where spbh2={{details_extNo}} main_params.shl订单数量string{{details_quantity}} main_params.Pihao批号string{{details_batchNum}} main_params.Sxrq有效期string{{details_giveDate date}} main_params.Baozhiqi生产日期string{{details_pactDate date}} main_params.hshj含税价string{{details_price}} main_params.hsje含税金额string{{details_money}} main_params.beizhu备注string{{remark}} main_params.rq订单日期string{{lastUpdateDt date}} main_params.ontime订单时间string{{lastUpdateDt time}} main_params.wldwname单位名称string{{details_unitCode}} main_params.wldwid单位名称string{{clientAppNo}} main_params.dizhi地址电话string{{shippingAddress}} main_params.shr收货人string{{contacts}} main_params.shrdh收货人电话string{{phone}} main_params.ywy业务员string{{salesmanName}} main_params.hzid组织IDstring548b6c51d1e741fc9f19a513bfb64395 main_params.ckname仓库名称string{{orgName}} main_params.main_sql主SQL语句stringINSERT INTO Inter_ddmx (djbh ,dj_sn,spid,shl,Pihao,Sxrq,Baozhiqi,hshj,hsje,beizhu,rq,ontime,wldwname,wldwid,dizhi,shr,shrdh,ywy,hzid,ckname) values ( :djbh ,:dj_sn,:spid,:shl,😛ihao,:Sxrq,:Baozhiqi,:hshj,:hsje,:beizhu,:rq,:ontime,:wldwname,:wldwid,:dizhi,:shr,:shrdh,:ywy,:hzid,:ckname)

数据对接效果

全新的API数据集成模式，赋能企业业务创新传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：SQL Server与汤臣倍健营销云之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。

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