VI | EN
Nhắn Messenger
Dành cho developer

Chi tiết đơn (tối đa 50 mã/lần) — API Shopee

v2.order.get_order_detail · gọi qua Quantri360 bằng một API key cho chính tài khoản / tài sản bạn đã kết nối và ủy quyền — 360 lo việc ký request và làm mới phiên đăng nhập bạn đã cấp.

v2.order.get_order_detail

GET/api/v2/order/get_order_detailGọi qua 360: GET https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail
Mô tả API

Lấy nội dung đầy đủ của tối đa 50 đơn: dòng hàng, người nhận, tiền, gói hàng, lý do hủy. Mặc định chỉ trả vài trường cơ bản — chọn thêm bằng response_optional_fields.

  • Không có tiền thực nhận ở đây — dùng payment/get_escrow_detail (module Tài chính).
  • Mã không tồn tại / không thuộc gian hàng bị bỏ qua im lặng — so số đơn trả về với số mã gửi đi.

Request

Địa chỉ

GET https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail

Xác thực & gian hàng

TênVị tríKiểuMẫuMô tả
AuthorizationheaderheaderBearer q360_live_ab12cd34_…Khóa API của brand (tạo ở mục API key). Bắt buộc với mọi request. Brand suy từ key — không truyền mã brand.
platform_shop_idquerystring100001Gian hàng (lấy ở GET /v1/platforms → shops[].platform_shop_id). BẮT BUỘC khi brand có > 1 gian hàng trên nền tảng; 360 bỏ tham số này trước khi chuyển tiếp.

Tham số request

TênVị tríKiểuBắt buộcMẫuMô tả
order_sn_listquerystringCó2610220ABCDE01,2610220ABCDE02Tối đa 50 mã đơn, cách nhau dấu phẩy.
response_optional_fieldsquerystringKhôngitem_list,recipient_address,total_amount,package_listTrường tùy chọn, cách nhau dấu phẩy: buyer_user_id, buyer_username, item_list, recipient_address, total_amount, pay_time, package_list, shipping_carrier, payment_method, cancel_reason, cancel_by, buyer_cancel_reason, note, pickup_done_time, actual_shipping_fee, estimated_shipping_fee, invoice_data, edt…
request_order_status_pendingqueryboolKhôngfalsetrue để Shopee trả cả đơn đang chờ (pending) nếu có.

Ví dụ request

curl -s "https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail?order_sn_list=2610220ABCDE01%2C2610220ABCDE02&response_optional_fields=item_list%2Crecipient_address%2Ctotal_amount%2Cpackage_list%2Cpay_time" \
  -H "Authorization: Bearer $KEY"
Python
import requests

KEY = "q360_live_..."  # khóa API của brand
r = requests.get(
    "https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail",
    params={
        "order_sn_list": "2610220ABCDE01,2610220ABCDE02",
        "response_optional_fields": "item_list,recipient_address,total_amount,package_list,pay_time"
    },
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=60,
)
print(r.status_code)
print(r.json())
Node.js
const KEY = 'q360_live_...'; // khóa API của brand
const url = new URL('https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail');
for (const [k, v] of Object.entries({"order_sn_list":"2610220ABCDE01,2610220ABCDE02","response_optional_fields":"item_list,recipient_address,total_amount,package_list,pay_time"})) url.searchParams.set(k, typeof v === 'object' ? JSON.stringify(v) : String(v));
const r = await fetch(url, {
  method: 'GET',
  headers: { Authorization: `Bearer ${KEY}` },
});
console.log(r.status, await r.json());
PHP
<?php
$key = 'q360_live_...'; // khóa API của brand
$url = 'https://partner.quantri360.com/v1/shopee/api/v2/order/get_order_detail' . '?' . http_build_query(['order_sn_list' => '2610220ABCDE01,2610220ABCDE02', 'response_optional_fields' => 'item_list,recipient_address,total_amount,package_list,pay_time']);
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Authorization: Bearer ' . $key]);
$res = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status, "\n", $res;

Response

Tham số phản hồi (nguyên của Shopee)

