从汤臣倍健营销云到畅捷通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/saleDispatch/Create
接口名称：创建销售出库单
接口方法：POST

请求参数

字段	名称	类型	描述
ExternalCode	外部系统数据编号	string	外部系统数据编号；OpenAPI调用者填写,后台做唯一性检查。用于防止重复提交，和外系统数据对应
Code	单据编码	string
Customer	客户	string
Partner	客户	string	客户，PartnerDTO对象，客户信息。
VoucherDate	单据日期	string
BusiType	业务类型	string
Warehouse	仓库	string
DispatchAddress	送货地址	string
TransDocNo	运单号	string
DeliveryCode	发货单号	string
Memo	备注	string
RDRecordDetails	物料明细	array
RDRecordDetails.Inventory	存货	string
RDRecordDetails.BaseQuantity	数量	string
RDRecordDetails.Batch	批号	string
RDRecordDetails.origTaxSalePrice	含税售价	string
RDRecordDetails.DetailMemo	明细备注	string
RDRecordDetails.Price	成本单价	string
RDRecordDetails.Amount	成本金额	string
RDRecordDetails.VoucherType	单据类型	string	不知道什么傻逼鬼东西，接口文档没有说，只有示例
RDRecordDetails.dataKey	dataKey	string

系统集成总览

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。