Tài liệu Partner API

1. Xác thực bằng API key

Mỗi key gắn với một brand. Một key có thể đọc nhiều nền tảng (Shopee, TikTok, Nhanh…) — tùy các gian hàng / tài khoản bạn tick lúc tạo (mục API key); chỗ không tick thì key không gọi được. Gửi key trong header:

Authorization: Bearer q360_live_<prefix>_<secret>

Key đầy đủ chỉ hiện một lần lúc tạo; hệ thống chỉ lưu hash. Nghi lộ key → thu hồi và tạo key mới. Không đặt key trong URL, mã nguồn công khai hay chat.

Whitelist nguồn gọi (khuyến nghị; có thể bị hệ thống bắt buộc): mỗi key có tối đa 20 mục — IP (203.0.113.10), dải CIDR IPv4/IPv6 (203.0.113.0/24, 2001:db8::/32) hoặc tên miền máy chủ gọi API (erp.congty.vn — hệ thống tra DNS A/AAAA, lưu tạm 5 phút, rồi so với IP nguồn; DNS lỗi = không khớp). Không dùng *, http://, đường dẫn hay cổng; header Origin/Referer KHÔNG được dùng để xác thực. Whitelist trống = mọi IP gọi được.

Gọi từ IP ngoài whitelist bằng key hợp lệ → 403 ip_not_allowed, phản hồi có source_ip = IP mà hệ thống thấy (IP công khai của máy chủ bạn sau NAT/proxy) — thêm đúng IP/dải đó vào whitelist ở trang API key. Khi hệ thống bật "bắt buộc whitelist", key chưa có whitelist nhận 403 whitelist_required. Key có thể đặt hạn dùng (30 / 90 / 180 / 365 ngày); hết hạn → 401.

Base URL: https://partner.quantri360.com/v1. Phản hồi JSON: thành công { ok: true, data, request_id }, lỗi { ok: false, error, message, request_id } (error = mã lỗi ở mục Mã lỗi).

1b. Điều khoản sử dụng API (phiên bản 2026-10-28)

Phải đồng ý khi tạo key (ghi nhận trong nhật ký). Quantri360 là ứng dụng đối tác của Shopee, TikTok Shop, Nhanh.vn… và đã được gian hàng của brand ủy quyền trên từng nền tảng; khi gọi API qua 360, brand (và máy chủ do brand chỉ định) là người dùng của ứng dụng 360 theo điều khoản của từng nền tảng.

1. Key của brand không được chia sẻ; Quantri360 không đọc, không lưu dữ liệu API đối với dịch vụ API này.
2. Hạn mức gọi theo gói; khi có hành vi spam API hoặc sử dụng API sai mục đích, tài khoản có thể bị khóa.
3. Brand chỉ dùng dữ liệu lấy qua Quantri360 cho hoạt động của chính gian hàng mình và chịu ràng buộc bởi điều khoản của nền tảng tương ứng (Shopee, TikTok, Facebook, Google…).
4. Quyền gọi API qua Quantri360 chấm dứt ngay khi brand vi phạm điều khoản này hoặc điều khoản nền tảng, khi nền tảng yêu cầu, hoặc khi brand thu hồi ủy quyền app.
5. Nền tảng đích (Shopee, TikTok Shop…) là bên thụ hưởng thứ ba của thỏa thuận này và có quyền trực tiếp yêu cầu thực thi, kể cả chấm dứt — ví dụ khi brand có hành vi bất thường khiến nền tảng nghi ngờ và yêu cầu Quantri360 thực thi kiểm soát. Quantri360 sẽ thông báo cho brand khi có sự cố này.
6. Brand tự chịu trách nhiệm về máy chủ / dịch vụ nhận dữ liệu (n8n, ERP, agency…) mà brand cấp key; đảm bảo bảo mật và tuân thủ các luật về an toàn dữ liệu.

2. REST /v1 — tự gọi

{platform} = mã nền tảng: shopee · shopee_ads · shopee_ams · shopee_live · shopee_video · tiktok · nhanh · facebook · google · tiktok_business · zalo · ga4 · meet · lark · ghn · jtexpress · kiotviet · pancake_pos · pancake_chat · misa_crm · gmail · base_service · base_wework. Danh sách gian hàng và kết nối key dùng được lấy ở GET /v1/platforms; tạo key, kết nối gian hàng làm ở cổng Partner (không có API riêng). Shopee/TikTok bắt buộc platform_shop_id khi brand có nhiều gian hàng. Phân trang: lặp tới khi next_cursor rỗng. Thời gian ISO 8601 UTC. Các loại "Sắp có" chưa có endpoint.

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_list?time_range_field=update_time&time_from=1760893200&time_to=1760979600&page_size=50&platform_shop_id=123456"

Dữ liệu nền tảng CHỈ lấy qua đường dẫn API của chính nền tảng (mục 2b) — 360 trả đúng những gì nền tảng trả. Dữ liệu đã xử lý (Đơn hàng chuẩn 360) không gọi qua /v1: đó là dịch vụ Auto Data — 360 gọi API, xử lý và đẩy về server / CSDL / Google Sheets của bạn theo lịch hoặc realtime.

