汤臣倍健营销云和畅捷通T+集成接口设计

汤臣倍健营销云和畅捷通T+集成接口设计

源系统:汤臣倍健营销云

汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系，助力企业在自营平台、微信生态等全渠道上精准触达用户，自动化营销互动，实时反馈效果，真正实现营销数字化。

写入目标:畅捷通T+

畅捷通T+是一款新型互联网企业管理软件，全面满足成长型小微企业对其灵活的业务流程的管控需求，重点解决往来业务管理、订单跟踪、资金、库存等管理难题。产品支持您通过各种固定或移动设备随时迅速获取企业实时、动态的运营信息，以及随时随地，实时掌握的特性带给您全新的体验感受。

数据对接方案

通过系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：汤臣倍健营销云，然后选择对应的连接器。选择对应的/openapi-basesubject/order/queryOrderHead作为数据对接来源。然后再写入目标平台配置目标系统为畅捷通T+，并且选择对应连接器。选择好对应的/tplus/api/v2/saleOrder/Create接口作为数据写入动作完成第一步的接口配置。通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。

汤臣倍健营销云接口明细

• API：/openapi-basesubject/order/queryOrderHead
• NAME：门户-查询订单表头&表体组合
• METHOD：POST

请求参数

接口字段名称预设值 orgId组织IDc8e67c8502014070a71e50329c142597,2e26f821434f49959258f76de0318e4d,7d5f1c3ab1604721984f2169e0f3f5d2,b1af15b39dfe4a2a918b1b866855c6d8,50f55dbc0d314eddb4e3cb549675f9a2,fc39b510ee8a4878aeb1f95c57f31902 page页码1 id订单id applyerId要货方id supplierId供货方id no订单号 distributionType分销类型 distributorId分销商id orderStatus订单状态 createDt创建时间 orderTypeCode订单类型,如普通订单、直运销售 isDeliveryFreezed是否暂停发货 nature订单分类 relatedApplyerId关联交易经销商id saleDistribution销售渠道 disApplyerId分销商id startDt订单时间（开始） endDt订单时间（结束） appStartDt审批时间（开始） appEndDt审批时间（结束） lastStartDt最后修改时间（开始）{{LAST_SYNC_TIME datetime}} lastEndDt最后修改时间（结束）2024-09-09 14:12:13

响应参数

接口字段名称预设值 applyerId要货方id supplierId供货方id no订单号 distributionType分销类型 distributorId分销商id orgId订单组织 orderStatus订单状态 createDt创建时间 contractNo合同编号 isReport是否随批报告 predictArriveDt预计到货日期 deliveryLevelCode发货优先级 orderTypeCode订单类型,如普通订单、直运销售 isDeliveryFreezed是否暂停发货 taxCode税码 areaCode区域id currencyCode币种 settlementModeCode结算方式 deliveryCode交货方式 isCreditManaged是否信用暂挂 salesman订单销售人员 relatedApplyerId关联交易经销商id saleDistribution销售渠道 nature订单分类，如要货单、退货单 actGiftQuantity实际审批数量 giftQuantity赠品数量 province省份 city城市 county县城 newExchangeOrder是否新的积分订单绑定方式（婴童特殊要求，值为1是，没有值或0为否） contacts收货联系人 phone收货联系人电话 storagePlace仓库归属地 shippingAddress收货地址 expectDate预计到达天数 disApplyerId分销商id freeGiftTotal免费赠品余量 discountTotalMoney产品折让总额 returnedMoney应退金额 retunsOvertopMoney退货超额金额 remainMoney折让后金额 fineMoney罚金金额 totalMoney总金额 netDiscountTotalMoney网络品&赠品折让总额 netDiscountCanuseMoney网络品(产品)使用网络品&赠品可用总额 netDiscountMoney网络品(产品)实际使用网络品&赠品折让金额 netGiftDiscountCanuseMoney赠品使用网络品&赠品可用总额 netGiftDiscountMoney赠品实际使用网络品&赠品折让金额 fullDiscountTotalMoney全品折让总额 fullDiscountCanuseMoney产品使用全品可用总额 fullDiscountMoney产品实际使用全品折让金额 fullGiftDiscountCanuseMoney赠品使用全品可用总额 fullGiftDiscountMoney赠品实际使用全品折让金额 retunsFullyMoney全额退款金额 orderContacts订单联系人 orderPhone订单联系人电话 orderDt订单时间 approveDt审批时间 lastUpdateDt最后更新时间 clientAppNo经销商外围系统编码 partnerName经销商名称 orgName租户名称 details明细 details.id明细Id details.discountMoney折扣后金额 details.quantity下单数量 details.productId产品id details.productName产品名称 details.productNo产品编码 details.spec规格 details.unitCode单位 details.minUnit包装数 details.basePrice统一价 details.price供货价 details.actQuantity审批数量 details.money金额 details.type类型 details.isFree是否免费 details.discountAmount折扣额 details.discountPrice折扣后单价 details.discountRate折扣率 details.itemDiscountMoney普通行折让 details.itemFullDiscountMoney全品行折让 details.itemNetDiscountMoney网络品&赠品行折让 details.easNo产品长编码 details.extNo产品外围编码 details.batchNum产品批次号

畅捷通T+接口明细

• API：/tplus/api/v2/saleDelivery/Create
• NAME：创建销售订单
• METHOD：POST

请求参数

接口字段名称预设值 VoucherDate单据日期{{createDt}} Code编码{{no}} ExternalCode外部编码{{no}} BusinessType业务类型15 Customer客户{{clientAppNo}} SaleDeliveryDetails明细details SaleDeliveryDetails.Inventory存货{{details.extNo}} SaleDeliveryDetails.Quantity数量{{details.actQuantity}} SaleDeliveryDetails.Batch批号{{details.batchNum}} SaleDeliveryDetails.OrigTaxPrice含税价{{details.price}} SaleDeliveryDetails.Warehouse仓库{{orgId}} SaleDeliveryDetails.IsPresent是否赠品_function case '{{isFree}}' when '是' then 'true' else 'false' end SaleDeliveryDetails.Memo备注{{orgName}}-(from营销云系统) SaleDeliveryDetails.dataKeydataKeydto

数据对接价值

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