Quay lại catalog nguồn dữ liệu
Sàn TMĐTPhù hợp với Retailer

TikTok Shop

Sàn livestream và short-video commerce, kênh tăng trưởng nhanh nhất 2024-2026 tại VN.

Trang chính của vendor Tài liệu API chính thức

Loại API

REST API

Xác thực

OAuth 2.0

Tần suất refresh khả thi

Mỗi giờ, Hằng ngày

Setup · Maintain hằng tháng

12-20 giờ (cộng 5-10 ngày chờ duyệt Developer) · 2-3 giờ

Hướng dẫn kết nối, 6 bước

Làm theo thứ tự từ trên xuống. Mỗi bước có ngữ cảnh để đội kỹ thuật của bạn hiểu lý do, không phải checklist bấm.

  1. 1

    Đăng ký TikTok Shop Partner Center

    Vào partner.tiktokshop.com, đăng ký Developer Account. Phê duyệt khoảng 5-10 ngày, có thể cần phỏng vấn ngắn về use case.

  2. 2

    Tạo App với region Vietnam

    Trong Console, tạo App, chọn region 'Vietnam' (region chỉ chọn 1 lần, không đổi được sau). Chọn scope: order, product, finance, fulfillment, promotion.

  3. 3

    Copy App Key + App Secret

    App Key/Secret hiển thị 1 lần khi tạo. Lưu ngay vào vault, không thể xem lại sau.

  4. 4

    Authorize shop qua TikTok Seller Center

    Generate auth URL → gửi cho admin shop → admin login TikTok Seller Center và accept. Hệ thống nhận access_token, refresh_token, shop_cipher.

  5. 5

    Implement refresh token job

    Access token hết hạn sau 24 giờ. Refresh token hết hạn sau 30 ngày. Tự động refresh access token mỗi 20 giờ.

  6. 6

    Kết nối order + product + statement

    Endpoints chính: /order/202309/orders/search, /product/202309/products/search, /finance/202309/statements. Statement là nguồn cuối cùng cho doanh thu net sau phí.

Credentials cần có

Lưu vào vault hoặc secret manager. Không hardcode trong code, không commit lên git.

  • App Key
  • App Secret
  • Shop Cipher
  • Access Token
  • Refresh Token

Trường dữ liệu mẫu

Các field thường có trong API response. Map vào schema warehouse khi ingest.

  • order_id
  • create_time
  • payment_info.total_amount
  • buyer_email
  • line_items[].sku_id
  • is_from_livestream
  • statement_id
  • statement.settlement_amount

Lỗi và pitfalls thường gặp tại Việt Nam

Đọc kỹ trước khi cam kết timeline, vài rủi ro dưới đây có thể kéo dài tích hợp thêm 1-2 tuần nếu không lên kế hoạch.

  • Rate limit: 60 request/phút mỗi endpoint, chậm hơn Shopee, cần queue cẩn thận.
  • API V2 (202309) thay đổi cấu trúc so với V1 cũ, luôn check release notes trước khi upgrade.
  • Đơn từ livestream có flag is_from_livestream, quan trọng để phân tách kênh khi báo cáo.
  • Phí dịch vụ + phí thanh toán + chiết khấu chương trình TikTok đôi khi báo về chậm 1-3 ngày so với ngày đặt đơn.
  • Region Vietnam cần whitelist IP khi gọi production, chuẩn bị danh sách IP cố định trước.

Dashboard sử dụng TikTok Shop

Xem toàn bộ thư viện dashboard →
Bán lẻ đa kênhCEO

P&L theo kênh bán

Lãi/lỗ thật của từng kênh (Shopee, TikTok Shop, Lazada, Web, Offline) sau khi trừ phí sàn, phí thanh toán, chi phí quảng cáo, hoàn hàng và vận chuyển. Một con số duy nhất cho mỗi kênh, không còn tranh luận cảm tính.

Mở dashboard
Bán lẻ đa kênhTrưởng phòng vận hành

Cảnh báo hết hàng và hàng tồn chậm bán

Hai mặt của một vấn đề: SKU bán chạy có nguy cơ hết trong 7-14 ngày tới, và hàng đã không bán hơn 90 ngày đang khóa vốn. Một danh sách hành động, không phải bảng tồn kho khô khan.

Mở dashboard
Bán lẻ đa kênhTrưởng phòng marketing

Ngân sách quảng cáo lãng phí (Meta / Google / TikTok)

Bảng so sánh chiến dịch theo ROAS thật (sau trừ hoàn hàng và phí sàn), nhóm 20% kém nhất tô màu để xem lại trước khi tiêu thêm. Liên kết ngược về kênh bán để hiểu chiến dịch nào kéo về đơn thật.

Mở dashboard
Bán lẻ đa kênhCEO

Brief CEO cuộc họp đầu tuần

Một trang A4 sáng thứ Hai 7h45: 3 điều tốt, 3 điều cần chú ý, 3 quyết định cần ra trong tuần. Mỗi gạch đầu dòng đều có nguồn để CEO click ra dòng gốc trong dashboard chi tiết.

Mở dashboard
Bước tiếp theo

Kết nối TikTok Shop vào data warehouse của doanh nghiệp bạn

Đặt lịch rà soát 30 phút. Chia sẻ tài khoản hiện tại, chúng tôi đề xuất phạm vi kết nối ưu tiên và timeline ngày bàn giao.

Đặt lịch rà soát 30 phútXem toàn bộ nguồn dữ liệu