Dịch vụ giao đồ ăn (Sàn Cam) Store API

Endpoint

Tham số

Ví dụ request

GET https://data.addlivetag.com/shopeefood/store.php?restaurant_id=1245352

# Nhiều quán cùng lúc
GET https://data.addlivetag.com/shopeefood/store.php?restaurant_id=1245352,1211381

Ví dụ response (rút gọn)

{
  "status": "ok",
  "data": [
    {
      "delivery_id": 123456,
      "restaurant_id": 1245352,
      "name": "Tên quán...",
      "address": "123 Đường ABC, Quận 1, TP.HCM",
      "is_open": true,
      "is_quality_merchant": true,
      "is_pickup": false,
      "restaurant_url": "https://shopeefood.vn/...",
      "operating": {
        "status": 1,
        "open_time": "07:00",
        "close_time": "22:00"
      }
    }
  ]
}

Ghi chú

• Chỉ chấp nhận phương thức GET (method khác trả HTTP 405).
• Thiếu hoặc sai restaurant_id trả HTTP 400 kèm thông báo lỗi.
• Response là JSON UTF-8, bật CORS, múi giờ dữ liệu Asia/Ho_Chi_Minh.

🧾 API Đơn hàng

Lấy danh sách đơn hàng Dịch vụ giao đồ ăn (Sàn Cam) theo tài khoản. Truyền cookie tài khoản và khoảng thời gian, nhận về JSON danh sách đơn.

Tham số

Ví dụ request

# Cookie qua query (nhớ urlencode):
GET https://data.addlivetag.com/shopeefood/orders.php?from=2026-07-01&to=2026-07-17&page=1&cookie=...

# An toàn hơn — cookie qua header:
curl 'https://data.addlivetag.com/shopeefood/orders.php?from=2026-07-01&to=2026-07-17' \
  -H 'X-SPF-Cookie: ...'

Ví dụ response (rút gọn)

{
  "code": 0,
  "msg": "success",
  "data": {
    "page_num": 1,
    "page_size": 100,
    "total_count": 27,
    "list": [
      {
        "checkout_id": "1872247192",
        "purchase_time": 1787500239,
        "conversion_status": 1,
        "checkout_cap": 2500000000,
        "gross_commission": 630000000,
        "capped_commission": 630000000,
        "is_shopee_capped": false,
        "affiliate_net_commission": "630000000",
        "orders": [
          {
            "order_id": "1872247192",
            "order_status": "PAID",
            "display_order_status": 1,
            "items": [
              {
                "shop_id": 1190358,
                "shop_name": "Tên quán...",
                "promotion_id": "0_0_1901361979",
                "item_id": 159006906,
                "item_name": "Tên món...",
                "item_price": 1400000000,
                "actual_amount": 7000000000,
                "qty": 5,
                "platform_commission_rate": 9000,
                "item_commission": 630000000,
                "affiliate_item_status": 1
              }
            ]
          }
        ]
      }
    ]
  }
}

Đọc kết quả — 3 quy tắc bắt buộc

1. Mọi số tiền đã nhân sẵn 100 000. Chia 100000 mới ra VNĐ. Áp dụng cho item_price, actual_amount, refunded_amount, mọi *_commission và checkout_cap.

platform_commission_rate cũng vậy: 9000 = 9%, 5000 = 5%, 25000 = 25%. Mọi mốc thời gian là unix timestamp (giây) — giá trị 0 nghĩa là chưa xảy ra.

2. Hoa hồng tính trên actual_amount, không phải item_price × qty.

hoa hồng 1 dòng = actual_amount × platform_commission_rate ÷ 100000

item_price là giá niêm yết 1 phần, chưa trừ khuyến mãi. actual_amount là tiền khách thực trả cho cả dòng đó — đã gồm số lượng, đã trừ giảm giá. Ví dụ có dòng item_price 58.800đ, qty 2, nhưng actual_amount chỉ 76.500đ.

3. Mỗi đơn bị chặn trần hoa hồng (checkout_cap, hiện là 25.000đ).

• gross_commission — hoa hồng trước khi cắt trần (số bạn tính tay sẽ ra số này).
• capped_commission — số thực nhận = min(gross_commission, checkout_cap).
• Khi is_shopee_capped: true, item_commission từng món đã bị chia lại theo tỉ lệ cho khớp trần, nên không còn bằng actual_amount × rate.
• Luôn đúng: tổng item_commission = capped_commission = affiliate_net_commission.

Trạng thái đơn

• Đơn trạng thái 1 sẽ chuyển sang 2 hoặc 3 ở lần đồng bộ sau → nếu lưu vào cơ sở dữ liệu thì ghi đè theo checkout_id, đừng cộng dồn.
• Đừng dùng checkout_status (chuỗi) để phân loại — đơn đã hoàn tất vẫn ghi "Waiting for payment". Chỉ tin conversion_status.
• Hoa hồng bằng 0 còn có 2 trường hợp bình thường: món giá 0 (combo tặng kèm) và món được voucher phủ hết (actual_amount: 0).

Khoá dữ liệu khi lưu trữ

• Khoá đơn trong báo cáo: checkout_id (trùng với orders[0].order_id).
• order_sn luôn rỗng ở dịch vụ giao đồ ăn → không dùng làm khoá.
• Subid nằm trong utm_content, nhưng trường này có 2 dạng — xem ngay bên dưới. Dù dạng nào cũng lưu subid kiểu chuỗi, đừng ép kiểu số.

utm_content có 2 dạng — đừng tách mù

Cả hai dạng đều dùng dấu - nhưng ý nghĩa khác hẳn. Đây là chỗ dễ viết code sai nhất.

• Khoá dòng món: promotion_id. Không dùng item_id — cùng một món có thể xuất hiện nhiều dòng trong 1 đơn với item_price khác nhau (khác size/topping).
• shop_id chạy từ 4 tới 10 chữ số → dùng kiểu BIGINT, không dùng INT.

Lỗi thường gặp

Ghi chú

• Chỉ chấp nhận GET; response là JSON UTF-8, bật CORS.
• data.total_count là tổng số đơn khớp bộ lọc — dùng để biết còn bao nhiêu trang.
• Các trường global_category_lv1..3 luôn rỗng ở dịch vụ giao đồ ăn — không phân loại món theo đây được.
• Cookie chỉ dùng cho lần gọi của bạn, không được lưu lại (chỉ log độ dài + mã trạng thái để debug).
• Kết quả trả về theo trang; dùng page để lấy các trang tiếp theo.
• Nếu nhận lỗi phiên đăng nhập: cookie đã hết hạn — đăng nhập lại và lấy cookie mới.