TikTok > 结算中心
共 13 条需求，按创建时间倒序。产品经理：陈家宜
当前最新逻辑
（待人工总结：以最新一条已完成需求的描述为准）
需求历史
2025-07-21 ｜ 已完成 ｜ ECERPH-31711
标题：tiktok》结算数据需要写入erp数据库
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20250729-常规-7月第五迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
配合中台处理可以节省大约2000元 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
就写tk结算数据入库的时候 双写一份到erp的数据库。
2025-07-15 ｜ 已完成 ｜ ECERPH-31414
标题：Tiktok》结算中心对接新版费用接口
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20250729-常规-7月第五迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
-
对接新版费用接口
中台需求：https://devops.aliyun.com/projex/req/ECERPJ-8382# 《中台》tiktok新增对接新版的账单接口》
2.对接新费用字段如下：
①已有字段对接说明
【取消仅拉取美国和英国的限制，支持所有站点的店铺都通过此接口获取结算数据】
| 所属费用分类 | 中文翻译 | 接口字段 | 备注 | ？提示 | 英文名 |
| --- | --- | --- | --- | --- | --- |
| 结算单日期 (UTC) | create_time | 统一都换算为UTC时间（0时区） | | Statement date | |
| 结算单 ID | transactions.id | | | Statement ID | |
| 付款 ID | 通过Statement ID关联去获取Payment ID | | | Payment ID | |
| 状态 | 通过Get Statements接口中获取到的数据去匹配 | | | Status | |
| 币种 | currency。需要按照用户选择的币种从原币种换算成用户选择的币种 | | | Currency | |
| 类型 | transactions.type | | | Type | |
| 订单/调整单 ID | order_id/adjustment_id | | | Order/adjustment ID | |
| SKU ID | sku_transactions.sku_id | 从Get Transactions by Statement接口中获取 | | SKU ID | |
| 数量 | sku_transactions.quantity | 从Get Transactions by Statement接口中获取 | | Quantity | |
| 商品名称 | sku_transactions.product_name | 从Get Transactions by Statement接口中获取 | | Product name | |
| SKU 名称 | sku_transactions.sku_name | 从Get Transactions by Statement接口中获取 | | SKU name | |
| 订单创建日期 | order_create_time | | | Order created date | |
| 关联订单 | adjustment_order_id | | | | |
| 结算金额 | 总结算金额 | settlement_amount | | 结算金额=平台收入+平台运费+平台费用+调整费 | Total settlement amount |
| 平台收入 | 平台收入 | revenue_amount | | 订单结算时的收入金额 | Total revenue |
| 平台收入 | 销售额 (毛销售额) | subtotal_before_discount_amount | | 扣除任何卖家折扣和平台折扣之前的所有订单商品的总价。这相当于商店的销售总额。 | subtotal before discount |
| 平台收入 | 销售额退款(毛销售额退款) | refund_subtotal_before_discount_amount | | 所有退款项目的总价格之前，任何卖方折扣。这相当于商店的销售额退款。 | refund subtotal before discount |
| 平台收入 | 卖家折扣 | seller_discount_amount | | 卖方提供的折扣总额，包括：
- 卖家促销活动（产品折扣，闪存交易，买多节省更多，折扣和捆绑交易）
- 共同出资活动中共同出资代金券折扣的卖方部分
- 活动期间的卖家折扣 | seller discount |
| 平台收入 | 卖家折扣退款 | seller_discount_refund_amount | | 由于退货或退款而退还给卖家的折扣。 | seller discount refund |
| 平台收入 | 货到付款手续费金额 | cod_service_fee_amount | | 向买家收取的货到付款服务费。
仅适用于沙特阿拉伯。 | cod service fee |
| 平台收入 | 货到付款服务费退款金额 | refund_cod_service_fee_amount | | 退还货到付款的服务费。
仅适用于沙特阿拉伯。 | refund cod service fee |
| 平台运费 | 平台运费 | shipping_cost_amount | | 订单结算时的运费 | shipping cost |
| 平台运费 | 实际运输费 | actual_shipping_fee_amount | | 根据承运人测量的重量/尺寸计算的实际运费。 | actual shipping fee |
| 平台运费 | 运费折扣金额 | shipping_fee_discount_amount | | 平台提供的运费补贴和奖励。这包括所有补贴，无论履行渠道或政策如何。 | shipping fee discount |
| 平台运费 | 买家支付运输费 | customer_paid_shipping_fee_amount | | 由客户承担的实际运费，根据卖家上传的产品重量计算。负数指客户已付运费的退款金额 | customer paid shipping fee |
| 平台运费 | 退货运输费 | return_shipping_fee_amount | | 卖方为交付退货而支付的运费 | return shipping fee |
| 平台运费 | 重置运费金额？ | replacement_shipping_fee_amount | | 由卖方支付的货物更换交付的运费。
仅适用于印度尼西亚。 | replacement shipping fee |
| 平台运费 | 汇兑运费金额？ | exchange_shipping_fee_amount | | 运费由卖方为交付货物而支付的运费交换。
仅适用于印度尼西亚。 | exchange shipping fee |
| 平台运费 | 签收确认服务费 | signature_confirmation_fee_amount | | 需要签名确认服务的包裹所产生的费用。 | signature confirmation fee |
| 平台运费 | 运输保险费 | shipping_insurance_fee_amount | | 卖家购买额外TikTok航运保险服务所产生的航运保险费。 | shipping insurance fee |
| 平台运费 | FBT履约费补偿金额 | fbt_fulfillment_fee_reimbursement_amount | | TikTok Shop对不符合免费送货条件的TikTok订单的退款。
仅适用于美国。 | fbt fulfillment fee reimbursement |
| 平台运费 | 退货运单费 | return_shipping_label_fee_amount | | 由客户承担的费用，以支付返回标签的成本。该费用由卖方代表收取，并根据商定的付款条件结算。 | return shipping label fee |
| 平台运费 | 卖方自助运输服务费金额 | seller_self_shipping_service_fee_amount | | 通过您自己的物流供应商运输的订单收取的服务费。不符合豁免标准的包裹。 | seller self shipping service fee |
| 平台支出 | 平台费用 | fee_tax_amount | | TikTok Shop在订单结算时收取的总费用和税费。不包括与运输有关的费用。 | Total fees |
| 平台支出 | 平台佣金额 | platform_commission_amount | | 平台收取的佣金金额。 | platform commission |
| 平台支出 | 平台佣金 | referral_fee_amount | | 处理成功订单所收取的转介费。
仅适用于美国。 | referral fee |
| 平台支出 | 退款管理费 | refund_administration_fee_amount | | 从退还的推荐费总额中扣除20%的退款管理费。 | refund administration fee |
| 平台支出 | 交易手续费 | transaction_fee_amount | | 处理成功订单所收取的交易费用。 | transaction fee |
| 平台支出 | 信用卡手续费金额 | credit_card_handling_fee_amount | | 买家用信用卡付款时收取的手续费。 | credit card handling fee |
| 平台支出 | 联盟佣金 | affiliate_commission_amount | | 向卖方收取的支付给创作者的佣金金额。 | affiliate commission |
| 平台支出 | 加盟商入坑前佣金金额 | affiliate_commission_amount_before_pit | | 在任何个人所得税预扣之前支付给创建者的联盟广告佣金。
仅适用于东南亚市场。 | affiliate commission before pit |
| 平台支出 | 联盟合作伙伴佣金 | affiliate_partner_commission_amount | | 通过附属合作伙伴链接购买的佣金金额。 | affiliate partner commission |
| 平台支出 | 联盟商店广告佣金 | affiliate_ads_commission_amount | | 广告中符合条件的订单的佣金。 | affiliate ads commission |
| 平台支出 | sfp服务费金额 | sfp_service_fee_amount | | 参加[卖家免运费计划]所收取的服务费。 | sfp service fee |
| 平台支出 | 直播特殊费用 | live_specials_fee_amount | | 参加[LIVE特别节目]所收取的服务费。 | live specials fee |
| 平台支出 | 奖金返现服务费金额 | bonus_cashback_service_fee_amount | | 参与红利返现计划所收取的服务费。 | bonus cashback service fee |
| 平台支出 | 购物中心服务费金额 | mall_service_fee_amount | | 使用TikTok Shop商城收取的服务费。 | mall service fee |
| 平台支出 | 凭证额外服务费金额 | voucher_xtra_service_fee_amount | | 参加XiamXtra计划所收取的服务费。 | voucher xtra service fee |
| 平台支出 | 闪付销售服务费金额 | flash_sales_service_fee_amount | | 参与限时抢购所收取的服务费。 | flash sales service fee |
| 平台支出 | 共同承担的推广服务费 | cofunded_promotion_service_fee_amount | | 共同资助促销活动收取的服务费。 | cofunded promotion service fee |
| 平台支出 | 预购服务费金额 | pre_order_service_fee_amount | | 参与预购计划所收取的服务费。 | pre order service fee |
| 平台支出 | tsp_佣金金额 | tsp_commission_amount | | TikTok Shop Partners（TSP）收取的佣金金额。 | tsp commission |
| 平台支出 | Dilayani Tokopedia手续费 | dt_handling_fee_amount | | 由Dilayani Tokopedia履行的订单所收取的手续费。 | dt handling fee |
| 平台支出 | 生态贡献服务费 | epr_pob_service_fee_amount | | 生态贡献TikTok商店代表您向合格的生产者责任组织（PRO）支付。 | epr pob service fee |
| 平台支出 | 卖方付款人手续费金额 | seller_paylater_handling_fee_amount | | 向卖方收取的参与PayLater计划的手续费。 | seller paylater handling fee |
| 平台支出 | 每项销售额费用 | fee_per_item_sold_amount | | 平台向卖家收取的每件商品的费用。这相当于订单中所有SKU的每件商品费用的总和。
仅适用于巴西市场。 | fee per item sold |
| 平台支出 | 共同承担的创作者奖励 | cofunded_creator_bonus_amount | | 您作为佣金提升活动的一部分共同资助的创作者奖金部分。 | cofunded creator bonus |
| 平台支出 | 动态佣金额 | dynamic_commission_amount | | 动态佣金是平台对每个成功交付的订单向所有卖家收取的金额。
仅适用于印度尼西亚。 | dynamic commission |
| 平台支出 | 外部联盟营销费用金额 | external_affiliate_marketing_fee_amount | | 参与外部联盟营销解决方案计划的服务费，如注册时所述。 | external affiliate marketing fee |
| 平台支出 | VAT税 | vat_amount | | 由平台代表卖家支付的增值税。
仅适用于跨境商店订单。 | vat |
| 平台支出 | 进口增值税金额 | import_vat_amount | | 进口增值税，对在一个国家购买并进口到另一个国家的商品征收的税。
仅适用于跨境商店订单。在日本，它指的是日本消费税（JCT）。 | import vat |
| 平台支出 | 关税金额 | customs_duty_amount | | 关税是政府对跨境货物征收的一种税。
仅适用于跨境商店订单。 | customs duty |
| 平台支出 | 结关金额 | customs_clearance_amount | | 物流供应商就清关服务收取的费用。
仅适用于跨境商店订单。 | customs clearance |
| 平台支出 | SST税 | sst_amount | | 该平台对进口到马来西亚的低价值商品征收并汇交税务机关的销售和服务税（SST），自2024年1月1日起生效。 | sst |
| 平台支出 | GST税 | gst_amount | | 平台对进口到新加坡的低价值商品征收并汇交税务机关的商品及服务税（GST），自2023年1月1日起生效。 | gst |
| 平台支出 | IVA税 | iva_amount | | TikTok Shop必须对您的应税产品预扣并汇给税务机关的墨西哥增值税。 | iva |
| 平台支出 | ISR税 | isr_amount | | TikTok Shop需要代扣的墨西哥联邦所得税。 | isr |
| 平台支出 | 反倾销税额 | anti_dumping_duty_amount | | 政府对进口商品征收的反倾销税。 | anti dumping duty |
| 平台支出 | 本地VAT税 | local_vat_amount | | 由平台代表卖家支付的增值税。仅适用于当地商店订单。 | local vat |
| 平台支出 | PIT税 | pit_amount | | 平台代卖家缴纳的个人所得税（PIT）。 | pit |
| 调整费 | 调整金额 | adjustment_amount | | | adjustment amount |
| 参考费用仅供用户查看，仅在详情弹窗内和导出中显示，不参与结算费用计算 | | 参考费用 | 买家支付金额 | customer_payment_amount | |
| | customer payment | 参考费用 | 买家退款金额 | customer_refund_amount | |
| | customer refund | 参考费用 | 平台折扣 | platform_discount_amount | |
| | platform discount | 参考费用 | 平台折扣退款 | platform_discount_refund_amount | |
| | platform discount refund | 参考费用 | 卖家共同承担优惠券折扣 | seller_cofunded_discount_amount | |
| | seller cofunded discount | 参考费用 | 卖家共同承担优惠券折扣退款 | seller_cofunded_discount_refund_amount | |
| | seller cofunded discount refund | 参考费用 | 平台共同承担优惠券折扣 | platform_cofunded_discount_amount | |
| | platform cofunded discount | 参考费用 | 平台共同承担优惠券折扣退款 | platform_cofunded_discount_refund_amount | |
| | platform cofunded discount refund | 参考费用 | 零售配送费用金额 | retail_delivery_fee_amount | |
| | retail delivery fee | 参考费用 | 零售配送费支付 | retail_delivery_fee_payment_amount | |
| | retail delivery fee payment | 参考费用 | 零售配送费退款 | retail_delivery_fee_refund_amount | |
| | retail delivery fee refund | 参考费用 | 销售税金额 | sales_tax_amount | |
| | sales tax | | 销售税支付额 | sales_tax_payment_amount | |
| | sales tax payment | 参考费用 | 销售税退款 | sales_tax_refund_amount | |
| | sales tax refund | 参考费用 | 平台运费折扣金额 | platform_shipping_fee_discount_amount | |
| | platform shipping fee discount | 参考费用 | TikTok Shop 运输激励 | promo_shipping_incentive_amount | |
| | promo shipping incentive | 参考费用 | 运输费补贴 | shipping_fee_subsidy_amount | |
| - 正数代表卖方收到的补贴。
- 负金额代表卖家必须返还给TikTok Shop的补贴。 | shipping fee subsidy | 参考费用 | 卖家运输费折扣 | seller_shipping_fee_discount_amount | |
| | seller shipping fee discount | 参考费用 | 买家运输费抵扣 | customer_shipping_fee_offset_amount | |
| 仅适用于美国。 | customer shipping fee offset | 参考费用 | 装运成本金额 | fbm_shipping_cost_amount | |
| | fbm shipping cost | 参考费用 | FBT运费金额 | fbt_shipping_cost_amount | |
| 仅适用于欧盟和英国。 | fbt shipping cost | 参考费用 | FBT装配金额 | fbt_fulfillment_fee_amount | |
| 仅适用于美国 | fbt fulfillment fee | | | | |
②如果出现了以上报表中没有说明的字段，则将字段直接作为字段中文名以及英文名保存到系统内。 （1）如果新字段出现在revenue_breakdown下则认为是平台收入 （2）如果新字段出现在shipping_cost_breakdown下则认为是平台运费
（3）如果新字段出现在fee_tax_breakdown下则认为是平台运费 （4）如果新字段出现在supplementary_component或者shipping_cost_breakdown.supplementary_component则认为是参考费用
3.结算页面进行以下调整 （1）首页 ①没有开启插件的提示不需要再展示了 【图片】 ②此处提示文案调整为：各个站点的结算单（statement）和回款单（payout）系统会自动通过接口拉取，但是onhold下的平台未结算数据系统暂无接口可以获取。美国ACCU/本土/跨境和英文本土的onhold数据支持通过插件获取到系统内。 【图片】 ③插件拉取任务中去掉payout+statement的拉取任务内容 【图片】 【图片】 ④币种选项需要显示为默认选中美元 【图片】 ⑤调整此模块内容，费用项都需要按照新费用项进行调整。 【图片】
（2）statement （结算单）、payout（回款单）页面 ①取消本土/跨境tab切换框 【图片】
②payout、statement、onhold页面的币种默认选中美元。 并且新增【原币种】字段，当用户选中原币种选项的时候，每个单则显示原币种的币种符号和金额。列表下的总计在选择原币种的时候按照美元进行统计
【图片】
③去除掉结算状态 【图片】
④payout、statement、onhold默认选中最近1个月的时间。不能清空时间筛选项，一次筛选最多允许勾选一年的时间。 时间组件统一换成以下组件。 【图片】 【图片】
⑤详情页面内新增显示【参考费用项】 并且删除掉妥投时间这个字段 【图片】
⑥调整费用需要 不需要显示下拉弹窗 【图片】
⑦；导出报表调整为如下字段
payout模式
【无需调整】
statement模式
【需要按照以下费用内容导出】
| 英文名称 | 中文 |
| --- | --- |
| Shop | 店铺 |
| Statement date (UTC) | 结算时间(UTC) |
| Statement ID | Statement ID |
| Payout ID | Payout ID |
| Payout status | 回款状态 |
| Payment initiation date (UTC) | Payout创建时间 |
| Payment completion date (UTC) | Payout回款时间 |
| Currency | 币种 |
| Total settlement amount | 结算金额 |
| Total revenue | 平台收入 |
| Shipping | 平台运费 |
| Fees | 平台费用 |
| Adjustments | 调整费 |
| listing模式
【需要按照以下费用内容导出】
中文翻译 | 英文名 |
| 结算单日期 (UTC) | Statement date |
| 结算单 ID | Statement ID |
| 付款 ID | Payment ID |
| 状态 | Status |
| 币种 | Currency |
| 类型 | Type |
| 订单/调整单 ID | Order/adjustment ID |
| SKU ID | SKU ID |
| 数量 | Quantity |
| 商品名称 | Product name |
| SKU 名称 | SKU name |
| 订单创建日期 | Order created date |
| 总结算金额 | Total settlement amount |
| 净销售额 | Total revenue |
| 销售额 (毛销售额) | subtotal before discount |
| 销售额退款(毛销售额退款) | refund subtotal before discount |
| 卖家折扣 | seller discount |
| 卖家折扣退款 | seller discount refund |
| 货到付款手续费金额 | cod service fee |
| 货到付款服务费退款金额 | refund cod service fee |
| 运输费 | shipping cost |
| 实际运输费 | actual shipping fee |
| 运费折扣金额 | shipping fee discount |
| 买家支付运输费 | customer paid shipping fee |
| 退货运输费 | return shipping fee |
| 重置运费金额？ | replacement shipping fee |
| 汇兑运费金额？ | exchange shipping fee |
| 签收确认服务费 | signature confirmation fee |
| 运输保险费 | shipping insurance fee |
| FBT履约费补偿金额 | fbt fulfillment fee reimbursement |
| 退货运单费 | return shipping label fee |
| 卖方自助运输服务费金额 | seller self shipping service fee |
| 费用 | Total fees |
| 平台佣金额 | platform commission |
| 平台佣金 | referral fee |
| 退款管理费 | refund administration fee |
| 交易手续费 | transaction fee |
| 信用卡手续费金额 | credit card handling fee |
| 联盟佣金 | affiliate commission |
| 加盟商入坑前佣金金额 | affiliate commission before pit |
| 联盟合作伙伴佣金 | affiliate partner commission |
| 联盟商店广告佣金 | affiliate ads commission |
| sfp服务费金额 | sfp service fee |
| 直播特殊费用 | live specials fee |
| 奖金返现服务费金额 | bonus cashback service fee |
| 购物中心服务费金额 | mall service fee |
| 凭证额外服务费金额 | voucher xtra service fee |
| 闪付销售服务费金额 | flash sales service fee |
| 共同承担的推广服务费 | cofunded promotion service fee |
| 预购服务费金额 | pre order service fee |
| tsp_佣金金额 | tsp commission |
| Dilayani Tokopedia手续费 | dt handling fee |
| 生态贡献服务费 | epr pob service fee |
| 卖方付款人手续费金额 | seller paylater handling fee |
| 每项销售额费用 | fee per item sold |
| 共同承担的创作者奖励 | cofunded creator bonus |
| 动态佣金额 | dynamic commission |
| 外部联盟营销费用金额 | external affiliate marketing fee |
| VAT税 | vat |
| 进口增值税金额 | import vat |
| 关税金额 | customs duty |
| 结关金额 | customs clearance |
| SST税 | sst |
| GST税 | gst |
| IVA税 | iva |
| ISR税 | isr |
| 反倾销税额 | anti dumping duty |
| 本地VAT税 | local vat |
| PIT税 | pit |
| 调整金额 | adjustment amount |
| 买家支付金额 | customer payment |
| 买家退款金额 | customer refund |
| 平台折扣 | platform discount |
| 平台折扣退款 | platform discount refund |
| 卖家共同承担优惠券折扣 | seller cofunded discount |
| 卖家共同承担优惠券折扣退款 | seller cofunded discount refund |
| 平台共同承担优惠券折扣 | platform cofunded discount |
| 平台共同承担优惠券折扣退款 | platform cofunded discount refund |
| 零售配送费用金额 | retail delivery fee |
| 零售配送费支付 | retail delivery fee payment |
| 零售配送费退款 | retail delivery fee refund |
| 销售税金额 | sales tax |
| 销售税支付额 | sales tax payment |
| 销售税退款 | sales tax refund |
| 平台运费折扣金额 | platform shipping fee discount |
| TikTok Shop 运输激励 | promo shipping incentive |
| 运输费补贴 | shipping fee subsidy |
| 卖家运输费折扣 | seller shipping fee discount |
| 买家运输费抵扣 | customer shipping fee offset |
| 装运成本金额 | fbm shipping cost |
| FBT运费金额 | fbt shipping cost |
| FBT装配金额 | fbt fulfillment fee |
| 订单模式
1.调整导出内容，原导出内容仅导出订单类型，现在调整按照statement维度，导出所有stament+订单的明细数据，但是名称还是显示为订单模式保持和后台报表一致。
2.需要按照以下费用内容导出
中文翻译 | 英文名 |
| 结算单日期 (UTC) | Statement date |
| 结算单 ID | Statement ID |
| 付款 ID | Payment ID |
| 状态 | Status |
| 币种 | Currency |
| 类型 | Type |
| 订单/调整单 ID | Order/adjustment ID |
| 订单创建日期 | Order created date |
| 关联订单 | Related order ID |
| 总结算金额 | Total settlement amount |
| 净销售额 | Total revenue |
| 销售额 (毛销售额) | subtotal before discount |
| 销售额退款(毛销售额退款) | refund subtotal before discount |
| 卖家折扣 | seller discount |
| 卖家折扣退款 | seller discount refund |
| 货到付款手续费金额 | cod service fee |
| 货到付款服务费退款金额 | refund cod service fee |
| 运输费 | shipping cost |
| 实际运输费 | actual shipping fee |
| 运费折扣金额 | shipping fee discount |
| 买家支付运输费 | customer paid shipping fee |
| 退货运输费 | return shipping fee |
| 重置运费金额？ | replacement shipping fee |
| 汇兑运费金额？ | exchange shipping fee |
| 签收确认服务费 | signature confirmation fee |
| 运输保险费 | shipping insurance fee |
| FBT履约费补偿金额 | fbt fulfillment fee reimbursement |
| 退货运单费 | return shipping label fee |
| 卖方自助运输服务费金额 | seller self shipping service fee |
| 费用 | Total fees |
| 平台佣金额 | platform commission |
| 平台佣金 | referral fee |
| 退款管理费 | refund administration fee |
| 交易手续费 | transaction fee |
| 信用卡手续费金额 | credit card handling fee |
| 联盟佣金 | affiliate commission |
| 加盟商入坑前佣金金额 | affiliate commission before pit |
| 联盟合作伙伴佣金 | affiliate partner commission |
| 联盟商店广告佣金 | affiliate ads commission |
| sfp服务费金额 | sfp service fee |
| 直播特殊费用 | live specials fee |
| 奖金返现服务费金额 | bonus cashback service fee |
| 购物中心服务费金额 | mall service fee |
| 凭证额外服务费金额 | voucher xtra service fee |
| 闪付销售服务费金额 | flash sales service fee |
| 共同承担的推广服务费 | cofunded promotion service fee |
| 预购服务费金额 | pre order service fee |
| tsp_佣金金额 | tsp commission |
| Dilayani Tokopedia手续费 | dt handling fee |
| 生态贡献服务费 | epr pob service fee |
| 卖方付款人手续费金额 | seller paylater handling fee |
| 每项销售额费用 | fee per item sold |
| 共同承担的创作者奖励 | cofunded creator bonus |
| 动态佣金额 | dynamic commission |
| 外部联盟营销费用金额 | external affiliate marketing fee |
| VAT税 | vat |
| 进口增值税金额 | import vat |
| 关税金额 | customs duty |
| 结关金额 | customs clearance |
| SST税 | sst |
| GST税 | gst |
| IVA税 | iva |
| ISR税 | isr |
| 反倾销税额 | anti dumping duty |
| 本地VAT税 | local vat |
| PIT税 | pit |
| 调整金额 | adjustment amount |
| 买家支付金额 | customer payment |
| 买家退款金额 | customer refund |
| 平台折扣 | platform discount |
| 平台折扣退款 | platform discount refund |
| 卖家共同承担优惠券折扣 | seller cofunded discount |
| 卖家共同承担优惠券折扣退款 | seller cofunded discount refund |
| 平台共同承担优惠券折扣 | platform cofunded discount |
| 平台共同承担优惠券折扣退款 | platform cofunded discount refund |
| 零售配送费用金额 | retail delivery fee |
| 零售配送费支付 | retail delivery fee payment |
| 零售配送费退款 | retail delivery fee refund |
| 销售税金额 | sales tax |
| 销售税支付额 | sales tax payment |
| 销售税退款 | sales tax refund |
| 平台运费折扣金额 | platform shipping fee discount |
| TikTok Shop 运输激励 | promo shipping incentive |
| 运输费补贴 | shipping fee subsidy |
| 卖家运输费折扣 | seller shipping fee discount |
| 买家运输费抵扣 | customer shipping fee offset |
| 装运成本金额 | fbm shipping cost |
| FBT运费金额 | fbt shipping cost |
| FBT装配金额 | fbt fulfillment fee |
5.去掉导出中此勾选项，接口文档中返回的参考费用有部分就是订单付款费用，不再添加订单付款费用上去了 【图片】 listing维度此选项咱去隐藏（因为接口频率不够用无法拉取所有的sku维度的数据） 【图片】
2025-02-17 ｜ 已完成 ｜ ECERPH-23324
标题：Tiktok》结算中心导出订单维度数据同时导出订单付款明细
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20250311-常规-3月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
即将关闭预估利润页面，所以需要将原订单费用相关数据关联显示在结算中内 UI图：https://www.figma.com/design/R8QFuJz7Qqvn7gxfdVxCs9/TikTok%E4%B8%93%E7%89%88?node-id=7820-5347&p=f&t=0gs65UZMlTlHkKsB-0 【图片】
- 需求（做什么？怎么做？有什么要注意的？）
销售》tiktok》结算中心
- 结算中心-statemtn页面导出的时候在勾选订单维度的情况下新增显示复选框：导出订单付款明细(仅支持类型为order的单据导出订单付款明细)。用户勾选复选框后在导出的报表中新增以下字段。
【图片】 注意：以下新增导出的内容要和原有结算数据内容中空开一列，如下图 【图片】 | 中文名称 | 英文名称 | 备注 | | --- | --- | --- | | 买家支付总金额 | Total | | | 折扣后小计 | Item(s) subtotal after discounts | | | 商品原价 | Item(s) subtotal before discounts | | | 卖家折扣 | Seller discount on items | | | 平台折扣 | TikTok Shop discount on items | | | 折扣后运费 | Shipping fee after discounts | | | 运费原价 | Shipping fee before discounts | | | 卖家运费折扣 | Seller shipping fee discount | | | 平台运费折扣 | TikTok Shop shipping fee discount | | | 总税费 | Taxes | | | 运费税 | Shipping fee tax | shipping_fee_tax。接口新增字段，注意需要新增保存 | | 商品税 | Product tax | product_tax。接口新增字段，注意需要新增保存 | | 零售配送费 | Retail delivery fee | | | 小订单费用（泰国） | Small order fee | small_order_fee。接口新增字段，注意需要新增保存 | | 买家服务费（印尼） | Buyer service fee | buyer_service_fee。接口新增字段，注意需要新增保存 | | 手续费（印尼） | Handling fee | handling_fee。接口新增字段，注意需要新增保存 | | 运费保险费（印尼） | Shipping insurance fee | shipping_insurance_fee。接口新增字段，注意需要新增保存 | | 商品保险费（印尼） | Item insurance fee | item_insurance_fee。接口新增字段，注意需要新增保存 |
2024-12-30 ｜ 已完成 ｜ ECERPH-21736
标题：Tiktok》结算中心美国+ACCU+英国本土店铺通过接口获取结算和账单数据
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20250114-常规-1月第二迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
以下接口获取数据仅支持对美国本土和ACCU店铺、英国本土，美国跨境店铺保留使用插件获取数据 判断是否本土店铺可以通过type进行判断，1为跨境，2为本土 【图片】
获取结算明细：https://partner.tiktokshop.com/docv2/page/650a6749defece02be67da87?external_id=650a6749defece02be67da87 获取账单：https://partner.tiktokshop.com/docv2/page/650a6784bace3e02b756fe6d?external_id=650a6784bace3e02b756fe6d 获取订单账单明细：https://partner.tiktokshop.com/docv2/page/650a6734defece02be67d724?external_id=650a6734defece02be67d724
2.结算单单据费用字段对应说明：
黄色字体为新增的费用字段。
| 系统字段 | | 接口字段 | |
| --- | --- | --- | --- |
| Total settlement amount（结算金额） | settlement_amount | Net sales（净销售额） | net_sales_amount |
| | | Gross sales（总销售额） | gross_sales_amount |
| | | Gross sales refund（销售退款总额） | gross_sales_refund_amount |
| | | Seller discount（卖方折） | seller_discount_amount |
| | | Seller discount refund（卖家折扣退款） | seller_discount_refund_amount |
| | Shipping（平台运费） | shipping_cost_amount | |
| | TikTok Shop shipping fee（TikTok商店运费） | fbm_shipping_cost_amount | |
| | Fulfilled by TikTok Shop (FBT) shipping fee（由TikTok商店（FBT）运费支付） | fbt_shipping_cost_amount | |
| | Signature confirmation service fee（签名确认服务费）【US】 | signature_confirmation_fee_amount | |
| | Shipping insurance fee（运送保险费）【US】 | shipping_insurance_amount | |
| | Customer-paid shipping fee（买家支付的运费） | customer_paid_shipping_fee_amount | |
| | Customer-paid shipping fee refund（已支付买家的运费退款） | customer_paid_shipping_fee_refund_amount | |
| | TikTok Shop shipping incentive（TikTok商店发货奖励） | promo_shipping_incentive_amount | |
| | TikTok Shop shipping incentive refund（TikTok商店运费奖励退款） | refund_shipping_cost_discount_amount | |
| | Shipping fee subsidy（运费补贴） | shipping_fee_subsidy_amount | |
| | Return shipping fee（退货运费） | return_shipping_fee_amount | |
| | FBT fulfillment fee（FBT履行费用）【US】 | fbt_fulfillment_fee_amount | |
| | Customer shipping fee offset（客户运费抵消）【US】 | customer_shipping_fee_offset_amount | |
| | Limited-time sign up shipping incentive（限时注册送货奖励）【US】 | Fees（平台费用） | fee_amount |
| | | Transaction fee（交易手续费）【US】 | transaction_fee_amount |
| | | Referral fee（推荐费）【US】 | referral_fee_amount |
| | | Refund administration fee（退还管理费）【US】 | refund_administration_fee_amount |
| | | Affiliate commission（合作伙伴佣金） | affiliate_commission_before_pit |
| | | Affiliate partner commission（联盟合作伙伴佣金） | affiliate_partner_commission_amount |
| | | Affiliate Shop Ads commission（联盟合作广告佣金） | affiliate_ads_commission_amount |
| | | Tiktok shop commission【UK】 | platform_commission_amount |
| | | VAT【UK】 | |
| | Adjustments | | adjustment_amount |
| | 其他基础字段
系统字段 | 接口字段 | |
| 订单号/Adjustment ID | order_id/adjustment_id | | |
| 订单创建 | order_create_time | | |
| Statement ID | statement_id | | |
| 结算日期 | statement_time | | |
| Statement类型 | type | | |
| 关联订单 | adjustment_order_id | | |
| 结算状态 | 缺失状态，暂不获取 | | |
| Payout ID | 通过statement_id关联payout获取 | | |
| 回款状态 | 通过statement_id关联payout获取 | | |
| payout创建时间 | 通过statement_id关联payout获取 | | |
| payout回款时间 | 通过statement_id关联payout获取 | | |
| 3.对接payment的数据
系统字段 | 接口字段 | | |
| Payout ID | id | | |
| 创建时间 | create_time | | |
| 回款时间 | paid_time | | |
| 回款状态 | status | | |
| 结算金额 | settlement_amount | | |
| 储备金 | reserve_amount | | |
| 回款金额 | amount | | |
4.新用户授权默认拉取最近1个月的数据。 每个店铺每天拉取1次最近3天的payment和statement列表数据。 如果有新增的statement数据则通过获取订单明细数据接口获取listting维度的数据。 在此基础上如果回款状态pending的statement结算数据状态更新为success则相应更新statement的明细数据和更新对应订单的明细数据。
5.在截图中位置新增2中提到的新增费用字段。 首页的结算数据明细图需要增加缺失英文的字段需要增加对应的英文说明。 【图片】 【图片】 【图片】
6.导出报表中需要新增2中提到的新增费用
7.结算中心的总览、payout、statement、onhold上都新增币种切换功能。枚举值为美元、人民币、英镑 【图片】
2024-11-11 ｜ 已完成 ｜ ECERPH-19266
标题：Tiktok》结算中心中拉取任务新增任务完成时间
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241130-紧急-11月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
1.结算中心中拉取任务中新增完成时间 【图片】
2024-11-11 ｜ 已完成 ｜ ECERPH-19252
标题：Tiktok》预估利润增加订单状态和结算状态的筛选项
负责人：黎明俊 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241130-紧急-11月紧急迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
【图片】
-
新增平台订单状态的筛选项。支持多选筛选
-
新增系统订单状态的筛选项，支持多选筛选
-
新增结算状态的筛选项。支持多选筛选。枚举值如下：
无结算数据：未使用插件获取结算数据的订单 待结算：使用插件获取到结算数据，但是仅有预估结算金额和预估结算日期的订单 已结算：使用插件获取到结算数据，并且已获取到实际结算金额和实际结算日期。
4.页面上新增自定义列的功能，支持用户手动选择显示的字段以及可以冻结的字段。默认勾选已有的字段 【图片】
2024-11-01 ｜ 已完成 ｜ ECERPH-18806
标题：Tiktko结算中心》同一个订单存在不同的statement的时候需要拆分显示
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
如果一个订单存在不同的statement的时候需要将他们拆分来显示 【图片】
2024-10-16 ｜ 已完成 ｜ ECERPH-17963
标题：Tiktok》结算中心筛选条件需要随着Tab页面切换
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241022-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
店铺和平台类型选项切换tab的时候不清除，保持选中改选项 注意：如果类似总览页面没有对应平台类型的筛选项则，该筛选项不生效 【图片】 【图片】
2024-10-15 ｜ 已完成 ｜ ECERPH-17912
标题：Tiktok》结算中心样式调整
负责人：曾宪森 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-订单模块 ｜ 迭代：20241022-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
【图片】
1.周期对比的时候根据当日所在时间对比上周周日至当日所在时间的数据。例如今天是周三，则周期对比取值上周的周日、周一、周二、周三进行对比。 鼠标悬停在上一周期的时候气泡提示上一周期的时间区间：2024/10/15-2024/10/18 这样
2.上一周期一列数据需要上移到下图的位置 【图片】
2024-10-14 ｜ 已完成 ｜ ECERPH-17854
标题：Tiktok》结算中心调整顶部面板
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241022-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
- 需求（做什么？怎么做？有什么要注意的？）
销售》结算中心
顶部面板调整为如下
- 本周已回款金额：
【图片】 （1）本周当前日期所在周的周日到周六。[按照UTC 时间进行换算] 【图片】 （2）已回款金额为时间段内payou状态为success的单据的回款金额之和 【图片】 （3）鼠标悬停在标题上的时候显示气泡提示：“状态为Success的payout的回款金额之和” （4）选择店铺的时候，此面板需要按照店铺筛选出对应的店铺的本周数据，但是设置时间选择器的则不影响此面板的数据，此面板的数据固定为本周的数据 （5）周期对比的时候根据当日所在时间对比上周周日至当日所在时间的数据。例如今天是周三，则周期对比取值上周的周日、周一、周二、周三进行对比。 鼠标悬停在上一周期的时候气泡提示上一周期的时间区间：2024/10/15-2024/10/18 这样
2.至今回款中金额 （1）至今回款中金额为所有payou状态为processing的单据的回款金额之和 【图片】 （2）鼠标悬停在标题上的时候显示气泡提示：“状态为Processing的payout的回款金额之和” （3）选择店铺的时候，此面板需要按照店铺筛选出对应的店铺的数据，但是设置时间选择器的则不影响此面板的数据，此面板的数据固定为至今为止的数据
3.至今待结算的金额 （1）Onhold中所有单据的预估结算金额之和 【图片】 （2）鼠标悬停在标题上的时候显示气泡提示：“Onhold状态下所有单据的预估结算金额之和” （3）下拉弹窗的样式同原未结算订单结算金额下拉框的样式和取值逻辑保持一致 【图片】 （4）选择店铺的时候，此面板需要按照店铺筛选出对应的店铺的数据，但是设置时间选择器的则不影响此面板的数据，此面板的数据固定为至今为止的数据
2024-10-10 ｜ 已完成 ｜ ECERPH-17639
标题：Tiktok结算》结算中心拉取任务的状态中新增状态：无数据
负责人：陈洁超 ｜ 需求类型：交付先锋(便捷性等) ｜ 模块：TikTok-达人模块 ｜ 迭代：20241022-常规-10月第三迭代 ｜ 最后更新：2026-05-18
需求描述：
-
背景（谁？什么问题？有什么影响？为什么？）
-
需求（做什么？怎么做？有什么要注意的？）
拉取任务中新增状态：无数据。 【图片】 【图片】
2023-11-22 ｜ 已完成 ｜ ECERPH-3559
标题：订单系统》【TIKtok轻量版】tiktok平台，对接账单接口更新账单数据
负责人：陈嘉骏 ｜ 模块：销售-订单管理-费用 ｜ 平台字段：Tiktok ｜ 迭代：20231231-项目-TikTok轻量级ERP ｜ 最后更新：2023-11-29
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
对接账单接口
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》tiktok平台
-
对接中台获取账单数据。接口地址：https://partner.tiktokshop.com/doc/page/63fd7434715d622a338c4cd0?external_id=63fd7434715d622a338c4cd0
-
对接费用明细
（1）使用接口返回的数据中order_id去匹配对应的订单 （2）一个订单可能存在多个账单数据，区分方式为order_id相同，但是unique_key不同则说明是同一个订单下的不同账单，针对这种情况计算的时候需要将2次账单的数据相加处理，具体处理方式详见下方的费用计算表格 （3）tk平台的账单数据中存在正负数的概念，所以在保存账单数据的时候需要保留这些费用数据正负号。
3.对接费用明细 （4）tk平台的查看金额中新增【查看费用详情】，点击出现弹窗如下。弹窗固定高度为550px 【图片】
当未拉取到结算账单的时候订单费用的样式如下。默认所有信息都是折叠起来的 【图片】
当拉取到结算的时候的费用样式如下。默认所有信息都是折叠起来的 【图片】
【单1：样例订单：578057463004891252 客户代码：sky 店铺：TK_LiveMall_PH】 报文见附件 | 系统新增费用项命名 | 系统映射字段 | 取值来源 | 接口对应字段或者计算方式 | 备注 | 系统？提示 | 账单未结算前是否能获取到数据 | 单1取值 | 平台字段翻译说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 平台结算金额 | 系统计算 | 当tk线上物流发货时： | | | | | | | 平台收入-平台支出-（原币种）运输费
当非tk线上物流发货时：
平台收入-平台支出
| 当接口没有返回任何账单数据的时候显示未结算。 | 如果订单使用的时候运输方式的服务商代码为TIKTOK ，则为tk线上物流发货订单，所以减去原币种的运输费 | tiktok线上物流发货的时候，平台结算金额=平台收入-平台支出-（原币种）运输费。 |
| --- | --- | --- |
| 非tiktok线上物流发货的时候，平台结算金额=平台收入-平台支出 | 否 | 259.52-0-63=196.52 |
| | settlement_amount=user_pay+platform_promotion+shipping_fee_subsidy-refund-payment_fee-platform_commission-flat_fee-sales_fee-affiliate_commission-affiliate_partner_commission-vat-shipping_fee-small_order_fee-transaction_fee+ satisfaction_subsidy+tok_logistics_reimbursement+logistics_reimbursement+ other_adjustment+promotion_adjustment+ customer_service_compensation+ charge_back+ shipping_fee_adjustment | |
| 平台收入 | 系统计算 | 买家支付总金额+平台补贴 |
| 需要按照汇率换算成RMB | 平台收入=买家支付总金额+平台补贴 | 是 |
| | 259.52PHP
=32.272RMB | |
| | 买家支付总金额 | 订单接口 |
| Get Order Detail | | |
| total_amount | | |
| | 买家支付总金额=折扣后小计+折扣后运费+总税费 | |
| | 是 | |
| | 259.52 | |
| 折扣后小计 | 订单接口 | |
| Get Order Detail | | |
| sub_total | | |
| | 折扣后小计=商品原价-卖家折扣-平台折扣 | |
| | 是 | |
| | 259.52 | |
| 商品原价 | | |
| | 订单接口 | |
| Get Order Detail | original_total_product_price | |
| | 产品原价合计。(VAT跨境购物）。 | |
| 对于美国市场，这是税前总额。 | 是 | |
| | 产品原价合计。(VAT跨境购物）。 | |
| 对于美国市场，这是税前总额。 | | |
| 卖家折扣 | | |
| | 订单接口 | |
| Get Order Detail | seller_discount | |
| | 卖方提供的产品折扣 | |
| | 是 | |
| | 产品折扣由卖方. | |
| 平台折扣 | | |
| | 订单接口 | |
| Get Order Detail | platform_discount | |
| | 平台提供的产品折扣 | |
| | 是 | |
| | 产品折扣平台。 | |
| 折扣后运费 | | |
| | 订单接口 | |
| Get Order Detail | shipping_fee | |
| | 折扣后运费=运费原价-卖家运费折扣-平台运费折扣 | |
| | 0 | |
| | 买家支付运费。 | |
| 对于美国市场，这是税前总额。 | | |
| 运费原价 | | |
| | 订单接口 | |
| Get Order Detail | original_shipping_fee | |
| | 折扣前运费 | |
| | 是 | |
| | 折扣前运费 | |
| 卖家运费折扣 | | |
| | 订单接口 | |
| Get Order Detail | shipping_fee_seller_discount | |
| | 卖方提供的运费折扣 | |
| | 是 | |
| | 运费折扣由卖方。 | |
| 平台运费折扣 | | |
| | 订单接口 | |
| Get Order Detail | shipping_fee_platform_discount | |
| | 平台提供的运费折扣 | |
| | 是 | |
| | 运费折扣由平台。 | |
| 总税费 | | |
| | 订单接口 | |
| Get Order Detail | taxes | |
| | 买方支付了订单的全部税款。适用于跨境商店和美国市场。 | |
| | 是 | |
| | 买方支付了订单的全部税款。适用于跨境商店和美国市场。 | |
| 平台补贴 | | |
| | 系统计算 | |
| | 平台运费补贴+平台促销补贴+运费调整费+异议扣款+客户服务补偿+折扣调整费+其他调整费+物流报销+Tiktok物流报销+满意度补贴 | |
| | （1）当平台运费补贴、运费调整费、异议扣款、客户服务补偿、折扣调整费、其他调整费为正数的时候才计入平台补贴 | |
| （2）各个费用项相加的时候需要各个费用项都取绝对值后再相加 | 平台补贴=平台运费补贴+平台促销补贴+运费调整费+异议扣款+客户服务补偿+折扣调整费+其他调整费+物流报销+Tiktok物流报销+满意度补贴（平台运费补贴、运费调整费、异议扣款、客户服务补偿、折扣调整费、其他调整费根据业务情况可能为正数可能为负数，正数则计入平台补贴，负数则计入平台支出） | |
| | 否 | |
| | 0 | |
| 平台支出 | | |
| | 系统计算 | |
| | 支付手续费+平台佣金+平台运费补贴+固定费用+销售费+推广佣金+VAT税费+小额订单服务费+联盟伙伴佣金+运费调整费+异议扣款+客户服务补偿+折扣调整费+其他调整费 | |
| | （1）当平台运费补贴、运费调整费、异议扣款、客户服务补偿、折扣调整费、其他调整费为负数的时候才计入平台补贴 | |
| （2）各个费用项相加的时候需要各个费用项都取绝对值后再相加
（3）需要按照汇率换算成RMB | 平台支出=支付手续费+平台佣金+平台运费补贴+固定费用+销售费+推广佣金+VAT税费+小额订单服务费+联盟伙伴佣金+运费调整费+异议扣款+客户服务补偿+折扣调整费+其他调整费 | |
| （平台运费补贴、运费调整费、异议扣款、客户服务补偿、折扣调整费、其他调整费根据业务情况可能为正数可能为负数，正数则计入平台补贴，负数则计入平台支出） | 否 | |
| | 0 PHP=0RMB | |
| 支付手续费 | 手续费 | |
| | 账单接口 | |
| Get Settlements | payment_fee | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 平台在线支付、退款、结算等类别收取的技术服务费（结算金额的X%） | |
| | 否 | |
| | 0+0=0 | |
| | 平台在线支付、退款、结算等类别收取的技术服务费（结算金额的X%） | |
| 平台佣金 | 交易费 | |
| | 账单接口 | |
| Get Settlements | platform_commission | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 平台收取的平台佣金费用（已结算订单的X%） | |
| | 否 | |
| | 0+0=0 | |
| | 平台收取的平台佣金费用（已结算订单的X%） | |
| 平台运费补贴 | 正数-补贴 | |
| 负数-其他费用 | 账单接口 | |
| Get Settlements | shipping_fee_subsidy | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入平台补贴/补贴，负数计入平台支出/其他费用 | |
| | 正数表示参与平台活动获得的运费折扣，负数表示您需要返回的运费折扣。 | |
| | 否 | |
| | 0+0=0 | |
| | 正数表示参与平台活动获得的运费折扣，负数表示您需要返回的运费折扣。 | |
| 平台促销补贴 | 补贴 | |
| | 账单接口 | |
| Get Settlements | platform_promotion | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 由平台补贴的促销费用，可能包括优惠券和平台组织的其他促销活动 | |
| | 否 | |
| | 0+0=0 | |
| | 由平台补贴的促销费用，可能包括优惠券和平台组织的其他促销活动 | |
| 固定费用 | 交易费 | |
| | 账单接口 | |
| Get Settlements | flat_fee | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 固定费用是对每个有效订单收取的固定金额 | |
| | 否 | |
| | 0+0=0 | |
| | 固定费用是对每个有效订单收取的固定金额 | |
| 销售费 | 交易费 | |
| | 账单接口 | |
| Get Settlements | sales_fee | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 销售费是产品价格在卖方折扣后的一定百分比，向卖方收取 | |
| | 否 | |
| | 0+0=0 | |
| | 销售费是产品价格在卖方折扣后的一定百分比，向卖方收取 | |
| 推广佣金 | 其他费用 | |
| | 账单接口 | |
| Get Settlements | affiliate_commission | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 当创作者在Tiktok平台上推广产品并产生订单时，需要支付给创作者的佣金（金额取决于卖家的推广计划） | |
| | 否 | |
| | 0+0=0 | |
| | 当创作者在Tiktok平台上推广产品并产生订单时，需要支付给创作者的佣金（金额取决于卖家的推广计划） | |
| VAT税费 | 其他费用 | |
| | 账单接口 | |
| Get Settlements | vat | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 由平台代为支付的增值税。仅适用于跨境购物订单。 | |
| | 否 | |
| | 0+0=0 | |
| | 由平台代为支付的增值税。仅适用于跨境购物订单。此API中其他字段的金额均不含增值税。 | |
| 小额订单服务费 | 其他费用 | |
| | 账单接口 | |
| Get Settlements | small_order_fee | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 小额订单费是客户为小额订单支付的服务费。 | |
| | 否 | |
| | 0+0=0 | |
| | 小额订单费是客户为小额订单支付的服务费。 | |
| 联盟伙伴佣金 | 交易费 | |
| | 账单接口 | |
| Get Settlements | affiliate_partner_commission | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 用户通过联盟合作伙伴的链接支付的金额乘以联盟合作伙伴佣金率（这是用户实际支付的金额，不包括任何TikTok商店优惠券或卖家优惠券的折扣。 | |
| | 否 | |
| | 0+0=0 | |
| | 用户通过联盟合作伙伴的链接支付的金额乘以联盟合作伙伴佣金率（这是用户实际支付的金额，不包括任何TikTok商店优惠券或卖家优惠券的折扣。 | |
| 运费调整费 | 正数-补贴 | |
| 负数-其他费用 | 账单接口 | |
| Get Settlements | shipping_fee_adjustment | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入平台补贴/补贴，负数计入平台支出/其他费用 | |
| | 调整费收取，以弥补实际运费和预付运费之间的差额。 | |
| 正数：TTS为商家买单;
负数：TTS向商家收费。 | 否 | |
| | null | |
| | 调整费收取，以弥补实际运费和预付运费之间的差额。 | |
| 正价值：TTS为商家买单;
负值：TTS向商家收费。 | | |
| 异议扣款 | 正数-补贴 | |
| 负数-其他费用 | 账单接口 | |
| Get Settlements | charge_back | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入平台补贴/补贴，负数计入平台支出/其他费用 | |
| | 在客户成功对他/她的账户对账单或交易报告中的项目提出异议后，返回到支付卡的金额。 | |
| 正数：TTS为商家买单;
负数：TTS向商家收费。 | 否 | |
| | null | |
| | 在客户成功对他/她的账户对账单或交易报告中的项目提出异议后，返回到支付卡的金额。 | |
| 正价值：TTS为商家买单;
负值：TTS向商家收费。 | | |
| 客户服务补偿 | 正数-补贴 | |
| 负数-其他费用 | 账单接口 | |
| Get Settlements | customer_service_compensation | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入平台补贴/补贴，负数计入平台支出/其他费用 | |
| | 订单支付或超额退款后的退款金额。 | |
| 正数：TTS为商家买单;
负值：TTS向商家收费。 | 否 | |
| | null | |
| | 订单支付或超额退款后的退款金额。 | |
| 正价值：TTS为商家买单;
负值：TTS向商家收费。 | | |
| 折扣调整费 | 正数-补贴 | |
| 负数-其他费用 | 账单接口 | |
| Get Settlements | promotion_adjustment | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入平台补贴/补贴，负数计入平台支出/其他费用 | |
| | 正数：TTS为商家买单; | |
| 负数：TTS向商家收费。 | 否 | |
| | null | |
| | 正价值：TTS为商家买单; | |
| 负值：TTS向商家收费。 | | |
| 订单处理服务费 | 交易费 | |
| | 账单接口 | |
| Get Settlements | transaction_fee | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 交易费是在TikTok商店处理成功订单所收取的服务费。 | |
| | 否 | |
| | 0+0=0 | |
| | 交易费是在TikTok商店处理成功订单所收取的服务费。 | |
| 其他调整费 | 正数-补贴 | |
| 负数-其他费用 | 账单接口 | |
| Get Settlements | other_adjustment | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入平台补贴/补贴，负数计入平台支出/其他费用 | |
| | 正数：TTS为商家买单; | |
| 负值：TTS向商家收费。 | 否 | |
| | null | |
| | 正价值：TTS为商家买单; | |
| 负值：TTS向商家收费。 | | |
| 物流报销 | 补贴 | |
| | 账单接口 | |
| Get Settlements | logistics_reimbursement | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 否 | |
| | 空数据 | |
| | 后勤补偿 | |
| Tiktok物流报销 | 补贴 | |
| | 账单接口 | |
| Get Settlements | tok_logistics_reimbursement | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 否 | |
| | 空数据 | |
| | 托克后勤补偿 | |
| 满意度补贴 | 补贴 | |
| | 账单接口 | |
| Get Settlements | satisfaction_subsidy | |
| | 如果存在多个账单的时候需要将多账单中对应的值相加 | |
| | 否 | |
| | 空数据 | |
| | 满意补贴 | |
| 成本 | 系统计算 | |
| 采购成本+采购运费+采购税费+头程关税+头程运费+包材成本+运输费 | | |
| 成本=采购成本+采购运费+采购税费+头程关税+头程运费+包材成本+运输费 | 是 | |
| 30.525RMB | | |
| 采购成本 | | 系统取值 |
| 【图片】 | | |
| | 17.000 | |
| 采购运费 | | 系统取值 |
| 【图片】 | | |
| | 1.000 | |
| 采购税费 | | 系统取值 |
| 【图片】 | | |
| | 0.000 | |
| 头程关税 | | 系统取值 |
| 【图片】 | | |
| | 0.000 | |
| 头程运费 | | 系统取值 |
| 同订单列表内的利润详情一样的取值方式 | | |
| | 0.000 | |
| 包材成本 | | 系统取值 |
| 同订单列表内的利润详情一样的取值方式 | | |
| | 0.108 | |
| 运输费 | 运输费 | 账单接口
Get Settlements和系统取值 |
| 【图片】
（2）如果订单使用的时候运输方式的服务商代码为TIKTOK或者订单为FBP订单，则需要取值账单接口中的shipping_fee作为原币种金额显示在旁边
【图片】
【图片】 | （1）如果存在多个账单的时候需要将多账单中对应的值相加
（2）将此数据保存在数据库供仓配系统来获取运输费 | 运输费为发货花费的实际运费。当使用tiktok线上物流的时候还会显示原币种的实际运费以做参考 |
| | （-63PHP）12.417RMB | 商家选择TikTok Shop支持的物流服务时支付的运费 |
| 利润 | | 系统计算 |
| | 当计算出来的利润值大于0则显示正利润
当计算出来的利润值小于0则显示负利润
利润值等于0，则不显示利润标签，为空即可 | 利润=平台收入-平台支出-成本 |
| | 32.272-0-30.525=1.747【正利润】 | |
| 利润率 | | 系统计算 |
| | | 利润率=利润/平台收入 |
| | 1.747/32.272=5.413% | |
| 汇率 | | 系统取值 |
| 【图片】 | | |
| | PHP/RMB汇率:0.12435 | |
2023-11-14 ｜ 已完成 ｜ ECERPH-3229
标题：订单系统》tiktok平台，对接账单接口更新账单数据
负责人：刘星辉 ｜ 模块：销售-订单管理-费用 ｜ 平台字段：Tiktok ｜ 迭代：20231128-项目-TikTok专项 ｜ 最后更新：2023-11-28
需求描述：
- 背景（谁？什么问题？有什么影响？为什么？）
对接账单接口
- 需求（做什么？怎么做？有什么要注意的？）
订单系统》tiktok平台
-
对接中台获取账单数据。接口地址：https://partner.tiktokshop.com/doc/page/63fd7434715d622a338c4cd0?external_id=63fd7434715d622a338c4cd0
-
对接费用明细
（1）使用接口返回的数据中order_id去匹配对应的订单 （2）一个订单可能存在多个账单数据，区分方式为order_id相同，但是unique_key不同则说明是同一个订单下的不同账单，针对这种情况计算的时候需要将2次账单的数据相加处理，具体处理方式详见下方的费用计算表格 （3）tk平台的账单数据中存在正负数的概念，所以在保存账单数据的时候需要保留这些费用数据正负号。
3.将以下表格内数据映射到系统的费用字段内
【样例订单：578057463004891252 客户代码：sky 店铺：TK_LiveMall_PH】 报文见附件
| 平台费用名称 | 系统映射字段 | 接口对应字段或者计算方式 | 值 | 平台字段翻译说明 | 备注 |
| --- | --- | --- | --- | --- | --- |
| 支付手续费 | 手续费 | payment_fee | 0 | 平台在线支付、退款、结算等类别收取的技术服务费（结算金额的X%） | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 平台佣金 | 交易费 | platform_commission | 0 | 平台收取的平台佣金费用（已结算订单的X%） | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 运输费 | 运输费 | shipping_fee | 63 | 商家选择TikTok Shop支持的物流服务时支付的运费 | （1）如果存在多个账单的时候需要将多账单中对应的值相加
（2）这个值需要保存下来让仓配系统来取值作为尾程运费 |
| 平台运费补贴 | 正数-补贴
负数-其他费用 | shipping_fee_subsidy | 0 | 正数表示参与平台活动获得的运费折扣，负数表示您需要返回的运费折扣。 | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入补贴，负数计入其他费用 |
| 平台促销补贴 | 补贴 | platform_promotion | 0 | 由平台补贴的促销费用，可能包括优惠券和平台组织的其他促销活动 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 固定费用 | 交易费 | flat_fee | 0 | 固定费用是对每个有效订单收取的固定金额 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 销售费 | 交易费 | sales_fee | 0 | 销售费是产品价格在卖方折扣后的一定百分比，向卖方收取 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 推广佣金 | 其他费用 | affiliate_commission | 0 | 当创作者在Tiktok平台上推广产品并产生订单时，需要支付给创作者的佣金（金额取决于卖家的推广计划） | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 总税费 | 其他费用 | vat | 0 | 由平台代为支付的增值税。仅适用于跨境购物订单。此API中其他字段的金额均不含增值税。 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 小额订单服务费 | 其他费用 | small_order_fee | 0 | 小额订单费是客户为小额订单支付的服务费。 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 联盟伙伴佣金 | 交易费 | affiliate_partner_commission | 0 | 用户通过联盟合作伙伴的链接支付的金额乘以联盟合作伙伴佣金率（这是用户实际支付的金额，不包括任何TikTok商店优惠券或卖家优惠券的折扣。 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 运费调整费 | 正数-补贴
负数-其他费用 | shipping_fee_adjustment | null | 调整费收取，以弥补实际运费和预付运费之间的差额。
正价值：TTS为商家买单;
负值：TTS向商家收费。 | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入补贴，负数计入其他费用 |
| 异议扣款 | 正数-补贴
负数-其他费用 | charge_back | null | 在客户成功对他/她的账户对账单或交易报告中的项目提出异议后，返回到支付卡的金额。
正价值：TTS为商家买单;
负值：TTS向商家收费。 | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入补贴，负数计入其他费用 |
| 客户服务补偿 | 正数-补贴
负数-其他费用 | customer_service_compensation | null | 订单支付或超额退款后的退款金额。
正价值：TTS为商家买单;
负值：TTS向商家收费。 | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入补贴，负数计入其他费用 |
| 折扣调整费 | 正数-补贴
负数-其他费用 | promotion_adjustment | null | 正价值：TTS为商家买单;
负值：TTS向商家收费。 | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入补贴，负数计入其他费用 |
| 订单处理服务费 | 交易费 | transaction_fee | 0 | 交易费是在TikTok商店处理成功订单所收取的服务费。 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 其他调整费 | 正数-补贴
负数-其他费用 | other_adjustment | null | 正价值：TTS为商家买单;
负值：TTS向商家收费。 | 如果存在多个账单的时候需要将多账单中对应的值相加，然后根据计算出来的结果判断是正数还是负数，正数计入补贴，负数计入其他费用 |
| 物流报销 | 补贴 | logistics_reimbursement | 空数据 | 后勤补偿 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| Tiktok物流报销 | 补贴 | tok_logistics_reimbursement | 空数据 | 托克后勤补偿 | 如果存在多个账单的时候需要将多账单中对应的值相加 |
| 满意度补贴 | 补贴 | satisfaction_subsidy | 空数据 | 满意补贴 | 如果存在多个账单的时候需要将多账单中对应的值相加 |