畅捷通T+对接外部汤臣倍健营销云系统
对接源平台:汤臣倍健营销云
汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系，助力企业在自营平台、微信生态等全渠道上精准触达用户，自动化营销互动，实时反馈效果，真正实现营销数字化。
目标系统:畅捷通T+
畅捷通T+是一款新型互联网企业管理软件，全面满足成长型小微企业对其灵活的业务流程的管控需求，重点解决往来业务管理、订单跟踪、资金、库存等管理难题。产品支持您通过各种固定或移动设备随时迅速获取企业实时、动态的运营信息，以及随时随地，实时掌握的特性带给您全新的体验感受。
数据接口配置
通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的/erp/api/order/query/saleReturnOrder作为数据对接来源。然后再写入目标平台配置目标系统为畅捷通T+，并且选择对应连接器。选择好对应的/tplus/api/v2/saleDelivery/Create接口作为数据写入动作完成第一步的接口配置。数据管道ETL：构建一体化的数据融合平台。高级数据转换： 支持公式转换数据格式、支持脚本直接进行数据转换、支持可视化多维度数据处理。高性能实时处理：针对不同数据节点类型提供TB级吞吐量，秒级延迟的增量数据处理能力。自动将旧版web服务转变为基于云端微服务的API，统一接口输出标准。支持接口开放服务，实现内外部能力接入。
汤臣倍健营销云接口明细
- 接口：/erp/api/order/query/saleReturnOrder
- 接口名称：查询下级退货入库订单接口
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| number | 系统订单号 | string |
| pageNo | 页码 | string |
| yxyNumber | 营销云销售订单号 | string |
| tenantId | 经销商id | string |
| beginTime | 开始时间 | string |
| endTime | 结束时间 | string |
| pageSize | 每页条数 | string |
| status | 订单状态 | string |
| timeType | 时间段标志 | string |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| 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/saleDelivery/Create
- 接口名称：创建销货单
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| Code | 单据编号 | string | |
| VoucherDate | 单据日期 | string | |
| ExternalCode | 外部单号 | string | |
| BusinessType | 业务类型 | string | |
| Customer | 客户 | string | |
| Memo | 备注 | string | |
| SaleDeliveryDetails | 销货明细 | array | |
| SaleDeliveryDetails.Warehouse | 仓库 | string | |
| SaleDeliveryDetails.Inventory | 存货 | string | |
| SaleDeliveryDetails.Batch | 批次号 | string | |
| SaleDeliveryDetails.Quantity | 数量 | string | |
| SaleDeliveryDetails.OrigPrice | 报价 | string | |
| SaleDeliveryDetails.TaxRate | 税率 | string | |
| SaleDeliveryDetails.OrigTaxPrice | 含税价 | string | |
| SaleDeliveryDetails.IsPresent | 是否赠品 | string | false |
| SaleDeliveryDetails.dataKey | dataKey | string | dto |
系统对接概况
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