2b. Gọi API của nền tảng qua 360

Máy chủ của brand (n8n, ERP, script) gọi đường dẫn, tham số, body như mô tả ở tài liệu API từng nền tảng (mục lục bên dưới); 360 xác thực bằng API key của brand và trả nguyên status + body của sàn. Phân trang, mã lỗi, phiên bản API đều là của sàn — 360 không đổi gì. Chỉ các endpoint trong mục lục API của từng nền tảng được mở; endpoint ghi cần key có quyền ghi.

GET|POST {BASE}/v1/{platform}/<đường dẫn API của nền tảng>?platform_shop_id=<gian hàng>&<tham số của API>
  shopee : /v1/shopee/api/v2/order/get_order_list?time_range_field=create_time&time_from=…&time_to=…&page_size=50
  shopee_ads : /v1/shopee_ads/api/v2/ads/get_total_balance            (quảng cáo Shopee là nền tảng riêng)
  tiktok : /v1/tiktok/order/202309/orders/search?page_size=50        (POST, body JSON)
  nhanh  : /v1/nhanh/v3.0/order/list                                  (POST, body JSON)

Ví dụ

Shopee — đơn tạo trong 1 ngày (get_order_list, lặp cursor tới khi more=false)

curl -s "https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_list?time_range_field=create_time&time_from=1760893200&time_to=1760979600&page_size=50&response_optional_fields=order_status" \
  -H "Authorization: Bearer $KEY"

Shopee — chi tiết tối đa 50 đơn (get_order_detail)

curl -s "https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail?order_sn_list=2510190ABCDEF1,2510190ABCDEF2&response_optional_fields=item_list,recipient_address,total_amount" \
  -H "Authorization: Bearer $KEY"

Shopee Ads — số dư tài khoản quảng cáo (mã nền tảng shopee_ads)

curl -s "https://partner.quantri360.com/v1/shopee_ads/api/v2/ads/get_total_balance" \
  -H "Authorization: Bearer $KEY"

TikTok Shop — tìm đơn theo cửa sổ (orders/search, trang kế bằng page_token)

curl -s -X POST "https://partner.quantri360.com/v1/tiktok/order/202309/orders/search?page_size=50&platform_shop_id=7495000000000000000" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"create_time_ge":1760893200,"create_time_lt":1760979600}'

Nhanh.vn — đơn cập nhật trong cửa sổ (order/list v3, cursor ở paginator.next)

curl -s -X POST "https://partner.quantri360.com/v1/nhanh/v3.0/order/list" \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"filters":{"updatedAtFrom":1760893200,"updatedAtTo":1760979600},"paginator":{"size":50}}'

Mẫu n8n (nhập thẳng vào n8n)

Workflow: Schedule Trigger → HTTP Request (credential Header Auth Authorization: Bearer <key>, phân trang theo cursor của sàn) → nút ghi dữ liệu của bạn (Google Sheets, Postgres, …). Sau khi nhập: tạo credential Header Auth với key của brand, điền platform_shop_id nếu có nhiều gian hàng.

Tải mẫu n8n — đơn shopee Tải mẫu n8n — đơn tiktok Tải mẫu n8n — đơn nhanh

Endpoint được phép

Cách dùng từng endpoint (tham số, phân trang, phản hồi, ví dụ) xem ở tài liệu API từng nền tảng: Shopee · Shopee Ads · Shopee AMS · Shopee Live · Shopee Video · TikTok Shop · Nhanh.vn · Facebook · Google Ads · TikTok Business · Zalo OA · Google Analytics 4 · Google Meet · Lark · GHN · J&T Express · KiotViet · Pancake POS · Pancake Chat · MISA AMIS CRM · Gmail · Base Service · Base Wework.

3. Đơn hàng chuẩn 360 (Auto Data) — một định dạng cho Shopee / TikTok / Nhanh

{
  "order_id": "…", "platform": "shopee|tiktok|nhanh", "platform_shop_id": "…",
  "channel": "shopee|tiktok|facebook|website|live|cskh|excluded|null",   // kênh bán theo Cấu hình báo cáo của brand
  "status": "created|confirmed|paid|shipping|delivered|delivery_failed|cancelled|returned|partially_returned|completed",
  "platform_status": "chuỗi gốc của nền tảng",
  "created_at": "…", "paid_at": null, "shipped_at": null, "delivered_at": null, "cancelled_at": null, "cancel_reason": null,
  "customer": { "name": "…", "phone": "+84…", "username": null },
  "shipping": { "province": "…", "district": "…", "ward": "…", "address": "…", "carrier": "…", "tracking_code": "…", "delivery_option": "…" },
  "amounts": { "subtotal": 0, "seller_discount": 0, "platform_discount": 0, "shipping_fee_buyer": 0, "shipping_fee_seller": 0,
               "platform_fee": null, "payment_fee": null, "affiliate_fee": null, "escrow_amount": null, "vat_amount": null,
               "prices_include_vat": true, "currency": "VND" },
  "items": [ { "sku": "…", "parent_sku": "…", "sku_id": "…", "product_id": "…", "name": "…", "color": "…", "size": "…",
               "quantity": 1, "unit_price": 0, "unit_sale_price": 0, "line_discount": 0, "line_voucher": 0, "vat_percent": null, "line_vat": null } ],
  "returns": [ { "return_id": "…", "status": "…", "reason": "…", "amount": 0, "created_at": "…" } ],
  "source": { "fetched_at": "…", "platform_endpoints": ["…"] }
}

