汤臣倍健营销云和畅捷通T+接口打通对接实战
对接源平台:汤臣倍健营销云
汤臣倍健创立于1995年,2002年系统地将膳食营养补充剂(VDS)引入中国非直销领域,2010年12月15日,汤臣倍健在深圳交易所创业板挂牌上市,并迅速成长为中国膳食营养补充剂领导品牌和标杆企业。2018年,汤臣倍健收购澳大利亚益生菌品牌Life-Space,同年5月,收购拜耳旗下具有80多年历史的儿童营养补充剂品牌Pentavite。欧睿数据显示,2020年汤臣倍健以10.3%的市场份额位居中国维生素与膳食补充剂行业第一位。汤臣倍健逐步发展为全球膳食营养补充剂行业领先者
集成系统:畅捷通T+
“T+”是一款灵动、智慧、时尚的互联网管理软件,主要针对中小型工贸和商贸企业的财务业务一体化应用,融入了社交化、移动化、物联网、电子商务、互联网信息订阅等元素。产品全面适应最新2013《小企业会计准则》,为企业打造全新的生意模式、管理模式、工作模式。与传统管理软件相比,“T+”更强调企业管理向企业经营的转变、等级化管人向平等化用人理念的转变。
数据接口配置方案
轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线,所以对接方案的配置极其重要,方案可以选择一键复制,轻易云有海量的对接方案可支持一键复制,复制后直接启动使用(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置,配置只要确认源平台:汤臣倍健营销云的取数逻辑,例如什么时间取什么样的数据。即可完成配置,目标平台:畅捷通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 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。
系统数据对接方案元数据代码