汤臣倍健营销云与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	经销商id	string	经销商id(必填,营销云id)如：34cc4109705e4c058b7b3b0352e57d31
yxyNumber	营销云销售订单号	string	如：YD1215710122031701，传此参数时，其他时间状态等条件无效
number	系统订单号	string	如：XOUT0000000293，传此参数时,其他时间状态等条件无效
status	订单状态	string	0:未审核 1：已审核（已出库）
beginTime	开始时间	string	timeType为空或者0，基于创建时间查询，timeType为1，基于更新时间查询，格式：0000-00-00或0000-00-00 00:00:00，如果不传单号此字段必填
endTime	结束时间	string	timeType为空或者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	审批人id	string
linknumber	关联订单号	string	关联的源单号
organName	客户名	string
organid	客户id	string
contacts	发货人	string
phone	发货电话	string
shippingAddress	发货地址	string
sourceBillType	来源订单类型	string	211：下级退货订单
status	订单状态	string	0：未审核，1：已审核（已出库）
subtype	单据类型	string	212：下级退货入库单
tenantName	公司名称	string
type	出入库类型	string	-1：扣减库存，1：增加库存，0：不加不减
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	如：AA010302
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.ontime	时间	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

数据对接效果

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。