Trường không có ở kênh → null (không bịa 0). Nhanh: "đã xác nhận" → confirmed; 4 trạng thái chuyển hoàn / thất bại của Nhanh là delivery_failed (Nhanh không có "hoàn"). Thay đổi phá vỡ → /v2.

4. Webhook tới URL của brand — chữ ký và envelope

Khi kết nối có đích Webhook URL chạy (realtime, theo lịch hoặc chạy tay), 360 gửi POST JSON tới URL đã khai (chỉ https, tên miền hoặc IP công khai phải được duyệt). Mỗi request kèm:

Body (envelope) — ký trên đúng chuỗi byte đã gửi:

{
  "event": "order.created | order.updated | order.cancelled | order.delivered | order.delivery_failed | order.returned | orders.batch | ping",
  "platform": "shopee | tiktok | nhanh | null",
  "shop_id": "<mã brand>",
  "data": <Đơn hàng chuẩn 360> | [ <Đơn hàng chuẩn 360>, … ] (theo lịch / chạy tay: cả lô) | null (ping),
  "sent_at": "2026-10-19T08:00:00.000Z"
}

Xác minh (Node.js):

const crypto = require('crypto');
function verify(secret, header, rawBody) {
  const m = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(header || '');
  if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
  const expect = crypto.createHmac('sha256', secret).update(m[1] + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(expect), Buffer.from(m[2]));
}

Phản hồi 2xx trong 8 giây = nhận thành công; 3xx không được theo; lỗi/timeout ghi vào nhật ký lần chạy (trang Kết nối) — chạy tay lại khi cần. Nút Kiểm tra ở Đích nhận gửi event: "ping" cùng chữ ký thật.

Google Sheets: mỗi đơn được cập nhật đúng chỗ theo mã đơn trong tab đã chọn, chạy lại không sinh dòng trùng (mỗi dòng một đơn / một dòng hàng).

Realtime — độ trễ và gom lô. Với đích Webhook URL, mỗi sự kiện đơn là một request riêng, gửi ngay khi tới lượt (không gom, không gửi lại — lấy lại qua /v1). Với Google Sheets / MySQL / PostgreSQL / BigQuery / Lark Base, đơn phát sinh trong cửa sổ gom lô của kết nối (10–60 giây, mặc định 30; đủ 500 đơn thì ghi sớm hơn; cùng một đơn đổi nhiều lần chỉ giữ bản mới nhất) được ghi một lần → độ trễ tối đa = cửa sổ gom lô. Lô lỗi tạm được thử lại 3 lần sau 1, 2, 4 phút (nhật ký ghi "Chạy lại"); lỗi cấu hình (user/quyền/khóa Google, bảng lệch khóa) không thử lại — sửa đích rồi chạy tay. Hết 3 lần: kết nối báo lỗi + thông báo cho brand. Mọi lượt giao đi qua hàng đợi chia công bằng giữa các brand; chạy tay được ưu tiên trước realtime và lịch.

5. Mã lỗi

Bảng trên là lỗi của 360 (body có ok: false). Khi đã gọi tới nền tảng, status và body là của nền tảng: phân biệt bằng header X-Q360-Upstream-Status.

6. Hạn mức

• Request / phút / key theo gói. Request / tháng tính riêng từng gói: gọi API thuộc gói nào trừ hạn mức của gói đó; hạn mức làm mới mỗi tháng tính từ ngày bắt đầu gói (vd gói bắt đầu 24/10 → kỳ 24/10–23/11), phần dư không chuyển sang kỳ sau. Header mỗi phản hồi: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-Quota-Calls-Limit, X-Quota-Calls-Remaining, X-Quota-Bucket (plan = trừ gói, topup = trừ request mua thêm), X-Quota-Cycle-End (hết kỳ của gói).
• Gói hết hạn mức → dùng tiếp request mua thêm (dùng chung cho mọi gói; mỗi lần mua dùng 1 tháng kể từ lúc mua, phần chưa dùng chuyển tiếp 1 tháng — tối đa 2 tháng; lần sắp hết hạn được trừ trước) — mua ở Quản lý thanh toán › Thêm request. Hết cả hai → 402 quota_exceeded. GET /v1/me trả số đã dùng / còn lại của từng gói và request mua thêm.
• Lượt đẩy / tháng (realtime + theo lịch + chạy tay) theo gói; vượt → kết nối tạm dừng tới đầu tháng sau hoặc khi mua thêm.
• Hạn mức "không giới hạn" hiện là trống ở trang Quản lý thanh toán; "0" = không cho phép. Số đã dùng xem ở trang Đo lường.

7. Đích CSDL / Cloud — MySQL, PostgreSQL, BigQuery, Lark Base

