有赞云开发者大赛 - 服装行业定制场景文档

目标场景

服装行业商家在接入有赞商城时,希望可以修改和定制有赞微商城的商品属性和下单流程,买家在查看商品和下单过程中,能够展示和填写服装定制信息及身体数据信息,从而适配服装定制的电商场景。商家在后台也能进行定制商品管理,模板管理及修改订单中定制商品的制作状态。

业务流程

B 端定制商品发布流程

C 端交易流程

备注:以下技术方案不包括购物车实现

技术方案

商品发布 & 商品详情

1. 商家发布服装定制商品时,需设置商品关联的服装定制模版及身体数据模版,调用商品详情 API(youzan.item.get )获取通用商品信息,在有赞云 ISV 应用中实现通用商品关联模板并保存

2. 买家查看服装定制商品时,在有赞云 ISV 应用中实现商品详情页前端扩展,在商品详情页展示服装定制信息,并将“立即购买”文案修改为“立即定制”。

标准 SKU(尺寸、颜色等)等选择流程与通用商品一致,“下一步”按钮需定制,点击后进入服装定制页面,此中间页由开发者自行开发,从有赞云 ISV 应用中读取商品关联的服装定制模板及身体信息模板,买家在服装定制页面可选择服装样式和添加身体信息。

买家下单

1. 买家定制服装完成后,触发下单流程。

• 调用买家下单 API ,接口会返回 book_key 和下单页 url,需要将下单页 url 返回给客户端,买家访问下单页 url 填写收货地址等信息后才能提交订单。

• 将服装样式和身体数据统称为定制信息,在订单正式创建前,即买家点击“提交订单”前,可以将 {book_key, 定制信息},存放在缓存中。

• 需在有赞云 ISV 应用实现下单页前端扩展,根据下单页 url 中的 book_key 到有赞云 ISV 中查询,获取商品信息和定制信息,在下单页展示定制商品信息。

2. 买家访问下单页提交订单,在有赞云 ISV 应用实现订单创建消息扩展点 ,监听订单创建消息并保存订单。

商品制作进度

1. 买家支付后,在有赞云 ISV 应用实现支付成功消息扩展点,记录买家付款信息,更新订单状态。商家后台可修改定制商品制作进度,关联至订单信息中。

2. 买家访问订单详情,在有赞云 ISV 应用实现订单详情页前端扩展,调用订单详情 API(youzan.trade.get ),根据订单号查询 book_key,获取 book_key 后到有赞云 ISV 应用中查询该笔订单的定制信息及商品制作进度,并在订单详情页展示。

涉及扩展点 /API

扩展点 /API 名称 应用场景
商品详情 / 下单页 / 订单详情前端扩展点 实现前端定制
下单成功消息扩展点 即订单创建消息,监听该消息保存新订单
支付成功消息扩展点 支付成功消息,监听该消息记录买家付款信息,更新订单状态
youzan.item.get 获取单个商品信息
买家下单 API 下单入口,获取下单页 url
youzan.trade.get 获取订单详情