-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
ui文档优化界面
https://www.figma.com/file/R8QFuJz7Qqvn7gxfdVxCs9/TikTok%E4%B8%93%E7%89%88?type=design&node-id=7416-4041&mode=design&t=UPRhi3LEfGOnPC6Q-0
新增tiktok结算中心
-
statement页面
（1）列表字段说明
从平台抓取下来的表格中order detail中按照SKU维度显示的，所以系统订单维度显示的数据，需要根据相同的Order/adjustment ID将多个SKU的对应字段的值相加显示。
|
本土店铺报表明细
|
系统映射字段
|
数据处理说明
|
？提示
|
|
Statement date (UTC)
|
结算时间
|
报表默认显示为UTC时间
|
Statement date。Statement创建时间。系统同报表一致显示的为UTC时间，即0时区时间
|
|
Statement ID
|
Statement ID
|
|
|
|
Payment ID
|
Payment ID
|
|
|
|
Status
|
结算状态
|
直接取值报表返回数据显示
|
|
|
Currency
|
币种。目前仅对接美国站点仅显示美元币种
|
|
|
|
Type
|
Statement类型
|
|
|
|
Order/adjustment ID
|
Order/adjustment ID
|
|
|
|
SKU ID
|
SKU ID
|
列表界面上暂不显示。
|
|
|
Quantity
|
SKU数量
|
列表界面上暂不显示。
|
|
|
Product name
|
商品名称
|
列表界面上暂不显示。
|
|
|
SKU name
|
SKU属性
|
列表界面上暂不显示。
|
|
|
Order created date(UTC)
|
订单创建时间
|
报表默认为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
|
Order delivery date(UTC)
|
订单妥投时间
|
报表默认为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
|
Total settlement amount
|
结算金额
|
|
结算金额=净销售额+平台运费+平台费用+调整费
|
|
净销售额
|
|
|
Net sales
|
净销售额
|
|
扣除任何卖方折扣后的总收入。净销售额=总销售额+销售退款总额+卖方折扣+卖家折扣退款
|
|
Gross sales
|
总销售额
|
|
未扣除卖家或TikTok提供的折扣前的总收入。
|
|
Gross sales refund
|
销售退款总额
|
|
退还给客户的销售额。
|
|
Seller discount
|
卖方折扣
|
|
卖方折扣是由卖方出资的折扣总额。其中包括
i) 通过卖家促销活动（产品折扣、闪购、多买多省、优惠券和捆绑优惠）由卖家提供的折扣金额
ii) 在卖家参与共同出资活动期间，由卖家出资的共同出资优惠券折扣部分
iii) 在活动期间由卖方出资的折扣
|
|
Seller discount refund
|
卖家折扣退款
|
|
|
|
平台运费
|
|
|
Shipping
|
平台运费
|
|
平台运费=TikTok商店运费+由TikTok商店（FBT）运费支付+买家支付的运费+已支付买家的运费退款+TikTok商店发货奖励+TikTok商店运费奖励退款+运费补贴+退货运费
|
|
TikTok Shop shipping fee
|
TikTok商店运费
|
|
卖家使用TikTok物流所产生的运费。
|
|
Fulfilled by TikTok Shop (FBT) shipping fee
|
由TikTok商店（FBT）运费支付
|
|
由TikTok履行的订单中卖家承担的运费。
|
|
Customer-paid shipping fee
|
买家支付的运费
|
|
客户根据您上传的产品重量产生的运费。
|
|
Customer-paid shipping fee refund
|
已支付买家的运费退款
|
|
从您账户中扣除的客户支付运费的退款金额。
|
|
TikTok Shop shipping incentive
|
TikTok商店发货奖励
|
|
TikTok提供运费奖励
|
|
TikTok Shop shipping incentive refund
|
TikTok商店运费奖励退款
|
|
因卖方过错而退款的订单，将从您的账户中扣除运费奖励金额。
|
|
Shipping fee subsidy
|
运费补贴
|
|
TikTok为卖家自己完成的订单提供运费补贴。
|
|
Return shipping fee
|
退货运费
|
|
卖方为交付退货而支付的运费。
|
|
平台费用
|
|
|
Fees
|
平台费用
|
|
平台费用=交易手续费+推荐费+退还管理费+合作伙伴佣金+联盟合作伙伴佣金
|
|
Transaction fee
|
交易手续费
|
|
使用TikTok商店服务收取的费用，如Tiktok 商店佣金和联盟佣金。
|
|
Referral fee
|
推荐费
|
|
交易费是 TikTok处理成功订单时收取的服务费。交易费是不可退还的费用，每笔交易收取 0.3 美元加客户支付价格的百分比。
|
|
Refund administration fee
|
退还管理费
|
|
退款或退货将从退还的推荐费总额中扣除 20% 的退款管理费。
|
|
Affiliate commission
|
合作伙伴佣金
|
|
客户为产品实际支付的价格（产品售价减去卖家折扣）乘以佣金百分比。
|
|
Affiliate partner commission
|
联盟合作伙伴佣金
|
|
客户通过联盟合作伙伴链接购买产品所支付的金额（产品价格减去卖家折扣）乘以联盟合作伙伴佣金率。
|
|
调整费
|
|
|
Adjustment amount
|
调整费
|
调整费
|
|
|
Adjustment reason
|
调整费的名称
|
列表界面上暂不显示。
|
|
|
Related order ID
|
关联的订单id
|
关联订单
|
关联的订单号。仅当Statement类型为非Order的情况下关联订单才会显示内容。
|
（2）筛选条件
①店铺：支持多选。但是仅显示美国本土的店铺
②时区：仅支持单选。枚举值：GMT-8（美国时间）、GMT+8（北京时间）。设置筛选后，系统的内的单据时间需要根据设置更新。
③订单号/Adjustment ID、Statement ID、Payout ID、关联订单支持这4个单号的单个单号模糊搜索，多个单号精确搜索。
④订单创建、结算日期的时间筛选功能
⑤结算状态：枚举值如下。支持多选
Pending=待结算
Success=已结算
Fail=结算失败
⑥回款状态：枚举值如下。支持多选
Pending=回款中
Success=已回款
Fail=回款失败
⑦Statement类型。枚举值根据平台返回的类型保存的基础数据作为枚举值。支持多选筛选。
（3）导出
根据筛选条件导出符合条件的订单，然后按照用户勾选导出的维度找到筛选条件下订单关联的payout和statement并且对应的报表里面导出对应维度的工作表
Listing
|
英文表头
|
Statement date (UTC)
|
Statement ID
|
Payment ID
|
Status
|
Currency
|
Type
|
Order/adjustment ID
|
SKU ID
|
Quantity
|
Product name
|
SKU name
|
Order created date(UTC)
|
Order delivery date(UTC)
|
Total settlement amount
|
Net sales
|
Gross sales
|
Gross sales refund
|
Seller discount
|
Seller discount refund
|
Shipping
|
TikTok Shop shipping fee
|
Fulfilled by TikTok Shop (FBT) shipping fee
|
Customer-paid shipping fee
|
Customer-paid shipping fee refund
|
TikTok Shop shipping incentive
|
TikTok Shop shipping incentive refund
|
Shipping fee subsidy
|
Return shipping fee
|
Fees
|
Transaction fee
|
Referral fee
|
Refund administration fee
|
Affiliate commission
|
Affiliate partner commission
|
Adjustment amount
|
Adjustment reason
|
Related order ID
|
|
中文表头
|
结算时间(UTC)
|
Statement ID
|
Payment ID
|
结算状态
|
币种
|
Statement类型
|
Order/adjustment ID
|
SKU ID
|
SKU数量
|
商品名称
|
SKU属性
|
订单创建时间(UTC)
|
订单妥投时间(UTC)
|
结算金额
|
净销售额
|
总销售额
|
销售退款总额
|
卖方折扣
|
卖家折扣退款
|
平台运费
|
TikTok商店运费
|
由TikTok商店（FBT）运费支付
|
买家支付的运费
|
已支付买家的运费退款
|
TikTok商店发货奖励
|
TikTok商店运费奖励退款
|
运费补贴
|
退货运费
|
平台费用
|
交易手续费
|
推荐费
|
退还管理费
|
合作伙伴佣金
|
联盟合作伙伴佣金
|
调整费
|
调整费的名称
|
关联的订单id
|
order
|
英文表头
|
Statement date (UTC)
|
Statement ID
|
Payment ID
|
Status
|
Currency
|
Type
|
Order/adjustment ID
|
Order created date(UTC)
|
Order delivery date(UTC)
|
Total settlement amount
|
Net sales
|
Gross sales
|
Gross sales refund
|
Seller discount
|
Seller discount refund
|
Shipping
|
TikTok Shop shipping fee
|
Fulfilled by TikTok Shop (FBT) shipping fee
|
Customer-paid shipping fee
|
Customer-paid shipping fee refund
|
TikTok Shop shipping incentive
|
TikTok Shop shipping incentive refund
|
Shipping fee subsidy
|
Return shipping fee
|
Fees
|
Transaction fee
|
Referral fee
|
Refund administration fee
|
Affiliate commission
|
Affiliate partner commission
|
Adjustment amount
|
Adjustment reason
|
Related order ID
|
|
中文表头
|
结算时间 (UTC)
|
Statement ID
|
Payment ID
|
结算状态
|
币种
|
Statement类型
|
Order/adjustment ID
|
订单创建时间(UTC)
|
订单妥投时间(UTC)
|
结算金额
|
净销售额
|
总销售额
|
销售退款总额
|
卖方折扣
|
卖家折扣退款
|
平台运费
|
TikTok商店运费
|
由TikTok商店（FBT）运费支付
|
买家支付的运费
|
已支付买家的运费退款
|
TikTok商店发货奖励
|
TikTok商店运费奖励退款
|
运费补贴
|
退货运费
|
平台费用
|
交易手续费
|
推荐费
|
退还管理费
|
合作伙伴佣金
|
联盟合作伙伴佣金
|
调整费
|
调整费的名称
|
关联的订单id
|
statement
|
英文表头
|
Statement date (UTC)
|
Statement ID
|
Payment ID
|
Status
|
Total settlement amount
|
Net sales
|
Shipping
|
Fees
|
Adjustments
|
|
中文表头
|
结算时间
|
Statement ID
|
Payment ID
|
结算状态
|
结算金额
|
净销售额
|
平台运费
|
平台费用
|
调整费
|
payout
|
英文表头
|
Payment initiation date (UTC)
|
Payment ID
|
Payment amount
|
Payment completion date (UTC)
|
Status
|
Total settlement amount
|
Reserve
|
|
中文表头
|
Payout创建时间
|
Payment ID
|
回款金额
|
回款时间
|
回款状态
|
结算金额
|
储备金
|
（4）订单账单详情
①详情内的费用字段如果返回为0，则不显示改字段。
②费用字段分组关系详见（1）列表字段说明中的分组。
③如果一个分组费用的金额都为0，则这个分组不显示在详情内。
（5）下载插件，点击出现同达人管理的弹窗，弹窗内隐藏一个跳转链接
2.Payout页面
（1）字段说明
|
本土店铺报表明细
|
系统映射字段
|
数据处理说明
|
？提示
|
|
payment_start_time
|
创建时间
|
报表默认显示为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
|
payment_id
|
Payout ID
|
|
|
|
payment_amount
|
回款金额
|
|
|
|
payment_success_time
|
回款时间
|
报表默认显示为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
|
payment_status
|
回款状态
|
20=已回款
其他状态待定
|
|
|
"bank_card_mask_code
|
银行账号
|
仅保存库内，界面上暂不显示
|
|
|
payment_note
|
回款备注
|
仅保存库内，界面上暂不显示
|
|
|
settle_amount
|
结算金额
|
|
|
|
total_reserve_amount
|
储备金
|
|
|
（2）筛选条件
①店铺：支持多选。但是仅显示美国本土的店铺
②时区：仅支持单选。枚举值：GMT-8（美国时间）、GMT+8（北京时间）。设置筛选后，系统的内的单据时间需要根据设置更新。
③Payout ID、支持这单个单号模糊搜索，多个单号精确搜索。
④Payout创建、回款时间的时间筛选功能
⑥回款状态：枚举值如下。支持多选
Pending=回款中
Success=已回款
Fail=回款失败
（3）导出
|
英文表头
|
Payment initiation date (UTC)
|
Payment ID
|
Payment amount
|
Payment completion date (UTC)
|
Status
|
Total settlement amount
|
Reserve
|
|
中文表头
|
Payout创建时间
|
Payment ID
|
回款金额
|
回款时间
|
回款状态
|
结算金额
|
储备金
|
3.Onhold页面
（1）字段说明
|
接口返回数据
|
系统映射字段
|
数据处理说明
|
？提示
|
导出报表英文名称
|
|
trade_order_id
|
订单号/Adjustment ID
|
|
|
Order ID/Adjustment ID
|
|
placed_time
|
订单创建
|
报表默认显示为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
Order creation date
|
|
delivery_time
|
订单妥投
|
报表默认显示为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
Order delivery date
|
|
estimate_settle_time
|
预估结算时间
|
报表默认显示为UTC时间
|
系统同报表一致显示的为UTC时间，即0时区时间
|
Est. settled time
|
|
settlement_amount
|
预估结算金额
|
|
|
Total settlement amount
|
|
earning_amount
|
净销售额
|
|
|
Est. net sales
|
|
shipping_amount
|
平台运费
|
|
|
Est. shipping
|
|
fees
|
平台费用
|
|
|
Est. fees
|
|
to_settle_reason
|
未结算原因
|
3=Order delivered and awaiting settlement（订单已妥投待结算）
2=Waiting for completed refund/return
（待完成退款/退货）
1=Waiting for package delivery
（待订单妥投）
|
|
Unsettled reasons
|
|
sku_records.sku_id
|
sku_id
|
|
|
sku id
|
|
sku_records.quantity
|
SKU数量
|
|
|
quantity
|
|
sku_records.product_name
|
SKU名称
|
|
|
product name
|
|
sku_records.product_name
|
SKU属性
|
|
|
sku name
|
|
sku_records.settlement_amount
|
预估结算金额（SKU维度）
|
预估结算金额（SKU维度）
|
|
settlement_amount
|
（2）筛选条件
①店铺：支持多选。但是仅显示美国本土的店铺
②时区：仅支持单选。枚举值：GMT-8（美国时间）、GMT+8（北京时间）。设置筛选后，系统的内的单据时间需要根据设置更新。
③订单号 ，支持这4个单号的单个单号模糊搜索，多个单号精确搜索。
④订单创建、订单妥投的时间筛选功能
⑤未结算原因。枚举值如下，支持多选筛选
Order delivered and awaiting settlement
Waiting for completed refund/return
Waiting for package delivery
（3）导出
order
|
英文表头
|
Order ID/Adjustment ID
|
Order creation date
|
Order delivery date
|
Est. settled time
|
Total settlement amount
|
Est. net sales
|
Est. shipping
|
Est. fees
|
Unsettled reasons
|
|
中文表头
|
订单号
|
订单创建
|
订单妥投
|
预估结算时间
|
预估结算金额
|
净销售额
|
平台运费
|
平台费用
|
未结算原因
|
listing
|
英文表头
|
订单号/Adjustment ID
|
订单创建
|
订单妥投
|
预估结算时间
|
未结算原因
|
sku_id
|
SKU数量
|
SKU名称
|
SKU属性
|
预估结算金额（SKU维度）
|
|
中文表头
|
Order ID/Adjustment ID
|
Order creation date
|
Order delivery date
|
Est. settled time
|
Unsettled reasons
|
sku id
|
quantity
|
product name
|
sku name
|
settlement_amount
|
4.总览页面
（1）总结算金额=已结算金额+结算中金额+未结算金额。
上一周期为用户选择时间的相邻的相同时间段的上一个周期。
环比比例=（本期数－上期数）／上期数 ×100%
（2）已结算金额=统计结算时间属于筛选时间段内的Success状态Statement的结算金额
上一周期为用户选择时间的相邻的相同时间段的上一个周期。
环比比例=（本期数－上期数）／上期数 ×100%
（3）结算中=统计结算时间属于筛选时间段内的pending状态Statement的结算金额
上一周期为用户选择时间的相邻的相同时间段的上一个周期。
环比比例=（本期数－上期数）／上期数 ×100%
（4）未结算订单结算金额=Onhold下订单创建时间属于筛选时间段内订单的预估结算金额
上一周期为用户选择时间的相邻的相同时间段的上一个周期。
环比比例=（本期数－上期数）／上期数 ×100%
总计订单数=时间段内创建订单的订单数量。
（5）已结算Statement的费用构成
根据筛选项筛选时间段内结算时间并且结算状态为Success状态Statement的结算金额明细。
（6）店铺回款。筛选出时间段内对应出款时间的出款单统计回款金额和储备金
右上角的为时间段内总回款金额和总储备金。
（7）店铺结算。筛选统计时间段内对应单据的总金额
|
系统映射字段
|
数据处理说明
|
？提示
|
|
店铺
|
取值店铺别名
|
|
|
总结算
|
总结算金额=已结算金额+结算中金额+未结算金额
|
总结算金额=已结算金额+结算中金额+未结算金额
|
|
已结算
|
结算时间=筛选时间并且结算状态为Success状态的statement的结算金额之和
|
筛选时间段内为已结算状态的statement的结算金额之和
|
|
结算中
|
结算时间=筛选时间并且结算状态为pending状态的statement的结算金额之和
|
筛选时间段内为结算中状态的statement的结算金额之和
|
|
未结算
|
订单创建时间=筛选时间并且处于onhold状态的订单的结算金额之和
|
筛选时间段内创建并且处于onhold状态的订单的结算金额之和。
|
|
总回款
|
回款时间=筛选时间并且回款状态为Success的payout单的回款金额之和
|
筛选时间段内回款并且回款状态为Success的payout的回款金额之和。
|
|
储备金
|
回款时间=筛选时间并且回款状态为Success的payout单的储备金之和
|
筛选时间段内回款并且回款状态为Success的payout的储备金之和。
|
5.页面警示
（1）当系统存在店铺没有任何一条数据则提示：店铺：SKJDL、FKLJS55、DKHCNK88未拉取到账单明细，请在Tiktok后台开启插件，开启插件后系统将拉取最近90天的账单数据。
（2）当存在店铺的已拉取到账单数据，但是最新一条statement的创建时间已经超过7天以上了，则提示：店铺：SKJDL、FKLJS55、DKHCNK88已经超过7天未拉取到新的账单明细，请在对应店铺开启插件让系统拉取账单明细
（3）如果同时存在（1）（2）的场景合并显示这2条提示。
