汤臣倍健营销云对接打通时空智友查询下级退货入库订单接口接口与新增入库信息(ifPurIn)接口|轻易云数据集成平台

汤臣倍健营销云对接打通时空智友查询下级退货入库订单接口接口与新增入库信息(ifPurIn)接口

对接系统：汤臣倍健营销云

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

对接系统：时空智友

时空智友是北京时空智友科技有限公司旗下品牌。北京时空智友科技有限公司(以下简称智友科技),成立于2011年6月,是注册于北京海淀中关村西区的一家高科技技术服务企业。公司的理念是用数据服务于“智慧的城市”,帮助商业用户成为数据城市的结点,与整个城市的商业数据流融会贯通。随着互联网的深入发展,网络的普及,人们的协同工作变得越来越便捷,无国界,无边界,无时间界限,公司面向流通领域,全面提供具有云应用的软件产品

数据接口配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：汤臣倍健营销云接口：查询下级退货入库订单接口通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：时空智友接口：新增入库信息(ifPurIn)，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：时空智友写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

汤臣倍健营销云接口明细

接口：/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	如果在营销云有维护就有该字段

时空智友接口明细

接口：/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销售退货入库

系统集成总览

随着企业数字化业务的深入发展，对于企业的 IT 或者 CIO 来讲，正在面临一个愈发重要的问题——系统的结构太复杂了，尤其是头部企业，至少有十多套系统，这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统，如何整合企业的现有IT资源，使企业中计算机孤岛式的应用向集体协作的方向发展，发挥资源效益的最大化，降低企业成本，正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上，操作统一，以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中，轻易云应用集成平台负责实现异构、分布式系统之间互联互通，实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件，连接现有各孤立应用系统，以图形化、拖拽方式构建集成流程和服务，提高应用系统集成工作效率，降低异构系统集成风险。针对未来可能出现的业务需求变更，在应用集成平台上进行动态调整，实现各应用系统之间的集成策略平滑升级。