Tính phí sàn TMĐT API
Tính phí người bán mỗi đơn trên Shopee, TikTok Shop, Lazada: phí theo ngành hàng, phí giao dịch, gói dịch vụ, thuế sàn khấu trừ, giá hoà vốn, giá đề xuất.
API tính phí sàn cho biết người bán thực nhận bao nhiêu từ một đơn hàng trên Shopee, TikTok Shop hoặc Lazada. Gửi platform, price, cost và ngành hàng category bằng lời thường (son môi, áo thun, laptop) hoặc tự nhập fixed_fee_rate: API tìm mức phí theo ngành hàng (TikTok Shop: bảng phí chính thức đến ngành cấp 3, áp dụng từ 03/7/2026 cho shop thường và 03/8/2026 cho Mall; Shopee: khung phí theo ngành cấp 1 từ 23/5/2026 và 29/5/2026, mặc định lấy mức cao nhất), rồi cộng phí giao dịch (6% trên giá sau giảm giá của shop cộng phí ship người mua trả), phí cố định mỗi đơn (3.000 đ), các gói dịch vụ tuỳ chọn (voucher_xtra, piship, freeship_max của Lazada, có trần mỗi sản phẩm), affiliate_rate, ads_rate và other_costs.
Với hộ và cá nhân kinh doanh, API tính thêm thuế sàn khấu trừ theo Nghị định 117/2025/NĐ-CP (hàng hoá 1% GTGT + 0,5% TNCN; dịch vụ 5% + 2%; vận tải, dịch vụ gắn với hàng hoá 3% + 1,5%), được bù trừ hoặc hoàn lại nếu doanh thu năm không quá 1 tỷ đồng; doanh nghiệp không bị khấu trừ (seller_type=company). Kết quả gồm từng dòng phí, tiền thực nhận, lợi nhuận và biên lợi nhuận tại giá bán, giá hoà vốn, và với target_margin là giá bán cần đặt để đạt biên lợi nhuận đó. GET ?platform=tiktok&categories=son môi chỉ tra mức phí ngành hàng.
Biểu phí được nhập tay từ trang biểu phí, thông báo công khai của các sàn, kèm phiên bản bảng phí và ngày rà soát trong mọi kết quả; một tác vụ hằng tuần băm các trang này để báo khi có thay đổi. Sàn đổi phí thường xuyên và Lazada chỉ công bố bảng phí theo ngành trong Seller Center: mọi mức phí đều có thể ghi đè.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
platform | body|query | string | có | shopee, tiktok hoặc lazada (bỏ trống: tổng quan biểu phí). | |
price | body|query | number | không | Giá bán mỗi sản phẩm (đồng). | |
cost | body|query | number | không | Giá vốn mỗi sản phẩm (để tính lợi nhuận, hoà vốn, giá đề xuất). | |
category | body|query | string | không | Ngành hàng bằng lời (Shopee, TikTok Shop). | |
fixed_fee_rate | body|query | number | không | Phí cố định / hoa hồng của ngành hàng, % (ghi đè bảng phí). | |
shop_type | body|query | string | không | normal | normal hoặc mall (Shopee Mall, TikTok Shop Mall, LazMall). |
quantity | body|query | number | không | 1 | Số sản phẩm trong đơn. |
seller_discount | body|query | number | không | Giảm giá do shop tài trợ cho đơn (đồng). | |
buyer_shipping | body|query | number | không | Phí ship người mua trả (tính vào phí giao dịch). | |
voucher_xtra | body|query | boolean | không | Tham gia Voucher Xtra (Shopee, TikTok Shop); truyền số để đặt mức phí. | |
piship | body|query | boolean | không | Gói PiShip của Shopee. | |
freeship_max | body|query | boolean | không | Freeship Max của Lazada; truyền số để đặt mức phí. | |
affiliate_rate | body|query | number | không | Hoa hồng tiếp thị liên kết (%). | |
ads_rate | body|query | number | không | Chi phí quảng cáo theo % doanh thu. | |
other_costs | body|query | number | không | Chi phí khác mỗi đơn (đóng gói…), đồng. | |
seller_type | body|query | string | không | household | household, individual (bị khấu trừ thuế) hoặc company. |
tax_category | body|query | string | không | goods | goods, services hoặc goods_services. |
target_margin | body|query | number | không | Biên lợi nhuận mong muốn (% doanh thu): trả về suggested_price. | |
categories | query | string | không | Chỉ GET: tra mức phí ngành hàng (son môi, hoặc 1 để xem danh sách). |
Ví dụ
curl -X POST "https://apibox.io.vn/v1/vn-marketplace-fees" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"platform":"tiktok","price":250000,"cost":120000,"category":"son môi","target_margin":20}'const res = await fetch('https://apibox.io.vn/v1/vn-marketplace-fees', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"platform": "tiktok",
"price": 250000,
"cost": 120000,
"category": "son môi",
"target_margin": 20
}),
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
"https://apibox.io.vn/v1/vn-marketplace-fees",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"platform": "tiktok", "price": 250000, "cost": 120000, "category": "son môi", "target_margin": 20},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-marketplace-fees');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => '{"platform":"tiktok","price":250000,"cost":120000,"category":"son môi","target_margin":20}',
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"platform": "tiktok",
"platform_name": "TikTok Shop",
"shop_type": "normal",
"category": {
"level": 3,
"path": [
"Chăm sóc sắc đẹp & Chăm sóc cá nhân",
"Trang điểm",
"Son môi & Son bóng"
],
"rate": 15.5,
"range": null,
"alternatives": []
},
"rates": {
"fixed_fee": 15.5,
"transaction_fee": 6,
"programmes": [],
"per_order": [
{
"code": "order_processing",
"name_vi": "Phí xử lý đơn hàng",
"amount": 3000
}
],
"affiliate": 0,
"ads": 0,
"effective": {
"commission": {
"normal": "2026-07-03",
"mall": "2026-08-03"
},
"transaction": "2026-05-09"
}
},
"tax": {
"seller_type": "household",
"withheld": true,
"category": "goods",
"vat_rate": 1,
"pit_rate": 0.5,
"decree": "117/2025/NĐ-CP",
"effective_from": "2025-07-01",
"reviewed": "2026-11-11"
},
"at_price": {
"price": 250000,
"units": 1,
"gross": 250000,
"seller_discount": 0,
"net_sales": 250000,
"buyer_shipping": 0,
"fees": [
{
"code": "commission",
"name_vi": "Phí hoa hồng nền tảng",
"rate": 15.5,
"base": 250000,
"amount": 38750
},
{
"code": "transaction_fee",
"name_vi": "Phí giao dịch",
"rate": 6,
"base": 250000,
"amount": 15000
},
{
"code": "order_processing",
"name_vi": "Phí xử lý đơn hàng",
"amount": 3000
}
],
"fee_total": 56750,
"fee_percent": 22.7,
"tax_withheld": {
"vat": 2500,
"pit": 1250,
"total": 3750
},
"payout": 189500,
"cost": 120000,
"profit": 69500,
"margin_percent": 27.8
},
"break_even_price": 159740,
"target_margin": 20,
"suggested_price": 215789,
"warnings": [],
"fee_table_version": "2026-11",
"reviewed": "2026-11-11",
"review_cadence": "monthly"
}
Ứng dụng
- Định giá sản phẩm trong phần mềm bán hàng đa kênh
- Hiển thị tiền thực nhận mỗi đơn trong dashboard người bán
- So sánh biên lợi nhuận giữa Shopee, TikTok Shop và Lazada
- Ước tính thuế sàn khấu trừ cho hộ kinh doanh online
Hỏi đáp
Biểu phí có được cập nhật không?
Rà soát hằng tháng; mỗi kết quả có fee_table_version và reviewed. Script hằng tuần so sánh các trang biểu phí công khai và báo khi có thay đổi.
Sàn có khấu trừ thuế thay người bán không?
Có với hộ, cá nhân kinh doanh: từ 01/7/2025 (Nghị định 117/2025), sàn có chức năng thanh toán khấu trừ GTGT và TNCN trên từng đơn; người có doanh thu năm dưới 1 tỷ được hoàn lại.
Vì sao phí Shopee là một khoảng?
Shopee tính phí cố định theo ngành cấp 3; API có khung phí theo ngành cấp 1 và mặc định dùng mức cao nhất, trừ khi bạn truyền fixed_fee_rate.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.