Khai ở trang Đích nhận, rồi chọn làm đích của một kết nối (realtime, theo lịch hoặc chạy tay). Dữ liệu ghi theo dạng bảng phẳng giống Google Sheets: loại đã xử lý = mỗi dòng hàng một dòng (cột đơn lặp lại, cột item_* theo dòng hàng). Dữ liệu thô chỉ nhận theo realtime tới đích Webhook.

• Khóa dòng hàng item_line_id = items[].line_id của Đơn hàng chuẩn 360 — mã dòng ỔN ĐỊNH do nền tảng cấp (TikTok line_items[].id, Shopee item_id:model_id, Nhanh products[].id); nền tảng không cấp → idx:<số thứ tự>. Cột item_index / item_count chỉ để đọc — số thứ tự đổi khi đơn hủy một phần nên KHÔNG dùng làm khóa.
• Tự tạo bảng nếu chưa có (cột theo dữ liệu + cột _synced_at), thêm cột còn thiếu khi Đơn hàng chuẩn 360 có trường mới; KHÔNG xóa / đổi cột có sẵn. Bảng có sẵn phải có khóa chính / UNIQUE đúng các cột khóa ở trên (bảng tạo trước 20/10/2026 khóa theo item_index → đặt tên bảng mới).
• Cập nhật theo khóa: đơn thay đổi trạng thái được ghi đè đúng dòng — chạy lại / chạy chồng cửa sổ không sinh dòng trùng.
• Dòng hàng bị bỏ khỏi đơn (tùy chọn Xóa dòng hàng không còn trong đơn ở đích, mặc định bật): sau mỗi lần ghi, với đúng các đơn vừa giao, dòng có item_line_id không còn được sàn trả về sẽ bị xóa ở đích (MySQL / PostgreSQL cần quyền DELETE; BigQuery xóa theo tham số; Lark Base tìm _row_key theo tiền tố đơn rồi xóa). Đơn khác không bị đụng. Tắt tùy chọn → dòng cũ ở lại, đối chiếu bằng item_count. Google Sheets tự cập nhật theo khóa và xóa dòng thừa của các đơn vừa giao; không sửa các cột hệ thống trong tab. Excel nối dòng, không xóa.
• MySQL / PostgreSQL: host là tên miền công khai được superadmin duyệt cho brand (IP nội bộ bị chặn); user chỉ cần CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER trên đúng bảng (DELETE chỉ cho tùy chọn xóa dòng); SSL mặc định require.
• BigQuery: dataset có sẵn; service account có BigQuery Data Editor trên dataset + BigQuery Job User trên project.
• Lark Base: custom app có quyền bitable:app, đã publish, là cộng tác viên có quyền sửa của Base; chỉ nhận loại đã xử lý; không xóa / đổi tên cột _row_key.
• Mật khẩu, JSON key, App Secret mã hóa khi lưu và không bao giờ hiện lại. Nút Kiểm tra thử kết nối + quyền mà không ghi dữ liệu.

8. Power BI / Looker Studio

Power BI và Looker Studio đọc dữ liệu — chúng không phải đích đẩy:

a. Nhanh nhất: nối BI vào nơi 360 đã đẩy dữ liệu về

• Tạo kết nối đẩy đơn (theo lịch) về MySQL / PostgreSQL / BigQuery (mục 7).
• Power BI Desktop → Get data → MySQL database / PostgreSQL database / Google BigQuery (connector có sẵn) → chọn bảng đã khai. Dùng user CHỈ ĐỌC riêng cho Power BI (không dùng user ghi của 360). Power BI Service làm mới theo lịch: MySQL/PostgreSQL cần cài on-premises data gateway nếu CSDL không mở ra Internet; BigQuery không cần gateway.
• Đếm doanh số theo đơn: dữ liệu đã xử lý là một dòng / dòng hàng — các cột tiền cấp đơn (subtotal, escrow_amount…) lặp lại trên mọi dòng của đơn → tính tổng đơn trên dòng item_index = 1; doanh số dòng hàng dùng item_quantity × item_unit_sale_price.

b. Looker Studio

• Google Sheets: tạo kết nối đẩy về đích Google Sheets → Looker Studio → Add data → Google Sheets → chọn bảng tính và tab (mặc định Orders).
• BigQuery (khuyến nghị khi nhiều dữ liệu): đẩy về BigQuery → Looker Studio → Add data → BigQuery → project / dataset / bảng.

Shopee

Các module của Shopee: Đơn hàng · Sản phẩm · Đánh giá · Tồn kho · Tài chính / đối soát · Khuyến mãi (Marketing). Giá, dùng thử / mua: trang nền tảng Shopee.

Shopee · Đơn hàng

Đơn, dòng hàng, tiền, vận đơn và yêu cầu trả hàng của gian hàng Shopee.

