Dữ liệu & kết nối

API Shopee là gì? Các nhóm API và cách ứng dụng cho người bán

API Shopee là cổng để phần mềm đọc và cập nhật dữ liệu gian hàng: đơn hàng, vận chuyển, sản phẩm, tồn kho, tiền về, khuyến mãi, quảng cáo. Thường dùng để kéo đơn về Google Sheets hoặc ERP, đồng bộ tồn kho và đối soát tiền về. Partner Quantri360 mở 412 API Shopee, gọi bằng một API key.

API là gì, áp vào Shopee nghĩa là gì?

API (Application Programming Interface) là cách hai phần mềm trao đổi dữ liệu theo một quy ước cố định. Phần mềm gửi một yêu cầu, ví dụ "cho tôi danh sách đơn tạo hôm qua"; phía bên kia trả về dữ liệu có cấu trúc (JSON) để phần mềm xử lý tiếp.

Với Shopee, API thay thế các thao tác tay quen thuộc: xuất file đơn, sửa tồn kho từng sản phẩm, tải báo cáo tiền về. Việc làm một lần thì thao tác tay là đủ. Việc lặp lại hằng ngày, nhiều gian hàng, cần số chính xác thì nên chuyển sang API.

API Shopee gồm những nhóm nào?

Nhóm Dùng để Số API
Đơn hàng (Order) Đơn, vận chuyển, vận đơn, thông tin và sức khỏe shop 72
Trả hàng (Return) Yêu cầu trả hàng / hoàn tiền, đề xuất xử lý, khiếu nại 17
Sản phẩm (Product) Sản phẩm, danh mục, hình ảnh, tồn kho, giá, đánh giá 141
Tài chính (Finance) Tiền về từng đơn, ví người bán, thu nhập 18
Khuyến mãi (Marketing) Voucher, combo, mua kèm, flash sale của shop 63
Quảng cáo (Ads) Chiến dịch quảng cáo trong sàn và hiệu quả 25
Livestream Phiên live, sản phẩm trong live, chỉ số 25
Video Video ngắn gắn sản phẩm 15
Affiliate (AMS) Chiến dịch affiliate, hoa hồng, đơn qua affiliate 36

Danh sách đầy đủ kèm tham số: API Shopee trên Partner Quantri360.

Ứng dụng API Shopee: 5 bài toán thường gặp

1. Kéo đơn hằng ngày về Google Sheets / ERP. Thứ tự gọi: get_order_list (mã đơn trong khoảng thời gian, tối đa 15 ngày, lặp theo cursor) → get_order_detail (tối đa 50 mã mỗi lần: sản phẩm, địa chỉ, tổng tiền). Nên chạy theo lịch, ví dụ 06:00 lấy đơn ngày hôm trước.

2. Cảnh báo đơn giao thất bại. Gọi get_package_detail và đọc trạng thái kiện hàng LOGISTICS_DELIVERY_FAILED. Không dựa vào order_status: đơn giao thất bại vẫn có thể ở trạng thái COMPLETED.

3. Đối soát tiền về. get_escrow_detail trả số tiền thực nhận và từng loại phí của một đơn. get_wallet_transaction_list trả bút toán ví. So hai nguồn để biết đơn nào đã về tiền, phí bị trừ bao nhiêu. Xem thêm đối soát phí sàn Shopee.

4. Đồng bộ tồn kho, giá. Nhóm Sản phẩm cho phép đọc tồn kho, giá từng phân loại và cập nhật lại khi kho tổng thay đổi. Một nguồn tồn kho dùng chung cho nhiều kênh giúp tránh bán vượt.

5. Theo dõi quảng cáo, livestream, affiliate. Các nhóm Ads, Livestream, Video, AMS trả chỉ số theo chiến dịch, phiên live, video, đơn qua affiliate. Gộp các số này với doanh thu đơn để biết kênh nào ra đơn thật.

Bắt đầu gọi API Shopee qua Partner Quantri360

  1. Đăng ký Partner Quantri360, bật xác thực hai lớp.
  2. Kết nối gian hàng ở trang danh sách API Shopee.
  3. Tạo API key ở mục Quản lý API. Có thể giới hạn key theo IP máy chủ và đặt hạn dùng.
  4. Gọi API:
