API Quản lý đơn hàng

API này cho phép quản lý đơn hàng hoàn chỉnh: lấy danh sách, chi tiết, tạo mới và cập nhật trạng thái.
Ví dụ minh họa: Quản lý đơn hàng

1. Lấy danh sách đơn hàng

GET https://api.socdo.vn/v1/order_management
Các tham số có thể truyền (tùy chọn):
  • user_id: ID người dùng
  • status: Trạng thái đơn hàng (0: Chờ xác nhận, 1: Đã xác nhận, 2: Đang giao, 3: Đã giao, 4: Đã hủy)
  • search: Tìm kiếm theo mã đơn, tên, SĐT, email
  • date_from: Từ ngày (Y-m-d)
  • date_to: Đến ngày (Y-m-d)
  • page: Trang hiện tại (mặc định: 1)
  • limit: Số đơn hàng mỗi trang (mặc định: 20, tối đa: 100)

2. Lấy chi tiết đơn hàng

GET https://api.socdo.vn/v1/order_management?order_id=123

3. Tạo đơn hàng mới

POST https://api.socdo.vn/v1/order_management
Các trường bắt buộc:
  • user_id: ID người dùng
  • ho_ten: Họ tên khách hàng
  • dien_thoai: Số điện thoại
  • dia_chi: Địa chỉ giao hàng
  • sanpham: Danh sách sản phẩm (JSON array)
  • tamtinh: Tạm tính
  • tongtien: Tổng tiền
Dữ liệu mẫu tạo đơn hàng (JSON): 
{
    "user_id": 123,
    "ho_ten": "Nguyễn Văn A",
    "email": "[email protected]",
    "dien_thoai": "0123456789",
    "dia_chi": "123 Đường ABC, Phường XYZ",
    "tinh": 1,
    "huyen": 2,
    "xa": 3,
    "dropship": 0,
    "sanpham": [
        {
            "id": 123,
            "qty": 2,
            "price": 500000,
            "name": "iPhone 15"
        },
        {
            "id": 456,
            "qty": 1,
            "price": 200000,
            "name": "Case iPhone"
        }
    ],
    "tamtinh": 1200000,
    "coupon": "SALE20",
    "giam": 200000,
    "phi_ship": 30000,
    "tongtien": 1030000,
    "thanhtoan": "cod",
    "ghi_chu": "Giao hàng nhanh",
    "utm_source": "facebook",
    "utm_campaign": "summer_sale"
}

4. Cập nhật trạng thái đơn hàng

PUT https://api.socdo.vn/v1/order_management
Dữ liệu mẫu cập nhật trạng thái (JSON): 
{
    "order_id": 123,
    "status": 2
}
Ví dụ lấy danh sách bằng cURL:
curl -X GET "https://api.socdo.vn/v1/order_management?status=1&page=1&limit=10" -H "Authorization: Bearer <token>"
Ví dụ tạo đơn hàng bằng PHP:
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.socdo.vn/v1/order_management");
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" => 123,
    "ho_ten" => "Nguyễn Văn A",
    "email" => "[email protected]",
    "dien_thoai" => "0123456789",
    "dia_chi" => "123 Đường ABC, Phường XYZ",
    "sanpham" => [
        ["id" => 123, "qty" => 2, "price" => 500000, "name" => "iPhone 15"],
        ["id" => 456, "qty" => 1, "price" => 200000, "name" => "Case iPhone"]
    ],
    "tamtinh" => 1200000,
    "giam" => 200000,
    "phi_ship" => 30000,
    "tongtien" => 1030000,
    "thanhtoan" => "cod"
]));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
Dữ liệu trả về mẫu (Danh sách):
{
    "success": true,
    "message": "Lấy danh sách đơn hàng thành công",
    "data": {
        "orders": [
            {
                "id": "123",
                "ma_don": "DH123456",
                "user_id": "456",
                "ho_ten": "Nguyễn Văn A",
                "email": "[email protected]",
                "dien_thoai": "0123456789",
                "dia_chi": "123 Đường ABC, Phường XYZ",
                "tamtinh": "1200000",
                "giam": "200000",
                "phi_ship": "30000",
                "tongtien": "1030000",
                "status": "1",
                "thanhtoan": "cod",
                "date_post": "1695020400",
                "date_update": "1695020400",
                "utm_source": "facebook",
                "tamtinh_formatted": "1,200,000",
                "giam_formatted": "200,000",
                "phi_ship_formatted": "30,000",
                "tongtien_formatted": "1,030,000",
                "date_post_formatted": "18/09/2023 15:00:00",
                "date_update_formatted": "18/09/2023 15:00:00",
                "status_text": "Đã xác nhận"
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 5,
            "total_orders": 48,
            "limit": 10,
            "has_next": true,
            "has_prev": false
        },
        "filters": {
            "user_id": 0,
            "status": 1,
            "search": "",
            "date_from": "",
            "date_to": ""
        }
    }
}
Dữ liệu trả về mẫu (Chi tiết):
{
    "success": true,
    "message": "Lấy chi tiết đơn hàng thành công",
    "data": {
        "id": "123",
        "ma_don": "DH123456",
        "ho_ten": "Nguyễn Văn A",
        "products": [
            {
                "id": "123",
                "tieu_de": "iPhone 15 Pro Max",
                "minh_hoa": "/uploads/hinh-anh/iphone15.jpg",
                "quantity": 2,
                "price": 500000,
                "total": 1000000,
                "price_formatted": "500,000",
                "total_formatted": "1,000,000",
                "image_url": "https://api.socdo.vn/uploads/hinh-anh/iphone15.jpg"
            }
        ],
        "address_info": {
            "tinh": "Hồ Chí Minh",
            "huyen": "Quận 1"
        },
        "full_address": "123 Đường ABC, Phường XYZ, Quận 1, Hồ Chí Minh",
        "tongtien_formatted": "1,030,000",
        "status_text": "Đã xác nhận"
    }
}
Lưu ý:
  • Bạn cần lấy token xác thực trước khi gọi API này
  • Trạng thái đơn hàng: 0=Chờ xác nhận, 1=Đã xác nhận, 2=Đang giao hàng, 3=Đã giao hàng, 4=Đã hủy
  • sanpham phải là mảng JSON chứa thông tin sản phẩm
  • Mã đơn hàng được tạo tự động khi tạo đơn hàng mới
  • API tự động tính toán và format giá tiền
  • Có thể lọc theo nhiều tiêu chí: user, status, ngày tháng, từ khóa