系统数据集成方案

从汤臣倍健营销云到时空智友通过接口配置打通数据

源系统:汤臣倍健营销云

对接目标平台:时空智友

数据接口配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：汤臣倍健营销云，并且选择对应的连接器（关于汤臣倍健营销云的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询采购入库订单接口接口作为数据对接来源。然后再通过写入目标平台配置目标系统为时空智友，并且选择对应连接器。选择对应的新增入库信息(ifPurIn)接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

汤臣倍健营销云接口明细

• 接口：/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

时空智友接口明细

• 接口：/formservice?service=OMSService.storageIn
• 接口名称：新增入库信息(ifPurIn)
• 接口方法：POST

请求参数

字段	名称	类型	描述
orgId	组织机构编码	string	系统后台默认
whid	物流中心	string
createTime	创建时间	string
ownerId	货主编码	string	系统后台默认
billcode	订单号	string
Remark1	明细备注	string	行明细备注
billsn	定单行号	string
carrier	承运单位	string
transMode	运输方式	string	火车，汽运，空运
taskType	数据类型	string	110采购订单214销退入库；114采退出库210销售订单,120采购入库，220销售出库
businessId	单位ID	string	供应商
songhts	送货天数	string	今天以后日期，包含今天
ShipFrom	起运时间	string	yyyy-mm-ddhh:mm:ss
businessCode	单位编号	string	供应商编码
sendaddress	发货地点	string
goodsId	商品编号	string
billFlag	是否扫描发票	string	0不需要，1需要，不传值为空
batchCode	批号	string
Isdone	已完成	string
valDate	效期	string
produceDate	生产日期	string
rebillcode	对应采购单号	string
SterilCode	灭菌批号	string
rebillsn	销售订单行号	string
taxPrice	采购价	string	最多保留6位小数
Clientcode	客户编号	string
Khx_spid	安泰嘉美商品id	string	安泰嘉美商品信息ID
num	数量	string	最多保留4位小数
piece	件数	string	最多保留2位小数
taxAmount	含税金额	string	最多保留2位小数
confirmMan	审核人	string
confirmDate	审核时间	string
caozyname	制单人	string
dates	制单日期	string
ontime	制单时间	string
GCategory	品种类型	string	化学药制剂/中成药/中药饮片/抗生素制剂//生化药品/等
remark	备注	string	主单备注
orderFlag	订单类型	string	101采购入库 102销售退货入库

数据对接价值

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

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