TênKiểuMẫuMô tả
request_idstringd52ca43b277a4f9292fb8be658bfd33dMã request của Shopee để tra lỗi.
errorstringMã lỗi Shopee; rỗng = thành công.
messagestringMô tả lỗi.
responseobjectDữ liệu.
order_listobject[]Đơn hàng.
order_snstring2610220ABCDE01Mã đơn Shopee.
order_statusstringCOMPLETEDUNPAID · READY_TO_SHIP · PROCESSED · SHIPPED · TO_CONFIRM_RECEIVE · COMPLETED · IN_CANCEL · CANCELLED · TO_RETURN · INVOICE_PENDING.
currencystringVND
codbooltrueĐơn thu hộ (COD).
days_to_shipint2Số ngày chuẩn bị hàng.
message_to_sellerstringLời nhắn người mua.
create_timetimestamp1760893200Thời điểm tạo.
update_timetimestamp1760979600Lần cập nhật cuối.
total_amountfloat259000Tổng tiền người mua trả (cần response_optional_fields).
pay_timetimestamp1760893500Thời điểm thanh toán.
payment_methodstringShopeePayHình thức thanh toán.
shipping_carrierstringSPX ExpressĐơn vị vận chuyển.
item_listobject[]Dòng hàng.
item_idint1234567890Id sản phẩm.
item_namestringÁo thunTên sản phẩm.
item_skustring1R08.2503OGSKU cha.
model_idint987654321Id biến thể.
model_namestringTrắng,MTên biến thể.
model_skustring1R08.2503OG-MS-XLSKU biến thể.
model_quantity_purchasedint2Số lượng.
model_original_pricefloat159000Giá gốc.
model_discounted_pricefloat129000Giá sau giảm.
weightfloat0.3Khối lượng (kg).
promotion_typestringLoại khuyến mãi của dòng (vd add_on_free_gift_main / add_on_free_gift_sub = quà tặng kèm).
recipient_addressobjectNgười nhận (bị che một phần sau khi đơn hoàn tất một thời gian — chính sách Shopee).
namestringN*** ATên.
phonestring******123SĐT.
full_addressstring…Địa chỉ đầy đủ.
citystringHà NộiTỉnh/thành.
districtstringCầu GiấyQuận/huyện.
package_listobject[]Gói hàng.
package_numberstringOFG1234567890Mã gói — dùng cho get_package_detail.
logistics_statusstringLOGISTICS_DELIVERY_DONETrạng thái vận chuyển.
shipping_carrierstringSPX ExpressĐVVC.
cancel_reasonstringLý do hủy.
cancel_bystringbuyer · seller · system.

Mẫu phản hồi

{
  "error": "",
  "message": "",
  "response": {
    "order_list": [
      {
        "order_sn": "2610220ABCDE01",
        "order_status": "SHIPPED",
        "create_time": 1792666721,
        "update_time": 1792803880,
        "currency": "VND",
        "cod": true,
        "days_to_ship": 2,
        "total_amount": 713400,
        "pay_time": 1792666721,
        "payment_method": "Thanh toán khi nhận hàng",
        "shipping_carrier": "SPX Express",
        "message_to_seller": "",
        "item_list": [
          {
            "item_id": 10000000126,
            "item_name": "Đầm nữ dáng xoè cổ yếm",
            "item_sku": "SDPBF1040",
            "model_id": 10000000127,
            "model_name": "Trắng,M",
            "model_sku": "SDPBF1040-Màu 1-M",
            "model_quantity_purchased": 1,
            "model_original_price": 1369000,
            "model_discounted_price": 713400,
            "weight": 0.3,
            "promotion_type": "add_on_free_gift_main"
          }
        ],
        "package_list": [
          {
            "package_number": "OFG2463650000001",
            "logistics_status": "LOGISTICS_PICKUP_DONE",
            "shipping_carrier": "SPX Express",
            "item_list": [
              {
                "item_id": 10000000126,
                "model_id": 10000000127,
                "model_quantity": 1
              }
            ]
          }
        ]
      }
    ]
  },
  "request_id": "e3e3e7f35e8f6b9e…"
}

Mã lỗi của Shopee (11)

Bấm để xem
MãÝ nghĩa
error_not_foundKhông tìm thấy đơn / gói / yêu cầu theo mã đã gửi.
error_paramTham số sai / thiếu / sai kiểu — xem `message` để biết tham số nào.
error_permissionGian hàng không có quyền xem dữ liệu này (vd yêu cầu trả / đơn không thuộc gian hàng).
error_serverLỗi hệ thống Shopee — thử lại sau ít phút.
error_dataDữ liệu không tồn tại hoặc không hợp lệ cho thao tác (vd mã không có, loại yêu cầu không cho phép).
error_shopGian hàng không hợp lệ — kiểm tra platform_shop_id.
error_authỦy quyền gian hàng cho 360 đã hết hạn hoặc bị thu hồi (360 đã tự làm mới token một lần) — chủ gian hàng kết nối lại Shopee trong Partner.
error_limitChạm hạn mức gọi Shopee trong ngày của kết nối — 360 trả kèm thời điểm thử lại; giảm tần suất gọi.
error_rate_limitGọi quá nhanh — chờ vài giây rồi gọi lại (360 cũng giới hạn theo key: 429 + Retry-After).
shop_bannedGian hàng đang bị Shopee khóa — mọi API tạm ngưng tới khi gỡ khóa.
error_kyc_authGian hàng chưa hoàn tất đăng ký người bán trên Kênh Người Bán.

Bắt đầu dùng

  1. Đăng ký tài khoản Partner
  2. Mở loại dữ liệu thuộc nhóm Đơn hàng ở trang nền tảng
  3. Tạo API key (tick kênh Shopee)
  4. Gọi theo ví dụ ở trên