# 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.

| Thông tin | Nội dung |
|---|---|
| Dấu hiệu | Ngày nào cũng xuất file đơn từ Seller Center rồi dán vào bảng tính; Tồn kho Shopee lệch với kho tổng, có lúc bán vượt; Cuối tháng mới đối soát tiền về bằng tay; Biết đơn giao thất bại khi khách đã khiếu nại; Muốn nối Shopee với ERP hoặc n8n nhưng chưa biết gọi API nào |
| Cập nhật | 2026-11-16 |

## 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](https://partner.quantri360.com/sources/shopee).

## Ứ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](/giai-phap/doi-soat-phi-san-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](https://partner.quantri360.com/register), bật xác thực hai lớp.
2. Kết nối gian hàng ở trang [danh sách API Shopee](https://partner.quantri360.com/sources/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:

```bash
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

- [Tự động hóa Shopee bằng n8n qua API](/giai-phap/shopee-n8n)
- [Đồng bộ đơn Shopee vào Google Sheets](/giai-phap/shopee-google-sheets)
- [Đổ đơn sàn vào MySQL / PostgreSQL](/giai-phap/don-san-vao-sql)
- [API TikTok Shop: nhóm API và cách ứng dụng](/giai-phap/api-tiktok-shop)

---
Nguồn: https://quantri360.com/giai-phap/api-shopee · Quantri360
