系统数据集成方案

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

数据源系统:汤臣倍健营销云

对接目标系统:SQL Server

多系统对接方案配置

通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将汤臣倍健营销云、SQL Server之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。

汤臣倍健营销云接口明细

• 接口：/erp/api/order/query/purInWarehsOrder
• 接口名称：查询采购入库订单接口
• 接口方法：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
yxyNumber	营销云单号	string	营销云单号
saleOrderNo	汤臣销售单号	string	汤臣销售单号
easSaleissueOrderNo	汤臣托运单号	string	托运单号
othernumber	外部单号唯一标识	string	托运单号+公司id的hashCode
opertime	业务日期	string
approverId	审批人id	string
linknumber	关联订单号	string	关联的源单号
defaultnumber	默认单号	string
organName	供应商名称	string
organid	供应商id	string
sourceBillType	来源订单类型	string	100：采购订单
status	订单状态	string	0：未审核，1：已审核（已出库）
subtype	单据类型	string	101：采购入库单
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

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.shouhr	收货人	string
main_params.shhdz	地址	string
main_params.lxdh	联系电话	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

系统对接概况

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

系统数据对接方案元数据代码