系统数据集成方案

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

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

接入系统：畅捷通T+

数据接口配置方案

集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：汤臣倍健营销云，源系统 API：查询采购入库订单接口，目标系统：畅捷通T+，目标系统 API创建进货单。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。

汤臣倍健营销云接口明细

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

畅捷通T+接口明细

• 接口：/tplus/api/v2/purchaseArrival/Create
• 接口名称：创建进货单
• 接口方法：POST

请求参数

字段	名称	类型	描述
ExternalCode	外部单号	string
Code	单号	string	单据编号 单据编码设置里，如果设置了自动编码，可以不传值 单据编码设置里，如果设置了手动编码，必须传值
VoucherDate	单据日期	string
BusinessType	业务类型	string
Partner	往来单位	string
Memo	备注	string
VoucherDetails	单据明细信息	array
VoucherDetails.Inventory	存货	string
VoucherDetails.Batch	批号	string
VoucherDetails.Quantity	数量	string
VoucherDetails.OrigDiscountPrice	含税价	string
VoucherDetails.ExpiryDate	有效期	string
VoucherDetails.ProductionDate	生产日期	string
VoucherDetails.Warehouse	仓库	string
VoucherDetails.dataKey	dataKey	string

系统集成总览

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

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