畅捷通T+和汤臣倍健营销云单据接口对接
源系统:汤臣倍健营销云
汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系,助力企业在自营平台、微信生态等全渠道上精准触达用户,自动化营销互动,实时反馈效果,真正实现营销数字化。
对接目标平台:畅捷通T+
“T+”是一款灵动、智慧、时尚的互联网管理软件,主要针对中小型工贸和商贸企业的财务业务一体化应用,融入了社交化、移动化、物联网、电子商务、互联网信息订阅等元素。产品全面适应最新2013《小企业会计准则》,为企业打造全新的生意模式、管理模式、工作模式。与传统管理软件相比,“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 | |
系统对接总览
异构系统都具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下,这两个系统都是分别独立部署和运行的,各自拥有不同的技术栈和编程模型,甚至两者在系统平台、技术平台和编程语言上是完全异构的。采用“轻易云集成方案”的解决方案,可以满足客户的实际业务需求,推动软件工程的规范化,使开发人员遵循统一的概要设计开发实现,降低系统实现的风险,做到系统设计资料的规范性与全面性,以利于系统的实现、测试、维护、版本升级等。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。
系统数据对接方案元数据代码