汤臣倍健营销云与畅捷通T+对接集成查询下级退货入库订单接口打通创建销货单|轻易云数据集成平台

汤臣倍健营销云与畅捷通T+对接集成查询下级退货入库订单接口打通创建销货单

来源系统:汤臣倍健营销云

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

接入系统：畅捷通T+

畅捷通T+是一款新型互联网企业管理软件，全面满足成长型小微企业对其灵活的业务流程的管控需求，重点解决往来业务管理、订单跟踪、资金、库存等管理难题。产品支持您通过各种固定或移动设备随时迅速获取企业实时、动态的运营信息，以及随时随地，实时掌握的特性带给您全新的体验感受。

系统对接接口配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的查询下级退货入库订单接口作为数据对接来源。然后再通过写入目标平台配置目标系统为畅捷通T+,并且选择对应连接器（关于畅捷通T+的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的创建销货单接口作为数据写入动作，既可以完成第一步的数据对接配置。

汤臣倍健营销云接口明细

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

畅捷通T+接口明细

接口：/tplus/api/v2/saleDelivery/Create
接口名称：创建销货单
接口方法：POST

请求参数

字段	名称	类型	描述
Code	单据编号	string	单据编码；如果设置了自动编号，可不传；如果设置的手动编码，必录
VoucherDate	单据日期	string	单据日期；默认系统日期
ExternalCode	外部单号	string	外部系统单据编码，编码必须唯一，且此字段不为空
BusinessType	业务类型	string	业务类型，BusiTypeDTO对象；
Customer	客户	string
Memo	备注	string
SaleDeliveryDetails	销货明细	array
SaleDeliveryDetails.Warehouse	仓库	string
SaleDeliveryDetails.Inventory	存货	string
SaleDeliveryDetails.Batch	批次号	string
SaleDeliveryDetails.Quantity	数量	string
SaleDeliveryDetails.TaxRate	税率	string
SaleDeliveryDetails.OrigTaxPrice	含税价	string
SaleDeliveryDetails.IsPresent	是否赠品	string
SaleDeliveryDetails.dataKey	dataKey	string

系统数据对接

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