Trạng thái đơn hàng

Để xem trạng thái đơn hàng trên API.socdo.vn, bạn cần gửi :
user_id để xem trạng thái của tất cả đơn hàng của tài khoản đó.
user_id và status để xem tất cả đơn hàng có trạng tái đó.
chú ý: status có thể là các giá trị sau: 0, 1, 2, 3, 4, 5, 6 trong đó:
- 0: Chờ xử lý
- 1: Đã tiếp nhận
- 2: Đang vận chuyển
- 3: Yêu cầu hủy đơn
- 4: Đã hủy đơn
- 5: Đã nhận hàng
- 6: Đã hoàn đơn

POST https://api.socdo.vn/v1/order_status

các trường cần truyền lên:

1 trạng thái tất cả đơn hàng

user_id: your_user_id

2 trạng thái đơn hàng theo trạng thái cụ thể

user_id: your_user_id
status: trạng thái đơn hàng (0, 1, 2, 3, 4, 5, 6)

Dữ liệu mẫu truyền lên (JSON):

1 trạng thái tất cả đơn hàng :

{
    "user_id": "your_user_id"
}

2 trạng thái đơn hàng theo trạng thái cụ thể :

{
    "user_id": "your_user_id",
    "status" : "1"
}

Ví dụ kết nối bằng cURL:

1 trạng thái tất cả đơn hàng :

    curl -X POST "https://api.socdo.vn/v1/register" -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"user_id": "your_user_id"}'

2 trạng thái đơn hàng theo trạng thái cụ thể

    curl -X POST "https://api.socdo.vn/v1/register" -H "Content-Type: application/json" -H "Authorization: Bearer <token>" -d '{"user_id": "your_user_id" , "status": "1"}'

Ví dụ kết nối bằng PHP:

1 trạng thái tất cả đơn hàng :

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.socdo.vn/v1/order_status");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer <token>"
]);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "user_id" => "your_user_id"
]));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

2 trạng thái đơn hàng theo trạng thái cụ thể :

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.socdo.vn/v1/order_status");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer <token>"
]);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "user_id" => "your_user_id",
    "status" => "1"
]));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Dữ liệu trả về mẫu:

{
    "success": true,
    "data": [
        {
            "user_id": 30890,
            "ho_ten": "Trần Văn Hoàn",
            "dien_thoai": "0899839344",
            "email": "[email protected]",
            "ma_don": "381378_20755_117",
            "status": 6,
            "sanpham": "{\"4330_4938\":{\"sp_id\":4330,\"pl\":4938,\"quantity\":1,\"gia_moi\":\"399,000\",\"thanhtien\":\"399,000\",\"tieu_de\":\"Nồi lẩu mini đa năng Elmich 2 màu sắc MPE-9121 dung tích 1.5L\",\"color\":\"Màu xanh\",\"size\":\"+\",\"link\":\"noi-lau-mini-da-nang-elmich-2-mau-sac-mpe-9121-dung-tich-1-5l\",\"minh_hoa\":\"\\/uploads\\/minh-hoa\\/noi-lau-mini-da-nang-elmich-2-mau-sac-mpe-9121-dung-tich-1-5l-1754808180.jpg\",\"hoa_hong\":\"0\",\"utm_source\":\"\",\"utm_campaign\":\"\"}}",
            "dia_chi": "zsdczs",
            "tinh": 53,
            "huyen": 599,
            "xa": 9387,
            "tamtinh": 399000,
            "phi_ship": 20500,
            "tongtien": 419090,
            "thanhtoan": "cod",
            "ghi_chu": "",
            "date_update": "1758180698",
            "date_post": "1758180698",
            "shop_id": "20755",
            "ship_support": 410
        }
    ]
}

Lưu ý: Bạn cần lấy token xác thực trước khi gọi API này (xem hướng dẫn lấy token ở mục Get token xác thực).
Trường phone_number sẽ là tên đăng nhập, là số điện thoại.
Để xem hướng dẫn chi tiết từng API, vui lòng chọn chức năng ở menu bên trái.

API Mini App Documentation

Tài liệu hướng dẫn tích hợp API cho ứng dụng Mini App của Sóc Đỏ. Cung cấp các endpoint để phát triển ứng dụng di động với đầy đủ tính năng.

Base URL: https://api.socdo.vn/mini-app/v1/

Ví dụ tích hợp cơ bản

// Khởi tạo Mini App
const miniApp = new SocdoMiniApp({
    appId: 'your-app-id',
    secretKey: 'your-secret-key',
    environment: 'production' // hoặc 'sandbox'
});

// Xác thực người dùng
const authResult = await miniApp.auth.login({
    phone: '0123456789',
    password: 'password123'
});

// Lấy danh sách sản phẩm
const products = await miniApp.products.list({
    page: 1,
    limit: 20,
    category: 'electronics'
});

Response mẫu

{
    "success": true,
    "data": {
        "products": [
            {
                "id": 1,
                "name": "iPhone 15 Pro",
                "price": 29990000,
                "image": "https://example.com/image.jpg",
                "category": "electronics"
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 20,
            "total": 100
        }
    },
    "message": "Lấy danh sách sản phẩm thành công"
}