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

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

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

对接系统：时空智友

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

数据对接方案

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

汤臣倍健营销云接口明细

接口：/erp/api/order/query/saleReturnOrder
接口名称：查询下级退货入库订单接口
接口方法：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 othernumber原始单号string营销云单号 opertime业务日期string approverId审批人idstring linknumber关联订单号string关联的源单号 organName客户名string organid客户idstring contacts发货人string phone发货电话string shippingAddress发货地址string sourceBillType来源订单类型string211：下级退货订单 status订单状态string0：未审核，1：已审核（已出库） subtype单据类型string212：下级退货入库单 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 itemList.extCusCode外围系统客户编码string如果在营销云有维护就有该字段

时空智友接口明细

API：/formservice?service=OMSService.storageIn
NAME：新增入库信息(ifPurIn)
METHOD：POST

请求参数

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

系统数据集成价值

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

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