{
  "ok": true,
  "data": {
    "order_id": "261017ABCD1234",
    "channel": "shopee",
    "platform": "shopee",
    "platform_shop_id": "880001234",
    "status": "completed",
    "platform_status": "COMPLETED",
    "created_at": "2026-10-17T03:00:00Z",
    "paid_at": "2026-10-17T03:01:40Z",
    "shipped_at": "2026-10-18T01:13:20Z",
    "delivered_at": "2026-10-19T05:00:00Z",
    "cancelled_at": null,
    "cancel_reason": null,
    "customer": {
      "name": "N***n V*n A",
      "phone": null,
      "username": "buyer_test01"
    },
    "shipping": {
      "province": "Hà Nội",
      "district": "Quận Cầu Giấy",
      "ward": "Phường Dịch Vọng",
      "address": "***, Phường Dịch Vọng, Quận Cầu Giấy, Hà Nội",
      "carrier": "SPX Express",
      "tracking_code": "SPXVN0123456789",
      "delivery_option": "Nhanh"
    },
    "amounts": {
      "subtotal": 1300000,
      "seller_discount": 140000,
      "platform_discount": 55000,
      "shipping_fee_buyer": 15000,
      "shipping_fee_seller": 0,
      "platform_fee": 160000,
      "payment_fee": 35000,
      "affiliate_fee": 30000,
      "escrow_amount": 1004000,
      "vat_amount": null,
      "prices_include_vat": null,
      "currency": "VND"
    },
    "items": [
      {
        "line_id": "2001:3001",
        "sku": "GT-VSU-S26V-024-GEY-M",
        "parent_sku": "GT-VSU-S26V-024",
        "sku_id": "3001",
        "product_id": "2001",
        "name": "Áo vest GT-VSU",
        "color": "GEY",
        "size": "M",
        "quantity": 2,
        "unit_price": 500000,
        "unit_sale_price": 450000,
        "line_discount": 100000,
        "line_voucher": 30000,
        "vat_percent": null,
        "line_vat": null
      },
      {
        "line_id": "2002:3002",
        "sku": "WJK20026-S",
        "parent_sku": "WJK20026-S",
        "sku_id": "3002",
        "product_id": "2002",
        "name": "Váy suông WJK20026",
        "color": null,
        "size": null,
        "quantity": 1,
        "unit_price": 300000,
        "unit_sale_price": 300000,
        "line_discount": 0,
        "line_voucher": 10000,
        "vat_percent": null,
        "line_vat": null
      }
    ],
    "returns": null,
    "source": {
      "fetched_at": "2026-10-21T08:00:00Z",
      "platform_endpoints": [
        "/api/v2/order/get_order_detail",
        "/api/v2/payment/get_escrow_detail",
        "/api/v2/order/get_package_detail",
        "/api/v2/logistics/get_tracking_number"
      ]
    }
  },
  "request_id": "req_9b07d4…"
}

