系统数据集成方案

汤臣倍健营销云与畅捷通T+对接集成查询盘点单明细连通创建其他入库单(HT汤臣盘点明细->其它入库(盘盈))

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

对接系统：畅捷通T+

数据接口配置方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的/erp/api/order/query/stocktakingOrder作为数据对接来源。然后再写入目标平台配置目标系统为畅捷通T+，并且选择对应连接器（关于畅捷通T+的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的/tplus/api/v2/otherReceive/Create接口作为数据写入动作完成第一步的接口配置。

汤臣倍健营销云接口明细

• 接口：/erp/api/order/query/stocktakingOrder
• 接口名称：查询盘点单明细
• 接口方法：POST

请求参数

字段	名称	类型	描述
tenantId	经销商id	string	经销商id(必填,营销云id)如：34cc4109705e4c058b7b3b0352e57d31
number	盘点单号	string	如：PDD0000000293，传此参数时,其他时间状态等条件无效
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
task_id	关联盘点任务id	string
linknumber	仓库id	string	关联订单号
bill_type	单据类型	string	盘点单:400
diff_ratio	差异控制比例	string
stock_process_status	盘点单状态	string
stock_process_msg	盘点单状态信息	string
status	状态	string
store_status	锁状态	string
device_id	设备id	string
version	版本号	string
lastUpdateTime	更新时间	string
has_diff	是否存在差异	string	-1：N/A，0：不存在（默认） 1：存在，2：已发送差异
stock_type	0：单品，1：全品	string
remark	差异备注信息	string
difference_sum	全品总数量	string
itemList	商品列表	array
itemList.id	明细行id	string
itemList.tenantId	公司id	string
itemList.tenantName	公司名称	string
itemList.createtime	创建时间	string
itemList.deleteFlag	是否已删除	string	0：否，1：是
itemList.headerid	盘点单id	string
itemList.materialId	产品id	string
itemList.materialName	产品名称	string
itemList.materialNumber	产品编码	string
itemList.helpcode	助记码	string
itemList.lot	批次	string
itemList.mfg	生产日期	string
itemList.exp	到期日期	string
itemList.depotid	仓库id	string
itemList.depotNo	仓库编号	string
itemList.depotName	仓库名称	string
itemList.stock_num	盘点数量	string
itemList.store_num	账面数量	string
itemList.diff_num	差异数量	string
itemList.diff_rate	差异比例	string	差异比例，1->100%
itemList.diff_type	差异类型	string	YES, 库存校验通过;NOT_EXIST, 库存信息不存在;NUM_ERR”, 库存信息不存在;
itemList.pda_detail_id	pda明细id	string
itemList.verdue_flag	是否过期标识	string
itemList.updateTime	更新时间	string
itemList.extMaterialNo	外围系统产品编码	string

畅捷通T+接口明细

• 接口：/tplus/api/v2/otherReceive/Create
• 接口名称：创建其他入库单
• 接口方法：POST

请求参数

字段	名称	类型	描述
ExternalCode	外部单据号	string	外部单据号,后台做唯一性检查。用于防止重复提交，和外系统数据对应。
Code	单据编码	string
VoucherType	单据类型	string	单据类型。默认值{Code:"ST1024"}
VoucherDate	单据日期	string
BusiType	业务类型	string	业务类型编码。取值范围： 13--其他 14--其他退库
RdStyle	出库类别	string
Warehouse	仓库信息	string
Department	部门信息	string
Clerk	经手人信息	string
Memo	表头备注	string
RDRecordDetails	单据明细信息	array
RDRecordDetails.Inventory	存货信息	string
RDRecordDetails.Project	项目信息	string
RDRecordDetails.ExpiryDate	失效日期	string	失效日期，可不录，选项批号自动带出时，带出该值。如果已录批号，存货启用有效期管理，不能为空
RDRecordDetails.InvLocation	货位信息	string
RDRecordDetails.Batch	批号	string	批号，可不录，有批号自动带出时，带出，并且带出相关信息
RDRecordDetails.BaseQuantity	主计量单位数量	string
RDRecordDetails.Amount	成本金额	string
RDRecordDetails.Price	成本单价	string
RDRecordDetails.dataKey	dataKey	string

数据对接价值

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

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