汤臣倍健营销云对接打通SQL Server查询采购入库订单接口接口与INSERT语句接口
对接系统汤臣倍健营销云
汤臣倍健创立于1995年，2002年系统地将膳食营养补充剂（VDS）引入中国非直销领域，2010年12月15日，汤臣倍健在深圳交易所创业板挂牌上市，并迅速成长为中国膳食营养补充剂领导品牌和标杆企业。2018年，汤臣倍健收购澳大利亚益生菌品牌Life-Space，同年5月，收购拜耳旗下具有80多年历史的儿童营养补充剂品牌Pentavite。欧睿数据显示，2020年汤臣倍健以10.3%的市场份额位居中国维生素与膳食补充剂行业第一位。汤臣倍健逐步发展为全球膳食营养补充剂行业领先者
集成系统:SQL Server
SQLServer数据库是Microsoft开发设计的一个关系数据库智能管理系统(RDBMS)，现在是全世界主流数据库之一；
数据接口配置方案
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将汤臣倍健营销云、SQL Server之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
汤臣倍健营销云接口明细
- 接口：/erp/api/order/query/purInWarehsOrder
- 接口名称：查询采购入库订单接口
- 接口方法：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
yxyNumber营销云单号string营销云单号
saleOrderNo汤臣销售单号string汤臣销售单号
easSaleissueOrderNo汤臣托运单号string托运单号
othernumber外部单号唯一标识string托运单号+公司id的hashCode
opertime业务日期string
approverId审批人idstring
linknumber关联订单号string关联的源单号
defaultnumber默认单号string
organName供应商名称string
organid供应商idstring
sourceBillType来源订单类型string100：采购订单
status订单状态string0：未审核，1：已审核（已出库）
subtype单据类型string101：采购入库单
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
SQL Server接口明细
- API：insert
- NAME：INSERT语句
- METHOD：POST
请求参数
接口字段字段名称预设值描述
main_params主表参数
main_params.djbh单号编号{{number}}
main_params.djlx采购入库传CGC 销售退回传XHHCGC
main_params.rq日期{{auditTime date}}
main_params.ontime时间{{auditTime time}}
main_params.wldwid单位内码WLD00001903
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)
系统集成总览
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：SQL Server与汤臣倍健营销云之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
