从汤臣倍健营销云到时空智友通过接口配置打通数据

接入系统:汤臣倍健营销云
汤臣倍健营销云是覆盖公域私域、线上线下的全场景的数字化营销平台。基于全触点数据构建全域标签体系,助力企业在自营平台、微信生态等全渠道上精准触达用户,自动化营销互动,实时反馈效果,真正实现营销数字化。
对接目标平台:时空智友
时空智友是北京时空智友科技有限公司旗下品牌。北京时空智友科技有限公司(以下简称智友科技),成立于2011年6月,是注册于北京海淀中关村西区的一家高科技技术服务企业。公司的理念是用数据服务于“智慧的城市”,帮助商业用户成为数据城市的结点,与整个城市的商业数据流融会贯通。随着互联网的深入发展,网络的普及,人们的协同工作变得越来越便捷,无国界,无边界,无时间界限,公司面向流通领域,全面提供具有云应用的软件产品
配置集成方案
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:汤臣倍健营销云的接口参数设置,以及设定好目标平台:时空智友的映射,即可启动方案进行测试

汤臣倍健营销云接口明细
- 调用接口:/openapi-basesubject/order/queryOrderHead
- 接口名称:门户-查询订单表头&表体组合
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
orgId | 组织ID | string | 774e22f1658542c2a1e887e39c6e2acb |
page | 页码 | string | 1 |
id | 订单id | string | |
applyerId | 要货方id | string | |
supplierId | 供货方id | string | |
no | 订单号 | string | |
distributionType | 分销类型 | string | |
distributorId | 分销商id | string | |
orderStatus | 订单状态 | string | 3 |
createDt | 创建时间 | string | |
orderTypeCode | 订单类型,如普通订单、直运销售 | string | |
isDeliveryFreezed | 是否暂停发货 | string | |
nature | 订单分类 | string | |
relatedApplyerId | 关联交易经销商id | string | |
saleDistribution | 销售渠道 | string | |
disApplyerId | 分销商id | string | |
startDt | 订单时间(开始) | string | |
endDt | 订单时间(结束) | string | |
appStartDt | 审批时间(开始) | string | {{LAST_SYNC_TIME datetime}} |
appEndDt | 审批时间(结束) | string | {{CURRENT_TIME datetime}} |
lastStartDt | 最后修改时间(开始) | string | |
lastEndDt | 最后修改时间(结束) | string | |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
applyerId | 要货方id | string | |
supplierId | 供货方id | string | |
no | 订单号 | string | |
distributionType | 分销类型 | string | |
distributorId | 分销商id | string | |
orgId | 订单组织 | string | |
orderStatus | 订单状态 | string | |
createDt | 创建时间 | string | |
contractNo | 合同编号 | string | |
isReport | 是否随批报告 | string | |
predictArriveDt | 预计到货日期 | string | |
deliveryLevelCode | 发货优先级 | string | |
orderTypeCode | 订单类型,如普通订单、直运销售 | string | |
isDeliveryFreezed | 是否暂停发货 | string | |
taxCode | 税码 | string | |
areaCode | 区域id | string | |
currencyCode | 币种 | string | |
settlementModeCode | 结算方式 | string | |
deliveryCode | 交货方式 | string | |
isCreditManaged | 是否信用暂挂 | string | |
salesman | 订单销售人员 | string | |
relatedApplyerId | 关联交易经销商id | string | |
saleDistribution | 销售渠道 | string | |
nature | 订单分类,如要货单、退货单 | string | |
actGiftQuantity | 实际审批数量 | string | |
giftQuantity | 赠品数量 | string | |
province | 省份 | string | |
city | 城市 | string | |
county | 县城 | string | |
newExchangeOrder | 是否新的积分订单绑定方式(婴童特殊要求,值为1是,没有值或0为否) | string | |
contacts | 收货联系人 | string | |
phone | 收货联系人电话 | string | |
storagePlace | 仓库归属地 | string | |
shippingAddress | 收货地址 | string | |
expectDate | 预计到达天数 | string | |
disApplyerId | 分销商id | string | |
freeGiftTotal | 免费赠品余量 | string | |
discountTotalMoney | 产品折让总额 | string | |
returnedMoney | 应退金额 | string | |
retunsOvertopMoney | 退货超额金额 | string | |
remainMoney | 折让后金额 | string | |
fineMoney | 罚金金额 | string | |
totalMoney | 总金额 | string | |
netDiscountTotalMoney | 网络品&赠品折让总额 | string | |
netDiscountCanuseMoney | 网络品(产品)使用网络品&赠品可用总额 | string | |
netDiscountMoney | 网络品(产品)实际使用网络品&赠品折让金额 | string | |
netGiftDiscountCanuseMoney | 赠品使用网络品&赠品可用总额 | string | |
netGiftDiscountMoney | 赠品实际使用网络品&赠品折让金额 | string | |
fullDiscountTotalMoney | 全品折让总额 | string | |
fullDiscountCanuseMoney | 产品使用全品可用总额 | string | |
fullDiscountMoney | 产品实际使用全品折让金额 | string | |
fullGiftDiscountCanuseMoney | 赠品使用全品可用总额 | string | |
fullGiftDiscountMoney | 赠品实际使用全品折让金额 | string | |
retunsFullyMoney | 全额退款金额 | string | |
orderContacts | 订单联系人 | string | |
orderPhone | 订单联系人电话 | string | |
orderDt | 订单时间 | string | |
approveDt | 审批时间 | string | |
lastUpdateDt | 最后更新时间 | string | |
clientAppNo | 经销商外围系统编码 | string | |
partnerName | 经销商名称 | string | |
orgName | 租户名称 | string | |
details | 明细 | array | |
details.id | 明细Id | string | |
details.discountMoney | 折扣后金额 | string | |
details.quantity | 下单数量 | string | |
details.productId | 产品id | string | |
details.productName | 产品名称 | string | |
details.productNo | 产品编码 | string | |
details.spec | 规格 | string | |
details.unitCode | 单位 | string | |
details.minUnit | 包装数 | string | |
details.basePrice | 统一价 | string | |
details.price | 供货价 | string | |
details.actQuantity | 审批数量 | string | |
details.money | 金额 | string | |
details.type | 类型 | string | |
details.isFree | 是否免费 | string | |
details.discountAmount | 折扣额 | string | |
details.discountPrice | 折扣后单价 | string | |
details.discountRate | 折扣率 | string | |
details.itemDiscountMoney | 普通行折让 | string | |
details.itemFullDiscountMoney | 全品行折让 | string | |
details.itemNetDiscountMoney | 网络品&赠品行折让 | string | |
details.easNo | 产品长编码 | string | |
details.extNo | 产品外围编码 | string | |
details.batchNum | 产品批次号 | string | |
时空智友接口明细
- API:/formservice?service=OMSService.storageOut
- NAME:新增出库信息(ifSaleOut)
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
RouteName | 线路 | | |
orgId | 组织机构编码 | O334MJVYSGL | 系统后台默认 |
ownerId | 货主编码 | K182SQADU6L | 系统后台默认 |
yaojianFlag | 药检报告 | | 0不需要,1需要,不传值系统默为0 |
billcode | 订单号 | {{no}} | |
SterilCode | 灭菌批号 | | |
zengpFlag | 赠品状态 | | y有赠品n无赠品 |
billsn | 订单行号 | 1 | |
taskType | 数据类型 | 210 | 110采购订单214销退入库;114采退出库210销售订单,120采购入库,220销售出库 |
goodsFlag | 首营品种打印 | | 0不打印,1打印 |
transType | 送货类型 | | 1正常,2,送货到家,3分包到家 |
dates | 开票日期 | {{createDt date}} | |
rebillcode | 对应采购单号 | | |
businessId | 单位ID | {{clientAppNo}} | |
rebillcode | 销售订单 | {{no}} | |
Remark1 | 备注 | 来自营销云 | 明细备注 |
businessCode | 单位编号 | {{clientAppNo}} | |
Isdone | 已完成 | | 已同步到ksoa |
address | 送货地址 | | |
createTime | 创建时间 | {{createDt}} | |
goodsId | 商品系统编号 | {{details_extNo}} | |
batchCode | 批号 | {{details_batchNum}} | |
valDate | 效期 | | |
produceDate | 生产日期 | | |
num | 销售数量 | {{details_actQuantity}} | 最多保留4位小数 |
taxPrice | 销售单价 | {{details_price}} | 最多保留4位小数 |
taxAmount | 销售金额 | {{details_money}} | 最多保留2位小数 |
remark | 备注 | 来自营销云 | |
Priority | 发货优先级 | 3 | 不传值默认为3 |
rebillsn | rebillsn | 1 | |
系统打通概况
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:时空智友与汤臣倍健营销云之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。