curl -s "https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_list?time_range_field=create_time&time_from=1794502800&time_to=1794589199&page_size=100" \
  -H "Authorization: Bearer $KEY"

Brand có nhiều gian hàng Shopee thì thêm platform_shop_id=<mã gian hàng> vào query. Phản hồi kèm header X-Q360-Request-Id để tra lỗi.

Lỗi hay gặp khi ứng dụng API Shopee

  • Phân trang cộng trùng: ở API thu nhập, next_page là object { cursor, page_size }. Truyền nguyên object thì nhận lại trang đầu. Lấy đúng trường cursor và khử trùng theo order_sn.
  • Khoảng thời gian quá dài: get_order_list nhận tối đa 15 ngày mỗi lần; khoảng dài hơn thì chia nhỏ.
  • Thiếu tham số bắt buộc: trả lỗi 400 kèm tên tham số. Sửa request, không cho chương trình thử lại liên tục.
  • 429 / 503: chờ theo header Retry-After rồi gọi lại.

Câu hỏi thường gặp

API Shopee gồm những nhóm nào?

Đơn hàng, Trả hàng, Sản phẩm, Tài chính, Khuyến mãi, Quảng cáo, Livestream, Video và Affiliate (AMS).

Lấy danh sách đơn hàng bằng API Shopee thế nào?

Gọi get_order_list để lấy mã đơn trong một khoảng thời gian, rồi get_order_detail để lấy sản phẩm, địa chỉ, tổng tiền của từng đơn.

Xem tiền về của đơn bằng API nào?

get_escrow_detail cho từng đơn; get_wallet_transaction_list cho bút toán ví người bán.

Biết đơn giao thất bại bằng API nào?

get_package_detail, đọc trạng thái kiện hàng.

Gọi API Shopee qua Quantri360 thế nào?

Gửi request tới https://partner.quantri360.com/v1/shopee/<đường dẫn API> với header Authorization: Bearer <key>.

Đọc tiếp

Liên quan

Giải pháp

Đổ đơn Shopee, TikTok Shop vào MySQL, PostgreSQL, SQL Server tự động

Cách đẩy đơn Shopee, TikTok Shop, Nhanh.vn vào MySQL, PostgreSQL hoặc SQL Server qua Partner Quantri360 để Power BI, ERP hay AI đọc trực tiếp.

Giải pháp

Tự động hóa Shopee bằng n8n qua API: lấy đơn, tiền về, cảnh báo

Cách dùng n8n gọi API Shopee qua Quantri360 để tự động lấy đơn, tiền về, cảnh báo, kèm các bẫy phân trang và hạn mức đã gặp thật.

Giải pháp

API TikTok Shop là gì? Các nhóm API và cách ứng dụng cho người bán

API TikTok Shop gồm các nhóm Seller, Product, Finance, Affiliate, Livestream, Video. Ứng dụng: kéo đơn, theo dõi giao hàng, trả hàng, tồn kho, đối soát quyết toán.

Giải pháp

AI agent bán hàng: hỏi số liệu Shopee, TikTok, Facebook với Agent 360

Agent 360 là các AI agent theo kênh trong Dashboard 360: hỏi doanh thu, hủy, hoàn, quảng cáo của Shopee, TikTok Shop, Facebook, Offline, Website bằng câu thường, số được soát với báo cáo.

Giải pháp

MCP là gì? Kết nối Claude với dữ liệu bán hàng qua Cổng MCP Quantri360

MCP (Model Context Protocol) là chuẩn để trợ lý AI gọi công cụ và dữ liệu bên ngoài. Cổng MCP Quantri360 cho Claude hỏi Agent 360 về số liệu Shopee, Facebook… của doanh nghiệp.

Giải pháp

Plugin Claude phân tích Shopee, TikTok Shop: Ecom Analyst

Ecom Analyst là plugin cho Claude: đọc file Dữ liệu tự động (đơn hàng, tiền về ví, chi phí quảng cáo) và phân tích theo đúng công thức của Quản Trị 360.

Quantri360
Viết bởi Quantri360 · Đội ngũ tư vấn quản trị & dữ liệu

Xây dựng Quantri360 — nền tảng xây dựng tự động hóa cho cá nhân, doanh nghiệp; viết về dữ liệu bán hàng, API, AI agent và tự động hóa vận hành.

Cập nhật
Nhắn Messenger ZaloChat Zalo