{
  "order_detail": {
    "order_sn": "2410190001ABC",
    "order_status": "COMPLETED",
    "item_list": [
      {
        "item_id": 100001,
        "model_sku": "1R08.2503OG-MS-XL",
        "model_quantity_purchased": 1
      }
    ]
  },
  "escrow_detail": {
    "order_income": {
      "escrow_amount": 301000
    }
  }
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/shopee/orders/<order_id>?mode=raw"

Shopee · Sản phẩm

Sản phẩm, biến thể (model), giá, trạng thái đăng bán và đánh giá của gian hàng.

{
  "item_id": 100001,
  "item_name": "Áo sơ mi",
  "item_status": "NORMAL",
  "item_sku": "1R08.2503OG",
  "price_info": [
    {
      "current_price": 330000,
      "original_price": 350000
    }
  ]
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/shopee/products?mode=raw&limit=50"

Shopee · Đánh giá

Đánh giá sản phẩm của người mua và trả lời đánh giá.

Shopee · Tồn kho

Kho của gian hàng / merchant, cập nhật tồn kho, tồn kho hàng gửi kho Shopee (SBS: tồn hiện tại, tuổi tồn, xuất nhập, hạn dùng).

Shopee · Tài chính / đối soát

Doanh thu đã quyết toán, chi tiết escrow và giao dịch ví người bán.

Shopee · Khuyến mãi (Marketing)

Mã giảm giá, chương trình giảm giá, combo (bundle), mua kèm (add-on), flash sale của shop, quà theo dõi, sản phẩm nổi bật — gọi API Shopee qua 360.

Shopee Ads

Các module của Shopee Ads: Quảng cáo (Ads). Giá, dùng thử / mua: trang nền tảng Shopee Ads.

Shopee Ads · Quảng cáo (Ads)

Hiệu quả quảng cáo Shopee Ads: CPC theo ngày, chiến dịch sản phẩm, GMS và số dư tài khoản quảng cáo.

Shopee Live

Các module của Shopee Live: Livestream. Giá, dùng thử / mua: trang nền tảng Shopee Live.

Shopee Live · Livestream

Shopee Live: phiên live và chỉ số bán hàng trong phiên.

Shopee Video

Các module của Shopee Video: Video. Giá, dùng thử / mua: trang nền tảng Shopee Video.

Shopee Video · Video

Shopee Video: danh sách video của shop và chỉ số xem, tương tác, đơn từ video.

Shopee AMS

Các module của Shopee AMS: Affiliate. Giá, dùng thử / mua: trang nền tảng Shopee AMS.

Shopee AMS · Affiliate

Tiếp thị liên kết Shopee (AMS): đơn qua affiliate và hiệu suất theo shop / sản phẩm / người làm affiliate.

TikTok Shop

Các module của TikTok Shop: Đơn hàng · Quảng cáo (GMV Max) · Affiliate · Video · Livestream · Sản phẩm · Tồn kho · Tài chính / đối soát · Khuyến mãi (Promotion) · Khách hàng & CSKH. Giá, dùng thử / mua: trang nền tảng TikTok Shop.

TikTok Shop · Đơn hàng

Đơn, dòng hàng, tiền, vận đơn và yêu cầu trả hàng / hoàn tiền của TikTok Shop.

{
  "order_id": "2410190001ABC",
  "platform": "tiktok",
  "platform_shop_id": "123456",
  "channel": "tiktok",
  "status": "delivered",
  "platform_status": "COMPLETED",
  "created_at": "2026-10-19T08:00:00Z",
  "paid_at": "2026-10-19T08:01:00Z",
  "delivered_at": "2026-10-21T10:00:00Z",
  "customer": {
    "name": "N***",
    "phone": null
  },
  "shipping": {
    "province": "Hà Nội",
    "carrier": "J&T Express",
    "tracking_code": "8500000000"
  },
  "amounts": {
    "subtotal": 350000,
    "seller_discount": 20000,
    "platform_discount": 0,
    "shipping_fee_buyer": 15000,
    "escrow_amount": 301000,
    "currency": "VND"
  },
  "items": [
    {
      "sku": "1R08.2503OG-MS-XL",
      "parent_sku": "1R08.2503OG",
      "name": "Áo sơ mi",
      "color": "MS",
      "size": "XL",
      "quantity": 1,
      "unit_price": 350000,
      "unit_sale_price": 330000
    }
  ],
  "returns": []
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/tiktok/orders?updated_from=2026-10-01T00:00:00Z&updated_to=2026-10-02T00:00:00Z"

{
  "order": {
    "id": "5800000000000000",
    "status": "COMPLETED",
    "line_items": [
      {
        "seller_sku": "1R08.2503OG-MS-XL",
        "sale_price": "330000"
      }
    ]
  },
  "price_detail": {
    "total": "345000",
    "currency": "VND"
  }
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/tiktok/orders/<order_id>?mode=raw"

TikTok Shop · Quảng cáo (GMV Max)

TikTok Ads GMV Max (Business API v1.3): chiến dịch, cấu hình và báo cáo hiệu quả theo ngày.

TikTok Shop · Affiliate

TikTok Shop Affiliate: đơn qua creator, hợp tác (open / target collaboration) và tìm creator.

TikTok Shop · Video

Hiệu quả video bán hàng của shop (Analytics API): lượt xem, GMV, sản phẩm trong video.

TikTok Shop · Livestream

Hiệu quả phiên LIVE (Analytics API): tổng quan phiên, theo phút, theo sản phẩm.

TikTok Shop · Sản phẩm

Sản phẩm / SKU, giá, trạng thái và hiệu quả bán theo sản phẩm.

{
  "id": "1729000000000000000",
  "title": "Áo sơ mi",
  "status": "ACTIVATE",
  "skus": [
    {
      "id": "1729000000000000001",
      "seller_sku": "1R08.2503OG-MS-XL",
      "price": {
        "sale_price": "330000",
        "currency": "VND"
      }
    }
  ]
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/tiktok/products?mode=raw&limit=50"

TikTok Shop · Tồn kho

Tồn kho theo SKU và kho của TikTok Shop.

TikTok Shop · Tài chính / đối soát

Sao kê (statement), giao dịch theo đơn và đơn chưa quyết toán.

TikTok Shop · Khuyến mãi (Promotion)

Hoạt động khuyến mãi (activity), coupon của TikTok Shop — gọi API TikTok qua 360.

TikTok Shop · Khách hàng & CSKH

Hội thoại và tin nhắn với người mua (Customer service), đánh giá và trả lời đánh giá (Customer engagement) — gọi API TikTok qua 360.

TikTok Business

Các module của TikTok Business: Quảng cáo (Marketing API) · Tài khoản TikTok (Organic API) · Tin nhắn (Business Messaging). Giá, dùng thử / mua: trang nền tảng TikTok Business.

TikTok Business · Quảng cáo (Marketing API)

Chiến dịch, nhóm quảng cáo, quảng cáo, báo cáo, GMV Max, creative, đối tượng, catalog, Business Center, đo lường — Marketing API v1.3 qua tài khoản quảng cáo brand đã ủy quyền.

TikTok Business · Tài khoản TikTok (Organic API)

Hồ sơ + chỉ số tài khoản TikTok Business, video, bình luận, Mentions, TikTok One (creator marketplace), Discovery, Spark Ads.

TikTok Business · Tin nhắn (Business Messaging)

Hội thoại + tin nhắn trực tiếp của tài khoản TikTok Business, tin chào mừng, tự động trả lời.

Facebook

Các module của Facebook: Quảng cáo (Marketing API) · Trang & Messenger · Conversion API · Doanh nghiệp (Business Manager) · Lead Ads · Instagram. Giá, dùng thử / mua: trang nền tảng Facebook.

Facebook · Quảng cáo (Marketing API)

Insight tài khoản quảng cáo theo chiến dịch / nhóm / quảng cáo, chi tiết đối tượng, bật tắt & ngân sách — các API Marketing 360 đang dùng.

Facebook · Trang & Messenger

Bài viết và insight của Page, insight trang, hội thoại và tin nhắn Messenger — các API Graph 360 đang dùng cho Fanpage.

Facebook · Conversion API

Gửi sự kiện chuyển đổi (mua hàng, thêm giỏ, đăng ký…) từ máy chủ về Pixel để Meta tối ưu và đo quảng cáo.

Facebook · Doanh nghiệp (Business Manager)

Doanh nghiệp, tài khoản quảng cáo, Trang, pixel, thành viên, system user và thử nghiệm A/B của Business Manager brand đã nối.

Facebook · Lead Ads

Form khách hàng tiềm năng của Trang (câu hỏi, trạng thái); đọc thông tin khách để lại cần cấp thêm quyền.

Facebook · Instagram

Google Ads

Các module của Google Ads: Google Ads. Giá, dùng thử / mua: trang nền tảng Google Ads.

Google Ads · Google Ads

Báo cáo GAQL (searchStream / search) và cập nhật trạng thái, ngân sách, từ khóa — đúng các thao tác 360 đang dùng.

Google Analytics 4

Các module của Google Analytics 4: Báo cáo GA4 (Data API) · Cấu hình property (Admin API). Giá, dùng thử / mua: trang nền tảng Google Analytics 4.

Google Analytics 4 · Báo cáo GA4 (Data API)

runReport, batchRunReports, pivot, realtime, metadata, kiểm tương thích chiều × chỉ số trên property GA4 brand đã nối.

Google Analytics 4 · Cấu hình property (Admin API)

Thông tin property, data stream (mã G-, domain), key event, custom dimension / metric, thời hạn lưu dữ liệu — chỉ đọc.

Google Meet

Các module của Google Meet: Lịch hẹn & lời mời (Calendar API) · Phòng họp (Meet REST API) · Lịch sử cuộc họp (Meet REST API). Giá, dùng thử / mua: trang nền tảng Google Meet.

Google Meet · Lịch hẹn & lời mời (Calendar API)

Tạo / sửa / hủy sự kiện lịch kèm link Google Meet, mời khách bằng email do Google gửi, đọc lịch đã hẹn.

Google Meet · Phòng họp (Meet REST API)

Tạo phòng họp Meet (link cố định), đọc / đổi cấu hình phòng (quyền vào, tự ghi hình…), kết thúc cuộc họp đang diễn ra.

Google Meet · Lịch sử cuộc họp (Meet REST API)

Danh sách cuộc họp đã diễn ra, người tham gia + phiên vào/ra, bản ghi, transcript và từng câu thoại.

Gmail

Các module của Gmail: Gửi email (Gmail API) · Đọc & quản lý hộp thư (chưa mở). Giá, dùng thử / mua: trang nền tảng Gmail.

Gmail · Gửi email (Gmail API)

Gửi email từ tài khoản Gmail / Google Workspace đã nối — thư đứng tên chính tài khoản đó, nằm trong mục Đã gửi.

Gmail · Đọc & quản lý hộp thư (chưa mở)

Đọc thư, luồng hội thoại, nhãn, lịch sử thay đổi, tệp đính kèm, thư nháp.

Nhanh.vn

Các module của Nhanh.vn: Đơn hàng · Sản phẩm · Tồn kho · Khách hàng · Hóa đơn bán lẻ · Doanh nghiệp · Vận chuyển · Khuyến mãi · Kế toán · Hóa đơn điện tử · Sàn TMĐT · Zalo (qua Nhanh). Giá, dùng thử / mua: trang nền tảng Nhanh.vn.

Nhanh.vn · Đơn hàng

Đơn Facebook / Website / Live quản lý trên Nhanh.vn (kênh bán theo Cấu hình báo cáo của brand).

{
  "order_id": "2410190001ABC",
  "platform": "nhanh",
  "platform_shop_id": null,
  "channel": "facebook",
  "status": "delivered",
  "platform_status": "Thành công",
  "created_at": "2026-10-19T08:00:00Z",
  "paid_at": "2026-10-19T08:01:00Z",
  "delivered_at": "2026-10-21T10:00:00Z",
  "customer": {
    "name": "N***",
    "phone": null
  },
  "shipping": {
    "province": "Hà Nội",
    "carrier": "GHN",
    "tracking_code": "GHN0000000"
  },
  "amounts": {
    "subtotal": 350000,
    "seller_discount": 20000,
    "platform_discount": 0,
    "shipping_fee_buyer": 15000,
    "escrow_amount": 301000,
    "currency": "VND"
  },
  "items": [
    {
      "sku": "1R08.2503OG-MS-XL",
      "parent_sku": "1R08.2503OG",
      "name": "Áo sơ mi",
      "color": "MS",
      "size": "XL",
      "quantity": 1,
      "unit_price": 350000,
      "unit_sale_price": 330000
    }
  ],
  "returns": []
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/nhanh/orders?updated_from=2026-10-01T00:00:00Z&updated_to=2026-10-02T00:00:00Z"

{
  "info": {
    "id": 1000001,
    "status": "Success",
    "createdAt": 1760860800
  },
  "channel": {
    "saleChannel": 1
  },
  "products": [
    {
      "code": "1R08.2503OG-MS-XL",
      "quantity": 1,
      "price": 330000
    }
  ]
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/nhanh/orders/<order_id>?mode=raw"

Nhanh.vn · Sản phẩm

Danh mục sản phẩm / biến thể, mã cha, giá, danh mục và danh mục nội bộ.

{
  "id": 2000001,
  "parentId": 2000000,
  "code": "1R08.2503OG-MS-XL",
  "barcode": "8930000000001",
  "name": "Áo sơ mi MS XL",
  "price": 350000,
  "inventory": {
    "remain": 12,
    "available": 10
  }
}

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/nhanh/products?mode=raw&limit=50"

Nhanh.vn · Tồn kho

Tồn kho theo kho (depot) và biến thể — nguồn tồn tổng của brand.

Nhanh.vn · Khách hàng

Khách hàng trên Nhanh.vn: liên hệ, ngày sinh, giới tính, địa chỉ, tổng mua.

Nhanh.vn · Hóa đơn bán lẻ

Hóa đơn bán lẻ / xuất nhập kho tại cửa hàng (bán tại quầy).

Nhanh.vn · Doanh nghiệp

Phòng ban, nhân viên, nhà cung cấp (xem + thêm nhà cung cấp).

Nhanh.vn · Vận chuyển

Hãng vận chuyển đang kết nối, tính phí vận chuyển trước khi tạo đơn.

Nhanh.vn · Khuyến mãi

Chương trình coupon, mã coupon, bảng giá; tạo chương trình, thêm mã, cập nhật trạng thái dùng mã.

Nhanh.vn · Kế toán

Tài khoản kế toán, công nợ khách hàng, bút toán.

Nhanh.vn · Hóa đơn điện tử

Danh sách hóa đơn điện tử đã phát hành trên Nhanh.

Nhanh.vn · Sàn TMĐT

Gian hàng sàn TMĐT nối với Nhanh, yêu cầu trả hàng / hoàn tiền từ sàn.

Nhanh.vn · Zalo (qua Nhanh)

Gửi tin Zalo ZBS bằng tài khoản Zalo đã nối trên Nhanh.

GHN

Các module của GHN: Danh mục & cửa hàng · Vận đơn. Giá, dùng thử / mua: trang nền tảng GHN.

GHN · Danh mục & cửa hàng

Tỉnh / phường hệ mới 34 tỉnh (v3) + hệ cũ, bưu cục, ca lấy hàng, cửa hàng của tài khoản.

GHN · Vận đơn

Dịch vụ khả dụng, báo giá, thời gian giao, tạo / sửa / hủy / hoàn / giao lại, đổi COD, chi tiết, phí đơn, in nhãn.

J&T Express

Các module của J&T Express: Vận đơn. Giá, dùng thử / mua: trang nền tảng J&T Express.

J&T Express · Vận đơn

Tính cước, tạo / hủy vận đơn, hành trình, in vận đơn PDF, đăng ký nhận hành trình.

KiotViet

Các module của KiotViet: Hàng hóa & bảng giá · Bán hàng · Kho · Khách hàng · Thu chi & thanh toán · Webhook & thiết lập. Giá, dùng thử / mua: trang nền tảng KiotViet.

KiotViet · Hàng hóa & bảng giá

Nhóm hàng, hàng hóa (thêm / sửa hàng loạt), thuộc tính, bảng giá, thương hiệu.

KiotViet · Bán hàng

Đặt hàng, hóa đơn, trả hàng, kênh bán, thu khác, voucher / coupon.

KiotViet · Kho

Tồn kho theo chi nhánh, chi nhánh, nhập hàng, đặt hàng nhập, nhà cung cấp, chuyển hàng.

KiotViet · Khách hàng

Khách hàng (thêm / sửa hàng loạt), nhóm khách hàng.

KiotViet · Thu chi & thanh toán

Sổ quỹ, thanh toán hóa đơn, tài khoản ngân hàng, QR thanh toán, thuế, thông tin hóa đơn điện tử.

KiotViet · Webhook & thiết lập

Đăng ký webhook (khách nhận trực tiếp, ký X-Hub-Signature bằng Secret của khách), người dùng, thiết lập, địa điểm.

Pancake POS

Các module của Pancake POS: Đơn hàng · Sản phẩm · Kho · Khách hàng · Tài chính · Bán hàng & quảng cáo · Khác. Giá, dùng thử / mua: trang nền tảng Pancake POS.

Pancake POS · Đơn hàng

Đơn hàng, thẻ đơn, đơn trả, gọi lại, giao vận.

Pancake POS · Sản phẩm

Sản phẩm, mẫu mã, combo, danh mục.

curl -H "Authorization: Bearer q360_live_…" \
  "https://partner.quantri360.com/v1/pancake_pos/products?mode=raw&limit=50"

Pancake POS · Kho

Kho, chuyển kho, kiểm kê, nhập hàng, nhà cung cấp, lô, phân tích tồn.