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
- Đăng ký Partner Quantri360, bật xác thực hai lớp.
- Kết nối gian hàng ở trang danh sách API Shopee.
- 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.
- 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_pagelà object{ cursor, page_size }. Truyền nguyên object thì nhận lại trang đầu. Lấy đúng trườngcursorvà khử trùng theoorder_sn. - Khoảng thời gian quá dài:
get_order_listnhậ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-Afterrồ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>.