-
背景（谁？什么问题？有什么影响？为什么？）
ui图：https://www.figma.com/design/R8QFuJz7Qqvn7gxfdVxCs9/TikTok%E4%B8%93%E7%89%88?node-id=8871-9259&t=BX0oEzdjzEbnBZaw-0
-
需求（做什么？怎么做？有什么要注意的？）
-
新增达人订单页面
（1）字段说明
|
系统字段
|
接口返回字段
|
数据处理逻辑
|
交互说明
|
|
平台单号
|
main_order_id
|
|
|
|
店铺账号
|
|
插件上绑定数据是什么店铺就是什么店铺的数据
|
|
|
订单状态
|
order_status
|
1=Processing
2=Completed
3=Cancelled
|
|
|
总数量
|
|
订单中SKU数量之和
|
|
|
总金额
|
|
订单中所有SKU数量*SKU单价之和
|
|
|
总预估佣金
|
|
订单中所有预估佣金之和
|
|
|
总实际佣金
|
|
订单中所有实际佣金之和
|
|
|
创建时间
|
create_time
|
订单创建时间
|
|
|
妥投时间
|
delivery_time
|
订单妥投时间
|
|
|
系统更新时间
|
|
系统更新此订单的时间
|
|
|
商品图片
|
thumbnail.url_list
|
根据店铺+product id去获取OSS中的商品图片
|
|
|
商品名称
|
sku_detail.product_name
|
|
|
|
SKU名称
|
sku_detail.sku_info
|
|
|
|
Product ID
|
sku_detail.product_id
|
|
|
|
SKU数量
|
sku_detail.quantity
|
|
|
|
SKU单价
|
sku_detail.price
|
|
|
|
达人名称
|
sku_detail.creator_nickname
|
|
|
|
达人账号
|
sku_detail.creator_username
|
|
|
|
达人ID
|
sku_detail.creator_oec_id
|
仅保存在库，不在界面显示
|
|
|
佣金比例
|
sku_detail.cos_ratio
|
|
|
|
预估佣金基数
|
sku_detail.estimated_amount
|
|
|
|
预估佣金
|
sku_detail.estimated_cos_fee
|
|
|
|
实际佣金基数
|
sku_detail.actual_amount
|
|
|
|
实际佣金
|
sku_detail.actual_cos_fee
|
|
|
|
退款数量
|
sku_detail.refund_number
|
|
|
|
退货数量
|
sku_detail.return_number
|
|
|
|
定向邀约ID
|
plan.plan_id
|
|
|
|
定向邀约类型
|
plan.plan_type
|
仅保存但是在列表上不显示
|
|
|
推广类型
|
promotion_position.promotion_position_type
|
2=视频
|
|
|
视频ID
|
promotion_position.id
|
将视频ID组装到以下链接中就能跳转到对应的视频中
https://www.tiktok.com/@notprincetv/video/7363102131999624491?shop_region=US
|
点击视频跳转新标签页。
点击链接icon则复制链接地址
|
（2）筛选功能
①支持以下ID的筛选。输入单个的时候支持模糊搜索。输入多个的时候支持精确搜索。
订单号
定向邀约ID
达人账号
视频ID
②支持以下时间的筛选
订单创建时间
订单妥投时间
③订单状态枚举值如下。支持多选筛选
Processing
Completed
Cancelled
④佣金比例支持按照数字区间筛选如下。注意如果一个订单内有多个SKU，只要有一个SKU的佣金比例符合筛选区间则可以筛选出来
⑤店铺账号，支持多选店铺进行筛选
（3）按钮
①【备注】。支持勾选多个订单进行备注，备注后再备注新的内容则进行覆盖
如果设置的是空白的内容，则认为是删除已有备注
②排序按钮
默认按照订单创建时间降序排序。
支持按照订单创建时间、订单妥投时间进行升序降序排序。
2.新增达人视频页面
（1）字段说明
|
系统字段
|
数据来源
|
数据处理逻辑
|
交互说明
|
？提示
|
|
视频信息
|
|
|
|
通过定向邀约达人为邀约中的商品制作的视频
|
|
视频缩略图
|
定向邀约任务
|
通过插件获取到的定向邀约任务获取到新视频都需要在此列表中展示。此处显示对应视频缩略图
|
点击此缩略图新开浏览器标签页跳转到对应tiktok视频页面
|
|
|
视频名称
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频名称
|
点击则新开浏览器标签页跳转到对应tiktok视频页面
|
|
|
视频ID
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频ID
|
|
|
|
视频发布时间
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频发布时间
|
|
|
|
达人名称
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频关联达人的达人名称
|
|
|
|
达人账号
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频关联达人的达人账号
|
|
|
|
达人二维码
|
达人管理
|
通过达人账号关联去获取达人的二维码
|
点击出现二维码的弹窗页面
|
|
|
视频播放量
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频的播放量
|
|
|
|
视频点赞量
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频的点赞量
|
|
|
|
视频评论数
|
定向邀约任务
|
取值通过定向邀约任务中获取到的视频的评论数
|
|
|
|
商品信息
|
|
|
|
|
|
商品图片
|
定向邀约任务
|
定向邀约任务中视频关联的商品的商品图片
|
|
|
|
商品名称
|
定向邀约任务
|
定向邀约任务中视频关联的商品的商品名称
|
|
|
|
店铺
|
定向邀约任务
|
定向邀约任务关联的店铺
|
|
|
|
Product id
|
定向邀约任务
|
定向邀约任务中视频关联的商品的Product id
|
|
|
|
商品价格
|
定向邀约任务
|
定向邀约任务中视频关联的商品的价格区间
|
|
|
|
邀约信息
|
|
|
|
此视频关联的定向邀约。如果此定向邀约不是通过系统创建的则无法查看邀约详情
|
|
定向邀约目标
|
定向邀约目标
|
定向邀约目标关联的定向邀约目标的名称
|
点击新开标签页显示定向邀约目标详情
|
|
|
定向邀约任务
|
定向邀约任务
|
定向邀约任务名称
|
点击出现定向邀约目标的弹窗。
如果这个定向邀约任务不是通过系统创建的则则此项名称无法点击
|
|
|
任务有效期
|
定向邀约任务
|
定向邀约任务有效期
|
|
|
|
佣金比例
|
定向邀约任务
|
定向邀约任务这个SKU的佣金比例
|
|
|
|
预估佣金
|
定向邀约任务
|
定向邀约任务这个SKU的预估佣金
|
|
|
|
销售情况
|
|
|
|
通过视频ID找到通过视频出单的订单并且进行统计。统计时包含退款、退货、取消的订单。
|
|
GMV
|
达人订单
|
关联视频ID内所有订单的总金额的和
|
|
|
|
销量
|
达人订单
|
关联视频ID内所有订单的总数量的和
|
|
|
|
订单量
|
达人订单
|
关联视频ID内所有订单的和
|
点击跳转到达人订单页面并且输入视频ID将对应的订单筛选出来
|
|
|
预估佣金
|
达人订单
|
关联视频ID内所有订单预估佣金的和
|
|
|
|
实际佣金
|
达人订单
|
关联视频ID内所有订单实际佣金的和
|
|
|
|
时间
|
|
|
|
视频发布时间是直接从平台获取到的，无时区概念。系统创建时间和系统更新时间是系统时间，默认是北京时间
|
|
视频发布时间
|
定向邀约任务
|
定向邀约任务中视频的发布时间
|
|
|
|
系统创建时间
|
|
视频初次拉取到系统内时间
|
|
|
|
系统更新时间
|
|
视频相关数据更新的时间
|
|
|
（2）筛选功能
①店铺账号 ，支持多选店铺进行筛选
②支持以下ID的筛选。输入单个的时候支持模糊搜索。输入多个的时候支持精确搜索。
视频名称
视频ID
邀约任务名称
Product ID
达人账号
③时间，支持按照时间区间筛选视频
发布时间
系统创建时间
④播放量，支持按照区间筛选对应的视频。播放量的组件同达人管理中的场均播放量。
⑤点赞量。支持按照区间筛选对应的视频。组件同达人管理中的场均播放量。
⑥评论数。支持按照区间筛选对应的视频。组件同达人管理中的场均播放量。
⑦销量、订单量。支持按照区间筛选对应的视频。组件同达人管理中的带货销量。
⑧ GMV、实际佣金、预估佣金。支持按照区间筛选对应的视频。点赞量的组件同达人管理中的带货收入。
（3）按钮
① 【备注】。支持勾选多个订单进行备注，备注后再备注新的内容则进行覆盖
如果设置的是空白的内容，则认为是删除已有备注
②排序按钮
默认按照视频发布时间降序排序。
支持按照GMV、销量、视频发布时间、播放量进行排序。
③更新视频信息，点击出现弹窗如下。根据用户勾选的视频去创建任务去获取对应定向邀约任务的结果内容
3.tiktok首页
首页上的达人邀约列表上增加显示新发布视频。需要根据首页上的时间范围找到发布时间在这段时间内的视频数量。
用户点击数字则跳转到达人视频页面并且将当前首页的时间对应映射到达人视频页面内的发布时间的筛选项内
